You need to enable JavaScript to run this app.
文档中心
私网连接

私网连接

复制全文
下载 pdf
标签
TagResources-绑定资源标签
复制全文
下载 pdf
TagResources-绑定资源标签
调用TagResources接口,为资源添加用户标签。​
使用说明​
  • 为同一个资源重复添加相同标签键的标签,则后面的标签值会自动覆盖前面的。​
  • 每个资源最多可添加50个标签,每次调用该接口最多可添加20个标签。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
Action String 必选 示例值:TagResources​
要执行的操作,取值:TagResources。​
​
Version String 必选 示例值:2020-04-01​
API的版本信息,当前版本为 2020-04-01。​
​
ResourceType String 必选 示例值:endpointservice​
资源的类型,取值如下:​
  • endpointservice:终端节点服务​
  • endpoint:接口终端节点​
  • gatewayendpoint:网关终端节点​
​
ResourceIds.N String 必选 示例值:epsvc-2fe630gurkl37k5gfuy33****​
资源的ID。​
说明​
  • N:表示资源ID的序号,取值范围 1~50。​
  • 多个资源 ID之间使用&分隔。​
​
Tags.N.Key String 必选 示例值:k1​
用户标签的标签键。​
  • 长度限制为1~128个字符。​
  • 大小写敏感,不能以volc:或sys:的任意大小写组合开头。​
  • 不能以空格开头或结尾。​
  • 允许包含字母、数字、空格()、下划线(_)、点号(.)、半角冒号(:)、斜杠(/)、等号(=)、加号(+)、减号(-)和@。​
说明​
同一资源的标签键不允许重复。​
​
Tags.N.Value String 可选 示例值:v1​
用户标签的标签值。​
  • 长度限制为0~255个字符。​
  • 大小写敏感,不能以空格开头或结尾。​
  • 允许包含字母、数字、空格()、下划线(_)、点号(.)、半角冒号(:)、斜杠(/)、等号(=)、加号(+)、减号(-)和@。​
说明​
如果传入该参数,则必须先传入Tags.N.Key。​
​
​
返回参数​
RequestId String 可选 示例值:2021062415303301022514515207C4****​
请求ID。​
​
​
请求示例​
​
GET /?Action=TagResources&Version=2020-04-01&ResourceType=endpointservice&ResourceIds.1=epsvc-2fe630gurkl37k5gfuy33****&ResourceIds.2=epsvc-2fe630gurkl58k5gfuy26****&Tags.1.Key=k1&Tags.2.Key=k2&Tags.1.Value=v1&Tags.2.Value=v2 HTTP/1.1​
Host: privatelink.cn-guangzhou.volcengineapi.com​
X-Date: 20251121T094038Z​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20251121/cn-guangzhou/privatelink/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "2021062415303301022514515207C4****",​
"Action": "TagResources",​
"Version": "2020-04-01",​
"Service": "privatelink",​
"Region": "cn-guangzhou"​
},​
"Result": {}​
}​
​
错误码​
此处仅展示当前API的错误码,更多错误码请参见公共错误码。​
​
状态码​
错误码​
错误信息​
说明​
400​
MissingParameter​
The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request; for example, the 'XXX'.​
该请求缺少必要参数。请确保发起请求已提供全部必要参数,比如XXX。​
说明​
其中,XXX表示缺少的参数名称。​
400​
InvalidIncorrectOrder.Malformed​
The specified index order is malformed.​
指定的索引顺序参数格式不合法。​
400​
InvalidResourceType.Malformed​
The specified ResourceType is malformed.​
指定的 ResourceType 参数格式不合法。​
400​
InvalidTagKey.Malformed​
The specified TagKey is malformed.​
指定的 TagKey 参数格式不合法。​
400​
InvalidTagValue.Malformed​
The specified TagValue is malformed.​
指定的 TagValue 参数格式不合法。​
400​
LimitExceeded.Resource​
You've reached the limit on the number of resources that you can operate at a time.​
已达到单次可操作资源数量的上限。​
400​
LimitExceeded.TagOperation​
You've reached the limit on the number of tags that you can operate at a time.​
已达到单次可操作的标签条目数量上限。​
400​
QuotaExceeded.ResourceCustomTags​
You've reached the limit on the number of resource tags that you can create.​
已达到单个资源可创建用户标签的数量的配额上限。​
400​
QuotaExceeded.ResourceSystemTags​
You've reached the limit on the number of system tags that you can create.​
已达到单个资源可创建系统标签的数量的配额上限。​
404​
InvalidResource.NotFound​
The specified resource does not exist.​
指定的资源不存在。​
​
最近更新时间:2025.12.09 10:55:04
这个页面对您有帮助吗?
有用
有用
无用
无用