View a markdown version of this page

Cómo trabajar con cubos S3 con almacenamiento compatible con Amazon S3 en Snowball Edge - AWS Snowball Edge Guía para desarrolladores
Uso de AWS CLIUso del SDK para JavaFormato de ARN de bucketFormato de ubicación del bucket

AWS Snowball Edge ya no está disponible para nuevos clientes. Los nuevos clientes deberían AWS DataSync buscar transferencias en línea, un terminal de transferencia de AWS datos para transferencias físicas seguras o soluciones de AWS socios. Para la computación periférica, explore AWS Outposts.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Cómo trabajar con cubos S3 con almacenamiento compatible con Amazon S3 en Snowball Edge

Con el almacenamiento compatible con Amazon S3 en Snowball Edge, puede crear cubos de Amazon S3 en sus dispositivos Snowball Edge para almacenar y recuperar objetos in situ para aplicaciones que requieren acceso a los datos locales, procesamiento local de datos y residencia de los datos. El almacenamiento compatible con Amazon S3 en Snowball Edge ofrece una nueva clase de almacenamiento que utiliza las API de Amazon S3 y está diseñada para almacenar datos de forma duradera y redundante en varios dispositivos de Snowball Edge. SNOW Puede usar las mismas API y características en los buckets de Snowball Edge que en Amazon S3, como políticas de ciclo de vida, cifrado y etiquetado.

Puede utilizar el almacenamiento compatible con Amazon S3 en Snowball Edge mediante el AWS Command Line Interface (AWS CLI) o de forma programática mediante el SDK de Java. AWS Con él AWS CLI, puede configurar un punto final de s3api o s3control e interactuar con él mediante comandos. Recomendamos usar el punto de conexión de s3api porque se puede utilizar el mismo punto de conexión para las operaciones de bucket y de objetos.

nota

El punto de conexión de s3api está disponible para la versión 8004 y posteriores del software Snowball Edge. Para buscar la versión del software de Snowball Edge instalada en un dispositivo, utilice el comando snowballEdge check-for-updates. Para actualizar un dispositivo Snowball Edge, consulte Actualización del software en dispositivos Snowball Edge.

Uso de AWS CLI

Siga estas instrucciones para trabajar con buckets de Amazon S3 en su dispositivo mediante la AWS CLI.

Para configurar el AWS CLI

  1. Cree un perfil para los puntos de conexión de objetos en ~/.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. Obtenga un certificado de su dispositivo. Para más información, consulte la Guía para desarrolladores de Snowball Edge.

  3. Si instaló el SDK en un entorno virtual, actívelo con el siguiente comando:

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

Tras configurar las operaciones, puede usar el SDK de s3api o el SDK de s3control para acceder a los buckets de S3 en Snowball Edge con el. AWS CLI

ejemplo de acceso al bucket de S3 mediante el SDK de s3api

aws s3api list-buckets --endpoint-url https://s3api-endpoint-ip --profile your-profile
ejemplo de acceder a los buckets de S3 mediante el SDK de s3control

aws s3control list-regional-buckets --account-id bucket-owner --endpoint-url https://s3ctrlapi-endpoint-ip --profile your-profile
ejemplo de acceso a los objetos de S3 mediante el SDK de s3api

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

Uso del SDK para Java

Utilice el siguiente ejemplo para trabajar con buckets y objetos de Amazon S3 mediante el SDK para 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 de ARN de bucket

Puede utilizar el formato de nombre de recurso de Amazon (ARN) que se muestra aquí para identificar un bucket de Amazon S3 en un dispositivo Snowball Edge:

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

¿Dónde partition está la partición de la región en la que ha pedido el dispositivo Snowball Edge? device-ides el job_id si el dispositivo es un dispositivo de Snowball Edge independiente o cluster_id si tiene un clúster de Snowball Edge.

Formato de ubicación del bucket

El formato de ubicación del bucket especifica el dispositivo Snowball Edge en el que se creará el bucket. Esta ubicación de bucket tiene el siguiente formato:

/device-id/bucket/bucket-name

Para obtener más información, consulte create-bucket en la AWS CLI referencia de comandos.