Spec-Zone.ru › AWS CLI v2

[ aws . cognito-idp ]

обновление-атрибутов-пользователя

Описание

Обновляет указанные атрибуты пользователя. Чтобы удалить атрибут у пользователя, отправьте атрибут в запросе API со значением пустой строки.

Для пользовательских атрибутов необходимо добавить префикс custom: к имени атрибута, например custom:department.

Данная операция может установить электронный адрес пользователя или номер телефона как подтверждённые и разрешить мгновенный вход в пулы пользователей, которые требуют подтверждения этих атрибутов. Для этого установите атрибут email_verified или phone_number_verified со значением true.

Примечание

Amazon Cognito оценивает политики управления идентификацией и доступом (IAM) в запросах для этой операции API. Для этой операции вы должны использовать учетные данные IAM для авторизации запросов и предоставить себе соответствующее разрешение IAM в политике.

Дополнительная информация
  • Подписание запросов API Amazon Web Services
  • Использование API пулов пользователей Amazon Cognito и конечных точек пулов пользователей

Примечание

Данное действие может генерировать текстовое SMS-сообщение. Начиная с 1 июня 2021 года, операторы связи США требуют регистрировать номер отправки перед отправкой SMS-сообщений на номера телефонов в США. Если вы используете SMS-сообщения в Amazon Cognito, вы должны зарегистрировать номер телефона в Amazon Pinpoint. Amazon Cognito автоматически использует зарегистрированный номер. В противном случае пользователи Amazon Cognito, которым необходимо получать SMS-сообщения, могут не иметь возможности зарегистрироваться, активировать свои учетные записи или войти в систему.

Если вы никогда не использовали SMS-сообщения с Amazon Cognito или любой другой службой Amazon Web Services, Amazon Simple Notification Service может поместить вашу учетную запись в песочницу SMS. В *режиме песочницы* вы можете отправлять сообщения только на проверенные номера телефонов. После тестирования приложения в среде песочницы вы можете выйти из песочницы и перейти в производство. Дополнительную информацию см. в разделе Настройки SMS-сообщений для пулов пользователей Amazon Cognito в руководстве разработчика Amazon Cognito.

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

Синтаксис

  admin-update-user-attributes
--user-pool-id <value>
--username <value>
--user-attributes <value>
[--client-metadata <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-pool-id (строка)

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

--username (строка)

Имя пользователя, который вы хотите запросить или изменить. Значение этого параметра обычно является именем пользователя, но может быть любым из его атрибутов псевдонима. Если username не является атрибутом псевдонима в вашем пуле пользователей, это значение должно быть sub локального пользователя или именем пользователя из стороннего IdP.

--user-attributes (список)

Массив пар имя-значение, представляющих атрибуты пользователя.

Для пользовательских атрибутов необходимо добавить префикс custom: к имени атрибута.

Если вашему пулу пользователей требуется проверка перед обновлением Amazon Cognito значения атрибута, указанного в этом запросе, Amazon Cognito немедленно не обновляет значение этого атрибута. После того, как ваш пользователь получит и ответит на сообщение о проверке для проверки нового значения, Amazon Cognito обновляет значение атрибута. Ваш пользователь может войти в систему и получать сообщения со значением исходного атрибута до тех пор, пока не проверит новое значение.

Чтобы пропустить сообщение о проверке и обновить значение атрибута, требующего проверки в том же запросе API, включите атрибут email_verified или phone_number_verified со значением true. Если вы зададите значение email_verified или phone_number_verified для атрибута email или phone_number, требующего проверки, на true, Amazon Cognito не отправляет сообщение о проверке вашему пользователю.

(структура)

Имя и значение атрибута пользователя.

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

Имя атрибута.

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

Значение атрибута.

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

Name=string,Value=string ...

Синтаксис JSON:

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

--client-metadata (карта)

Карта пользовательских пар ключ-значение, которые вы можете предоставить в качестве входных данных для любых пользовательских рабочих процессов, которые запускает это действие.

Вы создаете пользовательские рабочие процессы, назначая функции Lambda для триггеров пула пользователей. При использовании действия AdminUpdateUserAttributes API Amazon Cognito вызывает функцию, назначенную триггеру *настраиваемого сообщения*. При вызове Amazon Cognito этой функции она передает JSON-полезную нагрузку, которая принимается функцией в качестве входных данных. Эта полезная нагрузка содержит атрибут clientMetadata, который предоставляет данные, которые вы назначили параметру ClientMetadata в вашем запросе AdminUpdateUserAttributes. В коде функции в Lambda вы можете обработать значение clientMetadata, чтобы улучшить рабочий процесс под ваши нужды.

Дополнительную информацию см. в разделе Использование триггеров Lambda в руководстве разработчика Amazon Cognito.

Примечание

При использовании параметра ClientMetadata обратите внимание, что Amazon Cognito не выполняет следующие действия:

  • Сохранение значения ClientMetadata. Эти данные доступны только триггерам Lambda, назначенным пулу пользователей для поддержки пользовательских рабочих процессов. Если в конфигурации вашего пула пользователей отсутствуют триггеры, параметр ClientMetadata не нужен.
  • Проверка значения ClientMetadata.
  • Шифрование значения ClientMetadata. Не отправляйте конфиденциальную информацию в этот параметр.

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

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

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

KeyName1=string,KeyName2=string

Синтаксис JSON:

{"string": "string"
  ...}

--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-auto-prompt (логическое значение)

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

--no-cli-auto-prompt (логическое значение)

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

Примеры

Примечание

Чтобы использовать следующие примеры, вы должны иметь установленный и настроенный AWS CLI. Подробнее см. в руководстве по началу работы с AWS CLI в руководстве пользователя AWS CLI.

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

Для обновления атрибутов пользователя

В этом примере обновляется пользовательский атрибут CustomAttr1 для пользователя diego@example.com.

Команда:

aws cognito-idp admin-update-user-attributes --user-pool-id us-west-2_aaaaaaaaa --username diego@example.com --user-attributes Name="custom:CustomAttr1",Value="Purple"

Вывод

Отсутствует

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

Spec-Zone.ru

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