Création d'un bucket à usage général - Amazon Simple Storage Service
Réglages du godet à usage général

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.

Création d'un bucket à usage général

Pour télécharger vos données sur Amazon S3, vous devez d'abord créer un compartiment Amazon S3 à usage général dans l'un des Régions AWS. Le Compte AWS qui crée le compartiment en est le propriétaire. Lorsque vous créez un compartiment, vous devez choisir un nom de compartiment et une Région. Au cours du processus de création, vous pouvez éventuellement choisir d'autres options de gestion du stockage pour le compartiment.

Important

Une fois que vous avez créé un bucket, vous ne pouvez pas modifier le nom du bucket, le propriétaire du bucket ou la région. Pour plus d’informations sur l’attribution de noms à des compartiments, reportez-vous à la section Règles de dénomination des compartiments à usage général.

Par défaut, vous pouvez créer jusqu'à 10 000 compartiments à usage général par. Compte AWS Pour demander une augmentation du quota de compartiments à usage général, accédez à la console Service Quotas.

Chaque compartiment permet de stocker un nombre illimité d’objets. Pour obtenir la liste des restrictions et limitations relatives aux compartiments à usage général Amazon S3, consultezQuotas, limites et restrictions relatifs aux compartiments à usage général.

Réglages du godet à usage général

Lorsque vous créez un bucket à usage général, vous pouvez utiliser les paramètres suivants pour contrôler différents aspects du comportement de votre bucket :

  • Propriété des objets S3 — La propriété des objets S3 est un paramètre au niveau du compartiment Amazon S3 que vous pouvez utiliser à la fois pour contrôler la propriété des objets chargés dans votre compartiment et pour désactiver ou activer les listes de contrôle d'accès ()ACLs. Par défaut, Object Ownership est défini sur le paramètre imposé par le propriétaire du bucket, et tous ACLs sont désactivés. Lorsque cette option est ACLs désactivée, le propriétaire du compartiment possède tous les objets du compartiment et gère l'accès aux données exclusivement à l'aide de politiques. Pour de plus amples informations, veuillez consulter Contrôle de la propriété des objets et désactivation ACLs pour votre compartiment.

  • Verrouillage des objets S3 — Le verrouillage des objets S3 peut aider à empêcher la suppression ou le remplacement des objets Amazon S3 pendant une durée déterminée ou indéfiniment. Object Lock utilise un modèle write-once-read-many(WORM) pour stocker des objets. Le verrouillage d’objet vous permet de satisfaire aux exigences réglementaires qui nécessitent le stockage WORM, ou bien d’ajouter une couche de protection supplémentaire contre la suppression et les modifications d’objets. Pour de plus amples informations, veuillez consulter Verrouillage d’objets avec la fonctionnalité de verrouillage d’objet.

Après avoir créé un compartiment à usage général, ou lorsque vous créez un compartiment à usage général à l'aide de la console Amazon S3, vous pouvez également utiliser les paramètres suivants pour contrôler d'autres aspects du comportement de votre compartiment :

  • Accès public aux blocs S3 : la fonctionnalité S3 Block Public Access fournit des paramètres pour les points d'accès, les compartiments et les comptes afin de vous aider à gérer l'accès public aux ressources Amazon S3. Par défaut, les nouveaux compartiments, points d'accès et objets n'autorisent pas l'accès public. Toutefois, les utilisateurs peuvent modifier les stratégies de compartiment, les stratégies de point d’accès ou les autorisations d’objet pour autoriser l’accès public. Les paramètres de la fonctionnalité de blocage de l’accès public S3 remplacent ces stratégies et autorisations pour que vous puissiez restreindre l’accès public à ces ressources. Pour de plus amples informations, veuillez consulter Blocage de l’accès public à votre stockage Amazon S3.

  • Versionnage S3 : le versionnage est un moyen de conserver plusieurs variantes d'un objet dans le même compartiment. Vous pouvez utiliser la gestion des versions pour préserver, récupérer et restaurer chaque version de chaque objet stocké dans votre compartiment. La gestion des versions permet de récupérer facilement les données en cas d’actions involontaires des utilisateurs ou de défaillances des applications. Par défaut, le versionnement est désactivé pour les buckets. Pour de plus amples informations, veuillez consulter Conservation de plusieurs versions d’objets grâce à la gestion des versions S3.

  • Chiffrement par défaut : vous pouvez définir le type de chiffrement par défaut pour tous les objets de votre compartiment. Le chiffrement côté serveur avec les clés gérées par Amazon S3 (SSE-S3) est le niveau de base de la configuration du chiffrement pour chaque compartiment dans Amazon S3. Tous les nouveaux objets chargés dans un compartiment S3 sont automatiquement chiffrés avec SSE-S3 comme niveau de chiffrement de base. Si vous souhaitez utiliser un autre type de chiffrement par défaut, vous pouvez spécifier un chiffrement côté serveur avec des clés AWS Key Management Service (AWS KMS) (SSE-KMS), un chiffrement double couche côté serveur avec des clés (DSSE-KMS) ou un chiffrement côté serveur avec des AWS KMS clés fournies par le client (SSE-C) pour chiffrer vos données. Pour de plus amples informations, veuillez consulter Définition du comportement de chiffrement côté serveur par défaut pour les compartiments Amazon S3.

