Cloud KMS V1 Client - Class CryptoKeyVersion (2.5.1)

Reference documentation and code samples for the Cloud KMS V1 Client class CryptoKeyVersion.

A CryptoKeyVersion represents an individual cryptographic key, and the associated key material.

An ENABLED version can be used for cryptographic operations. For security reasons, the raw cryptographic key material represented by a CryptoKeyVersion can never be viewed or exported. It can only be used to encrypt, decrypt, or sign data when an authorized user or application invokes Cloud KMS.

Generated from protobuf message google.cloud.kms.v1.CryptoKeyVersion

Namespace

Google \ Cloud \ Kms \ V1

Methods

__construct

Constructor.

Parameters
Name	Description
`data`	`array` Optional. Data for populating the Message object.
`↳ name`	`string` Output only. The resource name for this CryptoKeyVersion in the format `projects//locations//keyRings//cryptoKeys//cryptoKeyVersions/*`.
`↳ state`	`int` The current state of the CryptoKeyVersion.
`↳ protection_level`	`int` Output only. The ProtectionLevel describing how crypto operations are performed with this CryptoKeyVersion.
`↳ algorithm`	`int` Output only. The CryptoKeyVersionAlgorithm that this CryptoKeyVersion supports.
`↳ attestation`	`KeyOperationAttestation` Output only. Statement that was generated and signed by the HSM at key creation time. Use this statement to verify attributes of the key as stored on the HSM, independently of Google. Only provided for key versions with protection_level HSM.
`↳ create_time`	`Google\Protobuf\Timestamp` Output only. The time at which this CryptoKeyVersion was created.
`↳ generate_time`	`Google\Protobuf\Timestamp` Output only. The time this CryptoKeyVersion's key material was generated.
`↳ destroy_time`	`Google\Protobuf\Timestamp` Output only. The time this CryptoKeyVersion's key material is scheduled for destruction. Only present if state is DESTROY_SCHEDULED.
`↳ destroy_event_time`	`Google\Protobuf\Timestamp` Output only. The time this CryptoKeyVersion's key material was destroyed. Only present if state is DESTROYED.
`↳ import_job`	`string` Output only. The name of the ImportJob used in the most recent import of this CryptoKeyVersion. Only present if the underlying key material was imported.
`↳ import_time`	`Google\Protobuf\Timestamp` Output only. The time at which this CryptoKeyVersion's key material was most recently imported.
`↳ import_failure_reason`	`string` Output only. The root cause of the most recent import failure. Only present if state is IMPORT_FAILED.
`↳ generation_failure_reason`	`string` Output only. The root cause of the most recent generation failure. Only present if state is GENERATION_FAILED.
`↳ external_destruction_failure_reason`	`string` Output only. The root cause of the most recent external destruction failure. Only present if state is EXTERNAL_DESTRUCTION_FAILED.
`↳ external_protection_level_options`	`ExternalProtectionLevelOptions` ExternalProtectionLevelOptions stores a group of additional fields for configuring a CryptoKeyVersion that are specific to the EXTERNAL protection level and EXTERNAL_VPC protection levels.
`↳ reimport_eligible`	`bool` Output only. Whether or not this key version is eligible for reimport, by being specified as a target in ImportCryptoKeyVersionRequest.crypto_key_version.

getName

Output only. The resource name for this CryptoKeyVersion in the format projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*.

Returns
Type	Description
`string`

setName

Output only. The resource name for this CryptoKeyVersion in the format projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*.

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getState

The current state of the CryptoKeyVersion.

Returns
Type	Description
`int`	Enum of type CryptoKeyVersionState.

setState

The current state of the CryptoKeyVersion.

Parameter
Name	Description
`var`	`int` Enum of type CryptoKeyVersionState.

Returns
Type	Description
`$this`

getProtectionLevel

Output only. The ProtectionLevel describing how crypto operations are performed with this CryptoKeyVersion.

Returns
Type	Description
`int`	Enum of type ProtectionLevel.

setProtectionLevel

Output only. The ProtectionLevel describing how crypto operations are performed with this CryptoKeyVersion.

Parameter
Name	Description
`var`	`int` Enum of type ProtectionLevel.

Returns
Type	Description
`$this`

getAlgorithm

Output only. The CryptoKeyVersionAlgorithm that this CryptoKeyVersion supports.

Returns
Type	Description
`int`	Enum of type CryptoKeyVersionAlgorithm.

setAlgorithm

Output only. The CryptoKeyVersionAlgorithm that this CryptoKeyVersion supports.

Parameter
Name	Description
`var`	`int` Enum of type CryptoKeyVersionAlgorithm.

Returns
Type	Description
`$this`

getAttestation

Output only. Statement that was generated and signed by the HSM at key creation time. Use this statement to verify attributes of the key as stored on the HSM, independently of Google. Only provided for key versions with protection_level HSM.

