Changing a Management Service Instance

Object Fields Reference

To update a management service instance to another management service, the client should perform a PUT request on the management service instance, with a JSON configpackage key in the request body.

Optionally, the request can include an If-Match header to make the update conditional on the management service instance not having changed.

Request syntax (with If-Match option):

PUT <service-url>

If-Match: "<ETag>"

{configpackage:"<service_name>"}

where

<ETag> is the ETag returned upon retrieving this management service instance; and

<service_name> is the name of the new management service, as retrieved from the store.

The response includes an ETag and a task object that can be used to track progress. If the If-Match condition is not met (the management service has changed), the response code is 412: Precondition Failed.