get-object-tagging

get-object-tagging用于获取对象(Object)的标签(Tagging)信息。

注意事项

  • 阿里云账号默认拥有获取对象的标签的权限。如果您需要通过RAM用户或者STS的方式获取,您必须拥有oss:GetObjectTagging权限。具体操作,请参见为RAM用户授权自定义的权限策略

  • 使用get-object-tagging命令时,默认只能获取Object当前版本的标签信息。您可以通过指定versionId参数来获取指定Object版本的标签信息。

命令格式

ossutil api get-object-tagging --bucket value --key value [flags]

参数

类型

说明

--bucket

string

Bucket名称。

--key

string

Object的完整路径。

--version-id

string

Object的版本号。

说明

使用示例

  • 获取存储空间examplebucket的标签信息。

    ossutil api get-object-tagging --bucket examplebucket --key exampleobject
  • 获取存储空间examplebucket的标签信息,以JSON格式显示。

    ossutil api get-object-tagging --bucket examplebucket --key exampleobject --output-format json
  • 获取存储空间examplebucket的标签信息,以YAML格式显示。

    ossutil api get-object-tagging --bucket examplebucket --key exampleobject --output-format yaml