Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

使用 Amazon S3 Adapter 传输文件来进行数据迁移

以下是 Amazon S3 适配器的概述，您可以使用该适配器通过 Amazon S3 REST API 操作以编程方式将数据传输到设备上已有的 S3 存储桶或从 Amazon Snowball Edge 设备上传输数据。此处的 Amazon S3 REST API 支持仅限于一部分操作。您可以将此操作子集与其中一个 Amazon SDK 配合使用，以编程方式传输数据。您还可以对 Amazon S3 使用这一部分受支持的 Amazon Command Line Interface （Amazon CLI）命令来以编程方式传输数据。

如果您的解决方案使用 1.11.0 或更高 Amazon SDK for Java 版本，则必须使用以下版本：S3ClientOptions

有关更多信息，请参阅适用于 Java 的亚马逊 S AppStream DK 中的 S3 类 ClientOptions .Builder。

正在下载并安装 1.16.14 Amazon CLI 版本以与 Amazon S3 适配器配合使用

目前，Snowball Edge 设备仅支持将 Amazon CLI 的版本 1.16.14 及更低版本与 Amazon S3 Adapter 结合使用。较新版本与 Amazon S3 适配器不兼容，因为它们不支持 S3 适配器的所有功能。 Amazon CLI

在 Linux 操作系统 Amazon CLI 上安装

运行以下链式命令：

curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.14.zip" -o "awscli-bundle.zip";unzip awscli-bundle.zip;sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws;/usr/local/bin/aws --version;
           

在 Windows 操作系统 Amazon CLI 上安装

为操作系统下载并运行安装程序文件：

在 Snowball Edge 设备上使用 Amazon CLI 和 API 操作

使用 Amazon CLI 或 API 操作在 Snowball Edge 上发出 IAM、Amazon S3 和 Amazon EC2 命令时，必须将区域指定为 “” snow。 您可以使用命令本身Amazon configure或在命令本身内执行此操作，如以下示例所示。

aws configure --profile abc
Amazon Access Key ID [None]: AKIAIOSFODNN7EXAMPLE
Amazon Secret Access Key [None]: 1234567
Default region name [None]: snow
Default output format [None]: json       

Or

aws s3 ls --profile snowballEdge --endpoint http://192.0.2.0:8080 --region snow         

使用 Amazon Snowball的 Amazon S3 API 接口进行的授权

当您使用 Amazon S3 适配器时，默认情况下，每次交互都使用 Amazon 签名版本 4 算法进行签名。此授权仅用于验证从数据来源传输到接口的数据。所有加密和解密工作都在设备上完成。未加密的数据从不会存储在设备上。

在使用接口时，请记住以下几点：

获取并使用本地 Amazon S3 凭证

与 Snowball Edge 的每一次交互都使用签 Amazon 名版本 4 算法进行签名。有关算法的更多信息，请参阅《Amazon Web Services 一般参考》中的签名版本 4 签名流程。

通过运行和 snowballEdge list-access-keys 和 snowballEdge get-secret-access-key Snowball Edge 客户端信息，您可以获取本地 Amazon S3 凭证，以便签署您对 Snowball Edge 客户端 Edge 设备的请求，请参阅获取凭证。这些本地 Amazon S3 凭证包含一对密钥：一个访问密钥 ID 和一个私有密钥。这些凭证仅可用于与您的作业关联的设备。它们不能在中使用， Amazon Web Services 云 因为它们没有 IAM 对应物。

您可以将这些凭据添加到服务器上的 Amazon Web Services 凭据文件中。默认的凭证配置文件通常位于 ~/.aws/credentials，但该位置可能因平台而异。该文件由许多 Amazon SDK 共享，并由. Amazon CLI您可以使用配置文件名称保存本地凭证，如以下示例所示。

[snowballEdge]
aws_access_key_id = AKIAIOSFODNN7EXAMPLE
aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

将 S3 Adapter 指定为 Amazon CLI 端点

当您使用 Amazon CLI 向 Amazon Snowball Edge 设备发出命令时，您指定终端节点是 Amazon S3 适配器。您可以选择使用 HTTPS 端点，或不安全的 HTTP 端点，如下所示。

HTTPS 安全端点

aws s3 ls --profile snowballEdge --endpoint https://192.0.2.0:8443 --ca-bundle path/to/certificate

HTTP 不安全端点

aws s3 ls --profile snowballEdge --endpoint http://192.0.2.0:8080

如果您使用 HTTPS 端点 8443，则您的数据将从服务器安全地传输到 Snowball Edge。使用 Snowball Edge 在获取新 IP 地址时所生成的证书来确保此加密。在您具有证书后，可以将其保存到本地 ca-bundle.pem 文件。然后，您可以将配置 Amazon CLI 文件配置为包含证书路径，如下所述。

在您完成此过程之后，可以使用这些本地凭证、您的证书和您指定的端点运行 CLI 命令，如以下示例所示。

aws s3 ls --profile snowballEdge --endpoint https://192.0.2.0:8443

Amazon S3 Adapter 不支持的 Amazon S3 特征

使用 Amazon S3 Adapter，您可以以编程方式通过 Amazon S3 API 操作在 Snowball Edge 中传输数据。但是，并非所有 Amazon S3 传输特征和 API 操作支持在使用 Amazon S3 Adapter 时用于 Snowball Edge 设备。例如，以下特征和操作不支持用于 Snowball Edge：