O comando du consulta o tamanho total de todos os objetos dentro de um bucket ou diretório.
Notas de uso
Para consultar o tamanho total de todas as versões atuais dos objetos em um bucket ou diretório, é necessário ter as permissões
oss:ListObjects,oss:ListPartseoss:ListMultipartUploads. Já para consultar o tamanho total de todas as versões dos objetos em um bucket ou diretório, são necessárias as permissõesoss:ListObjectVersions,oss:ListPartseoss:ListMultipartUploads. Para mais informações, consulte Grant a custom policy.A partir do ossutil 1.6.16, use diretamente ossutil como nome do binário na linha de comando e não atualize o nome do binário com base no sistema operacional. Para versões do ossutil anteriores à 1.6.16, especifique um nome de binário que corresponda ao sistema operacional. Para mais informações, consulte ossutil command reference.
Sintaxe do comando
ossutil du oss://bucketname[/prefix] [--payer requester] [--all-versions][--block-size <value>]
A tabela a seguir descreve os parâmetros e opções na sintaxe do comando.
|
Parâmetro/Opção |
Descrição |
|
bucketname |
O nome do bucket. |
|
prefix |
O diretório ou prefixo nos nomes dos objetos. |
|
--payer |
O pagador da solicitação. Se você deseja que o solicitante que acessa os recursos no caminho especificado pague pelo tráfego e pela solicitação, defina esta opção como requester. |
|
--all-versions |
Indica que o comando deve consultar o tamanho total de todas as versões dos objetos. Caso não especifique esta opção, o sistema consulta apenas o tamanho total das versões atuais dos objetos. |
|
--block-size |
Define a unidade de medida para o tamanho total dos objetos no bucket ou diretório especificado. Valores válidos: KB, MB, GB e TB. Se você não especificar esta opção, o tamanho dos objetos será medido em bytes. Importante
Esta opção está disponível para o ossutil 1.7.3 e versões posteriores. |
Consultar o tamanho total de todas as versões dos objetos em um bucket
Execute o seguinte comando de exemplo para consultar o tamanho total de todas as versões dos objetos no bucket examplebucket:
ossutil du oss://examplebucket --all-versions
A saída de exemplo a seguir mostra que o bucket contém um total de 13 objetos (12 objetos Standard e 1 objeto Archive), cujo tamanho total é 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
Consultar o tamanho total das versões atuais dos objetos em um diretório
Execute o seguinte comando de exemplo para consultar o tamanho total das versões atuais dos objetos no diretório dir em um bucket chamado examplebucket. O tamanho obtido é medido em GB.
ossutil du oss://examplebucket/dir/ --block-size GB
A saída de exemplo a seguir mostra que o diretório dir no bucket contém um total de 5 objetos Standard, cujo tamanho total é 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
Consultar o tamanho total de todas as versões dos objetos cujos nomes contêm um prefixo específico
Execute o seguinte comando para consultar o tamanho total de todas as versões dos objetos cujos nomes contêm o prefixo test em um bucket chamado examplebucket. O tamanho obtido é medido em KB.
ossutil du oss://examplebucket/test --all-versions --block-size KB
A saída de exemplo a seguir mostra que 4 objetos Standard cujos nomes contêm o prefixo test estão armazenados no bucket examplebucket e que o tamanho total desses objetos é 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
Opções comuns
Para acessar um bucket em uma região diferente, especifique o endpoint usando -e. Para acessar um bucket pertencente a uma conta Alibaba Cloud diferente, use -i para o AccessKeyID e -k para o AccessKeySecret.
Por exemplo, execute o seguinte comando para consultar o tamanho total de todas as versões dos objetos em um bucket chamado testbucket, que está localizado na região China (Shanghai) e pertence a outra conta Alibaba Cloud:
ossutil du oss://testbucket --all-versions -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret