Lists object versions - Object Storage Service - Centre de documentation Alibaba Cloud

Notes d’utilisation

Pour répertorier les versions des objets, vous devez disposer de l’autorisation oss:ListObjectVersions. Pour plus d’informations, consultez la rubrique Attach a custom policy to a RAM user.

Syntaxe de la commande

ossutil api list-object-versions --bucket value [flags]

Paramètre

Type

Description

--bucket

string

Nom du bucket.

--delimiter

string

Caractère utilisé pour regrouper les objets par nom.

--encoding-type

string

Type d’encodage du contenu de la réponse.

--key-marker

string

Renvoie les objets dont le nom suit alphabétiquement la valeur du paramètre key-marker. Ce paramètre peut être utilisé conjointement avec version-id-marker.

--max-keys

int

Nombre maximal d’objets à renvoyer.

--prefix

string

Préfixe que doivent contenir les noms des objets renvoyés.

--version-id-marker

string

ID de version de l’objet spécifié par key-marker à partir duquel commence le listage. Les versions sont renvoyées de la plus récente à la plus ancienne.

Remarque

Pour plus d’informations, consultez la rubrique Command-line options.

Exemples

Répertoriez les versions de tous les objets d’un bucket nommé examplebucket.
```
ossutil api list-object-versions --bucket examplebucket
```
Répertoriez les versions de tous les objets d’un bucket nommé examplebucket et formatez la sortie en JSON.
```
ossutil api list-object-versions --bucket examplebucket --output-format json
```
Répertoriez les versions de tous les objets d’un bucket nommé examplebucket et formatez la sortie en YAML.
```
ossutil api list-object-versions --bucket examplebucket --output-format yaml
```
Répertoriez les versions de tous les objets dont le nom commence par le préfixe « dir » dans un bucket nommé examplebucket.
```
ossutil api list-object-versions --bucket examplebucket --prefix dir
```
Répertoriez les versions des 100 premiers objets dont le nom commence par le préfixe « dir » dans un bucket nommé examplebucket.
```
ossutil api list-object-versions --bucket examplebucket --prefix dir --max-keys 100
```
Répertoriez les versions de tous les objets du répertoire courant dans un bucket nommé examplebucket.
```
ossutil api list-object-versions --bucket examplebucket --delimiter /
```
Répertoriez les versions de tous les objets dont le nom suit alphabétiquement « test.txt » dans un bucket nommé examplebucket.
```
ossutil api list-object-versions --bucket examplebucket --key-marker test.txt
```
Répertoriez les versions de tous les objets d’un bucket nommé examplebucket et encodez les noms des objets renvoyés au format URL.
```
ossutil api list-object-versions --bucket examplebucket --encoding-type url
```
Répertoriez les versions de tous les objets qui suivent la version « 123 » de l’objet test.txt dans un bucket nommé examplebucket.
```
ossutil api list-object-versions --bucket examplebucket --key-marker test.txt --version-id-marker 123
```