Optional. An optional CRC32C checksum of theMacSignRequest.data. If specified,KeyManagementServicewill verify the integrity of the receivedMacSignRequest.datausing this checksum.KeyManagementServicewill report an error if the checksum verification fails. If you receive a checksum error, your client should verify that CRC32C(MacSignRequest.data) is equal toMacSignRequest.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.
getName
Required. The resource name of theCryptoKeyVersionto use for
signing.
Returns
Type
Description
string
setName
Required. The resource name of theCryptoKeyVersionto use for
signing.
Parameter
Name
Description
var
string
Returns
Type
Description
$this
getData
Required. The data to sign. The MAC tag is computed over this data field
based on the specific algorithm.
Returns
Type
Description
string
setData
Required. The data to sign. The MAC tag is computed over this data field
based on the specific algorithm.
Parameter
Name
Description
var
string
Returns
Type
Description
$this
getDataCrc32C
Optional. An optional CRC32C checksum of theMacSignRequest.data. If
specified,KeyManagementServicewill verify the integrity of the receivedMacSignRequest.datausing this
checksum.KeyManagementServicewill report an error if the checksum verification fails. If you receive a
checksum error, your client should verify that
CRC32C(MacSignRequest.data) is
equal toMacSignRequest.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.
Optional. An optional CRC32C checksum of theMacSignRequest.data. If
specified,KeyManagementServicewill verify the integrity of the receivedMacSignRequest.datausing this
checksum.KeyManagementServicewill report an error if the checksum verification fails. If you receive a
checksum error, your client should verify that
CRC32C(MacSignRequest.data) is
equal toMacSignRequest.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.
Returns
Type
Description
int|string|null
setDataCrc32C
Optional. An optional CRC32C checksum of theMacSignRequest.data. If
specified,KeyManagementServicewill verify the integrity of the receivedMacSignRequest.datausing this
checksum.KeyManagementServicewill report an error if the checksum verification fails. If you receive a
checksum error, your client should verify that
CRC32C(MacSignRequest.data) is
equal toMacSignRequest.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.
Sets the field by wrapping a primitive type in a Google\Protobuf\Int64Value object.
Optional. An optional CRC32C checksum of theMacSignRequest.data. If
specified,KeyManagementServicewill verify the integrity of the receivedMacSignRequest.datausing this
checksum.KeyManagementServicewill report an error if the checksum verification fails. If you receive a
checksum error, your client should verify that
CRC32C(MacSignRequest.data) is
equal toMacSignRequest.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.
Parameter
Name
Description
var
int|string|null
Returns
Type
Description
$this
static::build
Parameters
Name
Description
name
string
Required. The resource name of theCryptoKeyVersionto use for
signing. Please seeKeyManagementServiceClient::cryptoKeyVersionName()for help formatting this field.
data
string
Required. The data to sign. The MAC tag is computed over this data field
based on the specific algorithm.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Cloud KMS V1 Client - Class MacSignRequest (2.3.1)\n\nVersion latestkeyboard_arrow_down\n\n- [2.3.1 (latest)](/php/docs/reference/cloud-kms/latest/V1.MacSignRequest)\n- [2.3.0](/php/docs/reference/cloud-kms/2.3.0/V1.MacSignRequest)\n- [2.2.0](/php/docs/reference/cloud-kms/2.2.0/V1.MacSignRequest)\n- [2.1.6](/php/docs/reference/cloud-kms/2.1.6/V1.MacSignRequest)\n- [2.0.0](/php/docs/reference/cloud-kms/2.0.0/V1.MacSignRequest)\n- [1.23.0](/php/docs/reference/cloud-kms/1.23.0/V1.MacSignRequest)\n- [1.22.1](/php/docs/reference/cloud-kms/1.22.1/V1.MacSignRequest)\n- [1.21.4](/php/docs/reference/cloud-kms/1.21.4/V1.MacSignRequest)\n- [1.20.3](/php/docs/reference/cloud-kms/1.20.3/V1.MacSignRequest)\n- [1.19.0](/php/docs/reference/cloud-kms/1.19.0/V1.MacSignRequest)\n- [1.18.1](/php/docs/reference/cloud-kms/1.18.1/V1.MacSignRequest)\n- [1.17.0](/php/docs/reference/cloud-kms/1.17.0/V1.MacSignRequest)\n- [1.16.4](/php/docs/reference/cloud-kms/1.16.4/V1.MacSignRequest)\n- [1.15.3](/php/docs/reference/cloud-kms/1.15.3/V1.MacSignRequest) \nReference documentation and code samples for the Cloud KMS V1 Client class MacSignRequest.\n\nRequest message for\n[KeyManagementService.MacSign](/php/docs/reference/cloud-kms/latest/V1.Client.KeyManagementServiceClient#_Google_Cloud_Kms_V1_Client_KeyManagementServiceClient__macSign__).\n\nGenerated from protobuf message `google.cloud.kms.v1.MacSignRequest`\n\nNamespace\n---------\n\nGoogle \\\\ Cloud \\\\ Kms \\\\ V1\n\nMethods\n-------\n\n### __construct\n\nConstructor.\n\n### getName\n\nRequired. The resource name of the\n[CryptoKeyVersion](/php/docs/reference/cloud-kms/latest/V1.CryptoKeyVersion) to use for\nsigning.\n\n### setName\n\nRequired. The resource name of the\n[CryptoKeyVersion](/php/docs/reference/cloud-kms/latest/V1.CryptoKeyVersion) to use for\nsigning.\n\n### getData\n\nRequired. The data to sign. The MAC tag is computed over this data field\nbased on the specific algorithm.\n\n### setData\n\nRequired. The data to sign. The MAC tag is computed over this data field\nbased on the specific algorithm.\n\n### getDataCrc32C\n\nOptional. An optional CRC32C checksum of the\n[MacSignRequest.data](/php/docs/reference/cloud-kms/latest/V1.MacSignRequest#_Google_Cloud_Kms_V1_MacSignRequest__getData__). If\nspecified, [KeyManagementService](/php/docs/reference/cloud-kms/latest/V1.Client.KeyManagementServiceClient)\nwill verify the integrity of the received\n[MacSignRequest.data](/php/docs/reference/cloud-kms/latest/V1.MacSignRequest#_Google_Cloud_Kms_V1_MacSignRequest__getData__) using this\nchecksum. [KeyManagementService](/php/docs/reference/cloud-kms/latest/V1.Client.KeyManagementServiceClient)\nwill report an error if the checksum verification fails. If you receive a\nchecksum error, your client should verify that\nCRC32C([MacSignRequest.data](/php/docs/reference/cloud-kms/latest/V1.MacSignRequest#_Google_Cloud_Kms_V1_MacSignRequest__getData__)) is\nequal to\nMacSignRequest.data_crc32c,\nand if so, perform a limited number of retries. A persistent mismatch may\nindicate an issue in your computation of the CRC32C checksum. Note: This\nfield is defined as int64 for reasons of compatibility across different\nlanguages. However, it is a non-negative integer, which will never exceed\n2\\^32-1, and can be safely downconverted to uint32 in languages that support\nthis type.\n\n### hasDataCrc32C\n\n### clearDataCrc32C\n\n### getDataCrc32CUnwrapped\n\nReturns the unboxed value from `getDataCrc32C()`\n\nOptional. An optional CRC32C checksum of the\n[MacSignRequest.data](/php/docs/reference/cloud-kms/latest/V1.MacSignRequest#_Google_Cloud_Kms_V1_MacSignRequest__getData__). If\nspecified, [KeyManagementService](/php/docs/reference/cloud-kms/latest/V1.Client.KeyManagementServiceClient)\nwill verify the integrity of the received\n[MacSignRequest.data](/php/docs/reference/cloud-kms/latest/V1.MacSignRequest#_Google_Cloud_Kms_V1_MacSignRequest__getData__) using this\nchecksum. [KeyManagementService](/php/docs/reference/cloud-kms/latest/V1.Client.KeyManagementServiceClient)\nwill report an error if the checksum verification fails. If you receive a\nchecksum error, your client should verify that\nCRC32C([MacSignRequest.data](/php/docs/reference/cloud-kms/latest/V1.MacSignRequest#_Google_Cloud_Kms_V1_MacSignRequest__getData__)) is\nequal to\nMacSignRequest.data_crc32c,\nand if so, perform a limited number of retries. A persistent mismatch may\nindicate an issue in your computation of the CRC32C checksum. Note: This\nfield is defined as int64 for reasons of compatibility across different\nlanguages. However, it is a non-negative integer, which will never exceed\n2\\^32-1, and can be safely downconverted to uint32 in languages that support\nthis type.\n\n### setDataCrc32C\n\nOptional. An optional CRC32C checksum of the\n[MacSignRequest.data](/php/docs/reference/cloud-kms/latest/V1.MacSignRequest#_Google_Cloud_Kms_V1_MacSignRequest__getData__). If\nspecified, [KeyManagementService](/php/docs/reference/cloud-kms/latest/V1.Client.KeyManagementServiceClient)\nwill verify the integrity of the received\n[MacSignRequest.data](/php/docs/reference/cloud-kms/latest/V1.MacSignRequest#_Google_Cloud_Kms_V1_MacSignRequest__getData__) using this\nchecksum. [KeyManagementService](/php/docs/reference/cloud-kms/latest/V1.Client.KeyManagementServiceClient)\nwill report an error if the checksum verification fails. If you receive a\nchecksum error, your client should verify that\nCRC32C([MacSignRequest.data](/php/docs/reference/cloud-kms/latest/V1.MacSignRequest#_Google_Cloud_Kms_V1_MacSignRequest__getData__)) is\nequal to\nMacSignRequest.data_crc32c,\nand if so, perform a limited number of retries. A persistent mismatch may\nindicate an issue in your computation of the CRC32C checksum. Note: This\nfield is defined as int64 for reasons of compatibility across different\nlanguages. However, it is a non-negative integer, which will never exceed\n2\\^32-1, and can be safely downconverted to uint32 in languages that support\nthis type.\n\n### setDataCrc32CUnwrapped\n\nSets the field by wrapping a primitive type in a Google\\\\Protobuf\\\\Int64Value object.\n\nOptional. An optional CRC32C checksum of the\n[MacSignRequest.data](/php/docs/reference/cloud-kms/latest/V1.MacSignRequest#_Google_Cloud_Kms_V1_MacSignRequest__getData__). If\nspecified, [KeyManagementService](/php/docs/reference/cloud-kms/latest/V1.Client.KeyManagementServiceClient)\nwill verify the integrity of the received\n[MacSignRequest.data](/php/docs/reference/cloud-kms/latest/V1.MacSignRequest#_Google_Cloud_Kms_V1_MacSignRequest__getData__) using this\nchecksum. [KeyManagementService](/php/docs/reference/cloud-kms/latest/V1.Client.KeyManagementServiceClient)\nwill report an error if the checksum verification fails. If you receive a\nchecksum error, your client should verify that\nCRC32C([MacSignRequest.data](/php/docs/reference/cloud-kms/latest/V1.MacSignRequest#_Google_Cloud_Kms_V1_MacSignRequest__getData__)) is\nequal to\nMacSignRequest.data_crc32c,\nand if so, perform a limited number of retries. A persistent mismatch may\nindicate an issue in your computation of the CRC32C checksum. Note: This\nfield is defined as int64 for reasons of compatibility across different\nlanguages. However, it is a non-negative integer, which will never exceed\n2\\^32-1, and can be safely downconverted to uint32 in languages that support\nthis type.\n\n### static::build"]]