En utilisant le AWS CLI Utilisation du SDK Java Format ARN du bucket Création d'un compartiment S3 sur un appareil Snowball Edge Création et gestion d'une configuration du cycle de vie d'un objet à l'aide du AWS CLI Utilisation de compartiments S3 sur un appareil Snowball Edge

Utilisation de compartiments S3 sur un appareil 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 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 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 relatives au cycle de vie des compartiments, le chiffrement et le balisage.

En utilisant le AWS CLI

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

Pour configurer le AWS CLI

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

Obtenez un certificat depuis votre appareil. Pour plus d'informations, consultez le guide du développeur de Snowball Edge.
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 y accéder à l'aide d'appels d'API avec le AWS CLI. Dans les exemples suivants, cert il s'agit du certificat d'appareil que vous venez d'obtenir à l'aide d'IAM.

Accès aux opérations sur les objets

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

Accès aux opérations du bucket

aws s3control --profile your-profile list-regional-buckets --account-id bucket-owner --endpoint-url https://s3ctrlapi-endpoint-ip

Utilisation du SDK Java

Utilisez l'exemple suivant pour travailler avec 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;
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ù 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 s'il s'agit d'un cluster Snowball Edge.

Création d'un compartiment S3 sur un appareil Snowball Edge

Vous pouvez créer des compartiments Amazon S3 sur votre appareil Snowball Edge afin de stocker et de récupérer des objets en périphérie 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 S3 et est conçue pour stocker les données de manière durable et redondante sur plusieurs appareils. Vous pouvez utiliser les mêmes API et fonctionnalités que sur les compartiments Amazon S3, notamment les politiques de cycle de vie des compartiments, le chiffrement et le balisage.

L'exemple suivant crée un compartiment Amazon S3 pour un appareil Snowball Edge à l'aide du. AWS CLI Pour exécuter cette commande, remplacez les espaces réservés saisis par l'utilisateur par vos propres informations.


aws s3control --profile your-profile create-bucket --bucket your-snow-bucket --endpoint-url https://s3ctrlapi-endpoint-ip

Création et gestion d'une configuration du cycle de vie d'un objet à l'aide du AWS CLI

Vous pouvez utiliser Amazon S3 Lifecycle pour optimiser la capacité de stockage compatible avec Amazon S3 sur les appareils de la gamme Snow. Vous pouvez créer des règles de cycle de vie pour faire expirer les objets quand ils vieillissent ou sont remplacés par des versions plus récentes. Vous pouvez créer, activer, désactiver ou supprimer une règle de cycle de vie. Pour plus d'informations sur Amazon S3 Lifecycle, consultez Gérer le cycle de vie de votre stockage.

Note

La personne Compte AWS qui crée le bucket en est propriétaire et est la seule à pouvoir créer, activer, désactiver ou supprimer une règle de cycle de vie.

Pour créer et gérer une configuration de cycle de vie pour un compartiment de stockage compatible avec Amazon S3 sur les appareils de la famille Snow à l'aide du AWS Command Line Interface (AWS CLI), consultez les exemples suivants.

PLACER une configuration de cycle de vie dans un bucket Snowball Edge

L' AWS CLI exemple suivant place une politique de configuration du cycle de vie sur un bucket Snowball Edge. Cette politique précise que tous les objets dotés du préfixe (myprefix) et des balises marqués expirent au bout de 10 jours. Pour utiliser cet exemple, remplacez chaque espace réservé saisi par l'utilisateur par vos propres informations.

Enregistrez d'abord la politique de configuration du cycle de vie dans un fichier JSON. Dans cet exemple, le fichier est nommélifecycle-example.json.


{
    "Rules": [{
        "ID": "id-1",
        "Filter": {
            "And": {
                "Prefix": "myprefix",
                "Tags": [{
                        "Value": "mytagvalue1",
                        "Key": "mytagkey1"
                    },
                    {
                        "Value": "mytagvalue2",
                        "Key": "mytagkey2"
                    }
                ],
            }
        },
        "Status": "Enabled",
        "Expiration": {
            "Days": 10
        }
    }]
}

Après avoir enregistré le fichier, soumettez le fichier JSON dans le cadre de la put-bucket-lifecycle-configuration commande. Pour utiliser cette commande, remplacez chaque espace réservé saisi par l'utilisateur par vos propres informations.


aws s3control put-bucket-lifecycle-configuration --bucket 
                example-snow-bucket --profile your-profile 
                --lifecycle-configuration file://lifecycle-example.json --endpoint-url https://s3ctrlapi-endpoint-ip

Pour plus d'informations sur cette commande, consultez put-bucket-lifecycle-configurationla référence des AWS CLI commandes.

Utilisation de compartiments S3 sur un appareil Snowball Edge

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 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 Amazon S3 sur les appareils de la famille Snow 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 relatives au cycle de vie des compartiments, le chiffrement et le balisage. Vous pouvez utiliser le stockage compatible Amazon S3 sur les appareils Snow Family à l'aide du AWS Command Line Interface (AWS CLI) ou AWS des SDK.

