As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

Adiciona uma configuração da nuvem privada virtual (VPC) à aplicação. Os aplicativos podem ser usados VPCs para armazenar e acessar recursos com segurança.

Observe o seguinte sobre as configurações de VPC para aplicações do Managed Service for Apache Flink:
+ As configurações de VPC não são compatíveis com aplicações de SQL.
+ Quando uma VPC é adicionada a uma aplicação do Managed Service for Apache Flink, a aplicação não pode mais ser acessada diretamente da Internet. Para habilitar o acesso à internet para a aplicação, adicione um gateway da internet à sua VPC.

## Sintaxe da solicitação
<a name="API_AddApplicationVpcConfiguration_RequestSyntax"></a>

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

## Parâmetros da solicitação
<a name="API_AddApplicationVpcConfiguration_RequestParameters"></a>

A solicitação aceita os dados a seguir no formato JSON.

 ** [ApplicationName](#API_AddApplicationVpcConfiguration_RequestSyntax) **   <a name="APIReference-AddApplicationVpcConfiguration-request-ApplicationName"></a>
O nome de um aplicativo existente.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O tamanho máximo é 128.  
Padrão: `[a-zA-Z0-9_.-]+`   
Obrigatório: Sim

 ** [ConditionalToken](#API_AddApplicationVpcConfiguration_RequestSyntax) **   <a name="APIReference-AddApplicationVpcConfiguration-request-ConditionalToken"></a>
Um valor que você usa para implementar uma forte simultaneidade para atualizações de aplicações. Você deve fornecer `ApplicationVersionID` ou `ConditionalToken`. Você obtém o `ConditionalToken` atual da aplicação usando [DescribeApplication](API_DescribeApplication.md). Para melhor suporte à simultaneidade, use o parâmetro `ConditionalToken` em vez de `CurrentApplicationVersionId`.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 512.  
Padrão: `[a-zA-Z0-9-_+/=]+`   
Obrigatório: não

 ** [CurrentApplicationVersionId](#API_AddApplicationVpcConfiguration_RequestSyntax) **   <a name="APIReference-AddApplicationVpcConfiguration-request-CurrentApplicationVersionId"></a>
A versão da aplicação à qual você deseja adicionar a configuração de VPC. Você deve fornecer `CurrentApplicationVersionId` ou `ConditionalToken`. Você pode usar a operação [DescribeApplication](API_DescribeApplication.md) para obter a versão atual da aplicação. Se a versão especificada não for a versão atual, `ConcurrentModificationException` será retornado. Para um melhor suporte à simultaneidade, use o parâmetro `ConditionalToken` em vez de `CurrentApplicationVersionId`.  
Tipo: longo  
Faixa válida: valor mínimo de 1. Valor máximo de 999999999.  
Obrigatório: não

 ** [VpcConfiguration](#API_AddApplicationVpcConfiguration_RequestSyntax) **   <a name="APIReference-AddApplicationVpcConfiguration-request-VpcConfiguration"></a>
Descrição da VPC a ser adicionada à aplicação.  
Tipo: objeto [VpcConfiguration](API_VpcConfiguration.md)  
Obrigatório: sim

## Sintaxe da resposta
<a name="API_AddApplicationVpcConfiguration_ResponseSyntax"></a>

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

## Elementos de resposta
<a name="API_AddApplicationVpcConfiguration_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [ApplicationARN](#API_AddApplicationVpcConfiguration_ResponseSyntax) **   <a name="APIReference-AddApplicationVpcConfiguration-response-ApplicationARN"></a>
O ARN da aplicação.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2.048.  
Padrão: `arn:.*` 

 ** [ApplicationVersionId](#API_AddApplicationVpcConfiguration_ResponseSyntax) **   <a name="APIReference-AddApplicationVpcConfiguration-response-ApplicationVersionId"></a>
Fornece a versão da aplicação atual. O Managed Service for Apache Flink é atualizado ApplicationVersionId sempre que você atualiza o aplicativo.  
Tipo: longo  
Faixa válida: valor mínimo de 1. Valor máximo de 999999999.

 ** [OperationId](#API_AddApplicationVpcConfiguration_ResponseSyntax) **   <a name="APIReference-AddApplicationVpcConfiguration-response-OperationId"></a>
O ID da operação que pode ser usado para rastrear a solicitação.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.

 ** [VpcConfigurationDescription](#API_AddApplicationVpcConfiguration_ResponseSyntax) **   <a name="APIReference-AddApplicationVpcConfiguration-response-VpcConfigurationDescription"></a>
Os parâmetros da nova configuração de VPC.  
Tipo: objeto [VpcConfigurationDescription](API_VpcConfigurationDescription.md)

## Erros
<a name="API_AddApplicationVpcConfiguration_Errors"></a>

 ** ConcurrentModificationException **   
Exceção lançada como resultado de modificações simultâneas em uma aplicação. Esse erro pode ser o resultado da tentativa de modificar uma aplicação sem usar o ID da aplicação atual.  
Código de status HTTP: 400

 ** InvalidApplicationConfigurationException **   
A configuração da aplicação fornecida pelo usuário do não é válida.  
Código de status HTTP: 400

 ** InvalidArgumentException **   
O valor do parâmetro de entrada especificado não é válido.  
Código de status HTTP: 400

 ** ResourceInUseException **   
A aplicação não está disponível para esta operação.  
Código de status HTTP: 400

 ** ResourceNotFoundException **   
O aplicativo especificado não pode ser encontrado.  
Código de Status HTTP: 400

## Consulte também
<a name="API_AddApplicationVpcConfiguration_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalyticsv2-2018-05-23/AddApplicationVpcConfiguration) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalyticsv2-2018-05-23/AddApplicationVpcConfiguration) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalyticsv2-2018-05-23/AddApplicationVpcConfiguration) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalyticsv2-2018-05-23/AddApplicationVpcConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalyticsv2-2018-05-23/AddApplicationVpcConfiguration) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalyticsv2-2018-05-23/AddApplicationVpcConfiguration) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalyticsv2-2018-05-23/AddApplicationVpcConfiguration) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalyticsv2-2018-05-23/AddApplicationVpcConfiguration) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalyticsv2-2018-05-23/AddApplicationVpcConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalyticsv2-2018-05-23/AddApplicationVpcConfiguration)