You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Next »

Page in development

This page is in development and as such, its contents may be incorrect

Internal API

This is an internal API used for communication between nodes and is not expected to be used by others

The manager node API provides functionality that allows a manager and worker nodes to communicate.

Release one or more workers

Reset the status of any in memory batches that were sent to a failed worker but had not been acknowledged so the may be sent to another worker

POST /aspire_api/manager/release/worker/:id

PUT /aspire_api/manager/release/worker/:id

PUT /aspire_api/manager/release/worker

Path and Request Body Parameters

NameTypeRequiredDescription
idstringRequiredThe identifier(s) of the failed worker node(s) whose batches must be reset

Response

{
  "message": "optional response message"
}

Status

Response codeDescription
200Success
404The given worker id was not found




Release one or more seeds

Used by the master manager when pausing or stopping to release all of the items for a seed from unsent batches. The manager will then forward the same to the workers

POST /aspire_api/manager/release/seed/:id

PUT /aspire_api/manager/release/seed/:id

PUT /aspire_api/manager/release/seed

Path and Request Body Parameters

NameTypeRequiredDescription
idstringRequiredThe identifier(s) of the seed to be released

Examples

Release a single seed

{
  "id": "AAABcID5GBc="
}

Release multiple seeds

[{
  "id": "AAABcID5GBc="
},
{
  "id": "AAABcIueWUc="
}]

Release multiple seeds (alternative form)

{
  "id": ["AAABcID5GBc=", "AAABcIueWUc="]
}

Response

{
  "message": "optional response message"
}

Status

Response codeDescription
200Success
404The given seed id was not found




Fetch one or more batches

Used by the worker to fetch a batch from the manager.

POST /aspire_api/manager/batch

Path and Request Body Parameters

NameTypeRequiredDescription
tagsstringOptionalThe tags this machine has
batchesnumberOptionalThe number of batches to fetch (default 1)

Response

{
  <TODO>
  "message": "optional response message"
}

Status

Response codeDescription
200Success
404Not found - a given connector identifier was not found
406Not acceptable - there was an issue validating the input




Acknowledge one or more batches

Used by the worker node to acknowledge the worker has taken responsibility for the batch(es)

POST /aspire_api/manager/batch/ack/:id

PUT /aspire_api/manager/batch/ack/:id

PUT /aspire_api/manager/batch/ack

Path and Request Body Parameters

NameTypeRequiredDescription
idstringRequiredThe identifier(s) of the seed to be released

Examples

Acknowledge a single batch

{
  "id": "AAABcID5GBc="
}

Acknowledge multiple batches

[{
  "id": "AAABcID5GBc="
},
{
  "id": "AAABcIueWUc="
}]

Acknowledge multiple batches (alternative form)

{
  "id": ["AAABcID5GBc=", "AAABcIueWUc="]
}

Response

{
  "message": "optional response message"
}

Status

Response codeDescription
200Success
404The given batch id was not found
  • No labels