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