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

本指南适用于 Snowball Edge。如果您正在查找 Snowball 的相关文档,请参阅 AWS Snowball 用户指南

支持的 AWS CLI 命令

在下文中,您将了解有关如何为适用的 AWS Command Line Interface (AWS CLI) 命令指定 适用于 Snowball 的 Amazon S3 Adapter 作为终端节点的信息。您还可以找到使用适配器将数据传输到 AWS Snowball Edge 设备时可使用的 Amazon S3 AWS CLI 命令的列表。

注意

有关安装和设置 AWS CLI 的信息(包括指定要为其执行 AWS CLI 调用的区域),请参阅 AWS Command Line Interface 用户指南

支持的 Amazon S3 AWS CLI 命令

接下来,您可以找到 AWS Snowball Edge 设备支持的一部分 Amazon S3 AWS CLI 命令和选项的描述。如果某个命令或选项未在下方列出,则表明它不受支持。您可以声明一些不受支持的选项 (如 --sse--storage-class) 以及一个命令。但是,这些选项会被忽略,并且不会对导入数据的方式产生任何影响。

  • cp 将文件或对象复制到 AWS Snowball Edge 设备,或从 AWS Snowball Edge 设备复制文件或对象。以下是此命令的选项:

    • --dryrun (布尔值) 仅显示使用指定命令要执行的操作,但不运行。

    • --quiet (布尔值) 不显示使用指定命令执行的操作。

    • --include (字符串) 不从命令中排除与指定模式匹配的文件或对象。有关详细信息,请参阅 AWS CLI Command Reference 中的使用 Exclude 和 Include 筛选条件

    • --exclude (字符串) 从命令中排除与指定模式匹配的所有文件或对象。

    • --follow-symlinks | --no-follow-symlinks(布尔值)仅当从本地文件系统将数据上传到 S3 时,才会访问符号链接。Amazon S3 不支持符号链接,因此应以链接的名称上传链接目标的内容。如果未指定任何选项,则默认访问符号链接。

    • --only-show-errors (布尔值) 仅显示错误和警告。禁止其他所有输出。

    • --recursive (布尔值) 针对指定目录或前缀下的所有文件或对象执行命令。

    • --page-size (整数) 要在一个列表操作的每个响应中返回的结果数。默认值为 1000 (允许的最大值)。如果操作超时,则使用较低的值可能会很有用。

    • --metadata(映射)要存储的元数据与 Amazon S3 中对象之间的映射。此映射将应用于作为此请求的一部分的每个对象。在同步中,此功能意味着未更改的文件将无法接收新的元数据。在两个 Amazon S3 位置之间复制时,除非另行指定,否则 metadata-directive 参数默认为 REPLACE

  • ls 列出 AWS Snowball Edge 设备上的对象。以下是此命令的选项:

    • --human-readable (布尔值) 以人类可读的格式显示文件大小。

    • --summarize (布尔值) 将显示摘要信息。此信息为对象的数量及其总大小。

    • --recursive (布尔值) 针对指定目录或前缀下的所有文件或对象执行命令。

    • --page-size (整数) 要在一个列表操作的每个响应中返回的结果数。默认值为 1000 (允许的最大值)。如果操作超时,则使用较低的值可能会很有用。

  • rm 删除 AWS Snowball Edge 设备上的对象。以下是此命令的选项:

    • --dryrun (布尔值) 仅显示使用指定命令要执行的操作,但不运行。

    • --include (字符串) 不从命令中排除与指定模式匹配的文件或对象。有关详细信息,请参阅 AWS CLI Command Reference 中的使用 Exclude 和 Include 筛选条件

    • --exclude (字符串) 从命令中排除与指定模式匹配的所有文件或对象。

    • --recursive (布尔值) 针对指定目录或前缀下的所有文件或对象执行命令。

    • --page-size (整数) 要在一个列表操作的每个响应中返回的结果数。默认值为 1000 (允许的最大值)。如果操作超时,则使用较低的值可能会很有用。

    • --only-show-errors (布尔值) 仅显示错误和警告。禁止其他所有输出。

    • --quiet (布尔值) 不显示使用指定命令执行的操作。

  • sync 同步目录和前缀。此命令将源目录中的新文件和更新过的文件复制到目的地。此命令仅在目的地创建文件夹 (如果文件夹包含一个或多个文件)。

    重要

    不支持在同一个 Snowball Edge 上从一个目录同步到另一个目录。

    不支持从一台 AWS Snowball 设备同步到另一台 AWS Snowball 设备。

    您只能使用此选项在本地数据存储和 Snowball Edge 之间同步内容。

    • --dryrun (布尔值) 仅显示使用指定命令要执行的操作,但不运行。

    • --quiet (布尔值) 不显示使用指定命令执行的操作。

    • --include (字符串) 不从命令中排除与指定模式匹配的文件或对象。有关详细信息,请参阅 AWS CLI Command Reference 中的使用 Exclude 和 Include 筛选条件

    • --exclude (字符串) 从命令中排除与指定模式匹配的所有文件或对象。

    • --follow-symlinks--no-follow-symlinks (布尔值) 仅当从本地文件系统上传到 S3 时,才会访问符号链接。S3 不支持符号链接,因此应以链接的名称上传链接目标的内容。如果未指定任何选项,则默认访问符号链接。

    • --only-show-errors (布尔值) 仅显示错误和警告。禁止其他所有输出。

    • --no-progress (布尔值) 不显示文件传输进度。此选项仅在未提供 --quiet--only-show-errors 选项时应用。

    • --page-size (整数) 要在一个列表操作的每个响应中返回的结果数。默认值为 1000 (允许的最大值)。如果操作超时,则使用较低的值可能会很有用。

    • --metadata(映射)要存储的元数据与 Amazon S3 中对象之间的映射。此映射将应用于作为此请求的一部分的每个对象。在同步中,此功能意味着未更改的文件将无法接收新的元数据。在两个 Amazon S3 位置之间复制时,除非另行指定,否则 metadata-directive 参数默认为 REPLACE

      重要

      不支持在同一个 Snowball Edge 上从一个目录同步到另一个目录。

      不支持从一台 AWS Snowball 设备同步到另一台 AWS Snowball 设备。

      您只能使用此选项在本地数据存储和 Snowball Edge 之间同步内容。

    • --size-only (布尔值) 利用此选项,每个密钥的大小是用来决定是否从源同步到目标的唯一标准。

    • --exact-timestamps (布尔值) 在从 S3 同步到本地存储时,仅在时间戳完全匹配时忽略大小相同的项。除非本地版本比 S3 版本更新,否则,默认行为是忽略大小相同的项。

    • --delete (布尔值) 在同步期间,将删除目标中存在而源中不存在的文件。

您可以使用名称中有空格的文件或文件夹,如 my photo.jpgMy Documents。但是,请确保您在 AWS CLI 命令中正确处理了空格。有关更多信息,请参阅 AWS Command Line Interface 用户指南 中的为 AWS 命令行界面指定参数值