Function

This API is used to change the IOPS or throughput of an EVS disk.

Constraints

The disk must be in the available or in-use state. For a General Purpose SSD V2 disk, both the IOPS and throughput can be changed. This API is not supported for other types of EVS disks.

URI

PUT /v5/{project_id}/cloudvolumes/{volume_id}/qos

**Table 1** URI parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	The project ID.
volume_id	Yes	String	The disk ID.

Request Parameters

**Table 2** Request header parameter
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	The user token. It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is the user token.

**Table 3** Request body parameter
Parameter	Mandatory	Type	Description
qos_modify	Yes	ModifyVolumeQoSOption object	The disk QoS change marker.

**Table 4** ModifyVolumeQoSOption
Parameter	Mandatory	Type	Description
iops	Yes	Integer	The new maximum IOPS of the disk. Only General Purpose SSD V2 disks are supported.
throughput	No	Integer	The new maximum throughput of the disk, in the unit of MiB/s. This parameter is only supported for General Purpose SSD V2 disks.

Response Parameters

Status code: 202

**Table 5** Response body parameter
Parameter	Type	Description
job_id	String	The task ID. NOTE: To query the task status, see Querying Task Status.

Status code: 400

**Table 6** Response body parameter
Parameter	Type	Description
error	Error object	The error code returned if an error occurs. For details about the error code, see Error Codes.

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

Example Requests

PUT https://{endpoint}/v5/{project_id}/cloudvolumes/{volume_id}/qos

{
  "qos_modify" : {
    "iops" : 10000,
    "throughput" : 200
  }
}

Example Responses

Status code: 202

Accepted

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

Status code: 400

Bad Request

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

Status Codes

Status Code	Description
202	Accepted
400	Bad Request

Error Codes

For details, see Error Codes.

Modifying QoS of an EVS Disk