# 归档日志文件
#### 功能说明
将日志文件归档到本地，或归档到指定的桶。
#### 命令结构
- Windows操作系统
  - 归档到本地
    ```
    obsutil archive [file_or_folder_url] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
    ```
    
  
  - 归档到指定的桶
    ```
    obsutil archive obs://bucket[/key] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
    ```
    
   
- macOS/Linux操作系统
  - 归档到本地
    ```
    obsutil archive [file_or_folder_url] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
    ```
    
  
  - 归档到指定的桶
    ```
    obsutil archive obs://bucket[/key] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
    ```
    
   
 
#### 运行示例
- 以Windows操作系统为例，运行**obsutil archive** ，归档日志到工具运行的同级目录。
  ```
  obsutil archive
  [----------------------------------------------------------] 100.00% 15/15 35ms
  Succeed to archive log files to [D:\obsutil\obsutil_log.zip]
  ```
  
 
#### 参数说明
| **参数**             | **约束**     | **描述**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
|:---|:---|:---|
| file_or_folder_url | 可选         | 日志归档路径，规则如下： - 如果该值为空，则以obsutil_log.zip为归档文件名，将日志归档到obsutil命令同级目录下；  - 如果file_or_folder_url不存在，则工具会判断其是否以"/"或"\\"结尾，如果是，则会以该路径创建文件夹，并以obsutil_log.zip为归档文件名将日志归档到该新建的文件夹下；  - 如果file_or_folder_url不存在，且不以"/"或"\\"结尾，则以该值作为归档文件名，将日志归档到本地；  - 如果file_or_folder_url为已存在的zip文件，则以该值作为归档文件名，将日志覆盖归档到本地；  - 如果file_or_folder_url为已存在的文件夹，则以obsutil_log.zip为归档文件名，将日志覆盖归档到file_or_folder_url指定的文件夹下。   说明： 归档文件均是以.zip结尾的压缩文件。 |
| bucket             | 归档到指定的桶时必选 | 桶名。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| key                | 归档到指定的桶时可选 | 归档日志到指定的桶时的对象名/对象名前缀。 规则如下： - 如果该值为空，则以obsutil_log.zip为对象名，将日志归档到桶的根目录；  - 如果该值不为空，如果该值以"/"结尾，则以该值作为对象名前缀归档日志，对象名为该值+obsutil_log.zip；否则，将该值作为对象名进行归档；                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| config             | 附加参数，可选    | 运行当前命令时的自定义配置文件，可支持的配置参数请参考[配置参数说明](https://support.huaweicloud.com/utiltg-obs/obs_11_0035.html)。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| e                  | 附加参数，可选    | 指定终端节点。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| i                  | 附加参数，可选    | 指定用户的AK。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| k                  | 附加参数，可选    | 指定用户的SK。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| t                  | 附加参数，可选    | 指定用户的securitytoken。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |