Key Management Service:CreateKey

La descripción de la clave.
La descripción puede tener una longitud de 0 a 8,192 caracteres.

El uso de la clave. Valores válidos:

• ENCRYPT/DECRYPT: cifra y descifra datos.

• SIGN/VERIFY: genera y verifica firmas digitales.

Valor predeterminado: Si la clave admite la verificación de firmas, el valor predeterminado es SIGN/VERIFY. De lo contrario, el valor predeterminado es ENCRYPT/DECRYPT.

El origen del material de la clave. Valores válidos:

• Aliyun_KMS (predeterminado): El material de la clave se genera mediante Alibaba Cloud KMS.

• EXTERNAL: El material de la clave se importa.

• Si establece este parámetro en EXTERNAL, importe el material de la clave. Para obtener más información, consulte Importar material de clave para una clave simétrica o Importar material de clave para una clave asimétrica.

No necesita especificar este parámetro. KMS establece automáticamente un nivel de protección adecuado para su clave.

El nivel de protección de la clave. Valores válidos:

• SOFTWARE

• HSM

• Si no especifica DKMSInstanceId, deje este parámetro vacío. KMS establece el nivel de protección. Si hay un HSM administrado disponible en la región, KMS establece este parámetro en HSM. De lo contrario, KMS establece este parámetro en SOFTWARE. Para obtener más información, consulte Descripción general de HSM administrado.

Especifica si se debe habilitar la rotación automática de claves. Valores válidos:

• true: habilita la rotación automática de claves.

• false (predeterminado): deshabilita la rotación automática de claves.

Este parámetro solo es válido cuando el tipo de gestión de claves de la clave admite la rotación automática. Para obtener más información, consulte Rotación de claves.

El período de rotación automática. El formato es `entero[unidad]`. `entero` indica la duración del período. `unidad` indica la unidad de tiempo. Unidades válidas: d (día), h (hora), m (minuto) y s (segundo). Por ejemplo, tanto 7d como 604800s representan un período de 7 días.

• Si la clave es una clave predeterminada, el valor es 365d.

• Si la clave está protegida por software, el valor puede ser de 7d a 365d.

• Si la clave está protegida por hardware, no se admite la rotación automática.

La especificación de la clave. Los valores válidos varían según el tipo de gestión de claves. Para obtener más información sobre las especificaciones de claves, los estándares admitidos y los algoritmos, consulte Tipos de gestión de claves y especificaciones de claves.

El ID de la instancia de KMS.

Las etiquetas que se vincularán a la clave. Cada etiqueta consta de un par clave-valor (Clave:Valor), que incluye una clave de etiqueta y un valor de etiqueta.

Especifique un máximo de 20 etiquetas. Para especificar varias etiquetas, utilice el siguiente formato: [{"TagKey":"clave1","TagValue":"valor1"},{"TagKey":"clave2","TagValue":"valor2"},...].

Cada clave de etiqueta y valor de etiqueta puede tener hasta 128 caracteres de longitud y puede contener letras mayúsculas, letras minúsculas, dígitos, barras diagonales (/), barras invertidas (\), guiones bajos (_), guiones (-), puntos (.), signos más (+), signos igual (=), dos puntos (:) y arrobas (@).

El contenido de la política de claves. El valor está en formato JSON. La política puede tener hasta 32,768 bytes de longitud. Para obtener más información sobre las políticas de claves, consulte Descripción general de la política de claves. Si no especifica este parámetro, se utiliza la política de credenciales predeterminada.

Una política de claves contiene el siguiente contenido:

• Version: La versión de la política de claves. Solo se admite la versión 1.

• Statement: Las declaraciones de la política de claves. Cada política de claves contiene una o más declaraciones.

El siguiente es el formato de una política de claves:

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

Detalles sobre una declaración:

• Sid: (Opcional) El identificador de declaración personalizado. El identificador puede tener hasta 128 caracteres de longitud y puede contener letras mayúsculas (A-Z), letras minúsculas (a-z), dígitos (0-9) y caracteres especiales, incluidos guiones bajos (_), barras diagonales (/), signos más (+), signos igual (=), puntos (.), arrobas (@) y guiones (-).

• Effect: (Obligatorio) El efecto de la declaración de política. Valores válidos: Allow y Deny.

• Principal: (Obligatorio) La entidad principal a la que se concede el permiso. Establezca este parámetro en la cuenta actual de Alibaba Cloud (la cuenta de Alibaba Cloud a la que pertenece la clave), un usuario RAM o rol RAM de la cuenta actual de Alibaba Cloud, o un usuario RAM o rol RAM de otra cuenta de Alibaba Cloud.

• Action: (Obligatorio) Las operaciones de API que se permiten o deniegan. El valor debe comenzar con "kms:". Para obtener una lista de las operaciones admitidas, consulte Descripción general de la política de claves. Si especifica una operación que no está en la lista, la configuración no surte efecto.

• Resource: (Obligatorio) El valor solo puede ser *, que indica la clave KMS actual.

• Condition: (Opcional) Las condiciones para que la autorización surta efecto. Utilice condiciones para evaluar el contexto de una solicitud de API y determinar si se aplica la declaración de política. El formato es "Condition": {"condition operator": {"condition key": "condition value"}}. Para obtener más información, consulte Descripción general de la política de claves.

La ubicación de almacenamiento de la clave. Este parámetro solo es válido cuando se especifica DKMSInstanceId para una instancia de gestión de claves por hardware. Valores válidos:

• HsmInternal (predeterminado): La clave se almacena en un HSM y no admite rotación.

• HsmEncryptedDatabase: La clave se almacena en una base de datos.

  • Claves simétricas: Se admite la rotación.

  • Claves asimétricas: No se admite la rotación.