更新时间:2022-05-18 GMT+08:00

授权码列举对象

功能说明

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

命令结构

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

运行示例

  • 以Windows操作系统为例,运行obsutil share-ls xxx -ac=123456 -limit=1,使用授权码查询桶内对象。
    obsutil share-ls xxx -ac=123456 -limit=1
    
    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/] is: 48.92KB
    Folder number is: 0
    Object number is: 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

附加参数,可选

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