View a markdown version of this page

Utilisation de compartiments S3 avec un stockage compatible Amazon S3 sur Snowball Edge - AWS Snowball Edge Guide du développeur
Utilisation de AWS CLIUtilisation du SDK JavaFormat ARN du bucketFormat de localisation des compartiments

AWS Snowball Edge n'est plus disponible pour les nouveaux clients. Les nouveaux clients devraient opter AWS DataSync pour les transferts en ligne, le terminal de transfert de AWS données pour des transferts physiques sécurisés ou les solutions AWS partenaires. Pour l'informatique de pointe, explorez AWS Outposts.

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 un stockage compatible Amazon S3 sur Snowball Edge

Grâce au stockage compatible Amazon S3 sur Snowball Edge, 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 nécessitant un accès aux données locales, un traitement des données local et la résidence des données. Le stockage compatible Amazon S3 sur Snowball Edge fournit une nouvelle classe de stockageSNOW, qui utilise les API Amazon S3, 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 API et fonctionnalités sur les compartiments Snowball Edge que sur Amazon S3, notamment les politiques de cycle de vie des compartiments, le chiffrement et le balisage.

Vous pouvez utiliser le stockage compatible Amazon S3 sur Snowball Edge à l'aide du AWS Command Line Interface (AWS CLI) ou par programmation via le SDK AWS Java. Avec le AWS CLI, vous pouvez configurer un point de terminaison s3api ou s3control et interagir avec lui via des commandes. Nous vous recommandons d'utiliser le point de terminaison s3api car le même point de terminaison peut être utilisé pour les opérations sur les compartiments et les objets.

Note

Le point de terminaison s3api est disponible pour la version 8004 et les versions ultérieures du logiciel Snowball Edge. Pour trouver 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, consultez la section Mise à jour du logiciel sur les appareils Snowball Edge.

Utilisation de 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 extrémités des 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 avez installé le 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 SDK s3api ou le SDK s3control pour accéder aux compartiments S3 sur Snowball Edge avec le. AWS CLI

Exemple d'accès au compartiment S3 à l'aide du SDK s3api

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

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

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

Utilisation du SDK Java

Utilisez l'exemple suivant pour utiliser des compartiments et des objets Amazon S3 à l'aide du SDK 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();

Format ARN du bucket

Vous pouvez utiliser le format Amazon Resource Name (ARN) répertorié 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ù se partition trouve la partition de la région où vous avez commandé votre appareil Snowball Edge. device-idest le job_id s'il s'agit d'un appareil Snowball Edge autonome, ou le job_id cluster_id s'il s'agit d'un cluster Snowball Edge.

Format de localisation des compartiments

Le format d'emplacement du compartiment spécifie l'appareil Snowball Edge sur lequel le compartiment 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.