调用 ModifyInstanceTag 接口,编辑实例的标签,支持新增、更新和删除标签。
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ModifyInstanceTag | 要执行的操作,取值:ModifyInstanceTag。 |
Version | String | 是 | 2023-06-01 | API的版本,取值:2023-06-01。 |
InstanceId | String | 是 | o-00c0****m46c | 需要编辑标签的实例 ID。 |
DeleteTags | Array of Object | 否 | - | 需要删除的资源标签。 |
UpdateTags | Array of Object | 否 | - | 需要新增、更新的资源标签。 |
下表仅列出本接口特有的返回参数。更多信息请参见返回结构。
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
Status | String | SUCCESS | 操作状态。 |
Message | String | OK | 操作提示信息。 |
POST /?Action=ModifyInstanceTag&Version=2023-06-01 HTTP/1.1 Host: bmq.volcengineapi.com Content-Type: application/json; charset=UTF-8 X-Date: 20241104T130804Z X-Content-Sha256: 287e874e******d653b44d21e Authorization: HMAC-SHA256 Credential=AK********/20241104/cn-beijing/bmq_dev/request, SignedHeaders=host;x-content-sha256;x-date, Signature=******** { "InstanceId": "o-00c0****m46c", "UpdateTags": [ { "Type": "intsance", "Kvs": { "tag-key-1": "tag-value-1" } } ], "DeleteTags": [ { "Type": "CUSTOM", "Keys": [ "tag-key-2" ] } ] }
{ "ResponseMetadata": { "RequestId": "2024110421080812703117506089****", "Action": "ModifyInstanceTag", "Version": "2023-06-01", "Service": "bmq", "Region": "cn-beijing" }, "Result": { "Status": "SUCCESS", "Message": "OK" } }
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。