Warning | ||
---|---|---|
| ||
This page is in development and as such, its contents may be incorrect |
The servers The connections API provides functionality that allows a an administrator to perform actions such as adding and configuring a server to connection to crawl, or beginning or stopping a crawl
Easy Heading Free | ||||
---|---|---|---|---|
| ||||
Section | ||||||||
---|---|---|---|---|---|---|---|---|
Get allserversconnectionsLists all the servers connections configured in the Aspire. This endpoint needs at least the OPERATOR role to be executed.
Query String Parameters | ||||||||
Name | Type | Required | Description | |||||
from | integer | Optional | Indicates the initial page to be retrieved | |||||
size | integer | Optional | Specifies the size of results page | |||||
sortBy | string | Optional | Field by which results are sorted | |||||
sortMode | string | Optional | Sort mode
| expand | string | Optional |
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 | ||||
---|---|---|---|---|
| ||||
{ "servercount": [{ { "idtotalItems": "5d0b35d5-c946-44e7-9be5-97c9ad9036a3", 2 }, "typeconnection": [ "filesystem", { "descriptionid": "Local Storagef0e88016-1a27-42b6-a5ae-31ab2226dbdc", "created": 1596707252548, "updatedtype": 1596707252548"ldap", "properties": { This is a dynamic JSON object} "description": "LDAp-ik", }, { "idproperties": "5d0b35d5-c946-44e7-9be5-97c9ad9036a4", { "type": "smb", "descriptionuseScript": "Remote Storagefalse", "created": 1596707252548, "updated": 1596707252548, "credentialuseSearchBase": "cred_1true", "properties": { This is a dynamic JSON object} } ], "from": 100, "size": 10, "sortBy"server": "ldap://localhost:20389", "authentication": "idsimple", "sortMode "user": "asc"cn=admin,dc=accenture,dc=com", "totalItems": 10000, "message": "optional response message" } |
Status
Lists servers configured in the Aspire, filtered by a specified criteria
Panel | ||||
---|---|---|---|---|
| ||||
|
Query String Parameters
Sort mode
Body Parameters
Response
Code Block | ||
---|---|---|
| ||
{ "server": [ { "id": "5d0b35d5-c946-44e7-9be5-97c9ad9036a3", "type": "filesystem", "password": "Adm1n!", "searchBase": "dc=accenture,dc=com", "userQuery": "(objectClass=person)", "groupQuery": "(objectClass=groupOfUniqueNames)", "userAttributes": "<users><attribute>uid</attribute><attribute>givenName</attribute></users>", "userKeyAttr": "dn", "userNameAttr": "uid", "descriptiongroupKeyAttr": "Local Storagedn", "created": 1596707252548, "updated": 1596707252548, "propertiesgroupNameAttr": {"ou", This is a dynamic JSON object} }, { "idgroupMappingAttr": "5d0b35d5-c946-44e7-9be5-97c9ad9036a4uniqueMember", "typegroupsHoldMembers": "smbtrue", "description": "Remote Storage", "createduserGUID": 1596707252548"true", "updated": 1596707252548, "credential": "cred_1", "propertiesuserGUIDName": "objectGUID", { This is a dynamic JSON object} } ], "fromisBinaryGUID": 100, "sizetrue": 10, "sortBy "lowerCase": "idfalse", "sortMode": "asc" "totalItems": 10000 } }, "message": "optional response message" } |
Status
Get information about a single server configured in Aspire
Panel | ||||
---|---|---|---|---|
| ||||
|
Path Parameters
Query String Parameters
Response
Code Block | ||
---|---|---|
| ||
{ "server": { { "id": "98960f72-aab0-4ba1-a90e-b29d4e3c2c92", "idtype": "5d0b35d5-c946-44e7-9be5-97c9ad9036a4filesystem", "type": "smb", "description": "Remote StorageFs-ik", "createdproperties": 1596707252548, "updated": 1596707252548, { "credentialmultipleStartPoints": "cred_1false", "properties": { This is a dynamic JSON object} }"url": "C:\\tmp\\ach1", "message": "optional response message" } |
Status
Add servers to Aspire
Panel | ||||
---|---|---|---|---|
| ||||
POST /aspire/_api/servers |
Body Parameters
The type of server to add
Example
Code Block | ||
---|---|---|
| ||
POST /aspire/_api/servers
[{
"type": "filesystem",
"description": "Local storage",
"properties": { This will be a dynamic JSON object }
},
{
"type": "filesystem",
"description": "Remote Storage",
"credential": "cred_1",
"properties": { This will be a dynamic JSON object }
}] |
Response
Code Block | ||
---|---|---|
| ||
{ "server": [ { "id": "5d0b35d5-c946-44e7-9be5-97c9ad9036a3", "type": "filesystem", "partialScan": "false", "subDirUrl": null, "indexContainers": "false", "scanRecursively": "true", "scanExcludedItems": "false", "ignoreScanErrors": "false", "ignoreSymLinks": "false", "useACLs": "false", "acls": null, "descriptionincludes": "Local Storage.*test1.*", "created": 1596707252548, "updated": 1596707252548, "propertiesexcludes": null { This is a dynamic JSON object} }, { } "id": ] } |
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
| ||||||||||||||||||||||
Response code | Description | |||||||||||||||||||||
201 | Created | |||||||||||||||||||||
406 | Not acceptable - there was an issue validating the input |
Section | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Add connection(s)Add connections to Aspire. This endpoint needs at least the ADMINISTRATOR role to be executed | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Section | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Update serversUpdate servers in Aspire.
Body Parameters
Example
Response
Response
Status | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Response code | Description | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
201 | Created | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
404 | Not found - a given server identifier was not found | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
406 | Not acceptable - there was an issue validating the input | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Section | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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. Delete multiple servers, filteredDelete multiple servers from Aspire, filtered by a specified criteria
Path Body Parameters
Body Parameters
x - at least one field must be present ExampleResponse
See Response Body for details regrading the response body returned where multiple items are affected with some (or all) returning errors Status | |||||||||||||||||||||||||||||||||||
Response code | Description | ||||||||||||||||||||||||||||||||||
200 | Success | ||||||||||||||||||||||||||||||||||
404 | Not found - a given credential identifier was not found | ||||||||||||||||||||||||||||||||||
406 | Not acceptable - there was an issue validating the input | ||||||||||||||||||||||||||||||||||
Section | |||||||||||||||||||||||||||||||||||
Response
Delete single serverDelete a single server from Aspire.
Path Parameters | |||||||||||||||||||||||||||||||||||
Name | Type | Required | Description | ||||||||||||||||||||||||||||||||
id | string | Required | The identifier of the server to delete |
Code Block | ||
---|---|---|
| ||
DELETE /aspire/_api/servers/AAABcID5GBc%3D |
Response
Filters: The connection filter definition here
| |||||||
Code Block | |||||||
---|---|---|---|---|---|---|---|
language | js
|
Status
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.
Path Parameters and Query parameters
Body Parameter
Examples
Response
Status: 200, 404, 406
|
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 | |||||||
Get server type dxfReturns the dxf for a specific server type
Path Parameters | |||||||
Name | Type | Required | Description | ||||
typeId | string | Required | The id of the type for which dxf is going to be retrieved |
Code Block | ||
---|---|---|
| ||
{
"dxf": {...}
"message": "optional response message"
} |
Status
Section | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Filters
Some endpoint queries require a filter. A filter is basically a JSON object with the following format: Credentials Seed filter:
|