• Elastic Volume Service

evs
  1. Help Center
  2. Elastic Volume Service
  3. Developer Guide
  4. Deleting an EVS Snapshot

Deleting an EVS Snapshot

Scenarios

If an EVS snapshot is no longer used, you can delete it to release virtual resources.

Constraints

  • The name of the to-be-deleted EVS snapshot cannot be prefixed with autobk_snapshot_.
  • A snapshot can be deleted only when it is in the available or error state.

Involved APIs

Query the snapshot list, obtain the ID of the target snapshot, and then delete the snapshot.

To meet the preceding requirements, call the following APIs:

  • Query EVS snapshots.
  • Delete an EVS snapshot.

Procedure

  1. Query the EVS snapshots.
    • API information

      URI format: GET /v3/{project_id}/snapshots

      For details, see OpenStack Cinder API v3 > EVS Snapshot > Querying EVS Snapshots in the Elastic Volume Service API Reference.

    • Example request

      GET /v3/000efdc5f9064584b718b181df137bd7/snapshots

    • Example response
      {
          "snapshots": [
              {
                  "created_at": "2016-02-16T16:54:14.981520", 
                  "description": null, 
                  "id": "b836dc3d-4e10-4ea4-a34c-8f6b0460a583", 
                  "metadata": { }, 
                  "name": "test01", 
                  "size": 1, 
                  "status": "available", 
                  "volume_id": "ba5730ea-8621-4ae8-b702-ff0ffc12c209", 
                  "updated_at": null
              }, 
              {
                  "created_at": "2016-02-16T16:54:19.475397", 
                  "description": null, 
                  "id": "83be494d-329e-4a78-8ac5-9af900f48b95", 
                  "metadata": { }, 
                  "name": "test02", 
                  "size": 1, 
                  "status": "available", 
                  "volume_id": "ba5730ea-8621-4ae8-b702-ff0ffc12c209", 
                  "updated_at": null
              }, 
              {
                  "created_at": "2016-02-16T16:54:24.367414", 
                  "description": null, 
                  "id": "dd360f46-7593-4d35-8f2c-5566fd0bd79e", 
                  "metadata": { }, 
                  "name": "test03", 
                  "size": 1, 
                  "status": "available", 
                  "volume_id": "ba5730ea-8621-4ae8-b702-ff0ffc12c209", 
                  "updated_at": null
              }, 
              {
                  "created_at": "2016-02-16T16:54:29.766740", 
                  "description": null, 
                  "id": "4c29796a-8cf4-4482-9afc-e66da9a81240", 
                  "metadata": { }, 
                  "name": "test04", 
                  "size": 1, 
                  "status": "available", 
                  "volume_id": "ba5730ea-8621-4ae8-b702-ff0ffc12c209", 
                  "updated_at": null
              }
          ], 
          "snapshots_links": null
      }
  2. Delete the snapshot.
    • API information

      URI format: DELETE /v3/{project_id}/snapshots/{snapshot_id}

      For details, see OpenStack Cinder API v3 > EVS Snapshot > Deleting an EVS Snapshot in the Elastic Volume Service API Reference.

    • Example request

      DELETE /v3/000efdc5f9064584b718b181df137bd7/snapshots/b836dc3d-4e10-4ea4-a34c-8f6b0460a583

    • Example response

      None

      or
      {
          "error": {
              "message": "XXXX", 
              "code": "XXX"
          }
      }
      In the preceding example, error indicates a general error, for example,  badRequest or  itemNotFound. An example is provided as follows:
      {
          "badRequest": {
              "message": "XXXX", 
              "code": "XXX"
          }
      }