:CreateKey

La description de la clé.
La description peut comporter de 0 à 8 192 caractères.

L'utilisation de la clé. Valeurs valides :

• ENCRYPT/DECRYPT : chiffre et déchiffre des données.

• SIGN/VERIFY : génère et vérifie des signatures numériques.

Valeur par défaut : si la clé prend en charge la vérification de signature, la valeur par défaut est SIGN/VERIFY. Sinon, la valeur par défaut est ENCRYPT/DECRYPT.

La source du matériel de clé. Valeurs valides :

• Aliyun_KMS (par défaut) : le matériel de clé est généré par Alibaba Cloud KMS.

• EXTERNAL : le matériel de clé est importé.

• Si vous définissez ce paramètre sur EXTERNAL, importez le matériel de clé. Pour plus d'informations, consultez Importer du matériel de clé pour une clé symétrique ou Importer du matériel de clé pour une clé asymétrique.

Vous n'avez pas besoin de spécifier ce paramètre. KMS définit automatiquement un niveau de protection approprié pour votre clé.

Le niveau de protection de la clé. Valeurs valides :

• SOFTWARE

• HSM

• Si vous ne spécifiez pas DKMSInstanceId, laissez ce paramètre vide. KMS définit le niveau de protection. Si un HSM géré est disponible dans la région, KMS définit ce paramètre sur HSM. Sinon, KMS définit ce paramètre sur SOFTWARE. Pour plus d'informations, consultez Présentation de l'HSM géré.

Indique si la rotation automatique des clés doit être activée. Valeurs valides :

• true : active la rotation automatique des clés.

• false (par défaut) : désactive la rotation automatique des clés.

Ce paramètre n'est valide que lorsque le type de gestion de clés de la clé prend en charge la rotation automatique. Pour plus d'informations, consultez Rotation des clés.

La période de rotation automatique. Le format est `integer[unit]`. `integer` indique la longueur de la période. `unit` indique l'unité de temps. Unités valides : d (jour), h (heure), m (minute) et s (seconde). Par exemple, 7d et 604800s représentent tous deux une période de 7 jours.

• Si la clé est une clé par défaut, la valeur est 365d.

• Si la clé est une clé protégée par logiciel, la valeur peut être comprise entre 7d et 365d.

• Si la clé est une clé protégée par matériel, la rotation automatique n'est pas prise en charge.

La spécification de la clé. Les valeurs valides varient en fonction du type de gestion des clés. Pour plus d'informations sur les spécifications des clés, les normes prises en charge et les algorithmes, consultez Types de gestion des clés et spécifications des clés.

L'identifiant de l'instance KMS.

Les balises à lier à la clé. Chaque balise se compose d'une paire clé-valeur (Key:Value), qui comprend une clé de balise et une valeur de balise.

Spécifiez un maximum de 20 balises. Pour spécifier plusieurs balises, utilisez le format suivant : [{"TagKey":"key1","TagValue":"value1"},{"TagKey":"key2","TagValue":"value2"},...].

Chaque clé de balise et valeur de balise peut comporter jusqu'à 128 caractères et peut contenir des lettres majuscules, des lettres minuscules, des chiffres, des barres obliques (/), des barres obliques inverses (), des traits de soulignement (_), des traits d'union (-), des points (.), des signes plus (+), des signes égal (=), des deux-points (:) et des arobases (@).

Le contenu de la stratégie de clé. La valeur est au format JSON. La stratégie peut comporter jusqu'à 32 768 octets. Pour plus d'informations sur les stratégies de clé, consultez Présentation des stratégies de clé. Si vous ne spécifiez pas ce paramètre, la stratégie d'identification par défaut est utilisée.

Une stratégie de clé contient les éléments suivants :

• Version : la version de la stratégie de clé. Seule la version 1 est prise en charge.

• Statement : les instructions de la stratégie de clé. Chaque stratégie de clé contient une ou plusieurs instructions.

Voici le format d'une stratégie de clé :

{
  "Version": "1",
  "Statement": [
    {
      "Sid": "Enable RAM User Permissions",
      "Effect": "Allow",
      "Principal": {
        "RAM": ["acs:ram::112890462****:root"]
      },
      "Action": [
        "kms:*"
      ],
      "Resource": [
        "*"
      ],
      "Condition": {
        "condition operator": {
          "condition key": "condition value"
        }
      }
    }
  ]
}

Détails concernant une instruction :

• Sid : (Facultatif) L'identifiant d'instruction personnalisé. L'identifiant peut comporter jusqu'à 128 caractères et peut contenir des lettres majuscules (A-Z), des lettres minuscules (a-z), des chiffres (0-9) et des caractères spéciaux, notamment des traits de soulignement (_), des barres obliques (/), des signes plus (+), des signes égal (=), des points (.), des arobases (@) et des traits d'union (-).

• Effect : (Requis) L'effet de l'instruction de stratégie. Valeurs valides : Allow et Deny.

• Principal : (Requis) Le principal auquel l'autorisation est accordée. Définissez ce paramètre sur le compte Alibaba Cloud actuel (le compte Alibaba Cloud auquel la clé appartient), un utilisateur RAM ou un rôle RAM du compte Alibaba Cloud actuel, ou un utilisateur RAM ou un rôle RAM d'un autre compte Alibaba Cloud.

• Action : (Requis) Les opérations d'API autorisées ou refusées. La valeur doit commencer par "kms:". Pour obtenir la liste des opérations prises en charge, consultez Présentation des stratégies de clé. Si vous spécifiez une opération qui ne figure pas dans la liste, le paramètre ne prend pas effet.

• Resource : (Requis) La valeur peut uniquement être *, ce qui indique la clé KMS actuelle.

• Condition : (Facultatif) Les conditions pour que l'autorisation prenne effet. Utilisez les conditions pour évaluer le contexte d'une requête d'API afin de déterminer s'il faut appliquer l'instruction de stratégie. Le format est "Condition": {"condition operator": {"condition key": "condition value"}}. Pour plus d'informations, consultez Présentation des stratégies de clé.

L'emplacement de stockage de la clé. Ce paramètre n'est valide que lorsque DKMSInstanceId est spécifié pour une instance de gestion de clés matérielle. Valeurs valides :

• HsmInternal (par défaut) : la clé est stockée dans un HSM et ne prend pas en charge la rotation.

• HsmEncryptedDatabase : la clé est stockée dans une base de données.

  • Clés symétriques : la rotation est prise en charge.

  • Clés asymétriques : la rotation n'est pas prise en charge.