object-tagging命令用于添加、修改、查询或删除对象(Object)的标签配置。

说明 对象标签功能介绍请参见对象标签

命令格式

  • 添加/修改对象标签配置
    ./ossutil object-tagging --method put oss://bucket[/prefix] key#value [--encoding-type url] [-r] [--payer requester] [--version-id versionId] [-c file]
    若Object未设置标签,此命令将为Object添加指定的标签;若Object已配置标签,此命令将覆盖Object原有标签。
    说明
    • 单个文件可设置最多10个标签,Key不可重复。
    • 每个Key长度不超过128字节,每个Value长度不超过256字节。
    • Key和Value区分大小写。
    • 标签合法字符集包括大小写字母、数字、空格和以下符号:

      +=._:/

    • 只有Bucket拥有者和授权用户拥有读写对象标签的权限,该权限不受对象ACL控制。
    • 跨区域复制时,对象标签也会复制到目的端。
  • 查询对象标签配置
    ./ossutil object-tagging --method get oss://bucket[/prefix] [--encoding-type url] [-r]  [--payer requester] [--version-id versionId] [-c file]
  • 删除对象标签配置
    ./ossuitl object-tagging --method delete oss://bucket[/prefix] [--encoding-type url] [-r] [--payer requester] [--version-id versionId] [-c file]

使用示例

  • 添加对象标签配置
    ./ossutil object-tagging --method put oss://bucket1/test.jpg a#1 b#2 c#3
    0.168034(s) elapsed
  • 查询对象标签配置
    ./ossutil object-tagging --method get oss://bucket1/test.jpg
    object index   tag index      tag key   tag value       object
    ---------------------------------------------------------------------------
    1              0              "a"       "1"     123/test.jpg
    1              1              "b"       "2"     123/test.jpg
    1              2              "c"       "3"     123/test.jpg
    
    0.228023(s) elapsed
  • 删除对象标签配置
    ./ossutil object-tagging --method delete oss://bucket1/test.jpg
    0.200020(s) elapsed

常用选项

您可以在使用object-tagging命令时附加如下选项:
选项名称 描述
--method 表示http的请求类型。取值:
  • put:添加或修改配置。
  • get:获取配置。
  • delete:删除配置。
--loglevel 设置日志级别,默认为空,表示不输出日志文件。可选值为:
  • info:输出提示信息日志。
  • debug:输出详细信息日志(包括http请求和响应信息)。
--proxy-host 网络代理服务器的url地址,支持http、https、socks5。例如http://120.79.**.**:3128、 socks5://120.79.**.**:1080。
--proxy-user 网络代理服务器的用户名,默认为空。
--proxy-pwd 网络代理服务器的密码,默认为空。
--payer 请求的支付方式,如果为请求者付费模式,需将该值设置为requester。
-j,--jobs 多文件操作时的并发任务数,默认值:3,取值范围:1-10000。
-r,--recursive 递归进行操作。当指定该选项时,命令会对Bucket下所有符合条件的Object进行操作,否则只对指定的单个Object进行操作。
--encoding-type 输入或者输出的文件名的编码方式,目前只支持url编码,即指定该选项时,取值为url。如果不指定该选项,则表示文件名未经过编码。Bucket名不支持url编码。
说明 更多通用选项请参见查看选项