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

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

支持的 Amazon CLI 命令

接下来,您可以找到有关如何将 Snow 系列设备上的 Amazon S3 Adapter 或与 Amazon S3 兼容的存储指定为适用 Amazon Command Line Interface (Amazon CLI) 命令的端点的信息。您还可以找到 Amazon S3 的 Amazon CLI 命令列表,这些命令支持使用 Snow 系列设备上的适配器或与 Amazon S3 兼容的存储将数据传输到 Amazon Snowball Edge 设备。

注意

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

目前,Snowball Edge 设备仅支持在使用 Amazon S3 Adapter 时使用 Amazon CLI 的版本 1.16.14 及更低版本。请参阅 Snowball Edge 客户端版本。如果您在 Snow 系列设备上使用与 Amazon S3 兼容的存储,则可以使用最新版本的 Amazon CLI。要下载和使用最新版本,请参阅 Amazon Command Line Interface 用户指南

注意

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

Amazon S3 支持的 Amazon CLI 命令

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

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

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

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

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

    • --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 Snowball Edge 设备上的对象。以下是此命令的选项:

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

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

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

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

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

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

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

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

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

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

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

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

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

    重要

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

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

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

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

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

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

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

    • --follow-symlinks--no-follow-symlinks (布尔值) – 仅当从本地文件系统上传到 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 (布尔值) – 在从 S3 同步到本地存储时,仅在时间戳完全匹配时忽略大小相同的项。除非本地版本比 Amazon S3 版本更新,否则,默认行为是忽略大小相同的项。

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

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