create-user
Описание
Создаёт учётную запись пользователя для указанного экземпляра Amazon Connect.
Предупреждение
Некоторые параметры UserIdentityInfo необходимы в некоторых ситуациях. Например,Email требуется, если вы используете SAML для управления идентификацией. FirstName и LastName необходимы, если вы используете Amazon Connect или SAML для управления идентификацией.Дополнительную информацию о создании пользователей с помощью веб-сайта администрирования Amazon Connect см. в разделе «Добавление пользователей» в руководстве администратора Amazon Connect.
См. также: Документация API AWS
Синтаксис
create-user
--username <value>
[--password <value>]
[--identity-info <value>]
--phone-config <value>
[--directory-user-id <value>]
--security-profile-ids <value>
--routing-profile-id <value>
[--hierarchy-group-id <value>]
--instance-id <value>
[--tags <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]
Параметры
--username (строка)
Имя пользователя для учётной записи. Для экземпляров, не использующих SAML для управления идентификацией, имя пользователя может содержать до 20 символов. Если вы используете SAML для управления идентификацией, имя пользователя может содержать до 64 символов из [a-zA-Z0-9_-.@]+.
Имя пользователя может содержать @ только если используется в формате электронной почты. Например:
- Верно: testuser
- Верно: testuser@example.com
- Неверно: testuser@example
--password (строка)
--identity-info (структура)
Информация об идентификации пользователя.
FirstName -> (строка)
LastName -> (строка)
Email -> (строка)
SecondaryEmail -> (строка)
Дополнительный адрес электронной почты пользователя. Если вы предоставляете дополнительный адрес электронной почты, пользователь получает уведомления по электронной почте (кроме уведомлений о сбросе пароля) на этот адрес электронной почты вместо основного адреса электронной почты.
Шаблон: (?=^.{0,265}$)[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,63}
Mobile -> (строка)
Сокращённый синтаксис:
FirstName=string,LastName=string,Email=string,SecondaryEmail=string,Mobile=string
Синтаксис JSON:
{
"FirstName": "string",
"LastName": "string",
"Email": "string",
"SecondaryEmail": "string",
"Mobile": "string"
}
--phone-config (структура)
Настройки телефона для пользователя.
PhoneType -> (строка)
AutoAccept -> (булево)
AfterContactWorkTimeLimit -> (целое число)
Настройка тайм-аута после завершения работы (ACW) в секундах. Этот параметр имеет минимальное значение 0 и максимальное значение 2 000 000 секунд (24 дня). Введите 0, если вы не хотите выделять определённое количество времени ACW. Это по существу означает неопределённое количество времени. Когда разговор заканчивается, начинается ACW; агент должен выбрать «Закрыть контакт», чтобы завершить ACW.
Примечание
При возврате вызовомSearchUsers, AfterContactWorkTimeLimit возвращается в миллисекундах.DeskPhoneNumber -> (строка)
Сокращённый синтаксис:
PhoneType=string,AutoAccept=boolean,AfterContactWorkTimeLimit=integer,DeskPhoneNumber=string
Синтаксис JSON:
{
"PhoneType": "SOFT_PHONE"|"DESK_PHONE",
"AutoAccept": true|false,
"AfterContactWorkTimeLimit": integer,
"DeskPhoneNumber": "string"
}
--directory-user-id (строка)
Идентификатор учётной записи пользователя в каталоге, используемом для управления идентификацией. Если Amazon Connect не может получить доступ к каталогу, вы можете указать этот идентификатор для проверки подлинности пользователей. Если вы включаете идентификатор, мы предполагаем, что Amazon Connect не может получить доступ к каталогу. В противном случае информация об идентификации используется для проверки подлинности пользователей из вашего каталога.
Этот параметр требуется, если вы используете существующий каталог для управления идентификацией в Amazon Connect, когда Amazon Connect не может получить доступ к вашему каталогу для проверки подлинности пользователей. Если вы используете SAML для управления идентификацией и включаете этот параметр, возвращается ошибка.
--security-profile-ids (список)
Идентификатор профиля безопасности для пользователя.
(строка)
Синтаксис:
"string" "string" ...
--routing-profile-id (строка)
--hierarchy-group-id (строка)
--instance-id (строка)
--tags (карта)
Теги, используемые для организации, отслеживания или управления доступом к этому ресурсу. Например, { “Теги”: {“key1”:”value1”, “key2”:”value2”} }.
ключ -> (строка)
значение -> (строка)
Сокращённый синтаксис:
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 для вывода.
--cli-auto-prompt (булево)
Автоматически запрашивать параметры ввода CLI.
--no-cli-auto-prompt (булево)
Отключить автоматическую запрос параметров ввода CLI.
Примеры
Примечание
Чтобы использовать следующие примеры, необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы в руководстве пользователя AWS CLI.
Если не указано иное, во всех примерах используются правила цитирования, аналогичные Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной оболочки. См. раздел «Использование кавычек со строками» в руководстве пользователя AWS CLI.
Для создания пользователя
В следующем create-user примере добавляется пользователь с указанными атрибутами в указанный экземпляр Amazon Connect.
aws connect create-user \
--username Mary \
--password Pass@Word1 \
--identity-info FirstName=Mary,LastName=Major \
--phone-config PhoneType=DESK_PHONE,AutoAccept=true,AfterContactWorkTimeLimit=60,DeskPhoneNumber=+15555551212 \
--security-profile-id 12345678-1111-2222-aaaa-a1b2c3d4f5g7 \
--routing-profile-id 87654321-9999-3434-abcd-x1y2z3a1b2c3 \
--instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
Вывод:
{
"UserId": "87654321-2222-1234-1234-111234567891",
"UserArn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/agent/87654321-2222-1234-1234-111234567891"
}
Дополнительную информацию см. в разделе «Добавление пользователей» в руководстве администратора Amazon Connect.
Вывод
UserId -> (строка)
UserArn -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.