Tous les produits
Search

Ce produit

    Object Storage Service:GetBucketStat

    Centre de documentation

    Object Storage Service:GetBucketStat

    Dernière mise à jour :Aug 18, 2026

    Appelez l'opération GetBucketStat pour obtenir la capacité de stockage, le nombre d'objets et le nombre de parties multipart d'un compartiment (bucket) spécifié.

    Notes d'utilisation

    • Pour appeler cette opération, vous devez disposer de l'autorisation oss:GetBucketStat.

    • Les données renvoyées par cette opération ne sont pas en temps réel et peuvent présenter un retard supérieur à une heure.

    • Les informations de stockage renvoyées ne sont pas garanties comme étant les plus récentes. La valeur LastModifiedTime d'une réponse peut être antérieure à celle d'une réponse précédente.

    Syntaxe de la requête

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

    En-têtes de requête

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

    En-têtes de réponse

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

    Éléments de réponse

    Nom

    Type

    Exemple

    Description

    BucketStat

    Container

    N/A

    Conteneur pour la structure BucketStat.

    Storage

    Entier positif

    1600

    Capacité de stockage réelle totale du compartiment. Unité : octets.

    Nœud parent : BucketStat

    Nœud enfant : Aucun

    ObjectCount

    Entier positif

    230

    Nombre total d'objets dans le compartiment.

    Nœud parent : BucketStat

    Nœud enfant : Aucun

    MultipartUploadCount

    Entier positif

    40

    Nombre de chargements multipart initiés mais non terminés ou abandonnés dans le compartiment.

    Nœud parent : BucketStat

    Nœud enfant : Aucun

    LiveChannelCount

    Entier positif

    4

    Nombre de LiveChannels dans le compartiment.

    Nœud parent : BucketStat

    Nœud enfant : Aucun

    MultipartPartCount

    Entier positif

    128

    Nombre de parties multipart téléchargées dans le compartiment.

    Nœud parent : BucketStat

    Nœud enfant : Aucun

    MultipartPartStorage

    Entier positif

    524288000

    Capacité de stockage des parties multipart téléchargées dans le compartiment. Unité : octets.

    Nœud parent : BucketStat

    Nœud enfant : Aucun

    DeleteMarkerCount

    Entier positif

    12

    Nombre de marqueurs de suppression dans le compartiment.

    Nœud parent : BucketStat

    Nœud enfant : Aucun

    LastModifiedTime

    Entier positif

    1643341269

    Horodatage des informations de stockage obtenues. La valeur est un horodatage UNIX en secondes.

    Nœud parent : BucketStat

    Nœud enfant : Aucun

    StandardStorage

    Entier positif

    430

    Capacité de stockage des objets Standard. Unité : octets.

    Nœud parent : BucketStat

    Nœud enfant : Aucun

    StandardObjectCount

    Entier positif

    66

    Nombre d'objets Standard.

    Nœud parent : BucketStat

    Nœud enfant : Aucun

    StandardMultipartPartCount

    Entier positif

    10

    Nombre de parties multipart Standard téléchargées dans le compartiment.

    Nœud parent : BucketStat

    Nœud enfant : Aucun

    StandardMultipartPartStorage

    Entier positif

    104857600

    Capacité de stockage des parties multipart Standard téléchargées dans le compartiment. Unité : octets.

    Nœud parent : BucketStat

    Nœud enfant : Aucun

    InfrequentAccessStorage

    Entier positif

    2359296

    Capacité de stockage facturable des objets Infrequent Access (IA). Unité : octets.

    Important

    Un objet de moins de 64 Ko est comptabilisé comme 64 Ko. Pour plus d'informations sur la facturation, consultez la section Frais de stockage.

    Nœud parent : BucketStat

    Nœud enfant : Aucun

    InfrequentAccessRealStorage

    Entier positif

    360

    Quantité réelle de stockage utilisée par la classe de stockage Infrequent Access, en octets.

    Nœud parent : BucketStat

    Nœud enfant : Aucun

    InfrequentAccessObjectCount

    Entier positif

    54

    Nombre d'objets IA.

    Nœud parent : BucketStat

    Nœud enfant : Aucun

    InfrequentMultipartPartCount

    Entier positif

    10

    Nombre de parties multipart IA téléchargées dans le compartiment.

    Nœud parent : BucketStat

    Nœud enfant : Aucun

    InfrequentMultipartPartStorage

    Entier positif

    104857600

    Capacité de stockage des parties multipart IA téléchargées dans le compartiment. Unité : octets.

    Nœud parent : BucketStat

    Nœud enfant : Aucun

    ArchiveStorage

    Entier positif

    2949120

    Capacité de stockage facturable des objets Archive. Unité : octets.

    Important

    Un objet de moins de 64 Ko est comptabilisé comme 64 Ko. Pour plus d'informations sur la facturation, consultez la section Frais de stockage.

    Nœud parent : BucketStat

    Nœud enfant : Aucun

    ArchiveRealStorage

    Entier positif

    450

    Capacité de stockage réelle des objets Archive. Unité : octets.

    Nœud parent : BucketStat

    Nœud enfant : Aucun

    ArchiveObjectCount

    Entier positif

    74

    Nombre d'objets Archive.

    Nœud parent : BucketStat

    Nœud enfant : Aucun

    ArchiveMultipartPartCount

    Entier positif

    10

    Nombre de parties multipart Archive téléchargées dans le compartiment.

    Nœud parent : BucketStat

    Nœud enfant : Aucun

    ArchiveMultipartPartStorage

    Entier positif

    104857600

    Capacité de stockage des parties multipart Archive téléchargées dans le compartiment. Unité : octets.

    Nœud parent : BucketStat

    Nœud enfant : Aucun

    ColdArchiveStorage

    Entier positif

    2359296

    Capacité de stockage facturable des objets Cold Archive. Unité : octets.

    Important

    Un objet de moins de 64 Ko est comptabilisé comme 64 Ko. Pour plus d'informations sur la facturation, consultez la section Frais de stockage.

    Nœud parent : BucketStat

    Nœud enfant : Aucun

    ColdArchiveRealStorage

    Entier positif

    360

    Capacité de stockage réelle des objets Cold Archive. Unité : octets.

    Nœud parent : BucketStat

    Nœud enfant : Aucun

    ColdArchiveObjectCount

    Entier positif

    36

    Nombre d'objets Cold Archive.

    Nœud parent : BucketStat

    Nœud enfant : Aucun

    ColdArchiveMultipartPartCount

    Entier positif

    10

    Nombre de parties multipart Cold Archive téléchargées dans le compartiment.

    Nœud parent : BucketStat

    Nœud enfant : Aucun

    ColdArchiveMultipartPartStorage

    Entier positif

    104857600

    Capacité de stockage des parties multipart Cold Archive téléchargées dans le compartiment. Unité : octets.

    Nœud parent : BucketStat

    Nœud enfant : Aucun

    DeepColdArchiveStorage

    Entier positif

    2359296

    Capacité de stockage facturable des objets Deep Cold Archive. Unité : octets.

    Important

    Un objet de moins de 64 Ko est comptabilisé comme 64 Ko. Pour plus d'informations sur la facturation, consultez la section Frais de stockage.

    Nœud parent : BucketStat

    Nœud enfant : Aucun

    DeepColdArchiveRealStorage

    Entier positif

    360

    Capacité de stockage réelle des objets Deep Cold Archive. Unité : octets.

    Nœud parent : BucketStat

    Nœud enfant : Aucun

    DeepColdArchiveObjectCount

    Entier positif

    36

    Nombre d'objets Deep Cold Archive.

    Nœud parent : BucketStat

    Nœud enfant : Aucun

    DeepColdArchiveMultipartPartCount

    Entier positif

    10

    Nombre de parties multipart Deep Cold Archive téléchargées dans le compartiment.

    Nœud parent : BucketStat

    Nœud enfant : Aucun

    DeepColdArchiveMultipartPartStorage

    Entier positif

    104857600

    Capacité de stockage des parties multipart Deep Cold Archive téléchargées dans le compartiment. Unité : octets.

    Nœud parent : BucketStat

    Nœud enfant : Aucun

    Exemples

    • Exemple de requête

      GET /?stat HTTP/1.1
