Utilisation de compartiments S3 avec stockage compatible Amazon S3 sur les appareils de la gamme Snow - AWS Snowball Edge Guide du développeur
À l'aide du AWS CLIUtiliser le Java SDKARNFormat du compartimentFormat de localisation du compartiment

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utilisation de compartiments S3 avec stockage compatible Amazon S3 sur les appareils de la gamme Snow

Grâce au stockage compatible Amazon S3 sur les appareils de la famille Snow, vous pouvez créer des compartiments Amazon S3 sur vos appareils Snowball Edge afin de stocker et de récupérer des objets sur site pour les applications qui nécessitent un accès aux données locales, un traitement local des données et une résidence des données. Le stockage compatible Amazon S3 sur les appareils de la famille Snow fournit une nouvelle classe de stockageSNOW, qui utilise Amazon S3APIs, et est conçue pour stocker les données de manière durable et redondante sur plusieurs appareils Snowball Edge. Vous pouvez utiliser les mêmes fonctionnalités sur APIs les compartiments Snowball Edge que sur Amazon S3, notamment les politiques relatives au cycle de vie des compartiments, le chiffrement et le balisage.

Vous pouvez utiliser le stockage compatible Amazon S3 sur les appareils de la famille Snow à l'aide du AWS Command Line Interface (AWS CLI) ou par programmation via AWS JavaSDK. Avec le AWS CLI, vous pouvez configurer un point de terminaison s3api ou s3control et interagir avec celui-ci par le biais de commandes. Nous recommandons d'utiliser le point de terminaison s3api, car le même point de terminaison peut être utilisé pour les opérations relatives aux compartiments et aux objets.

Note

Le point de terminaison s3api est disponible pour les versions 8004 et ultérieures du logiciel Snowball Edge. Pour rechercher la version du logiciel Snowball Edge installée sur un appareil, utilisez la snowballEdge check-for-updates commande. Pour mettre à jour un appareil Snowball Edge, voir Mise à jour du logiciel sur les appareils Snowball Edge.

À l'aide du AWS CLI

Suivez ces instructions pour utiliser les compartiments Amazon S3 sur votre appareil à l'aide du AWS CLI.

Pour configurer le AWS CLI

  1. Créez un profil pour les points de terminaison d'objets dans. ~/.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. Obtenez un certificat depuis votre appareil. Pour plus d'informations, consultez le guide du développeur de Snowball Edge.

  3. Si vous l'avez installé SDK dans un environnement virtuel, activez-le à l'aide de la commande suivante :

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

Après avoir configuré vos opérations, vous pouvez utiliser le s3api SDK ou le s3control SDK pour accéder aux compartiments S3 sur les appareils de la famille Snow avec le. AWS CLI

Exemple d'accéder au compartiment S3 à l'aide de la s3api SDK

aws s3api --profile your-profile list-buckets --endpoint-url https://s3api-endpoint-ip
Exemple d'accès aux compartiments S3 à l'aide du s3control SDK

aws s3control --profile your-profile list-regional-buckets --account-id bucket-owner --endpoint-url https://s3ctrlapi-endpoint-ip
Exemple d'accéder aux objets S3 à l'aide de la s3api SDK

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

Utiliser le Java SDK

Utilisez l'exemple suivant pour travailler avec des buckets et des objets Amazon S3 à l'aide de JavaSDK.


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

ARNFormat du compartiment

Vous pouvez utiliser le format Amazon Resource Name (ARN) indiqué ici pour identifier un compartiment Amazon S3 sur un appareil Snowball Edge :

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

Où partition est la partition de la région où vous avez commandé votre appareil Snowball Edge. device-id est le job_id s'il s'agit d'un appareil Snowball Edge autonome, ou le cluster_id si vous possédez un cluster Snowball Edge.

Format de localisation du compartiment

Le format de localisation du bucket indique le périphérique Snowball Edge sur lequel le bucket sera créé. L'emplacement du compartiment est au format suivant :

/device-id/bucket/bucket-name

Pour plus d'informations, consultez create-bucket dans la référence des AWS CLI commandes.