Tous les produits
Search

Ce produit

    Object Storage Service:GetBucketInfo

    Centre de documentation

    Object Storage Service:GetBucketInfo

    Dernière mise à jour :Aug 18, 2026

    Appelez l'opération GetBucketInfo pour consulter les informations d'un bucket.

    Remarques sur l'utilisation

    • Vous pouvez envoyer cette requête depuis n'importe quel endpoint Object Storage Service (OSS).

    • Par défaut, un compte Alibaba Cloud dispose des autorisations nécessaires pour consulter les informations d'un bucket. Pour qu'un utilisateur Resource Access Management (RAM) ou Security Token Service (STS) puisse accéder à ces informations, il doit posséder l'autorisation oss:GetBucketInfo. Pour plus d'informations, consultez Attacher une politique personnalisée à un utilisateur RAM.

    Syntaxe de la requête

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

    En-têtes de requête

    DescribeRegions utilise uniquement des en-têtes de requête courants. Pour plus d'informations, consultez En-têtes de requête courants.

    En-têtes de réponse

    La réponse ne contient que des en-têtes de réponse courants. Pour plus d'informations, consultez En-têtes de réponse courants.

    Éléments de réponse

    Nom

    Type

    Exemple

    Description

    BucketInfo

    Container

    N/A

    Conteneur des informations du bucket.

    Nœud enfant : Bucket

    Nœud parent : Aucun

    Bucket

    Container

    N/A

    Conteneur des informations du bucket.

    Nœud parent : BucketInfo

    CreationDate

    Time

    2013-07-31T10:56:21.000Z

    Date de création du bucket, exprimée en UTC.

    Nœud parent : BucketInfo.Bucket

    ExtranetEndpoint

    String

    oss-cn-hangzhou.aliyuncs.com

    Endpoint public.

    Nœud parent : BucketInfo.Bucket

    IntranetEndpoint

    String

    oss-cn-hangzhou-internal.aliyuncs.com

    Endpoint interne.

    Nœud parent : BucketInfo.Bucket

    Location

    String

    oss-cn-hangzhou

    Région où se trouve le bucket. Cette valeur correspond à l'ID de région pour OSS.

    Nœud parent : BucketInfo.Bucket

    StorageClass

    String

    Standard

    Classe de stockage du bucket.

    Valeurs valides : Standard, IA, Archive et ColdArchive.

    Pour plus d'informations sur les classes de stockage, consultez Classes de stockage.

    Name

    String

    oss-example

    Nom du bucket.

    Nœud parent : BucketInfo.Bucket

    ResourceGroupId

    String

    rg-aek27tc****

    ID du groupe de ressources auquel appartient le bucket.

    Si le bucket fait partie du groupe de ressources par défaut, ce paramètre prend la valeur rg-default-id.

    Nœud parent : BucketInfo.Bucket

    Owner

    Container

    N/A

    Conteneur des informations relatives au propriétaire du bucket.

    Nœud parent : BucketInfo.Bucket

    ID

    String

    27183473914****

    ID utilisateur du propriétaire du bucket.

    Nœud parent : BucketInfo.Bucket.Owner

    DisplayName

    String

    username

    Nom du propriétaire du bucket. Ce paramètre a la même valeur que l'ID.

    Nœud parent : BucketInfo.Bucket.Owner

    AccessControlList

    Container

    N/A

    Conteneur de la liste de contrôle d'accès (ACL) du bucket.

    Pour plus d'informations sur les ACL de bucket, consultez ACL de bucket.

    Nœud parent : BucketInfo.Bucket

    Grant

    Enumeration

    private

    ACL du bucket.

    Valeurs valides : private, public-read et public-read-write.

    Nœud parent : BucketInfo.Bucket.AccessControlList

    DataRedundancyType

    Enumeration

    LRS

    Type de redondance des données du bucket.

    Valeurs valides : LRS et ZRS.

    Nœud parent : BucketInfo.Bucket

    Versioning

    String

    Enabled

    État du versionnage du bucket.

    Valeurs valides : Enabled et Suspended.

    Pour plus d'informations sur les états de versionnage, consultez PutBucketVersioning.

    Nœud parent : BucketInfo.Bucket

    ServerSideEncryptionRule

    Container

    N/A

    Conteneur des règles de chiffrement côté serveur.

    Pour plus d'informations sur le chiffrement côté serveur, consultez Chiffrement côté serveur.

    Nœud parent : BucketInfo.Bucket

    SSEAlgorithm

    String

    KMS

    Méthode de chiffrement côté serveur par défaut.

    Valeurs valides : KMS et AES256.

    Nœud parent : BucketInfo.Bucket.ServerSideEncryptionRule

    KMSMasterKeyID

    String

    ID de la clé KMS utilisée. Ce paramètre n'est retourné que si SSEAlgorithm est défini sur KMS et qu'un ID de clé est spécifié. Dans le cas contraire, ce paramètre est vide.

    Nœud parent : BucketInfo.Bucket.ServerSideEncryptionRule

    KMSDataEncryption

    String

    SM4

    Algorithme de chiffrement de l'objet. Si ce paramètre n'est pas spécifié, AES-256 est utilisé. Ce paramètre est valide uniquement lorsque SSEAlgorithm est défini sur KMS.

    Nœud parent : BucketInfo.Bucket.ServerSideEncryptionRule

    CrossRegionReplication

    String

    Disabled

    État de la réplication interrégionale (CRR) du bucket.

    Valeurs valides : Enabled et Disabled.

    Nœud parent : BucketInfo.Bucket

    TransferAcceleration

    String

    Disabled

    État de l'accélération de transfert du bucket.

    Valeurs valides : Enabled et Disabled.

    Nœud parent : BucketInfo.Bucket

    HierarchicalNamespace

    String

    Enabled

    État du namespace hiérarchique du bucket.

    Valeur valide : Enabled.

    Nœud parent : BucketInfo.Bucket

    AccessMonitor

    String

    Enabled

    État du suivi des accès du bucket.

    Valeurs valides : Enabled et Disabled.

    Nœud parent : BucketInfo.Bucket

    BucketPolicy

    Container

    N/A

    Conteneur des informations de journalisation.

    Nœud parent : BucketInfo.Bucket

    LogBucket

    String

    examplebucket

    Nom du bucket stockant les enregistrements de journaux.

    Nœud parent : BucketInfo.Bucket.BucketPolicy

    LogPrefix

    String

    log/

    Répertoire de stockage des fichiers journaux.

    Nœud parent : BucketInfo.Bucket.BucketPolicy

    BlockPublicAccess

    Boolean

    true

    Configuration du blocage de l'accès public pour le bucket.

    • true : le blocage de l'accès public est activé.

    • false : le blocage de l'accès public est désactivé.

    Exemples

    Exemple de requête

    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

    Exemples de réponses

    • Réponse type d'une requête réussie

      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>

    • Réponse type pour un bucket inexistant

      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>

    • Réponse type en cas d'erreur d'accès refusé

      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

    Vous pouvez utiliser les SDK des langages de programmation suivants pour appeler cette opération :

    Outil en ligne de commande ossutil

    Pour plus d'informations sur la commande ossutil correspondant à cette opération, consultez get-bucket-info.

    Codes d'erreur

    Code d'erreur

    Code d'état HTTP

    Description

    NoSuchBucket

    404

    Le bucket spécifié n'existe pas.

    AccessDenied

    403

    Vous ne disposez pas des autorisations nécessaires pour consulter les informations du bucket. Seul le propriétaire du bucket peut accéder à ces informations.