Host: examplebucket.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 17 Apr 2025 01:17:29 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

    • Exemple de réponse

      <?xml version="1.0" encoding="UTF-8"?>
<BucketStat>
  <Storage>1600</Storage>
  <ObjectCount>230</ObjectCount>
  <MultipartUploadCount>40</MultipartUploadCount>
  <LiveChannelCount>4</LiveChannelCount>
  <LastModifiedTime>1643341269</LastModifiedTime>
  <StandardStorage>430</StandardStorage>
  <StandardObjectCount>66</StandardObjectCount>
  <InfrequentAccessStorage>2359296</InfrequentAccessStorage>
  <InfrequentAccessRealStorage>360</InfrequentAccessRealStorage>
  <InfrequentAccessObjectCount>54</InfrequentAccessObjectCount>
  <ArchiveStorage>2949120</ArchiveStorage>
  <ArchiveRealStorage>450</ArchiveRealStorage>
  <ArchiveObjectCount>74</ArchiveObjectCount>
  <ColdArchiveStorage>2359296</ColdArchiveStorage>
  <ColdArchiveRealStorage>360</ColdArchiveRealStorage>
  <ColdArchiveObjectCount>36</ColdArchiveObjectCount>
</BucketStat>

    SDK

    Les kits de développement logiciel (SDK) suivants sont disponibles pour cette opération :

    Outil de ligne de commande ossutil

    Pour plus d'informations sur la commande ossutil pour l'opération GetBucketStat, consultez la section get-bucket-stat.

    Codes d'erreur

    Code d'erreur

    Code d'état HTTP

    Description

    AccessDenied

    403

    Vous ne disposez pas de l'autorisation nécessaire pour consulter les informations de capacité de stockage du compartiment. Seul le propriétaire du compartiment peut accéder à ces informations.