AddApplicationOutput

Anmerkung

Diese Dokumentation bezieht sich auf Version 1 der Amazon-Kinesis-Data-Analytics-API, die nur SQL-Anwendungen unterstützt. Version 2 der API unterstützt SQL- und Java-Anwendungen. Weitere Informationen zu Version 2 finden Sie in der Amazon-Kinesis-Data-Analytics-API-V2-Dokumentation.

Fügt Ihrer Amazon-Kinesis-Analytics-Anwendung ein externes Ziel hinzu.

Wenn Sie möchten, dass Amazon Kinesis Analytics Daten aus einem anwendungsinternen Stream innerhalb Ihrer Anwendung an ein externes Ziel übermittelt (z. B. einen Amazon Kinesis-Stream, einen Amazon Kinesis Firehose-Lieferstream oder eine AWS Lambda-Funktion), fügen Sie Ihrer Anwendung mithilfe dieses Vorgangs die entsprechende Konfiguration hinzu. Sie können einen oder mehrere Ausgaben für Ihre Anwendung konfigurieren. Jede Ausgabekonfiguration bildet einen In-Application-Stream und ein externes Ziel ab.

Sie können eine der Ausgabekonfigurationen verwenden, um Daten aus Ihrem In-Application-Fehler-Stream in der Anwendung an ein externes Ziel zu liefern, damit Sie die Fehler analysieren können. Weitere Informationen finden Sie unter Informationen zur Anwendungsausgabe (Ziel).

Jedes Konfigurationsupdate, einschließlich dem Hinzufügen einer Streaming-Quelle mit dieser Operation, führt zu einer neuen Version der Anwendung. Sie können den DescribeApplicationVorgang verwenden, um die aktuelle Anwendungsversion zu finden.

Die Begrenzungen für die Anzahl der konfigurierbaren Anwendungsein- und -ausgänge finden Sie unter Begrenzungen.

Diese Operation erfordert zur Ausführung der kinesisanalytics:AddApplicationOutput-Aktion Berechtigungen.

Anforderungssyntax

{
   "ApplicationName": "string",
   "CurrentApplicationVersionId": number,
   "Output": { 
      "DestinationSchema": { 
         "RecordFormatType": "string"
      },
      "KinesisFirehoseOutput": { 
         "ResourceARN": "string",
         "RoleARN": "string"
      },
      "KinesisStreamsOutput": { 
         "ResourceARN": "string",
         "RoleARN": "string"
      },
      "LambdaOutput": { 
         "ResourceARN": "string",
         "RoleARN": "string"
      },
      "Name": "string"
   }
}

Anforderungsparameter

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

ApplicationName

Name der Anwendung, der Sie die Ausgabekonfiguration hinzufügen möchten.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.

Pattern: [a-zA-Z0-9_.-]+

Erforderlich: Ja

CurrentApplicationVersionId

Version der Anwendung, der Sie die Ausgabekonfiguration hinzufügen möchten. Sie können den DescribeApplicationVorgang verwenden, um die aktuelle Anwendungsversion abzurufen. Wenn die angegebene Version nicht die aktuelle Version ist, wird ConcurrentModificationException zurückgegeben.

Type: Long

Gültiger Bereich: Mindestwert 1. Maximaler Wert von 999999999.

Erforderlich: Ja

Output

Ein Array von Objekten, die jeweils eine Ausgabekonfiguration beschreiben. In der Ausgabekonfiguration geben Sie den Namen eines In-Application-Streams, eines Ziels (d. h. eines Amazon Kinesis-Streams, eines Amazon Kinesis Firehose-Lieferdatenstroms oder einer AWS Lambda-Funktion) an und zeichnen die Formation auf, die beim Schreiben in das Ziel verwendet werden soll.

Typ: Output Objekt

Erforderlich: Ja

Antwortelemente

Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück.

Fehler

ConcurrentModificationException

Ausnahme, die als Ergebnis einer gleichzeitigen Änderung an einer Anwendung ausgelöst wurde. Beispiel: Zwei Personen versuchen, dieselbe Anwendung gleichzeitig zu bearbeiten.

HTTP Status Code: 400

InvalidArgumentException

Der angegebene Eingabeparameterwert ist ungültig.

HTTP Status Code: 400

ResourceInUseException

Die Anwendung ist für diesen Vorgang nicht verfügbar.

HTTP Status Code: 400

ResourceNotFoundException

Die angegebene Anwendung kann nicht gefunden werden.

HTTP Status Code: 400

UnsupportedOperationException

Die Anfrage wurde abgelehnt, weil ein bestimmter Parameter nicht unterstützt wird oder eine angegebene Ressource für diesen Vorgang nicht gültig ist.

HTTP Status Code: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der AWS sprachspezifischen SDKs finden Sie im Folgenden:

• AWS -Befehlszeilenschnittstelle

• AWS SDK for .NET

• AWS SDK for C++

• AWS SDK for Go v2

• AWS SDK for Java V2

• AWS SDK für JavaScript V3

• AWS SDK for PHP V3

• AWS SDK für Python

• AWS SDK for Ruby V3