AddApplicationInput - Amazon Kinesis Data Analytics for SQL Applications 개발자 안내서

신중한 고려 후 다음 두 단계로 Amazon Kinesis Data Analytics for SQL applications를 중단하기로 결정했습니다.

1. 2025년 10월 15일부터 SQL 애플리케이션을 위한 새 Kinesis Data Analytics를 생성할 수 없습니다.

2. 2026년 1월 27일부터 애플리케이션이 삭제됩니다. SQL 애플리케이션용 Amazon Kinesis Data Analytics를 시작하거나 운영할 수 없습니다. SQL 해당 시점부터에 대한 Amazon Kinesis Data Analytics에 대한 지원을 더 이상 사용할 수 없습니다. 자세한 내용은 Amazon Kinesis Data Analytics for SQL Applications 중단 단원을 참조하십시오.

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

AddApplicationInput

참고

이 설명서는 Amazon Kinesis Data Analytics API 버전 1용이며, SQL 애플리케이션만 지원합니다. API 버전 2에서 SQL 및 Java 애플리케이션을 지원합니다. 버전 2에 대한 자세한 설명은 Amazon Kinesis Data Analytics API V2 설명서를 참조하십시오.

Amazon Kinesis 애플리케이션에 스트리밍 소스를 추가합니다. 개념 정보는 애플리케이션 입력 구성을 참조하십시오.

애플리케이션을 생성할 때 스트리밍 소스를 추가하거나 애플리케이션을 생성한 후 이 작업을 사용하여 스트리밍 소스를 추가할 수 있습니다. 자세한 설명은 CreateApplication을 참조하십시오.

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

이 작업에는 kinesisanalytics:AddApplicationInput 조치를 수행할 권한이 요구됩니다.

구문 요청

{ "ApplicationName": "string", "CurrentApplicationVersionId": number, "Input": { "InputParallelism": { "Count": number }, "InputProcessingConfiguration": { "InputLambdaProcessor": { "ResourceARN": "string", "RoleARN": "string" } }, "InputSchema": { "RecordColumns": [ { "Mapping": "string", "Name": "string", "SqlType": "string" } ], "RecordEncoding": "string", "RecordFormat": { "MappingParameters": { "CSVMappingParameters": { "RecordColumnDelimiter": "string", "RecordRowDelimiter": "string" }, "JSONMappingParameters": { "RecordRowPath": "string" } }, "RecordFormatType": "string" } }, "KinesisFirehoseInput": { "ResourceARN": "string", "RoleARN": "string" }, "KinesisStreamsInput": { "ResourceARN": "string", "RoleARN": "string" }, "NamePrefix": "string" } }

요청 파라미터

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

ApplicationName

스트리밍 소스를 추가하려는 기존 Amazon Kinesis Analytics 애플리케이션의 명칭입니다.

유형: 문자열

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

Pattern: [a-zA-Z0-9_.-]+

필수 여부: 예

CurrentApplicationVersionId

Amazon Kinesis Analytics 애플리케이션의 최신 버전입니다. DescribeApplication 작업을 사용하여 현재 애플리케이션 버전을 찾을 수 있습니다.

타입: Long

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

필수 여부: 예

Input

추가할 입력.

유형: Input 객체

필수 여부: 예

Response Elements

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

Errors

CodeValidationException

사용자가 제공한 애플리케이션 코드 (쿼리) 가 유효하지 않습니다. 이는 단순한 구문 오류일 수 있습니다.

HTTP 상태 코드: 400

ConcurrentModificationException

애플리케이션을 동시에 수정한 결과 예외가 발생했습니다. 예컨대, 두 사람이 동시에 같은 애플리케이션을 편집하려고 하는 경우를 예로 들 수 있습니다.

HTTP 상태 코드: 400

InvalidArgumentException

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

HTTP 상태 코드: 400

ResourceInUseException

이 작업을 위한 애플리케이션을 얻을 수 없습니다.

HTTP 상태 코드: 400

ResourceNotFoundException

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

HTTP 상태 코드: 400

UnsupportedOperationException

지정된 파라미터가 지원되지 않거나 지정된 리소스가 이 작업에 유효하지 않아 요청이 거부되었습니다.

HTTP 상태 코드: 400

참고

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