Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Warning
titlePage 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

Table of Contents

Section

List services

Lists all the services configured in the Aspire

Panel
borderColorblack
bgColor#fafafb
GET /aspire_api/service

Query String Parameters

NameTypeRequiredDescription
typestringOptionalFilter returned services to only those with the given type
descriptionstringOptionalFilter returned services to only those whose description matches the given expression

Response

Code Block
languagejs
{
  "service": [{
    "id": "AAABcID5GBc=",
    "typedescription": "filesystem",
    "description": "NetApp Group expansion service",
    ...
  },
  {
    "id": "AAABcIueWUc=",
    "typedescription": "shareoint-online",
    "description": "SharePoint OnlineLDAP cache service",
    ...
  }],
  "message": "optional response message"
}

Status

Response codeDescription
200Success




Section

Get a single service

Get information about a single service configured in Aspire

Panel
borderColorblack
bgColor#fafafb

GET /aspire_api/service?id=:id

GET /aspire_api/service/:id

Query String and Path Parameters

NameTypeRequiredDescription
idstringRequiredThe id of the service to return

Response

Code Block
languagejs
{
  "service": {
    "id": "AAABcID5GBc=",
    "typedescription": "filesystem",
    "description": "NetAppGroup expansion service",
    ...
  },
  "message": "optional response message"
}

Status

Response codeDescription
200Success
404The given service id was not found




Section

Add service

(s)

Adds a Add one or more services to Aspire

Panel
borderColorblack
bgColor#fafafb
POST /aspire_api/connector

Request Body Parameters

NameTypeRequiredDescription
typecoordsstringRequiredThe type maven coordinates of service bundle to use for this service (may be omitted if service is specified)
descriptionstringOptionalAn optional description of the service

Examples

Add a single service

Code Block
languagejs
{
  "typecoords": "filesystem",
  "description": "NetApp"
  ...
}

Add multiple services

Code Block
languagejs
[{
  "type": "filesystemcom.accenture.aspire:app-ge-manager",
  "description": "NetApp"
Group  ...
},
{
  "type": "sharepoint",
  "description": "SharePoint Online"
  expansion service"
  ...
}]

Response

Code Block
languagejs
{
  "connectorservice": [{
    "id": "AAABcID5GBc=",
    "type": "filesystem",
    "description": "NetApp"
Group    ...
  },
  {
    "type": "sharepoint",
    "description": "SharePoint Onlineexpansion service"
    ...
  }],
  "message": "optional response message"
}

Status

Response codeDescription
201Created
406Not acceptable - there was an issue validating the input




Section

Update service

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

Panel
borderColorblack
bgColor#fafafb
PUT /aspire_api/service

Request Body Parameters

The type of service to use for this service (may be omitted if service is specified)
NameTypeRequiredDescription
idstringRequiredThe identifier of the service to updatetypestringRequired
descriptionstringOptionalAn optional description of the service

Examples

Update a single service

Code Block
languagejs
{
  "id": "AAABcID5GBc=",
  "servicedescription": "c:\\testdata\\2500Group expansion service",
  "type": "filesystem"...
}

Response

Code Block
languagejs
{
  "service": {
    "id": "AAABcID5GBc=",
    "Descriptiondescription": "NetGroup expansion Appservice",
    ...
   },
  "typemessage": "filesystem",
    "status": "N"
   },optional response message"
}

Status

Response codeDescription
201Created
404Not found - a given service identifier was not found
406Not acceptable - there was an issue validating the input




Section

Delete service(s)

Delete one or more services from Aspire.

Panel
borderColorblack
bgColor#fafafb

DELETE /aspire_api/service?id=:id

DELETE /aspire_api/service/:id

DELETE /aspire_api/service

Query String, Path and Request Body Parameters

NameTypeRequiredDescription
idstringRequiredThe identifier(s) of the service(s) to delete

Examples

Delete a single service

Code Block
languagejs
{
  "id": "AAABcID5GBc="
}

Delete multiple services

Code Block
languagejs
[{
  "id": "AAABcID5GBc="
},
{
  "id": "AAABcIueWUc="
}]

Delete multiple services (alternative form)

Code Block
languagejs
{
  "id": ["AAABcID5GBc=", "AAABcIueWUc="]
}

Response

Code Block
languagejs
{
  "message": "optional response message"
}

Status

Response codeDescription
201200CreatedSuccess
404Not found - a given service identifier was not found
406Not acceptable - there was an issue validating the input




Section

Delete service(s)

Delete one or more services from Aspire.

Panel
borderColorblack
bgColor#fafafb

DELETE /aspire_api/service?id=:id

DELETE /aspire_api/service/:id

DELETE /aspire_api/service

Query String, Path and Request Body Parameters

NameTypeRequiredDescription
idstringRequiredThe identifier(s) of the service(s) to delete

Examples

Delete a single service

Code Block
languagejs
{
  "id": "AAABcID5GBc="
}

Delete multiple services

Code Block
languagejs
[{
  "id": "AAABcID5GBc="
},
{
  "id": "AAABcIueWUc="
}]

Delete multiple services (alternative form)

Code Block
languagejs
{
  "id": ["AAABcID5GBc=", "AAABcIueWUc="]
}

Response

Code Block
languagejs
{
  "message": "optional response message"
}

Status

Response codeDescription
200Success
404Not found - a given service identifier was not found
406Not acceptable - there was an issue validating the input