调用CreateQosPolicy接口创建QoS策略流分类规则。
前提条件
在您创建QoS策略五元组规则前,请确保您已经创建了QoS策略限速规则。具体操作,请参见CreateQosCar。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CreateQosPolicy |
要执行的操作。取值:CreateQosPolicy。 |
Description | String | 否 | desctest |
QoS策略流分类规则的描述信息。 描述长度为1~512个字符,以大小写字母或中文开头,可包含数字、下划线(_)和短划线(-)。 |
RegionId | String | 是 | cn-shanghai |
QoS策略实例所在的地域ID。 |
QosId | String | 是 | qos-xitd8690ucu8ro**** |
QoS策略的实例ID。 |
Priority | Integer | 是 | 3 |
QoS策略流分类规则所属的限速规则优先级。 优先级范围:1~3。数值越小,优先级越高。 |
SourceCidr | String | 是 | 10.10.10.0/24 |
源网段。 源网段格式为CIDR格式。示例:192.168.1.0/24。 |
DestCidr | String | 是 | 10.10.20.0/24 |
目的网段。 目的网段格式为CIDR格式。示例:192.168.10.0/24。 |
IpProtocol | String | 是 | TCP |
QoS策略流分类规则应用的协议类型。 QoS策略流分类规则支持的协议类型,请以控制台为准。 |
SourcePortRange | String | 是 | 80/80 |
源端口范围。 取值范围:-1或1~65535。 源端口范围格式示例:
|
DestPortRange | String | 是 | 80/80 |
目的端口范围。 取值范围:-1或1~65535。 目的端口范围格式示例:
|
StartTime | String | 否 | 2022-07-14T16:41:33+0800 |
QoS策略流分类规则开始生效时间。 时间按照ISO8601标准表示,并使用UTC时间+8小时。格式为: |
EndTime | String | 否 | 2022-09-14T16:41:33+0800 |
QoS策略流分类规则生效结束时间。 时间按照ISO8601标准表示,并使用UTC时间+8小时。格式为: |
Name | String | 否 | nametest |
QoS策略流分类规则名称。 名称长度为2~100个字符,以大小写字母或中文开头,可包含数字、短划线(-)和下划线(_)。 |
DpiSignatureIds.N | String | 否 | 1 |
应用ID。 系统支持一次最多输入100个应用ID。 您可以通过ListDpiSignatures查询应用ID及其对应的应用信息。 |
DpiGroupIds.N | String | 否 | 20 |
应用组ID。 系统支持一次最多输入100个应用组ID。 您可以通过ListDpiGroups查询应用组ID及其包含的应用信息。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Description | String | desctest |
QoS策略流分类规则的描述。 |
EndTime | String | 2022-09-14T16:41:33+0800 |
QoS策略流分类规则生效结束时间。 |
RequestId | String | 97862812-2C7E-4D25-B0D5-B26DAC7FA293 |
请求ID。 |
QosPolicyId | String | qospy-xhwhyuo43l******** |
QoS策略流分类规则的实例ID。 |
SourcePortRange | String | 80/80 |
源端口范围。 |
SourceCidr | String | 10.10.10.0/24 |
源网段。 |
Priority | Integer | 3 |
QoS策略流分类规则所属的限速规则优先级。 |
StartTime | String | 2022-07-14T16:41:33+0800 |
QoS策略流分类规则生效开始时间。 |
DestPortRange | String | 80/80 |
目的端口范围。 |
DpiGroupIds | Array of String | 20 |
应用组ID列表。 |
Name | String | nametest |
QoS策略流分类规则名称。 |
DestCidr | String | 10.10.10.0/24 |
目的网段。 |
DpiSignatureIds | Array of String | 1 |
应用ID列表。 |
QosId | String | qos-xitd8690ucu8ro**** |
QoS策略的实例ID。 |
IpProtocol | String | TCP |
QoS策略流分类规则应用的协议类型。 |
示例
请求示例
http(s)://[Endpoint]/?Action=CreateQosPolicy
&Description=desctest
&RegionId=cn-shanghai
&QosId=qos-xitd8690ucu8ro****
&Priority=3
&SourceCidr=10.10.10.0/24
&DestCidr=10.10.20.0/24
&IpProtocol=TCP
&SourcePortRange=80/80
&DestPortRange=80/80
&StartTime=2022-07-14T16:41:33+0800
&EndTime=2022-09-14T16:41:33+0800
&Name=nametest
&DpiSignatureIds=["1"]
&DpiGroupIds=["20"]
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateQosPolicyResponse>
<Description>desctest</Description>
<EndTime>2022-09-14T16:41:33+0800</EndTime>
<RequestId>97862812-2C7E-4D25-B0D5-B26DAC7FA293</RequestId>
<QosPolicyId>qospy-xhwhyuo43l********</QosPolicyId>
<SourcePortRange>80/80</SourcePortRange>
<SourceCidr>10.10.10.0/24</SourceCidr>
<Priority>3</Priority>
<StartTime>2022-07-14T16:41:33+0800</StartTime>
<DestPortRange>80/80</DestPortRange>
<DpiGroupIds>20</DpiGroupIds>
<Name>nametest</Name>
<DestCidr>10.10.10.0/24</DestCidr>
<DpiSignatureIds>1</DpiSignatureIds>
<QosId>qos-xitd8690ucu8ro****</QosId>
<IpProtocol>TCP</IpProtocol>
</CreateQosPolicyResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"Description" : "desctest",
"EndTime" : "2022-09-14T16:41:33+0800",
"RequestId" : "97862812-2C7E-4D25-B0D5-B26DAC7FA293",
"QosPolicyId" : "qospy-xhwhyuo43l********",
"SourcePortRange" : "80/80",
"SourceCidr" : "10.10.10.0/24",
"Priority" : 3,
"StartTime" : "2022-07-14T16:41:33+0800",
"DestPortRange" : "80/80",
"DpiGroupIds" : [ "20" ],
"Name" : "nametest",
"DestCidr" : "10.10.10.0/24",
"DpiSignatureIds" : [ "1" ],
"QosId" : "qos-xitd8690ucu8ro****",
"IpProtocol" : "TCP"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | NotSupportedProtocol | The specified protocol of the QoS policy is not supported. | QoS策略规则不支持该协议。 |
400 | InvalidId.Qos | The specified QosId is invalid. | 您输入的参数QosId不合法。 |
400 | QosPolicyPerQosAmountLimit | The maximum number of policies in a QoS is exceeded. You can submit a ticket to increase the quota. | 单个QoS策略中的QosPolicy达到上限,您可以提交工单申请提高配额。 |
400 | MissParameter.RegionId | You must specify RegionId. | 您的输入中缺少必填参数RegionId。 |
400 | MissParameter.QosId | You must specify QosId. | 您的输入中缺少必填参数QosId。 |
400 | MissParameter.QosPolicyId | You must specify QosPolicyId. | 您的输入中缺少必填参数QosPolicyId。 |
400 | InvalidParameter.Priority | The specified Priority is invalid. | 您输入的参数Priority不合法。 |
400 | MissParameter.SourceCidr | You must specify SourceCidr. | 您的输入中缺少必填参数SourceCidr。 |
400 | MissParameter.SourcePortRange | You must specify SourcePortRange. | 您的输入中缺少必填参数SourcePortRange。 |
400 | MissParameter.DestCidr | You must specify DestCidr. | 您的输入中缺少必填参数DestCidr。 |
400 | MissParameter.DestPortRange | You must specify DestPortRange. | 您的输入中缺少必填参数DestPortRange。 |
400 | MissParameter.IpProtocol | You must specify IpProtocol. | 您的输入中缺少必填参数IpProtocol。 |
400 | InvalidParameter.Description | The specified Description is invalid. | 您输入的参数Description不合法。 |
400 | InvalidParameter.DestCidr | The specified DestCidr is invalid. | 您输入的参数DestCidr不合法。 |
400 | InvalidParameter.DestPortRange | The specified DestPortRange is invalid. | 您输入的参数DestPortRange不合法。 |
400 | InvalidParameter.SourceCidr | The specified SourceCidr is invalid. | 您输入的参数SourceCidr不合法。 |
400 | InvalidParameter.SourcePortRange | The specified SourcePortRange is invalid. | 您输入的参数SourcePortRange不合法。 |
400 | InvalidParameter.StartTime | The specified StartTime is invalid. | 您输入的参数StartTime不合法。 |
400 | InvalidParameter.EndTime | The specified EndTime is invalid. | 您输入的参数EndTime不合法。 |
400 | InvalidTimeRangeCompare | The specified end time is earlier than the start time. Please check your input. | 您输入的参数中结束时间小于开始时间,请检查您的输入。 |
400 | InvalidParameter.Name | The specified Name is invalid. | 您输入的参数Name不合法。 |
403 | InternalError | An internal server error occurred. | 内部服务错误。 |
403 | InvalidPortRange | The specified port range is invalid. | 您输入的端口范围不合法。 |
访问错误中心查看更多错误码。