Tous les produits
Search

Ce produit

    Object Storage Service:GetBucketInfo

    Centre de documentation

    Object Storage Service:GetBucketInfo

    Dernière mise à jour :Sep 22, 2026

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

    Notes d'utilisation

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

    • Par défaut, un compte Alibaba Cloud dispose de l'autorisation nécessaire pour consulter les informations du bucket. Si vous souhaitez utiliser un utilisateur RAM (Resource Access Management) ou le service STS (Security Token Service) pour accéder à ces informations, vous devez disposer de l'autorisation oss:GetBucketInfo. Pour plus d'informations, consultez la rubrique Attacher une stratégie 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

    L'opération DescribeRegions utilise uniquement les en-têtes de requête communs. Pour plus d'informations, consultez la rubrique En-têtes de requête communs.

    En-têtes de réponse

    La réponse contient uniquement les en-têtes de réponse communs. Pour plus d'informations, consultez la rubrique En-têtes de réponse communs.

    É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 et heure de création du bucket, exprimées au format 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 dans laquelle se trouve le bucket. La valeur correspond à l'ID de région OSS.

    Nœud parent : BucketInfo.Bucket

    StorageClass

    String

    Standard

    Classe de stockage du bucket.

    Valeurs possibles : Standard, IA, Archive et ColdArchive.

    Pour plus d'informations sur les classes de stockage, consultez la rubrique 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 appartient au groupe de ressources par défaut, la valeur de ce paramètre est 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 la rubrique ACL de bucket.

    Nœud parent : BucketInfo.Bucket

    Grant

    Enumeration

    private

    ACL du bucket.

    Valeurs possibles : 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 possibles : LRS et ZRS.

    Nœud parent : BucketInfo.Bucket

    Versioning

    String

    Enabled

    État du versioning du bucket.

    Valeurs possibles : Enabled et Suspended.

    Pour plus d'informations sur les états de versioning, consultez la rubrique 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 la rubrique Chiffrement côté serveur.

    Nœud parent : BucketInfo.Bucket

    SSEAlgorithm

    String

    KMS

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

    Valeurs possibles : KMS et AES256.

    Nœud parent : BucketInfo.Bucket.ServerSideEncryptionRule

    KMSMasterKeyID

    String

    ID de la clé KMS utilisée. Ce paramètre est renvoyé uniquement 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 inter-régions (CRR) du bucket.

    Valeurs possibles : Enabled et Disabled.

    Nœud parent : BucketInfo.Bucket

    TransferAcceleration

    String

    Disabled

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

    Valeurs possibles : Enabled et Disabled.

    Nœud parent : BucketInfo.Bucket

    HierarchicalNamespace

    String

    Enabled

    État de l'espace de noms hiérarchique du bucket.

    Valeur possible : Enabled.

    Nœud parent : BucketInfo.Bucket

    AccessMonitor

    String

    Enabled

    État du suivi d'accès du bucket.

    Valeurs possibles : 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 qui stocke les 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 de Block Public Access pour le bucket.

    • true : Block Public Access est activé.

    • false : Block Public Access 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

    • Exemple de réponse pour 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>

    • Exemple de réponse 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>

    • Exemple de réponse pour une 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

    Utilisez les SDK pour les langages de programmation suivants afin d'appeler cette opération :

    Outil de ligne de commande ossutil

    Pour plus d'informations sur la commande ossutil correspondant à cette opération, consultez la rubrique 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 y accéder.