

신중한 고려 끝에 Amazon Kinesis Data Analytics for SQL 애플리케이션을 중단하기로 결정했습니다.

1. **2025년 9월 1**일부터 Amazon Kinesis Data Analytics for SQL 애플리케이션에 대한 버그 수정은 제공되지 않습니다. 곧 중단될 예정이므로 지원이 제한될 예정이기 때문입니다.

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

3. **2026년 1월 27**일부터 애플리케이션이 삭제됩니다. Amazon Kinesis Data Analytics for SQL 애플리케이션을 시작하거나 작동할 수 없게 됩니다. 그 시점부터 Amazon Kinesis Data Analytics for SQL에 대한 지원을 더 이상 이용할 수 없습니다. 자세한 내용은 [Amazon Kinesis Data Analytics for SQL 애플리케이션 단종](discontinuation.md) 단원을 참조하십시오.

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

# 작업
<a name="API_Operations"></a>

다음 작업이 지원됩니다.
+  [AddApplicationCloudWatchLoggingOption](API_AddApplicationCloudWatchLoggingOption.md) 
+  [AddApplicationInput](API_AddApplicationInput.md) 
+  [AddApplicationInputProcessingConfiguration](API_AddApplicationInputProcessingConfiguration.md) 
+  [AddApplicationOutput](API_AddApplicationOutput.md) 
+  [AddApplicationReferenceDataSource](API_AddApplicationReferenceDataSource.md) 
+  [CreateApplication](API_CreateApplication.md) 
+  [DeleteApplication](API_DeleteApplication.md) 
+  [DeleteApplicationCloudWatchLoggingOption](API_DeleteApplicationCloudWatchLoggingOption.md) 
+  [DeleteApplicationInputProcessingConfiguration](API_DeleteApplicationInputProcessingConfiguration.md) 
+  [DeleteApplicationOutput](API_DeleteApplicationOutput.md) 
+  [DeleteApplicationReferenceDataSource](API_DeleteApplicationReferenceDataSource.md) 
+  [DescribeApplication](API_DescribeApplication.md) 
+  [DiscoverInputSchema](API_DiscoverInputSchema.md) 
+  [ListApplications](API_ListApplications.md) 
+  [ListTagsForResource](API_ListTagsForResource.md) 
+  [StartApplication](API_StartApplication.md) 
+  [StopApplication](API_StopApplication.md) 
+  [TagResource](API_TagResource.md) 
+  [UntagResource](API_UntagResource.md) 
+  [UpdateApplication](API_UpdateApplication.md) 

# AddApplicationCloudWatchLoggingOption
<a name="API_AddApplicationCloudWatchLoggingOption"></a>

**참고**  
이 설명서는 Amazon Kinesis Data Analytics API 버전 1용이며, SQL 애플리케이션만 지원합니다. API 버전 2에서 SQL 및 Java 애플리케이션을 지원합니다. 버전 2에 대한 자세한 설명은 [Amazon Kinesis Data Analytics API V2 설명서](/kinesisanalytics/latest/apiv2/Welcome.html)를 참조하십시오.

