Easy Heading Free |
---|
navigationTitle | On this Page |
---|
navigationExpandOption | expand-all-by-default |
---|
|
The configuration and control API provides functionality that allows a an administrator to perform actions such as adding a seed to 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
Common parts
Those parts are described here once for all endpoints. They are referenced from the specific chapters when needed.
Anchor |
---|
| PaginationQueryStringParameters |
---|
| PaginationQueryStringParameters |
---|
|
Pagination query string parameters
...
Name | Type | Required | Default | Description |
---|
from | long | Optional | 0 | The offset in to into the results list from which results should be returned |
size | long | Optional | 25/unlimited | The (maximum) number of items to be returned in the results list Note: The results list is only limited if the size parameter is set (even to 0). If the size is not set, Aspire will assume you are trying to retrieve all items. TODO: the defaults not implemented
|
Where paging parameters are applied, Aspire will add a "count" to the returned object to inform the total number of objects that exists (the fields being from, size, totalItems) TODO: not implemented
Anchor |
---|
| SortingQueryStringParameters |
---|
| SortingQueryStringParameters |
---|
|
Sorting query string parameters...
NameName | Type | Required | Description |
---|
sortBy | string | Optional | Field by which results are sorted. The fields are "description" or "type" |
sortMode | string | Optional | Sort mode - "asc" for ascending sort,
- "desc" for descending sort
|
...
Name | Type | Required | Description |
---|
$expand | string | Optional | Comma separated list of fields to expand, * will expand everything |
...
Filter body parameter
Anchor |
---|
| FiltersAnchor |
---|
| FiltersAnchor |
---|
|
...
Some endpoint queries
...
support a filter.
...
The common filter is basically a JSON object with the following format
...
Code Block |
---|
|
{
"filter" : {
"ids" : ["ID1", "ID2", "ID3", ...],
"type" : "TYPE",
"description" : "DESCRIPTION"
}
Note |
---|
When using endpoints that use this filter, the filter cannot be empty: at least one field of the filter must be specified. |
|
Responses
Update body parameter
Anchor |
---|
| UpdatesAnchor |
---|
| UpdatesAnchor |
---|
|
Some update endpoint queries support an update object which together with the filtering above allows for "update by query" functionality. The update is basically a JSON object with the following format
Code Block |
---|
|
{
"update" : {
"description" : "DESCRIPTION"
}
} |
Responses
Aspire's API will return Aspire's API will return both an HTTP response code and a Json JSON body indicating the success or failure of all calls. The following status codes are used
Anchor |
---|
| ResponseStatus |
---|
| ResponseStatus |
---|
|
Status
Response code | Description |
---|
200 | Success Success with errors (batch mode)* |
201 TODO: not implemented | Created |
400 | Bad request |
404 | Not foundFound |
406 | Not acceptable |
* batch requests requests (those calls capable of creating, updating, deleting, or controlling more than a single item/object at a time - update multiple connectors for example) will return a status of 200 for the call itself and other status inside the Json body.
...
Response Body
Where an API call causes a single item to be successful created or updated, the body of the response will contain the item itself. The response shown below This is an example of the body returned if a single connector was created or updated (response status 200 or 201)response to this GET request - - /aspire/_api/workflows?sparse=true&from=0&size=2
Code Block |
---|
|
{
"count |
Code Block |
---|
|
{
"connector": {
"idfrom": "1823c41f-ba3e-43e0-aae5-dd38665d021a"0,
"typesize": "filesystem"2,
"description": "NetApp",
"application "totalItems": {3
"@config": "com.accenture.aspire:aspire-filesystem-source"},
"propertiesworkflow": {[
"property": [{
"@nameid": "enableFetcherf5daef4d-fd4b-4e01-bd7b-b00334601b73",
"$type": "true"
},
connector",
{
"@namedescription": "enableTextExtractPublish to Elastic-1",
"$checksum": "trueb0bb8b191d7bba8a0c32b8db091937a617e14ad0e768da2c0a75e360aff45430"
},
{
"@nameid": "extractTextConfiguratione33a890a-cea9-48c0-8db9-07533444820f",
"$type": "falseconnector",
}
"description": "Publish ]to Elastic-1",
}
},
"sourcechecksum": {"1d3e041ca4de48edcee85d46217d928846077277f39d07eac6e4206a2ce8966d"
"multipleStartPoints": "false", }
"url": "c:\\tmp\\ach1",
"partialScan": "false",
"subDirUrl": null,
]
} |
Where an API call causes a single item to be successful created , the body of the response will contain the item itself. The response shown below is an example of the body returned if a single connector was created or updated (response status 200 or 201)
Code Block |
---|
|
{
"connector": {
"indexContainersid": "falseAAABcID5GBc=",
"scanRecursivelytype": "truefilesystem",
"scanExcludedItemsdescription": "falseNetApp connector",
"ignoreScanErrorscreated": "false"1596707252548,
"ignoreSymLinksupdated": "false"1596707252548,
"useACLsproperties": "false",
{ This will be a dynamic "acls": null,
"includes": null,
"excludes": null
},
JSON object }
}
} |
Where multiple items/objects to be affected, an array will be returned in place of an object. The response shown below is an example of the body returned if two connectors were created (response status 200)
Code Block |
---|
|
{
"connector": [{
"general": {
"@activeid": "trueAAABcID5GBc=",
"displayNametype": "File Systemfilesystem",
"schedulesdescription": {"NetApp connector",
"created": 1596707252548,
"scheduleupdated": {1596707252548,
"@actionproperties": "start",
{ This will be a dynamic JSON object }
},
"@actionProperties{
"id": "incrementalAAABcIueWUc=",
"@typetype": "manuallysharepoint-online",
"description": }"SharePoint Online",
}"created": 1596707252548,
"normalizedNameupdated": "File_System"1596707252548,
},
"checksum": "BB580D32A38A50D6A9D6A3CD59AA01E0""properties": { This will be a dynamic JSON object }
}]
} |
Where multiple itemsShould multiple items/objects to be affected , an array will be returned in place of an objectand some (or all) result in errors, information about any unsuccessful call will be included in an error section for the response. The response shown below is an example of the body returned if two four connectors were created or updated submitted for creation and two encountered an error (response status 200)
Code Block |
---|
|
{
"connector": [{
"id": "1823c41f-ba3e-43e0-aae5-dd38665d021a",
"type": "filesystem",
"description": "NetApp",
"application": {
"@config": "com.accenture.aspire:aspire-filesystem-source",
"properties": {
"property": [{
"@name": "enableFetcher",
"$": "true"
},
{
"@name": "enableTextExtract",
"$": "true"
},
{
"@name": "extractTextConfiguration",
"$": "false"
}
]
}
},
"source": {
"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": null,
"excludes": null
},
"general": {
"@active": "true",
"displayName": "File System",
"schedules": {
"schedule": {
"@action": "start",
"@actionProperties": "incremental",
"@type": "manually"
}
},
"normalizedName": "File_System"
},
"checksum": "BB580D32A38A50D6A9D6A3CD59AA01E0"
},
{
"id": "26ab9abc-ca81-407b-89e3-21557996cce6",
"type": "filesystem",
"description": "NetApp",
"application": {
"@config": "com.accenture.aspire:aspire-filesystem-source",
"properties": {
"property": [{
"@name": "enableFetcher",
"$": "true"
},
{
"@name": "enableTextExtract",
"$": "true"
},
{
"@name": "extractTextConfiguration",
"$": "false"
}
]
}
},
"source": {
"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": null,
"excludes": null
},
"general": {
"@active": "true",
"displayName": "File System",
"schedules": {
"schedule": {
"@action": "start",
"@actionProperties": "incremental",
"@type": "manually"
}
},
"normalizedName": "File_System"
},
"checksum": "02422FD1FBE42E197998D9E13CA07166"
}
]
} |
Should multiple items/objects to be affected and some (or all) result in errors, information about any unsuccessful call will be included in an error section for the response. The response shown below is an example of the body returned if four connectors submitted for update and two encountered and error (response status 200)
|
{
"connector": [{
"id": "AAABcID5GBc=",
"type": "filesystem",
"description": "NetApp connector",
"created": 1596707252548,
"updated": 1596707252548,
"properties": { This will be a dynamic JSON object }
},
{
"id": "AAABcIueWUc=",
"type": "sharepoint-online",
"description": "SharePoint Online",
"created": 1596707252548,
"updated": 1596707252548,
"properties": { This will be a dynamic JSON object }
} |
Code Block |
---|
|
{
"connector": [{
"id": "1823c41f-ba3e-43e0-aae5-dd38665d021a",
"type": "filesystem",
"description": "NetApp",
"application": {
"@config": "com.accenture.aspire:aspire-filesystem-source",
"properties": {
"property": [{
"@name": "enableFetcher",
"$": "true"
},
{
"@name": "enableTextExtract",
"$": "true"
},
{
"@name": "extractTextConfiguration",
"$": "false"
}
]
}
},
"source": {
"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": null,
"excludes": null
},
"general": {
"@active": "true",
"displayName": "File System",
"schedules": {
"schedule": {
"@action": "start",
"@actionProperties": "incremental",
"@type": "manually"
}
},
"normalizedName": "File_System"
},
"checksum": "BB580D32A38A50D6A9D6A3CD59AA01E0"
},
{
"id": "26ab9abc-ca81-407b-89e3-21557996cce6",
"type": "filesystem",
"description": "NetApp",
"application": {
"@config": "com.accenture.aspire:aspire-filesystem-source",
"properties": {
"property": [{
"@name": "enableFetcher",
"$": "true"
},
{
"@name": "enableTextExtract",
"$": "true"
},
{
"@name": "extractTextConfiguration",
"$": "false"
}
]
}
},
"source": {
"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": null,
"excludes": null
},
"general": {
"@active": "true",
"displayName": "File System",
"schedules": {
"schedule": {
"@action": "start",
"@actionProperties": "incremental",
"@type": "manually"
}
},
"normalizedName": "File_System"
},
"checksum": "02422FD1FBE42E197998D9E13CA07166"
}
],
"error": {
"connector": [{
"id": "aaf15f20-c334-4f5f-a34f-f308360c2092",
"status": 406,
"message": "java.lang.RuntimeException: testing exception"
},
{
"id": "dde02131-ce63-4639-afee-d72293eef5e0",
"status": 406,
"message": "java.lang.RuntimeException: another testing exception"
}
]
}
} |
...