AWS Snowball
用户指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

Snowball 客户端的命令

在下文中,您可以找到有关 Snowball 客户端命令的信息,这些信息可帮助您管理向 Amazon Simple Storage Service (Amazon S3) 传输数据的操作。您可以在连接到单个 Snowball 的不同终端窗口中使用多个 Snowball 客户端实例。

数据传输期间,Snowball 的根级别将显示至少一个文件夹。此文件夹以及这一级别的任何其他文件夹将具有您在创建任务时为 Amazon S3 存储桶选择的名称。您无法将数据写入到 Snowball 的根级别。所有数据必须写入到其中一个存储桶文件夹或其子文件夹。

您可以使用名称中有空格的文件或文件夹,如 my photo.jpgMy Documents。但是,请确保您在客户端命令中正确处理了空格。有关更多信息,请参阅以下示例:

  • 该客户端的 Linux 和 Mac 版本snowball ls s3://mybucket/My\ Folder/my\ photo.jpg

  • 该客户端的 Windows 版本snowball ls "s3://mybucket/My Documents/my photo.jpg"

注意

在使用 Snowball 将数据传输到 Amazon S3 中之前,您应确保根据 Amazon S3 的对象键命名指南对要传输的文件和文件夹进行命名。

如果您在使用 Snowball 客户端时遇到问题,请参阅标准 Snowball 的故障排除

Snowball 客户端的复制命令

snowball cp 命令在 Snowball 和您的数据源之间复制文件和文件夹。有关 Snowball 复制命令 (snowball cp) 选项的详细信息,请参阅 snowball cp 命令的选项。除支持的命令选项外,使用 Snowball 客户端传输数据时,还可以使用架构定义正在传输的数据类型。有关架构的更多信息,请参阅 Snowball 客户端的架构

用法

snowball cp [OPTION...] SRC... s3://DEST

导入示例

snowball cp --recursive /Logs/April s3://MyBucket/Logs
snowball cp -r /Logs/April s3://MyBucket/Logs

导出示例

snowball cp --recursive s3://MyBucket/Logs/ /Logs/April
snowball cp -r s3://MyBucket/Logs/ /Logs/April

有关 Snowball 复制命令 (snowball cp) 选项的详细信息,请参阅 snowball cp 命令的选项

Snowball 客户端的列出命令

snowball ls 命令列出指定路径中的 Snowball 内容。您不能使用此命令列出在 Snowball 网络之外的工作站、数据源或其他网络位置上的内容。

用法

snowball ls [OPTION...] s3://DEST

示例

snowball ls s3://MyBucket/Logs/April

Snowball 客户端的创建目录命令

snowball mkdir 命令在 Snowball 上创建新的子文件夹。您无法在根级别创建新文件夹。根级别是为存储桶文件夹保留的。

用法

snowball mkdir [OPTION...] s3://DEST

示例

snowball mkdir s3://MyBucket/Logs/April/ExpenseReports

Snowball 客户端的重试命令

snowball retry 命令对上次执行 snowball cp 期间未复制的所有文件重试 snowball cp 命令。未复制文件列表以纯文本格式保存在您的工作站临时目录的日志中。snowball cp 命令未能复制文件时,指向该日志的准确路径将输出到终端上。

示例用法

snowball retry

Snowball 客户端的删除命令

snowball rm 命令删除 Snowball 上的文件和文件夹。如果此操作将删除大量文件或目录 (例如,与 snowball rm -r 一起使用将删除设备上的所有内容),则需要一些时间才能完成。如果您之后运行 snowball ls 命令,则它将在删除操作完成时显示设备的状态。

不过,snowball status 命令报告的存储量可能会显示发出 snowball rm 命令之前的剩余存储量。如果发生这种情况,请在约 1 小时后尝试发出 snowball status 命令来查看新的剩余存储值。

用法

snowball rm [OPTION...] s3://DEST

示例

snowball rm --recursive s3://MyBucket/Logs/April
snowball rm -r s3://MyBucket/Logs/April

Snowball 客户端的启动命令

snowball start 命令使用 Snowball 的 IP 地址和您的凭证,验证您对 Snowball 的访问权限。在运行 snowball start 命令之后,您可以执行任意数量的 snowball cp 命令。

用法

snowball start -i IP Address -m Path/to/manifest/file -u 29 character unlock code

示例

snowball start -i 192.0.2.0 -m /user/tmp/manifest -u 01234-abcde-01234-ABCDE-01234

Snowball 客户端的状态命令

snowball status 命令返回 Snowball 的状态。

示例用法

snowball status

示例输出

Snowball Status: SUCCESS S3 Endpoint running at: http://192.0.2.0:8080 Total Size: 72 TB Free Space: 64 TB

Snowball 客户端的停止命令

snowball stop 命令停止从 Snowball 客户端的当前实例到 Snowball 的通信。

您可以使用此命令确保数据源服务器与 Snowball 之间的所有其他命令已停止。如果您有多个客户端实例连接到单个 Snowball,则在您准备好停止传输数据时,需要针对每个实例使用此命令。您可以运行此命令来停止客户端的一个实例,同时仍然使用其他实例复制数据。

示例用法

snowball stop

Snowball 客户端的测试命令

snowball test 命令在传输开始之前,对数据传输进行测试。有关更多信息,请参阅使用 Snowball 客户端测试您的数据传输

示例用法

snowball test

Snowball 客户端的验证命令

除非另行指定路径,否则 snowball validate 命令将验证 Snowball 中的所有元数据和对象的传输状态。如果您指定路径,则此命令将验证该路径指向的内容及其子目录中的内容。此命令将列出当前正在传输的文件,并将其传输状态标记为未完成。

对于导入任务而言,这样做可确保您的内容顺利导入到 AWS 中。

此命令可能需要一些时间才能完成,并且可能不时出现停滞。在有大量文件时,此效果很常见;在文件嵌套在多个子文件夹中时,更为如此。建议您将此命令与 verbose 选项一起运行。

示例用法

snowball -v validate

Snowball 客户端的版本命令

snowball version 命令在终端上显示 Snowball 客户端版本。

示例用法

snowball version

使用详细选项

每当执行 Snowball 客户端命令时,您都可以使用 verbose 选项来获取更多信息。此额外信息将在此命令运行时输出到终端。

使用 verbose 选项可帮助您更好地了解每个命令执行的操作。此外,它还可帮助您解决使用 Snowball 客户端时可能遇到的问题。

默认情况下,verbose 选项处于关闭状态。您可以通过在运行命令时指定该选项来打开它,如以下示例所示。

snowball -v cp /Logs/April/logs1.csv s3://MyBucket/Logs/April/logs1.csv
snowball --verbose ls s3://MyBucket/Logs/April/