Page in development
This page is in development and as such, its contents may be incorrect
The connectors API provides functionality that allows a administrator to perform actions such as adding and configuring connectors
Lists all the connectors configured in the Aspire
GET /aspire_api/connectors
Query String Parameters
Name | Type | Required | Description |
---|---|---|---|
type | string | Optional | Filter returned connectors to only those with the given type |
description | string | Optional | Filter returned connectors to only those whose description matches the given expression |
Response
{ "connector": [{ "id": "AAABcID5GBc=", "type": "filesystem", "description": "NetApp connector", ... }, { "id": "AAABcIueWUc=", "type": "shareoint-online", "description": "SharePoint Online", ... }], "message": "optional response message" }
Status
Response code | Description |
---|---|
200 | Success |
Get information about a single connector configured in Aspire
GET /aspire_api/connectors/:id
Path Parameters
Name | Type | Required | Description |
---|---|---|---|
id | string | Required | The id of the connector to return |
Response
{ "connector": { "id": "AAABcID5GBc=", "type": "filesystem", "description": "NetApp connector", ... }, "message": "optional response message" }
Status
Response code | Description |
---|---|
200 | Success |
404 | The given connector id was not found |
Add one or more connectors to Aspire
POST /aspire_api/connectors
Request Body Parameters
Name | Type | Required | Description |
---|---|---|---|
type | string | Required | The type of this connector |
description | string | Optional | An optional description of the connector |
Examples
Add a single connector
{ "type": "filesystem", "description": "NetApp" ... }
Add multiple connectors
[{ "type": "filesystem", "description": "NetApp" ... }, { "type": "sharepoint", "description": "SharePoint Online" ... }]
Response
{ "connector": [{ "id": "AAABcID5GBc=", "type": "filesystem", "description": "NetApp" ... }, { "type": "sharepoint", "description": "SharePoint Online" ... }], "message": "optional response message" }
Status
Response code | Description |
---|---|
201 | Created |
406 | Not acceptable - there was an issue validating the input |
Updates one or more connectors in Aspire. Updates will be treated as partial updates rather than overwrites. If a field is not present in the input, any previous value will remain after the update. If you wish to "delete" a value, pass a value of null
PUT /aspire_api/connectors/:id
PUT /aspire_api/connectors
Request Body Parameters
Name | Type | Required | Description |
---|---|---|---|
id | string | Required | The identifier of the connector to update |
type | string | Required | The type of the connector |
description | string | Optional | An optional description of the connector |
Examples
Update a single connector
{ "id": "AAABcID5GBc=", "connector": "c:\\testdata\\2500", "type": "filesystem", ... }
Update multiple connectors
{ "AAABcID5GBc=": { "id": "AAABcID5GBc=", "connector": "c:\\testdata\\2500", "type": "filesystem", ... }, "AAABcID5GBc=": { "id": "AAABcID5GBd=", "connector": "c:\\testdata\\250", "type": "filesystem", ... } }
Response
{ "connector": [{ "id": "AAABcID5GBc=", "description": "Net App", "type": "filesystem", "status": "N" }], "message": "optional response message" }
Status
Response code | Description |
---|---|
201 | Created |
404 | Not found - a given connector identifier was not found |
406 | Not acceptable - there was an issue validating the input |
Delete one or more connectors from Aspire.
DELETE /aspire_api/connectors/:id
DELETE /aspire_api/connectors
Path and Query String Parameters
Name | Type | Required | Description |
---|---|---|---|
id | string | Required | The identifier(s) of the connector(s) to delete |
Examples
Delete a single connector
DELETE /aspire_api/connectors/AAABcID5GBc=
Delete multiple connectors
DELETE /aspire_api/connectors?id=AAABcID5GBc%3D&id=AAABcIueWUc%3D }]
Response
{ "message": "optional response message" }
Status
Response code | Description |
---|---|
200 | Success |
404 | Not found - a given connector identifier was not found |
406 | Not acceptable - there was an issue validating the input |