Key Management Service:CreateKey

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

A finalidade da chave. Valores válidos:

• ENCRYPT/DECRYPT: Criptografia e descriptografia de dados.

• SIGN/VERIFY: Geração e verificação de assinatura digital.

Valor padrão: Se a chave suportar geração e 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 por você.

• Se você selecionar EXTERNAL, deverá importar o material da chave. Para obter mais informações, consulte Importar material de chave simétrica ou Importar material de chave assimétrica.

Você não precisa especificar este parâmetro. O KMS configurará as definições de proteção apropriadas para a sua chave.

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

• SOFTWARE

• HSM

• Se DKMSInstanceId não for especificado, recomendamos que você não especifique este parâmetro e confie nas configurações do KMS. Se o KMS tiver um HSM gerenciado na região, este parâmetro será definido como HSM. Caso contrário, será definido 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 só entra em vigor quando o tipo de gerenciamento de chaves ao qual a chave pertence suporta rotação automática. Para obter mais informações, consulte Rotação de chaves.

O período para rotação automática. O formato é inteiro[unidade], onde inteiro indica a duração do tempo e unidade indica a unidade de tempo. As unidades válidas são d (dias), h (horas), m (minutos) e s (segundos). Tanto 7d quanto 604800s indicam um período de 7 dias.

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

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

• Se a chave for uma chave protegida por hardware, a rotação automática não é 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 seguidos e algoritmos de chaves, consulte Tipos de gerenciamento de chaves e especificações de chaves.

O ID da instância da instância do KMS.

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

Você pode especificar até 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 e 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 no formato JSON. O comprimento máximo é de 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 chave padrão será usada.

A política de chave inclui os seguintes campos:

• 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.

A política de chave usa o seguinte formato:

{
  "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 da instrução:

• Sid: Opcional. O identificador de instrução personalizado. 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 (_/+=.@-).

• Effect: Obrigatório. Especifica se deve permitir ou negar as permissões na instrução da política. Valores válidos: Allow e Deny.

• Principal: Obrigatório. A entidade à qual a política está anexada. Você pode definir este campo como a conta atual do Alibaba Cloud (a conta à qual a chave pertence), usuários do RAM ou funções do RAM na conta atual do Alibaba Cloud, ou usuários do RAM ou funções do RAM em outras contas do Alibaba Cloud.

• Action: Obrigatório. As operações de API a serem permitidas ou negadas. O valor deve começar com "kms:". Para o escopo da lista de permissões de operação, consulte Visão geral da política de chave. Se você especificar operações fora da lista, as configurações não entrarão em vigor.

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

• Condition: Opcional. As condições que devem ser atendidas para que a autorização entre em vigor. Você pode usar condições para avaliar o contexto das solicitações de API e determinar se a instrução da política se aplica. 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 protegida por hardware. Este parâmetro só entra em vigor quando DKMSInstanceId está definido como o ID de uma instância de gerenciamento de chaves de hardware. Valores válidos:

• HsmInternal (padrão): A chave protegida por hardware é armazenada no HSM e não suporta rotação.

• HsmEncryptedDatabase: A chave protegida por hardware é armazenada no banco de dados.

  • Chaves simétricas: Suportam rotação.

  • Chaves assimétricas: Não suportam rotação.