授权码列举对象
功能说明
使用授权码查询桶内对象,返回对象列表将按照对象名以字典序排列。
命令结构
- 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 |
附加参数,可选 |
提取码。
说明:
|
prefix |
附加参数,可选 |
使用授权码列举对象时的对象名前缀。
说明:
|
s |
附加参数,可选 |
以精简格式显示查询结果。
说明:
在精简格式下,返回结果只包含对象名。 |
d |
附加参数,可选 |
仅列举当前目录下的对象和子目录,而非递归列举所有对象和子目录。
说明:
OBS中约定以“/”作为目录分隔符。 |
marker |
附加参数,可选 |
使用授权码列举桶内对象时的起始位置,返回结果是对象名按照字典序排序后该参数以后的所有对象。 |
bf |
附加参数,可选 |
列举结果中字节数的显示格式。支持的值:
说明:
如果未设置该参数,则列举结果中字节数的显示格式由配置文件中的humanReadableFormat参数决定。 |
limit |
附加参数,可选 |
列举结果的最大个数,小于等于0表示列举所有结果,不设置时的默认值为1000。
说明:
如果桶内对象较多,建议设置该值限制每次列举的对象个数,列举结束后,如果仍有对象,会在结果中返回下次请求的marker,用于继续列举剩余的对象。 |
format |
附加参数,可选 |
指定以自定义格式打印列举结果。当前仅支持值[default],指定列举结果在一行显示。 |
config |
附加参数,可选 |
运行当前命令时的自定义配置文件,可支持的配置参数请参考配置参数说明。 |