DescribeDirectConnectTrafficQosPolicies--专线连接-火山引擎

文档中心

立即注册

导航

DescribeDirectConnectTrafficQosPolicies

最近更新时间：2024.11.15 10:51:33首次发布时间：2024.11.15 10:51:33

调用DescribeDirectConnectTrafficQosPolicies查询符合条件的QoS策略。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	DescribeDirectConnectTrafficQosPolicies	要执行的操作，取值：DescribeDirectConnectTrafficQosPolicies。
Version	String	是	2020-04-01	API版本信息。
DirectConnectTrafficQosPolicyIds.N	List of String	否	DirectConnectTrafficQosPolicyIds.1=dcq-4bwbhc****&DirectConnectTrafficQosPolicyIds.2=dcq-3tehy13n2l4	QoS策略的ID。参数 - N：表示QoS策略ID的序号，单次调用数量上限100个。多个ID之间用&分隔。
DirectConnectTrafficQosPolicyName	String	否	Qos-policy002	QoS策略的名称。
PageSize	Integer	否	20	查询结果的分页大小。最大值：100，默认值：20。
PageNumber	Integer	否	1	查询结果的页码。如需传入此参数，请传入非负整数。不传或传入0，则均默认为1。

返回数据

名称	类型	示例值	描述
RequestId	String	0ED8D006-F706-4D23-88ED-E11ED28D****	请求ID。
PageSize	Integer	20	当前分页的行数。
PageNumber	Integer	1	当前页码。
TotalCount	Integer	33	符合查询条件的QoS策略总数。
DirectConnectTrafficQosPolicies	Array of struct	-	QoS策略信息集合，具体请见下表“DirectConnectTrafficQosPolicie”。

DirectConnectTrafficQosPolicie

名称	类型	示例值	描述
DirectConnectTrafficQosPolicyId	String	dcq-my4e8i4****	QoS策略的ID。
DirectConnectTrafficQosPolicyName	String	dcq-name	QoS策略的名称。
Description	String	dcq-describe	QoS策略的描述。
Status	String	Pending	QoS策略的状态。 Creating: 创建中 Deleting: 删除中 Pending：配置中 Available：可用
DirectConnectConnectionIds	List	[dcc-2l4c6c0v**, dcc-3tehy13**]	QoS策略关联的物理专线的ID。
DirectConnectTrafficQosQueueIds	List	[dqq-1234**, dqq-5678**]	QoS策略绑定的流队列的ID。
CreationTime	String	2024-10-09T08:36:47+08:00	创建QoS策略的时间。
UpdateTime	String	2024-10-10T08:36:47+08:00	更新QoS策略的时间。

请求示例

GET /?Action=DescribeDirectConnectTrafficQosPolicies&Version=2020-04-01&DirectConnectTrafficQosPolicyIds.1=dcq-12aso41dvse8017q7y2m****&PageNumber=1&PageSize=20 HTTP/1.1
Host: open.volcengineapi.com
ServiceName: directconnect
Region: cn-beijing

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202411071551537A413E6A9D8BD45****",
        "Action": "DescribeDirectConnectTrafficQosPolicies",
        "Version": "2020-04-01",
        "Service": "directconnect",
        "Region": "cn-beijing"
    },
    "Result": {
        "RequestId": "202411071551537A413E6A9D8BD45****",
        "PageNumber": 1,
        "PageSize": 20,
        "TotalCount": 1,
        "DirectConnectTrafficQosPolicies": [
            {
                "DirectConnectTrafficQosPolicyId": "dcq-12aso41dvse8017q7y2mq****",
                "DirectConnectTrafficQosPolicyName": "traffic-qos",
                "Description": "traffic-qos",
                "Status": "Available",
                "DirectConnectConnectionIds": [],
                "DirectConnectTrafficQosQueueIds": [
                    "dqq-12aso43cwwg7417q7y2n****"
                ],
                "CreationTime": "2024-11-07T15:51:27+08:00",
                "UpdateTime": "2024-11-07T15:51:29+08:00"
            }
        ]
    }
}

错误码

Http code	错误码	错误信息	描述信息
400	DryRunOperation	Exception raised to indicate a successfully authorized action when the DryRun flag is set to true.	该请求设置为DryRun操作，操作授权已获得许可，但未被实际执行。
400	InvalidPage.Malformed	The specified page is malformed.	指定的分页参数不合法。
400	LimitExceeded.DirectConnectTrafficQosPolicyId	You've reached the limit on the number of direct connect traffic qos policy IDs that you can describe.	已达到可查询的QoS策略的数量上限。