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.
Pagination query string parameters Response Sorting query string parameter
Response
Status | |||||||||||||||||||||||||||
Response code | Description | ||||||||||||||||||||||||||
200 | Success |
Section | |||||||
---|---|---|---|---|---|---|---|
Get all servers, filteredLists servers configured in the Aspire, filtered by a specified criteria
|
Section | |||||||
---|---|---|---|---|---|---|---|
Get a single serverGet information about a single server configured in Aspire
Path Parameters | |||||||
Name | Type | Required | Description | ||||
id | string | Required | The id of the server to return |
Code Block | ||
---|---|---|
| ||
{ "server": { "password": "Adm1n!", "searchBase": "dc=accenture,dc=com", "userQuery": "(objectClass=person)", "groupQuery": "(objectClass=groupOfUniqueNames)", "userAttributes": "<users><attribute>uid</attribute><attribute>givenName</attribute></users>", "userKeyAttr": "dn", "iduserNameAttr": "5d0b35d5-c946-44e7-9be5-97c9ad9036a4uid", "type "groupKeyAttr": "smbdn", "description": "Remote Storage", "createdgroupNameAttr": 1596707252548"ou", "updated": 1596707252548, "credentialgroupMappingAttr": "cred_1uniqueMember", "properties "groupsHoldMembers": { This is a dynamic JSON object} "true", }, "messageuserGUID": "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", true", "userGUIDName": "objectGUID", "isBinaryGUID": "true", "lowerCase": "false" } }, { "id": "98960f72-aab0-4ba1-a90e-b29d4e3c2c92", "type": "filesystem", "description": "Fs-ik", "properties": { This will be a dynamic JSON object } }] |
Response
Code Block | ||
---|---|---|
| ||
{ "server": [ "multipleStartPoints": "false", { "id": "5d0b35d5-c946-44e7-9be5-97c9ad9036a3", "typeurl": "filesystem"C:\\tmp\\ach1", "descriptionpartialScan": "Local Storagefalse", "created": 1596707252548, "updated": 1596707252548, "propertiessubDirUrl": {null, This is a dynamic JSON object} }, { "idindexContainers": "5d0b35d5-c946-44e7-9be5-97c9ad9036a4false", "type": "smb", "descriptionscanRecursively": "Remote Storagetrue", "created": 1596707252548, "updated": 1596707252548, "credentialscanExcludedItems": "cred_1false", "properties": { This is a dynamic JSON object} } ] } |
Status
"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
| |||||||||||||||
Section | |||||||||||||||
Update serversUpdate servers in Aspire.
Body Parameters | |||||||||||||||
Name | Type | Required | Description | ||||||||||||
id | string | Required | The identifier of the server to update | ||||||||||||
type | string | Optional | The type of server to add | ||||||||||||
description | string | Optional | An optional description of the server | ||||||||||||
credentials | string | Optional | Credentials can be specified for the server | ||||||||||||
properties | JSON | Optional | Dynamic JSON object with server properties (from dxf) |
Code Block | ||
---|---|---|
| ||
PUT /aspire/_api/servers
{
"AAABcID5GBc=": {
"id": "AAABcID5GBc=",
"description": "Local Storage",
"type": "filesystem"
},
"AAABcIueWUc=": {
"id": "AAABcIueWUc=",
"description": "Remote Storage",
"credential": "cred_2"
}
} |
Response
Code Block | ||||
---|---|---|---|---|
| ||||
{ "serverconnection": [ { "id": "AAABcID5GBc5d0b35d5-c946-44e7-9be5-97c9ad9036a4", "type": "filesystemsmb", "description": "LocalRemote Storage", "createdcredential": 1596707252548, "updated": 1596707252548"cred_1", "properties": { This is a dynamic JSON object} }, { "id": " "AAABcIueWUc=", "type": "smb", "description": "Remote Storage", "created": 1596707252548, "updated": 1596707252548, "credential": "cred_1", "properties": { This is a dynamic JSON object} } ] } |
Status
Delete multiple servers from Aspire, filtered by a specified criteria
} |
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
Response
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.
Path Parameters
Body Parameters
x - at least one field must be present Example
Response
|
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 | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Filters
Some endpoint queries require a filter. A filter is basically a JSON object with the following format: Seed filter:
|
Panel | ||||
---|---|---|---|---|
| ||||
|
Body Parameters
Response
Code Block | ||
---|---|---|
| ||
{
"message": "optional response message"
} |
See Response Body for details regrading the response body returned where multiple items are affected with some (or all) returning errors
Status
Delete a single server from Aspire.
Panel | ||||
---|---|---|---|---|
| ||||
|
Path Parameters
Example
Code Block | ||
---|---|---|
| ||
DELETE /aspire/_api/servers/AAABcID5GBc%3D |
Response
Code Block | ||
---|---|---|
| ||
{
"message": "optional response message"
} |
Status
Returns the dxf for a specific server type
Panel | ||||
---|---|---|---|---|
| ||||
GET /aspire/_api/servers/type/:typeId/dxf |
Path Parameters
Response
Code Block | ||
---|---|---|
| ||
{
"dxf": {...}
"message": "optional response message"
} |
Status