ListBuckets

Documentación: ListBuckets

Descripción

La operación ListBuckets retorna una lista de todos los buckets que pertenecen al remitente autenticado.

Solicitud

Método: GET

URI:

• Estilo virtual-host: https://s3.latam-scl-x.datageneral.cl/

• Estilo path: https://s3.latam-scl-x.datageneral.cl/

Encabezados:

• Host: Requerido. Especifica el host del servicio.

• Date: Requerido. Fecha y hora de la solicitud.

• Authorization: Requerido. Contiene la firma de la solicitud para la autenticación.

Cuerpo de la solicitud:

• Vacío. No se requiere un cuerpo de solicitud para listar buckets.

Respuesta

Códigos de estado:

• 200 OK: La solicitud fue exitosa.

Encabezados de la respuesta:

• Date: Fecha y hora de la respuesta.

• x-amz-request-id: Un identificador único para la solicitud.

• x-amz-id-2: Un identificador único extendido para la solicitud.

• Server: Información sobre el servidor que procesó la solicitud.

• Content-Type: El tipo de contenido de la respuesta, que será application/xml.

Cuerpo de la respuesta:

• Contiene un documento XML con la lista de buckets.

<ListAllMyBucketsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01">
  <Owner>
    <ID>xxxxxxxxxxxxxxxxxxxxx</ID>
    <DisplayName>Nombre del Propietario</DisplayName>
  </Owner>
  <Buckets>
    <Bucket>
      <Name>nombre-del-bucket-1</Name>
      <CreationDate>2024-07-26T12:00:00.000Z</CreationDate>
    </Bucket>
    <Bucket>
      <Name>nombre-del-bucket-2</Name>
      <CreationDate>2024-07-25T12:00:00.000Z</CreationDate>
    </Bucket>
    ...
  </Buckets>
</ListAllMyBucketsResult>

Ejemplos

Ejemplo de solicitud:

GET / HTTP/1.1
Host: s3.latam-scl-x.datageneral.cl
Date: Mon, 26 Jul 2024 14:00:00 GMT
Authorization: AWS AKIAIOSFODNN7EXAMPLE:QWxhZGVpbjEgXA==

Ejemplo de respuesta:

HTTP/1.1 200 OK
Date: Mon, 26 Jul 2024 14:00:01 GMT
Content-Type: application/xml
x-amz-request-id: 65423A7B884B82F1
Server: MyS3Server

<?xml version="1.0" encoding="UTF-8"?>
<ListAllMyBucketsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01">
  <Owner>
    <ID>xxxxxxxxxxxxxxxxxxxxx</ID>
    <DisplayName>Nombre del Propietario</DisplayName>
  </Owner>
  <Buckets>
    <Bucket>
      <Name>nombre-del-bucket-1</Name>
      <CreationDate>2024-07-26T12:00:00.000Z</CreationDate>
    </Bucket>
    <Bucket>
      <Name>nombre-del-bucket-2</Name>
      <CreationDate>2024-07-25T12:00:00.000Z</CreationDate>
    </Bucket>
  </Buckets>
</ListAllMyBucketsResult>