Todos los productos
Search

Este producto

    Object Storage Service:GetBucketInfo

    Centro de documentos

    Object Storage Service:GetBucketInfo

    Última actualización: Sep 22, 2026

    Llame a la operación GetBucketInfo para consultar la información de un bucket.

    Notas de uso

    • Puede enviar esta solicitud desde cualquier endpoint de Object Storage Service (OSS).

    • De forma predeterminada, una cuenta de Alibaba Cloud tiene el permiso para consultar la información del bucket. Si desea usar un usuario de Resource Access Management (RAM) o Security Token Service (STS) para consultar esta información, debe contar con el permiso oss:GetBucketInfo. Para obtener más información, consulte Attach a custom policy to a RAM user.

    Sintaxis de la solicitud

    GET /?bucketInfo HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

    Encabezados de la solicitud

    DescribeRegions usa únicamente los encabezados de solicitud comunes. Para obtener más información, consulte Common request headers.

    Encabezados de la respuesta

    La respuesta contiene únicamente los encabezados de respuesta comunes. Para obtener más información, consulte Common response headers.

    Elementos de la respuesta

    Nombre

    Tipo

    Ejemplo

    Descripción

    BucketInfo

    Contenedor

    Ninguna

    Contenedor que almacena la información del bucket.

    Nodo secundario: Bucket

    Nodo principal: Ninguno

    Bucket

    Contenedor

    Ninguna

    Contenedor que almacena la información del bucket.

    Nodo principal: BucketInfo

    CreationDate

    Hora

    2013-07-31T10:56:21.000Z

    Fecha y hora de creación del bucket, expresadas en UTC.

    Nodo principal: BucketInfo.Bucket

    ExtranetEndpoint

    Cadena

    oss-cn-hangzhou.aliyuncs.com

    Endpoint público.

    Nodo principal: BucketInfo.Bucket

    IntranetEndpoint

    Cadena

    oss-cn-hangzhou-internal.aliyuncs.com

    Endpoint interno.

    Nodo principal: BucketInfo.Bucket

    Location

    Cadena

    oss-cn-hangzhou

    Región donde se encuentra el bucket. El valor corresponde al identificador de región de OSS.

    Nodo principal: BucketInfo.Bucket

    StorageClass

    Cadena

    Standard

    Clase de almacenamiento del bucket.

    Valores válidos: Standard, IA, Archive y ColdArchive.

    Para obtener más información sobre las clases de almacenamiento, consulte Storage classes.

    Name

    Cadena

    oss-example

    Nombre del bucket.

    Nodo principal: BucketInfo.Bucket

    ResourceGroupId

    Cadena

    rg-aek27tc****

    Identificador del resource group al que pertenece el bucket.

    Si el bucket pertenece al resource group predeterminado, el valor de este parámetro es rg-default-id.

    Nodo principal: BucketInfo.Bucket

    Owner

    Contenedor

    Ninguna

    Contenedor con la información del propietario del bucket.

    Nodo principal: BucketInfo.Bucket

    ID

    Cadena

    27183473914****

    Identificador de usuario del propietario del bucket.

    Nodo principal: BucketInfo.Bucket.Owner

    DisplayName

    Cadena

    username

    Nombre del propietario del bucket. Este parámetro tiene el mismo valor que ID.

    Nodo principal: BucketInfo.Bucket.Owner

    AccessControlList

    Contenedor

    Ninguna

    Contenedor de la lista de control de acceso (ACL) del bucket.

    Para obtener más información sobre las ACL de los buckets, consulte Bucket ACL.

    Nodo principal: BucketInfo.Bucket

    Grant

    Enumeración

    private

    ACL del bucket.

    Valores válidos: private, public-read y public-read-write.

    Nodo principal: BucketInfo.Bucket.AccessControlList

    DataRedundancyType

    Enumeración

    LRS

    Tipo de redundancia de datos del bucket.

    Valores válidos: LRS y ZRS.

    Nodo principal: BucketInfo.Bucket

    Versioning

    Cadena

    Enabled

    Estado de control de versiones del bucket.

    Valores válidos: Enabled y Suspended.

    Para obtener más información sobre los estados de control de versiones, consulte PutBucketVersioning.

    Nodo principal: BucketInfo.Bucket

    ServerSideEncryptionRule

    Contenedor

    Ninguna

    Contenedor de las reglas de cifrado del lado del servidor.

    Para obtener más información sobre el cifrado del lado del servidor, consulte Server-side encryption.

    Nodo principal: BucketInfo.Bucket

    SSEAlgorithm

    Cadena

    KMS

    Método de cifrado del lado del servidor predeterminado.

    Valores válidos: KMS y AES256.

    Nodo principal: BucketInfo.Bucket.ServerSideEncryptionRule

    KMSMasterKeyID

    Cadena

    Identificador de la clave de KMS en uso. Este parámetro se devuelve únicamente si SSEAlgorithm se establece en KMS y se especifica un identificador de clave. De lo contrario, queda vacío.

    Nodo principal: BucketInfo.Bucket.ServerSideEncryptionRule

    KMSDataEncryption

    Cadena

    SM4

    Algoritmo de cifrado del objeto. Si no se especifica este parámetro, se utiliza AES-256. Solo es válido cuando SSEAlgorithm se establece en KMS.

    Nodo principal: BucketInfo.Bucket.ServerSideEncryptionRule

    CrossRegionReplication

    Cadena

    Disabled

    Estado de cross-region replication (CRR) del bucket.

    Valores válidos: Enabled y Disabled.

    Nodo principal: BucketInfo.Bucket

    TransferAcceleration

    Cadena

    Disabled

    Estado de aceleración de transferencia del bucket.

    Valores válidos: Enabled y Disabled.

    Nodo principal: BucketInfo.Bucket

    HierarchicalNamespace

    Cadena

    Enabled

    Estado del espacio de nombres jerárquico del bucket.

    Valor válido: Enabled.

    Nodo principal: BucketInfo.Bucket

    AccessMonitor

    Cadena

    Enabled

    Estado de seguimiento de accesos del bucket.

    Valores válidos: Enabled y Disabled.

    Nodo principal: BucketInfo.Bucket

    BucketPolicy

    Contenedor

    Ninguna

    Contenedor de la información de registros.

    Nodo principal: BucketInfo.Bucket

    LogBucket

    Cadena

    examplebucket

    Nombre del bucket que almacena los registros.

    Nodo principal: BucketInfo.Bucket.BucketPolicy

    LogPrefix

    Cadena

    log/

    Directorio donde se almacenan los archivos de registro.

    Nodo principal: BucketInfo.Bucket.BucketPolicy

    BlockPublicAccess

    Booleano

    true

    Configuración de Block Public Access del bucket.

    • true: Block Public Access está habilitado.

    • false: Block Public Access está deshabilitado.

    Ejemplos

    Ejemplo de solicitud

    Get /?bucketInfo HTTP/1.1
