PutObjectTagging_对象存储_API文档-阿里云OpenAPI开发者门户

接口说明

注意事项

对象标签使用一组键值对（Key-Value）标记对象。
单个 Object 最多能设置 10 个标签，Key 不能重复。
每个 Key 长度不能超过 128 字符，每个 Value 长度不能超过 256 字符。
Key 和 Value 区分大小写。
标签的合法字符集包括大小写字母、数字、空格和以下符号： +‑=._:/ 通过 HTTP Header 的方式设置标签且标签中包含任意字符时，您需要对标签的 Key 和 Value 进行 URL 编码。
更改标签信息不会更新 Object 的 Last‑Modified 时间。

关于对象标签的更多信息，请参见对象标签。

版本控制

调用 PutObjectTagging 接口时，默认设置 Object 当前版本的标签信息。您可以通过指定 versionId 参数来设置指定 Object 版本的标签信息。如果 Object 的对应版本为删除标记（Delete Marker），则 OSS 将返回 404 Not Found。

流控信息

当前云产品API请求速率暂未透出。

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

oss:PutObjectTagging	Update	Object acs:oss:oss-{#regionId}:{#accountId}:{#BucketName}/{#ObjectName}	oss:ExistingObjectTag oss:RequestObjectTag acs:UserAgent acs:AccessId oss:BucketTag oss:DataAccessPointArn oss:AccessPointNetworkOrigin oss:DataAccessPointAccount oss:TLSVersion	oss:PutObjectVersionTagging oss:GetObject

请求语法

PUT /{key}?tagging HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
<?xml version="1.0" encoding="UTF-8"?>
<Tagging>
  <TagSet>
    <Tag>
      <Key>string</Key>
      <Value>string</Value>
    </Tag>
  </TagSet>
</Tagging>

路径参数

字段名称	字段详情
keystring	Object 的完整路径。示例值:exampledir/exampleobject.txt

请求参数

字段名称	字段详情
bucketstring	Bucket 名称。示例值:examplebucket
versionIdstring	版本对应的 ID。示例值:CAEQNRiBgMClj7qD0BYiIDQ5Y2QyMjc3NGZkODRlMTU5M2VkY2U3MWRiNGRh****
bodyobject	保存标签集合的请求体。

变更历史

	变更时间	变更内容概要	操作
	2024-02-21	新增请求参数body