기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

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

애플리케이션에 Virtual Private Cloud(VPC) 구성을 추가합니다. 애플리케이션은 VPC를 사용하여 리소스를 안전하게 저장하고 액세스할 수 있습니다.

Managed Service for Apache Flink 애플리케이션의 VPC 구성에 대해서는 다음 사항에 유의하십시오.
+ SQL 애플리케이션에는 VPC 구성이 지원되지 않습니다.
+ Managed Service for Apache Flink 애플리케이션에 VPC를 추가하면 더 이상 인터넷에서 애플리케이션에 직접 액세스할 수 없습니다. 애플리케이션에 대한 인터넷 액세스를 활성화하려면 VPC에 인터넷 게이트웨이를 추가합니다.

## 구문 요청
<a name="API_AddApplicationVpcConfiguration_RequestSyntax"></a>

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

## 요청 파라미터
<a name="API_AddApplicationVpcConfiguration_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ApplicationName](#API_AddApplicationVpcConfiguration_RequestSyntax) **   <a name="APIReference-AddApplicationVpcConfiguration-request-ApplicationName"></a>
기존 애플리케이션의 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이 128.  
패턴: `[a-zA-Z0-9_.-]+`   
필수 여부: 예

 ** [ConditionalToken](#API_AddApplicationVpcConfiguration_RequestSyntax) **   <a name="APIReference-AddApplicationVpcConfiguration-request-ConditionalToken"></a>
애플리케이션 업데이트에 강력한 동시성을 구현하는 데 사용하는 값입니다. `ApplicationVersionID` 또는 `ConditionalToken`을 입력해야 합니다. [DescribeApplication](API_DescribeApplication.md)을 사용하여 애플리케이션의 현재 `ConditionalToken`을 가져옵니다. 더 나은 동시성 지원을 위해 `CurrentApplicationVersionId` 대신 `ConditionalToken` 파라미터를 사용하세요.  
유형: 문자열  
길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 512입니다.  
패턴: `[a-zA-Z0-9-_+/=]+`   
필수 여부: 아니요

 ** [CurrentApplicationVersionId](#API_AddApplicationVpcConfiguration_RequestSyntax) **   <a name="APIReference-AddApplicationVpcConfiguration-request-CurrentApplicationVersionId"></a>
VPC 구성을 추가할 애플리케이션의 버전입니다. `CurrentApplicationVersionId` 또는 `ConditionalToken`을 입력해야 합니다. [DescribeApplication](API_DescribeApplication.md) 작업을 사용하여 현재 애플리케이션 버전을 가져올 수 있습니다. 지정한 버전이 현재 버전이 아닌 경우 `ConcurrentModificationException`이 반환됩니다. 더 나은 동시성 지원을 위해 `CurrentApplicationVersionId` 대신 `ConditionalToken` 파라미터를 사용하세요.  
타입: Long  
유효 범위: 최소값 1. 최대 값은 999999999입니다.  
필수 여부: 아니요

 ** [VpcConfiguration](#API_AddApplicationVpcConfiguration_RequestSyntax) **   <a name="APIReference-AddApplicationVpcConfiguration-request-VpcConfiguration"></a>
애플리케이션에 추가할 VPC에 대한 설명입니다.  
타입: [VpcConfiguration](API_VpcConfiguration.md)객체  
필수 여부: 예

## 응답 구문
<a name="API_AddApplicationVpcConfiguration_ResponseSyntax"></a>

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

## 응답 요소
<a name="API_AddApplicationVpcConfiguration_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [ApplicationARN](#API_AddApplicationVpcConfiguration_ResponseSyntax) **   <a name="APIReference-AddApplicationVpcConfiguration-response-ApplicationARN"></a>
애플리케이션의 ARN입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 2,048.  
패턴: `arn:.*` 

 ** [ApplicationVersionId](#API_AddApplicationVpcConfiguration_ResponseSyntax) **   <a name="APIReference-AddApplicationVpcConfiguration-response-ApplicationVersionId"></a>
현재 애플리케이션 버전을 제공합니다. Managed Service for Apache Flink는 애플리케이션을 업데이트할 때마다 ApplicationVersionId를 업데이트합니다.  
타입: Long  
유효 범위: 최소값 1. 최대값 999999999.

 ** [OperationId](#API_AddApplicationVpcConfiguration_ResponseSyntax) **   <a name="APIReference-AddApplicationVpcConfiguration-response-OperationId"></a>
요청을 추적하는 데 사용할 수 있는 작업 ID입니다.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.

 ** [VpcConfigurationDescription](#API_AddApplicationVpcConfiguration_ResponseSyntax) **   <a name="APIReference-AddApplicationVpcConfiguration-response-VpcConfigurationDescription"></a>
새 VPC 구성의 파라미터입니다.  
타입: [VpcConfigurationDescription](API_VpcConfigurationDescription.md) 객체

## 오류
<a name="API_AddApplicationVpcConfiguration_Errors"></a>

 ** ConcurrentModificationException **   
애플리케이션의 동시 수정으로 인해 발생한 예외입니다. 이 오류는 현재 애플리케이션 ID를 사용하지 않고 애플리케이션을 수정하려고 시도한 경우 발생할 수 있습니다.  
HTTP 상태 코드: 400

 ** InvalidApplicationConfigurationException **   
사용자가 제공한 애플리케이션 구성이 유효하지 않습니다.  
HTTP 상태 코드: 400

 ** InvalidArgumentException **   
지정한 입력 파라미터 값이 유효하지 않습니다.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
이 작업에는 애플리케이션을 사용할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
지정된 애플리케이션을 찾을 수 없습니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_AddApplicationVpcConfiguration_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalyticsv2-2018-05-23/AddApplicationVpcConfiguration) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalyticsv2-2018-05-23/AddApplicationVpcConfiguration) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalyticsv2-2018-05-23/AddApplicationVpcConfiguration) 
+  [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalyticsv2-2018-05-23/AddApplicationVpcConfiguration) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalyticsv2-2018-05-23/AddApplicationVpcConfiguration) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalyticsv2-2018-05-23/AddApplicationVpcConfiguration) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalyticsv2-2018-05-23/AddApplicationVpcConfiguration) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalyticsv2-2018-05-23/AddApplicationVpcConfiguration) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisanalyticsv2-2018-05-23/AddApplicationVpcConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalyticsv2-2018-05-23/AddApplicationVpcConfiguration)