Struct RawEncryptRequest 

#[non_exhaustive]
pub struct RawEncryptRequest {
    pub name: String,
    pub plaintext: Bytes,
    pub additional_authenticated_data: Bytes,
    pub plaintext_crc32c: Option<Int64Value>,
    pub additional_authenticated_data_crc32c: Option<Int64Value>,
    pub initialization_vector: Bytes,
    pub initialization_vector_crc32c: Option<Int64Value>,
    /* private fields */
}

Request message for KeyManagementService.RawEncrypt.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

name: String

Required. The resource name of the CryptoKeyVersion to use for encryption.

plaintext: Bytes

Required. The data to encrypt. Must be no larger than 64KiB.

The maximum size depends on the key version’s protection_level. For SOFTWARE keys, the plaintext must be no larger than 64KiB. For HSM keys, the combined length of the plaintext and additional_authenticated_data fields must be no larger than 8KiB.

additional_authenticated_data: Bytes

Optional. Optional data that, if specified, must also be provided during decryption through RawDecryptRequest.additional_authenticated_data.

This field may only be used in conjunction with an algorithm that accepts additional authenticated data (for example, AES-GCM).

The maximum size depends on the key version’s protection_level. For SOFTWARE keys, the plaintext must be no larger than 64KiB. For HSM keys, the combined length of the plaintext and additional_authenticated_data fields must be no larger than 8KiB.

plaintext_crc32c: Option<Int64Value>

Optional. An optional CRC32C checksum of the RawEncryptRequest.plaintext. If specified, KeyManagementService will verify the integrity of the received plaintext using this checksum. KeyManagementService will report an error if the checksum verification fails. If you receive a checksum error, your client should verify that CRC32C(plaintext) is equal to plaintext_crc32c, and if so, perform a limited number of retries. A persistent mismatch may indicate an issue in your computation of the CRC32C checksum. Note: This field is defined as int64 for reasons of compatibility across different languages. However, it is a non-negative integer, which will never exceed 2^32-1, and can be safely downconverted to uint32 in languages that support this type.

additional_authenticated_data_crc32c: Option<Int64Value>

Optional. An optional CRC32C checksum of the RawEncryptRequest.additional_authenticated_data. If specified, KeyManagementService will verify the integrity of the received additional_authenticated_data using this checksum. KeyManagementService will report an error if the checksum verification fails. If you receive a checksum error, your client should verify that CRC32C(additional_authenticated_data) is equal to additional_authenticated_data_crc32c, and if so, perform a limited number of retries. A persistent mismatch may indicate an issue in your computation of the CRC32C checksum. Note: This field is defined as int64 for reasons of compatibility across different languages. However, it is a non-negative integer, which will never exceed 2^32-1, and can be safely downconverted to uint32 in languages that support this type.

initialization_vector: Bytes

Optional. A customer-supplied initialization vector that will be used for encryption. If it is not provided for AES-CBC and AES-CTR, one will be generated. It will be returned in RawEncryptResponse.initialization_vector.

initialization_vector_crc32c: Option<Int64Value>

Optional. An optional CRC32C checksum of the RawEncryptRequest.initialization_vector. If specified, KeyManagementService will verify the integrity of the received initialization_vector using this checksum. KeyManagementService will report an error if the checksum verification fails. If you receive a checksum error, your client should verify that CRC32C(initialization_vector) is equal to initialization_vector_crc32c, and if so, perform a limited number of retries. A persistent mismatch may indicate an issue in your computation of the CRC32C checksum. Note: This field is defined as int64 for reasons of compatibility across different languages. However, it is a non-negative integer, which will never exceed 2^32-1, and can be safely downconverted to uint32 in languages that support this type.

Implementations

impl RawEncryptRequest

pub fn new() -> Self

pub fn set_name<T: Into<String>>(self, v: T) -> Self

Sets the value of name.

pub fn set_plaintext<T: Into<Bytes>>(self, v: T) -> Self

Sets the value of plaintext.

pub fn set_additional_authenticated_data<T: Into<Bytes>>(self, v: T) -> Self

Sets the value of additional_authenticated_data.

pub fn set_plaintext_crc32c<T>(self, v: T) -> Self

where T: Into<Int64Value>,

Sets the value of plaintext_crc32c.

pub fn set_or_clear_plaintext_crc32c<T>(self, v: Option<T>) -> Self

where T: Into<Int64Value>,

Sets or clears the value of plaintext_crc32c.

pub fn set_additional_authenticated_data_crc32c<T>(self, v: T) -> Self

where T: Into<Int64Value>,

Sets the value of additional_authenticated_data_crc32c.

pub fn set_or_clear_additional_authenticated_data_crc32c<T>( self, v: Option<T>, ) -> Self

where T: Into<Int64Value>,

Sets or clears the value of additional_authenticated_data_crc32c.

pub fn set_initialization_vector<T: Into<Bytes>>(self, v: T) -> Self

Sets the value of initialization_vector.

pub fn set_initialization_vector_crc32c<T>(self, v: T) -> Self

where T: Into<Int64Value>,

Sets the value of initialization_vector_crc32c.

pub fn set_or_clear_initialization_vector_crc32c<T>(self, v: Option<T>) -> Self

where T: Into<Int64Value>,

Sets or clears the value of initialization_vector_crc32c.

Trait Implementations

impl Clone for RawEncryptRequest

fn clone(&self) -> RawEncryptRequest

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RawEncryptRequest

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for RawEncryptRequest

fn default() -> RawEncryptRequest

Returns the “default value” for a type.

impl Message for RawEncryptRequest

fn typename() -> &'static str

The typename of this message.

impl PartialEq for RawEncryptRequest

fn eq(&self, other: &RawEncryptRequest) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for RawEncryptRequest