Page in development
This page is in development and as such, its contents may be incorrect
The service API provides functionality that allows a administrator to perform actions such as adding and configuring services
Lists all the services configured in the Aspire
GET /aspire_api/service
Query String Parameters
Name | Type | Required | Description |
---|---|---|---|
description | string | Optional | Filter returned services to only those whose description matches the given expression |
Response
{ "service": [{ "id": "AAABcID5GBc=", "description": "Group expansion service", ... }, { "id": "AAABcIueWUc=", "description": "LDAP cache service", ... }], "message": "optional response message" }
Status
Response code | Description |
---|---|
200 | Success |
Get information about a single service configured in Aspire
GET /aspire_api/service/:id
Path Parameters
Name | Type | Required | Description |
---|---|---|---|
id | string | Required | The id of the service to return |
Response
{ "service": { "id": "AAABcID5GBc=", "description": "Group expansion service", ... }, "message": "optional response message" }
Status
Response code | Description |
---|---|
200 | Success |
404 | The given service id was not found |
Adds a services to Aspire
POST /aspire_api/connector
Request Body Parameters
Name | Type | Required | Description |
---|---|---|---|
coords | string | Required | The maven coordinates of bundle to use for this service |
description | string | Optional | An optional description of the service |
Examples
Add a single service
{ "coords": "com.accenture.aspire:app-ge-manager", "description": "Group expansion service" ... }
Response
{ "service": { "id": "AAABcID5GBc=", "description": "Group expansion service" ... }, "message": "optional response message" }
Status
Response code | Description |
---|---|
201 | Created |
406 | Not acceptable - there was an issue validating the input |
Update a service 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/service
Request Body Parameters
Name | Type | Required | Description |
---|---|---|---|
id | string | Required | The identifier of the service to update |
description | string | Optional | An optional description of the service |
Examples
Update a single service
{ "id": "AAABcID5GBc=", "description": "Group expansion service", ... }
Response
{ "service": { "id": "AAABcID5GBc=", "description": "Group expansion service", ... }, "message": "optional response message" }
Status
Response code | Description |
---|---|
201 | Created |
404 | Not found - a given service identifier was not found |
406 | Not acceptable - there was an issue validating the input |
Delete one or more services from Aspire.
DELETE /aspire_api/service/:id
DELETE /aspire_api/service
Path and Request Body Parameters
Name | Type | Required | Description |
---|---|---|---|
id | string | Required | The identifier(s) of the service(s) to delete |
Examples
Delete a single service
{ "id": "AAABcID5GBc=" }
Delete multiple services
[{ "id": "AAABcID5GBc=" }, { "id": "AAABcIueWUc=" }]
Delete multiple services (alternative form)
{ "id": ["AAABcID5GBc=", "AAABcIueWUc="] }
Response
{ "message": "optional response message" }
Status
Response code | Description |
---|---|
200 | Success |
404 | Not found - a given service identifier was not found |
406 | Not acceptable - there was an issue validating the input |
Delete one or more services from Aspire.
DELETE /aspire_api/service/:id
DELETE /aspire_api/service/:id/:action
DELETE /aspire_api/service
QueryString, Path and Request Body Parameters
Name | Type | Required | Description |
---|---|---|---|
id | string | Required | The identifier(s) of the service(s) to control |
action | string | Optional | The action to perform
|
Examples
Start a single service
{ "id": "AAABcID5GBc=" }
Start multiple services
[{ "id": "AAABcID5GBc=" }, { "id": "AAABcIueWUc=" }]
Start multiple services (alternative form)
{ "id": ["AAABcID5GBc=", "AAABcIueWUc="] }
Response
{ "message": "optional response message" }
Status
Response code | Description |
---|---|
200 | Success |
404 | Not found - a given service identifier was not found |
406 | Not acceptable - there was an issue validating the input |