对象存储 对象标签 – object-tagging

object-tagging 命令用于创建(修改)、查询、删除对象标签。每个对象最多支持10组标签。

相关产品
对象存储 产品页,含版本规格、价格与购买入口。

注意:更多授权请参见 支持 CAM 的业务接口。

一、命令格式

./coscli object-tagging –method [method] cos://<bucket-name>/object [tag_key]#[tag_value]

object-tagging 命令包含以下参数:

参数格式 参数用途 示例
cos://<bucket-name> 指定需要访问的存储桶。支持使用 配置参数 中的桶别名,或桶名称进行访问。如使用桶名称访问,需要额外携带 endpoint flag 使用桶别名访问:cos://example-alias使用桶名称访问:cos://examplebucket-1250000000

object-tagging 命令包含以下可选 flag:

flag 简写 flag 全称 flag 用途
-h –help 查看该命令的具体用法
无 –method 指定需要进行的操作,包括 put(设置标签)、get(查询标签)、delete(删除标签)、add(添加标签)
无 –version-id 操作对象的特定版本

注意:说明:

注意:关于此命令的其他通用选项(例如切换存储桶、切换用户账号等),请参见 通用选项 文档。

二、修改对象标签

对象标签用一组键值对(Key-Value)来表示,只有对象所有者及拥有 PutObjectTagging 权限的用户才可以添加或修改对象标签,否则会返回错误码 403 AccessDenied。

三、命令格式

./coscli object-tagging –method put cos://bucketAlias/object key1#value1 key2#value2

其中,key#value表示标签键值对 Key-Value,key 和 value 之间以#分隔。若对象未设置标签,此命令将为对象添加指定的标签;若对象已设置标签,此命令将覆盖原有的标签。

四、操作示例

为桶别名为 example-alias下的 object 对象配置两组标签,其中一组标签的 key 为1,value 为111,一组标签的 key 为2,value 为222。命令如下:

./coscli object-tagging –method put cos://example-alias/object 1#111 2#222

五、命令格式

./coscli object-tagging –method get cos://bucketAlias/object

六、操作示例

./coscli object-tagging –method get cos://example-alias/object

以下输出结果表明桶别名为 example-alias下的 object 对象配置了两组标签,其中一组标签的 key 为1,value 为111,一组标签的 key 为2,value 为222。

KEY | VALUE ——+——– 1 | 111 2 | 222

七、命令格式

./coscli object-tagging –method delete cos://bucketAlias/object key1#value1

八、操作示例

./coscli object-tagging –method delete cos://example-alias/object 1#111

九、命令格式

./coscli object-tagging –method delete cos://bucketAlias/object

十、操作示例

./coscli object-tagging –method delete cos://example-alias/object

十一、添加对象标签

对象标签用一组键值对(Key-Value)来表示,只有对象所有者及拥有 PutObjectTagging 权限的用户才可以添加或修改对象标签,否则会返回错误码 403 AccessDenied。

十二、命令格式

./coscli object-tagging –method add cos://bucketAlias/object key3#value3

其中,key#value表示标签键值对 Key-Value,key 和 value 之间以#分隔。

十三、操作示例

为桶别名为 example-alias下的 object 对象添加一组标签,标签的 key 为1,value 为111。命令如下:

./coscli object-tagging –method add cos://example-alias/object 1#111

赞 (0)
上一篇 4天前
下一篇 4天前