• Elastic Volume Service

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

Creating an EVS Snapshot

Scenarios

You can create an EVS snapshot on the management console to save the disk data at a specific time point.

Constraints

A maximum of 7 snapshots can be created for an EVS disk.

Involved APIs

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

To meet the preceding requirements, call the following APIs:

  • Query EVS disks.
  • Create an EVS snapshot.

Procedure

  1. Query EVS disks.
    • API information

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

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

    • Example request

      GET /v3/000efdc5f9064584b718b181df137bd7/volumes

    • Example response
      {
          "volumes": [
              {
                  "id": "6b604cef-9bd8-4f5a-ae56-45839e6e1f0a", 
                  "links": [
                      {
                          "href": "https://volume.localdomain.com:8776/v2/dd14c6ac581f40059e27f5320b60bf2f/volumes/6b604cef-9bd8-4f5a-ae56-45839e6e1f0a", 
                          "rel": "self"
                      }, 
                      {
                          "href": "https://volume.localdomain.com:8776/dd14c6ac581f40059e27f5320b60bf2f/volumes/6b604cef-9bd8-4f5a-ae56-45839e6e1f0a", 
                          "rel": "bookmark"
                      }
                  ], 
                  "name": "zjb_u25_test"
              }, 
              {
                  "id": "2bce4552-9a7d-48fa-8484-abbbf64b206e", 
                  "links": [
                      {
                          "href": "https://volume.localdomain.com:8776/v2/dd14c6ac581f40059e27f5320b60bf2f/volumes/2bce4552-9a7d-48fa-8484-abbbf64b206e", 
                          "rel": "self"
                      }, 
                      {
                          "href": "https://volume.localdomain.com:8776/dd14c6ac581f40059e27f5320b60bf2f/volumes/2bce4552-9a7d-48fa-8484-abbbf64b206e", 
                          "rel": "bookmark"
                      }
                  ], 
                  "name": "zjb_u25_test"
              }, 
              {
                  "id": "3f1b98ec-a8b5-4e92-a727-88def62d5ad3", 
                  "links": [
                      {
                          "href": "https://volume.localdomain.com:8776/v2/dd14c6ac581f40059e27f5320b60bf2f/volumes/3f1b98ec-a8b5-4e92-a727-88def62d5ad3", 
                          "rel": "self"
                      }, 
                      {
                          "href": "https://volume.localdomain.com:8776/dd14c6ac581f40059e27f5320b60bf2f/volumes/3f1b98ec-a8b5-4e92-a727-88def62d5ad3", 
                          "rel": "bookmark"
                      }
                  ], 
                  "name": "zjb_u25_test"
              }
          ], 
          "volumes_links": [
              {
                  "href": "https://volume.localdomain.com:8776/v2/dd14c6ac581f40059e27f5320b60bf2f/volumes?limit=3&marker=3f1b98ec-a8b5-4e92-a727-88def62d5ad3", 
                  "rel": "next"
              }
          ]
      }
  2. Create the snapshot.
    • API information

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

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

    • Example request

      GET /v3/000efdc5f9064584b718b181df137bd7/snapshots

      {

      "snapshot": {

      "name": "snap-001",

      "description": "Daily backup",

      "volume_id": "5aa119a8-d25b-45a7-8d1b-88e127885635",

      "force": false,

      "metadata": { }

      }

      }

    • Example response
      {
          "snapshot": {
              "status": "creating", 
              "description": "Daily backup", 
              "created_at": "2013-02-25T03:56:53.081642", 
              "metadata": { }, 
              "volume_id": "5aa119a8-d25b-45a7-8d1b-88e127885635", 
              "size": 1, 
              "id": "ffa9bc5e-1172-4021-acaf-cdcd78a9584d", 
              "name": "snap-001", 
              "updated_at": "2013-02-25T03:56:53.081642"
          }
      }
      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"
          }
      }