View a markdown version of this page

Trabalhando com buckets S3 com armazenamento compatível com Amazon S3 no Snowball Edge - AWS Snowball Edge Guia do Desenvolvedor
Usar o AWS CLIUso do Java SDKFormato do ARN do bucketFormato do local do bucket

AWS Snowball Edge não está mais disponível para novos clientes. Novos clientes devem explorar AWS DataSynctransferências on-line, o Terminal de Transferência de AWS Dados para transferências físicas seguras ou soluções de AWS parceiros. Para computação de ponta, explore AWS Outposts.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Trabalhando com buckets S3 com armazenamento compatível com Amazon S3 no Snowball Edge

Com o armazenamento compatível com o Amazon S3 no Snowball Edge, você pode criar buckets do Amazon S3 em seus dispositivos Snowball Edge para armazenar e recuperar objetos no local para aplicativos que exigem acesso e processamento de dados locais e residência de dados. O armazenamento compatível com o Amazon S3 no Snowball Edge fornece uma nova classe de armazenamentoSNOW, que usa as APIs do Amazon S3 e foi projetada para armazenar dados de forma durável e redundante em vários dispositivos do Snowball Edge. É possível usar os mesmos atributos e APIs nos buckets do Snowball Edge da mesma maneira que em buckets do Amazon S3, incluindo políticas de acesso ciclo de vida do bucket, criptografia e marcação.

Você pode usar o armazenamento compatível com o Amazon S3 no Snowball Edge usando o AWS Command Line Interface(AWS CLI) ou programaticamente por meio do Java SDK.AWS Com o AWS CLI, você pode configurar um endpoint s3api ou s3control e interagir com ele por meio de comandos. Recomendamos usar o endpoint s3api porque o mesmo endpoint pode ser usado para operações de bucket e de objeto.

nota

O endpoint s3api está disponível para a versão 8004 e mais recente do software Snowball Edge. Para encontrar a versão do software Snowball Edge instalada em um dispositivo, use o comando snowballEdge check-for-updates. Para atualizar um dispositivo Snowball Edge, consulte Atualização de software em dispositivos Snowball Edge.

Usar o AWS CLI

Siga estas instruções para trabalhar com buckets do Amazon S3 no seu dispositivo usando o AWS CLI.

Para configurar o AWS CLI

  1. Crie um perfil para endpoints de objetos em ~/.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. Obtenha um certificado do seu dispositivo. Para obter informações, consulte o Guia do desenvolvedor do Snowball Edge.

  3. Se você tiver instalado o SDK em um ambiente virtual, ative-o usando o seguinte comando:

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

Depois de configurar suas operações, você pode usar o SDK s3api ou o SDK s3control para acessar buckets do S3 no Snowball Edge com o.AWS CLI

exemplo de acesso ao bucket do S3 usando o SDK s3api

aws s3api list-buckets --endpoint-url https://s3api-endpoint-ip --profile your-profile
exemplo de acessar buckets S3 usando o SDK s3control

aws s3control list-regional-buckets --account-id bucket-owner --endpoint-url https://s3ctrlapi-endpoint-ip --profile your-profile
exemplo de acesso aos objetos do S3 usando o SDK s3api

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

Uso do Java SDK

Use o exemplo a seguir para trabalhar com buckets do Amazon S3 usando o SDK em Java.


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();

Formato do ARN do bucket

Você pode usar o formato do nome do recurso da Amazon (ARN) listado aqui para identificar um bucket do Amazon S3 em um dispositivo Snowball Edge:

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

Onde partition está a partição da região em que você solicitou seu dispositivo Snowball Edge. device-idé o job_id se o dispositivo for um dispositivo autônomo do Snowball Edge ou se você tiver um cluster cluster_id do Snowball Edge.

Formato do local do bucket

O formato de localização do bucket especifica o dispositivo Snowball Edge em que o bucket será criado. O local do bucket tem o seguinte formato:

/device-id/bucket/bucket-name

Para obter mais informações, consulte create-bucket na Referência de comandos.AWS CLI