• Elastic Cloud Server

ecs
  1. Help Center
  2. Elastic Cloud Server
  3. API Reference
  4. OpenStack Nova APIs
  5. Snapshot Management
  6. Querying Snapshots (Discarded)

Querying Snapshots (Discarded)

Function

This API is used to query information about a volume snapshot.

Request

  • This API will be discarded. You are advised to use the EVS API "Querying Details About an EVS Snapshot (Native OpenStack API V2)".

URI

GET /v2/{project_id}/os-snapshots/{snapshot_id}

GET /v2.1/{project_id}/os-snapshots/{snapshot_id}

Table 1 describes the parameters in the URI.
Table 1 Parameter description

Parameter

Mandatory

Description

project_id

Yes

Specifies the project ID.

snapshot_id

Yes

Specifies the volume snapshot ID.

Response

Response parameters

Table 2 describes the response parameters.

Table 2 Response parameters

Parameter

Type

Description

id

String

Specifies the disk snapshot ID in UUID format.

status

String

Specifies the volume snapshot status.

displayName

String

Specifies the volume snapshot name.

displayDescription

String

Specifies the volume snapshot description.

createdAt

String

Specifies the time when the volume snapshot was created.

volumeId

String

Specifies the disk ID in UUID format for the snapshot.

size

Int

Specifies the volume snapshot size.

Example Request

GET /v2/d6c277ba8820452e83df36f33c9fa561/os-snapshots/b836dc3d-4e10-4ea4-a34c-8f6b0460a583
GET /v2.1/d6c277ba8820452e83df36f33c9fa561/os-snapshots/b836dc3d-4e10-4ea4-a34c-8f6b0460a583

Example Response

{
    "snapshot": 
        {
            "createdAt": "2016-05-20T16:54:14.981520", 
            "displayDescription": null, 
            "id": "b836dc3d-4e10-4ea4-a34c-8f6b0460a583",  
            "displayName": "test", 
            "size": 1, 
            "status": "creating", 
            "volumeId": "ba5730ea-8621-4ae8-b702-ff0ffc12c209"
        }
}

Returned Values

See General Request Returned Values.