Tous les produits
Search
Centre de documentation

Object Storage Service:du

Dernière mise à jour :Aug 18, 2026

La commande du calcule la taille totale de tous les objets contenus dans un bucket ou un répertoire.

Remarques

  • Pour calculer la taille totale de toutes les versions actuelles des objets d'un bucket ou d'un répertoire, vous devez disposer des autorisations oss:ListObjects, oss:ListParts et oss:ListMultipartUploads. Pour calculer la taille totale de toutes les versions des objets d'un bucket ou d'un répertoire, vous devez disposer des autorisations oss:ListObjectVersions, oss:ListParts et oss:ListMultipartUploads. Pour plus d'informations, consultez la rubrique Accorder une stratégie personnalisée.

  • À partir de la version 1.6.16 d'ossutil, utilisez directement ossutil comme nom binaire dans la ligne de commande. Il n'est pas nécessaire d'adapter le nom binaire en fonction du système d'exploitation. Pour les versions antérieures à la 1.6.16, spécifiez un nom binaire correspondant au système d'exploitation. Pour plus d'informations, consultez la rubrique Prise en main rapide de l'outil de ligne de commande ossutil.

Syntaxe de la commande

ossutil du oss://bucketname[/prefix] [--payer requester] [--all-versions][--block-size <value>]

Le tableau suivant décrit les paramètres et options de la syntaxe de commande.

Paramètre/Option

Description

bucketname

Nom du bucket.

prefix

Répertoire ou préfixe figurant dans les noms des objets.

--payer

Entité qui règle la requête. Si vous souhaitez que le demandeur accédant aux ressources du chemin spécifié prenne en charge le trafic et la requête, définissez cette option sur requester.

--all-versions

Indique que la commande calcule la taille totale de toutes les versions des objets. Si vous omettez cette option, seule la taille totale des versions actuelles des objets est calculée.

--block-size

Unité de mesure de la taille totale des objets dans le bucket ou le répertoire spécifié. Valeurs possibles : KB, MB, GB et TB. Si vous omettez cette option, la taille des objets est exprimée en octets.

Important

Cette option est disponible à partir de la version 1.7.3 d'ossutil.

Calculer la taille totale de toutes les versions des objets d'un bucket

Exécutez la commande suivante pour calculer la taille totale de toutes les versions des objets du bucket examplebucket :

ossutil du oss://examplebucket --all-versions

L'exemple de sortie ci-dessous indique que le bucket contient un total de 13 objets (12 objets Standard et 1 objet Archive), dont la taille totale s'élève à 132 116 024 octets.

storage class   object count            sum size(byte)
----------------------------------------------------------
Standard        12                       132115210
Archive         1                        814
----------------------------------------------------------
total object count: 13                          total object sum size: 132116024
total part count:   0                           total part sum size:   0

total du size(byte):132116024

0.382978(s) elapsed

Calculer la taille totale des versions actuelles des objets d'un répertoire

Exécutez la commande suivante pour calculer la taille totale des versions actuelles des objets du répertoire dir dans le bucket examplebucket. La taille obtenue est exprimée en GB.

ossutil du oss://examplebucket/dir/  --block-size GB

L'exemple de sortie ci-dessous indique que le répertoire dir du bucket contient un total de 5 objets Standard, dont la taille totale s'élève à 0,0002 GB.

storage class   object count            sum size(byte)
----------------------------------------------------------
Standard        5                       232277
----------------------------------------------------------
total object count: 5                           total object sum size: 232277
total part count:   0                           total part sum size:   0

total du size(GB):0.0002

0.078757(s) elapsed

Calculer la taille totale de toutes les versions des objets dont le nom contient un préfixe spécifique

Exécutez la commande suivante pour calculer la taille totale de toutes les versions des objets dont le nom contient le préfixe test dans le bucket examplebucket. La taille obtenue est exprimée en KB.

ossutil du oss://examplebucket/test --all-versions --block-size KB

L'exemple de sortie ci-dessous indique que 4 objets Standard dont le nom contient le préfixe test sont stockés dans le bucket examplebucket et que la taille totale de ces objets s'élève à 448,1455 KB.

storage class   object count            sum size(byte)
----------------------------------------------------------
Standard        4                       439425
----------------------------------------------------------
total object count: 4                           total object sum size: 439425
total part count:   0                           total part sum size:   0

total du size(KB):448.1455

0.126340(s) elapsed

Options courantes

Pour accéder à un bucket situé dans une autre région, utilisez -e pour spécifier l'endpoint. Pour accéder à un bucket appartenant à un autre compte Alibaba Cloud, utilisez -i pour l'AccessKey ID et -k pour l'AccessKey Secret.

Par exemple, exécutez la commande suivante pour calculer la taille totale de toutes les versions des objets du bucket testbucket, situé dans la région Chine (Shanghai) et appartenant à un autre compte Alibaba Cloud :

ossutil du oss://testbucket --all-versions -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

Options courantes.