Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
AddApplicationOutput
Aggiunge una destinazione esterna all'applicazione Kinesis Data Analytics basata su SQL.
Se desideri che Kinesis Data Analytics distribuisca i dati provenienti da un flusso all'interno della tua applicazione a una destinazione esterna (ad esempio, un flusso di dati Kinesis, un flusso di distribuzione Kinesis Data Firehose oppure una funzione Amazon Lambda), devi aggiungere la configurazione pertinente all'applicazione utilizzando questa operazione. Puoi configurare uno o più output per la tua applicazione. Ogni configurazione di output mappa a un flusso nell'applicazione e a una destinazione esterna.
Puoi utilizzare una delle configurazioni di output per distribuire i dati dal flusso degli errori nell'applicazione a una destinazione esterna, in modo da poter analizzare gli errori.
Qualsiasi aggiornamento della configurazione, inclusa l'aggiunta di un'origine di streaming utilizzando questa operazione, genera una nuova versione dell'applicazione. Puoi utilizzare l'operazione DescribeApplication per individuare la versione dell'applicazione corrente.
Sintassi della richiesta
{
"ApplicationName": "string",
"CurrentApplicationVersionId": number,
"Output": {
"DestinationSchema": {
"RecordFormatType": "string"
},
"KinesisFirehoseOutput": {
"ResourceARN": "string"
},
"KinesisStreamsOutput": {
"ResourceARN": "string"
},
"LambdaOutput": {
"ResourceARN": "string"
},
"Name": "string"
}
}Parametri della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- ApplicationName
-
Il nome dell'applicazione cui aggiungere la configurazione di output.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello:
[a-zA-Z0-9_.-]+Campo obbligatorio: sì
- CurrentApplicationVersionId
-
La versione dell'applicazione a cui desideri aggiungere la configurazione di output. È possibile utilizzare l'DescribeApplicationoperazione per ottenere la versione corrente dell'applicazione. Se la versione specificata non è la versione corrente, viene restituito
ConcurrentModificationException.Tipo: long
Intervallo valido: valore minimo di 1. Valore massimo di 999.999.999.
Campo obbligatorio: sì
- Output
-
Una serie di oggetti, ciascuno dei quali descrive una configurazione di output. Nella configurazione di output, si specifica il nome di un flusso interno all'applicazione, una destinazione (ovvero un flusso di dati Kinesis, un flusso di distribuzione Kinesis Data Firehose o una funzione Amazon Lambda) e si registra la formazione da utilizzare durante la scrittura nella destinazione.
Tipo: oggetto Output
Campo obbligatorio: sì
Sintassi della risposta
{
"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"
}
]
}Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- ApplicationARN
-
L'applicazione Amazon Resource Name (ARN).
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.
Modello:
arn:.* - ApplicationVersionId
-
L'ID della versione aggiornata dell'applicazione. Kinesis Data Analytics incrementa questo ID quando l'applicazione viene aggiornata.
Tipo: long
Intervallo valido: valore minimo di 1. Valore massimo di 999.999.999.
- OutputDescriptions
-
Descrive la configurazione di output dell'applicazione. Per ulteriori informazioni, consulta Configurazione dell'output delle applicazioni.
Tipo: matrice di oggetti OutputDescription
Errori
- ConcurrentModificationException
-
Eccezione generata a seguito di modifiche simultanee a un'applicazione. Questo errore può essere il risultato del tentativo di modificare un'applicazione senza utilizzare l'ID dell'applicazione corrente.
Codice di stato HTTP: 400
- InvalidArgumentException
-
Il valore del parametro di input specificato non è valido.
Codice di stato HTTP: 400
- InvalidRequestException
-
La richiesta JSON non è valida per l'operazione.
Codice di stato HTTP: 400
- ResourceInUseException
-
L'applicazione non è disponibile per questa operazione.
Codice di stato HTTP: 400
- ResourceNotFoundException
-
L'applicazione specificata non è stata trovata.
Codice di stato HTTP: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue:
