在 Snowball Edge 上使用与亚马逊 S3 兼容存储空间的 S3 存储桶 - AWS Snowball Edge 开发者指南
使用 AWS CLI使用 Java SDK存储桶 ARN 格式存储桶位置格式

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

在 Snowball Edge 上使用与亚马逊 S3 兼容存储空间的 S3 存储桶

借助 Snowball Edge 上的 Amazon S3 兼容存储，您可以在 Snowball Edge 设备上创建 Amazon S3 存储桶，以便在需要本地数据访问、本地数据处理和数据驻留的应用程序存储和检索对象。Snowball Edge 上与 Amazon S3 兼容的存储提供了一种新的存储类别SNOW，它使用 Amazon S3 APIs，旨在在多台 Snowball Edge 设备上以持久和冗余的方式存储数据。您可以在 Snowball Edge 存储桶上使用与在 Amazon S3 上相同的功能，包括存储桶生命周期策略、加密 APIs 和标记。

你可以使用 AWS Command Line Interface (AWS CLI) 在 Snowball Edge 上使用与 Amazon S3 兼容的存储，也可以通过 Java SDK 以编程方式使用。 AWS 使用 AWS CLI，您可以设置 s3api 或 s3control 端点，并通过命令与之交互。我们建议使用 s3api 端点，因为相同的端点可同时用于存储桶和对象操作。

注意

s3api 端点可用于 Snowball Edge 软件的 8004 版及更高版本。要查找设备上安装的 Snowball Edge 软件的版本，请使用 snowballEdge check-for-updates 命令。要更新 Snowball Edge 设备，请参阅更新 Snowball Edge 设备上的软件。

使用 AWS CLI

请按照以下说明使用 AWS CLI在设备上使用 Amazon S3 存储桶。

要设置 AWS CLI

  1. 在 ~/.aws/config 中为对象端点创建配置文件。

    [profile your-profile]
aws_access_key_id = your-access-id
aws_secret_access_key = your-access-key
region = snow
ca_bundle = dev/apps/ca-certs/your-ca_bundle

  2. 从您的设备获取证书。有关更多信息，请参阅《Snowball Edge 开发人员指南》。

  3. 如果您在虚拟环境中安装了开发工具包，请使用以下命令将其激活：

    source your-virtual-environment-name/bin/activate

设置操作后，你可以使用 s3api SDK 或 s3control SDK 通过访问 Snowball Edge 上的 S3 存储桶。 AWS CLI

例 使用 s3api SDK 访问 S3 存储桶

aws s3api list-buckets --endpoint-url https://s3api-endpoint-ip --profile your-profile
例 使用 s3control 软件开发工具包访问 S3 存储桶

aws s3control list-regional-buckets --account-id bucket-owner --endpoint-url https://s3ctrlapi-endpoint-ip --profile your-profile
例 使用 s3api SDK 访问 S3 对象

aws s3api list-objects-v2 --endpoint-url https://s3api-endpoint-ip --profile your-profile

使用 Java SDK

使用以下示例，利用 Java SDK 处理 Amazon S3 存储桶和对象。


import software.amazon.awssdk.services.s3.S3Client;
import software.amazon.awssdk.auth.credentials.AwsBasicCredentials;
import software.amazon.awssdk.auth.credentials.StaticCredentialsProvider;
import software.amazon.awssdk.http.SdkHttpClient;bg
import software.amazon.awssdk.http.apache.ApacheHttpClient;
import software.amazon.awssdk.regions.Region;

import java.net.URI;

AwsBasicCredentials creds = AwsBasicCredentials.create(accessKey, secretKey); // set creds by getting Access Key and Secret Key from snowball edge
SdkHttpClient httpClient = ApacheHttpClient.builder().tlsTrustManagersProvider(trustManagersProvider).build(); // set trust managers provider with client certificate from snowball edge
String s3SnowEndpoint = "10.0.0.0"; // set s3-snow object api endpoint from describe service

S3Client s3Client = S3Client.builder().httpClient(httpClient).region(Region.of("snow")).endpointOverride(new URI(s3SnowEndpoint)).credentialsProvider(StaticCredentialsProvider.create(creds)).build();

存储桶 ARN 格式

您可以使用此处列出的 Amazon 资源名称（ARN）格式来识别 Snowball Edge 设备上的 Amazon S3 存储桶：

arn:partition:s3:snow:account-id:device/device-id/bucket/bucket-name

您订购 partition Snowball Edge 设备所在地区的分区在哪里。 device-id如果设备是独立的 Snowball Edge 设备，则为 job_id；cluster_id如果你有 Snowball Edge 集群，则为 job_id。

存储桶位置格式

存储分区位置格式指定了将在其中创建存储分区的 Snowball Edge 设备。存储桶位置具有以下格式：

/device-id/bucket/bucket-name

有关更多信息，请参阅《 AWS CLI 命令参考》中的 create-buck et。