在仔細考慮之後，我們決定停止 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)。本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # API 參考 **注意** 此文件適用於 Amazon Kinesis Data Analytics API 第 1 版，僅支援 SQL 應用程式。第 2 版的 API 則支援 SQL 和 Java 應用程式。如需有關第 2 版的詳細資訊，請參閱 [Amazon Managed Service for Apache Flink API V2 文件](https://docs.aws.amazon.com//managed-flink/latest/apiv2/Welcome.html)。您可以使用 AWS CLI 探索 Amazon Kinesis Data Analytics API。本指南提供使用 AWS CLI的 [Amazon Kinesis Data Analytics for SQL 應用程式入門](getting-started.md) 練習。 **主題** + [動作](API_Operations.md) + [資料類型](API_Types.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) # 資料類型目前支援下列資料類型： + [ApplicationDetail](API_ApplicationDetail.md) + [ApplicationSummary](API_ApplicationSummary.md) + [ApplicationUpdate](API_ApplicationUpdate.md) + [CloudWatchLoggingOption](API_CloudWatchLoggingOption.md) + [CloudWatchLoggingOptionDescription](API_CloudWatchLoggingOptionDescription.md) + [CloudWatchLoggingOptionUpdate](API_CloudWatchLoggingOptionUpdate.md) + [CSVMappingParameters](API_CSVMappingParameters.md) + [DestinationSchema](API_DestinationSchema.md) + [Input](API_Input.md) + [InputConfiguration](API_InputConfiguration.md) + [InputDescription](API_InputDescription.md) + [InputLambdaProcessor](API_InputLambdaProcessor.md) + [InputLambdaProcessorDescription](API_InputLambdaProcessorDescription.md) + [InputLambdaProcessorUpdate](API_InputLambdaProcessorUpdate.md) + [InputParallelism](API_InputParallelism.md) + [InputParallelismUpdate](API_InputParallelismUpdate.md) + [InputProcessingConfiguration](API_InputProcessingConfiguration.md) + [InputProcessingConfigurationDescription](API_InputProcessingConfigurationDescription.md) + [InputProcessingConfigurationUpdate](API_InputProcessingConfigurationUpdate.md) + [InputSchemaUpdate](API_InputSchemaUpdate.md) + [InputStartingPositionConfiguration](API_InputStartingPositionConfiguration.md) + [InputUpdate](API_InputUpdate.md) + [JSONMappingParameters](API_JSONMappingParameters.md) + [KinesisFirehoseInput](API_KinesisFirehoseInput.md) + [KinesisFirehoseInputDescription](API_KinesisFirehoseInputDescription.md) + [KinesisFirehoseInputUpdate](API_KinesisFirehoseInputUpdate.md) + [KinesisFirehoseOutput](API_KinesisFirehoseOutput.md) + [KinesisFirehoseOutputDescription](API_KinesisFirehoseOutputDescription.md) + [KinesisFirehoseOutputUpdate](API_KinesisFirehoseOutputUpdate.md) + [KinesisStreamsInput](API_KinesisStreamsInput.md) + [KinesisStreamsInputDescription](API_KinesisStreamsInputDescription.md) + [KinesisStreamsInputUpdate](API_KinesisStreamsInputUpdate.md) + [KinesisStreamsOutput](API_KinesisStreamsOutput.md) + [KinesisStreamsOutputDescription](API_KinesisStreamsOutputDescription.md) + [KinesisStreamsOutputUpdate](API_KinesisStreamsOutputUpdate.md) + [LambdaOutput](API_LambdaOutput.md) + [LambdaOutputDescription](API_LambdaOutputDescription.md) + [LambdaOutputUpdate](API_LambdaOutputUpdate.md) + [MappingParameters](API_MappingParameters.md) + [Output](API_Output.md) + [OutputDescription](API_OutputDescription.md) + [OutputUpdate](API_OutputUpdate.md) + [RecordColumn](API_RecordColumn.md) + [RecordFormat](API_RecordFormat.md) + [ReferenceDataSource](API_ReferenceDataSource.md) + [ReferenceDataSourceDescription](API_ReferenceDataSourceDescription.md) + [ReferenceDataSourceUpdate](API_ReferenceDataSourceUpdate.md) + [S3Configuration](API_S3Configuration.md) + [S3ReferenceDataSource](API_S3ReferenceDataSource.md) + [S3ReferenceDataSourceDescription](API_S3ReferenceDataSourceDescription.md) + [S3ReferenceDataSourceUpdate](API_S3ReferenceDataSourceUpdate.md) + [SourceSchema](API_SourceSchema.md) + [Tag](API_Tag.md) # ApplicationDetail **注意** 此文件適用於 Amazon Kinesis Data Analytics API 第 1 版，僅支援 SQL 應用程式。第 2 版的 API 則支援 SQL 和 Java 應用程式。如需第 2 版的詳細資訊，請參閱 [Amazon Kinesis Data Analytics API V2 文件](/kinesisanalytics/latest/apiv2/Welcome.html)。提供應用程式的說明，包含應用程式 Amazon Resource Name (ARN)、狀態、最新版本，以及輸入和輸出組態。 ## 目錄 ** ApplicationARN ** 應用程式的 ARN。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：是 ** ApplicationName ** 應用程式名稱。類型：字串長度限制：長度下限為 1。長度上限為 128。模式：`[a-zA-Z0-9_.-]+` 必要：是 ** ApplicationStatus ** 應用程式的狀態。類型：字串有效值:`DELETING | STARTING | STOPPING | READY | RUNNING | UPDATING | AUTOSCALING` 必要：是 ** ApplicationVersionId ** 提供目前的應用程式版本。類型：Long 有效範圍：最小值為 1。最大值為 999999999。必要：是 ** ApplicationCode ** 傳回您提供的應用程式碼，以便對應用程式中的任何應用程式內串流執行資料分析。類型：字串長度限制：長度下限為 0。長度上限為 102400。必要：否 ** ApplicationDescription ** 應用程式的描述。類型：字串長度限制：長度下限為 0。長度上限為 1024。必要：否 ** CloudWatchLoggingOptionDescriptions ** 描述設定為接收應用程式訊息的 CloudWatch 日誌串流。如需將 CloudWatch 日誌串流與 Amazon Kinesis Analytics 應用程式搭配使用的詳細資訊，請參閱[使用 Amazon CloudWatch Logs](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/cloudwatch-logs.html)。類型：[CloudWatchLoggingOptionDescription](API_CloudWatchLoggingOptionDescription.md) 物件陣列必要：否 ** CreateTimestamp ** 建立應用程式的時間戳記。類型：Timestamp 必要：否 ** InputDescriptions ** 描述應用程式輸入組態。如需詳細資訊，請參閱[設定應用程式輸入](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-input.html)。類型：[InputDescription](API_InputDescription.md) 物件陣列必要：否 ** LastUpdateTimestamp ** 上次更新應用程式時的時間戳記。類型：Timestamp 必要：否 ** OutputDescriptions ** 描述應用程式輸出組態。如需詳細資訊，請參閱[設定應用程式輸出](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-output.html)。類型：[OutputDescription](API_OutputDescription.md) 物件陣列必要：否 ** ReferenceDataSourceDescriptions ** 描述為應用程式設定的參考資料來源。如需詳細資訊，請參閱[設定應用程式輸入](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-input.html)。類型：[ReferenceDataSourceDescription](API_ReferenceDataSourceDescription.md) 物件陣列必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/ApplicationDetail) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/ApplicationDetail) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/ApplicationDetail) # ApplicationSummary **注意** 此文件適用於 Amazon Kinesis Data Analytics API 第 1 版，僅支援 SQL 應用程式。第 2 版的 API 則支援 SQL 和 Java 應用程式。如需第 2 版的詳細資訊，請參閱 [Amazon Kinesis Data Analytics API V2 文件](/kinesisanalytics/latest/apiv2/Welcome.html)。提供應用程式摘要資訊，包括應用程式 Amazon Resource Name (ARN)、名稱和狀態。 ## 目錄 ** ApplicationARN ** 應用程式的 ARN。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：是 ** ApplicationName ** 應用程式名稱。類型：字串長度限制：長度下限為 1。長度上限為 128。模式：`[a-zA-Z0-9_.-]+` 必要：是 ** ApplicationStatus ** 應用程式的狀態。類型：字串有效值:`DELETING | STARTING | STOPPING | READY | RUNNING | UPDATING | AUTOSCALING` 必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/ApplicationSummary) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/ApplicationSummary) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/ApplicationSummary) # ApplicationUpdate 說明現有的 Amazon Kinesis Analytics 應用程式要套用之更新。 ## 目錄 ** ApplicationCodeUpdate ** 說明應用程式碼更新。類型：字串長度限制：長度下限為 0。長度上限為 102400。必要：否 ** CloudWatchLoggingOptionUpdates ** 說明應用程式 CloudWatch 記錄選項更新。類型：[CloudWatchLoggingOptionUpdate](API_CloudWatchLoggingOptionUpdate.md) 物件陣列必要：否 ** InputUpdates ** 描述應用程式輸入組態更新。類型：[InputUpdate](API_InputUpdate.md) 物件陣列必要：否 ** OutputUpdates ** 描述應用程式輸出組態更新。類型：[OutputUpdate](API_OutputUpdate.md) 物件陣列必要：否 ** ReferenceDataSourceUpdates ** 描述應用程式參考資料來源更新。類型：[ReferenceDataSourceUpdate](API_ReferenceDataSourceUpdate.md) 物件陣列必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/ApplicationUpdate) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/ApplicationUpdate) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/ApplicationUpdate) # CloudWatchLoggingOption 提供 CloudWatch 記錄選項的描述，包括日誌串流 Amazon Resource Name (ARN) 與角色 ARN。 ## 目錄 ** LogStreamARN ** 接收應用程式訊息的 CloudWatch 日誌 ARN。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：是 ** RoleARN ** 用來傳送應用程式訊息之角色的 IAM ARN。備註：若要將應用程式訊息寫入 CloudWatch，所使用的 IAM 角色必須啟用 `PutLogEvents` 政策動作。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/CloudWatchLoggingOption) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/CloudWatchLoggingOption) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/CloudWatchLoggingOption) # CloudWatchLoggingOptionDescription CloudWatch 記錄選項的說明。 ## 目錄 ** LogStreamARN ** 接收應用程式訊息的 CloudWatch 日誌 ARN。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：是 ** RoleARN ** 用來傳送應用程式訊息之角色的 IAM ARN。備註：若要將應用程式訊息寫入 CloudWatch，所使用的 IAM 角色必須啟用 `PutLogEvents` 政策動作。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：是 ** CloudWatchLoggingOptionId ** CloudWatch 記錄選項說明的 ID。類型：字串長度限制：長度下限為 1。長度上限為 50。模式：`[a-zA-Z0-9_.-]+` 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/CloudWatchLoggingOptionDescription) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/CloudWatchLoggingOptionDescription) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/CloudWatchLoggingOptionDescription) # CloudWatchLoggingOptionUpdate 說明 CloudWatch 記錄選項更新。 ## 目錄 ** CloudWatchLoggingOptionId ** 要更新的 CloudWatch 記錄選項的 ID 類型：字串長度限制：長度下限為 1。長度上限為 50。模式：`[a-zA-Z0-9_.-]+` 必要：是 ** LogStreamARNUpdate ** 接收應用程式訊息的 CloudWatch 日誌 ARN。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：否 ** RoleARNUpdate ** 用來傳送應用程式訊息之角色的 IAM ARN。備註：若要將應用程式訊息寫入 CloudWatch，所使用的 IAM 角色必須啟用 `PutLogEvents` 政策動作。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/CloudWatchLoggingOptionUpdate) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/CloudWatchLoggingOptionUpdate) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/CloudWatchLoggingOptionUpdate) # CSVMappingParameters 當紀錄格式使用 CSV 等分隔符號時，提供其他的映射資訊。例如，以下的範例紀錄使用 CSV 格式，其紀錄使用 *'\$1n'* 做為資料列分隔符號，使用逗號 (",") 做為資料行分隔符號： `"name1", "address1"` `"name2", "address2"` ## 目錄 ** RecordColumnDelimiter ** 資料行分隔符號。例如，在 CSV 格式中，逗號 (",") 是典型的欄位分隔符號。類型：字串長度限制：長度下限為 1。必要：是 ** RecordRowDelimiter ** 資料列分隔符號。例如，在 CSV 格式中，*'\$1n'* 是典型的資料列分隔符號。類型：字串長度限制：長度下限為 1。必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/CSVMappingParameters) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/CSVMappingParameters) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/CSVMappingParameters) # DestinationSchema 描述紀錄寫入目標時所採用的資料格式。如需詳細資訊，請參閱[設定應用程式輸出](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-output.html)。 ## 目錄 ** RecordFormatType ** 指定輸出串流中的記錄格式。類型：字串有效值:`JSON | CSV` 必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/DestinationSchema) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/DestinationSchema) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/DestinationSchema) # Input 當您設定應用程式輸入時，您指定串流來源、建立的應用程式內串流名稱，以及兩者之間的映射。如需詳細資訊，請參閱[設定應用程式輸入](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-input.html)。 ## 目錄 ** InputSchema ** 描述串流來源中的資料格式，以及每個資料元素如何映射至所建立應用程式內串流的對應欄位。也用於描述參考資料來源的格式。類型：[SourceSchema](API_SourceSchema.md) 物件必要：是 ** NamePrefix ** 建立應用程式內串流時要使用的名稱前綴。假設您指定前綴 "MyInApplicationStream"。則 Amazon Kinesis Analytics 會 (根據您指定的 `InputParallelism` 計數) 建立一或多個應用程式內串流，名為 "MyInApplicationStream\$1001"、"MyInApplicationStream\$1002" 等等。類型：字串長度限制：長度下限為 1。長度上限為 32。必要：是 ** InputParallelism ** 描述要建立的應用程式內串流數量。您來源的資料會路由到這些應用程式內輸入串流。 (請參閱[設定應用程式輸入](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-input.html)。類型：[InputParallelism](API_InputParallelism.md) 物件必要：否 ** InputProcessingConfiguration ** 輸入的 [InputProcessingConfiguration](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_InputProcessingConfiguration.html)。輸入處理器在收到記錄時會轉換記錄，然後由應用程式的 SQL 程式碼執行。目前唯一可用的輸入處理組態是 [InputLambdaProcessor](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_InputLambdaProcessor.html)。類型：[InputProcessingConfiguration](API_InputProcessingConfiguration.md) 物件必要：否 ** KinesisFirehoseInput ** 如果串流來源是 Amazon Kinesis Firehose 交付串流，請識別交付串流的 ARN 和能讓 Amazon Kinesis Analytics 代您存取串流的 IAM 角色。注意：`KinesisStreamsInput` 或 `KinesisFirehoseInput` 為必要。類型：[KinesisFirehoseInput](API_KinesisFirehoseInput.md) 物件必要：否 ** KinesisStreamsInput ** 如果串流來源是 Amazon Kinesis 串流，請識別串流的 Amazon Resource Name (ARN) 和能代您存取串流的 IAM 角色。注意：`KinesisStreamsInput` 或 `KinesisFirehoseInput` 為必要。類型：[KinesisStreamsInput](API_KinesisStreamsInput.md) 物件必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/Input) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/Input) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/Input) # InputConfiguration 當啟動應用程式時，您要提供此組態以識別輸入來源，以及其中您希望應用程式開始處理記錄的點。 ## 目錄 ** Id ** 輸入來源 ID。您可以呼叫 [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 作業取得此 ID。類型：字串長度限制：長度下限為 1。長度上限為 50。模式：`[a-zA-Z0-9_.-]+` 必要：是 ** InputStartingPositionConfiguration ** 您希望應用程式從串流來源開始處理記錄的點。類型：[InputStartingPositionConfiguration](API_InputStartingPositionConfiguration.md) 物件必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/InputConfiguration) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/InputConfiguration) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/InputConfiguration) # InputDescription 描述應用程式輸入組態。如需詳細資訊，請參閱[設定應用程式輸入](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-input.html)。 ## 目錄 ** InAppStreamNames ** 傳回映射至串流來源的應用程式內串流名稱。類型：字串陣列長度限制：長度下限為 1。長度上限為 32。必要：否 ** InputId ** 與應用程式輸入相關聯的輸入 ID。這是 Amazon Kinesis Analytics 指派給您新增至應用程式的每個輸入組態之 ID。類型：字串長度限制：長度下限為 1。長度上限為 50。模式：`[a-zA-Z0-9_.-]+` 必要：否 ** InputParallelism ** 描述設定的平行處理 (映射至串流來源的應用程式內串流數量)。類型：[InputParallelism](API_InputParallelism.md) 物件必要：否 ** InputProcessingConfigurationDescription ** 執行應用程式碼前，在此輸入的記錄上執行之預處理器描述。類型：[InputProcessingConfigurationDescription](API_InputProcessingConfigurationDescription.md) 物件必要：否 ** InputSchema ** 描述串流來源中的資料格式，以及每個資料元素如何映射至所建立應用程式內串流的對應欄位。類型：[SourceSchema](API_SourceSchema.md) 物件必要：否 ** InputStartingPositionConfiguration ** 應用程式設定從輸入串流讀取的點。類型：[InputStartingPositionConfiguration](API_InputStartingPositionConfiguration.md) 物件必要：否 ** KinesisFirehoseInputDescription ** 如果設定串流來源為 Amazon Kinesis Firehose 交付串流，會提供交付串流的 ARN，和能讓 Amazon Kinesis Analytics 代您存取串流的 IAM 角色。類型：[KinesisFirehoseInputDescription](API_KinesisFirehoseInputDescription.md) 物件必要：否 ** KinesisStreamsInputDescription ** 如果串流來源是 Amazon Kinesis 串流，會提供 Amazon Kinesis 串流的 Amazon Resource Name (ARN)，和能代您允許 Amazon Kinesis Analytics 存取串流的 IAM 角色。類型：[KinesisStreamsInputDescription](API_KinesisStreamsInputDescription.md) 物件必要：否 ** NamePrefix ** 應用程式內名稱字首。類型：字串長度限制：長度下限為 1。長度上限為 32。必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/InputDescription) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/InputDescription) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/InputDescription) # InputLambdaProcessor 包含 [AWS Lambda](https://docs.aws.amazon.com/lambda/) 函數的 Amazon Resource Name (ARN) 的物件，用於預先處理串流中的記錄，以及用於存取 AWS Lambda 函數的 IAM 角色的 ARN。 ## 目錄 ** ResourceARN ** 在串流記錄中運作的 [AWS Lambda](https://docs.aws.amazon.com/lambda/) 函數的 ARN。若要指定非最新版的舊版 Lambda 函數，請在 Lambda 函數 ARN 中包含 Lambda 函數版本。如需 Lambda ARNs的詳細資訊，請參閱[範例 ARNs： AWS Lambda](/general/latest/gr/aws-arns-and-namespaces.html#arn-syntax-lambda) 類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：是 ** RoleARN ** 用於存取 AWS Lambda 函數的 IAM 角色 ARN。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/InputLambdaProcessor) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/InputLambdaProcessor) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/InputLambdaProcessor) # InputLambdaProcessorDescription 包含 [AWS Lambda](https://docs.aws.amazon.com/lambda/) 函數的 Amazon Resource Name (ARN) 的物件，用於預先處理串流中的記錄，以及用於存取 AWS Lambda 表達式的 IAM 角色的 ARN。 ## 目錄 ** ResourceARN ** 在串流記錄中預處理 [AWS Lambda](https://docs.aws.amazon.com/lambda/) 函數的 ARN。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：否 ** RoleARN ** 用於存取 AWS Lambda 函數的 IAM 角色 ARN。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/InputLambdaProcessorDescription) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/InputLambdaProcessorDescription) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/InputLambdaProcessorDescription) # InputLambdaProcessorUpdate 表示[InputLambdaProcessor](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_InputLambdaProcessor.html)的更新，該更新用於預處理串流中的記錄。 ## 目錄 ** ResourceARNUpdate ** 在串流中預處理紀錄的新 [AWS Lambda](https://docs.aws.amazon.com/lambda/) 函數之 Amazon Resource Name (ARN)。若要指定非最新版的舊版 Lambda 函數，請在 Lambda 函數 ARN 中包含 Lambda 函數版本。如需 Lambda ARNs的詳細資訊，請參閱[範例 ARNs： AWS Lambda](/general/latest/gr/aws-arns-and-namespaces.html#arn-syntax-lambda) 類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：否 ** RoleARNUpdate ** 用來存取 AWS Lambda 函數之新 IAM 角色的 ARN。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/InputLambdaProcessorUpdate) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/InputLambdaProcessorUpdate) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/InputLambdaProcessorUpdate) # InputParallelism 描述針對指定串流來源所建立的應用程式內串流數目。如需平行處理的資訊，請參閱[設定應用程式輸出](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-input.html)。 ## 目錄 ** Count ** 要建立的應用程式內串流數量。如需詳細資訊，請參閱[限制](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/limits.html)。類型：整數有效範圍：最小值為 1。最大值為 64。必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/InputParallelism) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/InputParallelism) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/InputParallelism) # InputParallelismUpdate 提供平行處理計數的更新。 ## 目錄 ** CountUpdate ** 針對指定串流來源所建立的應用程式內串流數目。類型：整數有效範圍：最小值為 1。最大值為 64。必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/InputParallelismUpdate) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/InputParallelismUpdate) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/InputParallelismUpdate) # InputProcessingConfiguration 提供處理器的描述，先用此處理器預先處理串流中的紀錄，再交由您的應用程式碼處理。目前唯一可用的輸入處理器是 [AWS Lambda](https://docs.aws.amazon.com/lambda/)。 ## 目錄 ** InputLambdaProcessor ** [InputLambdaProcessor](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_InputLambdaProcessor.html)，用來先預先處理串流中的記錄，再由您的應用程式碼處理它們。類型：[InputLambdaProcessor](API_InputLambdaProcessor.md) 物件必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/InputProcessingConfiguration) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/InputProcessingConfiguration) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/InputProcessingConfiguration) # InputProcessingConfigurationDescription 提供有關輸入處理器的組態資訊。目前唯一可用的輸入處理器是 [AWS Lambda](https://docs.aws.amazon.com/lambda/)。 ## 目錄 ** InputLambdaProcessorDescription ** 提供與 [InputLambdaProcessorDescription](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_InputLambdaProcessorDescription.html) 相關的組態資訊說明。類型：[InputLambdaProcessorDescription](API_InputLambdaProcessorDescription.md) 物件必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/InputProcessingConfigurationDescription) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/InputProcessingConfigurationDescription) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/InputProcessingConfigurationDescription) # InputProcessingConfigurationUpdate 描述 [InputProcessingConfiguration](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_InputProcessingConfiguration.html) 的更新。 ## 目錄 ** InputLambdaProcessorUpdate ** 提供 [InputLambdaProcessor](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_InputLambdaProcessor.html) 的更新資訊。類型：[InputLambdaProcessorUpdate](API_InputLambdaProcessorUpdate.md) 物件必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/InputProcessingConfigurationUpdate) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/InputProcessingConfigurationUpdate) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/InputProcessingConfigurationUpdate) # InputSchemaUpdate 說明應用程式輸入結構描述的更新。 ## 目錄 ** RecordColumnUpdates ** `RecordColumn` 物件的清單。每個物件皆描述串流來源元素與應用程式內串流中對應資料欄的映射。類型：[RecordColumn](API_RecordColumn.md) 物件陣列陣列成員：項目數下限為 1。項目數上限為 1000。必要：否 ** RecordEncodingUpdate ** 指定串流來源中的記錄編碼。例如，UTF-8。類型：字串模式：`UTF-8` 必要：否 ** RecordFormatUpdate ** 指定串流來源中的記錄格式。類型：[RecordFormat](API_RecordFormat.md) 物件必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/InputSchemaUpdate) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/InputSchemaUpdate) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/InputSchemaUpdate) # InputStartingPositionConfiguration 描述應用程式從串流來源讀取的點。 ## 目錄 ** InputStartingPosition ** 串流上的開始位置。 + `NOW`：在串流中的最新記錄之後開始讀取，從客戶發出的請求時間戳記開始。 + `TRIM_HORIZON`：從串流中最後一個未修剪記錄開始讀取，這是串流中最舊的記錄。Amazon Kinesis Firehose 交付串流不可使用此選項。 + `LAST_STOPPED_POINT`：繼續閱讀應用程式上次停止讀取的位置。類型：字串有效值:`NOW | TRIM_HORIZON | LAST_STOPPED_POINT` 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/InputStartingPositionConfiguration) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/InputStartingPositionConfiguration) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/InputStartingPositionConfiguration) # InputUpdate 描述特定輸入組態 (由應用程式的 `InputId` 識別) 之更新。 ## 目錄 ** InputId ** 要更新的應用程式輸入之輸入 ID。類型：字串長度限制：長度下限為 1。長度上限為 50。模式：`[a-zA-Z0-9_.-]+` 必要：是 ** InputParallelismUpdate ** 描述平行處理的更新 (Amazon Kinesis Analytics 為特定串流來源建立的應用程式內串流數目)。類型：[InputParallelismUpdate](API_InputParallelismUpdate.md) 物件必要：否 ** InputProcessingConfigurationUpdate ** 描述輸入處理組態的更新。類型：[InputProcessingConfigurationUpdate](API_InputProcessingConfigurationUpdate.md) 物件必要：否 ** InputSchemaUpdate ** 描述串流來源中的資料格式，以及串流來源的紀錄元素如何映射至建立的應用程式內串流資料欄。類型：[InputSchemaUpdate](API_InputSchemaUpdate.md) 物件必要：否 ** KinesisFirehoseInputUpdate ** 如果 Amazon Kinesis Firehose 交付串流是要更新的串流來源，則會提供更新的串流 ARN 和 IAM 角色 ARN。類型：[KinesisFirehoseInputUpdate](API_KinesisFirehoseInputUpdate.md) 物件必要：否 ** KinesisStreamsInputUpdate ** 如果 Amazon Kinesis 串流是要更新的串流來源，則會提供更新的串流 Amazon Resource Name (ARN) 和 IAM 角色 ARN。類型：[KinesisStreamsInputUpdate](API_KinesisStreamsInputUpdate.md) 物件必要：否 ** NamePrefixUpdate ** Amazon Kinesis Analytics 為特定串流來源建立的應用程式內串流之名稱前置詞。類型：字串長度限制：長度下限為 1。長度上限為 32。必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/InputUpdate) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/InputUpdate) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/InputUpdate) # JSONMappingParameters 在 JSON 為串流來源的記錄格式時，提供額外的映射資訊。 ## 目錄 ** RecordRowPath ** 包含紀錄的最上層父系路徑。類型：字串長度限制：長度下限為 1。必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/JSONMappingParameters) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/JSONMappingParameters) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/JSONMappingParameters) # KinesisFirehoseInput 將 Amazon Kinesis Firehose 交付串流識別為串流來源。您提供的交付串流 Amazon Resource Name (ARN) 和 IAM 角色 ARN，可讓 Amazon Kinesis Analytics 代您存取串流。 ## 目錄 ** ResourceARN ** 輸入交付串流的 ARN。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：是 ** RoleARN ** Amazon Kinesis Analytics 可擔任的 IAM 角色 ARN，此角色可代您存取串流。您需要確保此角色具有存取串流的必要許可。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/KinesisFirehoseInput) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/KinesisFirehoseInput) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/KinesisFirehoseInput) # KinesisFirehoseInputDescription 描述在應用程式輸入組態中設定為串流來源的 Amazon Kinesis Firehose 交付串流。 ## 目錄 ** ResourceARN ** Amazon Kinesis Firehose 交付串流的 Amazon Resource Name (ARN)。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：否 ** RoleARN ** Amazon Kinesis Analytics 擔任的 IAM 角色 ARN，此角色可代您存取串流。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/KinesisFirehoseInputDescription) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/KinesisFirehoseInputDescription) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/KinesisFirehoseInputDescription) # KinesisFirehoseInputUpdate 在更新應用程式輸入組態時，提供 Amazon Kinesis Firehose 交付串流的資訊，以作為串流來源。 ## 目錄 ** ResourceARNUpdate ** 要讀取的 Amazon Kinesis Firehose 交付串流的 Amazon Resource Name (ARN)。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：否 ** RoleARNUpdate ** Amazon Kinesis Analytics 可擔任的 IAM 角色 ARN，此角色可代您存取串流。您需要授予此角色必要的許可。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/KinesisFirehoseInputUpdate) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/KinesisFirehoseInputUpdate) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/KinesisFirehoseInputUpdate) # KinesisFirehoseOutput 在設定應用程式輸出時，將 Amazon Kinesis Firehose 交付串流識別為目標。您提供的串流 Amazon Resource Name (ARN) 和 IAM 角色，可讓 Amazon Kinesis Analytics 代您寫入串流。 ## 目錄 ** ResourceARN ** 要寫入的目標 Amazon Kinesis Firehose 交付串流 ARN。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：是 ** RoleARN ** Amazon Kinesis Analytics 可擔任的 IAM 角色 ARN，代您寫入目標串流。您需要授予此角色必要的許可。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/KinesisFirehoseOutput) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/KinesisFirehoseOutput) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/KinesisFirehoseOutput) # KinesisFirehoseOutputDescription 針對應用程式輸出，描述設定為其目的地的 Amazon Kinesis Firehose 交付串流。 ## 目錄 ** ResourceARN ** Amazon Kinesis Firehose 交付串流的 Amazon Resource Name (ARN)。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：否 ** RoleARN ** Amazon Kinesis Analytics 可擔任的 IAM 角色 ARN，此角色可存取串流。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/KinesisFirehoseOutputDescription) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/KinesisFirehoseOutputDescription) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/KinesisFirehoseOutputDescription) # KinesisFirehoseOutputUpdate 使用[UpdateApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_UpdateApplication.html)作業更新輸出組態時，會提供設定為目的地之 Amazon Kinesis Firehose 交付串流的相關資訊。 ## 目錄 ** ResourceARNUpdate ** 要寫入的 Amazon Kinesis Firehose 交付串流 Amazon Resource Name (ARN)。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：否 ** RoleARNUpdate ** Amazon Kinesis Analytics 可擔任的 IAM 角色 ARN，此角色可代您存取串流。您需要授予此角色必要的許可。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/KinesisFirehoseOutputUpdate) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/KinesisFirehoseOutputUpdate) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/KinesisFirehoseOutputUpdate) # KinesisStreamsInput 將 Amazon Kinesis 串流識別為串流來源。您提供的串流 Amazon Resource Name (ARN) 和 IAM 角色 ARN，可讓 Amazon Kinesis Analytics 代您存取串流。 ## 目錄 ** ResourceARN ** 要讀取的輸入 Amazon Kinesis 串流 ARN。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：是 ** RoleARN ** Amazon Kinesis Analytics 可擔任的 IAM 角色 ARN，此角色可代您存取串流。您需要授予此角色必要的許可。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/KinesisStreamsInput) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/KinesisStreamsInput) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/KinesisStreamsInput) # KinesisStreamsInputDescription 描述在應用程式輸入組態中設定為串流來源的 Amazon Kinesis 串流。 ## 目錄 ** ResourceARN ** Amazon Kinesis 串流的 Amazon Resource Name (ARN)。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：否 ** RoleARN ** Amazon Kinesis Analytics 可擔任的 IAM 角色 ARN，此角色可存取串流。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/KinesisStreamsInputDescription) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/KinesisStreamsInputDescription) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/KinesisStreamsInputDescription) # KinesisStreamsInputUpdate 在更新應用程式輸入組態時，提供 Amazon Kinesis 串流的資訊，以作為串流來源。 ## 目錄 ** ResourceARNUpdate ** 要讀取的輸入 Amazon Kinesis 串流之 Amazon Resource Name (ARN)。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：否 ** RoleARNUpdate ** Amazon Kinesis Analytics 可擔任的 IAM 角色 ARN，此角色可代您存取串流。您需要授予此角色必要的許可。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/KinesisStreamsInputUpdate) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/KinesisStreamsInputUpdate) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/KinesisStreamsInputUpdate) # KinesisStreamsOutput 在設定應用程式輸出時，將 Amazon Kinesis 串流識別為目標。您要提供串流 Amazon Resource Name (ARN) 以及可讓 Amazon Kinesis Analytics 使用的 IAM 角色 ARN，代您寫入串流。 ## 目錄 ** ResourceARN ** 要寫入的目標 Amazon Kinesis 串流 ARN。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：是 ** RoleARN ** Amazon Kinesis Analytics 可擔任的 IAM 角色 ARN，代您寫入目標串流。您需要授予此角色必要的許可。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/KinesisStreamsOutput) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/KinesisStreamsOutput) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/KinesisStreamsOutput) # KinesisStreamsOutputDescription 針對應用程式輸出，描述設定為其目的地的 Amazon Kinesis 串流。 ## 目錄 ** ResourceARN ** Amazon Kinesis 串流的 Amazon Resource Name (ARN)。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：否 ** RoleARN ** Amazon Kinesis Analytics 可擔任的 IAM 角色 ARN，此角色可存取串流。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/KinesisStreamsOutputDescription) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/KinesisStreamsOutputDescription) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/KinesisStreamsOutputDescription) # KinesisStreamsOutputUpdate 使用 [UpdateApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_UpdateApplication.html) 作業更新輸出組態時，會提供設定為目的地之 Amazon Kinesis 串流的相關資訊。 ## 目錄 ** ResourceARNUpdate ** 您想要寫入輸出的 Amazon Kinesis 串流之 Amazon Resource Name (ARN)。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：否 ** RoleARNUpdate ** Amazon Kinesis Analytics 可擔任的 IAM 角色 ARN，此角色可代您存取串流。您需要授予此角色必要的許可。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/KinesisStreamsOutputUpdate) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/KinesisStreamsOutputUpdate) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/KinesisStreamsOutputUpdate) # LambdaOutput 設定應用程式輸出時，會將 AWS Lambda 函數識別為目的地。您要提供函數 Amazon Resource Name (ARN) 以及可讓 Amazon Kinesis Analytics 使用的 IAM 角色，代您寫入函數。 ## 目錄 ** ResourceARN ** 要寫入之目標 Lambda 函數的 Amazon Resource Name (ARN)。若要指定非最新版的舊版 Lambda 函數，請在 Lambda 函數 ARN 中包含 Lambda 函數版本。如需 Lambda ARNs的詳細資訊，請參閱[範例 ARNs： AWS Lambda](/general/latest/gr/aws-arns-and-namespaces.html#arn-syntax-lambda) 類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：是 ** RoleARN ** Amazon Kinesis Analytics 可擔任的 IAM 角色 ARN，此角色代您寫入目標函數。您需要授予此角色必要的許可。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/LambdaOutput) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/LambdaOutput) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/LambdaOutput) # LambdaOutputDescription 對於應用程式輸出，描述設定為其目的地的 AWS Lambda 函數。 ## 目錄 ** ResourceARN ** 目的地 Lambda 函數的 Amazon Resource Name (ARN)。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：否 ** RoleARN ** Amazon Kinesis Analytics 可擔任的 IAM 角色 ARN，此角色會寫入目標函數。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/LambdaOutputDescription) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/LambdaOutputDescription) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/LambdaOutputDescription) # LambdaOutputUpdate 使用 [UpdateApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_UpdateApplication.html) 操作更新輸出組態時，會提供設定為目的地之 AWS Lambda 函數的相關資訊。 ## 目錄 ** ResourceARNUpdate ** 目的地 Lambda 函數的 Amazon Resource Name (ARN)。若要指定非最新版的舊版 Lambda 函數，請在 Lambda 函數 ARN 中包含 Lambda 函數版本。如需 Lambda ARNs的詳細資訊，請參閱[範例 ARNs： AWS Lambda](/general/latest/gr/aws-arns-and-namespaces.html#arn-syntax-lambda) 類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：否 ** RoleARNUpdate ** Amazon Kinesis Analytics 可擔任的 IAM 角色 ARN，此角色代您寫入目標函數。您需要授予此角色必要的許可。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/LambdaOutputUpdate) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/LambdaOutputUpdate) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/LambdaOutputUpdate) # MappingParameters 在建立或更新應用程式期間設定應用程式輸入時，請提供對串流來源記錄格式而言特定的額外映射資訊 (例如 JSON、CSV 或由一些分隔符號分隔的記錄欄位)。 ## 目錄 ** CSVMappingParameters ** 當記錄格式使用 CSV 等分隔符號時，此屬性會提供其他的映射資訊。類型：[CSVMappingParameters](API_CSVMappingParameters.md) 物件必要：否 ** JSONMappingParameters ** 在 JSON 為串流來源的記錄格式時，提供額外的映射資訊。類型：[JSONMappingParameters](API_JSONMappingParameters.md) 物件必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/MappingParameters) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/MappingParameters) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/MappingParameters) # Output 描述應用程式輸出組態，您可在此識別應用程式內串流和應用程式內串流資料寫入的目標。目標可以是 Amazon Kinesis 串流或 Amazon Kinesis Firehose 交付串流。如需應用程式可以寫入的目標數限制和其他限制，請參閱[限制](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/limits.html)。 ## 目錄 ** DestinationSchema ** 描述紀錄寫入目標時所採用的資料格式。如需詳細資訊，請參閱[設定應用程式輸出](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-output.html)。類型：[DestinationSchema](API_DestinationSchema.md) 物件必要：是 ** Name ** 應用程式內串流的名稱。類型：字串長度限制：長度下限為 1。長度上限為 32。必要：是 ** KinesisFirehoseOutput ** 將 Amazon Kinesis Firehose 交付串流識別為目標。類型：[KinesisFirehoseOutput](API_KinesisFirehoseOutput.md) 物件必要：否 ** KinesisStreamsOutput ** 將 Amazon Kinesis 串流識別為目標。類型：[KinesisStreamsOutput](API_KinesisStreamsOutput.md) 物件必要：否 ** LambdaOutput ** 將 AWS Lambda 函數識別為目的地。類型：[LambdaOutput](API_LambdaOutput.md) 物件必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/Output) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/Output) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/Output) # OutputDescription 描述應用程式輸出組態，其中包括應用程式內串流名稱和串流資料寫入的目的地。目標可以是 Amazon Kinesis 串流或 Amazon Kinesis Firehose 交付串流。 ## 目錄 ** DestinationSchema ** 用於將資料寫入目的地的資料格式。類型：[DestinationSchema](API_DestinationSchema.md) 物件必要：否 ** KinesisFirehoseOutputDescription ** 描述設定為輸出寫入目的地的 Amazon Kinesis Firehose 交付串流。類型：[KinesisFirehoseOutputDescription](API_KinesisFirehoseOutputDescription.md) 物件必要：否 ** KinesisStreamsOutputDescription ** 描述設定為輸出寫入的目的地的 Amazon Kinesis 串流。類型：[KinesisStreamsOutputDescription](API_KinesisStreamsOutputDescription.md) 物件必要：否 ** LambdaOutputDescription ** 描述設定為輸出寫入目的地的 AWS Lambda 函數。類型：[LambdaOutputDescription](API_LambdaOutputDescription.md) 物件必要：否 ** Name ** 設定為輸出的應用程式內串流名稱。類型：字串長度限制：長度下限為 1。長度上限為 32。必要：否 ** OutputId ** 輸出組態的唯一識別符。類型：字串長度限制：長度下限為 1。長度上限為 50。模式：`[a-zA-Z0-9_.-]+` 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/OutputDescription) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/OutputDescription) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/OutputDescription) # OutputUpdate 描述由 `OutputId` 識別之輸出組態的更新。 ## 目錄 ** OutputId ** 識別您想要更新的特定輸出組態。類型：字串長度限制：長度下限為 1。長度上限為 50。模式：`[a-zA-Z0-9_.-]+` 必要：是 ** DestinationSchemaUpdate ** 描述紀錄寫入目標時所採用的資料格式。如需詳細資訊，請參閱[設定應用程式輸出](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-output.html)。類型：[DestinationSchema](API_DestinationSchema.md) 物件必要：否 ** KinesisFirehoseOutputUpdate ** 描述設定為輸出目的地的 Amazon Kinesis Firehose 交付串流。類型：[KinesisFirehoseOutputUpdate](API_KinesisFirehoseOutputUpdate.md) 物件必要：否 ** KinesisStreamsOutputUpdate ** 將 Amazon Kinesis 串流描述為輸出目的地。類型：[KinesisStreamsOutputUpdate](API_KinesisStreamsOutputUpdate.md) 物件必要：否 ** LambdaOutputUpdate ** 描述 AWS Lambda 函數做為輸出的目的地。類型：[LambdaOutputUpdate](API_LambdaOutputUpdate.md) 物件必要：否 ** NameUpdate ** 如果您要為此輸出組態指定不同的應用程式內串流，請使用此欄位來指定新的應用程式內串流名稱。類型：字串長度限制：長度下限為 1。長度上限為 32。必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/OutputUpdate) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/OutputUpdate) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/OutputUpdate) # RecordColumn 描述串流來源中每個資料元素與應用程式內串流中對應欄位的映射。也用於描述參考資料來源的格式。 ## 目錄 ** Name ** 在應用程式內輸入串流或參考表中建立的欄位名稱。類型：字串必要：是 ** SqlType ** 在應用程式內輸入串流或參考表中建立的欄位類型。類型：字串長度限制：長度下限為 1。必要：是 ** Mapping ** 串流輸入資料元素或參考資料來源的參考。如果 [RecordFormatType](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_RecordFormat.html#analytics-Type-RecordFormat-RecordFormatTypel) 是 `JSON`，則此為必要元素。類型：字串必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/RecordColumn) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/RecordColumn) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/RecordColumn) # RecordFormat 描述紀錄格式和相關的映射資訊，它們應用來結構化串流內的記錄。 ## 目錄 ** RecordFormatType ** 紀錄格式的類型。類型：字串有效值:`JSON | CSV` 必要：是 ** MappingParameters ** 在建立或更新應用程式期間設定應用程式輸入時，請提供對串流來源記錄格式而言特定的額外映射資訊 (例如 JSON、CSV 或由一些分隔符號分隔的記錄欄位)。類型：[MappingParameters](API_MappingParameters.md) 物件必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/RecordFormat) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/RecordFormat) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/RecordFormat) # ReferenceDataSource 描述參考資料來源，方法是提供來源資訊 (S3 儲存貯體名稱和物件索引鍵名稱)、已建立的產生應用程式內資料表名稱，以及將 Amazon S3 物件中的資料元素映射至應用程式中資料表的必要結構描述。 ## 目錄 ** ReferenceSchema ** 描述串流來源中的資料格式，以及每個資料元素如何映射至應用程式內串流中所建立的對應欄位。類型：[SourceSchema](API_SourceSchema.md) 物件必要：是 ** TableName ** 要建立的應用程式內資料表名稱。類型：字串長度限制：長度下限為 1。長度上限為 32。必要：是 ** S3ReferenceDataSource ** 識別包含參考資料的 S3 儲存貯體和物件。也請識別 Amazon Kinesis Analytics 可擔任的 IAM 角色，代您讀取此物件。Amazon Kinesis Analytics 應用程式只會載入一次參考資料。如果資料變更，您可以呼叫 `UpdateApplication` 操作，觸發將資料重新載入到您的應用程式。類型：[S3ReferenceDataSource](API_S3ReferenceDataSource.md) 物件必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/ReferenceDataSource) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/ReferenceDataSource) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/ReferenceDataSource) # ReferenceDataSourceDescription 描述設定給應用程式的參考資料來源。 ## 目錄 ** ReferenceId ** 參考資料來源的 ID。當您使用 [AddApplicationReferenceDataSource](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_AddApplicationReferenceDataSource.html) 作業將參考資料來源新增至應用程式時，Amazon Kinesis Analytics 會指派一個 ID。類型：字串長度限制：長度下限為 1。長度上限為 50。模式：`[a-zA-Z0-9_.-]+` 必要：是 ** S3ReferenceDataSourceDescription ** 提供 S3 儲存貯體名稱，該物件金鑰包含參考資料。它還提供 Amazon Kinesis Analytics 可擔任的 IAM 角色之 Amazon Resource Name (ARN)，可讓 Amazon Kinesis Analytics 讀取 Amazon S3 物件並填入應用程式內參考資料表。類型：[S3ReferenceDataSourceDescription](API_S3ReferenceDataSourceDescription.md) 物件必要：是 ** TableName ** 由特定參考資料來源組態建立的應用程式內表格名稱。類型：字串長度限制：長度下限為 1。長度上限為 32。必要：是 ** ReferenceSchema ** 描述串流來源中的資料格式，以及每個資料元素如何映射至應用程式內串流中所建立的對應欄位。類型：[SourceSchema](API_SourceSchema.md) 物件必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/ReferenceDataSourceDescription) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/ReferenceDataSourceDescription) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/ReferenceDataSourceDescription) # ReferenceDataSourceUpdate 當您更新應用程式的參考資料來源組態時，此物件會提供所有更新的值 (例如來源儲存貯體名稱和物件金鑰名稱)、建立的應用程式內表格名稱，以及更新的映射資訊，將 Amazon S3 物件中的資料映射至建立的應用程式內參考資料表。 ## 目錄 ** ReferenceId ** 更新中參考資料來源的 ID。您可以使用 [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 作業取得此值。類型：字串長度限制：長度下限為 1。長度上限為 50。模式：`[a-zA-Z0-9_.-]+` 必要：是 ** ReferenceSchemaUpdate ** 描述串流來源中的資料格式，以及每個資料元素如何映射至應用程式內串流中所建立的對應欄位。類型：[SourceSchema](API_SourceSchema.md) 物件必要：否 ** S3ReferenceDataSourceUpdate ** 描述 Amazon Kinesis 分析可代表您讀取 Amazon S3 物件並填入應用程式內參考資料表的 S3 儲存貯體名稱、物件金鑰名稱和 IAM 角色。類型：[S3ReferenceDataSourceUpdate](API_S3ReferenceDataSourceUpdate.md) 物件必要：否 ** TableNameUpdate ** 此更新所建立的應用程式內資料表名稱。類型：字串長度限制：長度下限為 1。長度上限為 32。必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/ReferenceDataSourceUpdate) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/ReferenceDataSourceUpdate) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/ReferenceDataSourceUpdate) # S3Configuration 提供 Amazon S3 資料來源的描述，包括 S3 儲存貯體的 Amazon Resource Name (ARN)、用於存取儲存貯體的 IAM 角色 ARN，以及包含資料的 Amazon S3 物件名稱。 ## 目錄 ** BucketARN ** 包含該資料的 S3 儲存貯體 ARN。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：是 ** FileKey ** 包含該資料的物件名稱。類型：字串長度限制：長度下限為 1。長度上限為 1024。必要：是 ** RoleARN ** 用來存取資料之角色的 IAM ARN。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/S3Configuration) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/S3Configuration) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/S3Configuration) # S3ReferenceDataSource 識別包含參考資料的 S3 儲存貯體和物件。也請識別 Amazon Kinesis Analytics 可擔任的 IAM 角色，代您讀取此物件。 Amazon Kinesis Analytics 應用程式只會載入一次參考資料。如果資料變更，您可以呼叫 [UpdateApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_UpdateApplication.html) 操作，觸發將資料重新載入到您的應用程式。 ## 目錄 ** BucketARN ** S3 儲存貯體的 Amazon Resource Name (ARN)。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：是 ** FileKey ** 包含參考資料的物件索引鍵名稱。類型：字串長度限制：長度下限為 1。長度上限為 1024。必要：是 ** ReferenceRoleARN ** 服務可擔任代您讀取資料之 IAM 角色的 ARN。此角色必須有物件的 `s3:GetObject` 動作許可，以及讓 Amazon Kinesis Analytics 服務主體擔任此角色的信任政策。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/S3ReferenceDataSource) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/S3ReferenceDataSource) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/S3ReferenceDataSource) # S3ReferenceDataSourceDescription 提供儲存參考資料的儲存貯體與物件金鑰名稱。 ## 目錄 ** BucketARN ** S3 儲存貯體的 Amazon Resource Name (ARN)。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：是 ** FileKey ** Amazon S3 物件金鑰名稱。類型：字串長度限制：長度下限為 1。長度上限為 1024。必要：是 ** ReferenceRoleARN ** Amazon Kinesis Analytics 可擔任的 IAM 角色 ARN，此角色代您讀取 Amazon S3 物件，以填入應用程式內參考資料表。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/S3ReferenceDataSourceDescription) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/S3ReferenceDataSourceDescription) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/S3ReferenceDataSourceDescription) # S3ReferenceDataSourceUpdate 描述 Amazon Kinesis 分析可代表您讀取 Amazon S3 物件並填入應用程式內參考資料表的 S3 儲存貯體名稱、物件金鑰名稱和 IAM 角色。 ## 目錄 ** BucketARNUpdate ** S3 儲存貯體的 Amazon Resource Name (ARN)。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：否 ** FileKeyUpdate ** 物件金鑰名稱。類型：字串長度限制：長度下限為 1。長度上限為 1024。必要：否 ** ReferenceRoleARNUpdate ** Amazon Kinesis Analytics 可擔任的 IAM 角色 ARN，此角色會讀取 Amazon S3 物件，以填入應用程式內。類型：字串長度限制：長度下限為 1。長度上限為 2048。模式：`arn:.*` 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/S3ReferenceDataSourceUpdate) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/S3ReferenceDataSourceUpdate) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/S3ReferenceDataSourceUpdate) # SourceSchema 描述串流來源中的資料格式，以及每個資料元素如何映射至應用程式內串流中所建立的對應欄位。 ## 目錄 ** RecordColumns ** `RecordColumn` 物件的清單。類型：[RecordColumn](API_RecordColumn.md) 物件陣列陣列成員：項目數下限為 1。項目數上限為 1000。必要：是 ** RecordFormat ** 指定串流來源中的記錄格式。類型：[RecordFormat](API_RecordFormat.md) 物件必要：是 ** RecordEncoding ** 指定串流來源中的記錄編碼。例如，UTF-8。類型：字串模式：`UTF-8` 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/SourceSchema) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/SourceSchema) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/SourceSchema) # Tag 您可以定義和指派給 AWS 資源的鍵/值對（該值為選用）。如果您指定已存在的標籤，您在請求中指定的值會取代標籤值。請注意，應用程式標籤的數目上限包括系統標籤。使用者定義的應用程式的標籤數目上限為 50。如需詳細資訊，請參閱[使用標記](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-tagging.html)。 ## 目錄 ** Key ** 索引鍵值標籤的金鑰。類型：字串長度限制：長度下限為 1。長度上限為 128。必要：是 ** Value ** 鍵值對標籤的值。此值是選用的。類型：字串長度限制：長度下限為 0。長度上限為 256。必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/Tag) + [AWS 適用於 Java V2 的開發套件](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/Tag) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/Tag)