use the revert-versioning command to restore versions of deleted files - Object Storage Service

Notes d'utilisation

Pour restaurer une version d'un objet, vous devez disposer des autorisations oss:ListObjectVersions et oss:DeleteObjectVersion. Pour plus d'informations, consultez la rubrique Attacher une stratégie personnalisée à un utilisateur RAM.
À partir de la version 1.6.16 d'ossutil, utilisez ossutil comme nom binaire dans les commandes. Il n'est pas nécessaire de modifier le nom binaire selon le système d'exploitation. Pour les versions antérieures à 1.6.16, adaptez le nom binaire en fonction du système d'exploitation. Pour plus d'informations, consultez la rubrique Référence des commandes ossutil.

Pour plus d'informations sur le versioning, consultez la rubrique Versioning.
Pour plus d'informations sur les marqueurs de suppression, consultez la rubrique Marqueur de suppression.

Syntaxe de la commande

ossutil revert-versioning oss://bucketname[/prefix]
[--encoding-type <value>]
[-r，--recursive]
[--start-time <value> ]
[--end-time <value>]
[--include <value>]
[--exclude <value>]
[--payer <value>]

Le tableau suivant décrit les paramètres et options :

Paramètre/Option

Description

bucketname

Nom du bucket.

prefix

Ressources présentes dans un bucket, telles que les dossiers et les fichiers.

--encoding-type

Type d'encodage du préfixe qui suit oss://bucket_name. Valeur valide : url. Si vous ne spécifiez pas cette option, le préfixe n'est pas encodé.

-r, --recursive

Si vous spécifiez cette option, ossutil restaure tous les objets correspondant au préfixe vers leur version la plus récente. Sans cette option, seul l'objet spécifié est restauré vers sa version la plus récente.

--start-time

Début de la plage temporelle. La valeur correspond à un horodatage UNIX. Si vous spécifiez cette option, les objets supprimés avant cet instant sont ignorés.

--end-time

Fin de la plage temporelle. La valeur correspond à un horodatage UNIX. Si vous spécifiez cette option, les objets supprimés après cet instant sont ignorés.

--include

Inclut tous les objets répondant aux conditions spécifiées.

Pour plus d'informations, consultez la rubrique Options --include et --exclude.

--exclude

Exclut les objets répondant aux conditions spécifiées.

Pour plus d'informations, consultez la rubrique Options --include et --exclude.

--payer

Payeur de la requête. Si vous souhaitez que le demandeur accédant aux ressources du chemin spécifié prenne en charge les frais tels que le trafic et les requêtes, définissez cette option sur requester.

Exemples

Scénario de récupération
- Restaurez l'objet supprimé exampleobject.jpg du bucket examplebucket vers sa version la plus récente.
```
ossutil revert-versioning oss://examplebucket/exampleobject.jpg
```
- Utilisez l'option -r pour restaurer plusieurs objets supprimés correspondant au préfixe destdir dans le bucket examplebucket vers leurs versions les plus récentes.
```
ossutil revert-versioning oss://examplebucket/destdir -r
```
- Utilisez l'option -r pour restaurer tous les objets supprimés du bucket examplebucket vers leurs versions les plus récentes.
```
ossutil revert-versioning oss://examplebucket  -r
```
- Restaurez les objets supprimés dans une plage temporelle donnée vers leurs versions les plus récentes.
  
  Utilisez l'option -r pour restaurer les objets supprimés du bucket examplebucket entre 16 h 22 min 58 s et 16 h 39 min 38 s (UTC+8) le 16 juin 2020 vers leurs versions les plus récentes.
```
ossutil revert-versioning oss://examplebucket -r --start-time 1592295778 --end-time 1592296778
```
- Restaurez tous les objets supprimés répondant à des conditions spécifiques vers leurs versions les plus récentes.
  - Utilisez l'option -r pour restaurer tous les objets TXT supprimés du bucket examplebucket vers leurs versions les plus récentes.
```
ossutil revert-versioning oss://examplebucket --include "*.txt" -r
```
  - Utilisez l'option -r pour restaurer tous les objets supprimés du bucket examplebucket, à l'exception des objets JPG, vers leurs versions les plus récentes.
```
ossutil revert-versioning oss://examplebucket --exclude "*.jpg" -r
```
Exemple de sortie

Si les objets sont restaurés, la sortie inclut le nombre d'objets restaurés et le temps écoulé. Voici un exemple de sortie :
```
revert versioning object count is 10, batch list count is 10

0.066413(s) elapsed
```

Options communes

Pour accéder à un bucket situé dans une autre région, utilisez l'option -e afin de spécifier l'endpoint. Pour accéder à un bucket appartenant à un autre compte Alibaba Cloud, utilisez l'option -i pour l'AccessKey ID et l'option -k pour l'AccessKey Secret.

Par exemple, pour restaurer l'objet supprimé exampletest.png du bucket testbucket vers sa version la plus récente, exécutez la commande suivante. Le bucket se trouve dans la région Chine (Shanghai) et appartient à un autre compte Alibaba Cloud.

ossutil revert-versioning oss://testbucket/exampletest.png -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID  -k yourAccessKeySecret

Options communes.