Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/Data Encryption Workshop/Referência de API/APIs/APIs de gerenciamento de pares de chaves/Gerenciamento de pares de chaves/Criação e importação de um par de chaves SSH
Atualizado em 2023-02-28 GMT+08:00
Ver PDF
Compartilhar

Criação e importação de um par de chaves SSH

Função

Essa API é usada para criar e importar um par de chaves SSH.

URI

POST /v3/{project_id}/keypairs

Tabela 1 Parâmetros de caminho

Parâmetro

Obrigatoriedade

Tipo

Descrição

project_id

Sim

String

ID do projeto.

Parâmetros de solicitação

Tabela 2 Parâmetros de cabeçalho de solicitação

Parâmetro

Obrigatoriedade

Tipo

Descrição

X-Auth-Token

Sim

String

Token do usuário. O token pode ser obtido chamando a API do IAM (valor de X-Subject-Token no cabeçalho de resposta).

Tabela 3 Parâmetros de corpo de solicitação

Parâmetro

Obrigatoriedade

Tipo

Descrição

keypair

Sim

CreateKeypairAction object

Parâmetro no corpo da solicitação para criar um par de chaves.

Tabela 4 CreateKeypairAction

Parâmetro

Obrigatoriedade

Tipo

Descrição

name

Sim

String

Nome do par de chaves SSH.

  • O nome de um par de chaves deve ser exclusivo.
  • O nome do par de chaves SSH pode conter no máximo 64 caracteres, incluindo letras, dígitos, sublinhados (_) e hifens (-).

type

Não

String

Tipo de par de chaves SSH.

public_key

Não

String

Cadeia da chave pública importada.

scope

Não

String

Nível de locatário ou nível de usuário.

user_id

Não

String

Usuário ao qual pertence um par de chaves SSH.

key_protection

Não

KeyProtection object

Hospedagem de chave privada e proteção para o par de chaves SSH.

Tabela 5 KeyProtection

Parâmetro

Obrigatoriedade

Tipo

Descrição

private_key

Não

String

Chave privada do par de chaves SSH importado.

encryption

Não

Encryption object

Como uma chave privada é criptografada e armazenada.

Tabela 6 Criptografia

Parâmetro

Obrigatoriedade

Tipo

Descrição

type

Não

String

Opções de valor:

  • default: o modo de criptografia padrão. Aplicável a sites em que o KMS não está implementado.
  • kms: modo de criptografia de KMS. Se o KMS não estiver disponível, defina esse parâmetro como padrão.

kms_key_name

Não

String

Nome de uma chave de KMS.

  • Se o tipo for definido como kms, este parâmetro é obrigatório.

Parâmetros de resposta

Código de status: 200

Tabela 7 Parâmetros de corpo da resposta

Parâmetro

Tipo

Descrição

keypair

CreateKeypairResp object

Detalhes do par de chaves SSH.

Tabela 8 CreateKeypairResp

Parâmetro

Tipo

Descrição

name

String

Nome do par de chaves SSH.

type

String

Tipo de par de chaves SSH.

public_key

String

Informações de chave pública sobre um par de chaves SSH.

private_key

String

Informações de chave privada sobre um par de chaves SSH.

  • Quando um par de chaves SSH é criado, a resposta contém informações de private_key.
  • Quando um par de chaves SSH é importado, a resposta não contém informações de private_key.

fingerprint

String

Informações de impressão digital sobre um par de chaves SSH.

user_id

String

Usuário ao qual pertence um par de chaves SSH.

Código de status: 400

Tabela 9 Parâmetros de corpo da resposta

Parâmetro

Tipo

Descrição

error_code

String

Código de erro.

error_msg

String

Mensagem de erro.

Exemplo de solicitações

{
  "keypair" : {
    "name" : "demo2"
  }
}

Exemplo de respostas

Código de status: 200

OK.

{
  "keypair" : {
    "name" : "demo",
    "type" : "ssh",
    "public_key" : "ssh-rsa AAAAB3NzaC1yc2EAAAADAQAB...",
    "private_key" : "-----BEGIN RSA PRIVATE KEY-----...",
    "fingerprint" : "49:ef:73:2b:9b:7f:2e:0c:58:d3:e3:42:8e:28:04:3b",
    "user_id" : "e4f380899b1248918f3d37098dc63746"
  }
}

Código de status: 400

Ocorreu um erro.

{
  "error_code" : "KPS.XXX",
  "error_msg" : "XXX"
}

Códigos de status

Código de status

Descrição

200

OK.

400

Ocorreu um erro.

Códigos de erro

Consulte Códigos de erro.