[ aws . pinpoint-sms-voice-v2 ]
describe-pools
Описание
Возвращает указанные пулы или все пулы, связанные с вашей учетной записью Amazon Web Services.
Если вы укажете идентификаторы пулов, вывод будет содержать информацию только для указанных пулов. Если вы укажете фильтры, вывод будет содержать информацию только для тех пулов, которые соответствуют критериям фильтра. Если вы не укажете идентификаторы пулов или фильтры, вывод будет содержать информацию для всех пулов.
Если вы укажете неверный идентификатор пула, будет возвращена ошибка.
Пул — это коллекция телефонных номеров и SenderId. Пул может включать один или несколько телефонных номеров и SenderId, связанных с вашей учетной записью Amazon Web Services.
См. также: Документация API AWS
describe-pools является постраничной операцией. Для получения всего набора результатов могут быть выполнены несколько вызовов API. Вы можете отключить постраничный вывод, задав параметр --no-paginate. При использовании --output text и параметра --query в ответе с постраничным выводом, параметр --query должен извлекать данные из результатов следующих выражений запроса: Pools
Синтаксис
describe-pools
[--pool-ids <value>]
[--filters <value>]
[--owner <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--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]
Параметры
--pool-ids (список)
Уникальный идентификатор пулов для поиска. Это массив строк, которые могут быть либо PoolId, либо PoolArn.
Предупреждение
Если вы используете общий ресурс SMS и голосовой связи AWS End User Messaging, то вы должны использовать полное Amazon Resource Name (ARN).(строка)
Синтаксис:
"string" "string" ...
--filters (список)
Массив объектов PoolFilter для фильтрации результатов.
(структура)
Информация о пуле, удовлетворяющем указанным критериям.
Name -> (строка)
Values -> (список)
Массив значений для фильтрации.
(строка)
Сокращенный синтаксис:
Name=string,Values=string,string ...
Синтаксис JSON:
[
{
"Name": "status"|"message-type"|"two-way-enabled"|"self-managed-opt-outs-enabled"|"opt-out-list-name"|"shared-routes-enabled"|"deletion-protection-enabled"|"two-way-channel-arn",
"Values": ["string", ...]
}
...
]
--owner (строка)
Используйте SELF для фильтрации списка пулов по пулам, принадлежащим вашей учетной записи, или используйте SHARED для фильтрации по пулам, общих с вашей учетной записью. Параметры Owner и PoolIds не могут быть использованы одновременно.
Возможные значения:
SELFSHARED
--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной строки JSON. Строка JSON соответствует формату, предоставленному --generate-cli-skeleton. Если на командной строке предоставляются другие аргументы, эти значения перепишут значения, предоставленные в JSON. Невозможно передавать произвольные двоичные значения с использованием значения, предоставленного в JSON, поскольку строка будет взята буквально. Это не может быть указано вместе с --cli-input-yaml.
--starting-token (строка)
Маркер для указания точки начала постраничного вывода. Это NextToken из ранее усеченного ответа.
Примеры использования см. в разделе «Постраничный вывод» в руководстве пользователя AWS Command Line Interface.
--page-size (целое число)
Размер каждой страницы для получения в вызове AWS-сервиса. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-сервиса, получая меньше элементов в каждом вызове. Это может помочь предотвратить сбой вызовов AWS-сервиса.
Примеры использования см. в разделе «Постраничный вывод» в руководстве пользователя AWS Command Line Interface.
--max-items (целое число)
Общее количество элементов для возврата в выводе команды. Если общее количество доступных элементов превышает указанное значение, в выводе команды предоставляется NextToken. Для возобновления постраничного вывода укажите значение NextToken в параметре starting-token последующей команды. Не используйте элемент ответа NextToken напрямую вне AWS CLI.
Примеры использования см. в разделе «Постраничный вывод» в руководстве пользователя AWS Command Line Interface.
--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.
Вывод
Pools -> (список)
Массив объектов PoolInformation, содержащих подробную информацию о запрошенных пулах.
(структура)
Информация о пуле в учетной записи Amazon Web Services.
PoolArn -> (строка)
PoolId -> (строка)
Status -> (строка)
MessageType -> (строка)
TwoWayEnabled -> (логическое значение)
TwoWayChannelArn -> (строка)
TwoWayChannelRole -> (строка)
SelfManagedOptOutsEnabled -> (логическое значение)
OptOutListName -> (строка)
SharedRoutesEnabled -> (логическое значение)
Позволяет включить общие маршруты для вашего пула.
По умолчанию это установлено в значение False. Если вы устанавливаете это значение в True, ваши сообщения отправляются с использованием телефонных номеров или идентификаторов отправителей (в зависимости от страны), которые общие с другими пользователями. В некоторых странах, таких как США, отправителям не разрешается использовать общие маршруты и они должны использовать выделенный телефонный номер или короткий код.
DeletionProtectionEnabled -> (логическое значение)
CreatedTimestamp -> (временная метка)
NextToken -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.