调用DescribeExpressConnectTrafficQosQueue API查询高速通道QoS队列-高速通道-阿里云

调用DescribeExpressConnectTrafficQosQueue查询高速通道QoS队列。

调试

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

授权信息

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

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

操作	访问级别	资源类型	条件关键字	关联操作
vpc:DescribeExpressConnectTrafficQosQueue	list	全部资源 ``	无	无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	QoS 策略所在的地域 ID。您可以通过调用 DescribeRegions 接口获取地域 ID。	cn-shanghai
ClientToken	string	是	客户端 Token，用于保证请求的幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。说明若您未指定，则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 可能不一样。	0c593ea1-3bea-11e9-b96b-88e9fe63****
QueueIdList	array	否	QoS 队列 ID 集合。
	string	否	QoS 队列 ID。	qos-queue-9nyx2u7n71s2rc****
QueueNameList	array	否	QoS 队列名称集合。
	string	否	QoS 队列名称。	qos-queue-test
QosId	string	否	QoS 策略 ID。说明该参数必填。	qos-2giu0a6vd5x0mv****

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	606998F0-B94D-48FE-8316-ACA81BB230DA
QueueList	array<object>	QoS 队列列表。
queueList	object	QoS 队列信息。
QosId	string	QoS 策略 ID。	qos-ncfgzxg40zks5n****
QueueId	string	QoS 队列 ID。	qos-queue-9nyx2u7n71s2rc****
QueueType	string	QoS 队列类型，取值： High：高优先级队列。 Medium：普通优先级队列。 Default：默认优先级队列。说明默认优先级队列无法创建。	High
BandwidthPercent	string	QoS 队列带宽百分比。当 QoS 队列类型为 Medium 的时候，此字段必须输入，取值范围为：1~100。当 QoS 队列类型为 Default 的时候，此字段为"-"。	100
QueueName	string	QoS 队列的名称。长度为 0～128 个字符，不能以`http://`或`https://`开头。	qos-queue-test
QueueDescription	string	QoS 队列的描述信息。长度为 0～256 个字符，不能以`http://`或`https://`开头。	qos-queue-test
RuleList	array<object>	QoS 规则列表。
ruleList	object	QoS 规则信息。
QosId	string	QoS 策略 ID。	qos-91xz9f8zd7yj8x****
QueueId	string	QoS 队列 ID。	qos-queue-iugg0l9x27f2no****
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-iugg0l9x27f2no****
Status	string	QoS 规则的状态。取值： Normal：可用。 Configuring：配置中。 Deleting：删除中。	Normal
Status	string	QoS 队列的状态。取值： Normal：可用。 Configuring：配置中。 Deleting：删除中。	Normal

示例

正常返回示例

JSON格式

{
  "RequestId": "606998F0-B94D-48FE-8316-ACA81BB230DA",
  "QueueList": [
    {
      "QosId": "qos-ncfgzxg40zks5n****",
      "QueueId": "qos-queue-9nyx2u7n71s2rc****",
      "QueueType": "High",
      "BandwidthPercent": 100,
      "QueueName": "qos-queue-test",
      "QueueDescription": "qos-queue-test",
      "RuleList": [
        {
          "QosId": "qos-91xz9f8zd7yj8x****",
          "QueueId": "qos-queue-iugg0l9x27f2no****",
          "Priority": 1,
          "Protocol": "ALL",
          "SrcCidr": "1.1.**.**/24",
          "DstCidr": "1.1.**.**/24\n",
          "SrcIPv6Cidr": "2001:0db8:1234:****::/64",
          "DstIPv6Cidr": "2001:0db8:1234:****::/64",
          "SrcPortRange": "-1/-1",
          "DstPortRange": "-1/-1",
          "MatchDscp": 1,
          "RemarkingDscp": 1,
          "RuleName": "qos-rule-test",
          "RuleDescription": "qos-rule-test",
          "RuleId": "qos-rule-iugg0l9x27f2no****\n",
          "Status": "Normal"
        }
      ],
      "Status": "Normal"
    }
  ]
}

错误码

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

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

变更历史

变更时间	变更内容概要	操作

暂无变更历史