Spec-Zone.ru › AWS CLI v2

[ aws . pinpoint ]

get-endpoint

Описание

Получает информацию о настройках и атрибутах конкретного конечной точки для приложения.

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

Синтаксис

  get-endpoint
--application-id <value>
--endpoint-id <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]

Параметры

--application-id (строка)

Уникальный идентификатор приложения. Этот идентификатор отображается как Идентификатор проекта на консоли Amazon Pinpoint.

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

Уникальный идентификатор конечной точки, нечувствительный к регистру. Идентификатор не может содержать $ , { или } .

--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
  • text
  • table
  • yaml
  • yaml-stream

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

  • on
  • off
  • auto

--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.

Для получения информации о настройках и атрибутах конкретной конечной точки для приложения

Следующий get-endpoint пример получает информацию о настройках и атрибутах конкретной конечной точки для приложения.

aws pinpoint get-endpoint \
    --application-id 611e3e3cdd47474c9c1399a505665b91 \
    --endpoint-id testendpoint \
    --region us-east-1

Вывод:

{
    "EndpointResponse": {
        "Address": "+11234567890",
        "ApplicationId": "611e3e3cdd47474c9c1399a505665b91",
        "Attributes": {},
        "ChannelType": "SMS",
        "CohortId": "63",
        "CreationDate": "2019-01-28T23:55:11.534Z",
        "EffectiveDate": "2021-08-06T00:04:51.763Z",
        "EndpointStatus": "ACTIVE",
        "Id": "testendpoint",
        "Location": {
            "Country": "USA"
        },
        "Metrics": {
            "SmsDelivered": 1.0
        },
        "OptOut": "ALL",
        "RequestId": "a204b1f2-7e26-48a7-9c80-b49a2143489d",
        "User": {
            "UserAttributes": {
                "Age": [
                    "24"
                ]
            },
        "UserId": "testuser"
        }
    }
}

Вывод

EndpointResponse -> (структура)

Предоставляет информацию о типе канала и других настройках для конечной точки.

Address -> (строка)

Адрес назначения для сообщений или push-уведомлений, которые вы отправляете на конечную точку. Адрес зависит от канала. Например, адрес для канала push-уведомлений обычно представляет собой токен, предоставленный службой push-уведомлений, например, токен устройства Apple Push Notification Service (APNs) или токен регистрации Firebase Cloud Messaging (FCM). Адрес для канала SMS — это номер телефона в формате E.164, например +12065550100. Адрес для канала электронной почты — это адрес электронной почты.

ApplicationId -> (строка)

Уникальный идентификатор приложения, связанного с конечной точкой.

Attributes -> (карта)

Один или несколько пользовательских атрибутов, описывающих конечную точку, связывая имя с массивом значений. Например, значение пользовательского атрибута с именем Interests может быть: [“Наука”, “Музыка”, “Путешествия”]. Вы можете использовать эти атрибуты в качестве критериев фильтрации при создании сегментов.

key -> (строка)

value -> (список)

(строка)

ChannelType -> (строка)

Канал, используемый при отправке сообщений или push-уведомлений на конечную точку.

CohortId -> (строка)

Число от 0 до 99, представляющее когорту, к которой относится конечная точка. Конечные точки группируются по когортам случайным образом, и каждая когорта содержит приблизительно 1 процент конечных точек для приложения. Amazon Pinpoint назначает когортам распределения «holdout» или «treatment» для кампаний.

CreationDate -> (строка)

Дата и время создания конечной точки в формате ISO 8601.

Demographic -> (структура)

Демографическая информация о конечной точке, такая как часовой пояс и платформа.

AppVersion -> (строка)

Версия приложения, связанного с конечной точкой.

Locale -> (строка)

Локализация конечной точки в формате: двухбуквенный код ISO 639-1, за которым следует символ подчеркивания (_), за которым следует двухбуквенный код ISO 3166-1.

Make -> (строка)

Производитель устройства конечной точки, например apple или samsung.

Model -> (строка)

Наименование или номер модели устройства конечной точки, например iPhone или SM-G900F.

ModelVersion -> (строка)

Версия модели устройства конечной точки.

Platform -> (строка)

Платформа устройства конечной точки, например ios.

PlatformVersion -> (строка)

Версия платформы устройства конечной точки.

Timezone -> (строка)

Часовой пояс конечной точки, указанный как имя базы данных часовых поясов, например America/Los_Angeles.

EffectiveDate -> (строка)

Дата и время последнего обновления конечной точки в формате ISO 8601.

EndpointStatus -> (строка)

Указывает, отправляются ли сообщения или push-уведомления на конечную точку. Возможные значения: ACTIVE (сообщения отправляются на конечную точку) и INACTIVE (сообщения на конечную точку не отправляются).

Amazon Pinpoint автоматически устанавливает это значение в ACTIVE при создании или обновлении существующей конечной точки. Amazon Pinpoint автоматически устанавливает это значение в INACTIVE, если вы обновите другую конечную точку, имеющую тот же адрес, указанный в свойстве Address.

Id -> (строка)

Уникальный идентификатор, назначенный вами конечной точке. Идентификатор должен быть глобально уникальным идентификатором (GUID), чтобы избежать конфликтов с другими идентификаторами конечных точек, связанными с приложением.

Location -> (структура)

Географическая информация о конечной точке.

City -> (строка)

Название города, где расположена конечная точка.

Country -> (строка)

Двухбуквенный код ISO 3166-1 alpha-2 для страны или региона, где расположена конечная точка. Например, US для США.

Latitude -> (число с плавающей запятой)

Координата широты местоположения конечной точки, округлённая до одного десятичного знака.

Longitude -> (число с плавающей запятой)

Координата долготы местоположения конечной точки, округлённая до одного десятичного знака.

PostalCode -> (строка)

Почтовый индекс района, где расположена конечная точка.

Region -> (строка)

Название региона, в котором расположена конечная точка. Для мест в США это название штата.

Metrics -> (карта)

Один или несколько пользовательских показателей, которые ваше приложение сообщает Amazon Pinpoint для конечной точки.

key -> (строка)

value -> (число с плавающей запятой)

OptOut -> (строка)

Указывает, отказался ли пользователь, связанный с конечной точкой, от получения сообщений и push-уведомлений от вас. Возможные значения: ALL (пользователь отказался от всех сообщений и push-уведомлений) и NONE (пользователь не отказался и хочет получать все сообщения и push-уведомления).

RequestId -> (строка)

Уникальный идентификатор последнего запроса на обновление конечной точки.

User -> (структура)

Один или несколько пользовательских атрибутов пользователя, которые ваше приложение сообщает Amazon Pinpoint для пользователя, связанного с конечной точкой.

UserAttributes -> (карта)

Один или несколько пользовательских атрибутов, описывающих пользователя, связывая имя с массивом значений. Например, значение атрибута с именем Interests может быть: [“Наука”, “Музыка”, “Путешествия”]. Вы можете использовать эти атрибуты в качестве критериев фильтрации при создании сегментов. Имена атрибутов чувствительны к регистру.

Имя атрибута может содержать до 50 символов. Значение атрибута может содержать до 100 символов. При определении имени пользовательского атрибута избегайте использования следующих символов: диез (#), двоеточие (:), знак вопроса (?), обратный слэш (\) и слэш (/). Консоль Amazon Pinpoint не может отображать имена атрибутов, содержащие эти символы. Это ограничение не применяется к значениям атрибутов.

key -> (строка)

value -> (список)

(строка)

UserId -> (строка)

Уникальный идентификатор пользователя.

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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