Applies a Quality of Service (QoS) policy to a Smart Access Gateway (SAG) instance.
Debug
Use OpenAPI Explorer to perform debug operations and generate SDK code examples.
Request parameters
| Parameter | Type | Required? | Example value | Description |
|---|---|---|---|---|
| QosId | String | Yes | qos-awfxl1adxeqyk**** |
The instance ID of the QoS policy. |
| RegionId | String | Yes | cn-hangzhou |
The ID of the region to which the QoS policy belongs. |
| SmartAGId | String | Yes | sag-c3m3n1khz58l****** |
The ID of the SAG instance to which the QoS policy is to be applied. |
| Action | String | No | AssociateQos |
The name of this action. Value: AssociateQos. |
Response parameters
| Parameter | Type | Example value | Description |
|---|---|---|---|
| RequestId | String | 551CD836-9E46-4F2C-A167-B4363180A647 |
The ID of the request. |
Examples
Request example
http(s)://[Endpoint]/? Action=AssociateQos
&QosId=qos-awfxl1adxeqyk****
&RegionId=cn-hangzhou
&SmartAGId=sag-c3m3n1khz58l******
&<CommonParameters>
Response example
XML format
<AssociateQosResponse>
<RequestId>551CD836-9E46-4F2C-A167-B4363180A647</RequestId>
</AssociateQosResponse>JSON format
{
"RequestId": "551CD836-9E46-4F2C-A167-B4363180A647"
}Errors
| HTTP status code | Error code | Error message | Description |
|---|---|---|---|
| 400 | SmartAGAlreadyAssociateQos | The specified smart access gateway has already been associated with the specified QoS. | The specified SAG instance is already associated with another QoS policy. |
| 403 | InternalError | An internal server error occurred. | An internal error has occurred. |
| 400 | InvalidId.Qos | The specified QosId is invalid. | The specified QosId is invalid. |
| 400 | SAG.SoftwareNotSupport | The specified SAG software edition instance does not support ACL. | SAG software instances do not support ACL. |
| 400 | QosPerSmartagAmountLimit | No more QoS can be associated with this smart access gateway. | The specified SAG instance cannot be associated with more QoS policies. |
| 400 | MissParameter.RegionId | You must specify RegionId. | You must specify the RegionId. |
| 400 | MissParameter.QosId | You must specify QosId. | You must specify the QosId. |
| 400 | MissParameter.SmartAGId | You must specify SmartAGId. | You must specify the SmartAGId. |
| 403 | InvalidId.SMARTAG | The specified smart access gateway instance id is invalid. | The specified SmartAGId is invalid. |
For a list of error codes, visit the API Error Center.