Enumera todos los buckets propiedad del solicitante.
Notas de uso
Para enumerar todos los buckets propiedad del solicitante, debe contar con el permiso
oss: ListBuckets(GetService). Para obtener más información, consulte Attach a custom policy to a RAM user.Especifique el parámetro prefix, marker o max-keys para consultar los buckets que cumplan con las condiciones indicadas.
Si al ejecutar el comando se devuelven todos los buckets, los parámetros de respuesta en formato XML no incluyen los elementos Prefix, Marker, MaxKeys, IsTruncated ni NextMarker.
Sintaxis del comando
ossutil api list-buckets [flags]|
Parámetro |
Tipo |
Descripción |
|
--marker |
string |
El nombre del bucket. |
|
--max-keys |
int |
El número máximo de buckets que se pueden devolver en la solicitud. |
|
--prefix |
string |
El prefijo que deben contener los nombres de los buckets que desea devolver. |
|
--resource-group-id |
string |
El ID del resource group al que pertenece el bucket. |
El comando list-buckets corresponde a la operación ListBuckets (GetService). Para obtener más información sobre los parámetros de esta operación, consulte ListBuckets(GetService).
Para conocer las opciones globales de línea de comandos compatibles, consulte Global command-line options.
Ejemplos
-
Ejecute el siguiente comando para enumerar todos los buckets propiedad del solicitante:
ossutil api list-buckets -
Ejecute el siguiente comando para enumerar todos los buckets propiedad del solicitante y mostrarlos en formato JSON:
ossutil api list-buckets --output-format json -
Ejecute el siguiente comando para enumerar todos los buckets propiedad del solicitante y mostrarlos en formato YAML:
ossutil api list-buckets --output-format yaml -
Ejecute el siguiente comando para enumerar los buckets propiedad del solicitante cuyos nombres contienen el prefijo
example:ossutil api list-buckets --prefix example -
Ejecute el siguiente comando para enumerar los primeros 100 buckets propiedad del solicitante:
ossutil api list-buckets --max-keys 100 -
Ejecute el siguiente comando para enumerar los buckets propiedad del solicitante cuyos nombres van después de examplebucket en orden alfabético:
ossutil api list-buckets --marker examplebucket -
Ejecute el siguiente comando para enumerar los buckets que pertenecen a un resource group con el ID
rg-123:ossutil api list-buckets --resource-group-id rg-123