The connectors API provides functionality that allows a administrator or operator to perform actions such as adding and configuring connectors.
Easy Heading Free | ||||
---|---|---|---|---|
| ||||
Section | |||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Get all connectorsLists all the connectors configured in the Aspire, this endpoint need the at least the OPERATOR role to be executed.
Pagination query string parameters Sorting query string parameter
Response
Status: 200 |
Section | |||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Get a single connectorGet information about a single connector configured in Aspire, this endpoint need the at least the OPERATOR role to be executed.
Path Parameters
Response
Status: 200, 404
Status: 200, 404 |
Section | ||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Add connector(s)Add connectors to Aspire, this endpoint need the at least the ADMINISTRATOR role to be executed.
Body Parameters
| ||||||||||||||||||||||||||||||||||||||||||||||
Section | ||||||||||||||||||||||||||||||||||||||||||||||
Add connector(s)Add connectors to Aspire, this endpoint need the at least the ADMINISTRATOR role to be executed.
Body Parameters
Example
Response
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 connector(s)Updates connectors in Aspire, this endpoint need the ADMINISTRATOR role to be executed.
Path Parameters | ||||||||||||||||||||||||||||||||||||||||||||||
Name | Type | Required | Description | |||||||||||||||||||||||||||||||||||||||||||
id | string | Required | The identifier of the connector to update | |||||||||||||||||||||||||||||||||||||||||||
Name | Type | Required | Description | |||||||||||||||||||||||||||||||||||||||||||
id | string | Required | The identifier of the connector to update | description | string | properties | object |
Code Block |
---|
PUT /aspire/_api/connectors/600f70ef-7a90-4364-bdb9-7a9b5f81f6fe { "id": "600f70ef-7a90-4364-bdb9-7a9b5f81f6fe", "description": "NetApp - First- UPDATE", "properties": { "artifact": "com.accenture.aspire:aspire-filesystem-source", "type": "filesystem", "description": "FS_Demo_Test_1", "properties": { "enableFetcher": "true", "enableFetcherenableFetchUrl": "true", ..... } } |
Example - update more connectors
Code Block | ||
---|---|---|
| ||
PUT /aspire/_api/connectors { "AAABcID5GBc=": { "idinfoCacheSize": "AAABcID5GBc=100", .......... "description": "Net App" }, "properties": { "enableFetcherchecksum": "truec27b11a3996c4dc6f3a03b79397679fa68256241a865faeef7f06271b558bb46", ..... }, }{ }, "AAABcID5GBd=": { "id": "AAABcID5GBd=9ad25f3b-ae34-4cff-85e1-6884e5b8f070", "description "artifact": "Sharepoint onlinecom.accenture.aspire:aspire-filesystem-source", "properties": { "enableFetchertype": "truefilesystem", ..... } } } |
Response
Code Block | ||
---|---|---|
| ||
{"response"description":{"updated":true,"id":"AAABcID5GBc="}} {"response":{"connector":[{"updated":true,"id":"AAABcID5GBc="},{"updated":true,"id":"AAABcID5GBd="}]}} |
Status: 200, 404, 406
"FS_Demo_Test_2",
"properties": {
"enableFetcher": "true",
"enableFetchUrl": "true",
"infoCacheSize": "100",
.............
},
"checksum": "19a1ce2e3bb658c4831bbc706a13393874822bf03e1bac31a4f197770410afbb"
}
]
} |
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 connector(s)Updates connectors in Aspire, this endpoint need the ADMINISTRATOR | |||||||||||||||||||||||||||||||||||||
Section |
Panel | ||||
---|---|---|---|---|
| ||||
|
Filters: The connector filter definition here
Code Block |
---|
{
"update" : {
"description" : "DESCRIPTION"
"properties": {
"enableFetcher": "true",
.....
}
}
} |
Response
Code Block | ||
---|---|---|
| ||
{
"message": "update result response message"
} |
Status: 200, 406
Delete multiple connectors from Aspire, filtered by a specified criteria, this endpoint need the at least the ADMINISTRATOR role to be executed.
Panel | ||||
---|---|---|---|---|
| ||||
|
Filters: The connector filter definition here
Response
Code Block | ||
---|---|---|
| ||
{
"message": "delete result response message"
} |
Status: 200
|
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 connector to update |
description | string | x | The description of the connector |
properties | object | x | Connector properties |
x - at least one field must be present
Example - update one connector
Code Block | ||
---|---|---|
| ||
PUT |
Delete one or more connectors from Aspire, this endpoint need the at least the ADMINISTRATOR role to be executed.
Panel | ||||
---|---|---|---|---|
| ||||
|
Path Parameters and Query parameters
Body Parameter
Examples
Code Block | ||
---|---|---|
| ||
DELETE /aspire/_api/connectors/AAABcID5GBc DELETE /aspire/_api/connectors?id=AAABcID5GBc&id=AAABcID5GBd POST /aspire/_api/connectors/delete { "ids":["AAABcID5GBc","AAABcID5GBd"] } |
Response
Code Block | ||
---|---|---|
| ||
{
"message": "delete result response message"
} |
Status: 200, 404, 406
600f70ef-7a90-4364-bdb9-7a9b5f81f6fe
{
"id": "600f70ef-7a90-4364-bdb9-7a9b5f81f6fe",
"description": "NetApp - First- UPDATE",
"properties": {
"enableFetcher": "true",
.....
}
} |
Example - update more connectors
Code Block | ||||
---|---|---|---|---|
| ||||
PUT |
Lists all available connectors types
Panel | ||||
---|---|---|---|---|
| ||||
Code Block | ||||
| ||||
GET /aspire/_api/connectors /type |
Response
{ "typeAAABcID5GBc=": [{ "id": "filesystemAAABcID5GBc=", "description": "FilesytemNet ConnectorApp", "coordinates "properties": "com.accenture.aspire:aspire-filesystem-source"{ }, { "idenableFetcher": "sharepoint-onlinetrue", ..... "description": "SharePoint Online Connector} }, "AAABcID5GBd=": { "id": "AAABcID5GBd=", "coordinatesdescription": "com.accenture.aspire:aspire-sharepoint-online-source" }, ... ] } |
Status: 200
Returns the type of a specific connector
Panel | ||||
---|---|---|---|---|
| ||||
GET /aspire/_api/connectors/:id/type |
Path Parameters
Sharepoint online",
"properties": {
"enableFetcher": "true",
.....
}
}
} |
Response
Code Block | ||||
---|---|---|---|---|
| ||||
{"connector":[{"updated":true,"id":"AAABcID5GBc="},{"updated":true,"id":"AAABcID5GBd="}]} |
Status: 200, 404, 406
Section |
---|
Update connectors, filteredUpdate connectors configured in the Aspire, filtered by a specified criteria, this endpoint need the ADMINISTRATOR role to be executed. |
Response
Code Block | ||
---|---|---|
| ||
{
"type": [{
"id": "filesystem",
"description": "Filesytem Connector",
"coordinates": "com.accenture.aspire:aspire-filesystem-source"
}
]
} |
Status: 200
|
Path Parameters
Filters: The connector filter definition here
Response
Status: 200, 406 |
Section | |||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Delete connector(s)Delete one or more connectors from Aspire, this endpoint need the ADMINISTRATOR role to be executed.
Path Parameters and Query parameters
Body Parameter
Examples
Response
Status: 200, 404, 406
|
Section | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Export connector(s)Export one or more connector 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 Response
Status: 200 |
Section | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Filters
Some endpoint queries require a filter. A filter is basically a JSON object with the following format: Seed filterConnector filter:
|