Lista las versiones de todos los objetos en un bucket, incluidos los marcadores de eliminación.
Notas de uso
Para listar las versiones de los objetos, necesita el permiso oss:ListObjectVersions. Para obtener más información, consulte Attach a custom policy to a RAM user.
Sintaxis del comando
ossutil api list-object-versions --bucket value [flags]|
Parámetro |
Tipo |
Descripción |
|
--bucket |
string |
El nombre del bucket. |
|
--delimiter |
string |
Carácter que se utiliza para agrupar los objetos por nombre. |
|
--encoding-type |
string |
Tipo de codificación del contenido en la respuesta. |
|
--key-marker |
string |
Devuelve los objetos cuyos nombres van alfabéticamente después del valor del parámetro key-marker. Este parámetro se puede especificar junto con version-id-marker. |
|
--max-keys |
int |
Número máximo de objetos que se devuelven. |
|
--prefix |
string |
Prefijo que deben contener los nombres de los objetos devueltos. |
|
--version-id-marker |
string |
ID de versión del objeto especificado por key-marker a partir del cual inicia la operación de listado. Las versiones se devuelven desde la más reciente hasta la más antigua. |
Para obtener más información, consulte Command-line options.
Ejemplos
-
Liste las versiones de todos los objetos en un bucket llamado examplebucket.
ossutil api list-object-versions --bucket examplebucket -
Liste las versiones de todos los objetos en un bucket llamado examplebucket y formatee la salida en JSON.
ossutil api list-object-versions --bucket examplebucket --output-format json -
Liste las versiones de todos los objetos en un bucket llamado examplebucket y formatee la salida en YAML.
ossutil api list-object-versions --bucket examplebucket --output-format yaml -
Liste las versiones de todos los objetos con el prefijo de nombre "dir" en un bucket llamado examplebucket.
ossutil api list-object-versions --bucket examplebucket --prefix dir -
Liste las versiones de los primeros 100 objetos con el prefijo de nombre "dir" en un bucket llamado examplebucket.
ossutil api list-object-versions --bucket examplebucket --prefix dir --max-keys 100 -
Liste las versiones de todos los objetos en el directorio actual dentro de un bucket llamado examplebucket.
ossutil api list-object-versions --bucket examplebucket --delimiter / -
Liste las versiones de todos los objetos cuyos nombres van alfabéticamente después de "test.txt" en un bucket llamado examplebucket.
ossutil api list-object-versions --bucket examplebucket --key-marker test.txt -
Liste las versiones de todos los objetos en un bucket llamado examplebucket y codifique los nombres de los objetos devueltos mediante URL.
ossutil api list-object-versions --bucket examplebucket --encoding-type url -
Liste las versiones de todos los objetos posteriores a la versión "123" del objeto test.txt en un bucket llamado examplebucket.
ossutil api list-object-versions --bucket examplebucket --key-marker test.txt --version-id-marker 123