Vous pouvez utiliser la console Amazon S3, l'API REST Amazon S3 AWS Command Line Interface (AWS CLI) ou AWS SDKs pour créer un bucket à usage général. Pour plus d'informations sur les autorisations requises pour créer un bucket à usage général, consultez le CreateBucketmanuel Amazon Simple Storage Service API Reference.

Si vous ne parvenez pas à créer un compartiment Amazon S3, consultez Comment résoudre les erreurs lors de la création d'un compartiment Amazon S3 ? sur AWS re:Post.

  1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/s3/.

  2. Dans la barre de navigation en haut de la page, choisissez le nom du fichier actuellement affiché Région AWS. Choisissez ensuite la région dans laquelle vous souhaitez créer un compartiment.

    Note

    • Une fois le compartiment créé, vous ne pouvez pas changer sa région.

    • Pour limiter la latence et les coûts, et répondre aux exigences légales, choisissez une région proche de vous. Les objets stockés dans une Région ne la quittent jamais, sauf si vous les transférez explicitement vers une autre Région. Pour obtenir la liste d'Amazon S3 Régions AWS, consultez la section sur les Service AWS points de terminaison dans le Référence générale d'Amazon Web Services.

  3. Dans le volet de navigation de gauche, choisissez Compartiments à usage général.

  4. Choisissez Créer un compartiment. La page Créer un compartiment s’ouvre.

  5. Pour Nom du compartiment, saisissez le nom de votre compartiment.

    Le nom du compartiment doit présenter les caractéristiques suivantes :

    • Être unique dans une partition. Une partition est un regroupement de régions. AWS possède actuellement trois partitions : aws (Régions commerciales), aws-cn (Régions de Chine) et aws-us-gov (AWS GovCloud (US) Regions).

    • Il doit comporter entre 3 et 63 caractères.

    • Composé uniquement de lettres minuscules, de chiffres, de points (.) et de traits d'union (). - Pour une compatibilité optimale, nous vous recommandons d'éviter d'utiliser des points (.) dans les noms de bucket, sauf pour les buckets utilisés uniquement pour l'hébergement de sites Web statiques.

    • Il doit commencer et se terminer par une lettre ou un chiffre.

    • Pour obtenir la liste complète des règles de dénomination des compartiments, consultez. Règles de dénomination des compartiments à usage général

    Important

    • Une fois le compartiment créé, vous ne pouvez pas changer son nom.

    • N'incluez pas d'informations sensibles dans le nom du bucket. Le nom du compartiment est visible en pointant vers les objets URLs qu'il contient.

  6. (Facultatif) Sous Configuration générale, vous pouvez choisir de copier les paramètres d'un compartiment existant dans votre nouveau compartiment. Si vous ne souhaitez pas copier les paramètres d'un bucket existant, passez à l'étape suivante.

    Note

    Cette option :

    • N'est pas disponible dans AWS CLI et n'est disponible que dans la console Amazon S3

    • Ne copie pas la politique du bucket du bucket existant vers le nouveau bucket

    Pour copier les paramètres d’un compartiment existant, sous Copier les paramètres d’un compartiment existant, sélectionnez Choisir un compartiment. La fenêtre Choisir un compartiment s’ouvre. Recherchez le compartiment contenant les paramètres que vous souhaitez copier, puis sélectionnez Choisir un compartiment. La fenêtre Choisir un compartiment se ferme et la fenêtre Créer un compartiment s'ouvre à nouveau.

    Sous Copier les paramètres d'un bucket existant, vous pouvez désormais voir le nom du bucket que vous avez sélectionné. Les paramètres de votre nouveau compartiment correspondent désormais aux paramètres du compartiment que vous avez sélectionné. Si vous souhaitez supprimer les paramètres copiés, choisissez Restaurer les paramètres par défaut. Passez en revue les autres paramètres du bucket sur la page Créer un bucket. Si vous ne souhaitez apporter aucune modification, vous pouvez passer à l'étape finale.

  7. Sous Propriété des objets, pour désactiver ou activer ACLs et contrôler la propriété des objets chargés dans votre bucket, sélectionnez l'un des paramètres suivants :

    ACLs handicapé

    • Application par le propriétaire du compartiment (par défaut) : ACLs cette option est désactivée, et le propriétaire du compartiment possède automatiquement tous les objets du compartiment à usage général et en a le contrôle total. ACLs n'affectent plus les autorisations d'accès aux données du compartiment à usage général S3. Le compartiment utilise des stratégies exclusivement pour définir le contrôle des accès.

      Par défaut, ACLs sont désactivés. La majorité des cas d'utilisation modernes d'Amazon S3 ne nécessitent plus l'utilisation de ACLs. Nous vous recommandons de rester ACLs désactivé, sauf dans des circonstances exceptionnelles où vous devez contrôler l'accès à chaque objet individuellement. Pour de plus amples informations, veuillez consulter Contrôle de la propriété des objets et désactivation ACLs pour votre compartiment.

    ACLs enabled

    • Bucket owner preferred (Préféré par le propriétaire du compartiment) – Le propriétaire du compartiment possède les nouveaux objets que d’autres comptes écrivent dans le compartiment avec la liste ACL bucket-owner-full-control prête à l’emploi, et en a le contrôle total.

      Si vous appliquez le paramètre Propriétaire du compartiment préféré, pour exiger que tous les chargements Amazon S3 incluent la liste ACL prédéfinie bucket-owner-full-control, vous pouvez ajouter une politique de compartiment qui autorise uniquement les chargements d’objets utilisant cette liste ACL.

    • Auteur d'objets : celui Compte AWS qui télécharge un objet est propriétaire de l'objet, en a le contrôle total et peut autoriser d'autres utilisateurs à y accéder par le biais ACLs de celui-ci.

    Note

    Le paramètre par défaut est Propriétaire du compartiment appliqué. Pour appliquer le paramètre par défaut et le maintenir ACLs désactivé, seule l's3:CreateBucketautorisation est nécessaire. Pour l'activer ACLs, vous devez avoir l's3:PutBucketOwnershipControlsautorisation.

  8. Dans Paramètres de blocage de l’accès public pour ce compartiment, choisissez les paramètres Bloquer l’accès public que vous souhaitez appliquer au compartiment.

    Par défaut, les quatre paramètres de blocage de l’accès public sont activés. Nous vous recommandons de maintenir tous les paramètres activés, sauf si vous savez que vous devez en désactiver un ou plusieurs pour votre cas d’utilisation spécifique. Pour en savoir plus sur le blocage de l’accès public, consultez Blocage de l’accès public à votre stockage Amazon S3.

    Note

    Pour activer tous les paramètres de blocage de l’accès public, seule l’autorisation s3:CreateBucket est requise. Pour désactiver les paramètres de blocage de l’accès public, vous devez disposer de l’autorisation s3:PutBucketPublicAccessBlock.

  9. (Facultatif) Par défaut, le versionnement des compartiments est désactivé. La gestion des versions est un moyen de conserver plusieurs variantes d'un objet dans un même compartiment. Vous pouvez utiliser la gestion des versions pour préserver, récupérer et restaurer chaque version de chaque objet stocké dans votre compartiment. Le contrôle de version permet de récupérer facilement les données en cas d'action involontaire d'un utilisateur ou de défaillance applicative. Pour plus d’informations sur la gestion des versions, consultez Conservation de plusieurs versions d’objets grâce à la gestion des versions S3.

    Pour activer le versionnement sur votre compartiment, choisissez Enable.

  10. (Facultatif) Sous Tags (Balises), vous pouvez choisir d’ajouter des balises à votre compartiment. Avec la répartition des AWS coûts, vous pouvez utiliser des balises de compartiment pour annoter la facturation liée à l'utilisation d'un compartiment. Une balise correspond à une paire clé-valeur représentant un libellé que vous affectez à un compartiment. Pour de plus amples informations, veuillez consulter Utilisation des balises de répartition des coûts pour les compartiments S3.

    Pour ajouter une balise de compartiment, saisissez une Key (Clé) et éventuellement une Value (Valeur), puis choisissez Add Tag (Ajouter une balise).

  11. Pour configurer le chiffrement par défaut, sous Type de chiffrement, sélectionnez l'une des options suivantes :

    • Chiffrement côté serveur avec des clés gérées par Amazon S3 (SSE-S3)

    • Chiffrement côté serveur avec AWS Key Management Service clés (SSE-KMS)

    • Chiffrement double couche côté serveur avec clés AWS Key Management Service (AWS KMS) (DSSE-KMS)

      Important

      Si vous utilisez l'option SSE-KMS ou DSSE-KMS pour votre configuration de chiffrement par défaut, vous êtes soumis au quota de demandes par seconde (RPS) de. AWS KMS Pour plus d'informations sur les AWS KMS quotas et sur la manière de demander une augmentation de quota, consultez la section Quotas dans le guide du AWS Key Management Service développeur.

    Les buckets et les nouveaux objets sont chiffrés en utilisant le chiffrement côté serveur avec les clés gérées Amazon S3 (SSE-S3) comme niveau de base de configuration de chiffrement. Pour plus d’informations sur le chiffrement par défaut, consultez Définition du comportement de chiffrement côté serveur par défaut pour les compartiments Amazon S3. Pour en savoir plus sur SSE-S3, consultez Utilisation du chiffrement côté serveur avec des clés gérées par Amazon S3 (SSE-S3).

    Pour plus d'informations sur l'utilisation du chiffrement côté serveur pour chiffrer vos données, consultez. Protection des données à l’aide du chiffrement

  12. Si vous avez choisi le chiffrement côté serveur avec des clés gérées Amazon S3 (SSE-S3) ou le chiffrement côté serveur double couche avec des clés () AWS Key Management Service (DSSE-KMS AWS KMS), procédez comme suit :

    1. Sous CléAWS KMS , spécifiez votre clé KMS de l’une des manières suivantes :

      • Pour choisir parmi une liste de clés KMS disponibles, choisissez Choisir parmi vos AWS KMS keys, puis choisissez votre clé KMS dans la liste des clés disponibles.

        La clé Clé gérée par AWS (aws/s3) et la clé gérée par votre client apparaissent toutes deux dans cette liste. Pour plus d’informations sur les clés gérées par le client, consultez Clés de client et clés AWS dans le Guide du développeur AWS Key Management Service .

      • Pour saisir l’ARN de la clé KMS, choisissez Saisir l’ARN de AWS KMS key , puis saisissez l’ARN de votre clé KMS dans le champ qui s’affiche.

      • Pour créer une nouvelle clé gérée par le client dans la AWS KMS console, choisissez Create a KMS key.

        Pour plus d'informations sur la création d'un AWS KMS key, consultez la section Création de clés dans le Guide du AWS Key Management Service développeur.

      Important

      Vous ne pouvez utiliser que les clés KMS disponibles dans le même compartiment Région AWS que le bucket. La console Amazon S3 répertorie uniquement les 100 premières clés KMS dans la même région que le compartiment. Pour utiliser une clé KMS qui n'est pas répertoriée, vous devez saisir l'ARN de votre clé KMS. Si vous souhaitez utiliser une clé KMS appartenant à un autre compte, vous devez d'abord être autorisé à utiliser la clé, puis saisir l'ARN de la clé KMS. Pour plus d'informations sur les autorisations entre comptes pour les clés KMS, consultez la section Création de clés KMS utilisables par d'autres comptes dans le guide du AWS Key Management Service développeur. Pour en savoir plus sur SSE-KMS, consultez Spécification du chiffrement côté serveur avec AWS KMS (SSE-KMS). Pour en savoir plus sur DSSE-KMS, consultez Utilisation du chiffrement double couche côté serveur avec AWS KMS clés (DSSE-KMS).

      Lorsque vous utilisez un AWS KMS key pour le chiffrement côté serveur dans Amazon S3, vous devez choisir une clé KMS de chiffrement symétrique. Amazon S3 prend uniquement en charge les clés KMS symétriques de chiffrement et ne prend pas en charge les clés KMS asymétriques. Pour plus d’informations, consultez Identification des clés KMS symétriques et asymétriques dans le Guide du développeur AWS Key Management Service .

    2. Lorsque vous configurez votre compartiment pour utiliser le chiffrement par défaut avec SSE-KMS, vous pouvez également utiliser les clés de compartiment S3. Les clés de compartiment S3 réduisent le coût du chiffrement en diminuant le trafic de demandes d'Amazon S3 vers AWS KMS. Pour de plus amples informations, veuillez consulter Réduction du coût du SSE-KMS avec les clés de compartiment Amazon S3. Les clés de compartiment S3 ne sont pas prises en charge pour DSSE-KMS.

      Par défaut, les clés de compartiment S3 sont activées dans la console Amazon S3. Nous vous recommandons de laisser les clés de compartiment S3 activées pour réduire vos coûts. Pour désactiver les clés de compartiment S3 pour votre compartiment, sous Clé de compartiment, choisissez Disable.

  13. (Facultatif) S3 Object Lock permet de protéger les nouveaux objets contre la suppression ou le remplacement. Pour de plus amples informations, veuillez consulter Verrouillage d’objets avec la fonctionnalité de verrouillage d’objet. Si vous souhaitez activer S3 Object Lock, procédez comme suit :

    1. Choisissez Paramètres avancés.

      Important

      L'activation d'Object Lock active automatiquement le versionnement du bucket. Après avoir activé et créé le bucket avec succès, vous devez également configurer les paramètres de rétention par défaut et de conservation légale d'Object Lock dans l'onglet Propriétés du bucket.

    2. Pour activer le verrouillage d’objets, choisissez Enable (Activer), lisez l’avertissement qui s’affiche et confirmez-le.

    Note

    Pour créer un bucket activé pour Object Lock, vous devez disposer des autorisations suivantes : s3:CreateBuckets3:PutBucketVersioning, ets3:PutBucketObjectLockConfiguration.

  14. Choisissez Créer un compartiment.

Lorsque vous utilisez le AWS SDKs pour créer un bucket à usage général, vous devez créer un client, puis utiliser le client pour envoyer une demande de création d'un bucket. En tant que bonne pratique, vous devez créer votre client et votre compartiment dans la même Région AWS. Si vous ne spécifiez pas de région lorsque vous créez un client ou un compartiment, Amazon S3 utilise USA Est (Virginie du Nord), la région par défaut. Si vous souhaitez limiter la création du bucket à un paramètre spécifique Région AWS, utilisez la clé de LocationConstraintcondition.

Pour créer un client permettant d'accéder à un point de terminaison à double pile, vous devez spécifier un Région AWS. Pour plus d’informations, consultez Utilisation des points de terminaison à double pile Amazon S3 dans la Référence d’API Amazon S3. Pour obtenir la liste des points Régions AWS de terminaison et quotas Amazon Simple Storage Service disponibles dans le Références générales AWS.

Lorsque vous créez un client, la Région est mappée au point de terminaison spécifique à la Région. Le client utilise ce point de terminaison pour communiquer avec Amazon S3 : s3.region.amazonaws.com. Si votre Région a été lancée après le 20 mars 2019, votre client et votre compartiment doivent se trouver dans la même Région. Par conséquent, vous pouvez utiliser un client dans la Région USA Est (Virginie du Nord) pour créer un compartiment dans n’importe quelle Région lancée avant le 20 mars 2019. Pour de plus amples informations, veuillez consulter Points de terminaison hérités.

Ces exemples de code AWS SDK exécutent les tâches suivantes :

  • Créer un client en indiquant explicitement une Région AWS : dans l’exemple, le client utilise le point de terminaison s3.us-west-2.amazonaws.com pour communiquer avec Amazon S3. Vous pouvez spécifier n’importe quelle Région AWS. Pour en obtenir la liste Régions AWS, voir Régions et points de terminaison dans le manuel de référence AWS général.

  • Envoyer une demande de création de compartiment en indiquant uniquement un nom de compartiment : le client envoie une demande à Amazon S3 pour créer le compartiment dans la région où vous avez créé un client.

  • Récupérez les informations relatives à l'emplacement du compartiment : Amazon S3 stocke les informations relatives à l'emplacement du compartiment dans la sous-ressource de localisation associée au compartiment.

Pour des exemples de AWS SDK supplémentaires et des exemples dans d'autres langages, consultez la section Utilisation CreateBucket avec un AWS SDK ou une CLI dans le manuel Amazon Simple Storage Service API Reference.

Java
Exemple Créez un compartiment utilisant un identifiant unique global (GUID) dans le nom du compartiment

L'exemple suivant vous montre comment créer un avec un GUID à la fin du nom du compartiment dans la région USA Est (Virginie du Nord) (us-east-1) en utilisant le AWS SDK pour Java. Pour utiliser cet exemple, remplacez user input placeholders par vos propres informations. Pour plus d'informations sur les autres AWS SDKs, voir Outils sur lesquels s'appuyer AWS.


import com.amazonaws.regions.Regions;
import com.amazonaws.services.s3.AmazonS3;
import com.amazonaws.services.s3.AmazonS3ClientBuilder;
import com.amazonaws.services.s3.model.Bucket;
import com.amazonaws.services.s3.model.CreateBucketRequest;

import java.util.List;
import java.util.UUID;

public class CreateBucketWithUUID {
    public static void main(String[] args) {
        final AmazonS3 s3 = AmazonS3ClientBuilder.standard().withRegion(Regions.US_EAST_1).build();
        String bucketName = "amzn-s3-demo-bucket" +  UUID.randomUUID().toString().replace("-", "");
        CreateBucketRequest createRequest = new CreateBucketRequest(bucketName);
        System.out.println(bucketName);
        s3.createBucket(createRequest);
    }
}
Exemple Création d'un compartiment à usage général

Cet exemple vous montre comment créer un compartiment Amazon S3 à l'aide du AWS SDK pour Java. Pour obtenir des instructions sur la création et le test d'un échantillon fonctionnel, consultez le guide du AWS SDK for Java 2.x développeur.


import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.regions.Regions;
import com.amazonaws.services.s3.AmazonS3;
import com.amazonaws.services.s3.AmazonS3ClientBuilder;
import com.amazonaws.services.s3.model.CreateBucketRequest;
import com.amazonaws.services.s3.model.GetBucketLocationRequest;

import java.io.IOException;

public class CreateBucket2 {

    public static void main(String[] args) throws IOException {
        Regions clientRegion = Regions.DEFAULT_REGION;
        String bucketName = "*** Bucket name ***";

        try {
            AmazonS3 s3Client = AmazonS3ClientBuilder.standard()
                    .withCredentials(new ProfileCredentialsProvider())
                    .withRegion(clientRegion)
                    .build();

            if (!s3Client.doesBucketExistV2(bucketName)) {
                // Because the CreateBucketRequest object doesn't specify a region, the
                // bucket is created in the region specified in the client.
                s3Client.createBucket(new CreateBucketRequest(bucketName));

                // Verify that the bucket was created by retrieving it and checking its
                // location.
                String bucketLocation = s3Client.getBucketLocation(new GetBucketLocationRequest(bucketName));
                System.out.println("Bucket location: " + bucketLocation);
            }
        } catch (AmazonServiceException e) {
            // The call was transmitted successfully, but Amazon S3 couldn't process
            // it and returned an error response.
            e.printStackTrace();
        } catch (SdkClientException e) {
            // Amazon S3 couldn't be contacted for a response, or the client
            // couldn't parse the response from Amazon S3.
            e.printStackTrace();
        }
    }
}
.NET

Pour plus d'informations sur la création et le test d'un échantillon fonctionnel, consultez le manuel de AWS référence de l'API du SDK for .NET Version 3.

