Configurer la gestion des versions d'un bucket - Object Storage Service

Notes d'utilisation

Vous devez disposer de l'autorisation PutBucketVersioning.
Un bucket peut se trouver dans l'un des trois états de versioning suivants : désactivé (par défaut), activé ou suspendu.
Lorsque le versioning est activé, OSS attribue des ID de version uniques à tous les objets ajoutés au bucket et conserve plusieurs versions.
En cas de suspension, OSS attribue la valeur null comme ID de version aux nouveaux objets et ne conserve pas les versions des objets supprimés ou écrasés.

Pour plus d'informations sur la gestion des versions, consultez la rubrique Gestion des versions.

Syntaxe de la commande

ossutil api put-bucket-versioning --bucket value --versioning-configuration value [flags]

Paramètre

Type

Description

--bucket

string

Nom du bucket.

--versioning-configuration

string

Conteneur stockant les configurations de gestion des versions.

Remarque

La commande put-bucket-versioning équivaut à l'opération API PutBucketVersioning. Pour plus de détails sur cette opération, consultez la rubrique PutBucketVersioning.

--versioning-configuration

L'option --versioning-configuration prend en charge les formats XML et JSON :

Format XML :

<VersioningConfiguration>
  <Status>string</Status>
</VersioningConfiguration>

Format JSON :
```
{
  "Status": "string"
}
```

Remarque

Pour en savoir plus, consultez la rubrique Options de ligne de commande.

Exemples

Configurez la gestion des versions pour un bucket nommé examplebucket.

Utilisez un fichier de configuration XML (versioning-configuration.xml dans cet exemple)

<?xml version="1.0" encoding="UTF-8"?>
<VersioningConfiguration>
        <Status>Enabled</Status>
</VersioningConfiguration>

Exemple de commande :

ossutil api put-bucket-versioning --bucket examplebucket --versioning-configuration file://versioning-configuration.xml

Utilisez un fichier de configuration JSON (versioning-configuration.json dans cet exemple)

{
        "Status": "Enabled"
}

Exemple de commande :

ossutil api put-bucket-versioning --bucket examplebucket --versioning-configuration file://versioning-configuration.json

Spécifiez les paramètres JSON directement dans la ligne de commande

ossutil api put-bucket-versioning --bucket examplebucket --versioning-configuration "{\"Status\":\"Enabled\"}"