Spec-Zone.ru › AWS CLI v2

[ aws . quicksight ]

generate-embed-url-for-registered-user-with-identity

Описание

Генерирует URL-адрес для встраивания опыта Amazon QuickSight на вашем веб-сайте. Данное действие может быть использовано для любого зарегистрированного пользователя в учетной записи Amazon QuickSight, использующей IAM Identity Center для аутентификации. Для этого API требуются сессии IAM Role с усиленной аутентификацией для аутентифицированного пользователя, для которого выполняется вызов API.

Это API использует передачу доверенной идентификации для обеспечения аутентификации конечного пользователя и получения URL-адреса для встраивания, специфичного для этого пользователя. Приложение IAM Identity Center, в которое вошёл пользователь, должно иметь включённую передачу доверенной идентификации для Amazon QuickSight со значением области quicksight:read . Перед использованием этого действия убедитесь, что вы настроили соответствующий ресурс и разрешения Amazon QuickSight.

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

Синопсис

  generate-embed-url-for-registered-user-with-identity
--aws-account-id <value>
[--session-lifetime-in-minutes <value>]
--experience-configuration <value>
[--allowed-domains <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]

Параметры

--aws-account-id (строка)

Идентификатор зарегистрированного пользователя Amazon Web Services.

--session-lifetime-in-minutes (целое число)

Срок действия сессии в минутах.

--experience-configuration (структура)

Тип опыта, который вы хотите встроить. Для зарегистрированных пользователей можно встроить панели Amazon QuickSight или консоль Amazon QuickSight.

Примечание

Требуется ровно одна конфигурация опыта. Вы можете выбрать Dashboard или QuickSightConsole. Вы не можете выбрать более одной конфигурации опыта.

Панель –> (структура)

Подробная конфигурация для предоставления опыта встраивания панели.

InitialDashboardId –> (строка)

Идентификатор панели, которую вы хотите, чтобы пользователь увидел в первую очередь. Этот идентификатор включен в выходной URL-адрес. При доступе к URL-адресу в ответе Amazon QuickSight отображает эту панель, если у пользователя есть разрешения на ее просмотр.

Если у пользователя нет разрешения на просмотр этой панели, он увидит сообщение об ошибке разрешений.

FeatureConfigurations –> (структура)

Конфигурации функций встроенной панели Amazon QuickSight.

StatePersistence –> (структура)

Настройки сохранения состояния встроенной панели.

Enabled –> (булево)

Определяет, включены или выключены настройки сохранения состояния панели Amazon QuickSight.

SharedView –> (структура)

Настройки совместного просмотра встроенной панели.

Enabled –> (булево)

Настройки совместного просмотра встроенной панели.

Bookmarks –> (структура)

Конфигурация закладок для встроенной панели в Amazon QuickSight.

Enabled –> (булево)

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

AmazonQInQuickSight –> (структура)

Конфигурации Amazon Q встроенной панели Amazon QuickSight.

ExecutiveSummary –> (структура)

Сгенерированное резюме для встроенной панели Amazon QuickSight.

Enabled –> (булево)

Настройки резюме для встроенной консоли или панели Amazon QuickSight.

Schedules –> (структура)

Конфигурация расписаний для встроенной панели Amazon QuickSight.

Enabled –> (булево)

Конфигурация расписаний для встроенной панели Amazon QuickSight.

RecentSnapshots –> (структура)

Конфигурация последних снимков для встроенной панели Amazon QuickSight.

Enabled –> (булево)

Конфигурация последних снимков для встроенной панели Amazon QuickSight.

ThresholdAlerts –> (структура)

Конфигурация предупреждений по порогам для встроенной панели Amazon QuickSight.

Enabled –> (булево)

Конфигурация предупреждений по порогам для встроенной панели Amazon QuickSight.

QuickSightConsole –> (структура)

Подробная конфигурация для предоставления опыта встраивания каждой консоли Amazon QuickSight. Это можно использовать вместе с пользовательскими разрешениями для ограничения доступа к определенным функциям. Дополнительную информацию см. в разделе «Настройка доступа к консоли Amazon QuickSight» в руководстве пользователя Amazon QuickSight.

