# CreateBucket (API SOAP)
<a name="SOAPCreateBucket"></a>

**nota**  
 As APIs SOAP para o Amazon S3 não estão disponíveis para novos clientes e chegam ao fim da vida útil (EOL) em 31 de agosto de 2025. Recomendamos usar a API REST ou os AWS SDKs. 

A operação `CreateBucket` cria um bucket. Nem toda string é um nome de bucket aceitável. Para obter informações sobre restrições de nomenclatura de buckets, consulte [Como trabalhar com buckets do Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingBucket.html).

**nota**  
 Para determinar se existe um nome de bucket, use `ListBucket` e defina `MaxKeys` como 0. Uma resposta NoSuchBucket indica que o bucket está disponível, uma resposta AccessDenied indica que outra pessoa é proprietária do bucket e uma resposta Success indica que você é o proprietário do bucket ou tem permissão para acessá-lo. 

**Example Crie um bucket chamado “quotes”**  
`Sample Request`  

```
1. <CreateBucket xmlns="https://doc.s3.amazonaws.com/2006-03-01">
2.   <Bucket>quotes</Bucket>
3.   <AWSAccessKeyId>AKIAIOSFODNN7EXAMPLE</AWSAccessKeyId>
4.   <Timestamp>2006-03-01T12:00:00.183Z</Timestamp>
5.   <Signature>Iuyz3d3P0aTou39dzbqaEXAMPLE=</Signature>
6. </CreateBucket>
```
`Sample Response`  

```
1. <CreateBucketResponse xmlns="https://s3.amazonaws.com/doc/2006-03-01">
2.   <CreateBucketResponse>
3.     <Bucket>quotes</Bucket>
4.   </CreateBucketResponse>
5. </CreateBucketResponse>
```

## Elementos
<a name="SOAPCreateBucketElements"></a>
+ `Bucket:` O nome do bucket que você está tentando criar. 

  
+ `AccessControlList:` A lista de controle de acesso do novo bucket. O elemento é opcional. Se não for fornecido, o bucket será criado com uma política de acesso que concede acesso FULL\_CONTROL ao solicitante.

  

## Controle de acesso
<a name="SOAPCreateBucketAccessControl"></a>

Você deve se autenticar com um ID válido de chave de acesso da AWS. Solicitações anônimas nunca podem criar buckets.

## Recursos relacionados
<a name="SOAPCreateBucket_RelatedResources"></a>
+  [ListBucket (API SOAP)](SOAPListBucket.md)