- Solicitud HTTP
- Parámetros de ruta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de la autorización
- Pruébalo
Nombre completo: projects.locations.keyRings.cryptoKeys.encrypt
Permite encriptar datos, de manera que solo puedan recuperarse mediante una llamada a cryptoKeys.decrypt
. El CryptoKey.purpose
debe ser ENCRYPT_DECRYPT
.
Solicitud HTTP
POST https://cloudkms.googleapis.com/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/**}:encrypt
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta
Parámetros | |
---|---|
name |
Obligatorio. El nombre de recurso de la Si se especifica una La autorización necesita el siguiente permiso de Google IAM sobre el
|
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON | |
---|---|
{ "plaintext": string, "additionalAuthenticatedData": string } |
Campos | |
---|---|
plaintext |
Obligatorio. Los datos que se encriptarán. No deben superar los 64 KiB. El tamaño máximo depende del Una string codificada en base 64. |
additionalAuthenticatedData |
Datos opcionales que, si se especifican, también deben proporcionarse durante la desencriptación mediante El tamaño máximo depende del Una string codificada en base 64. |
Cuerpo de la respuesta
Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:
Mensaje de respuesta para KeyManagementService.Encrypt
.
Representación JSON | |
---|---|
{ "name": string, "ciphertext": string } |
Campos | |
---|---|
name |
El nombre de recurso de la |
ciphertext |
Los datos encriptados. Una string codificada en base 64. |
Alcances de la autorización
Se necesita uno de los siguientes alcances de OAuth:
https://www.googleapis.com/auth/cloudkms
https://www.googleapis.com/auth/cloud-platform
Para obtener más información, consulta Descripción general de la autenticación.