Method Detail

• importKeyPairInRegion

  @Named(value="keypair:import")
  @POST
  @Path(value="/")
  KeyPair importKeyPairInRegion(String region,
                                              @FormParam(value="KeyName")
                                              String keyName,
                                              @FormParam(value="PublicKeyMaterial")
                                              String publicKeyMaterial)

  Imports the public key from an RSA key pair that you created with a third-party tool. Compare this with CreateKeyPair, in which AWS creates the key pair and gives the keys to you (Nova keeps a copy of the public key). With ImportKeyPair, you create the key pair and give Nova just the public key. The private key is never transferred between you and Nova.

  You can easily create an RSA key pair on Windows and Linux using the ssh-keygen command line tool (provided with the standard OpenSSH installation). Standard library support for RSA key pair creation is also available in Java, Ruby, Python, and many other programming languages.

  Supported Formats

  • OpenSSH public key format (e.g., the format in ~/.ssh/authorized_keys)
  • Base64 encoded DER format
  • SSH public key file format as specified in RFC4716

  DSA keys are not supported. Make sure your key generator is set up to create RSA keys.

  Supported lengths: 1024, 2048, and 4096.

  Parameters:

  region - region to import the key into

  keyName - A unique name for the key pair. Accepts alphanumeric characters, spaces, dashes, and underscores.

  publicKeyMaterial - The public key

  Returns:

  imported key including fingerprint