Storing 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 splits the specified Thin Image pair. When the pair is split, snapshot data at the time of the split is stored.

Execution permission

Storage Administrator (Local Copy)

Request line

POST base-URL/v1/objects/snapshots/object-ID/actions/split/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) Specify the LDEV number of the P-VOL of the Thin Image pair to be split. Specify a decimal (base 10) number equal to or greater than `0`.
muNumber	int	(Required) Specify the MU number of the P-VOL of the Thin Image pair to be split. Specify a value in the range from `0` to `1023`.

Attribute

Type

Description

pvolLdevId

int

(Required) Specify the LDEV number of the P-VOL of the Thin Image pair to be split.

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

muNumber

int

(Required) Specify the MU number of the P-VOL of the Thin Image pair to be split.

Specify a value in the range from 0 to 1023.

Query parameters: None.

Body: None.

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 split Thin Image pair

Action template

GET base-URL/v1/objects/snapshots/object-ID/actions/split

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 when pairs are split.

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/split

To run the request after getting an action template:

curl -v -H "Content-type: application/json" -H "Accept: application/json" -H "Authorization:Session d7b673af189048468c5af9bcf3bbbb6f" -X POST https://192.0.2.100/ConfigurationManager/v1/objects/snapshots/100,3/actions/split/invoke -d ""