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
<a name="API_AddApplicationOutput"></a>

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](API_DescribeApplication.md) per individuare la versione dell'applicazione corrente.

## Sintassi della richiesta
<a name="API_AddApplicationOutput_RequestSyntax"></a>

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

## Parametri della richiesta
<a name="API_AddApplicationOutput_RequestParameters"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [ApplicationName](#API_AddApplicationOutput_RequestSyntax) **   <a name="APIReference-AddApplicationOutput-request-ApplicationName"></a>
Il nome dell'applicazione cui aggiungere la configurazione di output.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.  
Modello: `[a-zA-Z0-9_.-]+`   
Obbligatorio: sì

 ** [CurrentApplicationVersionId](#API_AddApplicationOutput_RequestSyntax) **   <a name="APIReference-AddApplicationOutput-request-CurrentApplicationVersionId"></a>
La versione dell'applicazione a cui desideri aggiungere la configurazione di output. È possibile utilizzare l'[DescribeApplication](API_DescribeApplication.md)operazione 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.  
Obbligatorio: sì

 ** [Output](#API_AddApplicationOutput_RequestSyntax) **   <a name="APIReference-AddApplicationOutput-request-Output"></a>
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](API_Output.md)  
Obbligatorio: sì

## Sintassi della risposta
<a name="API_AddApplicationOutput_ResponseSyntax"></a>

```
{
   "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
<a name="API_AddApplicationOutput_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [ApplicationARN](#API_AddApplicationOutput_ResponseSyntax) **   <a name="APIReference-AddApplicationOutput-response-ApplicationARN"></a>
L'applicazione Amazon Resource Name (ARN).  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Modello: `arn:.*` 

 ** [ApplicationVersionId](#API_AddApplicationOutput_ResponseSyntax) **   <a name="APIReference-AddApplicationOutput-response-ApplicationVersionId"></a>
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](#API_AddApplicationOutput_ResponseSyntax) **   <a name="APIReference-AddApplicationOutput-response-OutputDescriptions"></a>
Descrive la configurazione di output dell'applicazione. Per ulteriori informazioni, consulta [Configurazione dell'output delle applicazioni](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-output.html).   
Tipo: matrice di oggetti [OutputDescription](API_OutputDescription.md)

## Errori
<a name="API_AddApplicationOutput_Errors"></a>

 ** 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
<a name="API_AddApplicationOutput_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalyticsv2-2018-05-23/AddApplicationOutput) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalyticsv2-2018-05-23/AddApplicationOutput) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalyticsv2-2018-05-23/AddApplicationOutput) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalyticsv2-2018-05-23/AddApplicationOutput) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalyticsv2-2018-05-23/AddApplicationOutput) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalyticsv2-2018-05-23/AddApplicationOutput) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalyticsv2-2018-05-23/AddApplicationOutput) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalyticsv2-2018-05-23/AddApplicationOutput) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalyticsv2-2018-05-23/AddApplicationOutput) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalyticsv2-2018-05-23/AddApplicationOutput)