Promote

POST v1/volume_collections/id/actions/promote

Description

Take ownership of the specified volume collection. The volumes associated with the volume collection will be set to online and be available for reading and writing. Replication will be disabled on the affected schedules and must be re-configured if desired. Snapshot retention for the affected schedules will be set to the greater of the current local or replica retention values.

Normal Response Codes

200

HTTP Error Codes

400 401 403 404 409 500 503

Detail Codes

SM_ealready

SM_ebusy

SM_eexist

SM_einval

SM_encryption_master_key_inactive

SM_encryption_master_key_missing

SM_enoent

SM_eperm

SM_invalid_arg_value

SM_invalid_path_variable

SM_invalid_query_param

SM_malformed_url

SM_missing_arg

SM_no_action_found

SM_no_method_for_URL_pattern

SM_no_operation_found

SM_no_path_found

SM_root_branch_pinned

SM_too_many

SM_unexpected_arg

SM_unexpected_child

SM_unexpected_query_param

SM_version_name

SM_vol_not_online

Request

Parameter Type JSON Type Description Mandatory
id NsObjectID string ID of the promoted volume collection. A 42 digit hexadecimal number. Example: '2a0df0fe6f7dc7bb16000000000000000000004817'. true

JSON Request


            
            
            {
              "data" : {
                "id":"0700000000000004d3000000000000000000000005"
              }
            }
            
        
         

Response

Type:

JSON Response


            
            
            {
            }