You can call this operation to create a quality of service (QoS) policy.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String No CreateQos

The operation that you want to perform.

Set the value to CreateQos.

QosName String Yes doctest

The name of the QoS policy.

The name must be 2 to 100 characters in length, and can contain digits, periods (.), underscores (_), and hyphens (-). It must start with a letter or Chinese character.

RegionId String Yes cn-hangzhou

The ID of the region where the QoS policy is deployed.

QosDescription String No testdesc

The description of the QoS policy.

The description must be 1 to 512 characters in length, and can contain digits, underscores (_), and hyphens (-). It must start with a letter or Chinese character.

Response parameters

Parameter Type Example Description
QosId String qos-xhwhyuo43l********

The ID of the QoS policy.

RequestId String F7C5252D-F801-4671-B048-D9A4CD8CEC43

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/? Action=CreateQos
&QosName=doctest
&RegionId=cn-hangzhou
&<Common request parameter>

Sample success responses

XML format

<CreateQosResponse>
	  <QosId>qos-xhwhyuo43l********</QosId>
	  <RequestId>F7C5252D-F801-4671-B048-D9A4CD8CEC43</RequestId>
</CreateQosResponse>

JSON format

{
"QosId":"qos-xhwhyuo43l********",
"RequestId":"F7C5252D-F801-4671-B048-D9A4CD8CEC43"
}

Error codes

HttpCode Error code Error message Description
403 InternalError An internal server error occurred. The error message returned because an internal error occurred.
400 QosAmountLimit No more QoS can be created. You can submit a ticket to increase the quota of QoSes. The error message returned because the number of QoS policies that you have created has reached the upper limit. You can submit a ticket to request a quota increase.
400 MissParameter.RegionId You must specify RegionId. The error message returned because the ID (RegionId) of the region is not specified.
400 MissParameter.Name You must specify Name. The error message returned because the name (Name) of the QoS policy is not specified.
400 InvalidParameter.Name The specified Name is invalid. The error message returned because the specified name (Name) of the QoS policy is invalid.
400 InvalidParameter.Description The specified Description is invalid. The error message returned because the specified description (Description) of the QoS policy is invalid.

For a list of error codes, visit the API Error Center.