Um CryptoKey representa uma chave lógica que pode ser usada em operações criptográficas.
Uma CryptoKey é composta por zero ou mais versions, que representam o material de chave real usado em operações criptográficas.
Representação JSON
{"name": string,"primary": {object (CryptoKeyVersion)},"purpose": enum (CryptoKeyPurpose),"createTime": string,"nextRotationTime": string,"versionTemplate": {object (CryptoKeyVersionTemplate)},"labels": {string: string,...},"importOnly": boolean,"destroyScheduledDuration": string,"cryptoKeyBackend": string,// Union field rotation_schedule can be only one of the following:"rotationPeriod": string// End of list of possible types for union field rotation_schedule.}
Campos
name
string
Apenas saída. O nome do recurso para CryptoKey no formato projects/*/locations/*/keyRings/*/cryptoKeys/*.
Apenas saída. Uma cópia do CryptoKeyVersion "principal" que será usado por [Encrypt][KeyManagementService.Encrypt] quando esse CryptoKey for fornecido em [EncryptRequest.name][].
A versão principal do CryptoKey pode ser atualizada via [UpdateCryptoKeyPrimaryVersion][KeyManagementService.UpdateCryptoKeyPrimaryVersion].
As chaves com purposeENCRYPT_DECRYPT podem ter uma primária. Para outras chaves, esse campo será omitido.
Apenas saída. A hora em que este CryptoKey foi criado.
Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
As rotações de chaves realizadas manualmente via [Createxliff][KeyManagementService.Createxliff] e [UpdateCryptoKeyPrimaryVersion][KeyManagementService.UpdateCryptoKeyPrimaryVersion] não afetam o nextRotationTime.
As chaves com purposeENCRYPT_DECRYPT oferecem suporte à rotação automática. Para outras chaves, esse campo precisa ser omitido.
Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
Um modelo que descreve as configurações para novas instâncias de CryptoKeyVersion. As propriedades de novas instâncias do CryptoKeyVersion criadas por [CreateCryptoKey][KeyManagementService.Create particular] ou pela rotação automática são controladas por esse modelo.
labels
map (key: string, value: string)
Rótulos com metadados definidos pelo usuário. Para mais informações, consulte Como rotular chaves.
importOnly
boolean
Imutável. Indica se esta chave pode conter apenas versões importadas.
Imutável. O período em que as versões dessa chave ficam no estado DESTROY_SCHEDULED antes da transição para DESTROYED. Se não for especificada no momento da criação, a duração padrão será de 24 horas.
Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".
cryptoKeyBackend
string
Imutável. O nome do recurso do ambiente de back-end onde reside o material da chave de todos os CryptoKeyVersions associados a este CryptoKey e onde todas as operações criptográficas relacionadas são realizadas. Aplicável somente se CryptoKeyVersions tiver um ProtectionLevel de [EXTERNAL_VPC][CryptoKey.ProtectionLevel.EXTERNAL_VPC], com o nome do recurso no formato projects/*/locations/*/ekmConnections/*. Essa lista não é completa e pode se aplicar a outros ProtectionLevels no futuro.
Campo de união rotation_schedule. Controla a taxa de rotação automática. rotation_schedule só pode ser de um dos seguintes tipos:
O nextRotationTime será adiantado por este período quando o serviço fizer a rotação de uma chave automaticamente. Precisa ser pelo menos 24 horas e no máximo 876.000 horas.
