Interroge les règles de chiffrement côté serveur configurées pour un bucket.
Notes
L'appel à l'opération GetBucketEncryption nécessite l'autorisation oss:GetBucketEncryption. Pour plus d'informations, consultez la rubrique Exemples courants de politiques RAM.
Seul le propriétaire du bucket ou les utilisateurs RAM autorisés peuvent interroger les règles de chiffrement du bucket. Les autres utilisateurs reçoivent une erreur 403. Pour plus d'informations sur le chiffrement des buckets, consultez la rubrique Chiffrement côté serveur.
Structure de la requête
Get /? encryption HTTP/1.1
Date: GMT Date
Host: BucketName.oss.aliyuncs.com
Authorization: SignatureValueEn-têtes de requête
Cette requête utilise uniquement les en-têtes de requête communs. Pour plus d'informations, consultez la rubrique En-têtes de requête communs.
En-têtes de réponse
Cette réponse utilise uniquement les en-têtes de réponse communs. Pour plus d'informations, consultez la rubrique En-têtes de réponse communs.
Éléments de réponse
|
Élément |
Type |
Exemple |
Description |
|
ServerSideEncryptionRule |
Container |
N/A |
Conteneur des règles de chiffrement côté serveur. Nœud enfant : ApplyServerSideEncryptionByDefault |
|
ApplyServerSideEncryptionByDefault |
Container |
N/A |
Conteneur de la méthode de chiffrement côté serveur par défaut. Nœuds enfants : SSEAlgorithm et KMSMasterKeyID |
|
SSEAlgorithm |
String |
KMS |
Méthode de chiffrement côté serveur par défaut. Valeurs valides : KMS et AES256 |
|
KMSMasterKeyID |
String |
9468da86-3509-4f8d-a61e-6eab1eac**** |
ID de la CMK utilisée pour le chiffrement. Renvoyé uniquement lorsque SSEAlgorithm est défini sur KMS et qu'un ID de CMK est spécifié. Sinon, la valeur est nulle. |
Exemples
-
Exemple de requête
Get /? encryption HTTP/1.1 Date: Thu, 17 Apr 2025 11:20:10 GMT Host: oss-example.oss-cn-hangzhou.aliyuncs.com Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e -
Exemple de réponse
La réponse suivante indique que le chiffrement SSE-KMS est configuré pour le bucket.
HTTP/1.1 204 NoContent x-oss-request-id: 5C1B138A109F4E405B2D8AEF Date: Tue, 20 Dec 2018 11:22:05 GMT <? xml version="1.0" encoding="UTF-8"? > <ServerSideEncryptionRule> <ApplyServerSideEncryptionByDefault> <SSEAlgorithm>KMS</SSEAlgorithm> <KMSMasterKeyID>9468da86-3509-4f8d-a61e-6eab1eac****</KMSMasterKeyID> </ApplyServerSideEncryptionByDefault> </ServerSideEncryptionRule>
SDK OSS
Appelez GetBucketEncryption à l'aide des SDK OSS suivants :
ossutil
Pour obtenir des informations sur la commande ossutil correspondant à l'opération GetBucketEncryption, consultez la rubrique get-bucket-encryption.
Codes d'erreur
|
Code d'erreur |
Code d'état HTTP |
Description |
|
AccessDenied |
403 |
Vous ne disposez pas de l'autorisation nécessaire pour interroger les règles de chiffrement de ce bucket. |
|
NoSuchBucket |
400 |
Le bucket spécifié n'existe pas. |
|
NoSuchServerSideEncryptionRule |
400 |
Aucune règle de chiffrement n'est configurée pour ce bucket. |