全部产品
Search

搜索本产品

    专有网络 VPC：DescribeExpressConnectTrafficQosQueue - 查询高速通道QoS队列

    文档中心

    专有网络 VPC：DescribeExpressConnectTrafficQosQueue - 查询高速通道QoS队列

    更新时间：Nov 27, 2024

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

    调试

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

    授权信息

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

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

    请求参数

    名称类型必填描述示例值
    RegionIdstring是

    QoS 策略所在的地域 ID。

    您可以通过调用 DescribeRegions 接口获取地域 ID。

    		cn-shanghai
    ClientTokenstring是

    客户端 Token，用于保证请求的幂等性。

    从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。

    说明 若您未指定，则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 可能不一样。
    		0c593ea1-3bea-11e9-b96b-88e9fe63****
    QueueIdListarray否

    QoS 队列 ID 集合。

    string否

    QoS 队列 ID。

    		qos-queue-9nyx2u7n71s2rc****
    QueueNameListarray否

    QoS 队列名称集合。

    string否

    QoS 队列名称。

    		qos-queue-test
    QosIdstring否

    QoS 策略 ID。

    		qos-2giu0a6vd5x0mv****

    返回参数

    名称类型描述示例值
    object
    RequestIdstring

    请求 ID。

    		606998F0-B94D-48FE-8316-ACA81BB230DA
    QueueListarray<object>

    QoS 队列列表。

    queueListobject

    QoS 队列信息。

    QosIdstring

    QoS 策略 ID。

    		qos-ncfgzxg40zks5n****
    QueueIdstring

    QoS 队列 ID。

    		qos-queue-9nyx2u7n71s2rc****
    QueueTypestring

    QoS 队列类型，取值：

    • High：高优先级队列。

    • Medium：普通优先级队列。

    • Default：默认优先级队列。

    说明 默认优先级队列无法创建。
    		High
    BandwidthPercentstring

    QoS 队列带宽百分比。

    • 当 QoS 队列类型为 Medium 的时候，此字段必须输入，取值范围为：1~100。

    • 当 QoS 队列类型为 Default 的时候，此字段为"-"。

    		100
    QueueNamestring

    QoS 队列的名称。

    长度为 0～128 个字符，不能以http://或https://开头。

    		qos-queue-test
    QueueDescriptionstring

    QoS 队列的描述信息。

    长度为 0～256 个字符，不能以http://或https://开头。

    		qos-queue-test
    RuleListarray<object>

    QoS 规则列表。

    ruleListobject

    QoS 规则信息。

    QosIdstring

    QoS 策略 ID。

    		qos-91xz9f8zd7yj8x****
    QueueIdstring

    QoS 队列 ID。

    		qos-queue-iugg0l9x27f2no****
    Priorityinteger

    QoS 规则优先级。取值范围：1~9000，数字越大优先级越高，在同一个 QoS 策略内 QoS 规则优先级不允许重复。

    		1
    Protocolstring

    QoS 规则协议类型，取值：

    • ALL

    • ICMP(IPv4)

    • ICMPv6(IPv6)

    • TCP

    • UDP

    • GRE

    • SSH

    • Telnet

    • HTTP

    • HTTPS

    • MS SQL

    • Oracle

    • MySql

    • RDP

    • PostgreSQL

    • Redis

    		ALL
    SrcCidrstring

    QoS 规则流量匹配源 IPv4 网段。

    说明 不支持输入本参数时，再输入参数 SrcIPv6Cidr 或 DstIPv6Cidr。
    		1.1.**.**/24
    DstCidrstring

    QoS 规则流量匹配目的 IPv4 网段。

    说明 不支持输入本参数时，再输入参数 SrcIPv6Cidr 或 DstIPv6Cidr。
    		1.1.**.**/24
    SrcIPv6Cidrstring

    QoS 规则流量匹配源 IPv6 网段。

    说明 不支持输入本参数时，再输入参数 SrcCidr 或 DstCidr。
    		2001:0db8:1234:****::/64
    DstIPv6Cidrstring

    QoS 规则流量匹配目的 IPv6 网段。

    说明 不支持输入本参数时，再输入参数 SrcCidr 或 DstCidr。
    		2001:0db8:1234:****::/64
    SrcPortRangestring

    QoS 规则流量匹配源端口号范围，取值范围：0~65535，当不匹配时取值为-1。当前只支持指定单个端口号，端口号的起始和终止需要相同。

    		-1/-1
    DstPortRangestring

    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
    MatchDscpinteger

    QoS 规则匹配流量的 DSCP 值。取值范围：0~63，如果不匹配时取值为-1。

    		1
    RemarkingDscpinteger

    修改流量中的 DSCP 值。取值范围：0~63，如果不修改时取值为-1。

    		1
    RuleNamestring

    QoS 规则的名称。

    长度为 0～128 个字符，不能以http:// 或https://开头。

    		qos-rule-test
    RuleDescriptionstring

    QoS 规则的描述信息。

    长度为 0～256 个字符，不能以http://或https://开头。

    		qos-rule-test
    RuleIdstring

    QoS 规则 ID。

    		qos-rule-iugg0l9x27f2no****
    Statusstring

    QoS 规则的状态。取值：

    • Normal：可用。

    • Configuring：配置中。

    • Deleting：删除中。

    		Normal
    Statusstring

    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错误码错误信息描述
    400IllegalParam.%sThe param of %s is illegal.指定的参数非法

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

    变更历史

    变更时间变更内容概要操作
    暂无变更历史