Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda> Object Storage Service> Referencia de la API> Las API> Operaciones en buckets> Enumeración de buckets

Actualización más reciente 2023-07-11 GMT+08:00

Ver PDF

Enumeración de buckets

Funciones

Puede realizar esta operación para enumerar todos los bucket que ha creado.

Sintaxis de solicitud

    
         GET / HTTP/1.1 
Host: obs.region.myhuaweicloud.comDate: date
Authorization: authorization

Parámetros de solicitud

Esta solicitud no contiene ningún parámetro.

Encabezados de solicitud

La cabecera del mensaje de operación es la misma que la de una petición común. Para más detalles, consulte Tabla 3. Sin embargo, esta solicitud puede contener encabezados adicionales. En la siguiente tabla se describen los encabezados adicionales para esta solicitud.

**Tabla 1** Cabeceras de solicitud adicionales
Encabezado	Descripción	Obligatorio
x-obs-bucket-type	Este campo de encabezado se utiliza para especificar el contenido que se va a obtener. Valor: OBJECT: Obtener la lista de todos los bucket. POSIX: Obtener la lista de todos los sistemas de archivos paralelos. Si este encabezado no se lleva, se obtiene la lista de todos los bucket y sistemas de archivos paralelos. Tipo: string Ejemplo: x-obs-bucket-type: POSIX	No

Elementos de solicitud.

La solicitud no utiliza elementos de solicitud.

Sintaxis de respuesta

    
     
       
       
         GET HTTP/1.1 status_code
Content-Type: type
Date: date
Content-Length: length

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
<ListAllMyBucketsResult xmlns="http://obs.region.myhuaweicloud.com/doc/2015-06-30/"> 
    <Owner> 
        <ID>id</ID>
    </Owner> 
    <Buckets>
        <Bucket> 
            <Name>bucketName</Name> 
            <CreationDate>date</CreationDate>
            <Location>region</Location>
            <BucketType>buckettype</BucketType>
        </Bucket> 
        ... 
    </Buckets> 
</ListAllMyBucketsResult> 

        

      

    
   

Encabezados de respuesta

La respuesta a la solicitud utiliza encabezados comunes. Para más detalles, consulte Tabla 1.

Elementos de respuesta

Esta respuesta contiene la lista XML de los bucket propiedad del usuario. Tabla 2 describe los elementos.

**Tabla 2** Elementos de respuesta
Elemento	Description
ListAllMyBucketsResult	Lista de los bucket creados por el usuario Tipo: XML
Owner	Información del propietario del bucket, incluida la identificación del tenant. Tipo: XML
ID	ID de dominio (ID de cuenta) de un usuario. Tipo: string
Buckets	Bucket de propiedad del usuario Tipo: XML
Bucket	Detalles sobre un bucket Tipo: XML
Name	Nombre del bucket Tipo: string
CreationDate	Tiempo de creación del bucket Tipo: string
Location	Ubicación del bucket Tipo: string
BucketType	Tipo de bucket Tipo: string. Las opciones de valor son las siguientes: OBJECT: indica un bucket. POSIX: indica un sistema de ficheros paralelo.

Respuestas de error

No hay respuestas de error especiales involucradas. Para obtener más información sobre las respuestas de error, consulte Tabla 2.

Modelo de solicitud

    
         GET / HTTP/1.1
User-Agent: curl/7.29.0
Host: obs.region.myhuaweicloud.com
Accept: */*
Date: Mon, 25 Jun 2018 05:37:12 +0000
Authorization: OBS GKDF4C7Q6SI0IPGTXTJN:9HXkVQIiQKw33UEmyBI4rWrzmic=

Modelo de respuesta

    
     
       
       
         HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: BF260000016435722C11379647A8A00A
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSGGDRUM62QZi3hGP8Fz3gOloYCfZ39U
Content-Type: application/xml
Date: Mon, 25 Jun 2018 05:37:12 GMT
Content-Length: 460

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ListAllMyBucketsResult xmlns="http://obs.ap-southeast-1.myhuaweicloud.com/doc/2015-06-30/">
  <Owner>
    <ID>783fc6652cf246c096ea836694f71855</ID>
  </Owner>
  <Buckets>
    <Bucket>
      <Name>examplebucket01</Name>
      <CreationDate>2018-06-21T09:15:01.032Z</CreationDate>
      <Location>region</Location>
      <BucketType>OBJECT</BucketType>
    </Bucket>
    <Bucket>
      <Name>examplebucket02</Name>
      <CreationDate>2018-06-22T03:56:33.700Z</CreationDate>
      <Location>region</Location>
      <BucketType>OBJECT</BucketType>
    </Bucket>
  </Buckets>
</ListAllMyBucketsResult>

        

      

    
   