Lista todos os buckets pertencentes ao solicitante.
Observações de uso
Para listar todos os buckets pertencentes ao solicitante, você deve ter a permissão
oss: ListBuckets(GetService). Para mais informações, consulte Anexar uma política personalizada a um usuário do RAM.Especifique o parâmetro prefix, marker ou max-keys para consultar os buckets que atendem às condições definidas.
Se a execução do comando retornar todos os buckets, os parâmetros de resposta no formato XML não incluirão os elementos Prefix, Marker, MaxKeys, IsTruncated ou NextMarker.
Sintaxe do comando
ossutil api list-buckets [flags]|
Parâmetro |
Tipo |
Descrição |
|
--marker |
string |
Nome do bucket. |
|
--max-keys |
int |
Número máximo de buckets retornados na solicitação. |
|
--prefix |
string |
Prefixo obrigatório nos nomes dos buckets a serem retornados. |
|
--resource-group-id |
string |
ID do grupo de recursos ao qual o bucket pertence. |
O comando list-buckets corresponde à operação ListBuckets (GetService). Para obter detalhes sobre os parâmetros dessa operação, consulte ListBuckets(GetService).
Para mais informações sobre as opções globais de linha de comando compatíveis, consulte Opções globais de linha de comando.
Exemplos
-
Execute o comando a seguir para listar todos os buckets pertencentes ao solicitante:
ossutil api list-buckets -
Execute o comando a seguir para listar todos os buckets pertencentes ao solicitante e exibir o resultado no formato JSON:
ossutil api list-buckets --output-format json -
Execute o comando a seguir para listar todos os buckets pertencentes ao solicitante e exibir o resultado no formato YAML:
ossutil api list-buckets --output-format yaml -
Execute o comando a seguir para listar os buckets pertencentes ao solicitante cujos nomes contenham o prefixo
example:ossutil api list-buckets --prefix example -
Execute o comando a seguir 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 aparecem alfabeticamente após examplebucket:
ossutil api list-buckets --marker examplebucket -
Execute o comando a seguir para listar os buckets pertencentes ao grupo de recursos com ID
rg-123:ossutil api list-buckets --resource-group-id rg-123