ImportKeyPair - - Centre de documentation Alibaba Cloud

Importe la clé publique d'une paire de clés chiffrée RSA (Rivest–Shamir–Adleman) générée par un outil tiers. Une fois la paire de clés importée, Alibaba Cloud stocke la clé publique. Vous devez conserver la clé privée en toute sécurité et garantir sa confidentialité.

Notes d'utilisation

Tenez compte des points suivants :

Vous pouvez créer jusqu'à 500 paires de clés par région.
La paire de clés à importer doit prendre en charge l'une des méthodes de chiffrement suivantes :
- 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

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	ImportKeyPair	Opération à effectuer. Définissez la valeur sur ImportKeyPair.
RegionId	String	Oui	cn-hangzhou	ID de la région. Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente.
KeyPairName	String	Oui	testKeyPairName	Nom de la paire de clés. Le nom doit être unique. Il doit comporter entre 2 et 128 caractères, commencer par une lettre et ne peut pas commencer par http:// ou https://. Il peut contenir des lettres, des chiffres, des deux-points (:), des traits de soulignement (_) et des tirets (-).
PublicKeyBody	String	Oui	ABC1234567	Clé publique de la paire de clés.
ResourceGroupId	String	Non	rg-bp67acfmxazb4p****	ID du groupe de ressources auquel ajouter la paire de clés.
Tag.N.Key	String	Non	TestKey	Clé du tag N à ajouter à la paire de clés. Valeurs valides pour N : 1 à 20. La clé du tag ne peut pas être une chaîne vide. Elle peut comporter jusqu'à 128 caractères et ne peut pas contenir http:// ou https://. Elle ne peut pas commencer par acs: ou aliyun.
Tag.N.Value	String	Non	TestValue	Valeur du tag N à ajouter à la paire de clés. Valeurs valides pour N : 1 à 20. La valeur du tag peut être une chaîne vide. Elle peut comporter jusqu'à 128 caractères et ne peut pas contenir http:// ou https://. Elle ne peut pas commencer par acs:.

Paramètres de réponse

Paramètre	Type	Exemple	Description
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID de la requête.
KeyPairName	String	testKeyPairName	Nom de la paire de clés à ajouter à l'instance.
KeyPairFingerPrint	String	89:f0:ba:62:ac:b8:aa:e1:61:5e:fd:81:69:86:6d:6b:f0:c0:5a:**	Empreinte digitale de la paire de clés. L'algorithme de hachage MD5 (Message-Digest Algorithm 5) est utilisé selon le format d'empreinte digitale de clé publique défini dans la RFC 4716.

Exemples

Exemple de requête

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

Exemple de réponse réussie

Format 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>

Format 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:**"
}

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidKeyPairName.Malformed	Specified Key Pair name is not valid.	Le nom de la paire de clés spécifié n'est pas valide.
400	InvalidPublicKeyBody.Malformed	The PublicKeyBody format is not supported.	Le format de la clé publique n'est pas pris en charge.
400	KeyPair.AlreadyExist	The key pair already exist.	Une paire de clés portant le même nom existe déjà. Les noms de paires de clés doivent être uniques.
403	QuotaExceed.KeyPair	The key pair quota exceeds.	Le nombre maximal de paires de clés est atteint.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	Le groupe de ressources est introuvable.
500	InternalError	The request processing has failed due to some unknown error.	Une erreur interne s'est produite. Réessayez ultérieurement.

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur de service.