AWS EC2

List key pairs

Describe the specified key pairs or all of your key pairs.

Inputs

Expand All

Field

Type

Description

region [required]

enum

default: us-east-1

filters

[object]

One or more filters.

Name

string

The name of the filter. Filter names are case-sensitive.

Values

[string]

The filter values. Filter values are case-sensitive. If you specify multiple values for a filter, the values are joined with an OR, and the request returns all results that match any of the specified values.

keyNames

[string]

If specified, only return key pairs matching the provided names.

keyPairIds

[string]

If specified, only return key pairs matching the provided IDs.

Outputs

Expand All

Field

Type

Description

keyPairs

[object]

Information about the key pairs.

KeyPairId

string

The ID of the key pair.

KeyFingerprint

string

If you used CreateKeyPair to create the key pair:

  • For RSA key pairs, the key fingerprint is the SHA-1 digest of the DER encoded private key.
  • For ED25519 key pairs, the key fingerprint is the base64-encoded SHA-256 digest, which is the default for OpenSSH, starting with OpenSSH 6.8.
    If you used ImportKeyPair to provide Amazon Web Services the public key:
  • For RSA key pairs, the key fingerprint is the MD5 public key fingerprint as specified in section 4 of RFC4716.
  • For ED25519 key pairs, the key fingerprint is the base64-encoded SHA-256 digest, which is the default for OpenSSH, starting with OpenSSH 6.8.

KeyName

string

The name of the key pair.

KeyType

string

The type of key pair.

Tags

[object]

Any tags applied to the key pair.

Key

string

The key of the tag. Constraints: Tag keys are case-sensitive and accept a maximum of 127 Unicode characters. May not begin with aws:.

Value

string

The value of the tag.
Constraints: Tag values are case-sensitive and accept a maximum of 256 Unicode characters.

PublicKey

string

The public key material.

CreateTime

date-time

If you used Amazon EC2 to create the key pair, this is the date and time when the key was created, in ISO 8601 date-time format, in the UTC time zone. If you imported an existing key pair to Amazon EC2, this is the date and time the key was imported, in ISO 8601 date-time format, in the UTC time zone.

amzRequestId [required]

string