GetDashboardEmbedUrl - Amazon QuickSight
AnforderungssyntaxURI-AnfrageparameterAnforderungstextAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

GetDashboardEmbedUrl

Generiert eine temporäre Sitzungs-URL und einen Autorisierungscode (Bearer-Token), die Sie zum Einbetten eines Amazon verwenden können QuickSight schreibgeschütztes Dashboard auf Ihrer Website oder Anwendung. Stellen Sie vor Verwendung dieses Befehls sicher, dass Sie die Dashboards und Berechtigungen konfiguriert haben.

Zurzeit können Sie verwendenGetDashboardEmbedURLnur vom Server, nicht vom Browser des Benutzers. Die folgenden Regeln gelten für die generierte URL:

  • Sie müssen zusammen verwendet werden.

  • Sie können nur einmal verwendet werden.

  • Sie sind nach Ausführung dieses Befehls 5 Minuten gültig.

  • Ihnen werden nur Gebühren berechnet, wenn die URL verwendet wird oder eine Interaktion mit Amazon stattfindet QuickSight.

  • Die daraus resultierende Benutzersitzung ist 15 Minuten (Standard) bis zu 10 Stunden (maximal) gültig. Sie können das optionale verwendenSessionLifetimeInMinutesParameter zum Anpassen der Sitzungsdauer.

Weitere Informationen finden Sie unterEinbetten von Analysen mit GetDashboardEmbedUrlimAmazon QuickSight Benutzerhandbuch.

Weitere Informationen zu den allgemeinen Schritten beim Einbetten und eine interaktive Demo der Möglichkeiten, wie Sie die Einbettung anpassen können, finden Sie auf derAmazon QuickSight Entwicklerportal.

Anforderungssyntax

GET /accounts/AwsAccountId/dashboards/DashboardId/embed-url?additional-dashboard-ids=AdditionalDashboardIds&creds-type=IdentityType&namespace=Namespace&reset-disabled=ResetDisabled&session-lifetime=SessionLifetimeInMinutes&state-persistence-enabled=StatePersistenceEnabled&undo-redo-disabled=UndoRedoDisabled&user-arn=UserArn HTTP/1.1

URI-Anfrageparameter

Die Anforderung verwendet die folgenden URI-Parameter.

AdditionalDashboardIds

Eine Liste mit einer oder mehreren Dashboard-IDs, auf die anonyme Benutzer temporären Zugriff haben sollen. Zurzeit ist dieIdentityTypeParameter muss gesetzt sein aufANONYMOUSweil sich andere Identitätstypen als Amazon authentifizieren QuickSight für IAM-Benutzer. Zum Beispiel, wenn Sie“--dashboard-id dash_id1 --dashboard-id dash_id2 dash_id3 identity-type ANONYMOUS„, kann die Sitzung auf alle drei Dashboards zugreifen.

Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 50 Elemente.

Längenbeschränkungen: Mindestlänge 1. Maximale Länge beträgt 2048 Zeichen.

Pattern: [\w\-]+

AwsAccountId

Die -ID für dieAWS-Kontodas das Dashboard enthält, das Sie einbetten.

Längenbeschränkungen: Feste Länge von 12.

Pattern: ^[0-9]{12}$

Erforderlich: Ja

DashboardId

Die ID für das Dashboard, die ebenfalls demAWS Identity and Access Management(IAM) -Richtlinie.

Längenbeschränkungen: Mindestlänge 1. Maximale Länge beträgt 2048 Zeichen.

Pattern: [\w\-]+

Erforderlich: Ja

IdentityType

Die Authentifizierungsmethode, mit der sich der Benutzer anmeldet.

Zulässige Werte: IAM | QUICKSIGHT | ANONYMOUS

Erforderlich: Ja

Namespace

Der amazon QuickSight Namespace, der die Dashboard-IDs in dieser Anfrage enthält. Wenn Sie keinen benutzerdefinierten Namespace verwenden, legen SieNamespace = default.

Längenbeschränkungen: Höchstlänge = 64 Zeichen.

Pattern: ^[a-zA-Z0-9._-]*$

ResetDisabled

Schaltfläche für Rücksetzungsfunktion aus eingebettetem Dashboard entfernen. Die Standardeinstellung ist FALSE, wodurch die Reset-Taste aktiviert wird.

SessionLifetimeInMinutes

Wie viele Minuten ist die Sitzung gültig. Die Lebensdauer der Sitzung muss 15-600 Minuten betragen.

Gültiger Bereich: Der Mindestwert ist 15. Maximalwert 600.

StatePersistenceEnabled

Fügt die Persistenz des Status für die Benutzersitzung in einem eingebetteten Dashboard hinzu. Persistenz gilt für das Blatt und die Parametereinstellungen. Dies sind Steuerungseinstellungen, die der Dashboard-Abonnent (Amazon) QuickSight Reader) wählt beim Betrachten des Dashboards aus. Wenn dies auf eingestellt istTRUEsind die Einstellungen identisch, wenn der Abonnent dieselbe Dashboard-URL erneut öffnet. Der Status ist bei Amazon gespeichert QuickSight, nicht in einem Browser-Cookie. Wenn dieser Wert auf FALSE gesetzt ist, wird der Status der Benutzersitzung nicht beibehalten. Der Standardwert ist FALSE.

UndoRedoDisabled

