Amazon Snowball Edge不再向新客户提供。新客户应探索[Amazon DataSync](https://www.amazonaws.cn/datasync/)在线传输、用于安全物理[传输Amazon的数据传输终端](https://www.amazonaws.cn/data-transfer-terminal/)或Amazon合作伙伴解决方案。对于边缘计算，请浏览 [Amazon Out](https://www.amazonaws.cn/outposts/) posts。

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

# 支持Amazon CLI用于向 Snowball Edge 传输数据或从中传输数据的命令
<a name="using-adapter-cli"></a>

接下来，您可以找到有关如何在 Snowball Edge 上将 Amazon S3 适配器或 Amazon S3 兼容存储指定为适用Amazon Command Line Interface(Amazon CLI) 命令的终端节点的信息。您还可以在 Snowball Edge 上找到支持将数据传输到带有适配器的Amazon Snowball Edge设备或 Amazon S3 兼容存储设备的亚马逊 S3 Amazon CLI命令列表。

**注意**  
有关安装和设置的信息Amazon CLI，包括指定要针对哪些区域进行Amazon CLI呼叫，请参阅[《Amazon Command Line Interface用户指南》](https://docs.amazonaws.cn/cli/latest/userguide/)。

目前，Snowball Edge 设备仅支持在使用 Amazon S3 Adapter 时使用Amazon CLI的版本 1.16.14 及更低版本。请参阅 [查找 Snowball Edge 客户端版本](using-adapter.md#aws-cli-version)。如果您在 Snowball Edge 上使用与 Amazon S3 兼容的存储，则可以使用最新版本的。Amazon CLI要下载和使用最新版本，请参阅 [Amazon Command Line Interface用户指南](https://docs.amazonaws.cn/cli/latest/userguide/cli-chap-welcome.html)。

**注意**  
在安装Amazon CLI版本 1.16.14 之前，请务必安装 Python 版本 2.6.5\+ 或 3.4\+。

## 支持Amazon CLI使用 Amazon S3 和 Snowball Edge 进行数据传输的命令
<a name="using-adapter-cli-commands"></a>

以下是该Amazon Snowball Edge设备支持的 Amazon S3 Amazon CLI命令和选项子集的描述。如果某个命令或选项未列出，则表明它不受支持。您可以声明一些不受支持的选项（如 `--sse` 或 `--storage-class`）以及一个命令。但是，这些选项会被忽略，并且不会对导入数据的方式产生任何影响。
+ [cp](https://docs.amazonaws.cn/cli/latest/reference/s3/cp.html) — 将文件或对象复制到设备或从Amazon Snowball Edge设备复制出来。以下是此命令的选项：
  + `--dryrun`（布尔值）：仅显示使用指定命令要执行的操作，但不运行。
  + `--quiet`（布尔值）：不显示使用指定命令执行的操作。
  + `--include`（字符串）：不从命令中排除与指定模式匹配的文件或对象。有关详细信息，请参阅《Amazon CLI命令参考》**中的[使用 Exclude 和 Include 筛选条件](https://docs.amazonaws.cn/cli/latest/reference/s3/index.html#use-of-exclude-and-include-filters)。
  + `--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](https://docs.amazonaws.cn/cli/latest/reference/s3/ls.html) — 列出Amazon Snowball Edge设备上的对象。以下是此命令的选项：
  + `--human-readable`（布尔值）：以人类可读的格式显示文件大小。
  + `--summarize`（布尔值）：将显示摘要信息。此信息为对象的数量及其总大小。
  + `--recursive`（布尔值）：针对指定目录或前缀下的所有文件或对象执行命令。
  + `--page-size`（整数）：要在一个列表操作的每个响应中返回的结果数。默认值为 1000（允许的最大值）。如果操作超时，则使用较低的值可能会很有用。
+ [rm](https://docs.amazonaws.cn/cli/latest/reference/s3/rm.html) — 删除Amazon Snowball Edge设备上的对象。以下是此命令的选项：
  + `--dryrun`（布尔值）：仅显示使用指定命令要执行的操作，但不运行。
  + `--include`（字符串）：不从命令中排除与指定模式匹配的文件或对象。有关详细信息，请参阅《Amazon CLI命令参考》**中的[使用 Exclude 和 Include 筛选条件](https://docs.amazonaws.cn/cli/latest/reference/s3/index.html#use-of-exclude-and-include-filters)。
  + `--exclude`（字符串）：从命令中排除与指定模式匹配的所有文件或对象。
  + `--recursive`（布尔值）：针对指定目录或前缀下的所有文件或对象执行命令。
  + `--page-size`（整数）：要在一个列表操作的每个响应中返回的结果数。默认值为 1000（允许的最大值）。如果操作超时，则使用较低的值可能会很有用。
  + `--only-show-errors`（布尔值）：仅显示错误和警告。禁止其他所有输出。
  + `--quiet`（布尔值）：不显示使用指定命令执行的操作。
+ [sync](https://docs.amazonaws.cn/cli/latest/reference/s3/sync.html)：同步目录和前缀。此命令将源目录中的新文件和更新过的文件复制到目的地。此命令仅在目的地创建目录（如果文件夹包含一个或多个文件）。
**重要**  
不支持在同一个 Snowball Edge 上从一个目录同步到另一个目录。  
不支持从一Amazon Snowball Edge台设备同步到另一Amazon Snowball Edge台设备。  
您只能使用此选项在本地数据存储和 Snowball Edge 之间同步内容。
  + `--dryrun`（布尔值）：仅显示使用指定命令要执行的操作，但不运行。
  + `--quiet`（布尔值）：不显示使用指定命令执行的操作。
  + `--include`（字符串）：不从命令中排除与指定模式匹配的文件或对象。有关详细信息，请参阅《Amazon CLI命令参考》**中的[使用 Exclude 和 Include 筛选条件](https://docs.amazonaws.cn/cli/latest/reference/s3/index.html#use-of-exclude-and-include-filters)。
  + `--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 Edge台设备同步到另一Amazon Snowball Edge台设备。  
您只能使用此选项在本地数据存储和 Snowball Edge 之间同步内容。
  + `--size-only`（布尔值）：利用此选项，每个密钥的大小是用来决定是否从源同步到目标的唯一标准。
  + `--exact-timestamps`（布尔值）：在从 S3 同步到本地存储时，仅在时间戳完全匹配时忽略大小相同的项。除非本地版本比 Amazon S3 版本更新，否则，默认行为是忽略大小相同的项。
  + `--delete`（布尔值）：在同步期间，将删除目标中存在而源中不存在的文件。

您可以使用名称中有空格的文件或文件夹，如 `my photo.jpg` 或 `My Documents`。但是，请确保正确处理Amazon CLI命令中的空格。有关更多信息，请参阅《Amazon Command Line Interface用户指南》**中的[指定Amazon CLI 的参数值](https://docs.amazonaws.cn/cli/latest/userguide/cli-using-param.html)。