设置对象标签
PutObjectTagging操作可以为对象设置标签,标签是一个键值对,每个对象最多可以有10个标签。bucket的拥有者默认拥有给bucket中的对象设置标签的权限,并且可以将权限授予其他用户。
每次执行PutObjectTagging操作会覆盖对象已有的标签信息。每个对象最多可以设置10个标签,标签Key和Value区分大小写,并且Key不可重复。每个标签的Key长度不超过128字节,Value长度不超过256字节。通过HTTP header的方式设置标签且标签中包含任意字符时,需要对标签的Key和Value做URL编码。设置对象标签信息不回更新对象的最新更改时间。
def put_object_tagging():
try:
resp = s3_client.put_object_tagging(
Bucket='YOUR_BUCKET_NAME',
Key='YOUR_OBJECT_NAME',
Tagging={
'TagSet': [
{
'Key': 'key1',
'Value': 'value1'
},
]
}
)
print(resp)
except ClientError as e:
logging.error(e)
参数 | 类型 | 说明 | 是否必要 |
---|---|---|---|
Bucket | string | 执行本操作的桶名称 | 是 |
Key | string | 设置标签信息的对象key | 是 |
Tagging | Tagging | 设置的标签信息,包含了一个Tag结构体的数组,每个Tag以Key-Value的形式说明了标签的内容。 | 是 |
VersionId | string | 设置标签信息的对象的版本Id | 否 |