CreateBucket (API SOAP)
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.
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.
exemplo Crie um bucket chamado “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>
Elementos
-
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
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
