Assigning a secondary volume to snapshot data

REST API Reference Guide for Virtual Storage Platform 5000, Virtual Storage Platform E Series, and Virtual Storage Platform G/F Series

Version
93-07-0x
90-09-0x
88-08-10
Audience
anonymous
Part Number
MK-98RD9014-17
The following request assigns a secondary volume to snapshot data of a Thin Image pair.

Execution permission

Storage Administrator (Local Copy)

Request line

POST base-URL/v1/objects/snapshots/object-ID/actions/assign-volume/invoke

Request message

Object ID

Specify the snapshotId value obtained by getting information about Thin Image pairs. You can also specify the following attributes and connect them with commas:

pvolLdevId,muNumber

Attribute

Type

Description

pvolLdevId

int

(Required) LDEV number of the P-VOL of a Thin Image pair that has snapshot data

Specify a decimal (base 10) number equal to or greater than 0.

muNumber

int

(Required) MU number of the P-VOL of a Thin Image pair that has snapshot data

Specify a value in the range from 0 to 1023.

Query parameters
None.
Body
{
  "parameters": {
    "svolLdevId": 101
  }
}

Attribute

Type

Description

svolLdevId

int

(Required) LDEV number of the S-VOL to be assigned to the snapshot data

Specify a decimal (base 10) number equal to or greater than 0. For the S-VOL, specify a virtual volume for Thin Image that was created beforehand.

Response message

Body
A job object is returned. For details on attributes other than affectedResources, see the section explaining job objects.

Attribute

Description

affectedResources

URL of the Thin Image pair whose S-VOL was assigned

Action template

GET base-URL/v1/objects/snapshots/object-ID/actions/assign-volume

Status codes

The following table describes the meaning of the status code of the request for this operation. For details on other status codes, see the description on HTTP status codes.

Status codes

Message

Description

412

Precondition Failed

This object indicates that the following actions cannot run: actions specified during S-VOL assignment.

Coding example

To get an action template:

curl -v -H "Accept: application/json" -H "Authorization:Session d7b673af189048468c5af9bcf3bbbb6f" -X GET https://192.0.2.100/ConfigurationManager/v1/objects/snapshots/100,3/actions/assign-volume

To run the request after getting an action template:

curl -v -H "Accept: application/json" -H "Content-Type: application/json" -H "Authorization:Session d7b673af189048468c5af9bcf3bbbb6f" -X POST --data-binary @./InputParameters.json https://192.0.2.100/ConfigurationManager/v1/objects/snapshots/100,3/actions/assign-volume/invoke