Entfernen Sie die Schaltfläche Rückgängig/Wiederherstellen im eingebetteten Dashboard. Die Standardeinstellung ist FALSE, wodurch die Schaltfläche Rückgängig/Wiederherstellen aktiviert wird.

UserArn

Der amazon QuickSight Der Amazon-Ressourcenname (ARN), zur Verwendung mitQUICKSIGHTIdentitätstyp. Sie können dies für jedes Amazon verwenden QuickSight -Benutzer in Ihrem Konto (Leser, Autoren oder Administratoren), authentifiziert als einer der folgenden Arten von Benutzern:

  • Active Directory (AD) -Benutzer oder -Gruppenmitglieder

  • Eingeladene Benutzer

  • IAM-Benutzer und IAM-Rollen-basierte Sitzungen, authentifiziert durch verbundener Single Sign-On mit SAML, OpenID Connect oder IAM-Verbund.

Lassen Sie diesen Parameter für Benutzer in der dritten Gruppe weg — IAM-Benutzer und rollenbasierte IAM-Sitzungen.

Anforderungstext

Der Anforderung besitzt keinen Anforderungstext.

Antwortsyntax

HTTP/1.1 Status
Content-type: application/json

{
   "EmbedUrl": "string",
   "RequestId": "string"
}

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Dienst die folgende HTTP-Antwort zurück.

Status

Der HTTP-Status der Anforderung.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

EmbedUrl

Eine URL zur einmaligen Verwendung, die Sie in Ihre serverseitige Webseite eingeben können, um Ihr Dashboard einzubetten. Diese URL ist 5 Minuten gültig. Die API-Operation stellt die URL mit einemauth_codeWert, der eine (und nur eine) Anmeldung bei einer Benutzersitzung ermöglicht, die 10 Stunden lang gültig ist.

Type: String

RequestId

DieAWS-Anforderungscode für diese Operation.

Type: String

Fehler

Hinweise zu den Fehlern, die bei allen Aktionen auftreten, finden Sie unterHäufige Fehler.

AccessDeniedException

Sie haben keinen Zugriff auf dieses Element. Die bereitgestellten Anmeldeinformationen konnten nicht überprüft werden. Sie sind möglicherweise nicht berechtigt, die Anforderung auszuführen. Stellen Sie sicher, dass Ihr Konto für die Nutzung von Amazon autorisiert ist QuickSight --Service, dass Ihre -Richtlinien die korrekten Berechtigungen besitzen und dass Sie die richtigen Zugriffsschlüssel verwenden.

HTTP Status Code: 401

DomainNotWhitelistedException

Die angegebene Domäne ist nicht auf der Zulassungsliste. Alle Domänen für eingebettete Dashboards müssen von einem Amazon zur Liste der zulässigen Domänen hinzugefügt werden QuickSight admin.

HTTP Status Code: 403

IdentityTypeNotSupportedException

Der angegebene Identitätstyp wird nicht unterstützt. Unterstützte Identitätstypen sindIAMundQUICKSIGHT.

HTTP Status Code: 403

InternalFailureException

Es ist ein interner Fehler aufgetreten.

HTTP Status Code: 500

InvalidParameterValueException

Ein oder mehrere Parameter haben einen Wert, der nicht gültig ist.

HTTP Status Code: 400

QuickSightUserNotFoundException

Der Benutzer mit dem angegebenen Namen wurde nicht gefunden. Dieser Fehler kann bei jedem Vorgang auftreten, bei dem ein Benutzer anhand eines angegebenen Benutzernamens gesucht werden muss, wie z.DeleteUser,DescribeUser,,, usw.

HTTP Status Code: 404

ResourceExistsException

Die angegebene Ressource ist bereits vorhanden vorhanden vorhanden.

HTTP Status Code: 409

ResourceNotFoundException

Mindestens eine Ressource kann nicht gefunden werden.

HTTP Status Code: 404

SessionLifetimeInMinutesInvalidException

Die Anzahl der Minuten für die Lebensdauer einer Sitzung ist nicht gültig. Die Lebensdauer der Sitzung muss 15-600 Minuten betragen.

HTTP Status Code: 400

ThrottlingException

Der Zugriff wird gedrosselt

HTTP Status Code: 429

UnsupportedPricingPlanException

Dieser Fehler zeigt an, dass Sie einen Einbettungsvorgang in Amazon aufrufen. QuickSightohne den erforderlichen Preisplan auf IhremAWSKonto. Bevor Sie das Einbetten für anonyme Benutzer verwenden können, muss ein QuickSight Administrator muss Kapazitätspreise zu Amazon hinzufügen QuickSight. Sie können dies auf der tunAmazon verwalten QuickSightangezeigten.

Nachdem die Kapazitätspreise hinzugefügt wurden, können Sie die GetDashboardEmbedUrl API-Operation mit dem--identity-type ANONYMOUSOption.

HTTP Status Code: 403

UnsupportedUserEditionException

Dieser Fehler zeigt an, dass Sie eine Operation mit einem Amazon durchführen QuickSightAbonnement, bei dem die Edition keine Unterstützung für diesen Vorgang enthält. Amazon QuickSight verfügt derzeit über eine Standard Edition und eine Enterprise Edition. Nicht jede Operation und Funktion ist in jeder Version verfügbar ist.

HTTP Status Code: 403

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter: