Utilisez ossutil pour activer le versioning d'un bucket afin de restaurer les objets écrasés ou supprimés dans le bucket - Object Storage Service

Pour pouvoir restaurer un objet vers une version antérieure après un écrasement ou une suppression accidentelle, exécutez la commande bucket-versioning afin d'activer le versioning. Object Storage Service (OSS) vous permet de configurer le versioning d'un bucket pour protéger les objets qu'il contient. Une fois le versioning activé, OSS conserve les versions précédentes des objets écrasés ou supprimés.

Notes d'utilisation

Pour configurer le versioning, vous devez disposer de l'autorisation oss:PutBucketVersioning. Pour consulter l'état du versioning, l'autorisation oss:GetBucketVersioning est requise. Pour plus d'informations, consultez Accorder une stratégie personnalisée.

À partir de la version 1.6.16 d'ossutil, utilisez directement « ossutil » comme nom binaire dans la ligne de commande, sans adaptation 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 Prise en main rapide de l'outil de ligne de commande ossutil.
Pour plus d'informations sur le versioning, consultez Versioning.

Configurer le versioning

Syntaxe de la commande

ossutil bucket-versioning --method put oss://bucketname versioning

Le tableau suivant décrit les paramètres de la syntaxe de commande.

Paramètre

Description

bucketname

Nom du bucket pour lequel vous souhaitez configurer le versioning.

versioning

État du versioning du bucket. Valeurs possibles :

enabled : active le versioning pour le bucket. Lors du chargement d'un objet dans un bucket dont le versioning est activé, OSS génère une chaîne aléatoire servant d'ID de version globalement unique pour l'objet. Pour plus d'informations, consultez Gérer les objets versionnés.
suspended : suspend le versioning pour le bucket. Lors du chargement d'un objet dans un bucket dont le versioning est suspendu, OSS attribue un ID de version nul à l'objet chargé. Pour plus d'informations, consultez Gérer les objets dans un bucket avec versioning suspendu.

Important

Par défaut, un bucket n'est pas versionné. Une fois le versioning activé, il est impossible de revenir à l'état « non versionné ». Vous pouvez toutefois suspendre le versioning d'un bucket activé.

Exemples
Exécutez la commande suivante pour activer le versioning d'un bucket nommé examplebucket :
```
ossutil bucket-versioning --method put oss://examplebucket enabled
```
Exécutez la commande suivante pour suspendre le versioning d'un bucket nommé examplebucket :
```
ossutil bucket-versioning --method put oss://examplebucket suspended
```
La sortie d'exemple suivante indique que le versioning est configuré pour le bucket :
```
0.261209(s) elapsed
```

Interroger l'état du versioning d'un bucket

Syntaxe de la commande

ossutil bucket-versioning --method get oss://bucketname

Exemples

Exécutez la commande suivante pour interroger l'état du versioning d'un bucket nommé examplebucket :
```
ossutil bucket-versioning --method get oss://examplebucket
```
La sortie d'exemple suivante indique que le versioning est activé pour le bucket :
```
bucket versioning status:Enabled

0.218001(s) elapsed
```
La sortie d'exemple suivante indique que le versioning est suspendu pour le bucket :
```
bucket versioning status:Suspended

0.168791(s) elapsed
```
La sortie d'exemple suivante indique que le bucket n'est pas versionné :
```
bucket versioning status:Null

0.158691(s) elapsed
```

Opérations connexes

Le chargement dans un bucket dont le versioning est activé fonctionne de la même manière que dans un bucket non versionné, à la différence près qu'OSS génère un ID de version globalement unique pour l'objet chargé. Pour plus d'informations, consultez cp (charger des fichiers).
Une fois le versioning activé, OSS conserve les versions précédentes des objets écrasés ou supprimés. Spécifiez un ID de version pour télécharger une version spécifique d'un objet. Pour plus d'informations, consultez cp (Télécharger des objets). Vous pouvez également spécifier un ID de version pour restaurer une version précédente spécifique d'un objet. Pour plus d'informations, consultez Copier des objets à l'aide de la commande cp.

Options courantes

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

Par exemple, exécutez la commande suivante pour activer le versioning d'un bucket nommé examplebucket, situé dans la région Chine (Hangzhou) et appartenant à un autre compte Alibaba Cloud :

ossutil bucket-versioning--method put oss://examplebucket enabled -e oss-cn-hangzhou.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

Options courantes.