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 avec 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 une résidence des données. Le stockage compatible avec Amazon S3 sur Snowball Edge fournit une nouvelle classe de stockage`SNOW`, qui utilise Amazon S3 APIs, 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 Snowball Edge à l'aide du AWS Command Line Interface (AWS CLI) ou par programmation via le AWS SDK Java. 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](https://docs.aws.amazon.com/snowball/latest/developer-guide/updating-device.html) 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
```
1. Obtenez un certificat depuis votre appareil. Pour plus d'informations, consultez le guide du *[développeur de Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/using-client-commands.html#snowball-edge-certificates-cli)*.
1. 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
**Example d'accéder au compartiment S3 à l'aide du SDK s3api**
```
aws s3api list-buckets --endpoint-url https://s3api-endpoint-ip --profile your-profile
```
**Example d'accéder 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
```
**Example 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 travailler avec des buckets 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-id*est le job\$1id s'il s'agit d'un appareil Snowball Edge autonome ou s'il s'agit d'un *cluster\$1id* 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 bucket est au format suivant :
```
/device-id/bucket/bucket-name
```
Pour plus d'informations, consultez [create-bucket](https://awscli.amazonaws.com/v2/documentation/api/2.0.34/reference/s3api/create-bucket.html) dans la référence des AWS CLI commandes.