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.
AddApplicationOutput
Fügt Ihrer SQL-basierten Kinesis Data Analytics Analytics-Anwendung ein externes Ziel hinzu.
Wenn Sie möchten, dass Kinesis Data Analytics aus einem In-Application-Stream innerhalb Ihrer Anwendung an ein externes Ziel (z. B. einen Kinesis-Datenstrom, einen Bereitstellungs-Datenstrom von Kinesis Data Firehose oder eine Amazon-Lambda-Funktion) liefert, fügen Sie mit diesem Vorgang die entsprechende Konfiguration zu Ihrer Anwendung 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.
Jedes Konfigurationsupdate, einschließlich dem Hinzufügen einer Streaming-Quelle mit dieser Operation, führt zu einer neuen Version der Anwendung. Mit der DescribeApplication-Operation können Sie die aktuelle Anwendungsversion ermitteln.
Anforderungssyntax
{
"ApplicationName": "string
",
"CurrentApplicationVersionId": number
,
"Output": {
"DestinationSchema": {
"RecordFormatType": "string
"
},
"KinesisFirehoseOutput": {
"ResourceARN": "string
"
},
"KinesisStreamsOutput": {
"ResourceARN": "string
"
},
"LambdaOutput": {
"ResourceARN": "string
"
},
"Name": "string
"
}
}
Anforderungsparameter
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
- ApplicationName
-
Der Name der Anwendung, der die 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
-
Die Version der Anwendung, zu der Sie die Ausgabekonfiguration hinzufügen möchten. Sie können den DescribeApplication Vorgang 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 Kinesis-Datenstreams, eines Kinesis Data Firehose-Lieferdatenstroms oder einer Amazon Lambda-Funktion) an und zeichnen die Formation auf, die beim Schreiben in das Ziel verwendet werden soll.
Typ: Output Objekt
Erforderlich: Ja
Antwortsyntax
{
"ApplicationARN": "string",
"ApplicationVersionId": number,
"OutputDescriptions": [
{
"DestinationSchema": {
"RecordFormatType": "string"
},
"KinesisFirehoseOutputDescription": {
"ResourceARN": "string",
"RoleARN": "string"
},
"KinesisStreamsOutputDescription": {
"ResourceARN": "string",
"RoleARN": "string"
},
"LambdaOutputDescription": {
"ResourceARN": "string",
"RoleARN": "string"
},
"Name": "string",
"OutputId": "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.
- ApplicationARN
-
Der Amazon-Ressourcenname (ARN) der -Anwendung
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 2048 Zeichen.
Pattern:
arn:.*
- ApplicationVersionId
-
Die aktualisierte Versions-ID der Anwendung. Kinesis Data Analytics erhöht diese ID, wenn die Anwendung aktualisiert wird.
Type: Long
Gültiger Bereich: Mindestwert 1. Maximaler Wert von 999999999.
- OutputDescriptions
-
Beschreibt die Ausgabekonfiguration der Anwendung. Weitere Informationen finden Sie unter Konfigurieren der Anwendungsausgabe.
Typ: Array von OutputDescription-Objekten
Fehler
- ConcurrentModificationException
-
Ausnahme, die als Ergebnis gleichzeitiger Änderungen an einer Anwendung ausgelöst wird. Dieser Fehler kann das Ergebnis des Versuchs sein, eine Anwendung zu ändern, ohne die aktuelle Anwendungs-ID zu verwenden.
HTTP Status Code: 400
- InvalidArgumentException
-
Der angegebene Eingabeparameterwert ist nicht gültig.
HTTP Status Code: 400
- InvalidRequestException
-
Die JSON-Anforderung ist für den Vorgang nicht gü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
Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS SDKs finden Sie im Folgenden: