View a markdown version of this page

CreateBucket (API SOAP) - Amazon Simple Storage Service
ElémentsContrôle d’accèsRessources connexes

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.

CreateBucket (API SOAP)

Note

Les SOAP API pour Amazon S3 ne sont pas disponibles pour les nouveaux clients. Leur fin de vie est prévue le 31 août 2025. Nous vous recommandons d'utiliser l'API REST ou les AWS SDK.

L'CreateBucketopération crée un compartiment. Toutes les chaînes ne constituent pas un nom de compartiment acceptable. Pour plus d'informations sur les restrictions relatives à la dénomination des compartiments, consultez la section Utilisation des compartiments Amazon S3.

Note

Pour déterminer s'il existe un nom de compartiment, utilisez-le ListBucket et MaxKeys définissez-le sur 0. Une NoSuchBucket réponse indique que le compartiment est disponible, une AccessDenied réponse indique que quelqu'un d'autre est propriétaire du compartiment et une réponse de réussite indique que vous êtes propriétaire du compartiment ou que vous êtes autorisé à y accéder.

Exemple Créez un bucket nommé « quotes »

Sample Request

<CreateBucket xmlns="https://doc.s3.amazonaws.com/2006-03-01">
  <Bucket>quotes</Bucket>
  <AWSAccessKeyId>AKIAIOSFODNN7EXAMPLE</AWSAccessKeyId>
  <Timestamp>2006-03-01T12:00:00.183Z</Timestamp>
  <Signature>Iuyz3d3P0aTou39dzbqaEXAMPLE=</Signature>
</CreateBucket>

Sample Response

<CreateBucketResponse xmlns="https://s3.amazonaws.com/doc/2006-03-01">
  <CreateBucketResponse>
    <Bucket>quotes</Bucket>
  </CreateBucketResponse>
</CreateBucketResponse>

Eléments

  • Bucket:Le nom du compartiment que vous essayez de créer.

  • AccessControlList:La liste de contrôle d'accès pour le nouveau compartiment. Cet élément est facultatif. S'il n'est pas fourni, le bucket est créé avec une politique d'accès qui donne au demandeur un accès FULL_CONTROL.

Contrôle d’accès

Vous devez vous authentifier à l'aide d'un ID de clé AWS d'accès valide. Les demandes anonymes ne sont jamais autorisées pour créer des buckets.

Ressources connexes