Shows information about key pairs.
Syntax
euca-describe-keypairs [ keypair_name ] [[--filter "name=value"] ...]
Options
Option |
Description |
Required |
keypair_name |
Key pair name to describe |
No |
-F, --filter name=value |
Filter for limiting the results. See the table in the Available Filters section for a
list of filters. Use quotation marks if the value has a space ("name=value example"). On a Windows system, use quotation marks even without a space in the value ("name=value"). |
No |
Available Filters
You can add filters to your request so that the response includes information for
only certain keypairs. For example, you can use a filter to specify that you want to find
keypairs that include the string lampin their name. Some tips for using filters with this
command:
- You can use multiple values for a filter. Eucalyptus responds with information
for a keypair only if it matches at least one of the filter values that you
specified.
- You can use multiple filters. For example, you can specify keypairs that include the string
lampin their name and that have a specific value in their fingerprint. Eucalyptus responds
with the information for a keypair only if it matches all the filters that
you specified. If there is no match, Eucalyptus returns an empty response.
- You can use wildcards in a filter value. Use an asterisk (*) to match zero or
more characters. Use a question mark (?) to match exactly one character. To
escape special characters, use a backslash (\) before the character. For
example, a value of \*eucalyptus\?\\ searches for the literal string
*eucalyptus?\.
The following are the available filters for
euca-describe-keypairs:
Filter |
Description |
fingerprint |
Fingerprint of the key pair |
key-name |
Name of the keypair |
Common Options
Option |
Description |
--show-empty-fields |
Show empty fields as "(nil)". |
--region user@region |
Region and/or user name to search when looking up config file data. Only valid for EC2
endpoints. |
-U,--url url |
URL of the cloud service to connect to. For administrative commands, this should be <ip_address>:8773/services/Empyrean. |
-I,--access-key-id key_id |
User's access key ID. |
-S,--secret-key secret_key |
User's secret key. |
--security-token token |
User's security token. |
--debug |
Prints what the command sends to the server
and what it receives from the server. Use when
you're trying to debug Euca2ools. |
--debugger |
Enable interactive debugger on error. |
-h,--help |
Display the manual page for the
command. |
--version |
Display the version of this tool. |
Output
- Output type identifier ("KEYPAIR")
- Key pair name
- Private key fingerprint
Example
euca-describe-keypairs
KEYPAIR mykey 52:5f:e7:03:67:ad:b5:f3:65:4b:94:77:90:61:5f:1e:44:96:74:62