GenerateEmbedUrlForAnonymousUser - 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.

GenerateEmbedUrlForAnonymousUser

Generiert eine Einbettungs-URL, die Sie zum Einbetten eines Amazon verwenden können QuickSight Dashboard auf Ihrer Website, ohne dass Sie Leserbenutzer registrieren müssen. Bevor Sie diese Aktion ausführen, stellen Sie sicher, dass Sie die Dashboards und Berechtigungen konfiguriert haben.

Die folgenden Regeln gelten für die generierte URL:

  • Es enthält ein temporäres Inhaber-Token. Sie ist nach der Generierung 5 Minuten gültig. Einmal innerhalb dieser Frist eingelöst, kann es nicht erneut verwendet werden.

  • Die Gültigkeitsdauer der URL sollte nicht mit der tatsächlichen Sitzungsdauer verwechselt werden, die mithilfe der SessionLifetimeInMinutes -Parameter. Die daraus resultierende Benutzersitzung ist 15 Minuten (mindestens) bis 10 Stunden (maximal) gültig. Die Standardsitzungsdauer beträgt 10 Stunden.

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

Weitere Informationen finden Sie unterEingebettetesimAmazon 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

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-Anfrageparameter

Die Anforderung verwendet die folgenden URI-Parameter.

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

Anforderungstext

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

AuthorizedResourceArns

Die Amazon-Ressourcennamen (ARNs) für Amazon QuickSight Ressourcen, auf die der Benutzer während der Dauer der Sitzung zugreifen darf. Wenn Sie wählenDashboardÜbergeben Sie beim Einbetten der Erfahrung die Liste der Dashboard-ARNs im Konto, die der Benutzer anzeigen kann. Derzeit können Sie bei jedem API-Aufruf bis zu 25 Dashboard-ARNs übergeben.

Type: Zeichenfolgen-Array

Erforderlich: Ja

ExperienceConfiguration

Die Konfiguration des Erlebnisses, das Sie einbetten.

Typ: AnonymousUserEmbeddingExperienceConfiguration Objekt

Erforderlich: Ja

Namespace

Der Amazon QuickSight Namespace, zu dem der anonyme Benutzer virtuell gehört. Wenn Sie kein Amazon verwenden QuickSight benutzerdefinierter Namespace, setzen Sie dies aufdefault.

Type: String

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

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

Erforderlich: Ja

AllowedDomains

Die Domänen, die Sie der Zulassungsliste für den Zugriff auf die generierte URL hinzufügen möchten, die dann eingebettet wird. Dieser optionale Parameter überschreibt die statischen Domänen, die im Manage QuickSight Menü im Amazonas QuickSight console. Stattdessen sind nur die Domänen zulässig, die Sie in diesen Parameter aufnehmen. Sie können in jedem API-Aufruf bis zu drei Domänen oder Subdomains auflisten.

Um alle Subdomains einer bestimmten Domain in die Zulassungsliste aufzunehmen, verwenden Sie*. Beispiel,https://*.sapp.amazon.combeinhaltet alle Subdomains unterhttps://sapp.amazon.com.

Type: Zeichenfolgen-Array

Erforderlich: Nein

SessionLifetimeInMinutes

Wie viele Minuten ist die Sitzung gültig. Die Lebensdauer der Sitzung muss im Bereich von [15-600] Minuten betragen.

Type: Long

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

Erforderlich: Nein

SessionTags

Die Sitzungs-Tags, die für die Sicherheit auf Zeilenebene verwendet werden. Bevor Sie können Sie diesen Parameter verwenden, stellen Sie sicher, dass Sie die relevanten Datasets mit derDataSet$RowLevelPermissionTagConfiguration-Parameter, sodass Sitzungs-Tags zur Bereitstellung von Sicherheit auf Zeilenebene verwendet werden können.

Dies sind nicht die Tags, die für dieAWS-Ressourcen-Tagging-Funktion. Weitere Informationen finden Sie unterSicherheit auf Zeilenebene (Row-Level Security, RLS) mit TagsimAmazon QuickSight Benutzerhandbuch.

Type: Array vonSessionTagObjekte

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

Erforderlich: Nein

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

Die Einbettungs-URL für das Dashboard.

Type: String

RequestId

DieAWS-ID 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 -Dienste, dass Ihre Richtlinien die korrekten Berechtigungen besitzen und dass Sie die richtigen Zugriffsschlüssel verwenden.

HTTP Status Code: 401

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

ResourceNotFoundException

Mindestens eine Ressource kann nicht gefunden werden.

HTTP Status Code: 404

SessionLifetimeInMinutesInvalidException

Die Anzahl der Minuten für die Lebensdauer einer Sitzung ist ungü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 derAmazon Managed QuickSightangezeigten.

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

HTTP Status Code: 403

UnsupportedUserEditionException

Dieser Fehler zeigt an, dass Sie eine Operation bei Amazon durchführen QuickSightAbonnement, bei dem die Edition keine Unterstützung für diesen Vorgang enthält. Amazon 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: