文档中心

云备份

标签

TagResources - 添加标签

调用 TagResources 给资源添加标签。

调试

API Explorer

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

去调试

请求参数

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

Action string 必选示例值：TagResources

要执行的操作，取值：TagResources。

Version string 必选示例值：2024-03-01

API的版本，取值：2024-03-01。

ResourceType string 必选示例值：vault

资源类型，值为 vault，表示为备份库配置标签。

ResourceIds string[] 必选示例值：["vault-gju1gl0uapd5b3fr****"]

资源 ID 列表。

Tags object[] 必选示例值：--

Tag 数组。

Key string 必选示例值：my-key

标签的键。

Value string 必选示例值：my-value

标签的值。

返回参数

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

请求示例

POST /?Action=TagResources&Version=2024-03-01 HTTP/1.1​
Host: cbr.cn-beijing.volcengineapi.com​
Content-Type: application/json; charset=UTF-8​
X-Date: 20251030T093400Z​
X-Content-Sha256: 287e874e******d653b44d21e​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20251030/cn-beijing/cbr/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
{​
  "ResourceType": "vault",​
  "ResourceIds": ["vault-gju1gl0uapd5b3frq9hw"],​
  "Tags": [​
    {​
      "Key": "my-key",​
      "Value": "my-value"​
    }​
  ]​
}​

返回示例

{​
  "ResponseMetadata": {​
    "RequestId": "20251030173440152066059102B2D7B9",​
    "Action": "TagResources",​
    "Version": "2024-03-01",​
    "Service": "cbr",​
    "Region": "cn-beijing"​
  },​
  "Result": {}​
}​

错误码

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

状态码	错误码	错误信息	说明
400	ObjectNotExist	The specified object does not exist.	当前账号下不存在该对象。
400	InvalidParameter	The specified parameter %s is not valid.	参数值无效。
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	内部错误。

最近更新时间：2025.10.31 18:11:02

这个页面对您有帮助吗？

有用

无用