The configuration and control API provides functionality that allows a administrator to perform actions such as adding a seed to crawl, or beginning or stopping a crawl. This API will provide the functionality required by the Aspire User interface and will be extensively used by it. The API will also be used by any external process (or script) that needs to control Aspire
Lists all the seeds configured in the Aspire
GET /aspire_api/seeds
Parameters
Name | Type | Description |
---|---|---|
state | string | Filter returned seeds to only those with the given status(es) |
type | string | Filter returned seeds to only those with the given type |
description | string | Filter returned seeds to only those whose description matches the given expression |
seed | string | Filter returned seeds to only those whose seed matches the given expression |
Response
{ "seed": [{ "sid": "AAABcID5GBc=", "seed": "c:\\testdata\\2500", "type": "filesystem", "description": "2,500 files", "status": "S", "start": 1584550193011, "stop": 1584550267047 }, { "sid": "AAABcIueWUc=", "seed": "c:\\testdata\\250000", "type": "filesystem", "description": "250,000 files", "status": "S", "stop": 1583240224684, "start": 1583239823374 }] }
Status
Response code | Description |
---|---|
200 | Success |
Get information about a single seed configured in Aspire
GET /aspire_api/seeds/:seed_id
Response
{ "seed": { "sid": "AAABcID5GBc=", "seed": "c:\\testdata\\2500", "type": "filesystem", "description": "2,500 files", "status": "S", "start": 1584550193011, "stop": 1584550267047 } }
Status
Response code | Description |
---|---|
200 | Success |
404 | The given seed id was not found |
Add one or more seeds to Aspire
POST /aspire_api/seeds
Parameters
Name | Type | Description |
---|---|---|
seed | string | Required: The url/path indicating the content to crawl |
type | string | Required: The type of connector to use for this seed (may be omitted if connector is specified) |
connector | string | Required: The identifier of the connector configuration to use for this seed (may be omitted if type is specified) |
description | string | An optional description of the seed |
credential | string | An optional id of the credential to use for this seed |
policy | string | An optional list of the policy identifiers to use for this seed |
workflow | string | An optional list of the workflow identifiers to use for this seed |
Examples
Add a single seed
{ "seed": { "seed": "c:\\testdata\\2500", "type": "filesystem" } }
Add multiple seeds
{ "seed": [{ "seed": "c:\\testdata\\2500", "type": "filesystem" }, { "seed": "c:\\testdata\\250000", "connector": "connector_1", "description": "250,000 files", "credential": "cred_1", "policy": "policy_1", "workflow": ["workflow_1","workflow_99"] }] }
Response
{ "seed": [{ "sid": "AAABcID5GBc=", "seed": "c:\\testdata\\2500", "type": "filesystem", "status": "N" }, { "sid": "AAABcIueWUc=", "type": "filesystem", "seed": "c:\\testdata\\250000", "connector": "connector_1", "description": "250,000 files", "credential": "cred_1", "policy": "policy_1", "workflow": ["workflow_1","workflow_99"] "status": "N" }] }
Status
Response code | Description |
---|---|
201 | Created |
406 | Not acceptable - there was an issue validating the input |