本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # GenerateEmbedUrlForAnonymousUser 生成一個嵌入的 URL，您可以用來嵌入亞馬遜 QuickSight 儀表板在您的網站，而無需註冊任何讀者用戶。使用此動作之前，請確定您已設定儀表板和使用權限。下列規則會套用至產生的 URL： + 它包含一個臨時承載令牌。生成之後的 5 分鐘內有效。一旦在此期間內兌換，將不能再次使用。 + URL 有效期間不應與可以使用` [SessionLifetimeInMinutes](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GenerateEmbedUrlForAnonymousUser.html#QS-GenerateEmbedUrlForAnonymousUser-request-SessionLifetimeInMinutes) `參數。產生的使用者工作階段有效期為 15 分鐘 (最少) 到 10 小時 (最長)。預設工作階段持續時間為 10 小時。 + 只有在使用網址或與亞馬遜互動時才會向您收費 QuickSight。如需詳細資訊，請參閱「」[內嵌分析](https://docs.aws.amazon.com/quicksight/latest/user/embedded-analytics.html)中的*亞馬遜 QuickSight 使用者指南*。如需有關嵌入的高階步驟，以及如需自訂嵌入方式的互動式示範的詳細資訊，請造訪[亞馬遜 QuickSight 開發人員入口網站](https://docs.aws.amazon.com/quicksight/latest/user/quicksight-dev-portal.html)。 ## 請求語法 ``` POST /accounts/AwsAccountId/embed-url/anonymous-user HTTP/1.1 Content-type: application/json { "AllowedDomains": [ "string" ], "AuthorizedResourceArns": [ "string" ], "ExperienceConfiguration": { "Dashboard": { "InitialDashboardId": "string" } }, "Namespace": "string", "SessionLifetimeInMinutes": number, "SessionTags": [ { "Key": "string", "Value": "string" } ] } ``` ## URI 請求參數請求會使用下列 URI 參數。 ** [AwsAccountId](#API_GenerateEmbedUrlForAnonymousUser_RequestSyntax) ** 的 IDAWS 帳戶其中包含您要嵌入的儀表板。長度限制：固定長度為 12。模式：`^[0-9]{12}$` 必要是 ## 請求主體請求接受採用 JSON 格式的下列資料。 ** [AuthorizedResourceArns](#API_GenerateEmbedUrlForAnonymousUser_RequestSyntax) ** Amazon Resource Name (ARN) QuickSight 使用者在工作階段生命週期內獲授權存取的資源。如果選擇`Dashboard`嵌入體驗，在您希望用戶能夠查看的帳戶中傳遞儀表板 ARN 列表。目前，您可以在每個 API 呼叫中傳遞最多 25 個儀表板 ARN。類型：字串陣列必要是 ** [ExperienceConfiguration](#API_GenerateEmbedUrlForAnonymousUser_RequestSyntax) ** 您所嵌入之體驗的組態。類型：[AnonymousUserEmbeddingExperienceConfiguration](API_AnonymousUserEmbeddingExperienceConfiguration.md) 物件必要是 ** [Namespace](#API_GenerateEmbedUrlForAnonymousUser_RequestSyntax) ** Amazon QuickSight 匿名使用者虛擬所屬的命名空間。如果您不使用亞馬遜 QuickSight 自定義命名空間，將其設置為`default`。類型：字串長度限制：長度上限為 64。模式：`^[a-zA-Z0-9._-]*$` 必要是 ** [AllowedDomains](#API_GenerateEmbedUrlForAnonymousUser_RequestSyntax) ** 您要新增至允許清單以存取隨後內嵌產生的 URL 的網域。此選用參數會覆寫在「管理」中設定的靜態網域 QuickSight 亞馬遜菜單 QuickSight 主控台。相反地，它只允許您包含在此參數中的網域。您可以在每個 API 呼叫中列出最多三個網域或子網域。若要將特定網域下的所有子網域納入允許清單，請使用`*`。例如：`https://*.sapp.amazon.com`包括下面的所有子域`https://sapp.amazon.com`。類型：字串陣列必要否 ** [SessionLifetimeInMinutes](#API_GenerateEmbedUrlForAnonymousUser_RequestSyntax) ** 工作階段維持有效的分鐘數。工作階段生命週期必須介於 [15-600] 分鐘。類型：Long 有效範圍：最小值為 15。最大值為 600。必要否 ** [SessionTags](#API_GenerateEmbedUrlForAnonymousUser_RequestSyntax) ** 用於資料列層級安全性的工作階段標記。使用此參數之前，請確定您已使用`DataSet$RowLevelPermissionTagConfiguration`參數，以便會話標籤可用於提供行級安全性。這些不是用於AWS資源標記功能。如需詳細資訊，請參閱「」[搭配使用資料列層級安全性 (RLS)](https://docs.aws.amazon.com/quicksight/latest/user/quicksight-dev-rls-tags.html)中的*亞馬遜 QuickSight 使用者指南*。類型：的陣列[SessionTag](API_SessionTag.md)對象陣列成員：項目數下限為 1。項目數上限為 50。必要否 ## 回應語法 ``` HTTP/1.1 Status Content-type: application/json { "EmbedUrl": "string", "RequestId": "string" } ``` ## 回應元素如果動作成功，則服務傳回下列 HTTP 回應。 ** [Status](#API_GenerateEmbedUrlForAnonymousUser_ResponseSyntax) ** 請求的 HTTP 狀態。服務會傳回下列 JSON 格式的資料。 ** [EmbedUrl](#API_GenerateEmbedUrlForAnonymousUser_ResponseSyntax) ** 儀表板的內嵌 URL。類型：字串 ** [RequestId](#API_GenerateEmbedUrlForAnonymousUser_ResponseSyntax) ** 所以此AWS此操作的請求 ID。類型：字串 ## 錯誤如需所有動作常見的錯誤相關資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您無法存取。提供的登入資料無法驗證。您可能無法取得授權以執行請求。確保您的帳戶被授權使用亞馬遜 QuickSight 服務，您的政策有正確的權限，以及您使用正確的存取金鑰。 HTTP 狀態碼：401 ** InternalFailureException ** 發生內部故障。 HTTP 狀態碼：500 ** InvalidParameterValueException ** 一或多個參數的值無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 無法找到一個或多個資源。 HTTP 狀態碼：404 ** SessionLifetimeInMinutesInvalidException ** 針對工作階段生命週期指定的分鐘數無效。工作階段生命週期必須為 15-600 分鐘。 HTTP 狀態碼：400 ** ThrottlingException ** 存取已調節。 HTTP 狀態碼：429 ** UnsupportedPricingPlanException ** 此錯誤表明您正在調用亞馬遜中的嵌入操作 QuickSight沒有所需的定價計劃AWS帳戶。在您可以為匿名使用者使用內嵌之前， QuickSight 管理員需要將容量定價新增至 Amazon QuickSight。您可以在**管理 Amazon QuickSight**(憑證已建立！) 頁面上的名稱有些許差異。新增容量定價後，您可以使用` [GetDashboardEmbedUrl](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GetDashboardEmbedUrl.html) `使用 API 操作`--identity-type ANONYMOUS`選項。 HTTP 狀態碼：403 ** UnsupportedUserEditionException ** 此錯誤表示您正在呼叫 Amazon 上的操作 QuickSight訂閱版本不包括對該操作的支持。Amazon QuickSight 目前包含 Standard Edition (企業版)。不是每個版本都會提供所有操作和功能。 HTTP 狀態碼：403 ## 另請參閱如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明： + [AWS 命令列界面](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/GenerateEmbedUrlForAnonymousUser) + [適用於 .NET 的 AWS 開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/GenerateEmbedUrlForAnonymousUser) + [適用於 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/GenerateEmbedUrlForAnonymousUser) + [適用於 Go 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/GenerateEmbedUrlForAnonymousUser) + [適用於 Java 的 AWS 開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/GenerateEmbedUrlForAnonymousUser) + [AWS適用於的開發 JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/GenerateEmbedUrlForAnonymousUser) + [適用於 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/GenerateEmbedUrlForAnonymousUser) + [適用於 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/GenerateEmbedUrlForAnonymousUser) + [適用於 Ruby 的 AWS 開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/GenerateEmbedUrlForAnonymousUser)