Tous les produits
Search
Centre de documentation

Object Storage Service:Interroger la capacité de stockage d'un bucket à l'aide du SDK OSS pour Python 2.0

Dernière mise à jour :Sep 25, 2026

Cette rubrique explique comment interroger la capacité de stockage d'un bucket spécifié, ainsi que le nombre et la capacité de stockage des objets pour différentes classes de stockage dans le bucket.

Remarques sur l'utilisation

  • L'exemple de code de cette rubrique utilise l'ID de région cn-hangzhou de la région Chine (Hangzhou). Par défaut, le point de terminaison public est utilisé pour accéder aux ressources d'un bucket. Si vous souhaitez accéder aux ressources du bucket à l'aide d'autres services Alibaba Cloud situés dans la même région que le bucket, utilisez un point de terminaison interne. Pour plus d'informations sur les régions et les points de terminaison pris en charge par OSS, consultez Régions et points de terminaison.

Définition de la méthode

get_bucket_stat(request: GetBucketStatRequest, **kwargs) → GetBucketStatResult

Paramètres de requête

Paramètre

Type

Description

request

GetBucketStatRequest

Les paramètres de la requête. Pour plus d'informations, consultez GetBucketStatRequest

Paramètres de réponse

Type

Description

GetBucketStatResult

Les paramètres de la réponse. Pour plus d'informations, consultez GetBucketStatResult

Pour la définition complète de la méthode, consultez get_bucket_stat.

Exemple de code

Utilisez le code suivant pour interroger la capacité de stockage d'un bucket.

import argparse
import alibabacloud_oss_v2 as oss

# Create a command-line argument parser to describe that this script is used to obtain statistical information about a specified bucket.
parser = argparse.ArgumentParser(description="Get statistical information about a specified OSS bucket.")

# Add the --region command-line argument, which specifies the region where the bucket is located. This argument is required.
parser.add_argument('--region', help='The region in which the bucket is located.', required=True)

# Add the --bucket command-line argument, which specifies the name of the bucket for which to obtain statistics. This argument is required.
parser.add_argument('--bucket', help='The name of the bucket to get statistics for.', required=True)

# Add the --endpoint command-line argument, which specifies the domain name that other services can use to access OSS. This argument is optional.
parser.add_argument('--endpoint', help='The domain names that other services can use to access OSS.')

def main():
    """
    The main function, which is used to parse command-line arguments and obtain statistical information about a specified bucket.
    """

    args = parser.parse_args()  # Parse command-line arguments.

    # Load credentials from environment variables for identity verification.
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

    # Use the default configurations of the SDK and set the credential provider and region information.
    cfg = oss.config.load_default()
    cfg.credentials_provider = credentials_provider
    cfg.region = args.region

    # If the endpoint parameter is provided, set the endpoint in the configuration.
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

    # Create an OSS client using the configured information.
    client = oss.Client(cfg)

    # Construct a request to obtain statistical information about the specified bucket.
    request = oss.GetBucketStatRequest(bucket=args.bucket)

    # Send the request and obtain the response.
    result = client.get_bucket_stat(request)

    # Print the statistical information in the response.
    print(f'status code: {result.status_code},'
          f' request id: {result.request_id},'
          f' storage: {result.storage},'
          f' object count: {result.object_count},'
          f' multi part upload count: {result.multi_part_upload_count},'
          f' live channel count: {result.live_channel_count},'
          f' last modified time: {result.last_modified_time},'
          f' standard storage: {result.standard_storage},'
          f' standard object count: {result.standard_object_count},'
          f' infrequent access storage: {result.infrequent_access_storage},'
          f' infrequent access real storage: {result.infrequent_access_real_storage},'
          f' infrequent access object count: {result.infrequent_access_object_count},'
          f' archive storage: {result.archive_storage},'
          f' archive real storage: {result.archive_real_storage},'
          f' archive object count: {result.archive_object_count},'
          f' cold archive storage: {result.cold_archive_storage},'
          f' cold archive real storage: {result.cold_archive_real_storage},'
          f' cold archive object count: {result.cold_archive_object_count},'
          f' deep cold archive storage: {result.deep_cold_archive_storage},'
          f' deep cold archive real storage: {result.deep_cold_archive_real_storage},'
          f' deep cold archive object count: {result.deep_cold_archive_object_count},'
          f' delete marker count: {result.delete_marker_count},'
    )

if __name__ == "__main__":
    main()  # The script entry point. The main function is called when the file is run directly.

Informations courantes sur la capacité de stockage

Paramètre

Description

Storage

La capacité de stockage totale du bucket. Unité : octets.

ObjectCount

Le nombre total d'objets dans le bucket.

MultipartUploadCount

Le nombre de tâches de chargement multipart initiées mais non terminées ou abandonnées dans le bucket.

LiveChannelCount

Le nombre de LiveChannels dans le bucket.

LastModifiedTime

L'instant auquel les informations de stockage ont été obtenues par cet appel. La valeur est un horodatage UNIX. Unité : secondes.

StandardStorage

La capacité de stockage des objets Standard. Unité : octets.

StandardObjectCount

Le nombre d'objets Standard.

InfrequentAccessStorage

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

InfrequentAccessRealStorage

La capacité de stockage réelle des objets IA. Unité : octets.

InfrequentAccessObjectCount

Le nombre d'objets IA.

ArchiveStorage

La capacité de stockage facturable des objets Archive Storage. Unité : octets.

ArchiveRealStorage

La capacité de stockage réelle des objets Archive Storage. Unité : octets.

ArchiveObjectCount

Le nombre d'objets Archive Storage.

ColdArchiveStorage

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

ColdArchiveRealStorage

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

ColdArchiveObjectCount

Le nombre d'objets Cold Archive.

Références