Warning | ||
---|---|---|
| ||
This page is in development and as such, its contents may be incorrect |
The seeds The connections API provides functionality that allows a an administrator to perform actions such as adding and configuring a seed to connection to crawl, or beginning or stopping a crawl
Easy Heading Free | ||||
---|---|---|---|---|
| ||||
Section | ||||||||
---|---|---|---|---|---|---|---|---|
Get allseedsconnectionsLists all the seeds connections configured in the Aspire. This endpoint needs at least the OPERATOR role to be executed.
Query String Parameters | ||||||||
Name | Type | Required | Description | |||||
state | string | Optional | Filter returned seeds to only those with the given status(es) | |||||
type | string | Optional | Filter returned seeds to only those with the given type | |||||
description | string | Optional | Filter returned seeds to only those whose description matches the given expression |
connections |
Pagination query string parameters
Sorting query string parameter
Section | |||||||
---|---|---|---|---|---|---|---|
Get all connections, filteredLists connections configured in the Aspire, filtered by a specified criteria. This endpoint needs at least the OPERATOR role to be executed.
Pagination query string parameters |
Response
Code Block | ||||
---|---|---|---|---|
| ||||
{ "seedcount": [{ { "idtotalItems": "191283d9-183e-4820-8932-32b1fa07d2d5",2 }, "connectorconnection": "accd3396-6004-47c9-80a6-d6ae283878f5", [ "seed": "c:\\testdata\\2500", { "priority": "medium", "checksumid": "499207DDF2E673B3B33D74566D7457B5f0e88016-1a27-42b6-a5ae-31ab2226dbdc", "crawl": { "managertype": "manager_192.168.188.55:50505//AAABc8Mnl84=ldap", "modedescription": "fullLDAp-ik", "phaseproperties": "crawlStart", { "state "useScript": "runningfalse", "start": 1596707252548 } "useSearchBase": "true", }, { "idserver": "5d0b35d5-c946-44e7-9be5-97c9ad9036a3ldap://localhost:20389", "connectorauthentication": "accd3396-6004-47c9-80a6-d6ae283878f5simple", "seed": "c:\\testdata\\2500", "priorityuser": "mediumcn=admin,dc=accenture,dc=com", "checksum "password": "5647E40827A6C09CBA868294BB437CE5Adm1n!", "crawl": { "phasesearchBase": "idledc=accenture,dc=com", "state "userQuery": "never(objectClass=person)", } } ], "messagegroupQuery": "optional response message" } |
Status
Get information about a single seed configured in Aspire
Panel | ||||
---|---|---|---|---|
| ||||
|
Path Parameters
Response
Code Block | ||
---|---|---|
| ||
{ "seed": { (objectClass=groupOfUniqueNames)", "userAttributes": "<users><attribute>uid</attribute><attribute>givenName</attribute></users>", "iduserKeyAttr": "191283d9-183e-4820-8932-32b1fa07d2d5dn", "connector": "accd3396-6004-47c9-80a6-d6ae283878f5", "seeduserNameAttr": "c:\\testdata\\2500uid", "prioritygroupKeyAttr": "mediumdn", "checksumgroupNameAttr": "499207DDF2E673B3B33D74566D7457B5ou", "crawl": { "manager "groupMappingAttr": "manager_192.168.188.55:50505//AAABc8Mnl84=uniqueMember", "modegroupsHoldMembers": "fulltrue", "phase": "crawlStart", "stateuserGUID": "runningtrue", "start": 1596707252548 } }, "messageuserGUIDName": "optional response message" } |
Status
Add one or more seeds to Aspire
Panel | ||||
---|---|---|---|---|
| ||||
POST /aspire/_api/seeds |
Request Body Parameters
"objectGUID",
"isBinaryGUID": "true",
"lowerCase": "false"
}
},
{
"id": "98960f72-aab0-4ba1-a90e-b29d4e3c2c92",
"type": "filesystem",
"description": "Fs-ik",
"properties": {
"multipleStartPoints": "false",
"url": "C:\\tmp\\ach1",
"partialScan": "false",
"subDirUrl": null,
"indexContainers": "false",
"scanRecursively": "true",
"scanExcludedItems": "false",
"ignoreScanErrors": "false",
"ignoreSymLinks": "false",
"useACLs": "false",
"acls": null,
"includes": ".*test1.*",
"excludes": null
}
}
]
} |
Status: 200
Section | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Get a single connectionGet information about a single connection configured in Aspire. This endpoint needs at least the OPERATOR role to be executed.
Path Parameters
Response
Status: 200, 404 |
Section | ||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Add connection(s)Add connections to Aspire. This endpoint needs at least the ADMINISTRATOR role to be executed.
Body Parameters
Example
| ||||||||||||||||||||||||||||||||||||||||||||||
Name | Type | Required | 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 | Optional | An optional description of the seed | |||||||||||||||||||||||||||||||||||||||||||
credential | string | Optional | An optional id of the credential to use for this seed | |||||||||||||||||||||||||||||||||||||||||||
policy | string | Optional | An optional list of the policy identifiers to use for this seed | |||||||||||||||||||||||||||||||||||||||||||
workflow | string | Optional | An optional list of the workflow identifiers to use for this seed |
Code Block | ||
---|---|---|
| ||
POST /aspire/_api/seeds
{
"seed": "c:\\testdata\\2500",
"type": "filesystem"
} |
Add multiple seeds
Code Block | ||
---|---|---|
| ||
POST /aspire/_api/seeds
[{
"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
Code Block | ||
---|---|---|
| ||
{
"seed": [{
"id": "5d0b35d5-c946-44e7-9be5-97c9ad9036a3",
"connector": "accd3396-6004-47c9-80a6-d6ae283878f5",
"seed": "c:\\testdata\\2500",
"priority": "medium",
"checksum": "5647E40827A6C09CBA868294BB437CE5",
"crawl": {
"phase": "idle",
"state": "never"
}
},
{
"id": "5d0b35d5-c946-44e7-9be5-97c9ad9036a3",
"connector": "connector_1",
"description": "250,000 files",
"credential": "cred_1",
"policy": "policy_1",
"workflow": ["workflow_1","workflow_99"]
"seed": "c:\\testdata\\25000",
"priority": "medium",
"checksum": "5647E40827A6C09CBA868294BB437CE5",
"crawl": {
"phase": "idle",
"state": "never"
}
}],
"message": "optional response message"
} |
Status
Update one or more seeds in Aspire. Updates will be treated as partial updates rather than overwrites. If a field is not present in the input, any previous value will remain after the update. If you wish to "delete" a value, pass a value of null
Panel | ||||
---|---|---|---|---|
| ||||
|
Request Body Parameters
Examples
Update a single seed
Code Block | ||
---|---|---|
| ||
PUT /aspire/_api/seeds/AAABcID5GBc%3D
{
"id": "AAABcID5GBc=",
"seed": "c:\\testdata\\2500",
"type": "filesystem"
} |
Update multiple seeds
Code Block | ||
---|---|---|
| ||
PUT /aspire/_api/seeds { "AAABcID5GBc=": { "id": "AAABcID5GBc=", "seed": "c:\\testdata\\2500", "type": "filesystem", }, "AAABcIueWUc=description": { "id": "AAABcIueWUc="Remote Storage", "seedcredential": "c:\\testdata\\250000cred_1", "connectorproperties": "connector_1", "description": "250,000 files", "credential": "cred_1", { This will be a dynamic JSON object } }] |
Response
Code Block | ||||
---|---|---|---|---|
| ||||
{ "connection": [ { "policyid": "policy_15d0b35d5-c946-44e7-9be5-97c9ad9036a3", "workflowtype": [ "workflow_1filesystem","workflow_99"] } } |
Response
Code Block | ||
---|---|---|
| ||
{ "seed": [{ "iddescription": "AAABcID5GBc=Local Storage", "seedproperties": "c:\\testdata\\2500", "type": "filesystem", "status": "N" { This is a dynamic JSON object} }, { "id": "AAABcIueWUc=5d0b35d5-c946-44e7-9be5-97c9ad9036a4", "type": "filesystemsmb", "seeddescription": "c:\\testdata\\250000Remote Storage", "connectorcredential": "connectorcred_1", "descriptionproperties": "250,000 files", "credential": "cred_1",{ This is a dynamic JSON object} "policy": "policy_1", "workflow": ["workflow_1","workflow_99"] "status": "N" }], "message": "optional response message" } |
Status
}
]
} |
See Response Body for details regarding the response body returned where multiple items are affected with some (or all) returning errors.
Status: 201, 406
Section | |||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Update connection(s)Update connections in Aspire. This endpoint needs at least the ADMINISTRATOR role to be executed | |||||||||||||||||||||||||||||||||||||||||||||
Section | |||||||||||||||||||||||||||||||||||||||||||||
Delete seedsDelete one or more seeds from Aspire.
Path and Query String Parameters
Examples Delete a single seed
Delete multiple seeds
Body Parameters
x - at least one field must be present ExampleResponse
Status | |||||||||||||||||||||||||||||||||||||||||||||
Response code | Description | ||||||||||||||||||||||||||||||||||||||||||||
200 | Success | ||||||||||||||||||||||||||||||||||||||||||||
404 | Not found - a given seed identifier was not found | ||||||||||||||||||||||||||||||||||||||||||||
406 | Not acceptable - there was an issue validating the input | ||||||||||||||||||||||||||||||||||||||||||||
Section |
Panel | ||||
---|---|---|---|---|
| ||||
|
Path, Query String and Request Body Objects
The action to perform:
Defaults to start if not specified
The type of crawl to start:
Defaults to incremental if not specified
: "AAABcID5GBc=",
"description": "Local Storage",
"properties": { This is a dynamic JSON object}
},
"AAABcIueWUc=": {
"id": "AAABcIueWUc=",
"description": "Remote Storage",
"credential": "cred_2"
}
} |
Response
Code Block | ||||
---|---|---|---|---|
| ||||
{"server":[{"updated":true,"id":"AAABcID5GBc="},{"updated":true,"id":"AAABcID5GBd="}]} |
Status: 200, 404, 406
Section | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Update connections, filteredUpdate connections configured in the Aspire, filtered by a specified criteria. This endpoint needs at least the ADMINISTRATOR role to be executed.
Filters: The connection filter definition here
Response
Status: 200, 406 |
Section | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Delete connection(s)Delete one or more connections from Aspire. This endpoint needs at least the ADMINISTRATOR role to be executed. |
Code Block | ||
---|---|---|
| ||
POST /aspire/_api/seeds/191283d9-183e-4820-8932-32b1fa07d2d5/control |
Starts an full crawl for a single seed
Code Block | ||
---|---|---|
| ||
POST /aspire/_api/seeds/191283d9-183e-4820-8932-32b1fa07d2d5/control?action=start&type=full |
Pauses a crawl for a single seed
Code Block | ||
---|---|---|
| ||
POST /aspire/_api/seeds/191283d9-183e-4820-8932-32b1fa07d2d5/control?action=pause |
Starts a crawl for multiple seeds
Code Block | ||
---|---|---|
| ||
POST /aspire/_api/seeds/control
[{
"id": "AAABcID5GBc="
},
{
"id": "AAABcIueWUc="
}] |
Starts a crawl for multiple seeds (alternative)
Code Block | ||
---|---|---|
| ||
PUT /aspire/_api/seeds/control
{
"id": ["AAABcID5GBc=", "AAABcIueWUc="]
} |
Response
Code Block | ||
---|---|---|
| ||
{
"message": "optional response message"
} |
Status
Allows an administrator to manually re-balance the seed to manager allocation for active crawls
Panel | ||||
---|---|---|---|---|
| ||||
|
Code Block | ||
---|---|---|
| ||
{
"message": "optional response message"
} |
Status
|
Path Parameters and Query parameters
Name | Type | Required | Description |
---|---|---|---|
id | string | Required | The identifier(s) of the connection(s) to delete |
Body Parameter
Name | Type | Required | Description |
---|---|---|---|
ids | string | Required | The identifier(s) of the connection(s) to delete |
Examples
Code Block | ||||
---|---|---|---|---|
| ||||
DELETE /aspire/_api/connections/AAABcID5GBc
DELETE /aspire/_api/connections?id=AAABcID5GBc&id=AAABcID5GBd
POST /aspire/_api/connections/delete
{
"ids":["AAABcID5GBc","AAABcID5GBd"]
}
|
Response
Code Block | ||||
---|---|---|---|---|
| ||||
{
"message": "delete result response message"
} |
Status: 200, 404, 406
Section | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Delete multiple connections, filteredDelete multiple connections from Aspire, filtered by a specified criteria. This endpoint needs at least the ADMINISTRATOR role to be executed.
Filters: The connection filter definition here Response
Status: 200 |
Section | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Export connection(s)Export one or more connections from Aspire. This endpoint needs at least the OPERATOR role to be executed.
Path Parameters and Query parameters
Body Parameter
Examples
Response
Status: 200, 404, 406
|
Section |
---|
ImportThe import usage can be found here |
Section | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Filters
Some endpoint queries require a filter. A filter is basically a JSON object with the following format: Seed filter:
|