DescribeKeyPairs

Description

Returns information about key pairs available to you. If you specify key pairs, information about those key pairs is returned. Otherwise, information for all registered key pairs is returned.

Request Parameters

NameDescriptionRequired

KeyName.n

Key pair to describe.

Type: String

Default: Describes all key pairs available to the account.

No

Response Elements

NameDescription

DescribeKeyPairsResponseType

DescribeKeyPairsResponseType element.

Type: DescribeKeyPairsResponseType

Ancestor: None

Children: requestId, keySet

requestId

The ID of the request.

Type: xsd:string

Ancestor: DescribeKeyPairsResponseType

Children: None

keySet

Information for a key pair.

Type: DescribeKeyPairsResponseInfoType

Ancestor: DescribeKeyPairsResponseType

Children: item

item

Information for a key pair.

Type: DescribeKeyPairsResponseItemType

Ancestor: keySet

Children: keyName, keyFingerprint

keyName

The key pair name provided in the original request.

Type: xsd:string

Ancestor: item

Children: None

keyFingerprint

A SHA-1 digest of the DER encoded private key.

Type: xsd:string

Ancestor: item

Children: None

Examples

Example Request

This example describes the state of the gsg-keypair key.

https://ec2.amazonaws.com/?Action=DescribeKeyPairs&KeyName.1=gsg-keypair&AuthParams

Example Response

<DescribeKeyPairsResponse xmlns="http://ec2.amazonaws.com/doc/2009-11-30/">
  <keySet>
    <item>
      <keyName>gsg-keypair</keyName>
      <keyFingerprint>1f:51:ae:28:bf:89:e9:d8:1f:25:5d:37:2d:7d:b8:ca:9f:f5:f1:6f</keyFingerprint>
    </item>
  </keySet>
</DescribeKeyPairsResponse>