文档首页/ 对象存储服务 OBS/ 工具指南/ obsutil/ 对象相关命令/ 授权码列举对象
更新时间：2024-12-11 GMT+08:00
查看PDF
分享

授权码列举对象

功能说明

使用授权码查询桶内对象，返回对象列表将按照对象名以字典序排列。

命令结构

  • Windows操作系统
    • 直接输入授权码 
      obsutil share-ls authorization_code [-ac=xxx] [-prefix=xxx] [-s] [-d] [-marker=xxx] [-bf=xxx] [-limit=1] [-format=default] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
    • 使用文件路径传入授权码 
      obsutil share-ls file://authorization_code_file_url [-ac=xxx] [-prefix=xxx] [-s] [-d] [-marker=xxx] [-bf=xxx] [-limit=1] [-format=default] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
  • macOS/Linux操作系统
    • 直接输入授权码 
      ./obsutil share-ls authorization_code [-ac=xxx] [-prefix=xxx] [-s] [-d] [-marker=xxx] [-bf=xxx] [-limit=1] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
    • 使用文件路径传入授权码 
      ./obsutil share-ls file://authorization_code_file_url [-ac=xxx] [-prefix=xxx] [-s] [-d] [-marker=xxx] [-bf=xxx] [-limit=1] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

运行示例

  • 以Windows操作系统为例，运行obsutil share-ls xxx -ac=123456 -limit=1，使用授权码查询桶内对象。 
    obsutil share-ls xxx -ac=123456 -limit=1
The authorized prefix is [test/test.tar.gz]
Listing objects .
Object list:
key                                             LastModified                  Size      StorageClass        ETag
obs://bucket-test/test/test.tar.gz              2019-07-11T14:50:59Z          48.92KB   standard    "1dd27294ad2f152b43cd111e9fe3990f"

Total size of prefix [test/]: 48.92KB
Folder number: 0
File number: 1
The authorized prefix is [test/]
  • 以Windows操作系统为例，运行obsutil share-ls xxx -ac=123456 -limit=1，使用授权码查询桶内目录。 
    obsutil share-ls xxx -ac=123456 -limit=1

The authorized prefix is [test]

Listing objects .

Folder list:
obs://bucket-test/test/

Object list:
key                                             LastModified                  Size      StorageClass        ETag
obs://bucket-test/test/test.tar.gz              2019-07-11T14:50:59Z          48.92KB   standard    "1dd27294ad2f152b43cd111e9fe3990f"

Total size of prefix [test/]: 48.92KB
Folder number: 1
File number: 1
The authorized prefix is [test/]

参数说明

参数

约束

描述

authorization_code

或

file://authorization_code_file_url

必选

授权码。

说明：

如果以“file://”开头，则表明授权码是从本地文件中获取。

ac

附加参数，可选

提取码。

说明：
  • 如果未使用该参数设置提取码，obsutil工具会以交互模式提示输入提取码；
  • 提取码必须为6位。

prefix

附加参数，可选

使用授权码列举对象时的对象名前缀。

说明：
  • 如果该值不为空，其必须是授权码中授权路径的子集。
  • 如果该值为空，则表示列举授权码中授权路径下的所有对象。

s

附加参数，可选

以精简格式显示查询结果。

说明：

在精简格式下，返回结果只包含对象名。

d

附加参数，可选

仅列举当前目录下的对象和子目录，而非递归列举所有对象和子目录。

说明：

OBS中约定以“/”作为目录分隔符。

marker

附加参数，可选

使用授权码列举桶内对象时的起始位置，返回结果是对象名按照字典序排序后该参数以后的所有对象。

bf

附加参数，可选

列举结果中字节数的显示格式。支持的值：

  • human-readable
  • raw
说明：

如果未设置该参数，则列举结果中字节数的显示格式由配置文件中的humanReadableFormat参数决定。

limit

附加参数，可选

列举结果的最大个数，小于等于0表示列举所有结果，不设置时的默认值为1000。

说明：

如果桶内对象较多，建议设置该值限制每次列举的对象个数，列举结束后，如果仍有对象，会在结果中返回下次请求的marker，用于继续列举剩余的对象。

format

附加参数，可选

指定以自定义格式打印列举结果。当前仅支持值[default]，指定列举结果在一行显示。

config

附加参数，可选

运行当前命令时的自定义配置文件，可支持的配置参数请参考配置参数说明。

e

附加参数，可选

指定终端节点。

i

附加参数，可选

指定用户的AK。

k

附加参数，可选

指定用户的SK。

t

附加参数，可选

指定用户的securitytoken。
父主题： 对象相关命令

相关文档