CreateKeyPair - - Centro de documentación de Alibaba Cloud

Cree un key pair de SSH. El sistema almacena la clave pública y devuelve la clave privada sin cifrar. La clave privada está codificada con PEM en formato PKCS#8. Debe almacenar la clave privada por su cuenta y garantizar su confidencialidad.

Notas de uso

Además de llamar a CreateKeyPair, puede crear un key pair mediante una herramienta de generación de claves de terceros y usar la operación ImportKeyPair para cargarlo en una región de Alibaba Cloud.

Puede crear hasta 500 key pairs en cada región. Para obtener más información, consulte la sección "Límites" en Use Cloud Assistant to run commands in containers.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, se recomienda llamar a esta operación en OpenAPI Explorer. Esta herramienta genera dinámicamente el código de ejemplo de la operación para diferentes SDKs.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	CreateKeyPair	La operación que desea ejecutar. Establezca el valor en CreateKeyPair.
RegionId	String	Sí	cn-hangzhou	ID de la región donde se creará el key pair. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.
KeyPairName	String	Sí	testKeyPairName	Nombre del key pair. Debe tener entre 2 y 128 caracteres de longitud, comenzar con una letra y no puede empezar con http:// o https://. Puede contener letras, dígitos, dos puntos (:), guiones bajos (_) y guiones (-).
ResourceGroupId	String	No	rg-bp67acfmxazb4p****	ID del resource group al que se agregará el key pair.
Tag.N.Key	String	No	TestKey	Clave de la etiqueta N que se agregará al key pair. Valores válidos de N: 1 a 20. La clave de la etiqueta no puede ser una cadena vacía, debe tener hasta 128 caracteres de longitud y no puede contener http:// ni https://. Tampoco puede comenzar con acs: o aliyun.
Tag.N.Value	String	No	TestValue	Valor de la etiqueta N que se agregará al key pair. Valores válidos de N: 1 a 20. El valor de la etiqueta puede ser una cadena vacía, tener hasta 128 caracteres de longitud y no puede contener http:// ni https://. Tampoco puede comenzar con acs:.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
PrivateKeyBody	String	MIIEpAIBAAKCAQEAtReyMzLIcBH78EV2zj****	Clave privada del key pair. Está codificada con PEM en formato PKCS#8.
KeyPairName	String	testKeyPairName	Nombre del key pair.
KeyPairId	String	ssh-bp67acfmxazb4p****	ID del key pair de SSH.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID de la solicitud.
KeyPairFingerPrint	String	89:f0:ba:62:ac:b8:aa:e1:61:5e:fd:81:69:86:6d:6b:f0:c0:5a:**	Huella digital del key pair. Se utiliza el algoritmo de resumen de mensajes 5 (MD5) según el formato de huella digital de clave pública definido en RFC 4716. Para obtener más información, consulte RFC 4716.

Ejemplos

Solicitudes de ejemplo

https://ecs.aliyuncs.com/?Action=CreateKeyPair
&RegionId=cn-hangzhou
&KeyPairName=testKeyPairName
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

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

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

Formato JSON

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

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

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidKeyPairName.Malformed	Specified Key Pair name is not valid.	El nombre del key pair especificado no es válido.
400	KeyPair.AlreadyExist	The key pair already exist.	Ya existe un key pair con el mismo nombre. Los nombres de los key pairs deben ser únicos.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	La clave de la etiqueta ya existe. Las claves de las etiquetas deben ser únicas.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Valor de Tag.N.Key no válido.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Valor de Tag.N.Value no válido.
403	QuotaExceed.KeyPair	The key pair quota exceeds.	Se alcanzó el número máximo de key pairs.
403	QuotaExceed.Tags	%s	Se excedió el número máximo de etiquetas. %s es una variable. Se devuelve dinámicamente un mensaje de error según las condiciones de la llamada.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	No se encontró el resource group.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.