Используйте `` GenerateEmbedUrlForRegisteredUser `` там, где требуется создать портал авторизации, позволяющий пользователям создавать источники данных, наборы данных, анализы и панели. Пользователи, которые получают доступ к встроенной консоли Amazon QuickSight, должны принадлежать к группе безопасности авторов или администраторов. Если вы хотите ограничить разрешения на некоторые из этих функций, добавьте профиль пользовательских разрешений в пользователя с помощью операции API `` UpdateUser ``. Используйте операцию API `` RegisterUser `` для добавления нового пользователя с присоединенным профилем пользовательских разрешений. Дополнительную информацию см. в следующих разделах руководства пользователя Amazon QuickSight:

  • Встраивание полной функциональности консоли Amazon QuickSight для авторизованных пользователей
  • Настройка доступа к консоли Amazon QuickSight

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

InitialPath –> (строка)

Начальный путь URL-адреса консоли Amazon QuickSight. Требуется InitialPath.

Адрес URL-адреса входа ограничен следующими путями:

  • /start
  • /start/analyses
  • /start/dashboards
  • /start/favorites
  • /dashboards/DashboardId. DashboardId — фактический идентификатор из URL-адреса панели в консоли Amazon QuickSight.
  • /analyses/AnalysisId. AnalysisId — фактический идентификатор из URL-адреса анализа в консоли Amazon QuickSight.

FeatureConfigurations –> (структура)

Конфигурация встраивания встроенной консоли Amazon QuickSight.

StatePersistence –> (структура)

Настройки сохранения состояния встроенной консоли Amazon QuickSight.

Enabled –> (булево)

Определяет, включены или выключены настройки сохранения состояния панели Amazon QuickSight.

SharedView –> (структура)

Настройки совместного просмотра встроенной панели.

Enabled –> (булево)

Настройки совместного просмотра встроенной панели.

AmazonQInQuickSight –> (структура)

Конфигурации Amazon Q встроенной консоли Amazon QuickSight.

DataQnA –> (структура)

Добавляет возможность генерации ответов на вопросы в встроенной консоли Amazon QuickSight.

Enabled –> (булево)

Настройки генерации ответов на вопросы в встроенной консоли Amazon QuickSight.

GenerativeAuthoring –> (структура)

Добавляет генеративный опыт создания панелей в встроенную консоль Amazon QuickSight.

Enabled –> (булево)

Настройки генеративного опыта создания панелей в встроенной консоли Amazon QuickSight.

ExecutiveSummary –> (структура)

Добавляет функцию резюме в встроенную консоль Amazon QuickSight.

Enabled –> (булево)

Настройки резюме для встроенной консоли или панели Amazon QuickSight.

DataStories –> (структура)

Добавляет функцию историй данных в встроенную консоль Amazon QuickSight.

Enabled –> (булево)

Настройки историй данных для встроенной консоли Amazon QuickSight.

Schedules –> (структура)

Конфигурация расписаний для встроенной панели Amazon QuickSight.

Enabled –> (булево)

Конфигурация расписаний для встроенной панели Amazon QuickSight.

RecentSnapshots –> (структура)

Конфигурация последних снимков для встроенной панели Amazon QuickSight.

Enabled –> (булево)

Конфигурация последних снимков для встроенной панели Amazon QuickSight.

ThresholdAlerts –> (структура)

Конфигурация предупреждений по порогам для встроенной панели Amazon QuickSight.

Enabled –> (булево)

Конфигурация предупреждений по порогам для встроенной панели Amazon QuickSight.

QSearchBar –> (структура)

Подробная конфигурация для встраивания строки поиска Q.

Дополнительную информацию о встраивании строки поиска Q см. в разделе «Обзор встраивания» в руководстве пользователя Amazon QuickSight.

InitialTopicId –> (строка)

Идентификатор устаревшей темы Q, которую вы хотите использовать в качестве начальной темы в строке поиска Q. Чтобы найти идентификатор темы, которую вы хотите использовать, откройте консоль Amazon QuickSight, перейдите к панели «Темы» и выберите нужную тему. TopicID находится в URL-адресе открываемой темы. При выборе начальной темы вы можете указать, разрешено ли читателям выбирать другие темы из списка доступных тем.

Если вы не укажете начальную тему или укажете тему нового опыта чтения, в строке Q будет показан список всех общих устаревших тем.

DashboardVisual –> (структура)