using Amazon;
using Amazon.S3;
using Amazon.S3.Model;
using Amazon.S3.Util;
using System;
using System.Threading.Tasks;

namespace Amazon.DocSamples.S3
{
    class CreateBucketTest
    {
        private const string bucketName = "*** bucket name ***";
        // Specify your bucket region (an example region is shown).
        private static readonly RegionEndpoint bucketRegion = RegionEndpoint.USWest2;
        private static IAmazonS3 s3Client;
        public static void Main()
        {
            s3Client = new AmazonS3Client(bucketRegion);
            CreateBucketAsync().Wait();
        }

        static async Task CreateBucketAsync()
        {
            try
            {
                if (!(await AmazonS3Util.DoesS3BucketExistAsync(s3Client, bucketName)))
                {
                    var putBucketRequest = new PutBucketRequest
                    {
                        BucketName = bucketName,
                        UseClientRegion = true
                    };

                    PutBucketResponse putBucketResponse = await s3Client.PutBucketAsync(putBucketRequest);
                }
                // Retrieve the bucket location.
                string bucketLocation = await FindBucketLocationAsync(s3Client);
            }
            catch (AmazonS3Exception e)
            {
                Console.WriteLine("Error encountered on server. Message:'{0}' when writing an object", e.Message);
            }
            catch (Exception e)
            {
                Console.WriteLine("Unknown encountered on server. Message:'{0}' when writing an object", e.Message);
            }
        }
        static async Task<string> FindBucketLocationAsync(IAmazonS3 client)
        {
            string bucketLocation;
            var request = new GetBucketLocationRequest()
            {
                BucketName = bucketName
            };
            GetBucketLocationResponse response = await client.GetBucketLocationAsync(request);
            bucketLocation = response.Location.ToString();
            return bucketLocation;
        }
    }
}
Ruby

Pour plus d'informations sur la création et le test d'un échantillon fonctionnel, consultez le AWS SDK pour Ruby - Version 3.

require 'aws-sdk-s3'

# Wraps Amazon S3 bucket actions.
class BucketCreateWrapper
  attr_reader :bucket

  # @param bucket [Aws::S3::Bucket] An Amazon S3 bucket initialized with a name. This is a client-side object until
  #                                 create is called.
  def initialize(bucket)
    @bucket = bucket
  end

  # Creates an Amazon S3 bucket in the specified AWS Region.
  #
  # @param region [String] The Region where the bucket is created.
  # @return [Boolean] True when the bucket is created; otherwise, false.
  def create?(region)
    @bucket.create(create_bucket_configuration: { location_constraint: region })
    true
  rescue Aws::Errors::ServiceError => e
    puts "Couldn't create bucket. Here's why: #{e.message}"
    false
  end

  # Gets the Region where the bucket is located.
  #
  # @return [String] The location of the bucket.
  def location
    if @bucket.nil?
      'None. You must create a bucket before you can get its location!'
    else
      @bucket.client.get_bucket_location(bucket: @bucket.name).location_constraint
    end
  rescue Aws::Errors::ServiceError => e
    "Couldn't get the location of #{@bucket.name}. Here's why: #{e.message}"
  end
end

# Example usage:
def run_demo
  region = "us-west-2"
  wrapper = BucketCreateWrapper.new(Aws::S3::Bucket.new("amzn-s3-demo-bucket-#{Random.uuid}"))
  return unless wrapper.create?(region)

  puts "Created bucket #{wrapper.bucket.name}."
  puts "Your bucket's region is: #{wrapper.location}"
end

run_demo if $PROGRAM_NAME == __FILE__

L' AWS CLI exemple suivant crée un bucket à usage général dans la région USA Ouest (Californie du Nord) (us-west-1) avec un exemple de nom de bucket qui utilise un identifiant global unique (GUID). Pour utiliser cet exemple de commande, remplacez user input placeholders par vos propres informations.

aws s3api create-bucket \
    --bucket amzn-s3-demo-bucket1$(uuidgen | tr -d - | tr '[:upper:]' '[:lower:]' ) \
    --region us-west-1 \
    --create-bucket-configuration LocationConstraint=us-west-1

Pour plus d'informations et d'autres exemples, reportez-vous create-bucketà la référence des AWS CLI commandes.