支持的 Amazon CLI 命令 - Amazon Snowball Edge 开发人员指南
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

支持的 Amazon CLI 命令

接下来,您将了解有关如何将 Amazon S3 接口指定为适用Amazon Command Line Interface (Amazon CLI) 命令的终端节点的信息。您还可以找到支持通过接口将数据传输到Amazon Snowball Edge设备的 Amazon S3Amazon CLI 命令列表。

注意

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

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

注意

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

Amazon S3 支持的Amazon CLI命令

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

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

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

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

    • --include(string) — 不要在命令中排除与指定模式匹配的文件或对象。有关详细信息,请参阅Amazon CLI命令参考》中使用排除和包含筛选器

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

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

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

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

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

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

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

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

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

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

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

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

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

    • --include(string) — 不要在命令中排除与指定模式匹配的文件或对象。有关详细信息,请参阅Amazon CLI命令参考》中使用排除和包含筛选器

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

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

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

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

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

  • syn@@ c — 同步目录和前缀。此命令将源目录中的新文件和更新过的文件复制到目的地。只有当目录包含一个或多个文件时,此命令才会在目标中创建目录。

    重要

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

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

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

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

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

    • --include(string) — 不要在命令中排除与指定模式匹配的文件或对象。有关详细信息,请参阅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 位置之间复制时,REPLACE除非另有说明,否则metadata-directive参数默认为。

      重要

      不支持在同一 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用户指南中的为Amazon CLI 指定参数值