Spec-Zone.ru › AWS CLI v2

[ aws . iam ]

get-user

Описание

Получает информацию о заданном пользователе IAM, включая дату создания пользователя, путь, уникальный идентификатор и ARN.

Если имя пользователя не указано, IAM определяет имя пользователя неявно на основе идентификатора ключа доступа к Amazon Web Services, используемого для подписания запроса к этой операции.

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

Синтаксис

  get-user
[--user-name <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]

Параметры

--user-name (строка)

Имя пользователя, о котором требуется получить информацию.

Этот параметр необязателен. Если он не указан, по умолчанию используется имя пользователя, выполняющего запрос. Этот параметр позволяет (через шаблон регулярного выражения) строку символов, состоящую из буквенно-цифровых символов верхнего и нижнего регистра без пробелов. Вы также можете включить любые из следующих символов: _+=,.@-

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

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса к API. Если указано значение без значения или значение 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.

Получение информации о пользователе IAM

Следующая get-user команда получает информацию о пользователе IAM с именем Paulo.

aws iam get-user \
    --user-name Paulo

Вывод:

{
    "User": {
        "UserName": "Paulo",
        "Path": "/",
        "CreateDate": "2019-09-21T23:03:13Z",
        "UserId": "AIDA123456789EXAMPLE",
        "Arn": "arn:aws:iam::123456789012:user/Paulo"
    }
}

Дополнительную информацию см. в разделе Управление пользователями IAM в руководстве пользователя AWS IAM.

Вывод

Пользователь -> (структура)

Структура, содержащая подробную информацию о пользователе IAM.

Предупреждение

Из-за проблемы с сервисом данные о последнем использовании пароля не включают использование пароля с 3 мая 2018 г. 22:50 PDT по 23 мая 2018 г. 14:08 PDT. Это влияет на даты последнего входа, отображаемые в консоли IAM, и даты последнего использования пароля в отчете об учетных данных IAM, а также возвращаемые этой операцией. Если пользователи вошли в систему в указанное время, дата последнего использования пароля, возвращаемая, — это дата последнего входа пользователя до 3 мая 2018 г. Для пользователей, которые вошли в систему после 23 мая 2018 г. 14:08 PDT, возвращаемая дата последнего использования пароля является точной.

Вы можете использовать информацию о последнем использовании пароля, чтобы определить неиспользуемые учетные данные для удаления. Например, вы можете удалить пользователей, которые не входили в Amazon Web Services в течение последних 90 дней. В таких случаях мы рекомендуем вам скорректировать период оценки, включив даты после 23 мая 2018 г. В качестве альтернативы, если ваши пользователи используют ключи доступа для программного доступа к Amazon Web Services, вы можете обратиться к информации о последнем использовании ключей доступа, поскольку она является точной для всех дат.

Путь -> (строка)

Путь к пользователю. Дополнительную информацию о путях см. в разделе Идентификаторы IAM в руководстве пользователя IAM.

ARN политики, используемой для установки границ разрешений для пользователя.

Имя пользователя -> (строка)

Дружественное имя, идентифицирующее пользователя.

Идентификатор пользователя -> (строка)

Устойчивая и уникальная строка, идентифицирующая пользователя. Дополнительную информацию об идентификаторах см. в разделе Идентификаторы IAM в руководстве пользователя IAM.

Arn -> (строка)

Amazon Resource Name (ARN), который идентифицирует пользователя. Дополнительную информацию об ARN и о том, как использовать ARN в политиках, см. в разделе Идентификаторы IAM в руководстве пользователя IAM.

Дата создания -> (метка времени)

Дата и время создания пользователя в формате ISO 8601.

Последнее использование пароля -> (метка времени)

Дата и время, в формате ISO 8601, когда пароль пользователя был последний раз использован для входа в веб-сайт Amazon Web Services. Список веб-сайтов Amazon Web Services, которые фиксируют время последнего входа пользователя, см. в разделе Отчеты об учетных данных в руководстве пользователя IAM. Если пароль используется более одного раза в течение пятиминутного интервала, в этом поле возвращается только первое использование. Если поле равно NULL (без значения), это указывает, что пользователь никогда не входил в систему с помощью пароля. Это может быть из-за:

  • У пользователя никогда не было пароля.
  • Пароль существует, но не использовался с тех пор, как IAM начал отслеживать эту информацию 20 октября 2014 г.

Значение NULL не означает, что у пользователя никогда не было пароля. Кроме того, если у пользователя сейчас нет пароля, но он был в прошлом, в этом поле отображается дата и время использования последнего пароля.

Это значение возвращается только в операциях GetUser и ListUsers.

Пределы разрешений -> (структура)

Дополнительную информацию о границах разрешений см. в разделе Границы разрешений для идентификаторов IAM в руководстве пользователя IAM.

Тип Пределов разрешений -> (строка)

Тип использования границ разрешений, указывающий, какой тип ресурса IAM используется в качестве границ разрешений для сущности. Этот тип данных может иметь значение только Policy.

PermissionsBoundaryArn -> (строка)

ARN политики, используемой для установки границ разрешений для пользователя или роли.

Теги -> (список)

Список тегов, связанных с пользователем. Дополнительную информацию о тегах см. в разделе Тегирование ресурсов IAM в руководстве пользователя IAM.

(структура)

Структура, представляющая пользовательские метаданные, которые можно связать с ресурсом IAM. Дополнительную информацию о тегах см. в разделе Тегирование ресурсов IAM в руководстве пользователя IAM.

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

Имя ключа, которое можно использовать для поиска или извлечения связанного значения. Например, Department или Cost Center — распространенные варианты.

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

Значение, связанное с этим тегом. Например, теги с именем ключа Department могут иметь значения, такие как Human Resources, Accounting и Support. Теги с именем ключа Cost Center могут иметь значения, состоящие из номера, связанного с различными центрами затрат в вашей компании. Как правило, у многих ресурсов есть теги с одинаковым именем ключа, но с разными значениями.

Примечание

Amazon Web Services всегда интерпретирует тег Value как одну строку. Если вам необходимо хранить массив, вы можете хранить значения, разделенные запятыми, в строке. Однако вы должны интерпретировать значение в своем коде.

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

Spec-Zone.ru

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