Тип опыта встраивания. В данном случае — визуализации Amazon QuickSight.

InitialDashboardVisualId –> (структура)

Идентификатор визуализации, которую вы хотите встроить пользователю. Этот идентификатор включен в выходной URL-адрес. При доступе к URL-адресу в ответе Amazon QuickSight отображает эту визуализацию.

ARN (имя ресурса Amazon) панели, к которой принадлежит визуализация, должен быть включен в параметр AuthorizedResourceArns. В противном случае запрос завершится ошибкой InvalidParameterValueException.

DashboardId –> (строка)

Идентификатор панели, содержащей визуализацию, которую вы хотите встроить. DashboardId можно найти в разделе IDs for developers панели «Визуализация» в меню визуализации в консоли Amazon QuickSight. Также вы можете получить DashboardId с помощью операции API ListDashboards.

SheetId –> (строка)

Идентификатор листа, содержащего визуализацию, которую вы хотите встроить. SheetId можно найти в разделе IDs for developers панели «Визуализация» в меню визуализации в консоли Amazon QuickSight.

VisualId –> (строка)

Идентификатор визуализации, которую вы хотите встроить. VisualID можно найти в разделе IDs for developers панели «Визуализация» в меню визуализации в консоли Amazon QuickSight.

GenerativeQnA –> (структура)

Подробная конфигурация для встраивания опыта генеративного Q&A.

Дополнительную информацию о встраивании опыта генеративного Q&A см. в разделе «Обзор встраивания» в руководстве пользователя Amazon QuickSight.

InitialTopicId –> (строка)

Идентификатор новой темы опыта чтения Q, которую вы хотите сделать начальной темой в опыте генеративного Q&A. Идентификатор темы можно найти, перейдя в консоль Amazon QuickSight и открыв тему в панели «Темы». Идентификатор находится в URL-адресе открытой темы.

Если вы не укажете начальную тему или укажете устаревшую тему, в опыте генеративного Q&A для ваших читателей будет показан список всех общих новых тем опыта чтения. При выборе новой темы опыта чтения вы можете указать, разрешено ли читателям выбирать другие новые темы опыта чтения из доступного списка.

Синтаксис JSON:

{
  "Dashboard": {
    "InitialDashboardId": "string",
    "FeatureConfigurations": {
      "StatePersistence": {
        "Enabled": true|false
      },
      "SharedView": {
        "Enabled": true|false
      },
      "Bookmarks": {
        "Enabled": true|false
      },
      "AmazonQInQuickSight": {
        "ExecutiveSummary": {
          "Enabled": true|false
        }
      },
      "Schedules": {
        "Enabled": true|false
      },
      "RecentSnapshots": {
        "Enabled": true|false
      },
      "ThresholdAlerts": {
        "Enabled": true|false
      }
    }
  },
  "QuickSightConsole": {
    "InitialPath": "string",
    "FeatureConfigurations": {
      "StatePersistence": {
        "Enabled": true|false
      },
      "SharedView": {
        "Enabled": true|false
      },
      "AmazonQInQuickSight": {
        "DataQnA": {
          "Enabled": true|false
        },
        "GenerativeAuthoring": {
          "Enabled": true|false
        },
        "ExecutiveSummary": {
          "Enabled": true|false
        },
        "DataStories": {
          "Enabled": true|false
        }
      },
      "Schedules": {
        "Enabled": true|false
      },
      "RecentSnapshots": {
        "Enabled": true|false
      },
      "ThresholdAlerts": {
        "Enabled": true|false
      }
    }
  },
  "QSearchBar": {
    "InitialTopicId": "string"
  },
  "DashboardVisual": {
    "InitialDashboardVisualId": {
      "DashboardId": "string",
      "SheetId": "string",
      "VisualId": "string"
    }
  },
  "GenerativeQnA": {
    "InitialTopicId": "string"
  }
}

--allowed-domains (список)

Список доменов, которым разрешено генерировать URL-адрес встраивания.

(строка)

Синтаксис:

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

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

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

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

Вывод

EmbedUrl -> (строка)

Сгенерированный URL для встраивания для зарегистрированного пользователя.

Status -> (целое число)

HTTP-статус запроса.

RequestId -> (строка)

Идентификатор запроса Amazon Web Services для этой операции.

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

Spec-Zone.ru

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