# 创建目录分享的授权码
#### 功能说明
指定桶名、对象名前缀和提取码，创建目录分享的授权码。
#### 命令结构
- Windows操作系统
  ```
  obsutil create-share obs://bucket[/prefix] [-ac=xxx] [-vp=xxx] [-dst=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
  ```
  
- macOS/Linux操作系统
  ```
  ./obsutil create-share obs://bucket[/prefix] [-ac=xxx] [-vp=xxx] [-dst=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
  ```
  
 
#### 运行示例
- 以Windows操作系统为例，运行**obsutil create-share obs://bucket/test/ -ac=12345678 -vp=1m** ，创建一个月内有效的授权码。
  ```
  obsutil create-share obs://bucket/test/ -ac=12345678 -vp=1m
  Authorization Code:
  https://e-share.obs-website.cn-north-4.myhuaweicloud.com?
  token=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  Access Code:
  12345678
  Valid Until:
  Sat, 26 Oct 2019 11:28:10 GMT +0800
  ```
  
 
#### 参数说明
| **参数** | **约束**  | **描述**                                                                                                                                                                                                                                                                                                                                                                     |
|:---|:---|:---|
| bucket | 必选      | 桶名                                                                                                                                                                                                                                                                                                                                                                         |
| prefix | 可选      | 对象名前缀，如果不为空，代表分享以该前缀开头的所有对象；如果为空，代表分享整个桶内的对象。 说明： 设置该值时，建议均以"/"结尾。                                                                                                                                                                                                                                             |
| ac     | 附加参数，可选 | 提取码。 说明： - 如果未使用该参数传入提取码，obsutil工具会以交互模式提示输入提取码。  - 提取码必须为8位。                                                                                                                   |
| vp     | 附加参数，可选 | 授权码的有效期，以当前时间为基准，默认值为1天，代表生成的授权码将在1天后变为无效。 说明： - 该参数支持多种时间单位的配置方式，包括：m（月）、w（周）、d（天）、h（小时）、min（分钟）、s（秒），例如1d代表一天内有效，2w代表两周内有效，3h代表三个小时内有效。  - 如果不带时间单位，则该参数为授权码有效的秒数，例如3600代表3600秒内有效。   |
| dst    | 附加参数，可选 | 生成授权码的保存路径。                                                                                                                                                                                                                                                                                                                                                                |
| config | 附加参数，可选 | 运行当前命令时的自定义配置文件。可支持的配置参数请参考[配置参数说明](https://support.huaweicloud.com/utiltg-obs/obs_11_0035.html)。                                                                                                                                                                                                                                                                          |
| e      | 附加参数，可选 | 指定终端节点。                                                                                                                                                                                                                                                                                                                                                                    |
| i      | 附加参数，可选 | 指定用户的AK。                                                                                                                                                                                                                                                                                                                                                                   |
| k      | 附加参数，可选 | 指定用户的SK。                                                                                                                                                                                                                                                                                                                                                                   |
| t      | 附加参数，可选 | 指定用户的securitytoken。                                                                                                                                                                                                                                                                                                                                                        |
   
#### 响应结果
| **字段名**            | **描述**  |
|:---|:---|
| Authorization Code | 授权码。    |
| Access Code        | 提取码。    |
| Valid Until        | 有效截止时间。 |