Déterminez si vous pouvez accéder à un espace de stockage compatible Amazon S3 sur un bucket d'appareils Snow Family

L'exemple suivant utilise la head-bucket commande pour déterminer si un compartiment Amazon S3 existe et si vous êtes autorisé à y accéder à l'aide du AWS CLI. Pour utiliser cette commande, remplacez chaque espace réservé saisi par l'utilisateur par vos propres informations.


aws s3api head-bucket --bucket sample-bucket --profile your-profile --endpoint-url https://s3api-endpoint-ip

Récupérez une liste de buckets ou de buckets régionaux

Utilisez le list-regional-buckets ou list buckets pour répertorier le stockage compatible Amazon S3 sur les compartiments d'appareils de la famille Snow à l'aide du AWS CLI.


aws s3control list-regional-buckets --account-id 123456789012 --profile your-profile --endpoint-url https://s3ctrlapi-endpoint-ip

Pour plus d'informations sur la list-regional-buckets commande, reportez-vous list-regional-bucketsà la référence des AWS CLI commandes.


 aws s3 list-buckets --account-id 123456789012 --endpoint-url https://s3api-endpoint-ip

Pour plus d'informations sur la list-buckets commande, consultez list-buckets dans le manuel Command Reference AWS CLI

L'exemple de SDK pour Java suivant permet d'obtenir une liste de buckets sur les appareils Snowball Edge. Pour plus d'informations, consultez ListBucketsle manuel Amazon Simple Storage Service API Reference.



  import com.amazonaws.services.s3.model.*;
  public void listBuckets() {
    ListBucketsRequest reqListBuckets = new ListBucketsRequest()
    .withAccountId(AccountId)
    ListBucketsResult respListBuckets = s3APIClient.RegionalBuckets(reqListBuckets);
    System.out.printf("ListBuckets Response: %s%n", respListBuckets.toString());
  }

L' PowerShell exemple suivant permet d'obtenir la liste des buckets présents sur les appareils Snowball Edge.



   Get-S3CRegionalBucketList -AccountId 012345678910 -Endpoint "https://snowball_ip" -Region snow

L'exemple .NET suivant permet d'obtenir une liste de buckets sur les appareils Snowball Edge.



using Amazon.S3Control;
using Amazon.S3Control.Model;

namespace SnowTest;

internal class Program
{
    static async Task Main(string[] args)
    {
        var config = new AmazonS3ControlConfig
        {
            ServiceURL = "https://snowball_ip",
            AuthenticationRegion = "snow" // Note that this is not RegionEndpoint
        };        

        var client = new AmazonS3ControlClient(config);

        var response = await client.ListRegionalBucketsAsync(new ListRegionalBucketsRequest() 
        { 
            AccountId = "012345678910" 
        });
    }
}

Procurez-vous un seau

L'exemple suivant permet d'obtenir un compartiment de stockage compatible avec Amazon S3 sur les appareils Snow Family à l'aide du AWS CLI. Pour utiliser cette commande, remplacez chaque espace réservé saisi par l'utilisateur par vos propres informations.


aws s3control get-bucket --account-id 123456789012 --bucket DOC-EXAMPLE-BUCKET --profile your-profile --endpoint-url https://s3ctrlapi-endpoint-ip

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

L'exemple suivant de stockage compatible avec Amazon S3 sur les appareils de la famille Snow permet d'obtenir un bucket à l'aide du SDK for Java. Pour plus d'informations, consultez GetBucketle manuel Amazon Simple Storage Service API Reference.



import com.amazonaws.services.s3control.model.*;

public void getBucket(String bucketName) {

    GetBucketRequest reqGetBucket = new GetBucketRequest()
            .withBucket(bucketName)
            .withAccountId(AccountId);

    GetBucketResult respGetBucket = s3ControlClient.getBucket(reqGetBucket);
    System.out.printf("GetBucket Response: %s%n", respGetBucket.toString());
}

Supprimer un bucket

Important

Celui Compte AWS qui crée le bucket en est propriétaire et est le seul à pouvoir le supprimer.
Les compartiments des appareils de la famille Snow doivent être vides avant de pouvoir être supprimés.
Vous ne pouvez pas récupérer un compartiment après l'avoir supprimé.

L'exemple suivant supprime un compartiment de stockage compatible Amazon S3 sur les appareils Snow Family à l'aide du AWS CLI. Pour utiliser cette commande, remplacez chaque espace réservé saisi par l'utilisateur par vos propres informations.


aws s3control delete-bucket --account-id 123456789012 --bucket DOC-EXAMPLE-BUCKET --profile your-profile --endpoint-url https://s3ctrlapi-endpoint-ip

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

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Configuration et démarrage du stockage compatible Amazon S3 sur les appareils Snow Family

Utilisation d'objets S3 sur un appareil Snowball Edge