CreateBucket (API SOAP)

Nota

Le API SOAP per Amazon S3 non sono disponibili per i nuovi clienti, con la fine del ciclo di vita prevista per il 31 agosto 2025. Ti consigliamo di utilizzare l'API REST o gli AWS SDK.

L'CreateBucketoperazione crea un bucket. Non tutte le stringhe sono nomi di bucket accettabili. Per informazioni sulle restrizioni relative ai nomi dei bucket, consulta Lavorare con i bucket Amazon S3.

Nota

Per determinare se esiste un nome di bucket, usa ListBucket e imposta su 0. MaxKeys Una NoSuchBucket risposta indica che il bucket è disponibile, una AccessDenied risposta indica che qualcun altro è il proprietario del bucket e una risposta di successo indica che sei il proprietario del bucket o hai l'autorizzazione per accedervi.

Esempio Crea un bucket chiamato «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>

Elementi

• Bucket:Il nome del bucket che stai cercando di creare.

• AccessControlList:L'elenco di controllo degli accessi per il nuovo bucket. Questo elemento è facoltativo. Se non viene fornito, il bucket viene creato con una politica di accesso che consente l'accesso FULL_CONTROL al richiedente.

Controllo degli accessi

È necessario autenticarsi con un ID chiave di accesso valido. AWS Le richieste anonime non sono mai autorizzate a creare bucket.

Risorse correlate

• ListBucket (API SOAP)