中转路由器
中转路由器
中转路由器
文档指南
请输入
云广域网
产品动态
用户指南
API参考
全域网络
核心网
配置版本
配置版本变更集
VPC类型网络实例连接
专线网关类型网络实例连接
VPN类型网络实例连接
TR路由表类型网络实例连接
TR Peering
连接策略
常见问题
中转路由器
产品动态
图说中转路由器
快速入门
用户指南
实例管理
路由管理
最佳实践
API参考
中转路由器实例
VPC类型网络实例连接
VPN类型网络实例连接
专线网关类型网络实例连接
同地域连接
跨地域连接
带宽包
路由表
路由条目
关联转发
路由学习
路由策略
转发策略
流标记策略
流队列策略
流日志
组播
SDK参考
- 文档首页
中转路由器云广域网API参考连接策略DescribePolicyLabelsForCoreNetworkAttachments-查询连接策略标签
复制全文
下载 pdfDescribePolicyLabelsForCoreNetworkAttachments-查询连接策略标签
文档反馈
问问助手调用DescribePolicyLabelsForCoreNetworkAttachments接口，查询满足条件的连接策略标签。
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Action String 必选 示例值：DescribePolicyLabelsForCoreNetworkAttachments
接口名称。当前 API 的名称为 DescribePolicyLabelsForCoreNetworkAttachments。
Version String 必选 示例值：2026-06-01
接口版本。当前 API 的版本为 2026-06-01。
CoreNetworkId String 必选 示例值：cn-3hxn9ush899xmr2jxo0p***
核心网实例的ID。
CoreNetworkAttachmentIds.N String 可选 示例值：cn-attach-3tex2x1cwd4c6c0v***
网络实例连接的ID。
- N：表示网络实例连接的序号，取值范围为1～100。
- 多个网络实例连接ID之间使用“&”分隔。
LabelFilters.N.Key String 可选 示例值：k1
连接策略的标签键。
- N：表示标签键的序号，取值范围1~20。多个标签键之间使用&分隔。
- 指定多个标签键时，表示查询同时包含所有指定标签键的连接策略。
LabelFilters.N.Value String 可选 示例值：v1
连接策略的标签值。
- N：表示标签值的序号，取值范围1~20。多个标签值之间使用&分隔。
- 多个标签值之间使用&分隔。
- 如果传入该参数，则必须先传入LabelFilters.N.Key。
- 该参数传入空值时，表示查询指定标签键下标签值为空的资源。
PageNumber Integer 可选 示例值：1
列表的页码，默认值为1。
PageSize Integer 可选 示例值：20
分页查询时每页的行数，取值范围为1 ~ 100，默认值为20。
返回参数
CoreNetworkAttachmentPolicyLabels Object[] 示例值：-
符合条件的连接策略标签。
Labels Object[] 示例值：-
标签的详细信息。
Key String 示例值：k1
标签的标签键。
Value String 示例值：v1
标签的标签值。
CoreNetworkAttachmentId String 示例值：cn-attach-3tex2x1cwd4c6c0v***
网络实例连接的ID。
PageNumber Integer 示例值：1
当前页码。
PageSize Integer 示例值：20
当前分页的行数。
TotalCount Integer 示例值：33
符合条件的连接策略标签总数。
请求示例
GET /?Action=DescribePolicyLabelsForCoreNetworkAttachments&Version=2026-06-01&CoreNetworkId=cn-3hxn9ush899xmr2jxo0p***&CoreNetworkAttachmentIds.1=cn-attach-3tex2x1cwd4c6c0v***&LabelFilters.1.Key=k1&LabelFilters.1.Value=v1&PageNumber=1&PageSize=20 HTTP/1.1
Host: transitrouter.cn-guangzhou.volcengineapi.com
X-Date: 20251029T033538Z
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20250804/cn-guangzhou/transitrouter/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f
返回示例
{
"ResponseMetadata": {
"RequestId": "20230604110420****100232280022D31",
"Action": "DescribePolicyLabelsForCoreNetworkAttachments",
"Version": "2026-06-01",
"Service": "transitrouter",
"Region": "cn-guangzhou"
},
"Result": {
"CoreNetworkAttachmentPolicyLabels": [
{
"Labels": [
{
"Key": "k1",
"Value": "v1"
}
],
"CoreNetworkAttachmentId": "cn-attach-3tex2x1cwd4c6c0v***"
}
],
"PageNumber": 1,
"PageSize": 20,
"TotalCount": 33
}
}
错误码
状态码 | 错误码 | 错误信息 | 说明 |
400 | InvalidAttachmentPolicyLabel.KeyMalformed | The specified policy label key is malformed. It must be 1-128 characters, alphanumeric, hyphens, underscores, dots, colons, or slashes. | 指定的连接策略标签键无效。长度为1-128个字符，仅支持字母、数字、连字符、下划线、点号、冒号或斜杠。 |
400 | InvalidPage.Malformed | The specified page is malformed. | 指定的分页参数不合法。 |
400 | LimitExceeded.CoreNetworkAttachmentId | You've reached the limit on the number of Core Network attachment IDs that you can describe. | 已达到可查询的网络实例连接ID数量上限。 |
最近更新时间：2026.06.18 14:27:24
这个页面对您有帮助吗？
有用
有用
无用
无用