You can call this operation to create a quality of service (QoS) policy.
Debugging
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.