Restore Snapshot

Overview

Restores a snapshot to volume

注釈

Snapshots are available only for Block Storage Volumes.

Classification

  • Restore

Synchronous / Asynchronous

  • Asynchronous

Request

HTTP Request Method

  • POST

HTTP Request Path

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

HTTP Request Header

Format

X-Auth-Token: <token>

HTTP Request Body

Request Parameter

Request Parameter
Parameter Request Type Type Description Required or Optional Note
restore plain Null null    

Response

HTTP Response Header

Response Code

Response Codes
Code Description Error? Note
202 Accepted 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.  
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 -H 'Content-Type: application/json' -H 'Accept: application/json' -H 'X-Auth-Token: 9b2641e7460b4a5ebae3e9ce0ec472a7' -X POST -d '{"restore": null}' https://storage-jp1.ecl.api.ntt.com/v1.0/5846e9724f84439c9b44d7d754a70b96/snapshots/6d122618-0bc1-4897-b909-891adb0f5b26/action

Sample API Response

HTTP/1.1 202 Accepted
Date: Wed, 25 Jan 2017 07:07:24 GMT
Server: Apache
Transfer-Encoding: chunked
Content-Type: application/json

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