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à.

# AddApplicationVpcConfiguration
<a name="API_AddApplicationVpcConfiguration"></a>

Aggiunge una configurazione Virtual Private Cloud (VPC) all'applicazione. Le applicazioni possono essere utilizzate VPCs per archiviare e accedere alle risorse in modo sicuro.

Tieni presente quanto segue sulle configurazioni VPC per le applicazioni Managed Service for Apache Flink:
+ Le configurazioni VPC non sono supportate per le applicazioni SQL.
+ Quando un VPC viene aggiunto a un'applicazione Managed Service for Apache Flink, non è più possibile accedere all'applicazione direttamente da Internet. Per abilitare l'accesso a Internet all'applicazione, aggiungi un gateway Internet al tuo VPC.

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

```
{
   "ApplicationName": "string",
   "ConditionalToken": "string",
   "CurrentApplicationVersionId": number,
   "VpcConfiguration": { 
      "SecurityGroupIds": [ "string" ],
      "SubnetIds": [ "string" ]
   }
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [ApplicationName](#API_AddApplicationVpcConfiguration_RequestSyntax) **   <a name="APIReference-AddApplicationVpcConfiguration-request-ApplicationName"></a>
Nome di un'applicazione esistente.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.  
Modello: `[a-zA-Z0-9_.-]+`   
Obbligatorio: sì

 ** [ConditionalToken](#API_AddApplicationVpcConfiguration_RequestSyntax) **   <a name="APIReference-AddApplicationVpcConfiguration-request-ConditionalToken"></a>
Un valore da utilizzare per implementare una forte concorrenza per gli aggiornamenti delle applicazioni. È necessario fornire il `ApplicationVersionID` o il`ConditionalToken`. Ottieni l'`ConditionalToken`utilizzo corrente dell'applicazione[DescribeApplication](API_DescribeApplication.md). Per un migliore supporto alla concorrenza, utilizzate il `ConditionalToken` parametro anziché`CurrentApplicationVersionId`.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 512 caratteri.  
Modello: `[a-zA-Z0-9-_+/=]+`   
Obbligatorio: no

 ** [CurrentApplicationVersionId](#API_AddApplicationVpcConfiguration_RequestSyntax) **   <a name="APIReference-AddApplicationVpcConfiguration-request-CurrentApplicationVersionId"></a>
La versione dell'applicazione a cui si desidera aggiungere la configurazione VPC. È necessario fornire il `CurrentApplicationVersionId` o il`ConditionalToken`. È 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`. Per un migliore supporto della concorrenza, utilizzate il `ConditionalToken` parametro anziché`CurrentApplicationVersionId`.  
Tipo: long  
Intervallo valido: valore minimo di 1. Valore massimo di 999.999.999.  
Obbligatorio: no

 ** [VpcConfiguration](#API_AddApplicationVpcConfiguration_RequestSyntax) **   <a name="APIReference-AddApplicationVpcConfiguration-request-VpcConfiguration"></a>
Descrizione del VPC da aggiungere all'applicazione.  
Tipo: oggetto [VpcConfiguration](API_VpcConfiguration.md)  
Obbligatorio: sì

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

```
{
   "ApplicationARN": "string",
   "ApplicationVersionId": number,
   "OperationId": "string",
   "VpcConfigurationDescription": { 
      "SecurityGroupIds": [ "string" ],
      "SubnetIds": [ "string" ],
      "VpcConfigurationId": "string",
      "VpcId": "string"
   }
}
```

## Elementi di risposta
<a name="API_AddApplicationVpcConfiguration_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_AddApplicationVpcConfiguration_ResponseSyntax) **   <a name="APIReference-AddApplicationVpcConfiguration-response-ApplicationARN"></a>
L'ARN dell'applicazione.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Modello: `arn:.*` 

 ** [ApplicationVersionId](#API_AddApplicationVpcConfiguration_ResponseSyntax) **   <a name="APIReference-AddApplicationVpcConfiguration-response-ApplicationVersionId"></a>
Fornisce la versione corrente dell'applicazione. Managed Service for Apache Flink si aggiorna ApplicationVersionId ogni volta che si aggiorna l'applicazione.  
Tipo: long  
Intervallo valido: valore minimo di 1. Valore massimo di 999.999.999.

 ** [OperationId](#API_AddApplicationVpcConfiguration_ResponseSyntax) **   <a name="APIReference-AddApplicationVpcConfiguration-response-OperationId"></a>
L'ID dell'operazione che può essere utilizzato per tenere traccia della richiesta.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.

 ** [VpcConfigurationDescription](#API_AddApplicationVpcConfiguration_ResponseSyntax) **   <a name="APIReference-AddApplicationVpcConfiguration-response-VpcConfigurationDescription"></a>
I parametri della nuova configurazione VPC.  
Tipo: oggetto [VpcConfigurationDescription](API_VpcConfigurationDescription.md)

## Errori
<a name="API_AddApplicationVpcConfiguration_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

 ** InvalidApplicationConfigurationException **   
La configurazione dell'applicazione fornita dall'utente non è valida.  
Codice di stato HTTP: 400

 ** InvalidArgumentException **   
Il valore del parametro di input specificato non è valido.  
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_AddApplicationVpcConfiguration_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/AddApplicationVpcConfiguration) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalyticsv2-2018-05-23/AddApplicationVpcConfiguration) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalyticsv2-2018-05-23/AddApplicationVpcConfiguration) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalyticsv2-2018-05-23/AddApplicationVpcConfiguration) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalyticsv2-2018-05-23/AddApplicationVpcConfiguration) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalyticsv2-2018-05-23/AddApplicationVpcConfiguration) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalyticsv2-2018-05-23/AddApplicationVpcConfiguration) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalyticsv2-2018-05-23/AddApplicationVpcConfiguration) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalyticsv2-2018-05-23/AddApplicationVpcConfiguration) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalyticsv2-2018-05-23/AddApplicationVpcConfiguration)