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

文档中心

立即注册

导航

DescribeDirectConnectTrafficQosQueues

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

调用DescribeDirectConnectTrafficQosQueues查询符合条件的流队列的信息。

调试

API Explorer

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

去调试

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	DescribeDirectConnectTrafficQosQueues	要执行的操作，取值：DescribeDirectConnectTrafficQosQueues。
Version	String	是	2020-04-01	API版本信息。
DirectConnectTrafficQosQueueIds.N	List of String	否	DirectConnectTrafficQosQueueIds.1=dqq-93a1ee**&DirectConnectTrafficQosQueueIds.2=dqq-fsj3ekj1ie**	流队列的ID。参数 - N：表示流队列ID的序号，单次调用数量上限100个。多个ID之间用&分隔。
DirectConnectTrafficQosPolicyId	String	否	dcq-3bf8a0f4****	流队列关联的QoS策略的ID。
DirectConnectTrafficQosQueueName	String	否	dqq-name	流队列的名称。
QueueType	String	否	High	流队列的类型。 High：高优先级队列。 Medium：普通优先级队列。 Default：默认优先级队列。

返回数据

名称	类型	示例值	描述
RequestId	String	20241107160356F326746763AFFF5****	请求ID。
PageSize	Integer	20	当前分页的行数。
PageNumber	Integer	1	当前页码。
TotalCount	Integer	1	符合查询条件的流队列总数。
DirectConnectTrafficQosQueues	Array of struct	-	流队列信息集合，具体请见下表“DirectConnectTrafficQosQueue”。

DirectConnectTrafficQosQueue

名称	类型	示例值	描述
DirectConnectTrafficQosPolicyId	String	dcq-3bf8a0f4****	流队列关联的QoS策略的ID。
DirectConnectTrafficQosQueueId	String	dqq-93a1ee****	流队列的ID。
DirectConnectTrafficQosQueueName	String	dqq-name	流队列的名称。
Description	String	dqq-describe	流队列的描述信息。
QueueType	String	Medium	流队列的类型。
BandwidthPercent	Integer	49	流队列的带宽百分比。当流队列类型为 Medium 、Default时，返回此对应的带宽百分比数值。当流队列类型为High 时，返回值为0。
DirectConnectTrafficQosRuleIds	List	[dqr-88edo2**,dqr-e11ed28**]	流队列下流分类规则ID。
CreationTime	String	2024-10-09T08:36:47+08:00	创建流队列的时间。
UpdateTime	String	2024-10-10T08:36:47+08:00	更新流队列的时间。
Status	String	Pending	流队列的状态。 Creating: 创建中 Deleting: 删除中 Pending：配置中 Available：可用

请求示例

GET /?Action=DescribeDirectConnectTrafficQosQueues&DirectConnectTrafficQosQueueIds.1=dqq-in0gqqzwvi808gbssyj5****&Version=2020-04-01 HTTP/1.1
Host: open.volcengineapi.com
ServiceName: directconnect
Region: cn-beijing

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20241107160356F326746763AFFF5****",
        "Action": "DescribeDirectConnectTrafficQosQueues",
        "Version": "2020-04-01",
        "Service": "directconnect",
        "Region": "cn-beijing"
    },
    "Result": {
        "RequestId": "20241107160356F326746763AFFF5****",
        "PageNumber": 1,
        "PageSize": 20,
        "TotalCount": 1,
        "DirectConnectTrafficQosQueues": [
            {
                "DirectConnectTrafficQosPolicyId": "dcq-12aso41dvse8017q7y2mq****",
                "DirectConnectTrafficQosQueueId": "dqq-in0gqqzwvi808gbssyj****",
                "DirectConnectTrafficQosQueueName": "test",
                "Description": "test",
                "QueueType": "Medium",
                "BandwidthPercent": 19,
                "DirectConnectTrafficQosRuleIds": [],
                "Status": "Available",
                "CreationTime": "2024-11-07T16:02:26+08:00",
                "UpdateTime": "2024-11-07T16:02:40+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.DirectConnectTrafficQosQueueId	You've reached the limit on the number of direct connect traffic qos queue IDs that you can describe.	已达到可查询的QoS流队列数量上限。