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 servers

Lists all the servers configured in the Aspire

Panel

borderColor	black
bgColor	#fafafb

GET /aspire/_api/servers

Pagination query string parameters

Section

Get all servers, filtered

Lists servers configured in the Aspire, filtered by a specified criteria

Panel

borderColor	black
bgColor	#fafafb

POST /aspire/_api/servers/getAll

Pagination query string parameters

Common filter

Response

Code Block

language	js

{
  "server": [
    {
      "id": "5d0b35d5-c946-44e7-9be5-97c9ad9036a3",
      "type":   "filesystem",        
      "description": "Local Storage",
      "credential": "cred_0",
      "properties": { This is a dynamic JSON object}
    },
    {
      "id": "5d0b35d5-c946-44e7-9be5-97c9ad9036a4",
      "type": "smb",
      "description": "Remote Storage",
	  "credential": "cred_1",
      "properties": { This is a dynamic JSON object}
    }
  ],
  "from": 100,
  "size": 10,
  "totalItems": 10000
}

Status: 200

Section

Get a single server

Get information about a single server configured in Aspire

Panel

borderColor	black
bgColor	#fafafb

GET /aspire/_api/servers/:id

Path Parameters

Name	Type	Required	Description
id	string	Required	The id of the server to return

Response

Code Block

language	js

{
  "server": {
      "id": "5d0b35d5-c946-44e7-9be5-97c9ad9036a4",
      "type": "smb",
      "description": "Remote Storage",
	  "credential": "cred_1",
      "properties": { This is a dynamic JSON object}
    }
}

Status: 200, 404

Section

Add server(s)

Add servers to Aspire

Panel

borderColor	black
bgColor	#fafafb

POST /aspire/_api/servers

Body Parameters

Name	Type	Required	Description
type	string	Required	The type of server to add
description	string	Required	An optional description of the server
credential	string	Optional	Credential id can be specified for the server
properties	JSON	Required	Dynamic JSON object with server properties

Example

Code Block

language	js

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

language	js

{
  "server": [
    {
      "id": "5d0b35d5-c946-44e7-9be5-97c9ad9036a3",
      "type":   "filesystem",        
      "description": "Local Storage",
      "properties": { This is a dynamic JSON object}
    },
    {
      "id": "5d0b35d5-c946-44e7-9be5-97c9ad9036a4",
      "type": "smb",
      "description": "Remote Storage",
	  "credential": "cred_1",
      "properties": { This is a dynamic JSON object}
    }
  ]
}

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 server(s)

Update servers in Aspire.

Panel

borderColor	black
bgColor	#fafafb

PUT /aspire/_api/servers/:id

PUT /aspire/_api/servers

Note
The existing document will be replaced by the new one provided in the body

Path Parameters

Name	Type	Required	Description
id	string	Required	The identifier of the connector to update

Body Parameters

Name	Type	Required	Description
id	string	Required	The identifier of the server to update
...

+ fields from "Add" section...

Example

Code Block

language	js

PUT /aspire/_api/servers
{
  "AAABcID5GBc=": {
    "id": "AAABcID5GBc=",
    "description": "Local Storage",
    "type": "filesystem"
    "properties": { This is a dynamic JSON object}
  },
  "AAABcIueWUc=": {
    "id": "AAABcIueWUc=",
    "description": "Remote Storage",
    "credential": "cred_2"
    "properties": { This is a dynamic JSON object}
  }
}

Response

Code Block

language	js

{
  "server": [
    {
      "id": "AAABcID5GBc",
      "type":   "filesystem",        
      "description": "Local Storage",
      "properties": { This is a dynamic JSON object}
    },
    {
      "id": "  "AAABcIueWUc=",
      "type": "smb",
      "description": "Remote Storage",
	  "credential": "cred_1",
      "properties": { This is a dynamic JSON object}
    }
  ]
}

See Response Body for details regarding the response body returned where multiple items are affected with some (or all) returning errors

Status: 200, 404, 406

Section

Update servers, filtered

Update servers configured in the Aspire, filtered by a specified criteria

Panel

borderColor	black
bgColor	#fafafb

POST /aspire/_api/servers/updateAll

Common filter

Update body parameter

Response

Code Block

language	js

{
  "message": "update result response message"
}

Status: 200, 406

Section

Delete multiple servers, filtered

Delete multiple servers from Aspire, filtered by a specified criteria

Panel

borderColor	black
bgColor	#fafafb

POST /aspire/_api/servers/deleteAll

Common filter

Response

Code Block

language	js

{
  "message": "optional response message"
}

Status: 200

Section

Delete servers(s)

Delete one or more servers from Aspire.

Panel

borderColor	black
bgColor	#fafafb

DELETE /aspire/_api/servers/:id

DELETE /aspire/_api/servers

POST /aspire/_api/servers/delete

Path Parameters and Query parameters

Name	Type	Required	Description
id	string	Required	The identifier(s) of the server(s) to delete

Body Parameter

Name	Type	Required	Description
ids	string	Required	The identifier(s) of the server(s) to delete

Examples

Code Block

language	js

DELETE /aspire/_api/servers/AAABcID5GBc

DELETE /aspire/_api/servers?id=AAABcID5GBc&id=AAABcID5GBd

POST /aspire/_api/servers/delete
{
  "ids":["AAABcID5GBc","AAABcID5GBd"]
}

Response

Code Block

language	js

{
  "message": "delete result response message"
}

Status: 200, 404, 406

Section

Get server type dxf (TODO)

Returns the dxf for a specific server type

Panel

borderColor	black
bgColor	#fafafb

GET /aspire/_api/servers/type/:typeId/dxf

Path Parameters

Name	Type	Required	Description
typeId	string	Required	The id of the type for which dxf is going to be retrieved

Response

Code Block

language	js

{
  "dxf": {...}
  "message": "optional response message"
}

Status: 200, 404

Page tree

Versions Compared

Old Version 18

New Version 19

Key

Get all servers

Get all servers, filtered

Get a single server

Add server(s)

Update server(s)

Update servers, filtered

Delete multiple servers, filtered

Delete servers(s)

Get server type dxf (TODO)

Page tree

Page History

Versions Compared

Old Version 18

New Version 19

Key

Get all servers

Get all servers, filtered

Get a single server

Add server(s)

Update server(s)

Update servers, filtered

Delete multiple servers, filtered

Delete servers(s)

Get server type dxf (TODO)