AddApplicationCloudWatchLoggingOption - 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 중단 단원을 참조하십시오.

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

AddApplicationCloudWatchLoggingOption

참고

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

CloudWatch 로그 스트림을 추가하여 애플리케이션 구성 오류를 모니터링 합니다. Amazon Kinesis Analytics 애플리케이션에서 CloudWatch 로그 스트림을 사용하는 방법에 대한 자세한 설명은 Amazon CloudWatch Logs 사용을 참조하십시오.

구문 요청

{ "ApplicationName": "string", "CloudWatchLoggingOption": { "LogStreamARN": "string", "RoleARN": "string" }, "CurrentApplicationVersionId": number }

요청 파라미터

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

ApplicationName

Kinesis Analytics 애플리케이션 명칭.

유형: 문자열

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

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

필수 여부: 예

CloudWatchLoggingOption

CloudWatch 로그 스트림 Amazon 리소스 이름(ARN) 과 IAM 역할 ARN을 제공합니다. 참고: 애플리케이션 메시지를 CloudWatch에 쓰려면 사용하는 IAM 역할에는 PutLogEvents 정책 작업이 활성화되어 있어야 합니다.

유형: CloudWatchLoggingOption 객체

필수 여부: 예

CurrentApplicationVersionId

Kinesis Analytics 애플리케이션의 버전 ID.

타입: Long

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

필수 여부: 예

Response Elements

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

Errors

ConcurrentModificationException

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

HTTP 상태 코드: 400

InvalidArgumentException

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

HTTP 상태 코드: 400

ResourceInUseException

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

HTTP 상태 코드: 400

ResourceNotFoundException

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

HTTP 상태 코드: 400

UnsupportedOperationException

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

HTTP 상태 코드: 400

참고

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