AddApplicationVpcConfiguration - Amazon Managed Service for Apache Flink(이전의 Amazon Kinesis Data Analytics for Apache Flink)

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

AddApplicationVpcConfiguration

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

Managed Service for Apache Flink 애플리케이션의 VPC 구성에 대해서는 다음 사항에 유의하십시오.

  • SQL 애플리케이션에는 VPC 구성이 지원되지 않습니다.

  • Managed Service for Apache Flink 애플리케이션에 VPC를 추가하면 더 이상 인터넷에서 애플리케이션에 직접 액세스할 수 없습니다. 애플리케이션에 대한 인터넷 액세스를 활성화하려면 VPC에 인터넷 게이트웨이를 추가합니다.

구문 요청

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

요청 파라미터

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

ApplicationName

기존 애플리케이션의 이름입니다.

유형: 문자열

길이 제약: 최소 길이는 1. 최대 길이 128.

패턴: [a-zA-Z0-9_.-]+

필수 여부: 예

ConditionalToken

애플리케이션 업데이트에 강력한 동시성을 구현하는 데 사용하는 값입니다. ApplicationVersionID 또는 ConditionalToken을 입력해야 합니다. DescribeApplication을 사용하여 애플리케이션의 현재 ConditionalToken을 가져옵니다. 더 나은 동시성 지원을 위해 CurrentApplicationVersionId 대신 ConditionalToken 파라미터를 사용하세요.

유형: 문자열

길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 512입니다.

패턴: [a-zA-Z0-9-_+/=]+

Required: No

CurrentApplicationVersionId

VPC 구성을 추가할 애플리케이션의 버전입니다. CurrentApplicationVersionId 또는 ConditionalToken을 입력해야 합니다. DescribeApplication 작업을 사용하여 현재 애플리케이션 버전을 가져올 수 있습니다. 지정한 버전이 현재 버전이 아닌 경우 ConcurrentModificationException이 반환됩니다. 더 나은 동시성 지원을 위해 CurrentApplicationVersionId 대신 ConditionalToken 파라미터를 사용하세요.

타입: Long

유효 범위: 최소값 1. 최대 값은 999999999입니다.

필수 여부: 아니요

VpcConfiguration

애플리케이션에 추가할 VPC에 대한 설명입니다.

유형: VpcConfiguration객체

필수 여부: 예

응답 구문

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

응답 요소

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

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

ApplicationARN

애플리케이션의 ARN입니다.

유형: 문자열

길이 제약: 최소 길이는 1. 최대 길이는 2,048.

패턴: arn:.*

ApplicationVersionId

현재 애플리케이션 버전을 제공합니다. Apache Flink용 관리형 서비스는 애플리케이션을 업데이트할 ApplicationVersionId 때마다 업데이트됩니다.

타입: Long

유효 범위: 최소값 1. 최대값 999999999.

OperationId

요청을 추적하는 데 사용할 수 있는 작업 ID입니다.

유형: 문자열

길이 제한: 최소 길이는 1. 최대 길이는 64.

VpcConfigurationDescription

새 VPC 구성의 파라미터입니다.

유형: VpcConfigurationDescription객체

Errors

ConcurrentModificationException

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

HTTP 상태 코드: 400

InvalidApplicationConfigurationException

사용자가 제공한 애플리케이션 구성이 유효하지 않습니다.

HTTP 상태 코드: 400

InvalidArgumentException

지정한 입력 파라미터 값이 유효하지 않습니다.

HTTP 상태 코드: 400

ResourceInUseException

이 작업에는 애플리케이션을 사용할 수 없습니다.

HTTP 상태 코드: 400

ResourceNotFoundException

지정된 애플리케이션을 찾을 수 없습니다.

HTTP 상태 코드: 400

참고

언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.