本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
适用于:企业版 |
目标受众:Amazon QuickSight 开发者 |
使用嵌入分析的实际过程只涉及几个步骤 QuickSight APIs。
开始之前,请确保下列事项已准备就绪:
-
为将使用 AWS 软件开发工具包进行 API 调用的应用程序使用的来电者身份设置所需的 IAM 权限。例如,授予允许
quicksight:GenerateEmbedUrlForAnonymousUser
或quicksight:GenerateEmbedUrlForRegisteredUser
操作的权限。 -
要为注册用户嵌入,请事先与他们共享 QuickSight 资源。对于新的身份验证用户,请知晓如何授予对资产的访问权限。一种方法是将所有资源添加到一个 QuickSight 文件夹。如果您更喜欢使用 QuickSight API,请使用
DescribeDashboardPermissions
和UpdateDashboardPermissions
API 操作。有关更多信息,请参阅亚马逊 QuickSight API 参考UpdateDashboardPermissions中的DescribeDashboardPermissions或。如果您想与命名空间或用户组中的所有用户共享控制面板,则可以与namespace
或group
共享控制面板。 -
如果您要嵌入控制面板,请确保拥有要嵌入的控制面板 ID。控制面板 ID 是控制面板 URL 中的代码。您也可以从控制面板 URL 中获得该信息。
-
QuickSight 管理员必须明确启用您计划在其中嵌入 QuickSight 分析的域。您可以使用配置文件菜单中的 “管理” QuickSight、“域名” 和 “嵌入” 来执行此操作,也可以使用
GenerateEmbedUrlForAnonymousUser
或GenerateEmbedUrlForRegisteredUser
API 调用的AllowedDomains
参数。此选项仅对 QuickSight 管理员可见。您也可以将子域添加为域的一部分。有关更多信息,请参阅 允许在运行时使用 QuickSight API 列出域名。
必须显式允许静态允许列表中的所有域(如开发、暂存和生产),并且这些域必须使用 HTTPS。最多可以向允许列表添加 100 个域。您可以在运行时通过 QuickSight API 操作添加域名。
完成所有先决条件后,嵌入 QuickSight 涉及以下步骤,稍后将详细说明这些步骤:
您可以使用 AWS CloudTrail 审计日志来获取有关嵌入式仪表板数量、嵌入式体验的用户和访问率的信息。