# 授权码列举对象
#### 功能说明
使用授权码查询桶内对象，返回对象列表将按照对象名以字典序排列。
#### 命令结构
- 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=12345678 -limit=1** ，使用授权码查询桶内对象。
  ```
  obsutil share-ls xxx -ac=12345678 -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=12345678 -limit=1** ，使用授权码查询桶内目录。
  ```
  obsutil share-ls xxx -ac=12345678 -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工具会以交互模式提示输入提取码；  - 提取码必须为8位。                                                                    |
| prefix                                                                                                                 | 附加参数，可选    | 使用授权码列举对象时的对象名前缀。 说明： - 如果该值不为空，其必须是授权码中授权路径的子集。  - 如果该值为空，则表示列举授权码中授权路径下的所有对象。                                                          |
| s                                                                                                                       | 附加参数，可选   | 以精简格式显示查询结果。 说明： 在精简格式下，返回结果只包含对象名。                                                                                                                                                                                                                              |
| d                                                                                                                      | 附加参数，可选 | 仅列举当前目录下的对象和子目录，而非递归列举所有对象和子目录。 说明： OBS中约定以"/"作为目录分隔符。                                                                                                                                                                                                            |
| marker                                                                                                                | 附加参数，可选  | 使用授权码列举桶内对象时的起始位置，返回结果是对象名按照字典序排序后该参数以后的所有对象。                                                                                                                                                                                                                                                  |
| bf                                                                                                                      | 附加参数，可选 | 列举结果中字节数的显示格式。支持的值： - human-readable  - raw   说明： 如果未设置该参数，则列举结果中字节数的显示格式由配置文件中的humanReadableFormat参数决定。 |
| limit                                                                                                                 | 附加参数，可选   | 列举结果的最大个数，小于等于0表示列举所有结果，不设置时的默认值为1000。 说明： 如果桶内对象较多，建议设置该值限制每次列举的对象个数，列举结束后，如果仍有对象，会在结果中返回下次请求的marker，用于继续列举剩余的对象。                                                                                                                                              |
| format                                                                                                              | 附加参数，可选    | 指定以自定义格式打印列举结果。当前仅支持值\[default\]，指定列举结果在一行显示。                                                                                                                                                                                                                                                  |
| config                                                                                                                 | 附加参数，可选    | 运行当前命令时的自定义配置文件。可支持的配置参数请参考[配置参数说明](https://support.huaweicloud.com/utiltg-obs/obs_11_0035.html)。                                                                                                                                                                                 |
| e                                                                                                                     | 附加参数，可选  | 指定终端节点。                                                                                                                                                                                                                                                                                        |
| i                                                                                                                     | 附加参数，可选   | 指定用户的AK。                                                                                                                                                                                                                                                                                       |
| k                                                                                                                      | 附加参数，可选   | 指定用户的SK。                                                                                                                                                                                                                                                                                      |
| t                                                                                                                     | 附加参数，可选  | 指定用户的securitytoken。                                                                                                                                                                                                                                                                            |