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-hangzhoude 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
Pour l'exemple de code complet, consultez get_bucket_stat.py.