ImportKeyPair - : Central de Documentação do Alibaba Cloud

Importa a chave pública de um par de chaves criptografado com Rivest–Shamir–Adleman (RSA) gerado por uma ferramenta de terceiros. Após a importação, o Alibaba Cloud armazena a chave pública. Você deve armazenar a chave privada por conta própria e garantir sua confidencialidade.

Observações de uso

Atente-se aos seguintes pontos:

É possível crie até 500 pares de chaves em cada região.
O par de chaves a ser importado precisa oferecer suporte a um dos seguintes métodos de criptografia:
- rsa
- dsa
- ssh-rsa
- ssh-dss
- ecdsa
- ssh-rsa-cert-v00@openssh.com
- ssh-dss-cert-v00@openssh.com
- ssh-rsa-cert-v01@openssh.com
- ssh-dss-cert-v01@openssh.com
- ecdsa-sha2-nistp256-cert-v01@openssh.com
- ecdsa-sha2-nistp384-cert-v01@openssh.com
- ecdsa-sha2-nistp521-cert-v01@openssh.com

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos que você chame esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	ImportKeyPair	A operação que você deseja executar. Defina o valor como ImportKeyPair.
RegionId	String	Sim	cn-hangzhou	O ID da região. Chame a operação DescribeRegions para consultar a lista mais recente de regiões.
KeyPairName	String	Sim	testKeyPairName	O nome do par de chaves. O nome deve ser exclusivo e ter entre 2 e 128 caracteres. Deve começar com uma letra e não pode iniciar com http:// ou https://. Pode conter letras, dígitos, dois-pontos (:), sublinhados (_) e hifens (-).
PublicKeyBody	String	Sim	ABC1234567	A chave pública do par de chaves.
ResourceGroupId	String	Não	rg-bp67acfmxazb4p****	O ID do grupo de recursos ao qual o par de chaves será adicionado.
Tag.N.Key	String	Não	TestKey	A chave da tag N a ser adicionada ao par de chaves. Os valores válidos para N variam de 1 a 20. A chave da tag não pode ser uma string vazia, deve ter no máximo 128 caracteres e não pode conter http:// ou https://. Além disso, não pode começar com acs: ou aliyun.
Tag.N.Value	String	Não	TestValue	O valor da tag N a ser adicionada ao par de chaves. Os valores válidos para N variam de 1 a 20. O valor da tag pode ser uma string vazia, deve ter no máximo 128 caracteres e não pode conter http:// ou https://. Também não pode começar com acs:.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	O ID da solicitação.
KeyPairName	String	testKeyPairName	O nome do par de chaves a ser adicionado à instância.
KeyPairFingerPrint	String	89:f0:ba:62:ac:b8:aa:e1:61:5e:fd:81:69:86:6d:6b:f0:c0:5a:**	A impressão digital do par de chaves. Utiliza-se o algoritmo de resumo de mensagem 5 (MD5) com base no formato de impressão digital de chave pública definido na RFC 4716.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=ImportKeyPair
&RegionId=cn-qingdao
&PublicKeyBody=ABC1234567
&KeyPairName=testKeyPairName
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<ImportKeyPairResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <KeyPairName>testKeyPairName</KeyPairName>
    <KeyPairFingerPrint>89:f0:ba:62:ac:b8:aa:e1:61:5e:fd:81:69:86:6d:6b:f0:c0:5a:**</KeyPairFingerPrint>
</ImportKeyPairResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "KeyPairName" : "testKeyPairName",
  "KeyPairFingerPrint" : "89:f0:ba:62:ac:b8:aa:e1:61:5e:fd:81:69:86:6d:6b:f0:c0:5a:**"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidKeyPairName.Malformed	Specified Key Pair name is not valid.	O nome do par de chaves especificado é inválido.
400	InvalidPublicKeyBody.Malformed	The PublicKeyBody format is not supported.	O formato da chave pública não é suportado.
400	KeyPair.AlreadyExist	The key pair already exist.	Já existe um par de chaves com o mesmo nome. Os nomes dos pares de chaves devem ser exclusivos.
403	QuotaExceed.KeyPair	The key pair quota exceeds.	O número máximo de pares de chaves foi atingido.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	O grupo de recursos não foi encontrado.
500	InternalError	The request processing has failed due to some unknown error.	Ocorreu um erro interno. Tente novamente mais tarde.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.