Demote
POST v1/volume_collections/id/actions/demote
Description
Release ownership of the specified volume collection. The volumes associated with the volume collection will set to offline and a snapshot will be created, then full control over the volume collection will be transferred to the new owner. This option can be used following a promote to revert the volume collection back to its prior configured state. This operation does not alter the configuration on the new owner itself, but does require the new owner to be running in order to obtain its identity information.
Normal Response Codes
200
HTTP Error Codes
400 401 403 404 409 500 503
Detail Codes
Request
| Parameter | Type | JSON Type | Description | Mandatory |
|---|---|---|---|---|
| id | NsObjectID | string | ID of the demoted volume collection. A 42 digit hexadecimal number. Example: '2a0df0fe6f7dc7bb16000000000000000000004817'. | true |
| replication_partner_id | NsObjectID | string | ID of the new owner. If invoke_on_upstream_partner is provided, utilize the ID of the current owner i.e. upstream replication partner. A 42 digit hexadecimal number. Example: '2a0df0fe6f7dc7bb16000000000000000000004817'. | true |
| invoke_on_upstream_partner | NsBoolean | boolean | Invoke demote request on upstream partner. Default: 'false'. Possible values: 'true', 'false'. | false |
JSON Request
{
"data" : {
"id":"0700000000000004d3000000000000000000000005",
"replication_partner_id":"0900000000000004d3000000000000000000000001",
}
}
Response
Type:
JSON Response
{
}