使用 Amazon 內嵌 QuickSight APIs - Amazon QuickSight

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用 Amazon 內嵌 QuickSight APIs

 適用於：企業版 
   目標對象：Amazon QuickSight 開發人員 

使用 內嵌分析的實際程序只涉及幾個步驟 QuickSight APIs。

開始前，請確定您有下列項目：

  • 為您的應用程式使用的呼叫者身分設定必要的IAM許可，以使用 AWS SDK進行API呼叫。例如，授予允許 quicksight:GenerateEmbedUrlForAnonymousUser 或 quicksight:GenerateEmbedUrlForRegisteredUser 動作的許可。

  • 若要內嵌已註冊使用者，請事先與他們共用 QuickSight 資產。對於新的驗證使用者，請了解如何授予資產存取權。其中一個方法是將所有資產新增至 QuickSight 資料夾。如果您想要使用 QuickSight API，請使用 DescribeDashboardPermissions和 UpdateDashboardPermissionsAPI操作。如需詳細資訊，請參閱 Amazon QuickSight API 參考UpdateDashboardPermissions中的 DescribeDashboardPermissions或 。如果您想要與命名空間或群組中的所有使用者共用儀表板，您可以與 namespace 或 group 共用儀表板。

  • 如果您要嵌入儀表板，請確保具有要嵌入的儀表板的 ID。儀表板 ID 是儀表板 URL 中的程式碼。您也可以從儀表板 取得URL。

  • QuickSight 管理員必須明確啟用您計劃內嵌 QuickSight 分析的網域。您可以使用設定檔功能表中的管理 QuickSight、網域和內嵌，或使用 GenerateEmbedUrlForAnonymousUser或 GenerateEmbedUrlForRegisteredUserAPI呼叫的 AllowedDomains 參數來執行此操作。

    只有 QuickSight 管理員可以看到此選項。您也可以將子網域新增為域的一部分。如需詳細資訊，請參閱允許在執行時間使用 列出網域 QuickSight API。

    靜態允許清單中的所有網域 （例如開發、預備和生產） 必須明確允許，而且必須使用 HTTPS。新增至允許清單中的域可多達 100 個。您可以在執行時間使用 QuickSight API操作新增網域。

完成所有先決條件之後，嵌入會 QuickSight 涉及下列步驟，稍後會更詳細地說明這些步驟：

  1. 對於身分驗證，請使用應用程式伺服器來驗證使用者。在伺服器中驗證之後，URL使用您需要的 AWS SDK 產生內嵌儀表板。

  2. 在您的 Web 入口網站或應用程式中， QuickSight 使用產生的 內嵌URL。若要簡化此程序，您可以使用 Amazon QuickSight Embedding SDK，可在 NPMJS和 取得GitHub。此自訂 JavaScript SDK功能旨在協助您有效地整合 QuickSight 到您的應用程式頁面、設定預設值、連接控制項、取得回呼和處理錯誤。

您可以使用 AWS CloudTrail 稽核日誌來取得有關內嵌儀表板數量、內嵌體驗的使用者和存取速率的資訊。

主題