• Elastic Volume Service

evs
  1. Help Center
  2. Elastic Volume Service
  3. Developer Guide
  4. Expanding the Capacity of an EVS Disk

Expanding the Capacity of an EVS Disk

Scenarios

For an EVS disk that has been created, you can call this API to expand the disk capacity if the disk space is insufficient.

Constraints

  • If the status of the to-be-expanded disk is available, there are no restrictions.
  • If the status of the to-be-expanded disk is in-use, the restrictions are as follows:
    • The shared disk cannot be expanded, that is, the value of parameter multiattach must be false.
    • The status of the ECS to which the disk attached must be ACTIVE, PAUSED, SUSPENDED, or SHUTOFF.

Involved APIs

Query the disk list, obtain the ID of the target disk, and then expand the disk capacity.

To meet the preceding requirements, call the following APIs:

  • Query EVS disks.
  • Expand the capacity of a disk.

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. Expand the capacity of an EVS disk.
    • API information

      URI format: POST /v3/{project_id}/volumes/{volume_id}/action

      For details, see OpenStack Cinder API v3 > EVS Disk Actions > Expanding the Capacity of an EVS Disk in the Elastic Volume Service API Reference.

    • Example request

      POST /v3/000efdc5f9064584b718b181df137bd7/ volumes/9ab74d89-61e7-4259-8546-465fdebe4944/ action

      {

      "os-extend": {

      "new_size": 100

      }

      }

    • 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"
          }
      }