本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # DeleteEventSourceMapping 刪除[事件來源映射](https://docs.aws.amazon.com/lambda/latest/dg/intro-invocation-modes.html)。您可以從 [ListEventSourceMappings](API_ListEventSourceMappings.md) 的輸出中獲取映射的識別符。當您刪除事件來源映射時，它會進入 `Deleting` 狀態，並且可能在幾秒鐘內不會完全刪除。 ## 請求語法 ``` DELETE /2015-03-31/event-source-mappings/UUID HTTP/1.1 ``` ## URI 請求參數請求會使用下列 URI 參數。 ** [UUID](#API_DeleteEventSourceMapping_RequestSyntax) ** 事件來源映射的識別符。必要：是 ## 請求主體請求沒有請求主體。 ## 回應語法 ``` HTTP/1.1 202 Content-type: application/json { "AmazonManagedKafkaEventSourceConfig": { "ConsumerGroupId": "string" }, "BatchSize": number, "BisectBatchOnFunctionError": boolean, "DestinationConfig": { "OnFailure": { "Destination": "string" }, "OnSuccess": { "Destination": "string" } }, "DocumentDBEventSourceConfig": { "CollectionName": "string", "DatabaseName": "string", "FullDocument": "string" }, "EventSourceArn": "string", "FilterCriteria": { "Filters": [ { "Pattern": "string" } ] }, "FunctionArn": "string", "FunctionResponseTypes": [ "string" ], "LastModified": number, "LastProcessingResult": "string", "MaximumBatchingWindowInSeconds": number, "MaximumRecordAgeInSeconds": number, "MaximumRetryAttempts": number, "ParallelizationFactor": number, "Queues": [ "string" ], "ScalingConfig": { "MaximumConcurrency": number }, "SelfManagedEventSource": { "Endpoints": { "string" : [ "string" ] } }, "SelfManagedKafkaEventSourceConfig": { "ConsumerGroupId": "string" }, "SourceAccessConfigurations": [ { "Type": "string", "URI": "string" } ], "StartingPosition": "string", "StartingPositionTimestamp": number, "State": "string", "StateTransitionReason": "string", "Topics": [ "string" ], "TumblingWindowInSeconds": number, "UUID": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 202 回應。服務會傳回下列 JSON 格式的資料。 ** [AmazonManagedKafkaEventSourceConfig](#API_DeleteEventSourceMapping_ResponseSyntax) ** Amazon Managed Streaming for Apache Kafka (Amazon MSK) 事件來源的具體組態設定。類型：[AmazonManagedKafkaEventSourceConfig](API_AmazonManagedKafkaEventSourceConfig.md) 物件 ** [BatchSize](#API_DeleteEventSourceMapping_ResponseSyntax) ** Lambda 從串流或佇列中提取並傳送至函數的每個批次中的記錄數目上限。Lambda 會將批次中的所有記錄以單一呼叫形式傳送至函數，直到達到同步調用的承載限制 (6 MB)。預設值：依服務而異。對於 Amazon SQS，預設值為 10。對於所有其他服務，預設值為 100。相關設定：當您將 `BatchSize` 設定為大於 10 的值時，必須將 `MaximumBatchingWindowInSeconds` 至少設定為 1。類型：整數有效範圍：最小值為 1。最大值為 10000。 ** [BisectBatchOnFunctionError](#API_DeleteEventSourceMapping_ResponseSyntax) ** (僅限 Kinesis 和 DynamoDB Streams) 如果函數傳回錯誤，將批次分割為兩個並重試。預設值為 false。類型：布林值 ** [DestinationConfig](#API_DeleteEventSourceMapping_ResponseSyntax) ** (僅限 Kinesis、DynamoDB Streams、Amazon MSK 和自我管理的 Apache 卡夫卡事件來源) 一種組態物件，可在 Lambda 處理事件後指定事件的目的地。類型：[DestinationConfig](API_DestinationConfig.md) 物件 ** [DocumentDBEventSourceConfig](#API_DeleteEventSourceMapping_ResponseSyntax) ** DocumentDB 事件來源的具體組態設定。類型：[DocumentDBEventSourceConfig](API_DocumentDBEventSourceConfig.md) 物件 ** [EventSourceArn](#API_DeleteEventSourceMapping_ResponseSyntax) ** 事件來源的 Amazon Resource Name (ARN)。類型：String 模式：`arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` ** [FilterCriteria](#API_DeleteEventSourceMapping_ResponseSyntax) ** 定義篩選條件標準的物件，用於決定 Lambda 是否應該處理事件。如需詳細資訊，請參閱 [Lambda 事件篩選](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html)。類型：[FilterCriteria](API_FilterCriteria.md) 物件 ** [FunctionArn](#API_DeleteEventSourceMapping_ResponseSyntax) ** Lambda 函數的 ARN。類型：String 模式：`arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}(-gov)?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?` ** [FunctionResponseTypes](#API_DeleteEventSourceMapping_ResponseSyntax) ** (Kinesis、DynamoDB Streams 和 Amazon SQS) 套用至事件來源映射的目前回應類型列舉清單。類型：字串陣列陣列成員：項目數下限為 0。項目數上限為 1。有效值:`ReportBatchItemFailures` ** [LastModified](#API_DeleteEventSourceMapping_ResponseSyntax) ** 上次更新事件來源映射或其狀態變更的日期 (以 Unix 時間秒為單位)。類型：Timestamp ** [LastProcessingResult](#API_DeleteEventSourceMapping_ResponseSyntax) ** 函數的最後一次 Lambda 調用的結果。類型：字串 ** [MaximumBatchingWindowInSeconds](#API_DeleteEventSourceMapping_ResponseSyntax) ** Lambda 調用函數之前收集記錄所花費的最長時間 (以秒為單位)。您可以將 `MaximumBatchingWindowInSeconds` 設定為從 0 秒到 300 秒之間的任意值，增量為秒。如果事件來源是串流和 Amazon SQS，預設批次間隔為 0 秒。如果事件來源是 Amazon MSK、自主管理 Apache Kafka 、Amazon MQ 以及 DocumentDB，則預設批次間隔為 500 毫秒。請注意，因為您只能以秒為增量變更 `MaximumBatchingWindowInSeconds`，所以預設批次間隔一旦變更後就無法再恢復到 500 毫秒的預設值。要恢復預設批次間隔，必須建立新的事件來源映射。相關設定：如果事件來源是串流和 Amazon SQS，將 `BatchSize` 設定為大於 10 的值時，必須將 `MaximumBatchingWindowInSeconds` 至少設定為 1。類型：整數有效範圍：最小值為 0。最大值為 300。 ** [MaximumRecordAgeInSeconds](#API_DeleteEventSourceMapping_ResponseSyntax) ** (僅限 Kinesis 和 DynamoDB Streams) 捨棄超過指定存留期的記錄。預設值為 -1，這會將最大存留期設定為無限。當值設定為無限時，Lambda 永遠不會捨棄舊記錄。最大記錄保留期的最小有效值為 60 秒。雖然小於 60 且大於 -1 的值在參數的絕對範圍內，但不允許這些值類型：整數有效範圍：最小值為 -1。最大值為 604800。 ** [MaximumRetryAttempts](#API_DeleteEventSourceMapping_ResponseSyntax) ** (僅限 Kinesis 和 DynamoDB Streams) 在指定的重試次數之後捨棄記錄。預設值為 -1，這會將重試數上限設定為無限。如果 MaximumRetryAttempts 是無限的，Lambda 會重試失敗的記錄，直到事件來源中的記錄到期為止。類型：整數有效範圍：最小值為 -1。最大值為 10000。 ** [ParallelizationFactor](#API_DeleteEventSourceMapping_ResponseSyntax) ** (僅限 Kinesis 和 DynamoDB Streams) 要從每個碎片中同時處理的批次數。預設值為 1。類型：整數有效範圍：最小值為 1。最大值為 10。 ** [Queues](#API_DeleteEventSourceMapping_ResponseSyntax) ** (Amazon MQ) 要使用的 Amazon MQ 代理程式目的地佇列的名稱。類型：字串陣列陣列成員：固定項目數為 1。長度限制：長度下限為 1。長度上限為 1000。模式：`[\s\S]*` ** [ScalingConfig](#API_DeleteEventSourceMapping_ResponseSyntax) ** (僅限 Amazon SQS) 事件來源的擴展組態。如需詳細資訊，請參閱[設定 Amazon SQS 事件來源的並行上限](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#events-sqs-max-concurrency)。類型：[ScalingConfig](API_ScalingConfig.md) 物件 ** [SelfManagedEventSource](#API_DeleteEventSourceMapping_ResponseSyntax) ** 用於事件來源的自我管理型 Apache Kafka 叢集。類型：[SelfManagedEventSource](API_SelfManagedEventSource.md) 物件 ** [SelfManagedKafkaEventSourceConfig](#API_DeleteEventSourceMapping_ResponseSyntax) ** 用於自我管理的 Apache Kafka 事件來源的具體組態設定。類型：[SelfManagedKafkaEventSourceConfig](API_SelfManagedKafkaEventSourceConfig.md) 物件 ** [SourceAccessConfigurations](#API_DeleteEventSourceMapping_ResponseSyntax) ** 保護和定義事件來源的身分驗證協定、VPC 元件或虛擬主機。類型：[SourceAccessConfiguration](API_SourceAccessConfiguration.md) 物件陣列陣列成員：項目數下限為 0。項目數上限為 22。 ** [StartingPosition](#API_DeleteEventSourceMapping_ResponseSyntax) ** 要從中開始讀取的串流位置。Amazon Kinesis 和 Amazon DynamoDB Stream 事件來源所必需。Amazon Kinesis 串流、Amazon DocumentDB、Amazon MSK 以及自我管理的 Apache Kafka 僅支援 `AT_TIMESTAMP`。類型：字串有效值:`TRIM_HORIZON | LATEST | AT_TIMESTAMP` ** [StartingPositionTimestamp](#API_DeleteEventSourceMapping_ResponseSyntax) ** 將 `StartingPosition` 設定為 `AT_TIMESTAMP`，這是開始讀取的時間 (以 Unix 時間秒為單位)。`StartingPositionTimestamp` 不能為未來的時間。類型：Timestamp ** [State](#API_DeleteEventSourceMapping_ResponseSyntax) ** 事件來源映射的狀態。可為下列其中之一：`Creating`、`Enabling`、`Enabled`、`Disabling`、`Disabled`、`Updating` 或 `Deleting`。類型：字串 ** [StateTransitionReason](#API_DeleteEventSourceMapping_ResponseSyntax) ** 指出使用者或 Lambda 是否對事件來源映射進行最後的變更。類型：字串 ** [Topics](#API_DeleteEventSourceMapping_ResponseSyntax) ** Kafka 主題名稱。類型：字串陣列陣列成員：固定項目數為 1。長度限制：長度下限為 1。長度上限為 249。模式：`^[^.]([a-zA-Z0-9\-_.]+)` ** [TumblingWindowInSeconds](#API_DeleteEventSourceMapping_ResponseSyntax) ** (僅限 Kinesis 和 DynamoDB Streams) DynamoDB 和 Kinesis Streams 事件來源處理時段的持續時間 (以秒為單位)。值為 0 秒代表沒有輪轉時段。類型：整數有效範圍：最小值為 0。最大值為 900。 ** [UUID](#API_DeleteEventSourceMapping_ResponseSyntax) ** 事件來源映射的識別符。類型：字串 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** InvalidParameterValueException ** 請求中的其中一個參數無效。 HTTP 狀態碼：400 ** ResourceConflictException ** 資源已存在，或另一個操作正在進行中。 HTTP 狀態碼：409 ** ResourceInUseException ** 操作與資源的可用性衝突。例如，您嘗試 CREATING 狀態的更新事件來源映射，或嘗試刪除目前處於 UPDATING 狀態的事件來源映射。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 請求中指定的資源不存在。 HTTP 狀態碼：404 ** ServiceException ** AWS Lambda 服務發生內部錯誤。 HTTP 狀態碼：500 ** TooManyRequestsException ** 超出請求輸送量限制。如需詳細資訊，請參閱 [Lambda 配額](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)。 HTTP 狀態碼：429 ## 另請參閱如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明： + [AWS 命令列介面](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/DeleteEventSourceMapping) + [適用於 .NET 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/DeleteEventSourceMapping) + [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/DeleteEventSourceMapping) + [適用於 Go 的 AWS 軟體開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/DeleteEventSourceMapping) + [適用於 Java 的 AWS 軟體開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/DeleteEventSourceMapping) + [AWS適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/DeleteEventSourceMapping) + [適用於 PHP 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/DeleteEventSourceMapping) + [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/DeleteEventSourceMapping) + [適用於 Ruby 的 AWS 軟體開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/DeleteEventSourceMapping)