Expanding Capacity of an EVS Disk

Function

This API contains all functions found in Expanding Capacity of an EVS Disk and can also be used to expand the capacity of the disk billed in yearly/monthly mode.

URI

• URI format

  POST /v2.1/{project_id}/cloudvolumes/{volume_id}/action

• Parameter description

  Parameter	Mandatory	Description
  project_id	Yes	The project ID. For details about how to obtain the project ID, see Obtaining a Project ID.
  volume_id	Yes	The disk ID.

Request

• Request parameters

  Parameter	Type	Mandatory	Description
  os-extend	Object	Yes	The disk expansion marker. For details, see Parameter in the os-extend field.
  bssParam	Object	No	The operation parameter. For details, see Parameter in the bssParam.

• Parameter in the os-extend field

  Parameter	Type	Mandatory	Description
  new_size	Integer	Yes	The new disk size, in GB. The new size ranges from the original size to the maximum size (32768 for a data disk and 1024 for a system disk). NOTE: If the specified value is a decimal, the number part of the value will be used.

• Parameters in the bssParam field

  Parameter	Type	Mandatory	Description
  chargingMode	String	No	The billing mode. The default value is postPaid. Value range prePaid: indicates the yearly/monthly billing mode. postPaid: indicates the pay-per-use billing mode. If the disk is billed on a yearly/monthly basis, set the parameter value to prePaid. If the disk is billed on a pay-per-use basis, set the parameter value to postPaid or use the default value.
  isAutoPay	String	No	Whether to pay immediately. This parameter is valid only when the disk is billed on the yearly/monthly basis. The default value is false. Value range false: indicates not to pay immediately after an order is created. true: indicates to pay immediately after an order is created. The system will automatically deduct fees from the account balance.

• Example request

  {
      "os-extend": {
          "new_size": 100
      }, 
      "bssParam": {
          "isAutoPay": "true"
      }
  }

Response

• Response parameters

  Parameter	Type	Description
  job_id	String	The task ID. This parameter is returned when the expanded disk is billed in the pay-per-use mode. NOTE: For details about how to query the task status, see Querying Task Status.
  order_id	String	The order ID. This parameter is returned when the expanded disk is billed in the yearly/monthly mode. NOTE: For details about how to pay for the order, see Paying Yearly/Monthly Product Orders.
  error	Object	The error message returned if an error occurs. For details, see Parameters in the error field.

• Parameters in the error field

  Parameter	Type	Description
  message	String	The error message returned if an error occurs.
  code	String	The error code returned if an error occurs. For details about the error code, see Error Codes.

• Example response

  {
      "job_id": "70a599e0-31e7-49b7-b260-868f441e862b"
  }

  or

  {
      "order_id": "CS1711152257C60TL"
  }

  or

  {
      "error": {
          "message": "XXXX", 
          "code": "XXX"
      }
  }

Status Codes

• Normal

  202

Error Codes

For details, see Error Codes.