Rotating Snapshot

POST /volume/{volume_id}/snapshot/rotate

Introduction

Rotates Snapshots for the specified Volume.

Updates the oldest generation of the SnapOPC+ Sessions, for which the specified Volume is the copy destination, to the latest generation.

Caution
  • The Hrefs for the new Copy Session created by rotation can be found on resource_href_list in "GET /job/{job_id}".

  • You can see the details on the new Copy Session created by the rotation with "GET /copysession/{copysession_id}".

  • For tenant users, only the Snapshots of the Volumes that belong to the tenant of the current user can be rotated.

Request Examples

  • This is an example of rotating Volume ID 100001 Snapshots.
    $ curl -i -H "Authorization: Bearer g17e4umvwYoHuhkG7yCSee.." -X POST "https://192.168.1.1:5665/api/v1/volume/100001/snapshot/rotate"

Response Examples

{
  "job_id": 8192001,
  "job_href": "/api/v1/job/8192001"
}

Parameters

PATH PARAMETERS

volume_id

(required)

integer

Volume ID.

Responses

If the job registration is successful, the HTTP status code will be 202 (Accepted) and the response body will respond.

RESPONSE BODY

job_id

integer

Job ID.

job_href

string

Resource link of the job.