Todos los productos
Search
Centro de documentos

Object Storage Service:du

Última actualización: Sep 03, 2026

El comando du consulta el tamaño total de todos los objetos dentro de un bucket o directorio.

Notas de uso

  • Para consultar el tamaño total de todas las versiones actuales de los objetos en un bucket o directorio, debe contar con los permisos oss:ListObjects, oss:ListParts y oss:ListMultipartUploads. Para consultar el tamaño total de todas las versiones de los objetos en un bucket o directorio, debe contar con los permisos oss:ListObjectVersions, oss:ListParts y oss:ListMultipartUploads. Para obtener más información, consulte Grant a custom policy.

  • En ossutil 1.6.16 y versiones posteriores, puede usar directamente ossutil como nombre del binario en la línea de comandos. No es necesario actualizar el nombre del binario según el sistema operativo. En versiones de ossutil anteriores a la 1.6.16, debe especificar un nombre de binario que corresponda al sistema operativo. Para obtener más información, consulte ossutil command reference.

Sintaxis del comando

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

A continuación se describen los parámetros y opciones de la sintaxis del comando.

Parámetro/Opción

Descripción

bucketname

Nombre del bucket.

prefix

Directorio o prefijo en los nombres de los objetos.

--payer

Pagador de la solicitud. Si desea que el solicitante que accede a los recursos en la ruta especificada pague por el tráfico y la solicitud, establezca esta opción en requester.

--all-versions

Indica que el comando consulta el tamaño total de todas las versiones de los objetos. Si no especifica esta opción, solo se consulta el tamaño total de las versiones actuales de los objetos.

--block-size

Unidad del tamaño total de los objetos dentro del bucket o directorio especificado. Valores válidos: KB, MB, GB y TB. Si no especifica esta opción, el tamaño de los objetos se mide en bytes.

Importante

Esta opción está disponible en ossutil 1.7.3 y versiones posteriores.

Consulta del tamaño total de todas las versiones de objetos en un bucket

Ejecute el siguiente comando de ejemplo para consultar el tamaño total de todas las versiones de objetos en el bucket examplebucket:

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

La siguiente salida de ejemplo muestra que el bucket contiene un total de 13 objetos (12 objetos Standard y 1 objeto Archive), cuyo tamaño total es de 132,116,024 bytes.

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

Consulta del tamaño total de las versiones actuales de objetos en un directorio

Ejecute el siguiente comando de ejemplo para consultar el tamaño total de las versiones actuales de los objetos en el directorio dir dentro de un bucket llamado examplebucket. El tamaño obtenido se mide en GB.

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

La siguiente salida de ejemplo muestra que el directorio dir en el bucket contiene un total de 5 objetos Standard, cuyo tamaño total es de 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

Consulta del tamaño total de todas las versiones de objetos cuyos nombres contienen un prefijo específico

Ejecute el siguiente comando para consultar el tamaño total de todas las versiones de objetos cuyos nombres contienen el prefijo test en un bucket llamado examplebucket. El tamaño obtenido se mide en KB.

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

La siguiente salida de ejemplo muestra que hay 4 objetos Standard cuyos nombres contienen el prefijo test almacenados en el bucket examplebucket, y que el tamaño total de estos objetos es de 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

Opciones comunes

Para acceder a un bucket en una región diferente, use -e para especificar el endpoint. Para acceder a un bucket propiedad de otra cuenta de Alibaba Cloud, use -i para el AccessKey ID y -k para el AccessKey secret.

Por ejemplo, ejecute el siguiente comando para consultar el tamaño total de todas las versiones de objetos en un bucket llamado testbucket, ubicado en la región China (Shanghai) y propiedad de otra cuenta de Alibaba Cloud:

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

Common options.