Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 9 Next »

3.10.0

The Deployment Group REST API is used mange deployment groups and mobile application configurations for deployment groups.

There is always a Default deployment group that can not be deleted from the system. 

It is not required to create separate mobile configuration for each new deployment group that is created. If a deployment group does not have a specific mobile configuration defined it will automatically inherit form the Default deployment group. 

Resource URL Summary

Retrieve a list of all Deployment Groups

GET /seiapi/v3/trans/DeploymentGroup

Retrieve the details of a specific Deployment Group

GET /seiapi/v3/trans/DeploymentGroup/${DeploymentGroupID}

Insert or Update the details of a specific Deployment Group

POST /seiapi/v3/trans/DeploymentGroup/${DeploymentGroupID}

API Specific Parameters

ParameterDescription

${DeploymentGroupID}

Identifies the Deployment Group.

HTTP Headers

This API uses the default ServiceMobility HTTP Headers.

 


API Specifics

Retrieve a list of all Deployment Groups

This REST API will return a list of all Deployment Groups that exist in the system.

URL

GET /seiapi/v3/trans/DeploymentGroup

HTTP Request Body

This request does not require a request body. 

HTTP Response

On success, an HTTP response code of 200 will be returned, and the response body will contain a collection of Deployment Group Objects

(warning) It is possible for the returned collection to be empty if there are no Deployment Groups that exist in the system. 

HTTP Response Body
{
	"DeploymentGroups" : [
		// A collection of zero or more deployment group object.
	]
}

Retrieve the details of a specific Deployment Group

This REST API will return a Deployment Group with the specified ID. The Deployment Group with the specified ID must already exist in the system.

URL

GET /seiapi/v3/trans/DeploymentGroup/${DeploymentGroupID}

HTTP Request Body

This request does not require a request body. 

HTTP Response Body

On success, an HTTP response code of 200 will be returned, and the response body will contain a Deployment Group Object. Otherwise, on error, the response body will contain a descriptive reason for the error. 

JSON Format
{
  "DGroupID": "Default",
  "Desc": {
    "en": "Default"
  }
}

Insert or Update the details of a specific Deployment Group

This REST API will insert a new Deployment Group with the specified ID into the system, if a Deployment Group with the specified ID does not already exist in the system.

If, however, the Deployment Group with the specified ID does already exist in the system, then this REST API will update (i.e. replace) the already existing Deployment Group with the specified ID with the details of the Deployment Group supplied in the HTTP Request Body.

URL

POST /seiapi/v3/trans/DeploymentGroup/${DeploymentGroupID}

HTTP Request Body

The HTTP request body must contain a valid Deployment Group Object.

HTTP Response

On success the API will return a response code of 200.

  • No labels