Obtenir les informations de chiffrement d'un objet

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/>