The credentials API provides functionality that allows a administrator to add, delete or update credentials
Easy Heading Free | ||||
---|---|---|---|---|
| ||||
Section | |||||||
---|---|---|---|---|---|---|---|
Get all credentialsLists all the credentials configured in the Aspire, this endpoint need the at least the OPERATOR role to be executed.
Query String Parameters | |||||||
Name | Type | Required | Description | ||||
start | integer | Optional | Retrieves the specified page of results | ||||
size | integer | Optional | Specifies the size of results page | sortBy | string | Optional | Field by which results are sorted
Section | |||||||
---|---|---|---|---|---|---|---|
Get all credentials, filteredLists credentials configured in the Aspire, filtered by a specified criteria, this endpoint need the at least the OPERATOR role to be executed.
Pagination query string parameters |
Response
Code Block | ||||
---|---|---|---|---|
| ||||
{ "credentialcount": [{ "id": "AAABcID5GBc=", "typetotalItems": "filesystem",1 "description": "Sales HD1 credentials"}, "createdcredential": 1596707252548,[ "updated": 1596707252548, "properties": { This will be a dynamic{ JSON object } }, { "id": "AAABcIueWUc=40b305ea-77e1-4874-aa28-964b1cf4a1a8", "type": "filesystem", "description": "Sales HD2 credentials", "createddescription": 1596707252548, "updatedxxxx": 1596707252548, "properties": { This will be a dynamic JSON object } }] } |
Status
Lists credentials configured in the Aspire, filtered by a specified criteria
Panel | ||||
---|---|---|---|---|
| ||||
{ } |
Query String Parameters
Response
Code Block | ||
---|---|---|
| ||
{ "credential": [{ "id": "AAABcID5GBc=", "throttlePolicy": "10653921-1b27-40b5-9d7a-f54ef1e3ad01", "typeproperties": "filesystem",{ "description": "Sales HD1 credentials", "created": 1596707252548, "updateddomain": 1596707252548"xxxx", "properties": { This will be a dynamic JSON object } }, { "iduser": "AAABcIueWUc=xxxx", "type": "filesystem", "descriptionpassword": "xxxx"Sales HD2 credentials", "created": 1596707252548, "updated": 1596707252548, "properties": { This will be a dynamic JSON object } } } } ] } |
: 200
Section | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Get a single credentialGet information about a single credential configured in Aspire, this endpoint need the at least the OPERATOR role to be executed.
Path Parameters
Response
| ||||||||||||||||||||||
Response code | Description | |||||||||||||||||||||
200 | Success | 404 | The given credentials id was not found
Section | |||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Addcredentialcredential(s)Add one or more Adds credentials to Aspire, this endpoint need the ADMINISTRATOR role to be executed.
Request Body Parameters
Examples
ExampleAdd a single credential
Add multiple credentials
Response
See Response Body for details regrading regarding the response body returned where multiple items are affected with some (or all) returning errors | |||||||||||||||||||||||||||||||||||||||||||||||
Response code | Description | ||||||||||||||||||||||||||||||||||||||||||||||
201 | Created | 406 | Not acceptable - there was an issue validating the input
Section | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Update credential(s)Update one or more credentials in Aspire, this endpoint needs the ADMINISTRATOR role to be executed.
Path and Request Body Parameters
Other parameters passed in the request body will depend on the type of credential being created - see Add credential(s) above Examples
x - at least one field must be present Update a single credentialExample - update more credentials
Update multiple credentials
Response
Status: 200, 404, 406
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
404 | Not found - a given credential identifier was not found |
Status: 200, 406 |
Section | |||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Delete credential(s)Delete one or more credentials connectors from Aspire, this endpoint need the ADMINISTRATOR role to be executed.
Path Parameters and Query string Parametersparameters
Examples Delete a single credential Body Parameter
Examples
Delete multiple credentials
Response
See Response Body for details regrading the response body returned where multiple items are affected with some (or all) returning errors Status | |||||||||||||||||||||||||||||||||||||||||||
Response code | Description | ||||||||||||||||||||||||||||||||||||||||||
200 | Success | ||||||||||||||||||||||||||||||||||||||||||
404 | Not found - a given credential identifier was not found | ||||||||||||||||||||||||||||||||||||||||||
406 | Not acceptable - there was an issue validating the input | ||||||||||||||||||||||||||||||||||||||||||
Section | |||||||||||||||||||||||||||||||||||||||||||
Status: 200, 404, 406
|
Section | |||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Export credentials(s)Export one or more credential from Aspire, this endpoint needs at least the OPERATOR role to be executed. Get credential type dxfReturns the dxf for a specific credential type
Path Parameters and Query parameters
Body ParameterQuery String Parameters
Examples
Response
Status | |||||||||||||||||||||||||||||||||||||||||||
Response code | Description | ||||||||||||||||||||||||||||||||||||||||||
200 | Success | ||||||||||||||||||||||||||||||||||||||||||
404 | Not found - a given service identifier was not found |
bearer",
"query": {
...
}
}
},
...
]
}
}
} |
Status: 200, 404, 406
Section | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Export multiple credentials, filteredExport multiple credentials from Aspire, filtered by a specified criteria, this endpoint needs at least the OPERATOR role to be executed.
Filters: The connection filter definition here Response
Status: 200 |
Section |
---|
ImportThe import usage can be found here |
Section | |||||||
---|---|---|---|---|---|---|---|
Filters
Credential | |||||||
Section | |||||||
FiltersSome endpoint queries require a filter. A filter is basically a JSON object with the following format: Credentials filter:
|