Warning | ||
---|---|---|
| ||
This page is in development and as such, its contents may be incorrect |
The servers API provides functionality that allows a administrator to perform actions such as adding and configuring a server to crawl, or beginning or stopping a crawl
Table of Contents |
---|
Section | |||||||
---|---|---|---|---|---|---|---|
Get all serversLists all the servers configured in the Aspire
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 | List of fields to expand, * will expand everything
Code Block | ||
---|---|---|
| ||
{ "server": [ { "id": "5d0b35d5-c946-44e7-9be5-97c9ad9036a3", "type": "filesystem", "description": "Local Storage", "created": 1596707252548, "updated": 1596707252548, "properties": { This is a dynamic JSON object} }, { "id": "5d0b35d5-c946-44e7-9be5-97c9ad9036a4", "type": "smb", "description": "Remote Storage", "created": 1596707252548, "updated": 1596707252548, "credential": "cred_1", "properties": { This is a dynamic JSON object} } ], "from": 100, "size": 10, "sortBy": "id", "sortMode": "asc" "totalItems": 10000, "message": "optional response message" } |
Status
Response code | Description |
---|---|
200 | Success |
Section | |||||||
---|---|---|---|---|---|---|---|
Get all servers, filteredLists servers configured in the Aspire, filtered by a specified criteria
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 | List of fields to expand, * will expand everything | ||||
Name | Type | Required | Description | ||||
filter | JSON | Required | Filters retrieved servers. Check the filter definition here |
Code Block | ||
---|---|---|
| ||
{
"server": [
{
"id": "5d0b35d5-c946-44e7-9be5-97c9ad9036a3",
"type": "filesystem",
"description": "Local Storage",
"created": 1596707252548,
"updated": 1596707252548,
"properties": { This is a dynamic JSON object}
},
{
"id": "5d0b35d5-c946-44e7-9be5-97c9ad9036a4",
"type": "smb",
"description": "Remote Storage",
"created": 1596707252548,
"updated": 1596707252548,
"credential": "cred_1",
"properties": { This is a dynamic JSON object}
}
],
"from": 100,
"size": 10,
"sortBy": "id",
"sortMode": "asc"
"totalItems": 10000,
"message": "optional response message"
} |
Status
Section | ||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Get a single serverGet information about a single server configured in Aspire
Path Parameters
Query String Parameters
Response
Status
|
Section | |||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Add serversAdd servers to Aspire
Body Parameters
Example
Response
Status
|
Section | |||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Update serversUpdate servers in Aspire.
Body Parameters
Example
Response
Status
|
Section | ||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Delete multiple servers, filteredDelete multiple servers from Aspire, filtered by a specified criteria
Body Parameters
Response
See Response Body for details regrading the response body returned where multiple items are affected with some (or all) returning errors Status
|
Section | |||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Delete single serverDelete a single server from Aspire.
Path Parameters
Example
Response
Status
|
Section | ||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Get server type dxf (TODO)Returns the dxf for a specific server type
Path Parameters
Response
Status
| ||||||||||||||||||||||||||
Section | ||||||||||||||||||||||||||
Filters Anchor | | FiltersAnchor | FiltersAnchor |
Code Block | ||
---|---|---|
| ||
"filter" : {
"ids" : ["ID1", "ID2", "ID3", ...],
"type" : "TYPE",
"description" : "DESCRIPTION"
}
|