Update Snapshot

Overview

Updates properties of a snapshot

Note

Snapshots are available only for Block Storage Volumes.

Pre/Post Conditions

  • snapshot status must be ‘available’

Classification

  • Update

Synchronous / Asynchronous

  • Synchronous

Request

HTTP Request Method

  • PUT

HTTP Request Path

{api_endpoint}/v1.0/{tenant_id}/snapshots/{snapshot_id}

HTTP Request Header

Format

X-Auth-Token: <token>

HTTP Request Body

Request Parameter

Request Parameter
Parameter Request Type Type Description Required or Optional Note  
name plain String Name of snapshot Required Must be unique by tenant  
description plain String Description of snapshot Optional    

Response

HTTP Response Header

Response Code

Response Codes
Code Description Error? Note
200 OK No Returned in case of success
400 Bad Request Yes  
401 Unauthorized Yes  
409 Tenant is busy Yes Returned if one of creation/update/deletion/restore request is already on-going
500 Internal Server Error Yes  

HTTP Response Body

Response Parameter

Response Parameters
Parameter Type Description Note
api_error_message String Error message in API error case.This property may not appear if there is no error.  
id String Snapshot’s ID (UUID)  
status String Snapshot status  
name String Name of snapshot Must be unique by tenant
description String Description of snapshot  
usage Integer The usage of snapshot in byte  
volume_id String volume ID (UUID)  
snapshot_type_id String ID (UUID) of snapshot_type  
created_at DateTime Creation timestamp for snapshot  
updated_at DateTime Update timestamp for snapshot  
deleted_at DateTime Delete timestamp for snapshot  
error_message String Error message for snapshot in case of error  
delete_reason String Delete reason why the snapshot automatically deleted  

Sample API Request and Response

Sample API Request

curl -s -i -X PUT https://storage-jp1.ecl.api.ntt.com/v1.0/5846e9724f84439c9b44d7d754a70b96/snapshots/6d122618-0bc1-4897-b909-891adb0f5b26 -H 'Content-type: application/json' -H 'Accept: application/json' -H 'X-Auth-Token: 9b2641e7460b4a5ebae3e9ce0ec472a7' -d '{"snapshot":{ "description": "test desc"}}'

Sample API Response

HTTP/1.1 200 OK
Date: Wed, 25 Jan 2017 07:09:57 GMT
Server: Apache
Transfer-Encoding: chunked
Content-Type: application/json

{
    "snapshot": {
        "id": "6d122618-0bc1-4897-b909-891adb0f5b26",
        "status": "available",
        "name": "snapshot01",
        "volume_id": "6cd24c70-f78a-4da6-a308-9a1d97687d0c",
        "description": "test desc",
        "usage": 0,
        "snapshot_type_id": "a1c59e22-94d3-11e6-8f3b-080027aeede7",
        "created_at": "2017-01-25T07:01:03+0000",
        "updated_at": "2017-01-25T07:09:57+0000",
        "deleted_at": null,
        "delete_reason": "",
        "error_message": ""
    }
}