本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
使用 QuickSight API 嵌入
適用於:企業版 |
目標受眾:Amazon QuickSight 開發者 |
使用 QuickSight API 嵌入分析的實際程序只涉及幾個步驟。
開始前,請確定您有下列項目:
-
為您的應用程式使用的呼叫者身分設定必要的 IAM 許可,以使用 AWS SDK 進行 API 呼叫。例如,授予允許
quicksight:GenerateEmbedUrlForAnonymousUser
或quicksight:GenerateEmbedUrlForRegisteredUser
動作的許可。 -
若要為已註冊使用者嵌入,請事先與他們共用 QuickSight 資產。對於新的驗證使用者,請了解如何授予資產存取權。執行此操作的一種方法是將所有資產添加到 QuickSight 文件夾中。如果您偏好使用 QuickSight API,請使用
DescribeDashboardPermissions
和UpdateDashboardPermissions
API 作業。如需詳細資訊,請參閱 Amazon 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 稽核記錄來取得內嵌儀表板的數量、內嵌體驗的使用者以及存取率的相關資訊。