Interne API-Operationen - AMS-Benutzerhandbuch für Fortgeschrittene

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.

Interne API-Operationen

Wenn Sie API-Operationen überwachen, werden Ihnen möglicherweise Aufrufe der folgenden rein internen Operationen angezeigt:

  • GetDashboardUrl

  • ListReportsV2

Interner API-Vorgang: GetDashboardUrl

Dieser Vorgang erscheint in den Systemprotokollen, wenn er von der AMS-Konsole aufgerufen wird. Es gibt keinen anderen Anwendungsfall. Es ist nicht für Ihren direkten Gebrauch verfügbar.

Gibt die eingebettete Dashboard-URL für den entsprechenden Bericht zurück. Dieser Vorgang akzeptiert einen dashboardName zurückgegebenen Wert vonListReports.

Erforderliche Syntax

HTTP/1.1 200 Content-type: application/json { "dashboardName": "string" }

Elemente anfordern

dashboardName: Der Name des QuickSight Dashboards, für das die URL angefordert wird. Der Dashboard-Name wird in ListReports V2 zurückgegeben.

Typ: Zeichenfolge

Antwortsyntax

HTTP/1.1 200 Content-type: application/json { "url": "string" }

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück. Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

url: Gibt die QuickSight URL für die angeforderte URL zurückdashboardName.

Typ: Zeichenfolge

Fehler

Informationen zu den Fehlern, die allen Aktionen gemeinsam sind, finden Sie unter Häufige Fehler.

BadRequestException:

Die eingereichte Anfrage ist nicht gültig. Zum Beispiel, wenn die Eingabe unvollständig oder falsch ist. Einzelheiten finden Sie in der beigefügten Fehlermeldung.

HTTP Status Code: 400

NotFoundException:

Die angeforderte Ressource wurde nicht gefunden. Stellen Sie sicher, dass der Anfrage-URI korrekt ist.

HTTP Status Code: 404

TooManyRequestsException:

Die Anfrage hat ihr Drosselungslimit erreicht. Versuchen Sie es nach dem angegebenen Zeitraum erneut.

HTTP-Statuscode: 429

UnauthorizedException:

Die Anfrage wurde abgelehnt, da der Anrufer nicht über ausreichende Berechtigungen verfügt.

HTTP-Statuscode: 401

Interner API-Betrieb: ListReports V2

Diese API erscheint in den Systemprotokollen, wenn sie von der AMS-Konsole aufgerufen wird. Sie hat keinen anderen Anwendungsfall. Es ist nicht für Ihren direkten Gebrauch verfügbar.

Gibt eine Liste von Betriebsberichten zurück, die für ein bestimmtes Konto verfügbar sind.

Erforderliche Syntax

Die Anfrage hat keinen Anfragetext.

Antwortsyntax

HTTP/1.1 200 Content-type: application/json { "reportsList": [ { "dashboard": "string", "lastUpdatedTime": "string", } ], "reportsType": "string" }

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück. Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

reportsList: Die Liste der verfügbaren Betriebsberichte.

Typ: Anordnung von Dashboard-Objekten

reportsType: Gibt an, ob ein Bericht für mehrere Konten aggregiert ist oder nicht.

Typ: Zeichenfolge

Fehler

Informationen zu den Fehlern, die allen Aktionen gemeinsam sind, finden Sie unter Häufige Fehler.

BadRequestException:

Die eingereichte Anfrage ist nicht gültig. Beispielsweise ist die Eingabe unvollständig oder falsch. Einzelheiten finden Sie in der beigefügten Fehlermeldung.

HTTP Status Code: 400

NotFoundException:

Die angeforderte Ressource wurde nicht gefunden. Stellen Sie sicher, dass der Anfrage-URI korrekt ist.

HTTP Status Code: 404

TooManyRequestsException:

Die Anfrage hat ihr Drosselungslimit erreicht. Versuchen Sie es nach dem angegebenen Zeitraum erneut.

HTTP-Statuscode: 429

UnauthorizedException:

Die Anfrage wurde abgelehnt, da der Anrufer nicht über ausreichende Berechtigungen verfügt.

HTTP-Statuscode: 401