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> Bare Metal Server> Referência de API> APIs OpenStack nativo Nova V2.1> Gerenciamento de pares de chaves SSH do BMS> Criação e importação de um par de chaves SSH (API OpenStack nativo)

Atualizado em 2023-03-20 GMT+08:00

Ver PDF

Criação e importação de um par de chaves SSH (API OpenStack nativo)

Função

Essa interface é usada para criar um par de chaves SSH ou importar uma chave pública para gerar um par de chaves.

Após a criação de uma chave SSH, baixe a chave privada para um diretório local. Em seguida, você pode usar essa chave privada para fazer logon no BMS. Para garantir a segurança de BMS, a chave privada pode ser baixada apenas uma vez. Mantenha-a segura.

URI

POST /v2.1/{project_id}/os-keypairs

A Tabela 1 lista os parâmetros.

**Tabela 1** Descrição do parâmetro
Parâmetro	Obrigatório	Descrição
project_id	Sim	Especifica o ID do projeto. Para obter detalhes de como conseguir o ID de domínio, consulte Obtenção de um ID de projeto.

Solicitação

Parâmetros de solicitação

Ao criar um par de chaves SSH, você só precisa configurar o name. Ao importar uma chave SSH pública, você também deve configurar public_key.

Parâmetro	Obrigatório	Tipo	Descrição
keypair	Sim	Object	Especifica o par de chaves SSH criado ou importado. Para mais detalhes, consulte Tabela 2.

**Tabela 2** Descrição da estrutura de dados do campo **keypair**
Parâmetro	Obrigatório	Tipo	Descrição
public_key	Não	String	Especifica a chave pública importada. O tamanho máximo da chave pública importada é 1024 bytes. Observação: se o comprimento da chave pública a ser importada exceder 1024 bytes, a importação de chave pública para o BMS falhará.
name	Sim	String	Especifica o nome do par de chaves. O novo nome do par de chaves não pode ser igual a um existente.

Exemplo de solicitação

      
           POST https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/os-keypairs

      
           {
    "keypair": {
        "name": "keypair-7d7c3650-dabe-4eb0-b904-5c464453c043",
        "public_key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQC9mC3WZN9UGLxgPBpP7H5jZMc6pKwOoSgre8yun6REFktn/Kz7DUt9jaR1UJyRzHxITfCfAIgSxPdGqB/oF1suMyWgu5i0625vavLB5z5kC8Hq3qZJ9zJO1poE1kyD+htiTtPWJ88e12xuH2XB/CZN9OpEiF98hAagiOE0EnOS5Q== Generated by Nova\n"
    }
}

Resposta

Parâmetros de resposta

Parâmetro	Tipo	Descrição
keypair	Object	Especifica o par de chaves SSH. Para mais detalhes, consulte Tabela 3.

**Tabela 3** Descrição da estrutura de dados do campo **keypair**
Parâmetro	Tipo	Descrição
fingerprint	String	Especifica informações de impressão digital sobre o par de chaves.
name	String	Especifica o nome do par de chaves.
public_key	String	Especifica a chave pública.
private_key	String	Especifica a chave privada. As informações sobre a chave privada estão contidas na resposta para criar uma chave SSH. As informações sobre a chave privada não estão contidas na resposta para importar uma chave SSH.
user_id	String	Especifica o ID do usuário ao qual o par de chaves pertence.

Exemplo de resposta

      
           {
    "keypair": {
        "public_key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQC9mC3WZN9UGLxgPBpP7H5jZMc6pKwOoSgre8yun6REFktn/Kz7DUt9jaR1UJyRzHxITfCfAIgSxPdGqB/oF1suMyWgu5i0625vavLB5z5kC8Hq3qZJ9zJO1poE1kyD+htiTtPWJ88e12xuH2XB/CZN9OpEiF98hAagiOE0EnOS5Q== Generated by Nova\n",
        "user_id": "f882feb345064e7d9392440a0f397c25",
        "name": "keypair-7d7c3650-dabe-4eb0-b904-5c464453c043",
        "fingerprint": "35:9d:d0:c3:4a:80:d3:d8:86:f1:ca:f7:df:c4:f9:d8"
    }
}