Récupère les informations de chiffrement d'un objet.
Vous devez disposer de l'autorisation READ pour obtenir les informations de chiffrement d'un objet.
Paramètres de la chaîne de requête
| Paramètre | Description | Requis |
|---|---|---|
encryption |
Ce paramètre vous permet de déterminer le type de chiffrement utilisé sur un objet. Si le type de chiffrement est géré par le client ou par le client, ce paramètre fournit également un identifiant pour la clé de chiffrement spécifique utilisée. | Non |
Pour en savoir plus sur les paramètres à inclure lors de la création et de l'utilisation d'URL signées, consultez la section Paramètres des chaînes de requête d'URL signée.
En-têtes de requête
Voir les en-têtes de requêtes courants.
Éléments du corps de la requête
Cette requête n'inclut pas de document XML dans le corps de la requête.
Syntaxe des requêtes
La syntaxe suivante s'applique aux requêtes d'objet GET utilisant le paramètre de chaîne de requête encryption.
GET /OBJECT_NAME?encryption HTTP/1.1 Host: BUCKET_NAME.storage.googleapis.com Content-Length: 0 Content-Type: TYPE Authorization: AUTHENTICATION_STRING
En-têtes de réponse
La requête peut renvoyer divers en-têtes de réponse en fonction des en-têtes de requête que vous utilisez, par exemple : Cache-Control, Content-Length.Content-Type, Content-Disposition, ETag et Last-Modified
Éléments du corps de la réponse
Les éléments de corps de réponse suivants ne sont disponibles que si vous utilisez le paramètre de chaîne de requête encryption.
| Élément | Description |
|---|---|
Encryption |
Conteneur des informations de chiffrement de l'objet. |
KmsKeyName |
Nom de la ressource de clé Cloud Key Management Service utilisée pour chiffrer l'objet. Disponible uniquement lorsque l'objet est chiffré par une clé de chiffrement gérée par le client. |
CustomerEncryption |
Conteneur pour les informations de chiffrement fournies par le client. Disponible uniquement lorsque l'objet est chiffré par une clé de chiffrement fournie par le client |
EncryptionAlgorithm |
Algorithme de chiffrement utilisé pour la clé de chiffrement fournie par le client. |
KeySha256 |
Chaîne au format Base64 RFC 4648 du hachage SHA256 de la clé de chiffrement fournie par le client. |
Exemples
L'exemple suivant récupère les informations de chiffrement d'un objet nommé tokyo.jpg chiffré par une clé de chiffrement gérée par le client.
Requête
GET /tokyo.jpg?encryption HTTP/1.1 Host: travel-maps.storage.googleapis.com Content-Length: 0 Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg
Réponse
HTTP/1.1 200 OK
Content-Length: 164
Content-Type: application/xml; charset=UTF-8
Date: Tue, 01 Nov 2016 17:12:32 GMT
<?xml version="1.0" encoding="UTF-8"?>
<Encryption>
<KmsKeyName>
projects/my-project/locations/us-east1/keyRings/my-keyRing/cryptoKeys/my-key
</KmsKeyName>
</Encryption>
L'exemple suivant récupère les informations de chiffrement d'un objet nommé "paris.jpg" chiffré par une clé de chiffrement fournie par le client.
Requête
GET /paris.jpg?encryption HTTP/1.1 Host: travel-maps.storage.googleapis.com Content-Length: 0 Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg
Réponse
HTTP/1.1 200 OK
Content-Length: 220
Content-Type: application/xml; charset=UTF-8
Date: Tue, 01 Nov 2016 17:12:32 GMT
<?xml version="1.0" encoding="UTF-8"?>
<Encryption>
<CustomerEncryption>
<EncryptionAlgorithm>AES256</EncryptionAlgorithm>
<KeySha256>Vb/C17P2fk35hguiD/pdLoXJk2j2NlmWmUmnOPsLtfA=</KeySha256>
</CustomerEncryption>
</Encryption>
L'exemple suivant récupère les informations de chiffrement d'un objet nommé london.jpg non chiffré par une clé de chiffrement fournie par le client.
Requête
GET /london.jpg?encryption HTTP/1.1 Host: travel-maps.storage.googleapis.com Content-Length: 0 Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg
Réponse
HTTP/1.1 200 OK Content-Length: 51 Content-Type: application/xml; charset=UTF-8 Date: Tue, 01 Nov 2016 20:35:29 GMT <?xml version="1.0" encoding="UTF-8"?> <Encryption/>