Key Management Service:CreateKey

A descrição da chave.
A descrição pode ter de 0 a 8.192 caracteres.

O uso da chave. Valores válidos:

• ENCRYPT/DECRYPT: criptografa e descriptografa dados.

• SIGN/VERIFY: gera e verifica assinaturas digitais.

Valor padrão: Se a chave oferecer suporte à verificação de assinatura, o valor padrão será SIGN/VERIFY. Caso contrário, o valor padrão será ENCRYPT/DECRYPT.

A origem do material da chave. Valores válidos:

• Aliyun_KMS (padrão): O material da chave é gerado pelo Alibaba Cloud KMS.

• EXTERNAL: O material da chave é importado.

• Se você definir este parâmetro como EXTERNAL, importe o material da chave. Para obter mais informações, consulte Importar material de chave para uma chave simétrica ou Importar material de chave para uma chave assimétrica.

Você não precisa especificar este parâmetro. O KMS define automaticamente um nível de proteção apropriado para a sua chave.

O nível de proteção da chave. Valores válidos:

• SOFTWARE

• HSM

• Se você não especificar DKMSInstanceId, deixe este parâmetro vazio. O KMS define o nível de proteção. Se um HSM gerenciado estiver disponível na região, o KMS definirá este parâmetro como HSM. Caso contrário, o KMS definirá este parâmetro como SOFTWARE. Para obter mais informações, consulte Visão geral do HSM gerenciado.

Especifica se a rotação automática de chaves deve ser ativada. Valores válidos:

• true: ativa a rotação automática de chaves.

• false (padrão): desativa a rotação automática de chaves.

Este parâmetro é válido apenas quando o tipo de gerenciamento de chaves da chave oferece suporte à rotação automática. Para obter mais informações, consulte Rotação de chaves.

O período de rotação automática. O formato é `integer[unit]`. `integer` indica a duração do período. `unit` indica a unidade de tempo. Unidades válidas: d (dia), h (hora), m (minuto) e s (segundo). Por exemplo, tanto 7d quanto 604800s representam um período de 7 dias.

• Se a chave for uma chave padrão, o valor será 365d.

• Se a chave for uma chave protegida por software, o valor poderá ser de 7d a 365d.

• Se a chave for uma chave protegida por hardware, a rotação automática não será suportada.

A especificação da chave. Os valores válidos variam de acordo com o tipo de gerenciamento de chaves. Para obter mais informações sobre especificações de chaves, padrões suportados e algoritmos, consulte Tipos de gerenciamento de chaves e especificações de chaves.

O ID da instância do KMS.

As tags a serem vinculadas à chave. Cada tag consiste em um par chave-valor (Chave:Valor), que inclui uma chave de tag e um valor de tag.

Especifique no máximo 20 tags. Para especificar várias tags, use o seguinte formato: [{"TagKey":"key1","TagValue":"value1"},{"TagKey":"key2","TagValue":"value2"},...].

Cada chave de tag e valor de tag pode ter até 128 caracteres e pode conter letras maiúsculas, letras minúsculas, dígitos, barras (/), barras invertidas (), sublinhados (_), hifens (-), pontos (.), sinais de mais (+), sinais de igual (=), dois-pontos (:) e arrobas (@).

O conteúdo da política de chave. O valor está no formato JSON. A política pode ter até 32.768 bytes. Para obter mais informações sobre políticas de chave, consulte Visão geral da política de chave. Se você não especificar este parâmetro, a política de credenciais padrão será usada.

Uma política de chave contém o seguinte conteúdo:

• Version: A versão da política de chave. Apenas a versão 1 é suportada.

• Statement: As instruções da política de chave. Cada política de chave contém uma ou mais instruções.

O formato de uma política de chave é o seguinte:

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

Detalhes sobre uma instrução:

• Sid: (Opcional) O identificador de instrução personalizado. O identificador pode ter até 128 caracteres e pode conter letras maiúsculas (A-Z), letras minúsculas (a-z), dígitos (0-9) e caracteres especiais, incluindo sublinhados (_), barras (/), sinais de mais (+), sinais de igual (=), pontos (.), arrobas (@) e hifens (-).

• Effect: (Obrigatório) O efeito da instrução da política. Valores válidos: Allow e Deny.

• Principal: (Obrigatório) A entidade à qual a permissão é concedida. Defina este parâmetro como a conta atual do Alibaba Cloud (a conta do Alibaba Cloud à qual a chave pertence), um usuário do RAM ou uma função do RAM da conta atual do Alibaba Cloud, ou um usuário do RAM ou uma função do RAM de outra conta do Alibaba Cloud.

• Action: (Obrigatório) As operações de API que são permitidas ou negadas. O valor deve começar com "kms:". Para obter uma lista de operações suportadas, consulte Visão geral da política de chave. Se você especificar uma operação que não esteja na lista, a configuração não terá efeito.

• Resource: (Obrigatório) O valor pode ser apenas *, que indica a chave atual do KMS.

• Condition: (Opcional) As condições para que a autorização entre em vigor. Use condições para avaliar o contexto de uma solicitação de API e determinar se a instrução da política deve ser aplicada. O formato é "Condition": {"condition operator": {"condition key": "condition value"}}. Para obter mais informações, consulte Visão geral da política de chave.

O local de armazenamento da chave. Este parâmetro é válido apenas quando DKMSInstanceId é especificado para uma instância de gerenciamento de chaves de hardware. Valores válidos:

• HsmInternal (padrão): A chave é armazenada em um HSM e não oferece suporte à rotação.

• HsmEncryptedDatabase: A chave é armazenada em um banco de dados.

  • Chaves simétricas: A rotação é suportada.

  • Chaves assimétricas: A rotação não é suportada.