
# 阿里云OSS
阿里云OSS提供了ossutil工具来解冻归档对象，支持解冻指定前缀的归档类型对象。ossutil工具支持Windows、Linux和macOS等操作系统，您可以根据实际情况下载和安装合适的版本。
本文以Windows系统为例进行介绍。
#### 操作步骤
1. 下载ossutil工具。 
   - [Windows x86 32bit](https://gosspublic.alicdn.com/ossutil/1.7.13/ossutil32.zip)
   
   - [Windows x86 64bit](https://gosspublic.alicdn.com/ossutil/1.7.13/ossutil64.zip?spm=a2c4g.11186623.0.0.128b68c3Oy9nmS&file=ossutil64.zip)
   
   
   
   
2. 将安装包解压，并双击运行ossutil.bat文件。
3. 运行以下命令，生成配置文件。 
   ```
   解压路径\ossutil>ossutil64.exe config
   ```
   
   
4. 使用交互式配置生成配置文件。 
   1. 输入配置命令。
      ```
      ./ossutil64 config
      ```
      
   
   2. 根据提示设置配置文件路径。 建议直接按回车使用默认配置文件的路径。
      
   
   3. 根据提示设置工具的语言。 请输入语言**CH** 或**EN**。工具使用的语言默认与操作系统保持一致。该配置项将在此次config命令设置成功后生效。
      
   
   4. 根据提示分别设置Endpoint、AccessKey ID、AccessKey Secret和STSToken参数。 参数说明如下：
      - **endpoint**：填写Bucket所在地域的Endpoint。您也可以增加http://或https://指定ossutil访问OSS使用的协议，默认使用HTTP协议。例如：使用HTTPS协议访问深圳的Bucket，设置为:https://oss-cn-shenzhen.aliyuncs.com。
      
      - **accessKeyID、accessKeySecret**：填写账号的AccessKey。
      
      - **stsToken**：使用STS临时授权账号访问OSS时需要配置该项，否则置空即可。
       
   
   
   **示例**：
   ```
   ./ossutil64 config 
   请输入配置文件名，文件名可以带路径（默认为：/home/user/.ossutilconfig，回车将使用默认路径。 
   如果用户设置为其它路径，在使用命令时需要将--config-file选项设置为该路径）：  
   未输入配置文件路径，将使用默认配置文件：/home/user/.ossutilconfig。  
   对于下述配置，回车将跳过相关配置项的设置，配置项的具体含义，请使用"help config"命令查看。  
   请输入endpoint：  
   请输入accessKeyID：  
   请输入accessKeySecret： 
   请输入stsToken：
   ```
   
   
5. 通过命令行工具，执行**restore** 命令解冻文件。
   
   命令格式：
   ```
   Binary名称 restore oss://bucketname[/prefix][local_xml_file]
   [--encoding-type <value>]
   [--payer <value>]
   [--version-id <value>]
   [-r, --recursive]
   [-f, --force]
   [--retry-times <value>]
   [-j，--job <value>]
   ```
   ![](https://support.huaweicloud.com/bestpractice-oms/public_sys-resources/caution_3.0-zh-cn.png)
   命令行开头的**Binary名称** 需要根据操作系统替换，例如：Linux 64位系统替换为**./ossutil64**。更多详情，请参见阿里云OSS《命令行工具ossutil快速入门》文档。
   参数说明参见下表：
   
   | 参数              | 说明                                                                                             |
   |:---|:---|
   | bucketname      | 桶名称。                                                                                           |
   | prefix          | 桶内带该前缀的对象。                                                                                     |
   | local_xml_file  | 本地XML格式文件，用于保存冷归档类型文件的解冻参数。                                                                    |
   | --encoding-type | 对prefix名称进行编码，取值为url。 如果不指定该选项，则表示prefix未经过编码。                   |
   | --payer         | 请求的支付方式。 如果希望访问指定路径下的资源产生的流量、请求次数等费用由请求者支付，请将此选项的值设置为requester。 |
   | --version-id    | 对象的指定版本。仅适用于已开启或暂停版本控制状态桶下的对象。                                                                 |
   | -r，--recursive  | 如果指定该选项时，ossutil将解冻所有与prefix匹配的文件。 如果不指定该选项，则ossutil只解冻指定文件。    |
   | -f, --force     | 强制操作，不进行询问提示。                                                                                  |
   | --retry-times   | 发生错误后的重试次数。默认值为10，取值范围为1\~500。                                                                 |
   | -j，--job        | 多文件操作时的并发任务数，默认值为3，取值范围为1\~10000。                                                              |
      
   更多详情，请参见阿里云OSS restore解冻文件相关文档。
   
   
6. 解冻完成后，参考[阿里云OSS迁移至华为云OBS教程](https://support.huaweicloud.com/bestpractice-oms/oms_05_0057.html)，将数据迁移到华为云OBS。
 
