View a markdown version of this page

ListAllMyBuckets (API SOAP) - Amazon Simple Storage Service

ListAllMyBuckets (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 ListAllMyBuckets retorna uma lista de todos os buckets de propriedade do remetente da solicitação.

exemplo

Sample Request

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

Sample Response

<ListAllMyBucketsResult xmlns="https://s3.amazonaws.com/doc/2006-03-01"> <Owner> <ID>bcaf1ffd86f41161ca5fb16fd081034f</ID> <DisplayName>webfile</DisplayName> </Owner> <Buckets> <Bucket> <Name>quotes;/Name> <CreationDate>2006-02-03T16:45:09.000Z</CreationDate> </Bucket> <Bucket> <Name>samples</Name> <CreationDate>2006-02-03T16:41:58.000Z</CreationDate> </Bucket> </Buckets> </ListAllMyBucketsResult>

Corpo da resposta

  • Owner:

    Isso fornece informações que o Amazon S3 usa para representar sua identidade para fins de autenticação e controle de acesso. O ID é um identificador exclusivo e permanente do desenvolvedor que fez a solicitação. DisplayName é um nome legível por humanos que representa o desenvolvedor que fez a solicitação. Não é exclusivo e pode mudar com o tempo. Recomendamos que você associe seu DisplayName ao nome do fórum.

  • Name:

    O nome de um bucket. Se um de seus buckets tiver sido excluído recentemente, o nome do bucket excluído ainda poderá estar presente nessa lista por um tempo.

  • CreationDate:

    A hora em que o bucket foi criado.

Controle de acesso

Você deve se autenticar com um ID válido de chave de acesso da AWS. Solicitações anônimas nunca podem listar buckets, e você só pode listar buckets dos quais seja o proprietário.