Returns
Type	Description
`KeyOperationAttestation\|null`

hasAttestation

clearAttestation

setAttestation

Parameter
Name	Description
`var`	`KeyOperationAttestation`

Returns
Type	Description
`$this`

getCreateTime

Output only. The time at which this CryptoKeyVersion was created.

Returns
Type	Description
`Google\Protobuf\Timestamp\|null`

hasCreateTime

clearCreateTime

setCreateTime

Output only. The time at which this CryptoKeyVersion was created.

Parameter
Name	Description
`var`	`Google\Protobuf\Timestamp`

Returns
Type	Description
`$this`

getGenerateTime

Output only. The time this CryptoKeyVersion's key material was generated.

Returns
Type	Description
`Google\Protobuf\Timestamp\|null`

hasGenerateTime

clearGenerateTime

setGenerateTime

Output only. The time this CryptoKeyVersion's key material was generated.

Parameter
Name	Description
`var`	`Google\Protobuf\Timestamp`

Returns
Type	Description
`$this`

getDestroyTime

Output only. The time this CryptoKeyVersion's key material is scheduled for destruction. Only present if state is DESTROY_SCHEDULED.

Returns
Type	Description
`Google\Protobuf\Timestamp\|null`

hasDestroyTime

clearDestroyTime

setDestroyTime

Output only. The time this CryptoKeyVersion's key material is scheduled for destruction. Only present if state is DESTROY_SCHEDULED.

Parameter
Name	Description
`var`	`Google\Protobuf\Timestamp`

Returns
Type	Description
`$this`

getDestroyEventTime

Output only. The time this CryptoKeyVersion's key material was destroyed. Only present if state is DESTROYED.

Returns
Type	Description
`Google\Protobuf\Timestamp\|null`

hasDestroyEventTime

clearDestroyEventTime

setDestroyEventTime

Output only. The time this CryptoKeyVersion's key material was destroyed. Only present if state is DESTROYED.

Parameter
Name	Description
`var`	`Google\Protobuf\Timestamp`

Returns
Type	Description
`$this`

getImportJob

Output only. The name of the ImportJob used in the most recent import of this CryptoKeyVersion. Only present if the underlying key material was imported.

Returns
Type	Description
`string`

setImportJob

Output only. The name of the ImportJob used in the most recent import of this CryptoKeyVersion. Only present if the underlying key material was imported.

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getImportTime

Output only. The time at which this CryptoKeyVersion's key material was most recently imported.

Returns
Type	Description
`Google\Protobuf\Timestamp\|null`

hasImportTime

clearImportTime

setImportTime

Output only. The time at which this CryptoKeyVersion's key material was most recently imported.

Parameter
Name	Description
`var`	`Google\Protobuf\Timestamp`

Returns
Type	Description
`$this`

getImportFailureReason

Output only. The root cause of the most recent import failure. Only present if state is IMPORT_FAILED.

Returns
Type	Description
`string`

setImportFailureReason

Output only. The root cause of the most recent import failure. Only present if state is IMPORT_FAILED.

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getGenerationFailureReason

Output only. The root cause of the most recent generation failure. Only present if state is GENERATION_FAILED.

Returns
Type	Description
`string`

setGenerationFailureReason

Output only. The root cause of the most recent generation failure. Only present if state is GENERATION_FAILED.

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getExternalDestructionFailureReason

Output only. The root cause of the most recent external destruction failure. Only present if state is EXTERNAL_DESTRUCTION_FAILED.

Returns
Type	Description
`string`

setExternalDestructionFailureReason

Output only. The root cause of the most recent external destruction failure. Only present if state is EXTERNAL_DESTRUCTION_FAILED.

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getExternalProtectionLevelOptions

ExternalProtectionLevelOptions stores a group of additional fields for configuring a CryptoKeyVersion that are specific to the EXTERNAL protection level and EXTERNAL_VPC protection levels.

Returns
Type	Description
`ExternalProtectionLevelOptions\|null`

hasExternalProtectionLevelOptions

clearExternalProtectionLevelOptions

setExternalProtectionLevelOptions

ExternalProtectionLevelOptions stores a group of additional fields for configuring a CryptoKeyVersion that are specific to the EXTERNAL protection level and EXTERNAL_VPC protection levels.

Parameter
Name	Description
`var`	`ExternalProtectionLevelOptions`

Returns
Type	Description
`$this`

getReimportEligible

Output only. Whether or not this key version is eligible for reimport, by being specified as a target in ImportCryptoKeyVersionRequest.crypto_key_version.

Returns
Type	Description
`bool`

setReimportEligible

Output only. Whether or not this key version is eligible for reimport, by being specified as a target in ImportCryptoKeyVersionRequest.crypto_key_version.

Parameter
Name	Description
`var`	`bool`

Returns
Type	Description
`$this`