支持的 Amazon CLI 命令 - Amazon Snowball Edge Developer Guide
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

支持的 Amazon CLI 命令

在下文中,您将了解如何将 Amazon S3 Adapter for Snowball 指定为适用的终端节点。Amazon Command Line Interface(Amazon CLI) 命令。您还可以在以下位置查找Amazon CLI命令 Amazon S3 持将数据传输到Amazon Snowball带有接口的边缘设备。

注意

有关安装和设置Amazon CLI,包括指定要创建的区域Amazon CLI调用,请参阅Amazon Command Line Interface用户指南

目前,Snowball Edge 设备仅支持版本 1.16.14 及更早版本的Amazon CLI。您可以从 GitHub 中下载并安装此版本的 Amazon CLI。请使用以下过程执行此任务。

注意

在安装 Amazon CLI 版本 1.16.14 之前,请务必安装 Python 版本 2.6.5+ 或 3.4+。

支持Amazon CLIAmazon S3 的命令

以下是指定的子集Amazon CLI命令和 Amazon S3 项,Amazon SnowballEdge 设备支持。如果某个命令或选项未列出,则表明它不受支持。您可以声明一些不受支持的选项 (如 --sse--storage-class) 以及一个命令。但是,这些选项会被忽略,并且不会对导入数据的方式产生任何影响。

  • CP CP— 将文件或对象复制到或从复制文件或对象Amazon SnowballEdge 设备。以下是此命令的选项:

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

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

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

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

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

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

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

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

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

  • LS— 列出上的对象Amazon SnowballEdge 设备。以下是此命令的选项:

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

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

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

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

  • rm— 删除上的对象Amazon SnowballEdge 设备。以下是此命令的选项:

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

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

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

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

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

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

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

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

    重要

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

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

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

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

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

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

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

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

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

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

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

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

      重要

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

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

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

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

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

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

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