Host: examplebucket.oss-cn-hangzhou.aliyuncs.com  
Date: Thu, 17 Apr 2025 07:51:28 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

    Ejemplos de respuestas

    • Ejemplo de respuesta de una solicitud exitosa

      HTTP/1.1 200
x-oss-request-id: 534B371674E88A4D8906****
Date: Sat, 12 Sep 2015 07:51:28 GMT
Connection: keep-alive
Content-Length: 531  
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<BucketInfo>
  <Bucket>
    <CreationDate>2013-07-31T10:56:21.000Z</CreationDate>
    <ExtranetEndpoint>oss-cn-hangzhou.aliyuncs.com</ExtranetEndpoint>
    <IntranetEndpoint>oss-cn-hangzhou-internal.aliyuncs.com</IntranetEndpoint>
    <Location>oss-cn-hangzhou</Location>
    <StorageClass>Standard</StorageClass>
    <TransferAcceleration>Disabled</TransferAcceleration>
    <CrossRegionReplication>Disabled</CrossRegionReplication>
    <HierarchicalNamespace>Enabled</HierarchicalNamespace>
    <Name>oss-example</Name>
    <ResourceGroupId>rg-aek27tc********</ResourceGroupId>
    <Owner>
      <DisplayName>username</DisplayName>
      <ID>27183473914****</ID>
    </Owner>
    <AccessControlList>
      <Grant>private</Grant>
    </AccessControlList>  
    <Comment>test</Comment>
    <BucketPolicy>
      <LogBucket>examplebucket</LogBucket>
      <LogPrefix>log/</LogPrefix>
    </BucketPolicy>
  </Bucket>
</BucketInfo>

    • Ejemplo de respuesta cuando el bucket no existe

      HTTP/1.1 404 
x-oss-request-id: 534B371674E88A4D8906****
Date: Sat, 12 Sep 2015 07:51:28 GMT
Connection: keep-alive
Content-Length: 308  
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<Error>
  <Code>NoSuchBucket</Code>
  <Message>The specified bucket does not exist.</Message>
  <RequestId>568D547F31243C673BA1****</RequestId>
  <HostId>nosuchbucket.oss.aliyuncs.com</HostId>
  <BucketName>nosuchbucket</BucketName>
  <EC>0015-00000101</EC>
</Error>

    • Ejemplo de respuesta ante un error de acceso denegado

      HTTP/1.1 403
x-oss-request-id: 534B371674E88A4D8906****
Date: Sat, 12 Sep 2015 07:51:28 GMT
Connection: keep-alive
Content-Length: 209  
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<Error>
  <Code>AccessDenied</Code>
  <Message>AccessDenied</Message>
  <RequestId>568D5566F2D0F89F5C0E****</RequestId>
  <HostId>test.oss.aliyuncs.com</HostId>
</Error>

    SDK

    Use los SDK de los siguientes lenguajes de programación para llamar a esta operación:

    Herramienta de línea de comandos ossutil

    Para obtener más información sobre el comando de ossutil correspondiente a esta operación, consulte get-bucket-info.

    Códigos de error

    Código de error

    Código de estado HTTP

    Descripción

    NoSuchBucket

    404

    El bucket especificado no existe.

    AccessDenied

    403

    No cuenta con los permisos necesarios para consultar la información del bucket. Solo el propietario puede consultarla.