文档中心

专线连接

标签

TagResources - 创建标签

调用 TagResources 接口，为专线资源添加用户标签。

调试

API Explorer

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

去调试

请求参数

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

Action String 必选示例值：TagResources

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

Version String 必选示例值：2020-04-01

接口版本。当前 API 的版本为 2020-04-01。

ResourceType String 必选示例值：directconnectconnection

绑定标签的资源类型，取值如下：

directconnectconnection：物理专线

directconnectgateway：专线网关

directconnectvirtualinterface：虚拟接口

ResourceIds.N String 必选示例值：dcc-lhn2cx0an18****

绑定标签的资源ID。

参数 - N：表示专线资源的序号，单次调用数量上限50个ID。

多个ID之间请使用&分隔。

Tags.N.Key String 必选示例值：v1

资源的标签键。

参数 - N：表示标签键的序号，取值范围：1～20。

多个标签键之间用&分隔。

不能以 volc:或sys:开头，包括任意大小写形式。

长度取值范围为1~128字符，允许输入各国语言文字、数字、空格（）、下划线（_）、点号（.）、半角冒号（:）、斜杠（/）、等号（=）、加号（+）、中划线（-）和@（@）。

若标签键开头或结尾存在空格，系统会自动为其去除。

同一资源的标签键不允许重复。

Tags.N.Value String 可选示例值：k1

资源的标签值。

参数 - N：表示标签值的序号，取值范围：1～20。

多个标签值之间用&分隔。

长度取值范围为0～256字符，不填默认为空。

允许输入各国语言文字、数字、空格（）、下划线（_）、点号（.）、半角冒号（:）、斜杠（/）、等号（=）、加号（+）、中划线（-）和@（@）。

大小写敏感。

若标签值开头或结尾存在空格，系统会自动为其去除。

若传入该参数，则必须先传入Tags.N.Key。

返回参数

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

请求示例

GET /?Action=TagResources&Version=2020-04-01&ResourceType=directconnectconnection&ResourceIds.1=dcc-lhn2cx0an18****&Tags.1.Key=v1&Tags.1.Value=k1 HTTP/1.1​
Host: directconnect.cn-beijing.volcengineapi.com​
X-Date: 20250804T033538Z​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20250804/cn-beijing/directconnect/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​

返回示例

{​
    "ResponseMetadata": {​
        "RequestId": "20230604110420****100232280022D31",​
        "Action": "TagResources",​
        "Version": "2020-04-01",​
        "Service": "directconnect",​
        "Region": "cn-north-1"​
    },​
    "Result": {​
        "RequestId": "2021062415303301022514515207C4****"​
    }​
}​

错误码

公共错误码请参见公共错误码文档。

最近更新时间：2026.03.27 17:45:29

这个页面对您有帮助吗？

有用

无用