revert - Object Storage Service - Centro de documentación de Alibaba Cloud

Ejecute el comando revert para restaurar una versión eliminada de un objeto en un bucket con control de versiones habilitado a la versión anterior más reciente.

Notas de uso

Para restaurar una versión de objeto, debe contar con los permisos oss:GetObject, oss:PutObject, oss:ListObjectVersions y oss:DeleteObject. Para obtener más información, consulte Attach a custom policy to a RAM user.
Para obtener más información sobre el control de versiones, consulte Versioning.
Para obtener más información sobre los marcadores de eliminación, consulte Delete marker.

Sintaxis del comando

ossutil revert oss://bucket[/prefix] version-directive [flags]

Parámetro	Tipo	Descripción
version-directive	string	La versión eliminada del objeto que desea restaurar. Valores válidos: El ID de versión. Por ejemplo: CAEQIBiBgICAr6yv9hgiIDZiNmUzNjM5Njg0ZDRhOWQ4Yj. El índice de versión. Formato: HEAD~n. La versión del objeto se restaura a la versión válida n-1, sin incluir el marcador de eliminación. Si el índice de versión se establece en HEAD~0, la versión del objeto se restaura a la versión anterior más reciente. Si la última versión es un marcador de eliminación, la versión del objeto se restaura a la versión anterior más reciente al eliminar dicho marcador. Si el índice de versión se establece en HEAD~n (n > 0), la versión del objeto se restaura a la versión anterior más reciente al copiar la versión del objeto. El índice de tiempo. Formato: NOW~Tiempo relativo o NOW~Tiempo absoluto. La versión del objeto se restaura a la versión anterior más reciente cuya última hora de modificación no sea posterior a la hora especificada, sin incluir el marcador de eliminación. NOW~ tiempo relativo: Al usar la indexación por tiempo relativo, puede retroceder un intervalo de tiempo específico desde la hora local actual. El formato es `NOW~` seguido de un sufijo de unidad de tiempo. Los sufijos de unidad compatibles son: ms para milisegundos, s para segundos, m para minutos, h para horas, d para días, w para semanas, M para meses y y para años. Por ejemplo: `NOW~1d` significa restaurar a la versión de un día antes de la hora local actual. NOW~ tiempo absoluto: Para casos que requieren una fecha y hora específicas, puede usar un índice de tiempo absoluto. El formato es `NOW~` seguido de una cadena de tiempo que cumple con el estándar ISO 8601 (`YYYY-MM-DDTHH:mm:ss`), lo cual restaurará la versión más reciente anterior a la hora local especificada. Por ejemplo: `NOW~2024-04-12T14:00:00` indica que la versión del objeto se restaura a la versión anterior más reciente cuya última hora de modificación no sea posterior a las 14:00:00 del 12 de abril de 2024.
-d, --dirs	/	Devuelve los objetos y subdirectorios del directorio actual.
--encoding-type	string	El método de codificación usado para el nombre del objeto. Valor válido: url.
--end-with	string	Devuelve los objetos cuyos nombres sean alfabéticamente anteriores o iguales al valor del parámetro --end-with.
--exclude	stringArray	La regla de exclusión para rutas o nombres de objetos.
--exclude-from	stringArray	Lee la regla de exclusión desde el archivo de reglas.
--files-from	stringArray	Lee los nombres de los objetos de origen desde el archivo de reglas e ignora las líneas vacías o de comentarios.
--files-from-raw	stringArray	Lee los nombres de los objetos de origen desde el archivo de reglas.
--filter	stringArray	La regla de filtro para las rutas o nombres de objetos.
--filter-from	stringArray	Lee la regla de filtro para las rutas o nombres de objetos desde el archivo de reglas.
-f, --force	/	Ejecuta el comando forzosamente sin solicitar confirmación.
--ignore-version-not-exist	/	Ignora los errores que indican versiones inexistentes en operaciones por lotes.
--include	stringArray	La regla de inclusión para rutas o nombres de objetos.
--include-from	stringArray	Lee la regla de inclusión desde el archivo de reglas.
--max-age	Duración	Restaura únicamente los objetos cuya última hora de modificación se encuentre dentro de la duración especificada. La unidad predeterminada es segundos. También puede usar un sufijo, como 1h para una hora. Nota `--min-age 1h` indica que solo se restauran los objetos modificados durante la última hora.
--min-mtime	Hora	Restaura únicamente los objetos cuya última hora de modificación sea posterior a la hora especificada. Por ejemplo: 2006-01-02T15:04:05. Nota `--min-mtime "2006-01-02T15:04:05"` indica que solo se restauran los archivos modificados después de 2006-01-02 15:04:05.
--page-size	int	El número máximo de objetos a listar por solicitud de API durante operaciones por lotes. Valor predeterminado: 1000. Rango de valores: de 1 a 1000.
-r, --recursive	/	Ejecuta el comando recursivamente sobre los objetos. Si se especifica este parámetro, el comando revert surte efecto en todos los objetos que cumplen las condiciones dentro del bucket. De lo contrario, el comando revert solo surte efecto en los objetos de la ruta especificada.
--request-payer	string	El pagador de la solicitud. Si el pago por solicitante está habilitado para el bucket, establezca este parámetro en requester. Valor válido: requester.
--start-after	string	Devuelve los objetos cuyos nombres sean alfabéticamente posteriores al valor del parámetro --start-after.