CloudWatch 로그 스트림을 추가하여 애플리케이션 구성 오류를 모니터링 합니다. Amazon Kinesis Analytics 애플리케이션에서 CloudWatch 로그 스트림을 사용하는 방법에 대한 자세한 설명은 [Amazon CloudWatch Logs 사용](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/cloudwatch-logs.html)을 참조하십시오.

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

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

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

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

 ** [ApplicationName](#API_AddApplicationCloudWatchLoggingOption_RequestSyntax) **   <a name="analytics-AddApplicationCloudWatchLoggingOption-request-ApplicationName"></a>
Kinesis Analytics 애플리케이션 명칭.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이 128.  
패턴: `[a-zA-Z0-9_.-]+`   
필수 여부: 예

 ** [CloudWatchLoggingOption](#API_AddApplicationCloudWatchLoggingOption_RequestSyntax) **   <a name="analytics-AddApplicationCloudWatchLoggingOption-request-CloudWatchLoggingOption"></a>
CloudWatch 로그 스트림 Amazon 리소스 이름(ARN) 과 IAM 역할 ARN을 제공합니다. 참고: 애플리케이션 메시지를 CloudWatch에 쓰려면 사용하는 IAM 역할에는 `PutLogEvents` 정책 작업이 활성화되어 있어야 합니다.  
타입: [CloudWatchLoggingOption](API_CloudWatchLoggingOption.md)객체  
필수 여부: 예

 ** [CurrentApplicationVersionId](#API_AddApplicationCloudWatchLoggingOption_RequestSyntax) **   <a name="analytics-AddApplicationCloudWatchLoggingOption-request-CurrentApplicationVersionId"></a>
Kinesis Analytics 애플리케이션의 버전 ID.  
타입: Long  
유효 범위: 최소값 1. 최대값 999999999.  
필수 여부: 예

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

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

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

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

 ** UnsupportedOperationException **   
지정된 파라미터가 지원되지 않거나 지정된 리소스가 이 작업에 유효하지 않아 요청이 거부되었습니다.  
HTTP 상태 코드: 400

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

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

# AddApplicationInput
<a name="API_AddApplicationInput"></a>

**참고**  
이 설명서는 Amazon Kinesis Data Analytics API 버전 1용이며, SQL 애플리케이션만 지원합니다. API 버전 2에서 SQL 및 Java 애플리케이션을 지원합니다. 버전 2에 대한 자세한 설명은 [Amazon Kinesis Data Analytics API V2 설명서](/kinesisanalytics/latest/apiv2/Welcome.html)를 참조하십시오.

 Amazon Kinesis 애플리케이션에 스트리밍 소스를 추가합니다. 개념 정보는 [애플리케이션 입력 구성](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-input.html)을 참조하십시오.

애플리케이션을 생성할 때 스트리밍 소스를 추가하거나 애플리케이션을 생성한 후 이 작업을 사용하여 스트리밍 소스를 추가할 수 있습니다. 자세한 설명은 [CreateApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_CreateApplication.html)을 참조하십시오.

이 작업을 사용한 스트리밍 소스 추가를 포함하여 모든 구성 업데이트 시 새로운 버전의 애플리케이션이 생성됩니다. [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 작업을 사용하여 현재 애플리케이션 버전을 찾을 수 있습니다.

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

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

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

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

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

 ** [ApplicationName](#API_AddApplicationInput_RequestSyntax) **   <a name="analytics-AddApplicationInput-request-ApplicationName"></a>
스트리밍 소스를 추가하려는 기존 Amazon Kinesis Analytics 애플리케이션의 명칭입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이 128.  
패턴: `[a-zA-Z0-9_.-]+`   
필수 여부: 예

 ** [CurrentApplicationVersionId](#API_AddApplicationInput_RequestSyntax) **   <a name="analytics-AddApplicationInput-request-CurrentApplicationVersionId"></a>
Amazon Kinesis Analytics 애플리케이션의 최신 버전입니다. [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 작업을 사용하여 현재 애플리케이션 버전을 찾을 수 있습니다.  
타입: Long  
유효 범위: 최소값 1. 최대값 999999999.  
필수 여부: 예

 ** [Input](#API_AddApplicationInput_RequestSyntax) **   <a name="analytics-AddApplicationInput-request-Input"></a>
추가할 [입력](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_Input.html).  
타입: [Input](API_Input.md)객체  
필수 여부: 예

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

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

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

 ** CodeValidationException **   
사용자가 제공한 애플리케이션 코드 (쿼리) 가 유효하지 않습니다. 이는 단순한 구문 오류일 수 있습니다.    
 ** message **   
테스트
HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

 ** UnsupportedOperationException **   
지정된 파라미터가 지원되지 않거나 지정된 리소스가 이 작업에 유효하지 않아 요청이 거부되었습니다.  
HTTP 상태 코드: 400

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

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

# AddApplicationInputProcessingConfiguration
<a name="API_AddApplicationInputProcessingConfiguration"></a>

**참고**  
이 설명서는 Amazon Kinesis Data Analytics API 버전 1용이며, SQL 애플리케이션만 지원합니다. API 버전 2에서 SQL 및 Java 애플리케이션을 지원합니다. 버전 2에 대한 자세한 설명은 [Amazon Kinesis Data Analytics API V2 설명서](/kinesisanalytics/latest/apiv2/Welcome.html)를 참조하십시오.

애플리케이션에 [InputProcessingConfiguration](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_InputProcessingConfiguration.html)을 추가합니다. 입력 프로세서는 애플리케이션의 SQL 코드가 실행되기 전에 입력 스트림에서 레코드를 전처리합니다. 현재 사용할 수 있는 유일한 입력 프로세서는 [AWS Lambda](https://docs.aws.amazon.com/lambda/)입니다.

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

```
{
   "ApplicationName": "string",
   "CurrentApplicationVersionId": number,
   "InputId": "string",
   "InputProcessingConfiguration": { 
      "InputLambdaProcessor": { 
         "ResourceARN": "string",
         "RoleARN": "string"
      }
   }
}
```

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

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

 ** [ApplicationName](#API_AddApplicationInputProcessingConfiguration_RequestSyntax) **   <a name="analytics-AddApplicationInputProcessingConfiguration-request-ApplicationName"></a>
입력 구성을 추가할 애플리케이션의 명칭.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이 128.  
패턴: `[a-zA-Z0-9_.-]+`   
필수 여부: 예

 ** [CurrentApplicationVersionId](#API_AddApplicationInputProcessingConfiguration_RequestSyntax) **   <a name="analytics-AddApplicationInputProcessingConfiguration-request-CurrentApplicationVersionId"></a>
입력 구성을 추가할 애플리케이션의 버전. [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 작업을 사용하여 최신 애플리케이션 버전을 찾을 수 있습니다. 지정된 버전이 최신 버전이 아닌 경우 `ConcurrentModificationException`가 반환됩니다.  
타입: Long  
유효 범위: 최소값 1. 최대값 999999999.  
필수 항목 여부: 예

 ** [InputId](#API_AddApplicationInputProcessingConfiguration_RequestSyntax) **   <a name="analytics-AddApplicationInputProcessingConfiguration-request-InputId"></a>
입력 처리 구성을 추가할 입력 구성의 ID. [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 작업을 사용하여 애플리케이션의 입력 ID 목록을 가져올 수 있습니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 50.  
패턴: `[a-zA-Z0-9_.-]+`   
필수 여부: 예

 ** [InputProcessingConfiguration](#API_AddApplicationInputProcessingConfiguration_RequestSyntax) **   <a name="analytics-AddApplicationInputProcessingConfiguration-request-InputProcessingConfiguration"></a>
애플리케이션에 추가할 [InputProcessingConfiguration](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_InputProcessingConfiguration.html).  
타입: [InputProcessingConfiguration](API_InputProcessingConfiguration.md)객체  
필수 여부: 예

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

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

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

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

 ** UnsupportedOperationException **   
지정된 파라미터가 지원되지 않거나 지정된 리소스가 이 작업에 유효하지 않아 요청이 거부되었습니다.  
HTTP 상태 코드: 400

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

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

# AddApplicationOutput
<a name="API_AddApplicationOutput"></a>

**참고**  
이 설명서는 Amazon Kinesis Data Analytics API 버전 1용이며, SQL 애플리케이션만 지원합니다. API 버전 2에서 SQL 및 Java 애플리케이션을 지원합니다. 버전 2에 대한 자세한 설명은 [Amazon Kinesis Data Analytics API V2 설명서](/kinesisanalytics/latest/apiv2/Welcome.html)를 참조하십시오.

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

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

 오류를 분석할 수 있도록 출력 구성 중 하나를 사용하여 애플리케이션 내 오류 스트림에서 외부 대상으로 데이터를 전송할 수 있습니다. 자세한 설명은 [애플리케이션 출력(목적지) 이해](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-output.html) 섹션을 참조하십시오.

 이 작업을 사용한 스트리밍 소스 추가를 포함하여 모든 구성 업데이트 시 새로운 버전의 애플리케이션이 생성됩니다. [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 작업을 사용하여 현재 애플리케이션 버전을 찾을 수 있습니다.

구성할 수 있는 애플리케이션 입력 및 출력 수 제한은 [제한](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/limits.html)을 참조하십시오.

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

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

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

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

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

 ** [ApplicationName](#API_AddApplicationOutput_RequestSyntax) **   <a name="analytics-AddApplicationOutput-request-ApplicationName"></a>
출력 구성을 추가할 애플리케이션의 명칭.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이 128.  
패턴: `[a-zA-Z0-9_.-]+`   
필수 여부: 예

 ** [CurrentApplicationVersionId](#API_AddApplicationOutput_RequestSyntax) **   <a name="analytics-AddApplicationOutput-request-CurrentApplicationVersionId"></a>
출력 구성을 추가할 애플리케이션의 버전. [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 작업을 사용하여 최신 애플리케이션 버전을 찾을 수 있습니다. 지정된 버전이 최신 버전이 아닌 경우 `ConcurrentModificationException`가 반환됩니다.  
타입: Long  
유효 범위: 최소값 1. 최대값 999999999.  
필수 항목 여부: 예

 ** [Output](#API_AddApplicationOutput_RequestSyntax) **   <a name="analytics-AddApplicationOutput-request-Output"></a>
각각 출력 구성 하나를 설명하는 객체의 배열입니다. 출력 구성에서 인애플리케이션 스트림의 이름, 대상(즉, Amazon Kinesis 스트림, Amazon Kinesis Firehose 전송 스트림 또는 AWS Lambda 함수)을 지정하고 대상에 쓸 때 사용할 형식을 기록합니다.  
타입: [Output](API_Output.md)객체  
필수 여부: 예

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

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

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

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

 ** UnsupportedOperationException **   
지정된 파라미터가 지원되지 않거나 지정된 리소스가 이 작업에 유효하지 않아 요청이 거부되었습니다.  
HTTP 상태 코드: 400

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

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

# AddApplicationReferenceDataSource
<a name="API_AddApplicationReferenceDataSource"></a>

**참고**  
이 설명서는 Amazon Kinesis Data Analytics API 버전 1용이며, SQL 애플리케이션만 지원합니다. API 버전 2에서 SQL 및 Java 애플리케이션을 지원합니다. 버전 2에 대한 자세한 설명은 [Amazon Kinesis Data Analytics API V2 설명서](/kinesisanalytics/latest/apiv2/Welcome.html)를 참조하십시오.

기존 애플리케이션에 준거 데이터 소스를 추가합니다.

Amazon Kinesis Analytics는 준거 데이터(즉, Amazon S3 객체)를 읽고 애플리케이션 내에 애플리케이션 내 표를 만듭니다. 요청에서 소스(S3 버킷 명칭과 객체 키 명칭), 생성할 애플리케이션 내 표의 명칭, Amazon S3 객체의 데이터가 결과 애플리케이션 내 표의 열에 매핑하는 방법을 설명하는 필요한 매핑 정보를 제공합니다.

 개념 정보는 [애플리케이션 입력 구성](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-input.html)을 참조하십시오. 애플리케이션에 추가할 수 있는 데이터 소스에 대한 한도는 [한도](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/limits.html)를 참조하십시오.

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

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

```
{
   "ApplicationName": "string",
   "CurrentApplicationVersionId": number,
   "ReferenceDataSource": { 
      "ReferenceSchema": { 
         "RecordColumns": [ 
            { 
               "Mapping": "string",
               "Name": "string",
               "SqlType": "string"
            }
         ],
         "RecordEncoding": "string",
         "RecordFormat": { 
            "MappingParameters": { 
               "CSVMappingParameters": { 
                  "RecordColumnDelimiter": "string",
                  "RecordRowDelimiter": "string"
               },
               "JSONMappingParameters": { 
                  "RecordRowPath": "string"
               }
            },
            "RecordFormatType": "string"
         }
      },
      "S3ReferenceDataSource": { 
         "BucketARN": "string",
         "FileKey": "string",
         "ReferenceRoleARN": "string"
      },
      "TableName": "string"
   }
}
```

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

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

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

 ** [CurrentApplicationVersionId](#API_AddApplicationReferenceDataSource_RequestSyntax) **   <a name="analytics-AddApplicationReferenceDataSource-request-CurrentApplicationVersionId"></a>
준거 데이터 소스가 추가되는 애플리케이션의 버전입니다. [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 작업을 사용하여 최신 애플리케이션 버전을 받을 수 있습니다. 지정된 버전이 최신 버전이 아닌 경우 `ConcurrentModificationException`가 반환됩니다.  
타입: Long  
유효 범위: 최소값 1. 최대값 999999999.  
필수 항목 여부: 예

 ** [ReferenceDataSource](#API_AddApplicationReferenceDataSource_RequestSyntax) **   <a name="analytics-AddApplicationReferenceDataSource-request-ReferenceDataSource"></a>
준거 데이터 소스는 Amazon S3 버킷의 객체일 수 있습니다. Amazon Kinesis Analytics는 객체를 읽고 생성된 애플리케이션 내 표에 데이터를 복사합니다. S3 버킷, 객체 키 명칭, 생성된 애플리케이션 내 표를 제공합니다. Amazon Kinesis Analytics가 사용자를 대신해 S3 버킷에서 객체를 읽기 위해 맡을 수 있는 IAM 역할도 제공해야 합니다.  
타입: [ReferenceDataSource](API_ReferenceDataSource.md)객체  
필수 여부: 예

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

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

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

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

 ** UnsupportedOperationException **   
지정된 파라미터가 지원되지 않거나 지정된 리소스가 이 작업에 유효하지 않아 요청이 거부되었습니다.  
HTTP 상태 코드: 400

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

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

# CreateApplication
<a name="API_CreateApplication"></a>

**참고**  
이 설명서는 Amazon Kinesis Data Analytics API 버전 1용이며, SQL 애플리케이션만 지원합니다. API 버전 2에서 SQL 및 Java 애플리케이션을 지원합니다. 버전 2에 대한 자세한 설명은 [Amazon Kinesis Data Analytics API V2 설명서](/kinesisanalytics/latest/apiv2/Welcome.html)를 참조하십시오.

 Amazon Kinesis Analytics 애플리케이션을 생성합니다. 스트리밍 소스 하나를 입력으로 사용하고, 애플리케이션 코드를 입력으로 사용하고, Amazon Kinesis Analytics에서 애플리케이션의 출력 데이터를 기록할 대상을 최대 3개까지 설정하여 각 애플리케이션을 구성할 수 있습니다. 개관을 위해 [작동 방식](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works.html)을 참조하십시오.

입력 구성에서 스트리밍 소스를 애플리케이션 내 스트림에 매핑합니다. 그것은 지속적으로 업데이트되는 표로 간주할 수 있습니다. 매핑에서 애플리케이션 내 스트림에 대한 스키마를 제공하고 애플리케이션 내 스트림에 있는 각 데이터 열을 스트리밍 소스의 데이터 요소에 매핑합니다.

애플리케이션 코드는 입력 데이터를 읽고, 해당 데이터를 변환하고, 출력을 생성하는 하나 이상의 SQL 문입니다. 애플리케이션 코드는 SQL 스트림 또는 펌프와 같은 하나 이상의 SQL 아티팩트를 생성할 수 있습니다.

출력 구성에서는 애플리케이션에서 만든 애플리케이션 내 스트림의 데이터를 최대 세 개의 대상에 쓰도록 애플리케이션을 구성할 수 있습니다.

 귀하의 소스 스트림으로부터 데이터를 읽거나 대상 스트림에 데이터를 쓰려면 Amazon Kinesis Analytics는 귀하의 권한을 필요로 합니다. 귀하는 IAM 역할을 생성함으로써 그러한 권한을 부여할 수 있습니다. 이 작업에는 `kinesisanalytics:CreateApplication` 조치를 수행할 권한이 요구됩니다.

 Amazon Kinesis Analytics 애플리케이션을 생성하기 위한 입문 연습은 [시작하기](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/getting-started.html)를 참조하십시오.

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

```
{
   "ApplicationCode": "string",
   "ApplicationDescription": "string",
   "ApplicationName": "string",
   "CloudWatchLoggingOptions": [ 
      { 
         "LogStreamARN": "string",
         "RoleARN": "string"
      }
   ],
   "Inputs": [ 
      { 
         "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"
      }
   ],
   "Outputs": [ 
      { 
         "DestinationSchema": { 
            "RecordFormatType": "string"
         },
         "KinesisFirehoseOutput": { 
            "ResourceARN": "string",
            "RoleARN": "string"
         },
         "KinesisStreamsOutput": { 
            "ResourceARN": "string",
            "RoleARN": "string"
         },
         "LambdaOutput": { 
            "ResourceARN": "string",
            "RoleARN": "string"
         },
         "Name": "string"
      }
   ],
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

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

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

 ** [ApplicationCode](#API_CreateApplication_RequestSyntax) **   <a name="analytics-CreateApplication-request-ApplicationCode"></a>
입력 데이터를 읽고, 해당 데이터를 변환하고, 출력을 생성하는 하나 이상의 SQL 문입니다. 예컨대, 한 애플리케이션 내 스트림에서 데이터를 읽고 공급업체의 광고 클릭 수의 이동 평균을 생성하는 SQL 문을 쓰고, 펌프를 사용하여 다른 애플리케이션 내 스트림에 결과 행을 삽입할 수 있습니다. 일반적인 패턴에 대한 자세한 설명은 [애플리케이션 코드](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-app-code.html)를 참조하십시오.  
한 문의 출력을 다음 문의 입력으로 사용할 수 있는 일련의 SQL 문을 제공할 수 있습니다. 애플리케이션 내 스트림과 펌프를 만들어 중간 결과를 저장합니다.  
애플리케이션 코드는 `Outputs`에 지정된 명칭으로 스트림을 만들어야 합니다. 예컨대, `Outputs`이 `ExampleOutputStream1` 및 `ExampleOutputStream2`라는 출력 스트림을 정의하면 애플리케이션 코드는 이러한 스트림을 만들어야 합니다.  
유형: 문자열  
길이 제한: 최소 길이는 0. 최대 길이 102400.  
필수 여부: 아니요

 ** [ApplicationDescription](#API_CreateApplication_RequestSyntax) **   <a name="analytics-CreateApplication-request-ApplicationDescription"></a>
애플리케이션의 요약 설명.  
유형: 문자열  
길이 제약 조건: 최소 길이는 0입니다. 최대 길이 1,024.  
필수 여부: 아니요

 ** [ApplicationName](#API_CreateApplication_RequestSyntax) **   <a name="analytics-CreateApplication-request-ApplicationName"></a>
Amazon Kinesis Analytics 애플리케이션의 명칭 (예: `sample-app`).  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이 128.  
패턴: `[a-zA-Z0-9_.-]+`   
필수 여부: 예

 ** [CloudWatchLoggingOptions](#API_CreateApplication_RequestSyntax) **   <a name="analytics-CreateApplication-request-CloudWatchLoggingOptions"></a>
이 파라미터를 사용하여 CloudWatch 로그 스트림을 애플리케이션 구성 오류를 모니터링합니다. 자세한 설명은 [Amazon CloudWatch Logs 사용](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/cloudwatch-logs.html)을 참조하십시오.  
타입: [CloudWatchLoggingOption](API_CloudWatchLoggingOption.md)객체 배열  
필수: 아니요

 ** [Inputs](#API_CreateApplication_RequestSyntax) **   <a name="analytics-CreateApplication-request-Inputs"></a>
이 파라미터를 사용하여 애플리케이션 입력을 구성합니다.  
단일 스트리밍 소스로부터 입력을 수신하도록 애플리케이션을 구성할 수 있습니다. 이 구성에서는 이 스트리밍 소스를 생성된 애플리케이션 내 스트림에 매핑합니다. 그러면 애플리케이션 코드가 애플리케이션 내 스트림을 표처럼 쿼리할 수 있습니다(지속적으로 업데이트되는 표로 간주할 수 있음).  
스트리밍 소스의 경우 Amazon 리소스 이름(ARN)과 스트림의 데이터 형식(예: JSON, CSV 등)을 제공합니다. Amazon Kinesis Analytics가 사용자를 대신해 이 스트림을 읽기 위해 맡을 수 있는 IAM 역할도 제공해야 합니다.  
애플리케이션 내 스트림을 생성하기 위해서는 SQL에 사용되는 스키마화된 버전으로 데이터를 변환할 스키마를 지정해야 합니다. 스키마에서, 스트리밍 소스의 데이터 요소를 인앱 스트림의 레코드 열에 매핑합니다.  
타입: [Input](API_Input.md)객체 배열  
필수: 아니요

 ** [Outputs](#API_CreateApplication_RequestSyntax) **   <a name="analytics-CreateApplication-request-Outputs"></a>
애플리케이션 내 스트림의 데이터를 최대 세 개의 대상에 쓰도록 애플리케이션 출력을 구성할 수 있습니다.  
이러한 대상은 Amazon Kinesis 스트림, Amazon Kinesis Firehose 전송 AWS 스트림, Lambda 목적지 또는 이 세 가지의 조합일 수 있습니다.  
구성에서 애플리케이션 내 스트림 명칭, 대상 스트림 또는 Lambda 함수 Amazon Resource Name (ARN), 데이터를 쓸 때 사용할 형식을 지정합니다. 또한 Amazon Kinesis Analytics가 귀하를 대신하여 대상 스트림 또는 Lambda 함수에 작성하기 위해 취할 수 있는 IAM 역할도 제공해야 합니다.  
출력 구성에서는 출력 스트림 또는 Lambda 함수 ARN도 제공합니다. 스트림 대상의 경우 스트림의 데이터 형식 (예: JSON, CSV) 을 제공합니다. 또한 Amazon Kinesis Analytics가 귀하를 대신하여 스트림 또는 Lambda 함수에 작성하기 위해 취할 수 있는 IAM 역할도 제공해야 합니다.   
타입: [Output](API_Output.md)객체 배열  
필수: 아니요

 ** [Tags](#API_CreateApplication_RequestSyntax) **   <a name="analytics-CreateApplication-request-Tags"></a>
애플리케이션에 할당할 하나 이상의 태그 목록입니다. 태그는 애플리케이션을 식별하는 키값 페어입니다. 애플리케이션 태그의 최대 수는 시스템 태그를 포함합니다. 사용자 정의 애플리케이션 태그의 최대 수는 50입니다. 자세한 설명은 [태그 사용하기](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-tagging.html)를 참조하십시오  
타입: [Tag](API_Tag.md)객체 배열  
어레이 멤버: 최소 항목 수 1개. 최대 항목 수 200.  
필수 여부: 아니요

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

```
{
   "ApplicationSummary": { 
      "ApplicationARN": "string",
      "ApplicationName": "string",
      "ApplicationStatus": "string"
   }
}
```

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

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

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

 ** [ApplicationSummary](#API_CreateApplication_ResponseSyntax) **   <a name="analytics-CreateApplication-response-ApplicationSummary"></a>
귀하의 `CreateApplication` 요청에 대응하여, Amazon Kinesis Analytics는 애플리케이션 Amazon 리소스 이름 (ARN), 명칭 및 상태를 포함하여 생성한 애플리케이션의 요약이 포함된 응답을 반환합니다.  
타입: [ApplicationSummary](API_ApplicationSummary.md) 객체

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

 ** CodeValidationException **   
사용자가 제공한 애플리케이션 코드 (쿼리) 가 유효하지 않습니다. 이는 단순한 구문 오류일 수 있습니다.    
 ** message **   
테스트
HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

 ** LimitExceededException **   
허용된 애플리케이션 수를 초과했습니다.    
 ** message **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

 ** TooManyTagsException **   
애플리케이션에 너무 많은 태그 또는 너무 많은 태그가 추가된 상태로 애플리케이션이 생성되었습니다. 애플리케이션 태그의 최대 수는 시스템 태그를 포함합니다. 사용자 정의 애플리케이션 태그의 최대 수는 50입니다.  
HTTP 상태 코드: 400

 ** UnsupportedOperationException **   
지정된 파라미터가 지원되지 않거나 지정된 리소스가 이 작업에 유효하지 않아 요청이 거부되었습니다.  
HTTP 상태 코드: 400

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

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

# DeleteApplication
<a name="API_DeleteApplication"></a>

**참고**  
이 설명서는 Amazon Kinesis Data Analytics API 버전 1용이며, SQL 애플리케이션만 지원합니다. API 버전 2에서 SQL 및 Java 애플리케이션을 지원합니다. 버전 2에 대한 자세한 설명은 [Amazon Kinesis Data Analytics API V2 설명서](/kinesisanalytics/latest/apiv2/Welcome.html)를 참조하십시오.

지정된 애플리케이션을 삭제합니다. Amazon Kinesis Analytics는 애플리케이션 실행을 중단하고 애플리케이션 아티팩트 (예: 애플리케이션 내 스트림, 참조 애플리케이션 내, 애플리케이션 코드) 를 비롯한 애플리케이션을 삭제합니다.

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

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

```
{
   "ApplicationName": "string",
   "CreateTimestamp": number
}
```

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

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

 ** [ApplicationName](#API_DeleteApplication_RequestSyntax) **   <a name="analytics-DeleteApplication-request-ApplicationName"></a>
삭제할 Amazon Kinesis Analytics 애플리케이션의 명칭.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이 128.  
패턴: `[a-zA-Z0-9_.-]+`   
필수 여부: 예

 ** [CreateTimestamp](#API_DeleteApplication_RequestSyntax) **   <a name="analytics-DeleteApplication-request-CreateTimestamp"></a>
 `DescribeApplication` 작업으로 이 값을 얻을 수 있습니다.  
유형: 타임스탬프  
필수 항목 여부: 예

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

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

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

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

 ** UnsupportedOperationException **   
지정된 파라미터가 지원되지 않거나 지정된 리소스가 이 작업에 유효하지 않아 요청이 거부되었습니다.  
HTTP 상태 코드: 400

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

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

# DeleteApplicationCloudWatchLoggingOption
<a name="API_DeleteApplicationCloudWatchLoggingOption"></a>

**참고**  
이 설명서는 Amazon Kinesis Data Analytics API 버전 1용이며, SQL 애플리케이션만 지원합니다. API 버전 2에서 SQL 및 Java 애플리케이션을 지원합니다. 버전 2에 대한 자세한 설명은 [Amazon Kinesis Data Analytics API V2 설명서](/kinesisanalytics/latest/apiv2/Welcome.html)를 참조하십시오.

애플리케이션에서 CloudWatch 로그 스트림을 삭제합니다. [Amazon Kinesis Analytics 애플리케이션에서 CloudWatch 로그 스트림을 사용하는 방법에 대한 자세한 설명은 Amazon CloudWatch Logs 사용을 참조하십시오.](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/cloudwatch-logs.html)

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

```
{
   "ApplicationName": "string",
   "CloudWatchLoggingOptionId": "string",
   "CurrentApplicationVersionId": number
}
```

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

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

 ** [ApplicationName](#API_DeleteApplicationCloudWatchLoggingOption_RequestSyntax) **   <a name="analytics-DeleteApplicationCloudWatchLoggingOption-request-ApplicationName"></a>
Kinesis Analytics 애플리케이션 명칭.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이 128.  
패턴: `[a-zA-Z0-9_.-]+`   
필수 여부: 예

 ** [CloudWatchLoggingOptionId](#API_DeleteApplicationCloudWatchLoggingOption_RequestSyntax) **   <a name="analytics-DeleteApplicationCloudWatchLoggingOption-request-CloudWatchLoggingOptionId"></a>
삭제할 CloudWatch 로깅 옵션 `CloudWatchLoggingOptionId` 중 하나입니다. [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 작업을 `CloudWatchLoggingOptionId` 사용하여 가져올 수 있습니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 50.  
패턴: `[a-zA-Z0-9_.-]+`   
필수 여부: 예

 ** [CurrentApplicationVersionId](#API_DeleteApplicationCloudWatchLoggingOption_RequestSyntax) **   <a name="analytics-DeleteApplicationCloudWatchLoggingOption-request-CurrentApplicationVersionId"></a>
Kinesis Analytics 애플리케이션의 버전 ID.  
타입: Long  
유효 범위: 최소값 1. 최대값 999999999.  
필수 여부: 예

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

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

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

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

 ** UnsupportedOperationException **   
지정된 파라미터가 지원되지 않거나 지정된 리소스가 이 작업에 유효하지 않아 요청이 거부되었습니다.  
HTTP 상태 코드: 400

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

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

# DeleteApplicationInputProcessingConfiguration
<a name="API_DeleteApplicationInputProcessingConfiguration"></a>

**참고**  
이 설명서는 Amazon Kinesis Data Analytics API 버전 1용이며, SQL 애플리케이션만 지원합니다. API 버전 2에서 SQL 및 Java 애플리케이션을 지원합니다. 버전 2에 대한 자세한 설명은 [Amazon Kinesis Data Analytics API V2 설명서](/kinesisanalytics/latest/apiv2/Welcome.html)를 참조하십시오.

입력에서 [InputProcessingConfiguration](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_InputProcessingConfiguration.html)을 삭제합니다.

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

```
{
   "ApplicationName": "string",
   "CurrentApplicationVersionId": number,
   "InputId": "string"
}
```

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

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

 ** [ApplicationName](#API_DeleteApplicationInputProcessingConfiguration_RequestSyntax) **   <a name="analytics-DeleteApplicationInputProcessingConfiguration-request-ApplicationName"></a>
Kinesis Analytics 애플리케이션 명칭.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이 128.  
패턴: `[a-zA-Z0-9_.-]+`   
필수 여부: 예

 ** [CurrentApplicationVersionId](#API_DeleteApplicationInputProcessingConfiguration_RequestSyntax) **   <a name="analytics-DeleteApplicationInputProcessingConfiguration-request-CurrentApplicationVersionId"></a>
Kinesis Analytics 애플리케이션의 버전 ID.  
타입: Long  
유효 범위: 최소값 1. 최대값 999999999.  
필수 항목 여부: 예

 ** [InputId](#API_DeleteApplicationInputProcessingConfiguration_RequestSyntax) **   <a name="analytics-DeleteApplicationInputProcessingConfiguration-request-InputId"></a>
입력 처리 구성을 삭제할 입력 구성의 ID입니다. [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 작업을 사용하여 애플리케이션의 입력 ID 목록을 가져올 수 있습니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 50.  
패턴: `[a-zA-Z0-9_.-]+`   
필수 여부: 예

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

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

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

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

 ** UnsupportedOperationException **   
지정된 파라미터가 지원되지 않거나 지정된 리소스가 이 작업에 유효하지 않아 요청이 거부되었습니다.  
HTTP 상태 코드: 400

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

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

# DeleteApplicationOutput
<a name="API_DeleteApplicationOutput"></a>

**참고**  
이 설명서는 Amazon Kinesis Data Analytics API 버전 1용이며, SQL 애플리케이션만 지원합니다. API 버전 2에서 SQL 및 Java 애플리케이션을 지원합니다. 버전 2에 대한 자세한 설명은 [Amazon Kinesis Data Analytics API V2 설명서](/kinesisanalytics/latest/apiv2/Welcome.html)를 참조하십시오.

애플리케이션 구성에서 출력 대상 구성을 삭제합니다. Amazon Kinesis Analytics는 더 이상 해당 애플리케이션 내 스트림의 데이터를 외부 출력 대상에 쓰지 않습니다.

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

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

```
{
   "ApplicationName": "string",
   "CurrentApplicationVersionId": number,
   "OutputId": "string"
}
```

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

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

 ** [ApplicationName](#API_DeleteApplicationOutput_RequestSyntax) **   <a name="analytics-DeleteApplicationOutput-request-ApplicationName"></a>
Amazon Kinesis Analytics 애플리케이션 명칭  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이 128.  
패턴: `[a-zA-Z0-9_.-]+`   
필수 여부: 예

 ** [CurrentApplicationVersionId](#API_DeleteApplicationOutput_RequestSyntax) **   <a name="analytics-DeleteApplicationOutput-request-CurrentApplicationVersionId"></a>
Amazon Kinesis Analytics 애플리케이션 버전 [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 작업을 사용하여 최신 애플리케이션 버전을 찾을 수 있습니다. 지정된 버전이 최신 버전이 아닌 경우 `ConcurrentModificationException`가 반환됩니다.  
타입: Long  
유효 범위: 최소값 1. 최대값 999999999.  
필수 항목 여부: 예

 ** [OutputId](#API_DeleteApplicationOutput_RequestSyntax) **   <a name="analytics-DeleteApplicationOutput-request-OutputId"></a>
삭제할 구성의 ID. 애플리케이션을 만들 때 또는 나중에 [AddApplicationOutput](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_AddApplicationOutput.html) 작업을 사용하여 애플리케이션에 추가되는 각 출력 구성에는 고유한 ID가 있습니다. 애플리케이션 구성에서 삭제하려는 출력 구성을 고유하게 식별하려면 ID를 제공해야 합니다. [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 작업을 통하여 특정 `OutputId`를 가져올 수 있습니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 50.  
패턴: `[a-zA-Z0-9_.-]+`   
필수 여부: 예

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

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

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

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

 ** UnsupportedOperationException **   
지정된 파라미터가 지원되지 않거나 지정된 리소스가 이 작업에 유효하지 않아 요청이 거부되었습니다.  
HTTP 상태 코드: 400

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

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

# DeleteApplicationReferenceDataSource
<a name="API_DeleteApplicationReferenceDataSource"></a>

**참고**  
이 설명서는 Amazon Kinesis Data Analytics API 버전 1용이며, SQL 애플리케이션만 지원합니다. API 버전 2에서 SQL 및 Java 애플리케이션을 지원합니다. 버전 2에 대한 자세한 설명은 [Amazon Kinesis Data Analytics API V2 설명서](/kinesisanalytics/latest/apiv2/Welcome.html)를 참조하십시오.

지정된 애플리케이션 구성에서 참조 데이터 소스 구성을 삭제합니다.

애플리케이션이 실행 중인 경우, Amazon Kinesis Analytics는 [AddApplicationReferenceDataSource](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_AddApplicationReferenceDataSource.html) 작업을 사용하여 생성한 애플리케이션 내 표를 즉시 제거합니다.

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

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

```
{
   "ApplicationName": "string",
   "CurrentApplicationVersionId": number,
   "ReferenceId": "string"
}
```

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

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

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

 ** [CurrentApplicationVersionId](#API_DeleteApplicationReferenceDataSource_RequestSyntax) **   <a name="analytics-DeleteApplicationReferenceDataSource-request-CurrentApplicationVersionId"></a>
애플리케이션의 버전입니다. [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 작업을 사용하여 최신 애플리케이션 버전을 찾을 수 있습니다. 지정된 버전이 최신 버전이 아닌 경우 `ConcurrentModificationException`가 반환됩니다.  
타입: Long  
유효 범위: 최소값 1. 최대값 999999999.  
필수 여부: 예

 ** [ReferenceId](#API_DeleteApplicationReferenceDataSource_RequestSyntax) **   <a name="analytics-DeleteApplicationReferenceDataSource-request-ReferenceId"></a>
준거 데이터 소스의 ID. 이 ID는 [AddApplicationReferenceDataSource](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_AddApplicationReferenceDataSource.html)를 사용하여 준거 데이터 소스를 애플리케이션에 추가할 때 Amazon Kinesis Analytics에서 할당하는 ID입니다. [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 작업을 사용하여 참조 ID를 가져올 수 있습니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 50.  
패턴: `[a-zA-Z0-9_.-]+`   
필수 여부: 예

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

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

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

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

 ** UnsupportedOperationException **   
지정된 파라미터가 지원되지 않거나 지정된 리소스가 이 작업에 유효하지 않아 요청이 거부되었습니다.  
HTTP 상태 코드: 400

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

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

# DescribeApplication
<a name="API_DescribeApplication"></a>

**참고**  
이 설명서는 Amazon Kinesis Data Analytics API 버전 1용이며, SQL 애플리케이션만 지원합니다. API 버전 2에서 SQL 및 Java 애플리케이션을 지원합니다. 버전 2에 대한 자세한 설명은 [Amazon Kinesis Data Analytics API V2 설명서](/kinesisanalytics/latest/apiv2/Welcome.html)를 참조하십시오.

Amazon Kinesis Analytics 애플리케이션에 대한 정보를 반환합니다.

계정의 모든 애플리케이션 목록을 검색하려면 [ListApplications](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_ListApplications.html) 작업을 사용하십시오.

이 작업에는 `kinesisanalytics:DescribeApplication` 조치를 수행할 권한이 요구됩니다. `Update`와 같은 다른 작업을 호출하는 데 필요한 현재 애플리케이션 버전 ID를 가져오는 데 `DescribeApplication`을 사용할 수 있습니다. 

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

```
{
   "ApplicationName": "string"
}
```

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

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

 ** [ApplicationName](#API_DescribeApplication_RequestSyntax) **   <a name="analytics-DescribeApplication-request-ApplicationName"></a>
애플리케이션의 명칭.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이 128.  
패턴: `[a-zA-Z0-9_.-]+`   
필수 여부: 예

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

```
{
   "ApplicationDetail": { 
      "ApplicationARN": "string",
      "ApplicationCode": "string",
      "ApplicationDescription": "string",
      "ApplicationName": "string",
      "ApplicationStatus": "string",
      "ApplicationVersionId": number,
      "CloudWatchLoggingOptionDescriptions": [ 
         { 
            "CloudWatchLoggingOptionId": "string",
            "LogStreamARN": "string",
            "RoleARN": "string"
         }
      ],
      "CreateTimestamp": number,
      "InputDescriptions": [ 
         { 
            "InAppStreamNames": [ "string" ],
            "InputId": "string",
            "InputParallelism": { 
               "Count": number
            },
            "InputProcessingConfigurationDescription": { 
               "InputLambdaProcessorDescription": { 
                  "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"
               }
            },
            "InputStartingPositionConfiguration": { 
               "InputStartingPosition": "string"
            },
            "KinesisFirehoseInputDescription": { 
               "ResourceARN": "string",
               "RoleARN": "string"
            },
            "KinesisStreamsInputDescription": { 
               "ResourceARN": "string",
               "RoleARN": "string"
            },
            "NamePrefix": "string"
         }
      ],
      "LastUpdateTimestamp": number,
      "OutputDescriptions": [ 
         { 
            "DestinationSchema": { 
               "RecordFormatType": "string"
            },
            "KinesisFirehoseOutputDescription": { 
               "ResourceARN": "string",
               "RoleARN": "string"
            },
            "KinesisStreamsOutputDescription": { 
               "ResourceARN": "string",
               "RoleARN": "string"
            },
            "LambdaOutputDescription": { 
               "ResourceARN": "string",
               "RoleARN": "string"
            },
            "Name": "string",
            "OutputId": "string"
         }
      ],
      "ReferenceDataSourceDescriptions": [ 
         { 
            "ReferenceId": "string",
            "ReferenceSchema": { 
               "RecordColumns": [ 
                  { 
                     "Mapping": "string",
                     "Name": "string",
                     "SqlType": "string"
                  }
               ],
               "RecordEncoding": "string",
               "RecordFormat": { 
                  "MappingParameters": { 
                     "CSVMappingParameters": { 
                        "RecordColumnDelimiter": "string",
                        "RecordRowDelimiter": "string"
                     },
                     "JSONMappingParameters": { 
                        "RecordRowPath": "string"
                     }
                  },
                  "RecordFormatType": "string"
               }
            },
            "S3ReferenceDataSourceDescription": { 
               "BucketARN": "string",
               "FileKey": "string",
               "ReferenceRoleARN": "string"
            },
            "TableName": "string"
         }
      ]
   }
}
```

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

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

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

 ** [ApplicationDetail](#API_DescribeApplication_ResponseSyntax) **   <a name="analytics-DescribeApplication-response-ApplicationDetail"></a>
애플리케이션 Amazon 리소스 이름(ARN), 상태, 최신 버전, 입력 및 출력 구성 세부 정보와 같은 애플리케이션에 대한 설명을 제공합니다.  
타입: [ApplicationDetail](API_ApplicationDetail.md) 객체

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

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

HTTP 상태 코드: 400

 ** UnsupportedOperationException **   
지정된 파라미터가 지원되지 않거나 지정된 리소스가 이 작업에 유효하지 않아 요청이 거부되었습니다.  
HTTP 상태 코드: 400

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

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

# DiscoverInputSchema
<a name="API_DiscoverInputSchema"></a>

**참고**  
이 설명서는 Amazon Kinesis Data Analytics API 버전 1용이며, SQL 애플리케이션만 지원합니다. API 버전 2에서 SQL 및 Java 애플리케이션을 지원합니다. 버전 2에 대한 자세한 설명은 [Amazon Kinesis Data Analytics API V2 설명서](/kinesisanalytics/latest/apiv2/Welcome.html)를 참조하십시오.

지정된 스트리밍 소스 (Amazon Kinesis 스트림 또는 Amazon Kinesis Firehose 전송 스트림) 또는 S3 객체의 샘플 레코드를 평가하여 스키마를 유추합니다. 응답에서 작업은 추론된 스키마와 작업에서 스키마를 추론하는 데 사용한 샘플 레코드를 반환합니다.

 애플리케이션의 스트리밍 소스를 구성할 때 유추된 스키마를 사용할 수 있습니다. 개념 정보는 [애플리케이션 입력 구성](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-input.html)을 참조하십시오. Amazon Kinesis Analytics 콘솔을 사용하여 애플리케이션을 생성하면 콘솔은 이 작업을 사용하여 스키마를 유추하고 콘솔 사용자 인터페이스에 표시한다는 점에 유의하십시오.

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

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

```
{
   "InputProcessingConfiguration": { 
      "InputLambdaProcessor": { 
         "ResourceARN": "string",
         "RoleARN": "string"
      }
   },
   "InputStartingPositionConfiguration": { 
      "InputStartingPosition": "string"
   },
   "ResourceARN": "string",
   "RoleARN": "string",
   "S3Configuration": { 
      "BucketARN": "string",
      "FileKey": "string",
      "RoleARN": "string"
   }
}
```

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

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

 ** [InputProcessingConfiguration](#API_DiscoverInputSchema_RequestSyntax) **   <a name="analytics-DiscoverInputSchema-request-InputProcessingConfiguration"></a>
레코드의 스키마를 발견하기 전에 레코드를 사전 처리하는 데 사용할 [InputProcessingConfiguration](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_InputProcessingConfiguration.html).  
유형: [InputProcessingConfiguration](API_InputProcessingConfiguration.md)객체  
필수 여부: 아니요

 ** [InputStartingPositionConfiguration](#API_DiscoverInputSchema_RequestSyntax) **   <a name="analytics-DiscoverInputSchema-request-InputStartingPositionConfiguration"></a>
Amazon Kinesis Analytics가 지정된 스트리밍 소스 검색 목적의 레코드 읽기를 시작하도록 하려는 시점입니다.  
유형: [InputStartingPositionConfiguration](API_InputStartingPositionConfiguration.md)객체  
필수 여부: 아니요

 ** [ResourceARN](#API_DiscoverInputSchema_RequestSyntax) **   <a name="analytics-DiscoverInputSchema-request-ResourceARN"></a>
스트리밍 소스의 Amazon 리소스 이름(ARN).  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 2,048.  
패턴: `arn:.*`   
필수 여부: 아니요

 ** [RoleARN](#API_DiscoverInputSchema_RequestSyntax) **   <a name="analytics-DiscoverInputSchema-request-RoleARN"></a>
Amazon Kinesis Analytics가 스트림에 액세스할 수 있는 권한을 주는 IAM 역할의 ARN입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 2,048.  
패턴: `arn:.*`   
필수 여부: 아니요

 ** [S3Configuration](#API_DiscoverInputSchema_RequestSyntax) **   <a name="analytics-DiscoverInputSchema-request-S3Configuration"></a>
Amazon S3 객체의 데이터에서 스키마를 검색하려면 이 파라미터를 지정합니다.  
유형: [S3Configuration](API_S3Configuration.md)객체  
필수 항목 여부: 아니요

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

```
{
   "InputSchema": { 
      "RecordColumns": [ 
         { 
            "Mapping": "string",
            "Name": "string",
            "SqlType": "string"
         }
      ],
      "RecordEncoding": "string",
      "RecordFormat": { 
         "MappingParameters": { 
            "CSVMappingParameters": { 
               "RecordColumnDelimiter": "string",
               "RecordRowDelimiter": "string"
            },
            "JSONMappingParameters": { 
               "RecordRowPath": "string"
            }
         },
         "RecordFormatType": "string"
      }
   },
   "ParsedInputRecords": [ 
      [ "string" ]
   ],
   "ProcessedInputRecords": [ "string" ],
   "RawInputRecords": [ "string" ]
}
```

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

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

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

 ** [InputSchema](#API_DiscoverInputSchema_ResponseSyntax) **   <a name="analytics-DiscoverInputSchema-response-InputSchema"></a>
스트리밍 소스에서 추론된 스키마. 스트리밍 소스의 데이터의 형식을 식별하고 각 데이터 요소가 애플리케이션 내 스트림에서 생성할 수 있는 해당 열에 매핑하는 방법을 설명합니다.  
유형: [SourceSchema](API_SourceSchema.md)객체

 ** [ParsedInputRecords](#API_DiscoverInputSchema_ResponseSyntax) **   <a name="analytics-DiscoverInputSchema-response-ParsedInputRecords"></a>
각 요소가 스트림 레코드의 행에 해당하는 요소 배열 (스트림 레코드는 행을 두 개 이상 포함할 수 있음).  
유형: 문자열 배열들의 배열

 ** [ProcessedInputRecords](#API_DiscoverInputSchema_ResponseSyntax) **   <a name="analytics-DiscoverInputSchema-response-ProcessedInputRecords"></a>
`InputProcessingConfiguration` 파라미터에 지정된 프로세서가 수정한 스트림 데이터.  
유형: 문자열 배열

 ** [RawInputRecords](#API_DiscoverInputSchema_ResponseSyntax) **   <a name="analytics-DiscoverInputSchema-response-RawInputRecords"></a>
스키마를 유추하기 위해 샘플링된 원시 스트림 데이터입니다.  
유형: 문자열 배열

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

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

HTTP 상태 코드: 400

 ** ResourceProvisionedThroughputExceededException **   
Amazon Kinesis Streams의 프로비저닝된 처리량 ProvisionedExceedExceedeException 때문에 디스커버리가 스트리밍 소스에서 레코드를 가져오지 못했습니다. 자세한 내용을 알아보려면 Amazon Kinesis 스트림 API 참조의 [GetRecords](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_GetRecords.html)를 참조하십시오.  
HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
이 서비스를 사용할 수 없습니다. 작업을 다시 시도하십시오.  
HTTP 상태 코드: 500

 ** UnableToDetectSchemaException **   
유효하지 않는 날짜 형식입니다. Amazon Kinesis Analytics는 지정된 스트리밍 소스에 대한 스키마를 탐지할 수 없습니다.  
HTTP 상태 코드: 400

 ** UnsupportedOperationException **   
지정된 파라미터가 지원되지 않거나 지정된 리소스가 이 작업에 유효하지 않아 요청이 거부되었습니다.  
HTTP 상태 코드: 400

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

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

# ListApplications
<a name="API_ListApplications"></a>

**참고**  
이 설명서는 Amazon Kinesis Data Analytics API 버전 1용이며, SQL 애플리케이션만 지원합니다. API 버전 2에서 SQL 및 Java 애플리케이션을 지원합니다. 버전 2에 대한 자세한 설명은 [Amazon Kinesis Data Analytics API V2 설명서](/kinesisanalytics/latest/apiv2/Welcome.html)를 참조하십시오.

계정에 있는 Amazon Kinesis Analytics 애플리케이션 목록을 반환합니다. 각 애플리케이션에 대한 응답에는 애플리케이션 명칭, Amazon 리소스 이름 (ARN) 및 상태가 포함됩니다. 응답에서 `HasMoreApplications` 값이 참으로 반환되는 경우 요청 본문에 `ExclusiveStartApplicationName`를 추가하여 다른 요청을 보내고 이 값을 이전 응답의 마지막 애플리케이션 명칭으로 설정할 수 있습니다.

특정 애플리케이션에 대한 자세한 정보가 필요하면 [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html)을 사용하십시오.

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

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

```
{
   "ExclusiveStartApplicationName": "string",
   "Limit": number
}
```

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

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

 ** [ExclusiveStartApplicationName](#API_ListApplications_RequestSyntax) **   <a name="analytics-ListApplications-request-ExclusiveStartApplicationName"></a>
목록을 시작할 때 사용할 애플리케이션의 명칭. 페이지 매김을 사용하여 목록을 검색할 경우 첫 번째 요청에서 이 파라미터를 지정하지 않아도 됩니다. 하지만 후속 요청에서는 이전 응답의 마지막 애플리케이션 명칭을 추가하여 애플리케이션의 다음 페이지를 가져옵니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이 128.  
패턴: `[a-zA-Z0-9_.-]+`   
필수 여부: 아니요

 ** [Limit](#API_ListApplications_RequestSyntax) **   <a name="analytics-ListApplications-request-Limit"></a>
나열할 애플리케이션의 최대수.  
타입: 정수  
유효 범위: 최소값 1. 최대값 50.  
필수 항목 여부: 아니요

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

```
{
   "ApplicationSummaries": [ 
      { 
         "ApplicationARN": "string",
         "ApplicationName": "string",
         "ApplicationStatus": "string"
      }
   ],
   "HasMoreApplications": boolean
}
```

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

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

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

 ** [ApplicationSummaries](#API_ListApplications_ResponseSyntax) **   <a name="analytics-ListApplications-response-ApplicationSummaries"></a>
`ApplicationSummary` 객체의 목록.  
타입: [ApplicationSummary](API_ApplicationSummary.md)객체 배열

 ** [HasMoreApplications](#API_ListApplications_ResponseSyntax) **   <a name="analytics-ListApplications-response-HasMoreApplications"></a>
검색할 애플리케이션이 더 있는 경우 참을 반환합니다.  
유형: Boolean

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

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

# ListTagsForResource
<a name="API_ListTagsForResource"></a>

애플리케이션에 할당된 키값 태그의 목록을 검색합니다. 자세한 설명은 [태그 사용](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-tagging.html)을 참조하십시오.

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

```
{
   "ResourceARN": "string"
}
```

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

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

 ** [ResourceARN](#API_ListTagsForResource_RequestSyntax) **   <a name="analytics-ListTagsForResource-request-ResourceARN"></a>
태그를 검색하기 위한 애플리케이션의 ARN.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 2,048.  
패턴: `arn:.*`   
필수 여부: 예

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

```
{
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

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

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

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

 ** [Tags](#API_ListTagsForResource_ResponseSyntax) **   <a name="analytics-ListTagsForResource-response-Tags"></a>
애플리케이션에 할당된 키값 태그.  
타입: [Tag](API_Tag.md)객체 배열  
어레이 멤버: 최소 항목 수 1개. 최대 항목 수 200.

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

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

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

# StartApplication
<a name="API_StartApplication"></a>

**참고**  
이 설명서는 Amazon Kinesis Data Analytics API 버전 1용이며, SQL 애플리케이션만 지원합니다. API 버전 2에서 SQL 및 Java 애플리케이션을 지원합니다. 버전 2에 대한 자세한 설명은 [Amazon Kinesis Data Analytics API V2 설명서](/kinesisanalytics/latest/apiv2/Welcome.html)를 참조하십시오.

지정된 Amazon Kinesis Analytics 애플리케이션을 시작합니다. 애플리케이션을 생성한 후에는 이 작업을 독점적으로 호출하여 애플리케이션을 시작해야 합니다.

애플리케이션이 시작되면 입력 데이터를 소비하기 시작하고 처리한 다음 구성된 대상에 출력을 씁니다.

 애플리케이션을 시작하려면 애플리케이션 상태가 해당 애플리케이션 상태여야 `READY` 합니다. 콘솔에서 또는 [DescribeCustomKeyStores](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 작업을 사용하여 애플리케이션 상태를 볼 수 있습니다.

애플리케이션을 시작한 후 [StopApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_StopApplication.html) 작업을 호출하여 애플리케이션이 입력을 처리하지 못하도록 할 수 있습니다.

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

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

```
{
   "ApplicationName": "string",
   "InputConfigurations": [ 
      { 
         "Id": "string",
         "InputStartingPositionConfiguration": { 
            "InputStartingPosition": "string"
         }
      }
   ]
}
```

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

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

 ** [ApplicationName](#API_StartApplication_RequestSyntax) **   <a name="analytics-StartApplication-request-ApplicationName"></a>
애플리케이션의 명칭.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이 128.  
패턴: `[a-zA-Z0-9_.-]+`   
필수 여부: 예

 ** [InputConfigurations](#API_StartApplication_RequestSyntax) **   <a name="analytics-StartApplication-request-InputConfigurations"></a>
애플리케이션이 사용하기 시작하는 특정 입력을 ID로 식별합니다. Amazon Kinesis Analytics는 입력과 관련된 스트리밍 소스를 읽기 시작합니다. 또한 귀하는 스트리밍 소스의 어디에서 Amazon Kinesis Analytics가 읽기를 시작할지를 지정할 수 있습니다.  
타입: [InputConfiguration](API_InputConfiguration.md)객체 배열  
필수 항목 여부: 예

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

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

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

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

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

 ** UnsupportedOperationException **   
지정된 파라미터가 지원되지 않거나 지정된 리소스가 이 작업에 유효하지 않아 요청이 거부되었습니다.  
HTTP 상태 코드: 400

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

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

# StopApplication
<a name="API_StopApplication"></a>

**참고**  
이 설명서는 Amazon Kinesis Data Analytics API 버전 1용이며, SQL 애플리케이션만 지원합니다. API 버전 2에서 SQL 및 Java 애플리케이션을 지원합니다. 버전 2에 대한 자세한 설명은 [Amazon Kinesis Data Analytics API V2 설명서](/kinesisanalytics/latest/apiv2/Welcome.html)를 참조하십시오.

애플리케이션이 입력 데이터를 처리하지 못하도록 중지합니다. 실행 상태인 경우에만 애플리케이션을 중지할 수 있습니다. [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 작업을 사용하여 애플리케이션 상태를 찾을 수 있습니다. 애플리케이션이 중지되면 Amazon Kinesis Analytics는 입력에서 데이터 읽기를 중지하고, 애플리케이션은 데이터 처리를 중지하며, 대상에 출력은 기록되지 않습니다.

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

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

```
{
   "ApplicationName": "string"
}
```

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

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

 ** [ApplicationName](#API_StopApplication_RequestSyntax) **   <a name="analytics-StopApplication-request-ApplicationName"></a>
중지하려는 실행 중 애플리케이션의 명칭.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이 128.  
패턴: `[a-zA-Z0-9_.-]+`   
필수 여부: 예

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

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

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

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

 ** UnsupportedOperationException **   
지정된 파라미터가 지원되지 않거나 지정된 리소스가 이 작업에 유효하지 않아 요청이 거부되었습니다.  
HTTP 상태 코드: 400

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

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

# TagResource
<a name="API_TagResource"></a>

Kinesis Analytics 애플리케이션에 하나 이상의 키값 태그를 추가합니다. 애플리케이션 태그의 최대 수는 시스템 태그를 포함합니다. 사용자 정의 애플리케이션 태그의 최대 수는 50입니다. 자세한 설명은 [태그 사용하기](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-tagging.html)를 참조하십시오.

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

```
{
   "ResourceARN": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

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

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

 ** [ResourceARN](#API_TagResource_RequestSyntax) **   <a name="analytics-TagResource-request-ResourceARN"></a>
태그를 지정하기 위한 애플리케이션의 ARN.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 2,048.  
패턴: `arn:.*`   
필수 여부: 예

 ** [Tags](#API_TagResource_RequestSyntax) **   <a name="analytics-TagResource-request-Tags"></a>
애플리케이션에 할당된 키값 태그.  
타입: [Tag](API_Tag.md)객체 배열  
어레이 멤버: 최소 항목 수 1개. 최대 항목 수 200.  
필수 여부: 예

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

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

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

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

 ** TooManyTagsException **   
애플리케이션에 너무 많은 태그 또는 너무 많은 태그가 추가된 상태로 애플리케이션이 생성되었습니다. 애플리케이션 태그의 최대 수는 시스템 태그를 포함합니다. 사용자 정의 애플리케이션 태그의 최대 수는 50입니다.  
HTTP 상태 코드: 400

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

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

# UntagResource
<a name="API_UntagResource"></a>

Kinesis Analytics 애플리케이션에서 하나 이상의 태그를 제거합니다. 자세한 설명은 [태그 사용하기](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-tagging.html)를 참조하십시오

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

```
{
   "ResourceARN": "string",
   "TagKeys": [ "string" ]
}
```

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

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

 ** [ResourceARN](#API_UntagResource_RequestSyntax) **   <a name="analytics-UntagResource-request-ResourceARN"></a>
태그를 제거할 Kinesis Analytics 애플리케이션의 ARN입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 2,048.  
패턴: `arn:.*`   
필수 여부: 예

 ** [TagKeys](#API_UntagResource_RequestSyntax) **   <a name="analytics-UntagResource-request-TagKeys"></a>
지정된 애플리케이션에서 제거할 태그의 키 목록입니다.  
타입: 문자열 배열  
배열 구성원: 최소수는 1개입니다. 최대 항목 수 200.  
길이 제약: 최소 길이 1. 최대 길이는 128.  
필수 항목 여부: 예

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

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

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

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

 ** TooManyTagsException **   
애플리케이션에 너무 많은 태그 또는 너무 많은 태그가 추가된 상태로 애플리케이션이 생성되었습니다. 애플리케이션 태그의 최대 수는 시스템 태그를 포함합니다. 사용자 정의 애플리케이션 태그의 최대 수는 50입니다.  
HTTP 상태 코드: 400

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

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

# UpdateApplication
<a name="API_UpdateApplication"></a>

**참고**  
이 설명서는 Amazon Kinesis Data Analytics API 버전 1용이며, SQL 애플리케이션만 지원합니다. API 버전 2에서 SQL 및 Java 애플리케이션을 지원합니다. 버전 2에 대한 자세한 설명은 [Amazon Kinesis Data Analytics API V2 설명서](/kinesisanalytics/latest/apiv2/Welcome.html)를 참조하십시오.

기존 Amazon Kinesis Analytics 애플리케이션을 업데이트합니다. 이 API를 사용하여 애플리케이션 코드, 입력 구성 및 출력 구성을 업데이트할 수 있습니다.

Amazon Kinesis Analytics는 애플리케이션을 업데이트할 때마다 `CurrentApplicationVersionId`을 업데이트 한다는 것을 유의하십시오.

이 작업에는 `kinesisanalytics:UpdateApplication` 작업 권한이 필요합니다.

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

```
{
   "ApplicationName": "string",
   "ApplicationUpdate": { 
      "ApplicationCodeUpdate": "string",
      "CloudWatchLoggingOptionUpdates": [ 
         { 
            "CloudWatchLoggingOptionId": "string",
            "LogStreamARNUpdate": "string",
            "RoleARNUpdate": "string"
         }
      ],
      "InputUpdates": [ 
         { 
            "InputId": "string",
            "InputParallelismUpdate": { 
               "CountUpdate": number
            },
            "InputProcessingConfigurationUpdate": { 
               "InputLambdaProcessorUpdate": { 
                  "ResourceARNUpdate": "string",
                  "RoleARNUpdate": "string"
               }
            },
            "InputSchemaUpdate": { 
               "RecordColumnUpdates": [ 
                  { 
                     "Mapping": "string",
                     "Name": "string",
                     "SqlType": "string"
                  }
               ],
               "RecordEncodingUpdate": "string",
               "RecordFormatUpdate": { 
                  "MappingParameters": { 
                     "CSVMappingParameters": { 
                        "RecordColumnDelimiter": "string",
                        "RecordRowDelimiter": "string"
                     },
                     "JSONMappingParameters": { 
                        "RecordRowPath": "string"
                     }
                  },
                  "RecordFormatType": "string"
               }
            },
            "KinesisFirehoseInputUpdate": { 
               "ResourceARNUpdate": "string",
               "RoleARNUpdate": "string"
            },
            "KinesisStreamsInputUpdate": { 
               "ResourceARNUpdate": "string",
               "RoleARNUpdate": "string"
            },
            "NamePrefixUpdate": "string"
         }
      ],
      "OutputUpdates": [ 
         { 
            "DestinationSchemaUpdate": { 
               "RecordFormatType": "string"
            },
            "KinesisFirehoseOutputUpdate": { 
               "ResourceARNUpdate": "string",
               "RoleARNUpdate": "string"
            },
            "KinesisStreamsOutputUpdate": { 
               "ResourceARNUpdate": "string",
               "RoleARNUpdate": "string"
            },
            "LambdaOutputUpdate": { 
               "ResourceARNUpdate": "string",
               "RoleARNUpdate": "string"
            },
            "NameUpdate": "string",
            "OutputId": "string"
         }
      ],
      "ReferenceDataSourceUpdates": [ 
         { 
            "ReferenceId": "string",
            "ReferenceSchemaUpdate": { 
               "RecordColumns": [ 
                  { 
                     "Mapping": "string",
                     "Name": "string",
                     "SqlType": "string"
                  }
               ],
               "RecordEncoding": "string",
               "RecordFormat": { 
                  "MappingParameters": { 
                     "CSVMappingParameters": { 
                        "RecordColumnDelimiter": "string",
                        "RecordRowDelimiter": "string"
                     },
                     "JSONMappingParameters": { 
                        "RecordRowPath": "string"
                     }
                  },
                  "RecordFormatType": "string"
               }
            },
            "S3ReferenceDataSourceUpdate": { 
               "BucketARNUpdate": "string",
               "FileKeyUpdate": "string",
               "ReferenceRoleARNUpdate": "string"
            },
            "TableNameUpdate": "string"
         }
      ]
   },
   "CurrentApplicationVersionId": number
}
```

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

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

 ** [ApplicationName](#API_UpdateApplication_RequestSyntax) **   <a name="analytics-UpdateApplication-request-ApplicationName"></a>
업데이트할 Amazon Kinesis Analytics 애플리케이션의 명칭입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이 128.  
패턴: `[a-zA-Z0-9_.-]+`   
필수 여부: 예

 ** [ApplicationUpdate](#API_UpdateApplication_RequestSyntax) **   <a name="analytics-UpdateApplication-request-ApplicationUpdate"></a>
애플리케이션 업데이트에 대해 설명합니다.  
타입: [ApplicationUpdate](API_ApplicationUpdate.md)객체  
필수 여부: 예

 ** [CurrentApplicationVersionId](#API_UpdateApplication_RequestSyntax) **   <a name="analytics-UpdateApplication-request-CurrentApplicationVersionId"></a>
최신 애플리케이션 버전 ID. [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 작업을 사용하여 이 값을 얻을 수 있습니다.  
타입: Long  
유효 범위: 최소값 1. 최대값 999999999.  
필수 여부: 예

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

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

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

 ** CodeValidationException **   
사용자가 제공한 애플리케이션 코드 (쿼리) 가 유효하지 않습니다. 이는 단순한 구문 오류일 수 있습니다.    
 ** message **   
테스트
HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

 ** UnsupportedOperationException **   
지정된 파라미터가 지원되지 않거나 지정된 리소스가 이 작업에 유효하지 않아 요청이 거부되었습니다.  
HTTP 상태 코드: 400

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

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