GetBucketVersioning - Object Storage Service - Centre de documentation Alibaba Cloud

Syntaxe de la requête

GET /? versioning HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

En-têtes de requête

DescribeRegions utilise uniquement les en-têtes de requête communs. Pour plus d'informations, consultez En-têtes de requête communs.

En-têtes de réponse

La réponse contient uniquement les en-têtes de réponse communs. Pour plus d'informations, consultez En-têtes de réponse communs.

Éléments de réponse

Élément

Type

Exemple

Description

VersioningConfiguration

Container

N/A

Conteneur qui stocke l'état de versioning du bucket.

Nœuds enfants : Status

Nœuds parents : aucun

Status

String

Enabled

État de versioning du bucket.

Nœuds parents : VersioningConfiguration

Valeurs valides :

Enabled : indique que le versioning est activé pour le bucket.
Suspended : indique que le versioning est suspendu pour le bucket.

Remarque

Si le versioning n'est pas activé pour un bucket, l'élément Status n'est pas inclus dans les éléments de réponse.

Exemples

Exemple de requête

GET /?versioning HTTP/1.1
Host: bucket-versioning.oss-cn-hangzhou.aliyuncs.com
Date: Tue, 09 Apr 2019 02:28:18 GMT
Authorization: OSS qn6q**************:77Dv****************

Exemples de réponses

Exemple de réponse pour un bucket dont le versioning est activé

HTTP/1.1 200 OK
x-oss-request-id: 5CAC0342B7AEADE01700****
Date: Tue, 09 Apr 2019 02:28:18 GMT 
Content-Length: 121
Content-Type: application/xml
Connection: keep-alive
Server: AliyunOSS
<? xml version="1.0" encoding="UTF-8"? >
<VersioningConfiguration>
    <Status>Enabled</Status>
</VersioningConfiguration>

Exemple de réponse pour un bucket dont le versioning est désactivé

Si le versioning est désactivé pour le bucket demandé, l'état de versioning du bucket n'est pas inclus dans le corps XML de la réponse.

HTTP/1.1 200 OK
x-oss-request-id: 5CAC015CB7AEADE01700****
Date: Tue, 09 Apr 2019 02:20:12 GMT 
Content-Length: 74
Content-Type: application/xml
Connection: keep-alive
Server: AliyunOSS
<VersioningConfiguration xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com"/>

SDK OSS

Utilisez les SDK OSS pour les langages de programmation suivants afin d'appeler l'opération GetBucketVersioning :

ossutil

Pour plus d'informations sur la commande ossutil correspondant à l'opération GetBucketVersioning, consultez get-bucket-versioning.

Codes d'erreur

Code d'erreur

Code d'état HTTP

Description

AccessDenied

403

Message d'erreur indiquant que vous ne disposez pas des autorisations nécessaires pour interroger l'état de versioning du bucket.

Seul le propriétaire du bucket ou les utilisateurs RAM disposant de l'autorisation GetBucketVersioning peuvent interroger l'état de versioning d'un bucket.

NoSuchBucket

404

Message d'erreur indiquant que le bucket spécifié n'existe pas.