Lista todos os buckets pertencentes ao solicitante.
Notas de uso
Para listar todos os buckets pertencentes ao solicitante, você deve ter a permissão
oss: ListBuckets(GetService). Para mais informações, consulte Attach a custom policy to a RAM user.Especifique o parâmetro prefix, marker ou max-keys para consultar os buckets que atendem às condições especificadas.
Se o comando retornar todos os buckets, os parâmetros de resposta no formato XML não incluem os elementos de resposta Prefix, Marker, MaxKeys, IsTruncated ou NextMarker.
Sintaxe do comando
ossutil api list-buckets [flags]|
Parâmetro |
Tipo |
Descrição |
|
--marker |
string |
O nome do bucket. |
|
--max-keys |
int |
O número máximo de buckets retornados na solicitação. |
|
--prefix |
string |
O prefixo que os nomes dos buckets a serem retornados devem conter. |
|
--resource-group-id |
string |
O ID do grupo de recursos ao qual o bucket pertence. |
O comando list-buckets corresponde à operação ListBuckets (GetService). Para mais informações sobre os parâmetros da operação ListBuckets (GetService), consulte ListBuckets(GetService).
Para mais informações sobre as opções globais de linha de comando suportadas, consulte Global command-line options.
Exemplos
-
Execute o seguinte comando para listar todos os buckets pertencentes ao solicitante:
ossutil api list-buckets -
Execute o comando abaixo para listar todos os buckets pertencentes ao solicitante e exibi-los no formato JSON:
ossutil api list-buckets --output-format json -
Execute o comando a seguir para listar todos os buckets pertencentes ao solicitante e exibi-los no formato YAML:
ossutil api list-buckets --output-format yaml -
Execute o seguinte comando para listar os buckets pertencentes ao solicitante cujos nomes contêm o prefixo
example:ossutil api list-buckets --prefix example -
Execute o comando abaixo para listar os primeiros 100 buckets pertencentes ao solicitante:
ossutil api list-buckets --max-keys 100 -
Execute o comando a seguir para listar os buckets pertencentes ao solicitante cujos nomes vêm alfabeticamente após examplebucket:
ossutil api list-buckets --marker examplebucket -
Execute o seguinte comando para listar os buckets que pertencem a um grupo de recursos cujo ID é
rg-123:ossutil api list-buckets --resource-group-id rg-123