本文档用于帮助用户在完成 OSS 转储授权之后，使用命令行工具快速完成转储任务的提交

使用前提

1. 请确保已经执行过 归档存储 对 OSS 访问的授权，授权流程请参考OSS转储授权

2. 请确保已经安装过命令行工具 oascmd.py，安装流程请参考命令行工具

注意事项

OSS 转储暂只支持内网之间转移，osshost的域名请加上 internal 标识。

开始使用

1. 使用配置

   OSS 转储使用 oascmd.py 的 cp 命令来完成，参数说明请参考命令行工具或者使用

    $ oascmd.py cp -h

   cp 命令需要配置 OSS 的域名，可以通过以下三种方式指定：

   • 在命令行指定 —osshost 参数

   • 在 归档存储 的配置文件增加一个 osshost=<oss-host-domain> 的配置（推荐方案）

   • OSS 默认的配置文件（用户目录下的 .osscredentials）的 host 配置项

     以上三种方式按照从上到下的顺序依次读取，如果均未指定，cp 命令会报错。

2. 典型使用

    # 1. 从 OSS 转储到 归档存储，成功提交任务以后会返回一个 Job ID。
    $ oascmd.py cp oss://<bucketname>/<object-path> oas://<vaultname>
    # 2. 查询转储进度或转储完成后生成的 Archive 的 ID 等信息
    $ oascmd.py getjobdesc oas://<vaultname> <job-id>
    # 3. 从 归档存储 提取文件到 OSS
    $ oascmd.py cp oas://<vaultname>/<archive-id> oss://<bucketname>/<dest-object-path>

其他说明

• 从 OSS 到 归档存储 转储，目的 Vault 不需要指定文件名，只能由 归档存储 生成。

• 转储完成后，getjobdesc 返回的 Job 信息里有一个 ArchiveId 字段，该字段内容即为新生成的 Archive 的 ID，未完成时该字段为空。

• 从 归档存储 到 OSS，并不需要 Archive 来自原 OSS 集群， 通过 归档存储 的接口上传的 Archive 也同样可以通过 cp 命令提取到指定的 OSS。