Spec-Zone.ru › AWS CLI v2

[ aws . quicksight ]

generate-embed-url-for-registered-user

Описание

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

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

  • Он содержит временный токен доступа. Он действителен в течение 5 минут после генерации. После использования в течение этого периода он больше не может быть повторно использован.
  • Срок действия URL-адреса не следует путать с фактическим сроком действия сессии, который можно настроить с помощью параметра `` SessionLifetimeInMinutes ``. Результирующая сессия пользователя действительна от 15 минут (минимум) до 10 часов (максимум). По умолчанию срок действия сессии составляет 10 часов.
  • Вы оплачиваете только при использовании URL-адреса или при взаимодействии с Amazon QuickSight.

Дополнительную информацию см. в разделе «Встраиваемые аналитические возможности» в Руководстве пользователя Amazon QuickSight.

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

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

Синтаксис

  generate-embed-url-for-registered-user
--aws-account-id <value>
[--session-lifetime-in-minutes <value>]
--user-arn <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 (целое число)

Сколько минут сессия действительна. Время жизни сессии должно быть в диапазоне от 15 до 600 минут.

--user-arn (строка)

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

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

Тип встраиваемого элемента. Для зарегистрированных пользователей вы можете встроить панели Amazon QuickSight, визуализации Amazon QuickSight, поле поиска Amazon QuickSight Q, функциональность генеративных ответов Amazon QuickSight Q&A или всю консоль Amazon QuickSight.

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

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

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.

Используйте `` 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 -> (структура)

Добавляет возможности генеративного Q&A встраиваемой консоли Amazon QuickSight.

Enabled -> (булево)

Настройки генеративного Q&A для встраиваемой консоли 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, перейдите в раздел «Темы» и выберите нужную тему. Идентификатор темы находится в URL-адресе открывающейся темы. При выборе начальной темы вы можете указать, разрешено ли пользователям выбирать другие темы из списка доступных тем.

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

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

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

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

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

Идентификатор ARN панели, к которой принадлежит визуализация, должен быть указан в параметре 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 -> (структура)

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

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

InitialTopicId -> (строка)

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

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

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-адресу, который затем будет встроен. Этот необязательный параметр переопределяет статические домены, настроенные в меню «Управление QuickSight» в консоли Amazon QuickSight. Вместо этого он разрешает доступ только тем доменам, которые вы включите в этот параметр. Вы можете указать до трех доменов или поддоменов в каждом вызове API.

Чтобы включить все поддомены определенного домена в разрешенный список, используйте *. Например, https://*.sapp.amazon.com включает все поддомены домена https://sapp.amazon.com.

(строка)

Синтаксис:

"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 версии 1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого файла, которое соответствует двоичному блоку, 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.

Вывод

EmbedUrl -> (строка)

URL встраивания для панели Amazon QuickSight, визуализации, строки поиска Q, опыта Generative Q&A или консоли.

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

HTTP-код состояния запроса.

RequestId -> (строка)

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

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

Spec-Zone.ru

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