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

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

AddApplicationOutput

SQL 기반 Kinesis Data Analytics 애플리케이션에 외부 대상을 추가합니다.

Kinesis Data Analytics가 애플리케이션 내의 인애플리케이션 스트림에서 외부 대상(예: Kinesis 데이터 스트림, Kinesis Data Firehose 전송 스트림 또는 Amazon Lambda 함수)으로 데이터를 전송하도록 하려면, 이 작업을 사용하여 애플리케이션에 관련 구성을 추가합니다. 애플리케이션에 대해 출력을 하나 이상 구성할 수 있습니다. 각 출력 구성은 애플리케이션 내 스트림과 외부 대상을 매핑합니다.

오류를 분석할 수 있도록 출력 구성 중 하나를 사용하여 애플리케이션 내 오류 스트림에서 외부 대상으로 데이터를 전송할 수 있습니다.

이 작업을 사용한 스트리밍 소스 추가를 포함하여 모든 구성 업데이트 시 새로운 버전의 애플리케이션이 생성됩니다. DescribeApplication 작업을 사용하여 현재 애플리케이션 버전을 찾을 수 있습니다.

구문 요청

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

요청 파라미터

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

ApplicationName

출력 구성을 추가할 애플리케이션의 이름입니다.

유형: 문자열

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

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

필수 사항 여부: Yes

CurrentApplicationVersionId

출력 구성을 추가할 애플리케이션의 버전입니다. DescribeApplication 작업을 사용하여 현재 애플리케이션 버전을 가져올 수 있습니다. 지정한 버전이 현재 버전이 아닌 경우 ConcurrentModificationException이 반환됩니다.

타입: Long

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

필수 여부: 예

Output

각각 출력 구성 하나를 설명하는 객체의 배열입니다. 출력 구성에서 인애플리케이션 스트림의 이름, 대상(즉, Kinesis 데이터 스트림, Kinesis Data Firehose 전송 스트림 또는 Amazon Lambda 함수)을 지정하고 대상에 쓸 때 사용할 형식을 기록합니다.

유형: Output객체

필수 여부: 예

응답 구문

{ "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" } ] }

응답 요소

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

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

ApplicationARN

애플리케이션 Amazon 리소스 이름(ARN).

유형: 문자열

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

패턴: arn:.*

ApplicationVersionId

업데이트된 애플리케이션 버전 ID입니다. Kinesis Data Analytics는 애플리케이션이 업데이트될 때 이 ID를 증가시킵니다.

타입: Long

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

OutputDescriptions

애플리케이션 출력 구성에 대해 설명합니다. 자세한 설명은 애플리케이션 출력 구성을 참조하십시오.

타입: OutputDescription 객체 배열

Errors

ConcurrentModificationException

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

HTTP 상태 코드: 400

InvalidArgumentException

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

HTTP 상태 코드: 400

InvalidRequestException

요청 JSON이 작업에 유효하지 않습니다.

HTTP 상태 코드: 400

ResourceInUseException

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

HTTP 상태 코드: 400

ResourceNotFoundException

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

HTTP 상태 코드: 400

참고

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