Nota

Para obtener más información, consulte Command-line options.

Nota: No puede ejecutar el comando revert para eliminar versiones de objetos y así restaurar un objeto a una versión específica. Para restaurar un objeto a una versión específica mediante la eliminación de versiones, ejecute el comando rm. Por ejemplo, ejecute el siguiente comando para eliminar las tres versiones anteriores más recientes de un objeto llamado key123.

ossutil rm oss://bucket/key123 --end-with key123 --limited-num 3 -rf --all-versions

Ejemplos

Restaurar la versión eliminada de un solo objeto

Restaure el objeto eliminado example.txt en el bucket examplebucket a una versión cuyo ID de versión es 123:
```
ossutil revert oss://examplebucket/example.txt 123
```
Restaure el objeto eliminado example.txt en el bucket examplebucket a la versión anterior más reciente:
```
ossutil revert oss://examplebucket/example.txt HEAD~0
```
Restaure el objeto eliminado example.txt en el bucket examplebucket a la cuarta versión anterior más reciente:
```
ossutil revert oss://examplebucket/example.txt HEAD~4
```
Restaure el objeto eliminado example.txt en el bucket examplebucket a la versión anterior más reciente del día anterior:
```
ossutil revert oss://examplebucket/example.txt NOW~1d
```
Restaure el objeto eliminado example.txt en el bucket examplebucket a la versión anterior más reciente cuya última hora de modificación no sea posterior a 2024-04-12T14:00:00:
```
ossutil revert oss://examplebucket/example.txt NOW~2024-04-12T14:00:00
```

Restaurar las versiones eliminadas de varios objetos

Restaure todos los objetos en el directorio dir del bucket examplebucket a la cuarta versión anterior más reciente:
```
ossutil revert oss://examplebucket/dir -r HEAD~4
```
Restaure todos los objetos en el directorio dir del bucket examplebucket a la cuarta versión anterior más reciente e ignore los errores que indiquen que las versiones no existen:
```
ossutil revert oss://examplebucket/dir -r HEAD~4 --ignore-version-not-exist
```
Restaure todos los objetos, excepto aquellos en formato JPG, en el bucket examplebucket a la versión anterior más reciente:
```
ossutil revert oss://examplebucket -r --exclude "*.jpg" HEAD~0
```
Restaure todos los objetos con sufijo .txt en los directorios dir1 y dir2 del bucket examplebucket a la versión anterior más reciente:
```
ossutil revert oss://examplebucket -r --include "/dir1/*.txt" --include "/dir2/*.txt" HEAD~0
```
Lea la regla de inclusión desde el archivo include_rules.txt y restaure los objetos que cumplan con las reglas en el directorio dir del bucket examplebucket a la cuarta versión anterior más reciente:

El contenido del archivo de reglas include_rules.txt es a continuación:
```
*.log
*.csv
```
Comando de ejemplo:
```
ossutil revert oss://examplebucket/dir -r HEAD~4 --include-from include_rules.txt
```