在仔細考慮之後，我們決定停止 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)。 本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 動作 支援以下動作： + [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 **注意** 此文件適用於 Amazon Kinesis Data Analytics API 第 1 版，僅支援 SQL 應用程式。第 2 版的 API 則支援 SQL 和 Java 應用程式。如需第 2 版的詳細資訊，請參閱 [Amazon Kinesis Data Analytics API V2 文件](/kinesisanalytics/latest/apiv2/Welcome.html)。 新增 CloudWatch 日誌串流來監控應用程式組態錯誤。如需將 CloudWatch 日誌串流與 Amazon Kinesis Analytics 應用程式搭配使用的詳細資訊，請參閱[使用 Amazon CloudWatch Logs](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/cloudwatch-logs.html)。 ## 請求語法 ``` { "ApplicationName": "string", "CloudWatchLoggingOption": { "LogStreamARN": "string", "RoleARN": "string" }, "CurrentApplicationVersionId": number } ``` ## 請求參數 請求接受採用 JSON 格式的下列資料。 ** [ApplicationName](#API_AddApplicationCloudWatchLoggingOption_RequestSyntax) ** Kinesis Analytics 應用程式名稱。 類型：字串 長度限制：長度下限為 1。長度上限為 128。 模式：`[a-zA-Z0-9_.-]+` 必要：是 ** [CloudWatchLoggingOption](#API_AddApplicationCloudWatchLoggingOption_RequestSyntax) ** 提供 CloudWatch 日誌串流 Amazon Resource Name (ARN) 和 IAM 角色 ARN。備註：若要將應用程式訊息寫入 CloudWatch，所使用的 IAM 角色必須啟用 `PutLogEvents` 政策動作。 類型：[CloudWatchLoggingOption](API_CloudWatchLoggingOption.md) 物件 必要：是 ** [CurrentApplicationVersionId](#API_AddApplicationCloudWatchLoggingOption_RequestSyntax) ** Kinesis Analytic 應用程式的版本 ID。 類型：Long 有效範圍：最小值為 1。最大值為 999999999。 必要：是 ## 回應元素 如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** ConcurrentModificationException ** 並行修改應用程式的結果拋出例外。例如，有兩個人嘗試同時編輯相同的應用程式。 ** message ** HTTP 狀態碼：400 ** InvalidArgumentException ** 指定的輸入參數值無效。 ** message ** HTTP 狀態碼：400 ** ResourceInUseException ** 應用程式不適用於此作業。 ** message ** HTTP 狀態碼：400 ** ResourceNotFoundException ** 找不到指定的應用程式。 ** message ** HTTP 狀態碼：400 ** UnsupportedOperationException ** 請求被拒絕，因為指定的參數不受支持，或指定的資源對此操作無效。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [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 適用於 C\$1\$1 的 SDK](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 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/AddApplicationCloudWatchLoggingOption) + [AWS 適用於 Kotlin 的 SDK](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 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/AddApplicationCloudWatchLoggingOption) # AddApplicationInput **注意** 此文件適用於 Amazon Kinesis Data Analytics API 第 1 版，僅支援 SQL 應用程式。第 2 版的 API 則支援 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` 動作。 ## 請求語法 ``` { "ApplicationName": "string", "CurrentApplicationVersionId": number, "Input": { "InputParallelism": { "Count": number }, "InputProcessingConfiguration": { "InputLambdaProcessor": { "ResourceARN": "string", "RoleARN": "string" } }, "InputSchema": { "RecordColumns": [ { "Mapping": "string", "Name": "string", "SqlType": "string" } ], "RecordEncoding": "string", "RecordFormat": { "MappingParameters": { "CSVMappingParameters": { "RecordColumnDelimiter": "string", "RecordRowDelimiter": "string" }, "JSONMappingParameters": { "RecordRowPath": "string" } }, "RecordFormatType": "string" } }, "KinesisFirehoseInput": { "ResourceARN": "string", "RoleARN": "string" }, "KinesisStreamsInput": { "ResourceARN": "string", "RoleARN": "string" }, "NamePrefix": "string" } } ``` ## 請求參數 請求接受採用 JSON 格式的下列資料。 ** [ApplicationName](#API_AddApplicationInput_RequestSyntax) ** 要新增串流來源的現有 Amazon Kinesis Analytics 應用程式名稱。 類型：字串 長度限制：長度下限為 1。長度上限為 128。 模式：`[a-zA-Z0-9_.-]+` 必要：是 ** [CurrentApplicationVersionId](#API_AddApplicationInput_RequestSyntax) ** 您的 Amazon Kinesis Analytics 應用程式的最新版本。您可以使用 [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 操作來尋找目前的應用程式版本。 類型：Long 有效範圍：最小值為 1。最大值為 999999999。 必要：是 ** [Input](#API_AddApplicationInput_RequestSyntax) ** 要添加的[輸入](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_Input.html)。 類型：[Input](API_Input.md) 物件 必要：是 ## 回應元素 如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** CodeValidationException ** 使用者提供的應用程式碼 (查詢) 無效。這可能是一個簡單的語法錯誤。 ** message ** 測試 HTTP 狀態碼：400 ** ConcurrentModificationException ** 並行修改應用程式的結果拋出例外。例如，有兩個人嘗試同時編輯相同的應用程式。 ** message ** HTTP 狀態碼：400 ** InvalidArgumentException ** 指定的輸入參數值無效。 ** message ** HTTP 狀態碼：400 ** ResourceInUseException ** 應用程式不適用於此作業。 ** message ** HTTP 狀態碼：400 ** ResourceNotFoundException ** 找不到指定的應用程式。 ** message ** HTTP 狀態碼：400 ** UnsupportedOperationException ** 請求被拒絕，因為指定的參數不受支持，或指定的資源對此操作無效。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [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 適用於 C\$1\$1 的 SDK](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 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/AddApplicationInput) + [AWS 適用於 Kotlin 的 SDK](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 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/AddApplicationInput) # AddApplicationInputProcessingConfiguration **注意** 此文件適用於 Amazon Kinesis Data Analytics API 第 1 版，僅支援 SQL 應用程式。第 2 版的 API 則支援 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/)。 ## 請求語法 ``` { "ApplicationName": "string", "CurrentApplicationVersionId": number, "InputId": "string", "InputProcessingConfiguration": { "InputLambdaProcessor": { "ResourceARN": "string", "RoleARN": "string" } } } ``` ## 請求參數 請求接受採用 JSON 格式的下列資料。 ** [ApplicationName](#API_AddApplicationInputProcessingConfiguration_RequestSyntax) ** 您要將輸入處理組態新增到其中的應用程式名稱。 類型：字串 長度限制：長度下限為 1。長度上限為 128。 模式：`[a-zA-Z0-9_.-]+` 必要：是 ** [CurrentApplicationVersionId](#API_AddApplicationInputProcessingConfiguration_RequestSyntax) ** 您要將輸入處理組態新增到其中的應用程式版本。您可以使用 [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 操作來取得目前的應用程式版本。如果指定的版本不是目前版本，則會傳回 `ConcurrentModificationException`。 類型：Long 有效範圍：最小值為 1。最大值為 999999999。 必要：是 ** [InputId](#API_AddApplicationInputProcessingConfiguration_RequestSyntax) ** 要新增輸入處理組態的輸入組態 ID。您可以使用 [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 作業取得應用程式的輸入 ID 清單。 類型：字串 長度限制：長度下限為 1。長度上限為 50。 模式：`[a-zA-Z0-9_.-]+` 必要：是 ** [InputProcessingConfiguration](#API_AddApplicationInputProcessingConfiguration_RequestSyntax) ** 要新增到應用程式的 [InputProcessingConfiguration](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_InputProcessingConfiguration.html)。 類型：[InputProcessingConfiguration](API_InputProcessingConfiguration.md) 物件 必要：是 ## 回應元素 如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** ConcurrentModificationException ** 並行修改應用程式的結果拋出例外。例如，有兩個人嘗試同時編輯相同的應用程式。 ** message ** HTTP 狀態碼：400 ** InvalidArgumentException ** 指定的輸入參數值無效。 ** message ** HTTP 狀態碼：400 ** ResourceInUseException ** 應用程式不適用於此作業。 ** message ** HTTP 狀態碼：400 ** ResourceNotFoundException ** 找不到指定的應用程式。 ** message ** HTTP 狀態碼：400 ** UnsupportedOperationException ** 請求被拒絕，因為指定的參數不受支持，或指定的資源對此操作無效。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [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 適用於 C\$1\$1 的 SDK](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 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/AddApplicationInputProcessingConfiguration) + [AWS 適用於 Kotlin 的 SDK](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 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/AddApplicationInputProcessingConfiguration) # AddApplicationOutput **注意** 此文件適用於 Amazon Kinesis Data Analytics API 第 1 版，僅支援 SQL 應用程式。第 2 版的 API 則支援 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` 動作。 ## 請求語法 ``` { "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" } } ``` ## 請求參數 請求接受採用 JSON 格式的下列資料。 ** [ApplicationName](#API_AddApplicationOutput_RequestSyntax) ** 您要將輸出組態新增到其中的應用程式名稱。 類型：字串 長度限制：長度下限為 1。長度上限為 128。 模式：`[a-zA-Z0-9_.-]+` 必要：是 ** [CurrentApplicationVersionId](#API_AddApplicationOutput_RequestSyntax) ** 您要將輸出組態新增到其中的應用程式版本。您可以使用 [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 操作來取得目前的應用程式版本。如果指定的版本不是目前版本，則會傳回 `ConcurrentModificationException`。 類型：Long 有效範圍：最小值為 1。最大值為 999999999。 必要：是 ** [Output](#API_AddApplicationOutput_RequestSyntax) ** 物件陣列，每個都會描述一個輸出組態。在輸出組態中，您可以指定應用程式內串流、目的地 （即 Amazon Kinesis 串流、Amazon Kinesis Firehose 交付串流或 AWS Lambda 函數） 的名稱，並記錄寫入目的地時要使用的表單。 類型：[Output](API_Output.md) 物件 必要：是 ## 回應元素 如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** ConcurrentModificationException ** 並行修改應用程式的結果拋出例外。例如，有兩個人嘗試同時編輯相同的應用程式。 ** message ** HTTP 狀態碼：400 ** InvalidArgumentException ** 指定的輸入參數值無效。 ** message ** HTTP 狀態碼：400 ** ResourceInUseException ** 應用程式不適用於此作業。 ** message ** HTTP 狀態碼：400 ** ResourceNotFoundException ** 找不到指定的應用程式。 ** message ** HTTP 狀態碼：400 ** UnsupportedOperationException ** 請求被拒絕，因為指定的參數不受支持，或指定的資源對此操作無效。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [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 適用於 C\$1\$1 的 SDK](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 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/AddApplicationOutput) + [AWS 適用於 Kotlin 的 SDK](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 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/AddApplicationOutput) # AddApplicationReferenceDataSource **注意** 此文件適用於 Amazon Kinesis Data Analytics API 第 1 版，僅支援 SQL 應用程式。第 2 版的 API 則支援 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` 動作。 ## 請求語法 ``` { "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" } } ``` ## 請求參數 請求接受採用 JSON 格式的下列資料。 ** [ApplicationName](#API_AddApplicationReferenceDataSource_RequestSyntax) ** 現有應用程式的名稱。 類型：字串 長度限制：長度下限為 1。長度上限為 128。 模式：`[a-zA-Z0-9_.-]+` 必要：是 ** [CurrentApplicationVersionId](#API_AddApplicationReferenceDataSource_RequestSyntax) ** 您要為其新增參考資料來源的應用程式版本。您可以使用 [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 操作來取得目前的應用程式版本。如果指定的版本不是目前版本，則會傳回 `ConcurrentModificationException`。 類型：Long 有效範圍：最小值為 1。最大值為 999999999。 必要：是 ** [ReferenceDataSource](#API_AddApplicationReferenceDataSource_RequestSyntax) ** 參考資料來源可以是您 Amazon S3 儲存貯體中的物件。Amazon Kinesis Analytics 會讀取物件，並將資料複製到所建立的應用程式內資料表。您可以提供 S3 儲存貯體、物件鍵名稱，以及所建立的結果應用程式內資料表。您也必須提供具備必要許可的 IAM 角色，讓 Amazon Kinesis Analytics 能取得該角色來代您從 S3 儲存貯體讀取物件。 類型：[ReferenceDataSource](API_ReferenceDataSource.md) 物件 必要：是 ## 回應元素 如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** ConcurrentModificationException ** 並行修改應用程式的結果拋出例外。例如，有兩個人嘗試同時編輯相同的應用程式。 ** message ** HTTP 狀態碼：400 ** InvalidArgumentException ** 指定的輸入參數值無效。 ** message ** HTTP 狀態碼：400 ** ResourceInUseException ** 應用程式不適用於此作業。 ** message ** HTTP 狀態碼：400 ** ResourceNotFoundException ** 找不到指定的應用程式。 ** message ** HTTP 狀態碼：400 ** UnsupportedOperationException ** 請求被拒絕，因為指定的參數不受支持，或指定的資源對此操作無效。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [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 適用於 C\$1\$1 的 SDK](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 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS 適用於 Kotlin 的 SDK](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 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) # CreateApplication **注意** 此文件適用於 Amazon Kinesis Data Analytics API 第 1 版，僅支援 SQL 應用程式。第 2 版的 API 則支援 SQL 和 Java 應用程式。如需第 2 版的詳細資訊，請參閱 [Amazon Kinesis Data Analytics API V2 文件](/kinesisanalytics/latest/apiv2/Welcome.html)。 建立 Amazon Kinesis Analytics 應用程式。您可以設定每個應用程式將一個串流來源作為輸入、處理輸入的應用程式碼，以及最多三個您希望 Amazon Kinesis Analytics 從應用程式寫入輸出資料的目的地。如需概觀，請參閱[運作方式](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)。 ## 請求語法 ``` { "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" } ] } ``` ## 請求參數 請求接受採用 JSON 格式的下列資料。 ** [ApplicationCode](#API_CreateApplication_RequestSyntax) ** 一個或多個 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) ** 應用程式的摘要描述。 類型：字串 長度限制：長度下限為 0。長度上限為 1024。 必要：否 ** [ApplicationName](#API_CreateApplication_RequestSyntax) ** 您 Amazon Kinesis Analytics 應用程式的名稱 (例如，`sample-app`)。 類型：字串 長度限制：長度下限為 1。長度上限為 128。 模式：`[a-zA-Z0-9_.-]+` 必要：是 ** [CloudWatchLoggingOptions](#API_CreateApplication_RequestSyntax) ** 使用此參數可設定 CloudWatch 日誌串流來監控應用程式組態錯誤。如需詳細資訊，請參閱[使用 Amazon CloudWatch Logs](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/cloudwatch-logs.html)。 類型：[CloudWatchLoggingOption](API_CloudWatchLoggingOption.md) 物件陣列 必要：否 ** [Inputs](#API_CreateApplication_RequestSyntax) ** 可藉由此參數來設定應用程式輸入。 您可以設定應用程式從單一串流來源接收輸入。在此組態中，您會將此串流來源映射到建立的應用程式內串流。您的應用程式程式碼接著會如同資料表般，查詢應用程式內串流 (您可以將它想成是持續更新的資料表)。 針對串流來源，您可以提供其 Amazon Resource Name (ARN) 及串流上的資料格式 (例如，JSON、CSV 等)。您也必須提供 Amazon Kinesis Analytics 可取得的 IAM 角色，代您讀取此串流。 要建立應用程式內部串流，您必須指定一個架構描述，以將您的資料轉換為 SQL 中使用的架構化版本。在結構描述中，您可以提供串流來源中資料元素的必要映射，來記錄應用程式內串流中的資料行。 類型：[Input](API_Input.md) 物件陣列 必要：否 ** [Outputs](#API_CreateApplication_RequestSyntax) ** 您可以設定應用程式輸出，將資料從任何應用程式內串流寫入最多三個目的地。 這些目的地可以是 Amazon Kinesis 串流、Amazon Kinesis Firehose 交付串流、 AWS Lambda 目的地或三者中的任意組合。 在組態中，指定應用程式內串流名稱、目標串流或 Lambda 函數 Amazon Resource Name (ARN)，以及寫入資料時使用的格式。您也必須提供 Amazon Kinesis Analytics 可擔任的 IAM 角色，以代您讀取目的地串流或 Lambda 函數。 在輸出組態中，您還可以提供輸出串流或 Lambda 函數 ARN。針對串流目的地，提供串流中的資料格式 (例如 JSON、CSV)。您也必須提供 Amazon Kinesis Analytics 可擔任的 IAM 角色，以代您讀取串流或 Lambda 函數。 類型：[Output](API_Output.md) 物件陣列 必要：否 ** [Tags](#API_CreateApplication_RequestSyntax) ** 要指派給應用程式的一或多個標籤的清單。標籤是識別應用程式的鍵/值對。請注意，應用程式標籤的數目上限包括系統標籤。使用者定義的應用程式的標籤數目上限為 50。如需詳細資訊，請參閱[使用標記](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-tagging.html)。 類型：[Tag](API_Tag.md) 物件陣列 陣列成員：項目數下限為 1。項目數上限為 200。 必要：否 ## 回應語法 ``` { "ApplicationSummary": { "ApplicationARN": "string", "ApplicationName": "string", "ApplicationStatus": "string" } } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [ApplicationSummary](#API_CreateApplication_ResponseSyntax) ** Amazon Kinesis Analytics 根據您的 `CreateApplication` 要求傳回回應，其中包含建立的應用程式摘要，內含應用程式 Amazon Resource Name (ARN)、名稱和狀態。 類型：[ApplicationSummary](API_ApplicationSummary.md) 物件 ## 錯誤 ** 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 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [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 適用於 C\$1\$1 的 SDK](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 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/CreateApplication) + [AWS 適用於 Kotlin 的 SDK](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 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/CreateApplication) # DeleteApplication **注意** 此文件適用於 Amazon Kinesis Data Analytics API 第 1 版，僅支援 SQL 應用程式。第 2 版的 API 則支援 SQL 和 Java 應用程式。如需第 2 版的詳細資訊，請參閱 [Amazon Kinesis Data Analytics API V2 文件](/kinesisanalytics/latest/apiv2/Welcome.html)。 刪除指定的應用程式。Amazon Kinesis Analytics 會停止執行應用程式並刪除應用程式，包括任何應用程式成品 (例如應用程式內串流、參考資料表和應用程式碼)。 這項操作需要許可來執行 `kinesisanalytics:DeleteApplication` 動作。 ## 請求語法 ``` { "ApplicationName": "string", "CreateTimestamp": number } ``` ## 請求參數 請求接受採用 JSON 格式的下列資料。 ** [ApplicationName](#API_DeleteApplication_RequestSyntax) ** 要刪除之 Amazon Kinesis Analytics 應用程式的名稱。 類型：字串 長度限制：長度下限為 1。長度上限為 128。 模式：`[a-zA-Z0-9_.-]+` 必要：是 ** [CreateTimestamp](#API_DeleteApplication_RequestSyntax) ** 若要取得此值，可以使用 `DescribeApplication` 操作。 類型：Timestamp 必要：是 ## 回應元素 如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** ConcurrentModificationException ** 並行修改應用程式的結果拋出例外。例如，有兩個人嘗試同時編輯相同的應用程式。 ** message ** HTTP 狀態碼：400 ** ResourceInUseException ** 應用程式不適用於此作業。 ** message ** HTTP 狀態碼：400 ** ResourceNotFoundException ** 找不到指定的應用程式。 ** message ** HTTP 狀態碼：400 ** UnsupportedOperationException ** 請求被拒絕，因為指定的參數不受支持，或指定的資源對此操作無效。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [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 適用於 C\$1\$1 的 SDK](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 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/DeleteApplication) + [AWS 適用於 Kotlin 的 SDK](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 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/DeleteApplication) # DeleteApplicationCloudWatchLoggingOption **注意** 此文件適用於 Amazon Kinesis Data Analytics API 第 1 版，僅支援 SQL 應用程式。第 2 版的 API 則支援 SQL 和 Java 應用程式。如需第 2 版的詳細資訊，請參閱 [Amazon Kinesis Data Analytics API V2 文件](/kinesisanalytics/latest/apiv2/Welcome.html)。 從應用程式中刪除 CloudWatch 日誌串流。如需將 CloudWatch 日誌串流與 Amazon Kinesis Analytics 應用程式搭配使用的詳細資訊，請參閱[使用 Amazon CloudWatch Logs](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/cloudwatch-logs.html)。 ## 請求語法 ``` { "ApplicationName": "string", "CloudWatchLoggingOptionId": "string", "CurrentApplicationVersionId": number } ``` ## 請求參數 請求接受採用 JSON 格式的下列資料。 ** [ApplicationName](#API_DeleteApplicationCloudWatchLoggingOption_RequestSyntax) ** Kinesis Analytics 應用程式名稱。 類型：字串 長度限制：長度下限為 1。長度上限為 128。 模式：`[a-zA-Z0-9_.-]+` 必要：是 ** [CloudWatchLoggingOptionId](#API_DeleteApplicationCloudWatchLoggingOption_RequestSyntax) ** 要刪除的 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) ** Kinesis Analytic 應用程式的版本 ID。 類型：Long 有效範圍：最小值為 1。最大值為 999999999。 必要：是 ## 回應元素 如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** ConcurrentModificationException ** 並行修改應用程式的結果拋出例外。例如，有兩個人嘗試同時編輯相同的應用程式。 ** message ** HTTP 狀態碼：400 ** InvalidArgumentException ** 指定的輸入參數值無效。 ** message ** HTTP 狀態碼：400 ** ResourceInUseException ** 應用程式不適用於此作業。 ** message ** HTTP 狀態碼：400 ** ResourceNotFoundException ** 找不到指定的應用程式。 ** message ** HTTP 狀態碼：400 ** UnsupportedOperationException ** 請求被拒絕，因為指定的參數不受支持，或指定的資源對此操作無效。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [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 適用於 C\$1\$1 的 SDK](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 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/DeleteApplicationCloudWatchLoggingOption) + [AWS 適用於 Kotlin 的 SDK](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 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/DeleteApplicationCloudWatchLoggingOption) # DeleteApplicationInputProcessingConfiguration **注意** 此文件適用於 Amazon Kinesis Data Analytics API 第 1 版，僅支援 SQL 應用程式。第 2 版的 API 則支援 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)。 ## 請求語法 ``` { "ApplicationName": "string", "CurrentApplicationVersionId": number, "InputId": "string" } ``` ## 請求參數 請求接受採用 JSON 格式的下列資料。 ** [ApplicationName](#API_DeleteApplicationInputProcessingConfiguration_RequestSyntax) ** Kinesis Analytics 應用程式名稱。 類型：字串 長度限制：長度下限為 1。長度上限為 128。 模式：`[a-zA-Z0-9_.-]+` 必要：是 ** [CurrentApplicationVersionId](#API_DeleteApplicationInputProcessingConfiguration_RequestSyntax) ** Kinesis Analytic 應用程式的版本 ID。 類型：Long 有效範圍：最小值為 1。最大值為 999999999。 必要：是 ** [InputId](#API_DeleteApplicationInputProcessingConfiguration_RequestSyntax) ** 要刪除輸入處理組態的輸入組態 ID。您可以使用 [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 作業取得應用程式的輸入 ID 清單。 類型：字串 長度限制：長度下限為 1。長度上限為 50。 模式：`[a-zA-Z0-9_.-]+` 必要：是 ## 回應元素 如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** ConcurrentModificationException ** 並行修改應用程式的結果拋出例外。例如，有兩個人嘗試同時編輯相同的應用程式。 ** message ** HTTP 狀態碼：400 ** InvalidArgumentException ** 指定的輸入參數值無效。 ** message ** HTTP 狀態碼：400 ** ResourceInUseException ** 應用程式不適用於此作業。 ** message ** HTTP 狀態碼：400 ** ResourceNotFoundException ** 找不到指定的應用程式。 ** message ** HTTP 狀態碼：400 ** UnsupportedOperationException ** 請求被拒絕，因為指定的參數不受支持，或指定的資源對此操作無效。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [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 適用於 C\$1\$1 的 SDK](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 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/DeleteApplicationInputProcessingConfiguration) + [AWS 適用於 Kotlin 的 SDK](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 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/DeleteApplicationInputProcessingConfiguration) # DeleteApplicationOutput **注意** 此文件適用於 Amazon Kinesis Data Analytics API 第 1 版，僅支援 SQL 應用程式。第 2 版的 API 則支援 SQL 和 Java 應用程式。如需第 2 版的詳細資訊，請參閱 [Amazon Kinesis Data Analytics API V2 文件](/kinesisanalytics/latest/apiv2/Welcome.html)。 從應用程式組態中刪除輸出目的地組態。Amazon Kinesis Analytics 不會再將資料從對應的應用程式內串流寫入外部輸出目的地。 這項操作需要許可來執行 `kinesisanalytics:DeleteApplicationOutput` 動作。 ## 請求語法 ``` { "ApplicationName": "string", "CurrentApplicationVersionId": number, "OutputId": "string" } ``` ## 請求參數 請求接受採用 JSON 格式的下列資料。 ** [ApplicationName](#API_DeleteApplicationOutput_RequestSyntax) ** Amazon Kinesis Analytics 應用程式名稱。 類型：字串 長度限制：長度下限為 1。長度上限為 128。 模式：`[a-zA-Z0-9_.-]+` 必要：是 ** [CurrentApplicationVersionId](#API_DeleteApplicationOutput_RequestSyntax) ** Amazon Kinesis Analytics 應用程式版本。您可以使用 [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 操作來取得目前的應用程式版本。如果指定的版本不是目前版本，則會傳回 `ConcurrentModificationException`。 類型：Long 有效範圍：最小值為 1。最大值為 999999999。 必要：是 ** [OutputId](#API_DeleteApplicationOutput_RequestSyntax) ** 要刪除組態的 ID。每個新增至應用程式的輸出組態都有唯一的 ID，無論是在建立應用程式時新增，或稍後使用 [AddApplicationOutput](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_AddApplicationOutput.html) 作業加入。您需要提供 ID，以唯一識別要從應用程式組態中刪除的輸出組態。您可以使用 [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 作業取得特定的 `OutputId`。 類型：字串 長度限制：長度下限為 1。長度上限為 50。 模式：`[a-zA-Z0-9_.-]+` 必要：是 ## 回應元素 如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** ConcurrentModificationException ** 並行修改應用程式的結果拋出例外。例如，有兩個人嘗試同時編輯相同的應用程式。 ** message ** HTTP 狀態碼：400 ** InvalidArgumentException ** 指定的輸入參數值無效。 ** message ** HTTP 狀態碼：400 ** ResourceInUseException ** 應用程式不適用於此作業。 ** message ** HTTP 狀態碼：400 ** ResourceNotFoundException ** 找不到指定的應用程式。 ** message ** HTTP 狀態碼：400 ** UnsupportedOperationException ** 請求被拒絕，因為指定的參數不受支持，或指定的資源對此操作無效。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [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 適用於 C\$1\$1 的 SDK](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 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/DeleteApplicationOutput) + [AWS 適用於 Kotlin 的 SDK](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 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/DeleteApplicationOutput) # DeleteApplicationReferenceDataSource **注意** 此文件適用於 Amazon Kinesis Data Analytics API 第 1 版，僅支援 SQL 應用程式。第 2 版的 API 則支援 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` 動作。 ## 請求語法 ``` { "ApplicationName": "string", "CurrentApplicationVersionId": number, "ReferenceId": "string" } ``` ## 請求參數 請求接受採用 JSON 格式的下列資料。 ** [ApplicationName](#API_DeleteApplicationReferenceDataSource_RequestSyntax) ** 現有應用程式的名稱。 類型：字串 長度限制：長度下限為 1。長度上限為 128。 模式：`[a-zA-Z0-9_.-]+` 必要：是 ** [CurrentApplicationVersionId](#API_DeleteApplicationReferenceDataSource_RequestSyntax) ** 應用程式的版本。您可以使用 [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 操作來取得目前的應用程式版本。如果指定的版本不是目前版本，則會傳回 `ConcurrentModificationException`。 類型：Long 有效範圍：最小值為 1。最大值為 999999999。 必要：是 ** [ReferenceId](#API_DeleteApplicationReferenceDataSource_RequestSyntax) ** 參考資料來源的 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_.-]+` 必要：是 ## 回應元素 如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** ConcurrentModificationException ** 並行修改應用程式的結果拋出例外。例如，有兩個人嘗試同時編輯相同的應用程式。 ** message ** HTTP 狀態碼：400 ** InvalidArgumentException ** 指定的輸入參數值無效。 ** message ** HTTP 狀態碼：400 ** ResourceInUseException ** 應用程式不適用於此作業。 ** message ** HTTP 狀態碼：400 ** ResourceNotFoundException ** 找不到指定的應用程式。 ** message ** HTTP 狀態碼：400 ** UnsupportedOperationException ** 請求被拒絕，因為指定的參數不受支持，或指定的資源對此操作無效。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [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 適用於 C\$1\$1 的 SDK](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 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/DeleteApplicationReferenceDataSource) + [AWS 適用於 Kotlin 的 SDK](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 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/DeleteApplicationReferenceDataSource) # DescribeApplication **注意** 此文件適用於 Amazon Kinesis Data Analytics API 第 1 版，僅支援 SQL 應用程式。第 2 版的 API 則支援 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` 動作。您可以使用 `DescribeApplication` 來獲取當前應用程式 versionId，此舉需要呼叫其他操作，例如 `Update`。 ## 請求語法 ``` { "ApplicationName": "string" } ``` ## 請求參數 請求接受採用 JSON 格式的下列資料。 ** [ApplicationName](#API_DescribeApplication_RequestSyntax) ** 應用程式名稱。 類型：字串 長度限制：長度下限為 1。長度上限為 128。 模式：`[a-zA-Z0-9_.-]+` 必要：是 ## 回應語法 ``` { "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" } ] } } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [ApplicationDetail](#API_DescribeApplication_ResponseSyntax) ** 提供應用程式的說明，例如應用程式 Amazon Resource Name (ARN)、狀態、最新版本，以及輸入和輸出組態詳細資訊。 類型：[ApplicationDetail](API_ApplicationDetail.md) 物件 ## 錯誤 ** ResourceNotFoundException ** 找不到指定的應用程式。 ** message ** HTTP 狀態碼：400 ** UnsupportedOperationException ** 請求被拒絕，因為指定的參數不受支持，或指定的資源對此操作無效。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [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 適用於 C\$1\$1 的 SDK](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 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/DescribeApplication) + [AWS 適用於 Kotlin 的 SDK](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 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/DescribeApplication) # DiscoverInputSchema **注意** 此文件適用於 Amazon Kinesis Data Analytics API 第 1 版，僅支援 SQL 應用程式。第 2 版的 API 則支援 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` 動作。 ## 請求語法 ``` { "InputProcessingConfiguration": { "InputLambdaProcessor": { "ResourceARN": "string", "RoleARN": "string" } }, "InputStartingPositionConfiguration": { "InputStartingPosition": "string" }, "ResourceARN": "string", "RoleARN": "string", "S3Configuration": { "BucketARN": "string", "FileKey": "string", "RoleARN": "string" } } ``` ## 請求參數 請求接受採用 JSON 格式的下列資料。 ** [InputProcessingConfiguration](#API_DiscoverInputSchema_RequestSyntax) ** [InputProcessingConfiguration](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_InputProcessingConfiguration.html) 用於在探索記錄結構描述前預處理記錄。 類型：[InputProcessingConfiguration](API_InputProcessingConfiguration.md) 物件 必要：否 ** [InputStartingPositionConfiguration](#API_DiscoverInputSchema_RequestSyntax) ** 您希望 Amazon Kinesis Analytics 從特定串流來源探索目的開始讀取記錄的點。 類型：[InputStartingPositionConfiguration](API_InputStartingPositionConfiguration.md) 物件 必要：否 ** [ResourceARN](#API_DiscoverInputSchema_RequestSyntax) ** 串流來源的 Amazon Resource Name (ARN)。 類型：字串 長度限制：長度下限為 1。長度上限為 2048。 模式：`arn:.*` 必要：否 ** [RoleARN](#API_DiscoverInputSchema_RequestSyntax) ** Amazon Kinesis Analytics 可擔任的 IAM 角色 ARN，此角色可代您存取串流。 類型：字串 長度限制：長度下限為 1。長度上限為 2048。 模式：`arn:.*` 必要：否 ** [S3Configuration](#API_DiscoverInputSchema_RequestSyntax) ** 指定此參數來探索 Amazon S3 物件中的資料結構描述。 類型：[S3Configuration](API_S3Configuration.md) 物件 必要：否 ## 回應語法 ``` { "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" ] } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [InputSchema](#API_DiscoverInputSchema_ResponseSyntax) ** 從串流來源推斷出來的結構描述。辨別串流來源中的資料格式，以及每個資料元素如何映射至相應欄位，這些欄位位於建立的應用程式內串流。 類型：[SourceSchema](API_SourceSchema.md) 物件 ** [ParsedInputRecords](#API_DiscoverInputSchema_ResponseSyntax) ** 元素陣列，其中每個元素對應到串流記錄中的一列 (串流記錄可以有多個資料列)。 類型：字串陣列的陣列。 ** [ProcessedInputRecords](#API_DiscoverInputSchema_ResponseSyntax) ** 在 `InputProcessingConfiguration` 參數中指定的處理器修改之串流資料。 類型：字串陣列 ** [RawInputRecords](#API_DiscoverInputSchema_ResponseSyntax) ** 已取樣來推斷結構描述的原始串流資料。 類型：字串陣列 ## 錯誤 ** InvalidArgumentException ** 指定的輸入參數值無效。 ** message ** HTTP 狀態碼：400 ** ResourceProvisionedThroughputExceededException ** 探索無法從串流來源取得記錄，因為 Amazon Kinesis Streams ProvisionedThroughputExceededException。如需詳細資訊，請參閱 [Amazon Kinesis Video 串流 API 參考資料](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_GetRecords.html)中的 GetRecords。 HTTP 狀態碼：400 ** ServiceUnavailableException ** 服務無法使用。退回並重試操作。 HTTP 狀態碼：500 ** UnableToDetectSchemaException ** 資料格式無效。Amazon Kinesis Analytics 無法偵測指定串流來源的結構描述。 HTTP 狀態碼：400 ** UnsupportedOperationException ** 請求被拒絕，因為指定的參數不受支持，或指定的資源對此操作無效。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [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 適用於 C\$1\$1 的 SDK](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 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/DiscoverInputSchema) + [AWS 適用於 Kotlin 的 SDK](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 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/DiscoverInputSchema) # ListApplications **注意** 此文件適用於 Amazon Kinesis Data Analytics API 第 1 版，僅支援 SQL 應用程式。第 2 版的 API 則支援 SQL 和 Java 應用程式。如需第 2 版的詳細資訊，請參閱 [Amazon Kinesis Data Analytics API V2 文件](/kinesisanalytics/latest/apiv2/Welcome.html)。 傳回您帳戶中的 Amazon Kinesis Analytics 應用程式清單。在每個應用程式，回應包括應用程式名稱、Amazon Resource Name (ARN)，以及狀態。如果回應傳回 `HasMoreApplications` 值為 true，您可以傳送另一個要求，方法為在請求主體中加入 `ExclusiveStartApplicationName`，並將此值設定為先前回應的最後一個應用程式名稱。 如果您想要特定應用程式的詳細資訊，請使用 [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html)。 這項操作需要許可來執行 `kinesisanalytics:ListApplications` 動作。 ## 請求語法 ``` { "ExclusiveStartApplicationName": "string", "Limit": number } ``` ## 請求參數 請求接受採用 JSON 格式的下列資料。 ** [ExclusiveStartApplicationName](#API_ListApplications_RequestSyntax) ** 清單開頭的應用程式名稱。使用分頁來擷取列表時，您不必在第一個請求中指定此參數。不過，在後續請求中，您可以新增先前回應中的最後一個應用程式名稱，以取得應用程式的下一頁。 類型：字串 長度限制：長度下限為 1。長度上限為 128。 模式：`[a-zA-Z0-9_.-]+` 必要：否 ** [Limit](#API_ListApplications_RequestSyntax) ** 要列出的應用程式數目上限。 類型：整數 有效範圍：最小值為 1。最大值為 50。 必要：否 ## 回應語法 ``` { "ApplicationSummaries": [ { "ApplicationARN": "string", "ApplicationName": "string", "ApplicationStatus": "string" } ], "HasMoreApplications": boolean } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [ApplicationSummaries](#API_ListApplications_ResponseSyntax) ** `ApplicationSummary` 物件的清單。 類型：[ApplicationSummary](API_ApplicationSummary.md) 物件陣列 ** [HasMoreApplications](#API_ListApplications_ResponseSyntax) ** 如有更多應用程式可擷取，則傳回 true。 類型：布林值 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [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 適用於 C\$1\$1 的 SDK](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 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/ListApplications) + [AWS 適用於 Kotlin 的 SDK](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 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/ListApplications) # ListTagsForResource 擷取指派給應用程式的索引鍵值標籤清單。如需詳細資訊，請參閱[使用標籤](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-tagging.html)。 ## 請求語法 ``` { "ResourceARN": "string" } ``` ## 請求參數 請求接受採用 JSON 格式的下列資料。 ** [ResourceARN](#API_ListTagsForResource_RequestSyntax) ** 要從中擷取標籤的應用程式 ARN。 類型：字串 長度限制：長度下限為 1。長度上限為 2048。 模式：`arn:.*` 必要：是 ## 回應語法 ``` { "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [Tags](#API_ListTagsForResource_ResponseSyntax) ** 指派給應用程式的索引鍵值標籤。 類型：[Tag](API_Tag.md) 物件陣列 陣列成員：項目數下限為 1。項目數上限為 200。 ## 錯誤 ** ConcurrentModificationException ** 並行修改應用程式的結果拋出例外。例如，有兩個人嘗試同時編輯相同的應用程式。 ** message ** HTTP 狀態碼：400 ** InvalidArgumentException ** 指定的輸入參數值無效。 ** message ** HTTP 狀態碼：400 ** ResourceNotFoundException ** 找不到指定的應用程式。 ** message ** HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [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 適用於 C\$1\$1 的 SDK](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 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/ListTagsForResource) + [AWS 適用於 Kotlin 的 SDK](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 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/ListTagsForResource) # StartApplication **注意** 此文件適用於 Amazon Kinesis Data Analytics API 第 1 版，僅支援 SQL 應用程式。第 2 版的 API 則支援 SQL 和 Java 應用程式。如需第 2 版的詳細資訊，請參閱 [Amazon Kinesis Data Analytics API V2 文件](/kinesisanalytics/latest/apiv2/Welcome.html)。 啟動指定的 Amazon Kinesis Analytics 應用程式。建立應用程式後，您必須專門呼叫此操作來啟動應用程序。 應用程式啟動後，即會開始使用輸入資料、處理輸入資料，然後將輸出寫入設定的目的地。 應用程式狀態必須是 `READY` 才能啟動應用程序。您可以使用 [DescribeApplication](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` 動作。 ## 請求語法 ``` { "ApplicationName": "string", "InputConfigurations": [ { "Id": "string", "InputStartingPositionConfiguration": { "InputStartingPosition": "string" } } ] } ``` ## 請求參數 請求接受採用 JSON 格式的下列資料。 ** [ApplicationName](#API_StartApplication_RequestSyntax) ** 應用程式名稱。 類型：字串 長度限制：長度下限為 1。長度上限為 128。 模式：`[a-zA-Z0-9_.-]+` 必要：是 ** [InputConfigurations](#API_StartApplication_RequestSyntax) ** 依 ID 識別應用程式開始使用的特定輸入。Amazon Kinesis Analytics 會開始讀取與輸入相關聯的串流來源。您也可以指定 Amazon Kinesis Analytics 要在串流來源中的哪個位置開始讀取。 類型：[InputConfiguration](API_InputConfiguration.md) 物件陣列 必要：是 ## 回應元素 如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** InvalidApplicationConfigurationException ** 使用者提供的應用組態無效。 ** message ** test HTTP 狀態碼：400 ** InvalidArgumentException ** 指定的輸入參數值無效。 ** message ** HTTP 狀態碼：400 ** ResourceInUseException ** 應用程式不適用於此作業。 ** message ** HTTP 狀態碼：400 ** ResourceNotFoundException ** 找不到指定的應用程式。 ** message ** HTTP 狀態碼：400 ** UnsupportedOperationException ** 請求被拒絕，因為指定的參數不受支持，或指定的資源對此操作無效。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [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 適用於 C\$1\$1 的 SDK](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 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/StartApplication) + [AWS 適用於 Kotlin 的 SDK](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 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/StartApplication) # StopApplication **注意** 此文件適用於 Amazon Kinesis Data Analytics API 第 1 版，僅支援 SQL 應用程式。第 2 版的 API 則支援 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` 動作。 ## 請求語法 ``` { "ApplicationName": "string" } ``` ## 請求參數 請求接受採用 JSON 格式的下列資料。 ** [ApplicationName](#API_StopApplication_RequestSyntax) ** 要停止的執行中應用程式名稱。 類型：字串 長度限制：長度下限為 1。長度上限為 128。 模式：`[a-zA-Z0-9_.-]+` 必要：是 ## 回應元素 如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** ResourceInUseException ** 應用程式不適用於此作業。 ** message ** HTTP 狀態碼：400 ** ResourceNotFoundException ** 找不到指定的應用程式。 ** message ** HTTP 狀態碼：400 ** UnsupportedOperationException ** 請求被拒絕，因為指定的參數不受支持，或指定的資源對此操作無效。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [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 適用於 C\$1\$1 的 SDK](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 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/StopApplication) + [AWS 適用於 Kotlin 的 SDK](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 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/StopApplication) # TagResource 將一或多個索引鍵值標籤新增至 Kinesis Analytics 應用程式。請注意，應用程式標籤的數目上限包括系統標籤。使用者定義的應用程式的標籤數目上限為 50。如需詳細資訊，請參閱[使用標籤](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-tagging.html)。 ## 請求語法 ``` { "ResourceARN": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 請求參數 請求接受採用 JSON 格式的下列資料。 ** [ResourceARN](#API_TagResource_RequestSyntax) ** 要指派標籤的應用程式 ARN。 類型：字串 長度限制：長度下限為 1。長度上限為 2048。 模式：`arn:.*` 必要：是 ** [Tags](#API_TagResource_RequestSyntax) ** 指派給應用程式的索引鍵值標籤。 類型：[Tag](API_Tag.md) 物件陣列 陣列成員：項目數下限為 1。項目數上限為 200。 必要：是 ## 回應元素 如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** ConcurrentModificationException ** 並行修改應用程式的結果拋出例外。例如，有兩個人嘗試同時編輯相同的應用程式。 ** message ** HTTP 狀態碼：400 ** InvalidArgumentException ** 指定的輸入參數值無效。 ** message ** HTTP 狀態碼：400 ** ResourceInUseException ** 應用程式不適用於此作業。 ** message ** HTTP 狀態碼：400 ** ResourceNotFoundException ** 找不到指定的應用程式。 ** message ** HTTP 狀態碼：400 ** TooManyTagsException ** 使用太多標籤建立的應用程式，或在應用程式中加入太多標籤。請注意，應用程式標籤的數目上限包括系統標籤。使用者定義的應用程式的標籤數目上限為 50。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [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 適用於 C\$1\$1 的 SDK](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 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/TagResource) + [AWS 適用於 Kotlin 的 SDK](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 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/TagResource) # UntagResource 從 Kinesis Analytics 應用程式移除一或多個標籤。如需詳細資訊，請參閱[使用標籤](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-tagging.html)。 ## 請求語法 ``` { "ResourceARN": "string", "TagKeys": [ "string" ] } ``` ## 請求參數 請求接受採用 JSON 格式的下列資料。 ** [ResourceARN](#API_UntagResource_RequestSyntax) ** 要從中移除標籤之 Kinesis Analytics 應用程式的 ARN。 類型：字串 長度限制：長度下限為 1。長度上限為 2048。 模式：`arn:.*` 必要：是 ** [TagKeys](#API_UntagResource_RequestSyntax) ** 要從指定應用程式移除的標籤金鑰清單。 類型：字串陣列 陣列成員：項目數下限為 1。項目數上限為 200。 長度限制：長度下限為 1。長度上限為 128。 必要：是 ## 回應元素 如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** ConcurrentModificationException ** 並行修改應用程式的結果拋出例外。例如，有兩個人嘗試同時編輯相同的應用程式。 ** message ** HTTP 狀態碼：400 ** InvalidArgumentException ** 指定的輸入參數值無效。 ** message ** HTTP 狀態碼：400 ** ResourceInUseException ** 應用程式不適用於此作業。 ** message ** HTTP 狀態碼：400 ** ResourceNotFoundException ** 找不到指定的應用程式。 ** message ** HTTP 狀態碼：400 ** TooManyTagsException ** 使用太多標籤建立的應用程式，或在應用程式中加入太多標籤。請注意，應用程式標籤的數目上限包括系統標籤。使用者定義的應用程式的標籤數目上限為 50。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [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 適用於 C\$1\$1 的 SDK](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 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/UntagResource) + [AWS 適用於 Kotlin 的 SDK](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 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/UntagResource) # UpdateApplication **注意** 此文件適用於 Amazon Kinesis Data Analytics API 第 1 版，僅支援 SQL 應用程式。第 2 版的 API 則支援 SQL 和 Java 應用程式。如需第 2 版的詳細資訊，請參閱 [Amazon Kinesis Data Analytics API V2 文件](/kinesisanalytics/latest/apiv2/Welcome.html)。 更新現有的 Amazon Kinesis Analytics 應用程式。使用此 API，您可以更新應用程式碼、輸入組態和輸出設定。 請注意，Amazon Kinesis Analytics 會在您每次更新應用程式時更新 `CurrentApplicationVersionId`。 這項操作需要 `kinesisanalytics:UpdateApplication` 動作的許可。 ## 請求語法 ``` { "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 } ``` ## 請求參數 請求接受採用 JSON 格式的下列資料。 ** [ApplicationName](#API_UpdateApplication_RequestSyntax) ** 要更新之 Amazon Kinesis Analytics 應用程式的名稱。 類型：字串 長度限制：長度下限為 1。長度上限為 128。 模式：`[a-zA-Z0-9_.-]+` 必要：是 ** [ApplicationUpdate](#API_UpdateApplication_RequestSyntax) ** 說明應用程式更新。 類型：[ApplicationUpdate](API_ApplicationUpdate.md) 物件 必要：是 ** [CurrentApplicationVersionId](#API_UpdateApplication_RequestSyntax) ** 目前的應用程式版本 ID。您可以使用 [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 作業取得此值 。 類型：Long 有效範圍：最小值為 1。最大值為 999999999。 必要：是 ## 回應元素 如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** CodeValidationException ** 使用者提供的應用程式碼 (查詢) 無效。這可能是一個簡單的語法錯誤。 ** message ** 測試 HTTP 狀態碼：400 ** ConcurrentModificationException ** 並行修改應用程式的結果拋出例外。例如，有兩個人嘗試同時編輯相同的應用程式。 ** message ** HTTP 狀態碼：400 ** InvalidArgumentException ** 指定的輸入參數值無效。 ** message ** HTTP 狀態碼：400 ** ResourceInUseException ** 應用程式不適用於此作業。 ** message ** HTTP 狀態碼：400 ** ResourceNotFoundException ** 找不到指定的應用程式。 ** message ** HTTP 狀態碼：400 ** UnsupportedOperationException ** 請求被拒絕，因為指定的參數不受支持，或指定的資源對此操作無效。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [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 適用於 C\$1\$1 的 SDK](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 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/UpdateApplication) + [AWS 適用於 Kotlin 的 SDK](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 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/UpdateApplication)