调用AddPolicyLabelsToCoreNetworkAttachment接口，为指定的网络实例连接添加连接策略标签。

调试

API Explorer

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

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action String 必选示例值：AddPolicyLabelsToCoreNetworkAttachment

接口名称。当前 API 的名称为 AddPolicyLabelsToCoreNetworkAttachment。

Version String 必选示例值：2026-06-01

接口版本。当前 API 的版本为 2026-06-01。

CoreNetworkAttachmentId String 必选示例值：cn-attach-3tex2x1cwd4c6c0v***

网络实例连接的ID。

您可以调用各个查询接口，获取网络实例连接的ID。

Labels.N.Key String 必选示例值：k1

连接策略的标签键。

N：表示标签键的序号，取值范围1~20。多个标签键之间使用&分隔。

长度限制为1～128个字符。

不能以空格开头或结尾。大小写敏感，不能以volc:或sys:的任意大小写组合开头。

允许包含字母、数字、空格（）、下划线（_）、点号（.）、半角冒号（:）、斜杠（/）、等号（=）、加号（+）、减号（-）和@。

Labels.N.Value String 必选示例值：v1

连接策略的标签值。

N：表示标签值的序号，取值范围1~20。多个标签值之间使用&分隔。

长度限制为1～128个字符。

不能以空格开头或结尾。大小写敏感，不能以volc:或sys:的任意大小写组合开头。

允许包含字母、数字、空格（）、下划线（_）、点号（.）、半角冒号（:）、斜杠（/）、等号（=）、加号（+）、减号（-）和@。

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

请求示例

返回示例

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	InvalidAttachmentPolicy.NetworkFunctionGroupAutoPublishRoute	An attachment with auto-publish-route enabled cannot be mapped to a network-function-group.	关联到网络服务组的连接不能开启路由同步。
400	InvalidAttachmentPolicyLabel.DuplicateKey	Duplicate label keys found in the request.	请求中存在重复的标签键。
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	InvalidAttachmentPolicyLabel.SystemPrefix	Policy label keys with 'sys:' prefix are reserved for system use and cannot be created or deleted by users.	以 'sys:' 为前缀的连接策略标签为系统预留，用户无法创建或删除。
400	InvalidAttachmentPolicyLabel.TooManyAttachmentPolicyLabelsPerRequest	The number of policy labels on this request is too large.	指定的请求中包含过多连接策略标签。
400	InvalidAttachmentPolicyLabel.ValueMalformed	The specified policy label value is malformed. It must be 0-256 characters.	指定的连接策略标签值无效。长度为0-256个字符。
400	InvalidCoreNetworkConfiguration.RouteTableAttachmentUnsupported	A segment referenced by service insertion cannot contain transit router route table attachments.	服务插入涉及的网络平面不允许挂载路由表连接。
400	LimitExceeded.AttachmentPolicyLabel	The number of attachment policy labels on this attachment has reached the quota limit.	该网络实例连接下的连接策略标签数量已达到配额上限。
404	InvalidCoreNetworkAttachment.NotFound	The specified Core Network attachment does not exist.	指定的网络实例连接不存在。

中转路由器