List Snapshot¶
Overview¶
Lists all snapshots in a tenant Lists all snapshots of a volume
注釈
Snapshots are available only for Block Storage Volumes.
Classification¶
- List
Synchronous / Asynchronous¶
- Synchronous
Request¶
HTTP Request Method¶
- GET
HTTP Request Path¶
{api_endpoint}/v1.0/{tenant_id}/snapshots
{api_endpoint}/v1.0/{tenant_id}/snapshots?volume_id={volume_id}
HTTP Request Body¶
- none
Response¶
HTTP Response Header¶
HTTP Response Body¶
Response Parameter¶
| 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 -X GET https://storage-jp1.ecl.api.ntt.com/v1.0/5846e9724f84439c9b44d7d754a70b96/snapshots -H 'Content-type: application/json' -H 'Accept: application/json' -H 'X-Auth-Token: 9b2641e7460b4a5ebae3e9ce0ec472a7'
curl -s -i -X GET https://storage-jp1.ecl.api.ntt.com/v1.0/5846e9724f84439c9b44d7d754a70b96/snapshots?volume_id=6cd24c70-f78a-4da6-a308-9a1d97687d0c -H 'Content-type: application/json' -H 'Accept: application/json' -H 'X-Auth-Token: 9b2641e7460b4a5ebae3e9ce0ec472a7'
Sample API Response¶
HTTP/1.1 200 OK
Date: Wed, 25 Jan 2017 07:02:29 GMT
Server: Apache
Transfer-Encoding: chunked
Content-Type: application/json
{"api_error_message":"","snapshots":[{"id":"6d122618-0bc1-4897-b909-891adb0f5b26","name":"snapshot01","volume_id":"6cd24c70-f78a-4da6-a308-9a1d97687d0c"}]}