Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

describe-key-pairs

Описание

Описывает указанные пары ключей или все ваши пары ключей.

Дополнительную информацию о парах ключей см. в разделе «Пары ключей Amazon EC2» в руководстве пользователя Amazon EC2.

См. также: Документацию API AWS

Синтаксис

  describe-key-pairs
[--key-names <value>]
[--key-pair-ids <value>]
[--include-public-key | --no-include-public-key]
[--dry-run | --no-dry-run]
[--filters <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--key-names (список)

Имена пар ключей.

По умолчанию: описывает все ваши пары ключей.

(строка)

Синтаксис:

"string" "string" ...

--key-pair-ids (список)

Идентификаторы пар ключей.

(строка)

Синтаксис:

"string" "string" ...

--include-public-key | --no-include-public-key (булево)

Если true , общедоступный ключ содержится в ответе.

По умолчанию: false

--dry-run | --no-dry-run (булево)

Проверяет наличие необходимых разрешений для действия, не выполняя фактический запрос, и предоставляет ответ об ошибке. Если у вас есть необходимые разрешения, ответ об ошибке DryRunOperation . В противном случае, он UnauthorizedOperation .

--filters (список)

Фильтры.

  • key-pair-id - Идентификатор пары ключей.
  • fingerprint - Отпечаток пальца пары ключей.
  • key-name - Имя пары ключей.
  • tag-key - Ключ метки, назначенной ресурсу. Используйте этот фильтр для поиска всех ресурсов, которым назначена метка с определенным ключом, независимо от значения метки.
  • tag :<key> - Комбинация ключ/значение метки, назначенной ресурсу. Используйте ключ метки в имени фильтра и значение метки в качестве значения фильтра. Например, чтобы найти все ресурсы, имеющие метку с ключом Owner и значением TeamA , укажите tag:Owner для имени фильтра и TeamA для значения фильтра.

(структура)

Пара имя-значение фильтра, используемая для возвращения более конкретного списка результатов из операции описания. Фильтры могут использоваться для сопоставления набора ресурсов по определенным критериям, таким как метки, атрибуты или идентификаторы.

Если вы укажете несколько фильтров, фильтры будут объединены с помощью AND , и запрос вернет только результаты, которые соответствуют всем указанным фильтрам.

Дополнительную информацию см. в разделе «Список и фильтрация с помощью командной строки и API» в руководстве пользователя Amazon EC2.

Имя -> (строка)

Имя фильтра. Имена фильтров чувствительны к регистру.

Значения -> (список)

Значения фильтра. Значения фильтров чувствительны к регистру. Если вы укажете несколько значений для фильтра, значения будут объединены с помощью OR , и запрос вернет все результаты, которые соответствуют любому из указанных значений.

(строка)

Сокращенный синтаксис:

Name=string,Values=string,string ...

Синтаксис JSON:

[
  {
    "Name": "string",
    "Values": ["string", ...]
  }
  ...
]

--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной строки JSON. Строка JSON соответствует формату, предоставленному --generate-cli-skeleton. Если другие аргументы указаны в командной строке, эти значения переопределят значения, предоставленные JSON. Невозможно передать произвольные двоичные значения с помощью предоставленного значения JSON, так как строка будет воспринята буквально. Это не может быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (строка) Выводит каркас JSON в стандартный вывод без отправки запроса API. Если предоставлено значение null или значение input , выводит пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если предоставлено yaml-input , он выведет пример входного YAML, который можно использовать с --cli-input-yaml. Если предоставлено значение output , он проверит входные данные команды и вернет пример выходного JSON для этой команды. Сгенерированный каркас JSON не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном каркасе JSON.

Глобальные параметры

--debug (булево)

Включить отладку.

--endpoint-url (строка)

Переопределить URL по умолчанию команды заданным URL.

--no-verify-ssl (булево)

По умолчанию AWS CLI использует SSL при общении с сервисами AWS. Для каждого подключения SSL AWS CLI проверит сертификаты SSL. Этот параметр переопределяет поведение по умолчанию проверки SSL-сертификатов.

--no-paginate (булево)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования для вывода команды.

  • json
  • текст
  • таблица
  • yaml
  • yaml-потоковый

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использование определенного профиля из файла учетных данных.

--region (строка)

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (строка)

Отобразить версию этого инструмента.

--color (строка)

Включение/выключение цветного вывода.

  • включено
  • выключено
  • авто

--no-sign-request (булево)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент указан.

--ca-bundle (строка)

Файл сертификатов CA для использования при проверке SSL-сертификатов. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет выполняться блокирующим образом и без таймаута. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет выполняться блокирующим образом и без таймаута. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (строка)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, а двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, которое сопоставляется с двоичным блоком, fileb:// всегда будет обрабатываться как двоичный и использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.

  • base64
  • raw-in-base64-out

--no-cli-pager (булево)

Отключить постраничную навигацию CLI для вывода.

--cli-auto-prompt (булево)

Автоматически запросить параметры ввода CLI.

--no-cli-auto-prompt (булево)

Отключить автоматический запрос параметров ввода CLI.

Примеры

Примечание

Чтобы использовать следующие примеры, необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве пользователя AWS CLI в разделе «Начало работы».

Если не указано иное, во всех примерах используются правила цитирования, аналогичные правилам Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки терминала. См. использование кавычек со строками в руководстве пользователя AWS CLI.

Для отображения пары ключей

Следующий describe-key-pairs пример отображает информацию об указанной паре ключей.

aws ec2 describe-key-pairs \
    --key-names my-key-pair

Вывод:

{
    "KeyPairs": [
        {
            "KeyPairId": "key-0b94643da6EXAMPLE",
            "KeyFingerprint": "1f:51:ae:28:bf:89:e9:d8:1f:25:5d:37:2d:7d:b8:ca:9f:f5:f1:6f",
            "KeyName": "my-key-pair",
            "KeyType": "rsa",
            "Tags": [],
            "CreateTime": "2022-05-27T21:51:16.000Z"
        }
    ]
}

Дополнительную информацию см. в разделе «Описание общедоступных ключей» в руководстве пользователя Amazon EC2.

Вывод

KeyPairs -> (список)

Информация о парах ключей.

(структура)

Описание пары ключей.

KeyPairId -> (строка)

Идентификатор пары ключей.

KeyType -> (строка)

Тип пары ключей.

Метки -> (список)

Любые метки, примененные к паре ключей.

(структура)

Описание метки.

Ключ -> (строка)

Ключ метки.

Ограничения: ключи меток чувствительны к регистру и принимают максимум 127 символов Юникода. Не может начинаться с aws: .

Значение -> (строка)

Значение метки.

Ограничения: значения меток чувствительны к регистру и принимают максимум 256 символов Юникода.

PublicKey -> (строка)

Общедоступный ключ.

CreateTime -> (метка времени)

Если вы создали пару ключей с помощью Amazon EC2, это дата и время создания ключа в формате ISO 8601, в часовом поясе UTC.

Если вы импортировали существующую пару ключей в Amazon EC2, это дата и время импорта ключа в формате ISO 8601, в часовом поясе UTC.

KeyName -> (строка)

Имя пары ключей.

KeyFingerprint -> (строка)

Если вы использовали CreateKeyPair для создания пары ключей:

  • Для пар ключей RSA отпечаток ключа — SHA-1 дайджест кодированного в DER закрытого ключа.
  • Для пар ключей ED25519 отпечаток ключа — закодированный в base64 SHA-256 дайджест, который является значением по умолчанию для OpenSSH, начиная с OpenSSH 6.8.

Если вы использовали ImportKeyPair для предоставления Amazon Web Services общедоступного ключа:

  • Для пар ключей RSA отпечаток ключа — MD5 отпечаток общедоступного ключа, как указано в разделе 4 RFC4716.
  • Для пар ключей ED25519 отпечаток ключа — закодированный в base64 SHA-256 дайджест, который является значением по умолчанию для OpenSSH, начиная с OpenSSH 6.8.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API