DescribeExpressConnectTrafficQosRule - 查询高速通道QoS规则 - 高速通道

调用DescribeExpressConnectTrafficQosRule查询高速通道QoS规则，不支持分页参数。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

vpc:DescribeExpressConnectTrafficQosRule

list

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	QoS 策略所在的地域 ID。您可以通过调用 DescribeRegions 接口获取地域 ID。	cn-shanghai
ClientToken	string	否	客户端 Token，用于保证请求的幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。说明若您未指定，则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 可能不一样。	123e4567-e89b-12d3-a456-426655440000
RuleIdList	array	否	QoS 规则 ID 集合。
	string	否	QoS 规则 ID。	qos-rule-iugg0l9x27f2no****
RuleNameList	array	否	QoS 规则名称集合。
	string	否	QoS 规则名称。	qos-rule-test
QosId	string	否	QoS 策略 ID，由 CreateExpressConnectTrafficQos 接口返回。说明该参数实际为必填项，未提供时服务返回 IllegalParam.QosId（400）。	qos-2giu0a6vd5x0mv****
QueueId	string	否	QoS 队列 ID，由 CreateExpressConnectTrafficQosQueue 接口返回。说明该参数实际为必填项，未提供时服务返回 IllegalParam.QueueId（400）。	qos-queue-9nyx2u7n71s2rc****

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	9C7FA9D6-72E0-48A9-A9C3-2DA8569CD5EB
RuleList	array<object>	QoS 规则列表。
	object	QoS 规则信息。
QosId	string	QoS 策略 ID。	qos-pksbqfmotl5hzq****
QueueId	string	QoS 队列 ID。	qos-queue-9nyx2u7n71s2rc****
Priority	integer	QoS 规则优先级。取值范围：1~9000，数字越大优先级越高，在同一个 QoS 策略内 QoS 规则优先级不允许重复。	1
Protocol	string	QoS 规则协议类型，取值： ALL ICMP(IPv4) ICMPv6(IPv6) TCP UDP GRE SSH Telnet HTTP HTTPS MS SQL Oracle MySql RDP PostgreSQL Redis	ALL
SrcCidr	string	QoS 规则流量匹配源 IPv4 网段。说明不支持输入本参数时，再输入参数 SrcIPv6Cidr 或 DstIPv6Cidr。	1.1../24
DstCidr	string	QoS 规则流量匹配目的 IPv4 网段。说明不支持输入本参数时，再输入参数 SrcIPv6Cidr 或 DstIPv6Cidr。	1.1../24
SrcIPv6Cidr	string	QoS 规则流量匹配源 IPv6 网段。说明不支持输入本参数时，再输入参数 SrcCidr 或 DstCidr。	2001:0db8:1234:****::/64
DstIPv6Cidr	string	QoS 规则流量匹配目的 IPv6 网段。说明不支持输入本参数时，再输入参数 SrcCidr 或 DstCidr。	2001:0db8:1234:****::/64
SrcPortRange	string	QoS 规则流量匹配源端口号范围，取值范围：0~65535，当不匹配时取值为-1。当前只支持指定单个端口号，端口号的起始和终止需要相同。	-1/-1
DstPortRange	string	QoS 规则流量匹配目的端口号范围。取值范围：0~65535，如果不匹配时取值为-1。当前只支持指定单个端口号，端口号的起始和终止需要相同。不同的协议类型，对应的目的端口号范围是固定的，取值如下： ALL：-1/-1，不可编辑。 ICMP(IPv4)：-1/-1，不可编辑。 ICMPv6(IPv6)：-1/-1，不可编辑。 TCP：-1/-1，可编辑。 UDP：-1/-1，可编辑。 GRE：-1/-1，不可编辑。 SSH：22/22，不可编辑。 Telnet：23/23，不可编辑。 HTTP：80/80，不可编辑。 HTTPS：443/443，不可编辑。 MS SQL：1443/1443，不可编辑。 Oracle：1521/1521，不可编辑。 MySql：3306/3306，不可编辑。 RDP：3389/3389，不可编辑。 PostgreSQL：5432/5432，不可编辑。 Redis：6379/6379，不可编辑。	-1/-1
MatchDscp	integer	QoS 规则匹配流量的 DSCP 值。取值范围：0~63，如果不匹配时取值为-1。	1
RemarkingDscp	integer	修改流量中的 DSCP 值。取值范围：0~63，如果不修改时取值为-1。	1
RuleName	string	QoS 规则的名称。长度为 0～128 个字符，不能以`http://` 或`https://`开头。	qos-rule-test
RuleDescription	string	QoS 规则的描述信息。长度为 0～256 个字符，不能以`http://`或`https://`开头。	qos-rule-test
RuleId	string	QoS 规则 ID。	qos-rule-iugg0l9x27f2noc****
Status	string	QoS 规则的状态。取值： Normal：可用。 Configuring：配置中。 Deleting：删除中。	Normal

示例

正常返回示例

JSON格式

{
  "RequestId": "9C7FA9D6-72E0-48A9-A9C3-2DA8569CD5EB",
  "RuleList": [
    {
      "QosId": "qos-pksbqfmotl5hzq****",
      "QueueId": "qos-queue-9nyx2u7n71s2rc****\n",
      "Priority": 1,
      "Protocol": "ALL",
      "SrcCidr": "1.1.**.**/24\n",
      "DstCidr": "1.1.**.**/24\n",
      "SrcIPv6Cidr": "2001:0db8:1234:****::/64\n",
      "DstIPv6Cidr": "2001:0db8:1234:****::/64\n",
      "SrcPortRange": "-1/-1\n",
      "DstPortRange": "-1/-1\n",
      "MatchDscp": 1,
      "RemarkingDscp": 1,
      "RuleName": "qos-rule-test\n",
      "RuleDescription": "qos-rule-test\n",
      "RuleId": "qos-rule-iugg0l9x27f2noc****",
      "Status": "Normal"
    }
  ]
}

错误码

HTTP status code	错误码	错误信息	描述
400	IllegalParam.%s	The param of %s is illegal.	指定的参数非法

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。