REST Resource: projects.locations.keyRings.cryptoKeys

{
  "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.
}

string

Uniquement en sortie. Nom de ressource de cet élément CryptoKey au format projects/*/locations/*/keyRings/*/cryptoKeys/*.

object (CryptoKeyVersion)

Uniquement en sortie. Copie du CryptoKeyVersion "principal" qui sera utilisé par [Encrypt][KeyManagementService.Encrypt] lorsque cet élément CryptoKey est fourni dans [EncryptRequest.name][].

La version principale de CryptoKey peut être mise à jour via [UpdateCryptoKeyPrimaryVersion][KeyManagementService.UpdateCryptoKeyPrimaryVersion].

Les clés avec purpose ENCRYPT_DECRYPT peuvent avoir une instance principale. Pour les autres clés, ce champ est omis.

enum (CryptoKeyPurpose)

Immuable. Objectif immuable de ce CryptoKey.

string (Timestamp format)

Uniquement en sortie. Date et heure de création de ce CryptoKey.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

À nextRotationTime, Key Management Service effectue automatiquement les opérations suivantes:

1. Créez une nouvelle version de ce CryptoKey.
2. Il désigne cette nouvelle version comme version principale.

Les rotations de clé effectuées manuellement via [CreateCryptoKey][KeyManagementService.CreateCryptoKey] et [UpdateCryptoKeyPrimaryVersion][KeyManagementService.UpdateCryptoKeyPrimaryVersion] n'affectent pas nextRotationTime.

Les clés avec purpose ENCRYPT_DECRYPT acceptent la rotation automatique. Pour les autres clés, ce champ doit être omis.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

object (CryptoKeyVersionTemplate)

Modèle décrivant les paramètres des nouvelles instances CryptoKeyVersion. Les propriétés des nouvelles instances CryptoKeyVersion créées par [CreateCryptoKey][KeyManagementService.CreateCryptoKey] ou par rotation automatique sont contrôlées par ce modèle.

map (key: string, value: string)

Libellés avec des métadonnées définies par l'utilisateur. Pour en savoir plus, consultez la page Ajouter des libellés à des clés.

boolean

Immuable. Indique si cette clé ne peut contenir que des versions importées.

string (Duration format)

Immuable. Durée pendant laquelle les versions de cette clé passent à l'état DESTROY_SCHEDULED avant de passer à DESTROYED. Si aucune valeur n'est spécifiée au moment de la création, la durée par défaut est de 24 heures.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

string

Immuable. Nom de ressource de l'environnement de backend où se trouve le matériel de clé pour tous les CryptoKeyVersions associés à ce CryptoKey et où toutes les opérations cryptographiques associées sont effectuées. Ne s'applique que si CryptoKeyVersions possède un ProtectionLevel de type [EXTERNAL_VPC][CryptoKey.ProtectionLevel.EXTERNAL_VPC], avec le nom de ressource au format projects/*/locations/*/ekmConnections/*. Notez que cette liste n'est pas exhaustive et qu'elle pourrait s'appliquer à d'autres ProtectionLevels à l'avenir.

string (Duration format)

nextRotationTime sera avancée de cette période lorsqu'une clé sera automatiquement alternée par le service. La durée doit être comprise entre 24 heures et 876 000 heures.

Si rotationPeriod est défini, nextRotationTime doit également être défini.

Les clés avec purpose ENCRYPT_DECRYPT acceptent la rotation automatique. Pour les autres clés, ce champ doit être omis.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"