

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Amazon EventBridge 中的事件
<a name="eb-events"></a>

*事件*指示某個環境 (例如 AWS 環境、SaaS 合作夥伴服務或應用程式) 或者您的某個應用程式或服務的變更。下列為事件的範例：
+ Amazon EC2 會在執行個體狀態變更時產生事件，例如從待定變更為執行中。
+ AWS CloudFormation 會在建立、更新或刪除堆疊時產生事件。
+ AWS CloudTrail 當您進行 API 呼叫時， 會發佈事件。

您也可以設定定期產生的排程事件。

事件表示為 JSON 物件，所有事件都具有類似的結構，且具有相同的最上層欄位。如需詳細資訊，請參閱 *EventBridge *[事件參考中的事件結構](https://docs.aws.amazon.com/eventbridge/latest/ref/welcome.html#overiew-event-structure)。

## 來自 AWS 服務的事件
<a name="eb-service-event"></a>

許多 AWS 服務會產生 EventBridge 接收的事件。當您帳戶中 AWS 的服務將事件傳送至 EventBridge 時，它會前往您帳戶的預設事件匯流排。

如需將事件傳送至 EventBridge AWS 的服務清單及其傳送的事件，請參閱 [EventBridge 事件參考](https://docs.aws.amazon.com/eventbridge/latest/ref/welcome.html)。

AWS 服務會以*持久*或*盡力*的方式將事件傳送至 EventBridge。如需詳細資訊，請參閱 *EventBridge *[事件參考中的事件交付層級](https://docs.aws.amazon.com/eventbridge/latest/ref/welcome.html#event-delivery-level)。

 下列影片說明事件的基本概念：




 以下影片涵蓋事件達到 EventBridge 的方式：




# 在 Amazon EventBridge `PutEvents`中使用 傳送事件
<a name="eb-putevents"></a>

`PutEvents` 動作可在單一請求中將多個[事件](eb-events.md)傳送至 EventBridge。如需詳細資訊，請參閱《Amazon EventBridge API 參考》**中的 [PutEvents](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutEvents.html) 和 *AWS CLI 命令參考*中的 [Put-Events](https://docs.aws.amazon.com/cli/latest/reference/events/put-events.html)。

每個 `PutEvents` 請求可支援有限數量的項目。如需詳細資訊，請參閱 [Amazon EventBridge 配額](eb-quota.md)。`PutEvents` 操作嘗試依照請求的自然順序處理所有項目。在您呼叫 `PutEvents` 之後，EventBridge 會為每個事件指派一個唯一的 ID。

在以下範例中，Java 程式碼將兩個相同的事件傳送至 EventBridge。

------
#### [ AWS SDK for Java Version 2.x ]

```
EventBridgeClient eventBridgeClient =
    EventBridgeClient.builder().build();

PutEventsRequestEntry requestEntry = PutEventsRequestEntry.builder()
    .resources("resource1", "resource2")
    .source("com.mycompany.myapp")
    .detailType("myDetailType")
    .detail("{ \"key1\": \"value1\", \"key2\": \"value2\" }")
    .build();

List <
PutEventsRequestEntry > requestEntries = new ArrayList <
PutEventsRequestEntry > ();
requestEntries.add(requestEntry);

PutEventsRequest eventsRequest = PutEventsRequest.builder()
    .entries(requestEntries)
    .build();

PutEventsResponse result = eventBridgeClient.putEvents(eventsRequest);

for (PutEventsResultEntry resultEntry: result.entries()) {
    if (resultEntry.eventId() != null) {
        System.out.println("Event Id: " + resultEntry.eventId());
    } else {
        System.out.println("PutEvents failed with Error Code: " + resultEntry.errorCode());
    }
}
```

------
#### [ AWS SDK for Java Version 1.0 ]

```
EventBridgeClient eventBridgeClient =
    EventBridgeClient.builder().build();
    
PutEventsRequestEntry requestEntry = new PutEventsRequestEntry()
        .withTime(new Date())
        .withSource("com.mycompany.myapp")
        .withDetailType("myDetailType")
        .withResources("resource1", "resource2")
        .withDetail("{ \"key1\": \"value1\", \"key2\": \"value2\" }");

PutEventsRequest request = new PutEventsRequest()
        .withEntries(requestEntry, requestEntry);

PutEventsResult result = awsEventsClient.putEvents(request);

for (PutEventsResultEntry resultEntry : result.getEntries()) {
    if (resultEntry.getEventId() != null) {
        System.out.println("Event Id: " + resultEntry.getEventId());
    } else {
        System.out.println("Injection failed with Error Code: " + resultEntry.getErrorCode());
    }
}
```

------

執行此程式碼之後，`PutEvents` 結果會包含回應項目的陣列。回應陣列中的每個項目按照從請求和回應的開始到結束的順序對應於請求陣列中的一個項目。回應 `Entries` 陣列通常包含與請求陣列相同數量的項目。

## 使用 `PutEvents` 處理失敗
<a name="eb-failure-handling"></a>

根據預設，如果要求中的個別項目失敗，EventBridge 會繼續處理要求中其餘的項目。回應 `Entries` 陣列可以同時包含成功和失敗的項目。您必須偵測未成功處理的項目，並將它們包含於後續呼叫中。

成功的結果項目包含一個 `Id` 值，不成功的結果項目包括 `ErrorCode` 和 `ErrorMessage` 值。`ErrorCode` 描述錯誤的類型。`ErrorMessage` 提供關於錯誤的詳細資訊。以下範例有 `PutEvents` 請求的三個結果項目。第二個項目不成功。

```
{
    "FailedEntryCount": 1, 
    "Entries": [
        {
            "EventId": "11710aed-b79e-4468-a20b-bb3c0c3b4860"
        },
        {   "ErrorCode": "InternalFailure",
            "ErrorMessage": "Internal Service Failure"
        },
        {
            "EventId": "d804d26a-88db-4b66-9eaf-9a11c708ae82"
        }
    ]
}
```

**注意**  
如果您使用 `PutEvents` 將事件發佈到不存在的事件匯流排，EventBridge 事件比對將找不到對應的規則，而且會捨棄該事件。雖然 EventBridge 會傳送 `200` 回應，但它不會讓要求失敗，也不會將事件包含在要求回應的 `FailedEntryCount` 值中。

未成功處理的項目可包含在後續的 `PutEvents` 請求中。首先，查看 `PutEventsResult` 中的 `FailedRecordCount` 參數以確認請求中是否有失敗的項目。如果其值非為零，您可以將具有非 null 值之 `ErrorCode` 中的每個 `Entry` 新增至後續請求中。以下範例顯示一個失敗處理常式。

```
PutEventsRequestEntry requestEntry = new PutEventsRequestEntry()
        .withTime(new Date())
        .withSource("com.mycompany.myapp")
        .withDetailType("myDetailType")
        .withResources("resource1", "resource2")
        .withDetail("{ \"key1\": \"value1\", \"key2\": \"value2\" }");

List<PutEventsRequestEntry> putEventsRequestEntryList = new ArrayList<>();
for (int i = 0; i < 3; i++) {
    putEventsRequestEntryList.add(requestEntry);
}

PutEventsRequest putEventsRequest = new PutEventsRequest();
putEventsRequest.withEntries(putEventsRequestEntryList);
PutEventsResult putEventsResult = awsEventsClient.putEvents(putEventsRequest);

while (putEventsResult.getFailedEntryCount() > 0) {
    final List<PutEventsRequestEntry> failedEntriesList = new ArrayList<>();
    final List<PutEventsResultEntry> PutEventsResultEntryList = putEventsResult.getEntries();
    for (int i = 0; i < PutEventsResultEntryList.size(); i++) {
        final PutEventsRequestEntry putEventsRequestEntry = putEventsRequestEntryList.get(i);
        final PutEventsResultEntry putEventsResultEntry = PutEventsResultEntryList.get(i);
        if (putEventsResultEntry.getErrorCode() != null) {
            failedEntriesList.add(putEventsRequestEntry);
        }
    }
    putEventsRequestEntryList = failedEntriesList;
    putEventsRequest.setEntries(putEventsRequestEntryList);
    putEventsResult = awsEventsClient.putEvents(putEventsRequest);
    }
```

## 使用 傳送事件 AWS CLI
<a name="eb-send-events-aws-cli"></a>

您可以使用 AWS CLI 將自訂事件傳送至 EventBridge，以便進行處理。以下範例將一個自訂事件放入 EventBridge：

```
aws events put-events \
--entries '[{"Time": "2016-01-14T01:02:03Z", "Source": "com.mycompany.myapp", "Resources": ["resource1", "resource2"], "DetailType": "myDetailType", "Detail": "{ \"key1\": \"value1\", \"key2\": \"value2\" }"}]'
```

您也可以建立包含自訂事件的 JSON 檔案。

```
[
  {
    "Time": "2016-01-14T01:02:03Z",
    "Source": "com.mycompany.myapp",
    "Resources": [
      "resource1",
      "resource2"
    ],
    "DetailType": "myDetailType",
    "Detail": "{ \"key1\": \"value1\", \"key2\": \"value2\" }"
  }
]
```

然後，若要使用 從此檔案 AWS CLI 讀取項目並傳送事件，請在命令提示字元中輸入：

```
aws events put-events --entries file://entries.json
```

## 計算 PutEvents 事件項目大小
<a name="eb-putevent-size"></a>

當您使用 `PutEvents`動作將自訂事件傳送至 EventBridge 時，您最多可以將 10 個事件項目批次處理為一個請求以提高效率。請求總大小，也就是請求中所有事件項目的總和，必須小於 1 MB。此限制適用於整個請求，不適用於個別項目。如果單一事件是請求中的唯一項目，則最多可以使用完整的 1 MB。您可以在傳送事件之前計算項目大小。



**注意**  
*項目*有大小的限制。即使項目小於大小限制，由於事件之 JSON 表示法的必要字元和鍵，EventBridge 中的*事件*始終大於項目大小。如需詳細資訊，請參閱 [Amazon EventBridge 中的事件](eb-events.md)。

EventBridge 會計算 `PutEventsRequestEntry` 大小，如下所示：
+ 如果已指定，`Time` 參數為 14 個位元。
+ `Source` 和 `DetailType` 參數為其 UTF-8 編碼表單的位元組數。
+ 如果已指定，`Detail` 參數為其 UTF-8 編碼表單的位元組數。
+ 如果已指定，`Resources` 參數的每個項目為其 UTF-8 編碼表單的位元組數。

以下範例 Java 程式碼會計算指定的 `PutEventsRequestEntry` 物件的大小：為了確認未違反 1MB 限制，您需要對請求中的所有事件執行計算。

```
int getSize(PutEventsRequestEntry entry) {
    int size = 0;
    if (entry.getTime() != null) {
        size += 14;
    }
    size += entry.getSource().getBytes(StandardCharsets.UTF_8).length;
    size += entry.getDetailType().getBytes(StandardCharsets.UTF_8).length;
    if (entry.getDetail() != null) {
        size += entry.getDetail().getBytes(StandardCharsets.UTF_8).length;
    }
    if (entry.getResources() != null) {
        for (String resource : entry.getResources()) {
            if (resource != null) {
                size += resource.getBytes(StandardCharsets.UTF_8).length;
            }
        }
    }
    return size;
}
```

**注意**  
如果項目大小大於 1MB，建議您將事件上傳至 Amazon S3 儲存貯體，並在`PutEvents`項目`Object URL`中包含 。

# EventBridge 如何重試交付事件
<a name="eb-rule-retry-policy"></a>

有時，[事件](eb-events.md)未成功交付至[規則](eb-rules.md)中指定的[目標](eb-targets.md)。這可能會發生，例如：
+ 如果目標資源無法使用
+ 由於網路條件

當事件因為可重新擷取的錯誤而未成功交付至目標時，EventBridge 會重試傳送事件。您可以設定嘗試的時間長度，以及目標的**重試政策**設定中重新嘗試的次數。在預設情況下，EventBridge 會重新嘗試傳送事件 24 小時且最多嘗試 185 次，並且具有[指數方式退避和*抖動*](https://aws.amazon.com/blogs/architecture/exponential-backoff-and-jitter/)或隨機延遲。

如果事件在所有重試嘗試都用盡之後仍未交付，則會捨棄該事件，且 EventBridge 不會繼續處理該事件。

為了避免在事件無法交付至目標後遺失事件，請設定無效字母佇列 (DLQ) 來接收所有失敗的事件。如需詳細資訊，請參閱[使用無效字母佇列來處理 EventBridge 中未傳遞的事件](eb-rule-dlq.md)。

# 使用無效字母佇列來處理 EventBridge 中未傳遞的事件
<a name="eb-rule-dlq"></a>

若要避免在無法交付至目標後遺失事件，您可以設定無效字母佇列 (DLQ)，並將所有失敗事件傳送至事件，以便稍後處理。

EventBridge DLQ 是標準的 Amazon SQS 佇列，EventBridge 用來儲存無法成功傳遞至目標的事件。建立規則並新增目標時，您可以選擇是否使用 DLQ。設定 DLQ 時，您可以保留任何未成功交付的事件。然後，您可以解決導致事件交付失敗的問題，並在稍後處理事件。

當您為規則的目標設定 DLQ 時，EventBridge 會將調用失敗的事件傳送至選取的 Amazon SQS 佇列。

事件錯誤以不同的方式進行處理。有些事件會捨棄或傳送至 DLQ，而不會嘗試任何重試。例如，對於遺失對目標的許可、不再存在的目標資源，或由於無效地址或 DNS 查詢失敗而找不到的目標所造成的錯誤，在採取動作來解決基礎問題之前，不會重試。如果您已指定這些事件， 會直接將這些事件 EventBridge 傳送至目標 DLQ。

當事件交付失敗時，EventBridge 會將事件發佈至 Amazon CloudWatch 指標，指出目標 `invocation` 失敗。如果您使用 DLQ，則會將其他指標傳送至 CloudWatch，包括 `InvocationsSentToDLQ` 和 `InvocationsFailedToBeSentToDLQ`。

如果您使用 AWS KMS 客戶受管金鑰 加密靜態事件，也可以指定事件匯流排DLQs。如需詳細資訊，請參閱[使用無效字母佇列擷取 EventBridge 中的加密事件錯誤](eb-encryption-event-bus-dlq.md)。

DLQ 中的每則訊息都會包含下列自訂屬性：
+ `RULE_ARN`
+ `TARGET_ARN`
+ `ERROR_CODE`

  以下是 DLQ 可傳回的錯誤代碼範例：
  + `ACTION_DECRYPTION_FAILURE`
  + `CONNECTION_FAILURE`
  + `CROSS_ACCOUNT_INGESTION_FAILED`
  + `CROSS_REGION_INGESTION_FAILED`
  + `ERROR_FROM_TARGET`
  + `EVENT_DECRYPTION_FAILURE`
  + `EVENT_ENCRYPTION_FAILURE`
  + `EVENTS_IN_BATCH_REQUEST_REJECTED`
  + `FAILED_TO_ASSUME_ROLE`
  + `INTERNAL_ERROR`
  + `INVALID_JSON`
  + `INVALID_PARAMETER`
  + `NO_PERMISSIONS`
  + `NO_RESOURCE`
  + `RESOURCE_ALREADY_EXISTS`
  + `RESOURCE_LIMIT_EXCEEDED`
  + `RESOURCE_MODIFICATION_COLLISION`
  + `RULE_DECRYPTION_FAILURE`
  + `SDK_CLIENT_ERROR`
  + `THIRD_ACCOUNT_HOP_DETECTED`
  + `THIRD_REGION_HOP_DETECTED`
  + `THROTTLING`
  + `TIMEOUT`
  + `TRANSIENT_ASSUME_ROLE`
  + `UNKNOWN`
+ `ERROR_MESSAGE`
+ `EXHAUSTED_RETRY_CONDITION`

  可能回傳以下條件：
  + `MaximumRetryAttempts`
  + `MaximumEventAgeInSeconds`
+ `RETRY_ATTEMPTS`

 以下影片會介紹如何設定 DLQs：




**Topics**
+ [

## 使用無效字母佇列的考量
](#eb-dlq-considerations)
+ [

## 將許可授予無效字母佇列
](#eb-dlq-perms)
+ [

## 如何從無效字母佇列重新傳送事件
](#eb-dlq-resend)

## 使用無效字母佇列的考量
<a name="eb-dlq-considerations"></a>

設定 EventBridge 的 DLQ 時請考量下列事項。
+ 僅支援[標準佇列](https://docs.aws.amazon.com//AWSSimpleQueueService/latest/SQSDeveloperGuide/standard-queues.html)。您無法在 EventBridge 中將 FIFO 佇列用於 DLQ。
+ EventBridge 在訊息中包含事件中繼資料和訊息屬性，包括：錯誤碼、錯誤訊息、用盡重試條件、規則 ARN、重試嘗試次數和目標 ARN。您可以使用這些值來識別事件和失敗原因。
+ 相同帳戶中 DLQ 的許可：
  + 如果您使用主控台將目標新增至規則，並在同一帳戶中選擇 Amazon SQS 佇列，則會將授予 EventBridge 存取佇列的[資源型政策](eb-use-resource-based.md)附加至佇列。
  + 如果您使用 EventBridge API 的 `PutTargets` 操作來新增或更新規則的目標，並在同一帳戶中選取 Amazon SQS 佇列，則必須手動授予所選取佇列的許可。如需詳細資訊，請參閱 [將許可授予無效字母佇列](#eb-dlq-perms)。
+ 從不同 AWS 帳戶使用 Amazon SQS 佇列的許可。
  + 如果您從主控台建立規則，則不會顯示來自其他帳戶的佇列供您選取。您必須為其他帳戶中的佇列提供 ARN，然後手動附加以資源為基礎的政策，以授予佇列的許可。如需詳細資訊，請參閱 [將許可授予無效字母佇列](#eb-dlq-perms)。
  + 如果您使用 API 建立規則，則必須手動將以資源為基礎的政策附加到另一個帳戶中作為無效字母佇列的 SQS 佇列。如需詳細資訊，請參閱 [將許可授予無效字母佇列](#eb-dlq-perms)。
+ 您使用的 Amazon SQS 佇列必須位於建立規則的相同區域。

## 將許可授予無效字母佇列
<a name="eb-dlq-perms"></a>

若要成功將事件交付至佇列，EventBridge 必須擁有執行此動作的許可。當您使用 EventBridge 主控台指定 DLQ 時，會自動新增許可。其中包含：
+ 當您為規則的目標設定 DLQ 時。
+ 當您為已指定 EventBridge 使用 AWS KMS 客戶受管金鑰 加密靜態事件的事件匯流排設定 DLQ 時。

  如需詳細資訊，請參閱[使用無效字母佇列擷取 EventBridge 中的加密事件錯誤](eb-encryption-event-bus-dlq.md)。

 如果您使用 API 指定 DLQ，或使用不同 AWS 帳戶中的佇列，則必須手動建立以資源為基礎的政策，以授予所需的許可，然後將其連接到佇列。

**目標無效字母佇列許可範例**

以下以資源為基礎的政策示範如何授予 EventBridge 將事件訊息傳送至 Amazon SQS 佇列的必要許可。此政策範例會授予 EventBridge 服務許可，以便使用 `SendMessage` 操作將訊息傳送至名為「MyEventDLQ」的佇列。佇列必須位於 AWS 帳戶 123456789012 中的 us-west-2 區域。`Condition` 陳述式僅允許來自名為 "MyTestRule" 的規則的請求，該規則是在 AWS 帳戶 123456789012 的 us-west-2 區域中建立的。

```
{
  "Sid": "Dead-letter queue permissions",
  "Effect": "Allow",
  "Principal": {
     "Service": "events.amazonaws.com"
  },
  "Action": "sqs:SendMessage",
  "Resource": "arn:aws:sqs:us-west-2:123456789012:MyEventDLQ",
  "Condition": {
    "ArnEquals": {
      "aws:SourceArn": "arn:aws:events:us-west-2:123456789012:rule/MyTestRule"
    }
  }
}
```

**事件匯流排無效字母佇列許可範例**

下列資源型政策示範如何在為事件匯流排指定 DLQ 時授予所需的許可。在此情況下， 會`aws:SourceArn`指定將事件傳送至 DLQ 的事件匯流排 ARN。在此範例中，佇列必須與事件匯流排位於相同的區域。

```
{
  "Sid": "Dead-letter queue permissions",
  "Effect": "Allow",
  "Principal": {
     "Service": "events.amazonaws.com"
  },
  "Action": "sqs:SendMessage",
  "Resource": "arn:aws:sqs:region:account-id:queue-name",
  "Condition": {
    "ArnEquals": {
      "aws:SourceArn": "arn:aws:events:region:account-id:event-bus/event-bus-arn"
    }
  }
}
```

若要將政策附加到佇列，請使用 Amazon SQS 主控台，開啟佇列，然後選擇**存取政策**並編輯政策。您也可以使用 AWS CLI。如需詳細資訊，請參閱 [Amazon SQS 許可](eb-use-resource-based.md#eb-sqs-permissions)。

## 如何從無效字母佇列重新傳送事件
<a name="eb-dlq-resend"></a>

您可以以下列兩種方式將訊息從無效字母佇列中移出：
+ 避免編寫 Amazon SQS 消費者邏輯 - 將無效字母佇列設為 Lambda 函數的事件來源，以耗盡無效字母佇列。
+ 寫入 Amazon SQS 消費者邏輯 – 使用 Amazon SQS API、 AWS SDK 或 AWS CLI 撰寫自訂消費者邏輯，以輪詢、處理和刪除 DLQ 中的訊息。

# AWS 透過 傳遞的服務事件 AWS CloudTrail
<a name="eb-service-event-cloudtrail"></a>

 AWS CloudTrail 是一種服務，可自動記錄 AWS API 呼叫等事件。您可以建立 EventBridge 規則，以使用 CloudTrail 的資訊。如需 CloudTrail 的詳細資訊，請參閱[什麼是 AWS CloudTrail？](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html)。

CloudTrail 會將下列類型的事件傳送至預設 EventBridge 事件匯流排。在每個案例中，事件`detail-type`的值都是列出的事件類型：
+ `AWS API Call via CloudTrail`

  代表公有 AWS 服務 API 請求的事件。

  如需詳細資訊，請參閱*AWS CloudTrail 《 使用者指南*》中的[了解 CloudTrail 事件](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-events.html)。
+ `AWS Console Signin via CloudTrail`

  嘗試登入 AWS 管理主控台、 AWS 開發論壇和 AWS 支援中心。

  如需詳細資訊，請參閱*AWS CloudTrail 《 使用者指南*》中的[AWS 管理主控台登入事件](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-aws-console-sign-in-events.html)。
+ `AWS Console Action via CloudTrail`

  在主控台中採取的動作不是 API 呼叫。

  如需詳細資訊，請參閱*AWS CloudTrail 《 使用者指南*》中的[AWS 管理主控台登入事件](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-aws-console-sign-in-events.html)。
+ `AWS Service Event via CloudTrail`

  由 AWS 服務建立但未由公有 AWS 服務 API 請求直接觸發的事件。

  如需詳細資訊，請參閱*AWS CloudTrail 《 使用者指南*》中的[AWS 服務事件](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/non-api-aws-service-events.html)。
+ `AWS Insight via CloudTrail`

  當客戶啟用 CloudTrail Insight 功能時，CloudTrail 會觸發 Insights 事件。

  如需詳細資訊，請參閱*AWS CloudTrail 《 使用者指南*》中的 [CloudTrail Insights](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-insight-details.html)。

若要使用其中一個 CloudTrail `detail-type`值記錄事件，您必須啟用具有記錄的 CloudTrail 追蹤。如需詳細資訊，請參閱*AWS CloudTrail 《 使用者指南*》中的[使用 CloudTrail 追蹤](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-trails.html)。

 AWS 服務本身和 CloudTrail 都可以向 EventBridge 報告某些事件。例如，啟動執行個體的 Amazon EC2 API 呼叫會產生多個事件：
+ `EC2 Instance State-change Notification` 當執行個體進入 `pending`，然後進入 `running` 狀態時，直接從 Amazon EC2 傳送至 EventBridge 的事件。例如：

  ```
  {
      . . . 
     "detail-type":"EC2 Instance State-change Notification",
     "source":"aws.ec2",
      . . . 
     "detail":{
        "instance-id":"i-abcd1111",
        "state":"pending"
     }
  }
  ```
+ 從 CloudTrail 傳送至 EventBridge `AWS API Call via CloudTrail`的事件，代表 API 呼叫本身。例如：

  ```
  {
      . . . 
     "detail-type":"AWS API Call via CloudTrail",
     "source":"aws.ec2",
      . . . 
     ],
    "detail": {
      "eventSource": "ec2.amazonaws.com",
      "eventName": "StartInstances"
      }
  }
  ```

**注意**  
如果您使用 `Put*Events` API 呼叫事件做為建立事件模式的基礎，請確定最終事件模式不超過 1 MB。任何`Put*Events`請求的大小上限為 1 MB。如需詳細資訊，請參閱[](eb-putevents.md)。

如需有關 CloudTrail 支援之服務的詳細資訊，請參閱[CloudTrail 使用者指南》中的 CloudTrail 支援的服務和整合](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html)。 *CloudTrail *

# 從 AWS 服務接收唯讀管理事件
<a name="eb-service-event-cloudtrail-management"></a>

您可以在預設或自訂事件匯流排上設定規則，透過 CloudTrail 從 AWS 服務接收唯讀*管理事件*。管理事件可讓您查看在 AWS 帳戶中資源上執行的管理操作。這些也稱為控制平面操作。如需詳細資訊，請參閱《CloudTrail 使用者指南》**中的[記錄管理事件](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html#logging-management-events)。

針對有關預設或自訂事件匯流排的每個規則，您可以設定規則狀態來控制要接收的事件類型：
+ 停用規則，讓 EventBridge 不符合規則的事件。
+ 啟用規則，讓 EventBridge 符合規則的事件，但透過 傳遞的唯讀 AWS 管理事件除外 CloudTrail。
+ 啟用規則，讓 EventBridge 符合規則的所有事件，*包括*透過 傳遞的唯讀管理事件 CloudTrail。

合作夥伴事件匯流排不會接收 AWS 事件。

決定是否接收唯讀管理事件時需要考量的一些事項：
+ 某些唯讀管理事件，例如 AWS Key Management Service `GetKeyPolicy` 和 `DescribeKey`，或 IAM `GetPolicy`和 `GetRole`事件，其發生量遠高於一般變更事件。
+ 您可能已經收到唯讀管理事件`Get`，即使這些事件的開頭不是 `Describe`、 或 `List`。其中一個範例來自 `TestEventPattern` EventBridge。

  如需依 AWS 服務不符合 `Describe`、 `Get`或 `List` 命名慣例的唯讀管理事件清單，請參閱 [EventBridge 中 AWS 服務產生的管理事件](eb-service-management-event-list.md)。

**使用 CLI AWS 建立接收唯讀管理事件的規則**
+ 使用 `put-rule` 指令建立或更新規則，並使用參數執行下列作業：
  + 指定規則屬於預設事件匯流排或特定自訂事件匯流排
  + 將規則狀態設為 `ENABLED_WITH_ALL_CLOUDTRAIL_MANAGEMENT_EVENTS`

  `aws events put-rule --name "ruleForManagementEvents" --event-bus-name "default" --state "ENABLED_WITH_ALL_CLOUDTRAIL_MANAGEMENT_EVENTS"`

**注意**  
僅支援透過 CLI 和 CloudFormation 範本啟用 CloudWatch AWS 管理事件的規則。

**Example**  
下列範例說明如何與特定事件進行比對。最佳實務是為比對特定事件定義專用規則，以保持清晰和易於編輯。  
在此情況下，專用規則會比對來自 的`AssumeRole`管理事件 AWS Security Token Service。  

```
{
    "source" : [ "aws.sts" ],
    "detail-type": ["AWS API Call via CloudTrail"],
    "detail" : {
        "eventName" : ["AssumeRole"]
    }
}
```

# EventBridge 中 AWS 服務產生的管理事件
<a name="eb-service-management-event-list"></a>

一般而言，產生管理 (或唯讀) 事件的 API 會以動詞 `Describe`、`Get` 或 `List` 開頭。下表列出其產生的不遵循此命名慣例 AWS 的服務和管理事件。如需管理事件的詳細資訊，請參閱 [從 AWS 服務接收唯讀管理事件](eb-service-event-cloudtrail-management.md)。

## 不是以 `Describe`、`Get` 或 `List` 開頭的管理事件
<a name="eb-service-management-table-list"></a>

下表列出 AWS 服務和其產生的管理事件，這些事件不遵循以 `Describe`、 `Get`或 開頭的典型命名慣例`List`。


| 服務 | 事件名稱 | 事件類型 | 
| --- | --- | --- | 
| 企業版 Alexa | ResolveRoom | API 呼叫 | 
| 企業版 Alexa | SearchAddressBooks | API 呼叫 | 
| 企業版 Alexa | SearchContacts | API 呼叫 | 
| 企業版 Alexa | SearchDevices | API 呼叫 | 
| 企業版 Alexa | SearchProfiles | API 呼叫 | 
| 企業版 Alexa | SearchRooms | API 呼叫 | 
| 企業版 Alexa | SearchSkillGroups | API 呼叫 | 
| 企業版 Alexa | SearchUsers | API 呼叫 | 
| IAM Access Analyzer | ValidatePolicy | API 呼叫 | 
| AWS AdSpace 無塵室 | BatchGetSchema | API 呼叫 | 
| AWS Amplify UI Builder | ExportComponents | API 呼叫 | 
| AWS Amplify UI Builder | ExportForms | API 呼叫 | 
| AWS Amplify UI Builder | ExportThemes | API 呼叫 | 
| Amazon OpenSearch Service | BatchGetCollection | API 呼叫 | 
| Amazon API Gateway | ExportApi | API 呼叫 | 
| AWS AppConfig | ValidateConfiguration | API 呼叫 | 
| Amazon AppFlow | RetrieveConnectorData | API 呼叫 | 
| Amazon CloudWatch Application Insights | UpdateApplicationDashboardConfiguration | API 呼叫 | 
| Amazon Athena | BatchGetNamedQuery | API 呼叫 | 
| Amazon Athena | BatchGetPreparedStatement | API 呼叫 | 
| Amazon Athena | BatchGetQueryExecution | API 呼叫 | 
| Amazon Athena | CheckQueryCompatibility | API 呼叫 | 
| Amazon Athena | ExportNotebook | API 呼叫 | 
| AWS Auto Scaling | AreScalableTargetsRegistered | API 呼叫 | 
| AWS Auto Scaling | 測試 | API 呼叫 | 
| AWS Marketplace | SearchAgreements | API 呼叫 | 
| AWS Backup | CreateLegalHold | API 呼叫 | 
| AWS Backup | ExportBackupPlanTemplate | API 呼叫 | 
| AWS Backup gateway | TestHypervisorConfiguration | API 呼叫 | 
| AWS 帳單與成本管理 | AWSPaymentInstrumentGateway.Get | 主控台動作 | 
| AWS 帳單與成本管理 | AWSPaymentPortalService.DescribeMakePaymentPage | 主控台動作 | 
| AWS 帳單與成本管理 | AWSPaymentPortalService.DescribePaymentsDashboard | 主控台動作 | 
| AWS 帳單與成本管理 | AWSPaymentPortalService.GetAccountPreferences | 主控台動作 | 
| AWS 帳單與成本管理 | AWSPaymentPortalService.GetAdvancePaySummary | 主控台動作 | 
| AWS 帳單與成本管理 | AWSPaymentPortalService.GetAsoBulkDownload | 主控台動作 | 
| AWS 帳單與成本管理 | AWSPaymentPortalService.GetBillingContactAddress | 主控台動作 | 
| AWS 帳單與成本管理 | AWSPaymentPortalService.GetDocuments | 主控台動作 | 
| AWS 帳單與成本管理 | AWSPaymentPortalService.GetEligiblePaymentInstruments | 主控台動作 | 
| AWS 帳單與成本管理 | AWSPaymentPortalService.GetEntitiesByIds | 主控台動作 | 
| AWS 帳單與成本管理 | AWSPaymentPortalService.GetFundingDocuments | 主控台動作 | 
| AWS 帳單與成本管理 | AWSPaymentPortalService.GetKybcValidationStatus | 主控台動作 | 
| AWS 帳單與成本管理 | AWSPaymentPortalService.GetOneTimePasswordStatus | 主控台動作 | 
| AWS 帳單與成本管理 | AWSPaymentPortalService.GetPaymentHistory | 主控台動作 | 
| AWS 帳單與成本管理 | AWSPaymentPortalService.GetPaymentProfileByArn | 主控台動作 | 
| AWS 帳單與成本管理 | AWSPaymentPortalService.GetPaymentProfileCurrencies | 主控台動作 | 
| AWS 帳單與成本管理 | AWSPaymentPortalService.GetPaymentProfiles | 主控台動作 | 
| AWS 帳單與成本管理 | AWSPaymentPortalService.GetPaymentProfileServiceProviders | 主控台動作 | 
| AWS 帳單與成本管理 | AWSPaymentPortalService.GetPaymentsDue | 主控台動作 | 
| AWS 帳單與成本管理 | AWSPaymentPortalService.GetRemittanceInformation | 主控台動作 | 
| AWS 帳單與成本管理 | AWSPaymentPortalService.GetTaxInvoiceMetadata | 主控台動作 | 
| AWS 帳單與成本管理 | AWSPaymentPortalService.GetTermsAndConditionsForProgramGroup | 主控台動作 | 
| AWS 帳單與成本管理 | AWSPaymentPortalService.GetTransactionsHistory | 主控台動作 | 
| AWS 帳單與成本管理 | AWSPaymentPortalService.GetUnappliedFunds | 主控台動作 | 
| AWS 帳單與成本管理 | AWSPaymentPortalService.GetUnpaidInvoices | 主控台動作 | 
| AWS 帳單與成本管理 | AWSPaymentPreferenceGateway.Get | 主控台動作 | 
| AWS 帳單與成本管理 | CancelBulkDownload | 主控台動作 | 
| AWS 帳單與成本管理 | DownloadCommercialInvoice | 主控台動作 | 
| AWS 帳單與成本管理 | DownloadCsv | 主控台動作 | 
| AWS 帳單與成本管理 | DownloadDoc | 主控台動作 | 
| AWS 帳單與成本管理 | DownloadECSVForBillingPeriod | 主控台動作 | 
| AWS 帳單與成本管理 | DownloadPaymentHistory | 主控台動作 | 
| AWS 帳單與成本管理 | DownloadRegistrationDocument | 主控台動作 | 
| AWS 帳單與成本管理 | DownloadTaxInvoice | 主控台動作 | 
| AWS 帳單與成本管理 | FindBankRedirectPaymentInstruments | 主控台動作 | 
| AWS 帳單與成本管理 | FindECSVForBillingPeriod | 主控台動作 | 
| AWS 帳單與成本管理 | ValidateReportDestination | 主控台動作 | 
| AWS 帳單與成本管理 | VerifyChinaPaymentEligibility | 主控台動作 | 
| Amazon Braket | SearchCompilations | API 呼叫 | 
| Amazon Braket | SearchDevices | API 呼叫 | 
| Amazon Braket | SearchQuantumTasks | API 呼叫 | 
| Amazon Connect Cases | BatchGetField | API 呼叫 | 
| Amazon Connect Cases | SearchCases | API 呼叫 | 
| Amazon Connect Cases | SearchRelatedItems | API 呼叫 | 
| Amazon Chime | RetrieveDataExports | API 呼叫 | 
| Amazon Chime | SearchChannels | API 呼叫 | 
| Amazon Chime SDK 身分 | DeleteProfile | 服務事件 | 
| Amazon Chime SDK 身分 | DeleteWorkTalkAccount | 服務事件 | 
| AWS Clean 房間 | BatchGetSchema | API 呼叫 | 
| Amazon 雲端目錄 | BatchRead | API 呼叫 | 
| Amazon 雲端目錄 | LookupPolicy | API 呼叫 | 
| CloudFormation | DetectStackDrift | API 呼叫 | 
| CloudFormation | DetectStackResourceDrift | API 呼叫 | 
| CloudFormation | DetectStackSetDrift | API 呼叫 | 
| CloudFormation | EstimateTemplateCost | API 呼叫 | 
| CloudFormation | ValidateTemplate | API 呼叫 | 
| AWS CloudShell | RedeemCode | API 呼叫 | 
| AWS CloudTrail | LookupEvents | API 呼叫 | 
| AWS CodeArtifact | ReadFromRepository | API 呼叫 | 
| AWS CodeArtifact | SearchPackages | API 呼叫 | 
| AWS CodeArtifact | VerifyResourcesExistForTagris | API 呼叫 | 
| AWS CodeBuild | BatchGetBuildBatches | API 呼叫 | 
| AWS CodeBuild | BatchGetBuilds | API 呼叫 | 
| AWS CodeBuild | BatchGetProjects | API 呼叫 | 
| AWS CodeBuild | BatchGetReportGroups | API 呼叫 | 
| AWS CodeBuild | BatchGetReports | API 呼叫 | 
| AWS CodeBuild | BatchPutCodeCoverages | API 呼叫 | 
| AWS CodeBuild | BatchPutTestCases | API 呼叫 | 
| AWS CodeBuild | RequestBadge | 服務事件 | 
| AWS CodeCommit | BatchDescribeMergeConflicts | API 呼叫 | 
| AWS CodeCommit | BatchGetCommits | API 呼叫 | 
| AWS CodeCommit | BatchGetPullRequests | API 呼叫 | 
| AWS CodeCommit | BatchGetRepositories | API 呼叫 | 
| AWS CodeCommit | EvaluatePullRequestApprovalRules | API 呼叫 | 
| AWS CodeCommit | GitPull | API 呼叫 | 
| AWS CodeDeploy | BatchGetApplicationRevisions | API 呼叫 | 
| AWS CodeDeploy | BatchGetApplications | API 呼叫 | 
| AWS CodeDeploy | BatchGetDeploymentGroups | API 呼叫 | 
| AWS CodeDeploy | BatchGetDeploymentInstances | API 呼叫 | 
| AWS CodeDeploy | BatchGetDeployments | API 呼叫 | 
| AWS CodeDeploy | BatchGetDeploymentTargets | API 呼叫 | 
| AWS CodeDeploy | BatchGetOnPremisesInstances | API 呼叫 | 
| Amazon CodeGuru Profiler | BatchGetFrameMetricData | API 呼叫 | 
| Amazon CodeGuru Profiler | SubmitFeedback | API 呼叫 | 
| AWS CodePipeline | PollForJobs | API 呼叫 | 
| AWS CodePipeline | PollForThirdPartyJobs | API 呼叫 | 
| CodeConnections | StartAppRegistrationHandshake | API 呼叫 | 
| CodeConnections | StartOAuthHandshake | API 呼叫 | 
| CodeConnections | ValidateHostWebhook | API 呼叫 | 
| Amazon CodeWhisperer | CreateCodeScan | API 呼叫 | 
| Amazon CodeWhisperer | CreateProfile | API 呼叫 | 
| Amazon CodeWhisperer | CreateUploadUrl | API 呼叫 | 
| Amazon CodeWhisperer | GenerateRecommendations | API 呼叫 | 
| Amazon CodeWhisperer | UpdateProfile | API 呼叫 | 
| Amazon Cognito 身分 | LookupDeveloperIdentity | API 呼叫 | 
| Amazon Cognito 使用者集區 | AdminGetDevice | API 呼叫 | 
| Amazon Cognito 使用者集區 | AdminGetUser | API 呼叫 | 
| Amazon Cognito 使用者集區 | AdminListDevices | API 呼叫 | 
| Amazon Cognito 使用者集區 | AdminListGroupsForUser | API 呼叫 | 
| Amazon Cognito 使用者集區 | AdminListUserAuthEvents | API 呼叫 | 
| Amazon Cognito 使用者集區 | Beta\$1Authorize\$1GET | 服務事件 | 
| Amazon Cognito 使用者集區 | Confirm\$1GET | 服務事件 | 
| Amazon Cognito 使用者集區 | ConfirmForgotPassword\$1GET | 服務事件 | 
| Amazon Cognito 使用者集區 | Error\$1GET | 服務事件 | 
| Amazon Cognito 使用者集區 | ForgotPassword\$1GET | 服務事件 | 
| Amazon Cognito 使用者集區 | IntrospectToken | API 呼叫 | 
| Amazon Cognito 使用者集區 | Login\$1Error\$1POST | 服務事件 | 
| Amazon Cognito 使用者集區 | Login\$1GET | 服務事件 | 
| Amazon Cognito 使用者集區 | Mfa\$1GET | 服務事件 | 
| Amazon Cognito 使用者集區 | MfaOption\$1GET | 服務事件 | 
| Amazon Cognito 使用者集區 | ResetPassword\$1GET | 服務事件 | 
| Amazon Cognito 使用者集區 | Signup\$1GET | 服務事件 | 
| Amazon Cognito 使用者集區 | UserInfo\$1GET | 服務事件 | 
| Amazon Cognito 使用者集區 | UserInfo\$1POST | 服務事件 | 
| Amazon Cognito Sync | BulkPublish | API 呼叫 | 
| Amazon Comprehend | BatchContainsPiiEntities | API 呼叫 | 
| Amazon Comprehend | BatchDetectDominantLanguage | API 呼叫 | 
| Amazon Comprehend | BatchDetectEntities | API 呼叫 | 
| Amazon Comprehend | BatchDetectKeyPhrases | API 呼叫 | 
| Amazon Comprehend | BatchDetectPiiEntities | API 呼叫 | 
| Amazon Comprehend | BatchDetectSentiment | API 呼叫 | 
| Amazon Comprehend | BatchDetectSyntax | API 呼叫 | 
| Amazon Comprehend | BatchDetectTargetedSentiment | API 呼叫 | 
| Amazon Comprehend | ClassifyDocument | API 呼叫 | 
| Amazon Comprehend | ContainsPiiEntities | API 呼叫 | 
| Amazon Comprehend | DetectDominantLanguage | API 呼叫 | 
| Amazon Comprehend | DetectEntities | API 呼叫 | 
| Amazon Comprehend | DetectKeyPhrases | API 呼叫 | 
| Amazon Comprehend | DetectPiiEntities | API 呼叫 | 
| Amazon Comprehend | DetectSentiment | API 呼叫 | 
| Amazon Comprehend | DetectSyntax | API 呼叫 | 
| Amazon Comprehend | DetectTargetedSentiment | API 呼叫 | 
| Amazon Comprehend | DetectToxicContent | API 呼叫 | 
| AWS Compute Optimizer | ExportAutoScalingGroupRecommendations | API 呼叫 | 
| AWS Compute Optimizer | ExportEBSVolumeRecommendations | API 呼叫 | 
| AWS Compute Optimizer | ExportECInstanceRecommendations | API 呼叫 | 
| AWS Compute Optimizer | ExportECSServiceRecommendations | API 呼叫 | 
| AWS Compute Optimizer | ExportLambdaFunctionRecommendations | API 呼叫 | 
| AWS Compute Optimizer | ExportRDSInstanceRecommendations | API 呼叫 | 
| AWS Config | BatchGetAggregateResourceConfig | API 呼叫 | 
| AWS Config | BatchGetResourceConfig | API 呼叫 | 
| AWS Config | SelectAggregateResourceConfig | API 呼叫 | 
| AWS Config | SelectResourceConfig | API 呼叫 | 
| Amazon Connect | AdminGetEmergencyAccessToken | API 呼叫 | 
| Amazon Connect | SearchQueues | API 呼叫 | 
| Amazon Connect | SearchRoutingProfiles | API 呼叫 | 
| Amazon Connect | SearchSecurityProfiles | API 呼叫 | 
| Amazon Connect | SearchUsers | API 呼叫 | 
| AWS Glue DataBrew | SendProjectSessionAction | API 呼叫 | 
| AWS Data Pipeline | EvaluateExpression | API 呼叫 | 
| AWS Data Pipeline | QueryObjects | API 呼叫 | 
| AWS Data Pipeline | ValidatePipelineDefinition | API 呼叫 | 
| AWS DataSync | VerifyResourcesExistForTagris | API 呼叫 | 
| AWS DeepLens | BatchGetDevice | API 呼叫 | 
| AWS DeepLens | BatchGetModel | API 呼叫 | 
| AWS DeepLens | BatchGetProject | API 呼叫 | 
| AWS DeepLens | CreateDeviceCertificates | API 呼叫 | 
| AWS DeepRacer | AdminGetAccountConfig | API 呼叫 | 
| AWS DeepRacer | AdminListAssociatedUsers | API 呼叫 | 
| AWS DeepRacer | TestRewardFunction | API 呼叫 | 
| AWS DeepRacer | VerifyResourcesExistForTagris | API 呼叫 | 
| Amazon Detective | BatchGetGraphMemberDatasources | API 呼叫 | 
| Amazon Detective | BatchGetMembershipDatasources | API 呼叫 | 
| Amazon Detective | SearchGraph | API 呼叫 | 
| Amazon DevOps Guru | SearchInsights | API 呼叫 | 
| Amazon DevOps Guru | SearchOrganizationInsights | API 呼叫 | 
| AWS Database Migration Service | BatchStartRecommendations | API 呼叫 | 
| AWS Database Migration Service | ModifyRecommendation | API 呼叫 | 
| AWS Database Migration Service | StartRecommendations | API 呼叫 | 
| AWS Database Migration Service | VerifyResourcesExistForTagris | API 呼叫 | 
| AWS Directory Service | VerifyTrust | API 呼叫 | 
| Amazon Elastic Compute Cloud | ConfirmProductInstance | API 呼叫 | 
| Amazon Elastic Compute Cloud | ReportInstanceStatus | API 呼叫 | 
| Amazon Elastic Container Registry | BatchCheckLayerAvailability | API 呼叫 | 
| Amazon Elastic Container Registry | BatchGetImage | API 呼叫 | 
| Amazon Elastic Container Registry | BatchGetImageReferrer | API 呼叫 | 
| Amazon Elastic Container Registry | BatchGetRepositoryScanningConfiguration | API 呼叫 | 
| Amazon Elastic Container Registry | DryRunEvent | 服務事件 | 
| Amazon Elastic Container Registry | PolicyExecutionEvent | 服務事件 | 
| Amazon Elastic Container Registry Public | BatchCheckLayerAvailability | API 呼叫 | 
| Amazon Elastic Container Service | DiscoverPollEndpoint | API 呼叫 | 
| Amazon Elastic Container Service | FindSubfleetRoute | API 呼叫 | 
| Amazon Elastic Container Service | ValidateResources | API 呼叫 | 
| Amazon Elastic Container Service | VerifyTaskSetsExist | API 呼叫 | 
| Amazon Elastic Kubernetes Service | AccessKubernetesApi | API 呼叫 | 
| AWS Elastic Beanstalk | CheckDNSAvailability | API 呼叫 | 
| AWS Elastic Beanstalk | RequestEnvironmentInfo | API 呼叫 | 
| AWS Elastic Beanstalk | RetrieveEnvironmentInfo | API 呼叫 | 
| AWS Elastic Beanstalk | ValidateConfigurationSettings | API 呼叫 | 
| Amazon Elastic File System | NewClientConnection | 服務事件 | 
| Amazon Elastic File System | UpdateClientConnection | 服務事件 | 
| Amazon Elastic Transcoder | ReadJob | API 呼叫 | 
| Amazon Elastic Transcoder | ReadPipeline | API 呼叫 | 
| Amazon Elastic Transcoder | ReadPreset | API 呼叫 | 
| Amazon EventBridge | TestEventPattern | API 呼叫 | 
| Amazon EventBridge | TestScheduleExpression | API 呼叫 | 
| Amazon FinSpace API | BatchListCatalogNodesByDataset | API 呼叫 | 
| Amazon FinSpace API | BatchListNodesByDataset | API 呼叫 | 
| Amazon FinSpace API | BatchValidateAccess | API 呼叫 | 
| Amazon FinSpace API | CreateAuditRecordsQuery | API 呼叫 | 
| Amazon FinSpace API | SearchDatasets | API 呼叫 | 
| Amazon FinSpace API | SearchDatasetsV | API 呼叫 | 
| Amazon FinSpace API | ValidateIdToken | API 呼叫 | 
| AWS Firewall Manager | DisassociateAdminAccount | API 呼叫 | 
| Amazon Forecast | InvokeForecastEndpoint | API 呼叫 | 
| Amazon Forecast | QueryFeature | API 呼叫 | 
| Amazon Forecast | QueryForecast | API 呼叫 | 
| Amazon Forecast | QueryWhatIfForecast | API 呼叫 | 
| Amazon Forecast | VerifyResourcesExistForTagris | API 呼叫 | 
| Amazon Fraud Detector | BatchGetVariable | API 呼叫 | 
| Amazon Fraud Detector | VerifyResourcesExistForTagris | API 呼叫 | 
| FreeRTOS | VerifyEmailAddress | API 呼叫 | 
| Amazon GameLift Servers | RequestUploadCredentials | API 呼叫 | 
| Amazon GameLift Servers | ResolveAlias | API 呼叫 | 
| Amazon GameLift Servers | SearchGameSessions | API 呼叫 | 
| Amazon GameLift Servers | ValidateMatchmakingRuleSet | API 呼叫 | 
| Amazon GameSparks | ExportSnapshot | API 呼叫 | 
| Amazon Location Service | BatchGetDevicePosition | API 呼叫 | 
| Amazon Location Service | CalculateRoute | API 呼叫 | 
| Amazon Location Service | CalculateRouteMatrix | API 呼叫 | 
| Amazon Location Service | SearchPlaceIndexForPosition | API 呼叫 | 
| Amazon Location Service | SearchPlaceIndexForSuggestions | API 呼叫 | 
| Amazon Location Service | SearchPlaceIndexForText | API 呼叫 | 
| Amazon Glacier | InitiateJob | API 呼叫 | 
| AWS Glue | BatchGetBlueprints | API 呼叫 | 
| AWS Glue | BatchGetColumnStatisticsForTable | API 呼叫 | 
| AWS Glue | BatchGetCrawlers | API 呼叫 | 
| AWS Glue | BatchGetCustomEntityTypes | API 呼叫 | 
| AWS Glue | BatchGetDataQualityResult | API 呼叫 | 
| AWS Glue | BatchGetDevEndpoints | API 呼叫 | 
| AWS Glue | BatchGetJobs | API 呼叫 | 
| AWS Glue | BatchGetMLTransform | API 呼叫 | 
| AWS Glue | BatchGetPartition | API 呼叫 | 
| AWS Glue | BatchGetTriggers | API 呼叫 | 
| AWS Glue | BatchGetWorkflows | API 呼叫 | 
| AWS Glue | QueryJobRuns | API 呼叫 | 
| AWS Glue | QueryJobRunsAggregated | API 呼叫 | 
| AWS Glue | QueryJobs | API 呼叫 | 
| AWS Glue | QuerySchemaVersionMetadata | API 呼叫 | 
| AWS Glue | SearchTables | API 呼叫 | 
| AWS HealthLake | ReadResource | API 呼叫 | 
| AWS HealthLake | SearchWithGet | API 呼叫 | 
| AWS HealthLake | SearchWithPost | API 呼叫 | 
| AWS Identity and Access Management | GenerateCredentialReport | API 呼叫 | 
| AWS Identity and Access Management | GenerateOrganizationsAccessReport | API 呼叫 | 
| AWS Identity and Access Management | GenerateServiceLastAccessedDetails | API 呼叫 | 
| AWS Identity and Access Management | SimulateCustomPolicy | API 呼叫 | 
| AWS Identity and Access Management | SimulatePrincipalPolicy | API 呼叫 | 
| AWS 身分存放區 | IsMemberInGroups | API 呼叫 | 
| AWS 身分存放區驗證 | BatchGetSession | API 呼叫 | 
| Amazon Inspector Classic | PreviewAgents | API 呼叫 | 
| Amazon Inspector Classic | BatchGetAccountStatus | API 呼叫 | 
| Amazon Inspector Classic | BatchGetFreeTrialInfo | API 呼叫 | 
| Amazon Inspector Classic | BatchGetMember | API 呼叫 | 
| AWS Invoicing | ValidateDocumentDeliveryS3LocationInfo | API 呼叫 | 
| AWS IoT | SearchIndex | API 呼叫 | 
| AWS IoT | TestAuthorization | API 呼叫 | 
| AWS IoT | TestInvokeAuthorizer | API 呼叫 | 
| AWS IoT | ValidateSecurityProfileBehaviors | API 呼叫 | 
| AWS IoT Analytics | SampleChannelData | API 呼叫 | 
| AWS IoT SiteWise | GatewaysVerifyResourcesExistForTagrisInternal | API 呼叫 | 
| AWS IoT Things Graph | SearchEntities | API 呼叫 | 
| AWS IoT Things Graph | SearchFlowExecutions | API 呼叫 | 
| AWS IoT Things Graph | SearchFlowTemplates | API 呼叫 | 
| AWS IoT Things Graph | SearchSystemInstances | API 呼叫 | 
| AWS IoT Things Graph | SearchSystemTemplates | API 呼叫 | 
| AWS IoT Things Graph | SearchThings | API 呼叫 | 
| AWS IoT TwinMaker | ExecuteQuery | API 呼叫 | 
| AWS IoT Wireless | CreateNetworkAnalyzerConfiguration | API 呼叫 | 
| AWS IoT Wireless | DeleteNetworkAnalyzerConfiguration | API 呼叫 | 
| AWS IoT Wireless | DeregisterWirelessDevice | API 呼叫 | 
| Amazon Interactive Video Service | BatchGetChannel | API 呼叫 | 
| Amazon Interactive Video Service | BatchGetStreamKey | API 呼叫 | 
| Amazon Kendra | BatchGetDocumentStatus | API 呼叫 | 
| Amazon Kendra | Query | API 呼叫 | 
| Amazon Managed Service for Apache Flink | DiscoverInputSchema | API 呼叫 | 
| AWS Key Management Service | 解密 | API 呼叫 | 
| AWS Key Management Service | 加密 | API 呼叫 | 
| AWS Key Management Service | GenerateDataKey | API 呼叫 | 
| AWS Key Management Service | GenerateDataKeyPair | API 呼叫 | 
| AWS Key Management Service | GenerateDataKeyPairWithoutPlaintext | API 呼叫 | 
| AWS Key Management Service | GenerateDataKeyWithoutPlaintext | API 呼叫 | 
| AWS Key Management Service | GenerateMac | API 呼叫 | 
| AWS Key Management Service | GenerateRandom | API 呼叫 | 
| AWS Key Management Service | ReEncrypt | API 呼叫 | 
| AWS Key Management Service | 符號 | API 呼叫 | 
| AWS Key Management Service | 確認 | API 呼叫 | 
| AWS Key Management Service | VerifyMac | API 呼叫 | 
| AWS Lake Formation | SearchDatabasesByLFTags | API 呼叫 | 
| AWS Lake Formation | SearchTablesByLFTags | API 呼叫 | 
| AWS Lake Formation | StartQueryPlanning | API 呼叫 | 
| Amazon Lex | BatchCreateCustomVocabularyItem | API 呼叫 | 
| Amazon Lex | BatchDeleteCustomVocabularyItem | API 呼叫 | 
| Amazon Lex | BatchUpdateCustomVocabularyItem | API 呼叫 | 
| Amazon Lex | DeleteCustomVocabulary | API 呼叫 | 
| Amazon Lex | SearchAssociatedTranscripts | API 呼叫 | 
| Amazon Lightsail | CreateGUISessionAccessDetails | API 呼叫 | 
| Amazon Lightsail | DownloadDefaultKeyPair | API 呼叫 | 
| Amazon Lightsail | IsVpcPeered | API 呼叫 | 
| Amazon CloudWatch Logs | FilterLogEvents | API 呼叫 | 
| Amazon Macie | BatchGetCustomDataIdentifiers | API 呼叫 | 
| Amazon Macie | UpdateFindingsFilter | API 呼叫 | 
| AWS Elemental MediaConnect | ManagedDescribeFlow | API 呼叫 | 
| AWS Elemental MediaConnect | PrivateDescribeFlowMeta | API 呼叫 | 
| AWS Application Migration Service | OperationalDescribeJobLogItems | API 呼叫 | 
| AWS Application Migration Service | OperationalDescribeJobs | API 呼叫 | 
| AWS Application Migration Service | OperationalDescribeReplicationConfigurationTemplates | API 呼叫 | 
| AWS Application Migration Service | OperationalDescribeSourceServer | API 呼叫 | 
| AWS Application Migration Service | OperationalGetLaunchConfiguration | API 呼叫 | 
| AWS Application Migration Service | OperationalListSourceServers | API 呼叫 | 
| AWS Application Migration Service | VerifyClientRoleForMgn | API 呼叫 | 
| AWS HealthOmics | VerifyResourceExists | API 呼叫 | 
| AWS HealthOmics | VerifyResourcesExistForTagris | API 呼叫 | 
| Amazon Polly | SynthesizeLongSpeech | API 呼叫 | 
| Amazon Polly | SynthesizeSpeech | API 呼叫 | 
| Amazon Polly | SynthesizeSpeechGet | API 呼叫 | 
| AWS 提供受管私有網路的服務 | Ping | API 呼叫 | 
| AWS Proton | DeleteEnvironmentTemplateVersion | API 呼叫 | 
| AWS Proton | DeleteServiceTemplateVersion | API 呼叫 | 
| Amazon QLDB | ShowCatalog | API 呼叫 | 
| Amazon Quick | GenerateEmbedUrlForAnonymousUser | API 呼叫 | 
| Amazon Quick | GenerateEmbedUrlForRegisteredUser | API 呼叫 | 
| Amazon Quick | QueryDatabase | 服務事件 | 
| Amazon Quick | SearchAnalyses | API 呼叫 | 
| Amazon Quick | SearchDashboards | API 呼叫 | 
| Amazon Quick | SearchDataSets | API 呼叫 | 
| Amazon Quick | SearchDataSources | API 呼叫 | 
| Amazon Quick | SearchFolders | API 呼叫 | 
| Amazon Quick | SearchGroups | API 呼叫 | 
| Amazon Quick | SearchUsers | API 呼叫 | 
| Amazon Relational Database Service | DownloadCompleteDBLogFile | API 呼叫 | 
| Amazon Relational Database Service | DownloadDBLogFilePortion | API 呼叫 | 
| Amazon Rekognition | CompareFaces | API 呼叫 | 
| Amazon Rekognition | 偵測自訂標籤 | API 呼叫 | 
| Amazon Rekognition | DetectFaces | API 呼叫 | 
| Amazon Rekognition | DetectLabels | API 呼叫 | 
| Amazon Rekognition | DetectModerationLabels | API 呼叫 | 
| Amazon Rekognition | DetectProtectiveEquipment | API 呼叫 | 
| Amazon Rekognition | DetectText | API 呼叫 | 
| Amazon Rekognition | RecognizeCelebrities | API 呼叫 | 
| Amazon Rekognition | SearchFaces | API 呼叫 | 
| Amazon Rekognition | SearchFacesByImage | API 呼叫 | 
| Amazon Rekognition | SearchUsers | API 呼叫 | 
| Amazon Rekognition | SearchUsersByImage | API 呼叫 | 
| AWS 資源總管 | BatchGetView | API 呼叫 | 
| AWS 資源總管 | 搜尋 | API 呼叫 | 
| AWS Resource Groups | SearchResources | API 呼叫 | 
| AWS Resource Groups | ValidateResourceSharing | API 呼叫 | 
| AWS RoboMaker | BatchDescribeSimulationJob | API 呼叫 | 
| Amazon Route 53 | TestDNSAnswer | API 呼叫 | 
| Amazon Route 53 網域 | checkAvailabilities | API 呼叫 | 
| Amazon Route 53 網域 | CheckDomainAvailability | API 呼叫 | 
| Amazon Route 53 網域 | checkDomainTransferability | API 呼叫 | 
| Amazon Route 53 網域 | CheckDomainTransferability | API 呼叫 | 
| Amazon Route 53 網域 | isEmailReachable | API 呼叫 | 
| Amazon Route 53 網域 | searchDomains | API 呼叫 | 
| Amazon Route 53 網域 | sendVerificationMessage | API 呼叫 | 
| Amazon Route 53 網域 | ViewBilling | API 呼叫 | 
| Amazon Route 53 網域 | viewBilling | API 呼叫 | 
| Amazon CloudWatch RUM | BatchGetRumMetricDefinitions | API 呼叫 | 
| Amazon Simple Storage Service | 回應 | API 呼叫 | 
| Amazon Simple Storage Service | GenerateInventory | 服務事件 | 
| Amazon SageMaker AI | BatchDescribeModelPackage | API 呼叫 | 
| Amazon SageMaker AI | DeleteModelCard | API 呼叫 | 
| Amazon SageMaker AI | QueryLineage | API 呼叫 | 
| Amazon SageMaker AI | RenderUiTemplate | API 呼叫 | 
| Amazon SageMaker AI | 搜尋 | API 呼叫 | 
| Amazon EventBridge 結構描述 | ExportSchema | API 呼叫 | 
| Amazon EventBridge 結構描述 | SearchSchemas | API 呼叫 | 
| Amazon SimpleDB | DomainMetadata | API 呼叫 | 
| AWS Secrets Manager | ValidateResourcePolicy | API 呼叫 | 
| AWS Service Catalog | ScanProvisionedProducts | API 呼叫 | 
| AWS Service Catalog | SearchProducts | API 呼叫 | 
| AWS Service Catalog | SearchProductsAsAdmin | API 呼叫 | 
| AWS Service Catalog | SearchProvisionedProducts | API 呼叫 | 
| Amazon SES | BatchGetMetricData | API 呼叫 | 
| Amazon SES | TestRenderEmailTemplate | API 呼叫 | 
| Amazon SES | TestRenderTemplate | API 呼叫 | 
| Amazon Simple Notification Service | CheckIfPhoneNumberIsOptedOut | API 呼叫 | 
| AWS SQL Workbench | BatchGetNotebookCell | API 呼叫 | 
| AWS SQL Workbench | ExportNotebook | API 呼叫 | 
| Amazon EC2 Systems Manager | ExecuteApi | API 呼叫 | 
| AWS Systems Manager Incident Manager | DeleteContactChannel | API 呼叫 | 
| AWS IAM Identity Center | IsMemberInGroup | API 呼叫 | 
| AWS IAM Identity Center | SearchGroups | API 呼叫 | 
| AWS IAM Identity Center | SearchUsers | API 呼叫 | 
| AWS STS | AssumeRole | API 呼叫 | 
| AWS STS | AssumeRoleWithSAML | API 呼叫 | 
| AWS STS | AssumeRoleWithWebIdentity | API 呼叫 | 
| AWS STS | DecodeAuthorizationMessage | API 呼叫 | 
| AWS 稅務設定 | atchGetTaxExemptions | API 呼叫 | 
| AWS WAFV2 | CheckCapacity | API 呼叫 | 
| AWS WAFV2 | GenerateMobileSdkReleaseUrl | API 呼叫 | 
| AWS Well-Architected Tool | ExportLens | API 呼叫 | 
| AWS Well-Architected Tool | TagResource | API 呼叫 | 
| AWS Well-Architected Tool | UntagResource | API 呼叫 | 
| AWS Well-Architected Tool | UpdateGlobalSettings | API 呼叫 | 
| Amazon Connect Wisdom | QueryAssistant | API 呼叫 | 
| Amazon Connect Wisdom | SearchContent | API 呼叫 | 
| Amazon Connect Wisdom | SearchSessions | API 呼叫 | 
| Amazon WorkDocs | AbortDocumentVersionUpload | API 呼叫 | 
| Amazon WorkDocs | AddUsersToGroup | API 呼叫 | 
| Amazon WorkDocs | BatchGetUsers | API 呼叫 | 
| Amazon WorkDocs | CheckAlias | API 呼叫 | 
| Amazon WorkDocs | CompleteDocumentVersionUpload | API 呼叫 | 
| Amazon WorkDocs | CreateAnnotation | API 呼叫 | 
| Amazon WorkDocs | CreateComment | API 呼叫 | 
| Amazon WorkDocs | CreateFeedbackRequest | API 呼叫 | 
| Amazon WorkDocs | CreateFolder | API 呼叫 | 
| Amazon WorkDocs | CreateGroup | API 呼叫 | 
| Amazon WorkDocs | CreateShare | API 呼叫 | 
| Amazon WorkDocs | CreateUser | API 呼叫 | 
| Amazon WorkDocs | DeleteAnnotation | API 呼叫 | 
| Amazon WorkDocs | DeleteComment | API 呼叫 | 
| Amazon WorkDocs | DeleteDocument | API 呼叫 | 
| Amazon WorkDocs | DeleteFeedbackRequest | API 呼叫 | 
| Amazon WorkDocs | DeleteFolder | API 呼叫 | 
| Amazon WorkDocs | DeleteFolderContents | API 呼叫 | 
| Amazon WorkDocs | DeleteGroup | API 呼叫 | 
| Amazon WorkDocs | DeleteOrganizationShare | API 呼叫 | 
| Amazon WorkDocs | DeleteUser | API 呼叫 | 
| Amazon WorkDocs | DownloadDocumentVersion | API 呼叫 | 
| Amazon WorkDocs | DownloadDocumentVersionUnderlays | API 呼叫 | 
| Amazon WorkDocs | InitiateDocumentVersionUpload | API 呼叫 | 
| Amazon WorkDocs | LogoutUser | API 呼叫 | 
| Amazon WorkDocs | PaginatedOrganizationActivity | API 呼叫 | 
| Amazon WorkDocs | PublishAnnotations | API 呼叫 | 
| Amazon WorkDocs | PublishComments | API 呼叫 | 
| Amazon WorkDocs | RestoreDocument | API 呼叫 | 
| Amazon WorkDocs | RestoreFolder | API 呼叫 | 
| Amazon WorkDocs | SearchGroups | API 呼叫 | 
| Amazon WorkDocs | SearchOrganizationUsers | API 呼叫 | 
| Amazon WorkDocs | TransferUserResources | API 呼叫 | 
| Amazon WorkDocs | UpdateAnnotation | API 呼叫 | 
| Amazon WorkDocs | UpdateComment | API 呼叫 | 
| Amazon WorkDocs | UpdateDocument | API 呼叫 | 
| Amazon WorkDocs | UpdateDocumentVersion | API 呼叫 | 
| Amazon WorkDocs | UpdateFolder | API 呼叫 | 
| Amazon WorkDocs | UpdateGroup | API 呼叫 | 
| Amazon WorkDocs | UpdateOrganization | API 呼叫 | 
| Amazon WorkDocs | UpdateUser | API 呼叫 | 
| Amazon WorkMail | AssumeImpersonationRole | API 呼叫 | 
| Amazon WorkMail | QueryDnsRecords | API 呼叫 | 
| Amazon WorkMail | SearchMembers | API 呼叫 | 
| Amazon WorkMail | TestAvailabilityConfiguration | API 呼叫 | 
| Amazon WorkMail | TestInboundMailFlowRules | API 呼叫 | 
| Amazon WorkMail | TestOutboundMailFlowRules | API 呼叫 | 

# Amazon EventBridge 事件詳細資訊參考
<a name="event-reference"></a>

EventBridge 本身會發出下列事件。這些事件會自動傳送至預設事件匯流排，就像任何其他 AWS 服務一樣。

如需所有事件中包含的中繼資料欄位定義，請參閱 [AWS 事件參考中的服務事件中繼資料](https://docs.aws.amazon.com/eventbridge/latest/ref/events-structure.html)。 **


| 事件詳細資訊類型 | Description | 
| --- | --- | 
|   [排程事件](#event-detail-scheduled-event)   |  代表排程的事件。 | 
|   [已建立結構描述](#event-detail-schema-created)   |  代表建立新事件結構描述。 | 
|   [已建立結構描述版本](#event-detail-schema-version-created)   |  代表建立新版本的新或現有事件結構描述。  | 
|   [連線狀態事件](#event-detail-connection-state)   |  代表連線狀態的變更。  | 
|   [API 目的地狀態事件](#event-detail-api-destination-state)   |  代表 API 目的地狀態的變更。  | 

## 排程事件
<a name="event-reference-schedules"></a>

EventBridge 會將下列排程事件傳送至預設事件匯流排。如需詳細資訊，請參閱[排程器](using-eventbridge-scheduler.md)。

### 排程事件
<a name="event-detail-scheduled-event"></a>

代表排程的事件。

包含 `source`和 `detail-type` 欄位，因為它們包含 EventBridge 事件的特定值。如需所有事件中包含的其他中繼資料欄位的定義，請參閱 [AWS 事件參考中的服務事件中繼資料](https://docs.aws.amazon.com/eventbridge/latest/ref/events-structure.html)。 **

```
{
  . . .,
  "detail-type": "Scheduled Event",
  "source": "aws.events",
  . . .,
  "detail": {}
}
```

`detail-type`  <a name="scheduled-event-detail-type"></a>
識別事件的類型。  
對於此事件，此值為 `Scheduled Event`。  
必要：是

`source`  <a name="scheduled-event-source"></a>
識別產生事件的服務。對於 EventBridge 事件，此值為 `aws.events`。  
必要：是

`detail`  <a name="scheduled-event-detail"></a>
包含事件相關資訊的 JSON 物件。產生事件的服務會決定此欄位的內容。  
必要：是  
此物件中沒有`Scheduled Event`事件的必要欄位。

**Example 排程事件範例**  <a name="event-detail-scheduled-event.example"></a>

```
{
  "version": "0",
  "id": "89d1a02d-5ec7-412e-82f5-13505f849b41",
  "detail-type": "Scheduled Event",
  "source": "aws.events",
  "account": "123456789012",
  "time": "2016-12-30T18:44:49Z",
  "region": "us-east-1",
  "resources": ["arn:aws:events:us-east-1:123456789012:rule/SampleRule"],
  "detail": {}
}
```

## 結構描述登錄檔事件
<a name="event-reference-schemas"></a>

EventBridge 會將下列結構描述登錄事件傳送至預設事件匯流排。如需詳細資訊，請參閱[](eb-schema.md)。

### 已建立結構描述
<a name="event-detail-schema-created"></a>

代表建立新結構描述。

建立結構描述時， 會同時 EventBridge 傳送 `Schema Created`和 `Schema Version Created`事件。

包含 `source`和 `detail-type` 欄位，因為它們包含 EventBridge 事件的特定值。如需所有事件中包含的其他中繼資料欄位的定義，請參閱 [AWS 事件參考中的服務事件中繼資料](https://docs.aws.amazon.com/eventbridge/latest/ref/events-structure.html)。 **

```
{
  . . .,
  "detail-type": "Schema Created",
  "source": "aws.schemas",
  . . .,
  "detail": {
    "SchemaName" : "String",
    "SchemaType" : "String",
    "RegistryName" : "String",
    "CreationDate" : "DateTime",
    "Version" : "Number"
  }
}
```

`detail-type`  <a name="schema-created-detail-type"></a>
識別事件的類型。  
對於此事件，此值為 `Schema Created`。  
必要：是

`source`  <a name="schema-created-source"></a>
識別產生事件的服務。對於 EventBridge 事件，此值為 `aws.schemas`。  
必要：是

`detail`  <a name="schema-created-detail"></a>
包含事件相關資訊的 JSON 物件。產生事件的服務會決定此欄位的內容。  
必要：是  
對於此事件，此資料包含：    
`SchemaName`  <a name="schema-created-schema-name"></a>
結構描述的名稱。  
必要：是  
`SchemaType`  <a name="schema-created-schema-type"></a>
結構描述的類型。  
有效值：`OpenApi3` \$1 `JSONSchemaDraft4`  
必要：是  
`RegistryName`  <a name="schema-created-registry-name"></a>
包含結構描述的登錄檔的名稱。  
必要：是  
`CreationDate`  <a name="schema-created-creation-date"></a>
建立結構描述的日期。  
必要：是  
`Version`  <a name="schema-created-version"></a>
此結構描述的版本。  
對於 `Schema Created` 事件，此值一律為 `1`。  
必要：是

**Example 已建立的結構描述事件範例**  <a name="event-detail-schema-created.example"></a>

```
{
  "version": "0",
  "id": "01234567-0123-0123-0123-012345678901",
  "detail-type": "Schema Created",
  "source": "aws.schemas",
  "account": "123456789012",
  "time": "2019-05-31T21:49:54Z",
  "region": "us-east-1",
  "resources": ["arn:aws:schemas:us-east-1::schema/myRegistry/mySchema"],
  "detail": {
    "SchemaName": "mySchema",
    "SchemaType": "OpenApi3",
    "RegistryName": "myRegistry",
    "CreationDate": "2019-11-29T20:08:55Z",
    "Version": "1"
  }
}
```

### 已建立結構描述版本
<a name="event-detail-schema-version-created"></a>

代表建立新版本的新或現有事件結構描述。

建立結構描述時， 會同時 EventBridge 傳送 `Schema Created`和 `Schema Version Created`事件。

包含 `source`和 `detail-type` 欄位，因為它們包含 EventBridge 事件的特定值。如需所有事件中包含的其他中繼資料欄位的定義，請參閱 [AWS 事件參考中的服務事件中繼資料](https://docs.aws.amazon.com/eventbridge/latest/ref/events-structure.html)。 **

```
{
  . . .,
  "detail-type": "Schema Version Created",
  "source": "aws.schemas",
  . . .,
  "detail": {
    "SchemaName" : "String",
    "SchemaType" : "String",
    "RegistryName" : "String",
    "CreationDate" : "DateTime",
    "Version" : "Number"
  }
}
```

`detail-type`  <a name="schema-version-created-detail-type"></a>
識別事件的類型。  
對於此事件，此值為 `Schema Version Created`。  
必要：是

`source`  <a name="schema-version-created-source"></a>
識別產生事件的服務。對於 EventBridge 事件，此值為 `aws.schemas`。  
必要：是

`detail`  <a name="schema-version-created-detail"></a>
包含事件相關資訊的 JSON 物件。產生事件的服務會決定此欄位的內容。  
必要：是  
對於此事件，此資料包含：    
`SchemaName`  <a name="schema-version-created-schema-name"></a>
結構描述的名稱。  
必要：是  
`SchemaType`  <a name="schema-version-created-schema-type"></a>
結構描述的類型。  
有效值：`OpenApi3` \$1 `JSONSchemaDraft4`  
必要：是  
`RegistryName`  <a name="schema-version-created-registry-name"></a>
包含結構描述的登錄檔的名稱。  
必要：是  
`CreationDate`  <a name="schema-version-created-creation-date"></a>
建立結構描述版本的日期。  
必要：是  
`Version`  <a name="schema-version-created-version"></a>
此結構描述的版本。  
必要：是

**Example 已建立的結構描述版本事件範例**  <a name="event-detail-schema-version-created.example"></a>

```
{
  "version": "0",
  "id": "01234567-0123-0123-0123-012345678901",
  "detail-type": "Schema Version Created",
  "source": "aws.schemas",
  "account": "123456789012",
  "time": "2019-05-31T21:49:54Z",
  "region": "us-east-1",
  "resources": ["arn:aws:schemas:us-east-1::schema/myRegistry/mySchema"],
  "detail": {
    "SchemaName": "mySchema",
    "SchemaType": "OpenApi3",
    "RegistryName": "myRegistry",
    "CreationDate": "2019-11-29T20:08:55Z",
    "Version": "5"
  }
}
```

## 連線事件
<a name="event-reference-connections"></a>

EventBridge 會將下列連線事件傳送至預設事件匯流排。如需詳細資訊，請參閱[連線](eb-target-connection.md)。

### 連線狀態事件
<a name="event-detail-connection-state"></a>

這些事件各自代表新連線或現有連線的狀態變更。

包含 `source`和 `detail-type` 欄位，因為它們包含 EventBridge 事件的特定值。如需所有事件中包含的其他中繼資料欄位的定義，請參閱 [AWS 事件參考中的服務事件中繼資料](https://docs.aws.amazon.com/eventbridge/latest/ref/events-structure.html)。 **

```
{
  . . .,
  "detail-type": "Connection status",
  "source": "aws.events",
  . . .,
  "detail": {
    "ConnectionName" : "String",
    "StateReason" : "String",
    "Timestamp" : "DateTime"
  }
}
```

`detail-type`  <a name="connection-state-detail-type"></a>
識別事件的類型。  
對於此事件，此值為下列其中一項：  
+ `Connection Creation Started`
+ `Connection Update Started`
+ `Connection Deletion Started`
+ `Connection Activated`
+ `Connection Authorized`
+ `Connection Authorization Started`
+ `Connection Deauthorization Started`
+ `Connection Deauthorized`
+ `Connection Failed Connectivity`
必要：是

`source`  <a name="connection-state-source"></a>
識別產生事件的服務。對於 EventBridge 事件，此值為 `aws.events`。  
必要：是

`detail`  <a name="connection-state-detail"></a>
包含事件相關資訊的 JSON 物件。產生事件的服務會決定此欄位的內容。  
必要：是  
對於此事件，此資料包含：    
`ConnectionName`  <a name="connection-state-connection-name"></a>
連線的名稱。  
必要：是  
`StateReason`  <a name="connection-state-state-reason"></a>
連線狀態變更的原因。  
必要：否  
`Timestamp`  <a name="connection-state-timestamp"></a>
連線狀態變更的時間和日期。  
必要：是

**Example 連線狀態事件範例**  <a name="event-detail-connection-state.example"></a>

```
{
    "version": "0",
    "id": "1d7a4ac6-a50a-745f-a331-a0d802f7badb",
    "detail-type": "Connection Creation Started",
    "source": "aws.events",
    "account": "123456789012",
    "time": "2024-10-28T09:08:20Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:events:us-east-1:123456789012:connection/sample-connection/ee7e4d52-8df0-4bed-a0d5-fa7dea43fcf8"
    ],
    "detail": {
        "ConnectionName": "sample-connection",
        "Timestamp": "2024-10-24 09:26:35 +0000 UTC"
    }
}
```

## API 目的地事件
<a name="event-reference-api-destinations"></a>

EventBridge 會將下列 API 目的地事件傳送至預設事件匯流排。如需詳細資訊，請參閱[API 目的地](eb-api-destinations.md)。

### API 目的地狀態事件
<a name="event-detail-api-destination-state"></a>

這些事件各自代表 API 目的地的狀態變更。

包含 `source`和 `detail-type` 欄位，因為它們包含 EventBridge 事件的特定值。如需所有事件中包含的其他中繼資料欄位的定義，請參閱 [AWS 事件參考中的服務事件中繼資料](https://docs.aws.amazon.com/eventbridge/latest/ref/events-structure.html)。 **

```
{
  . . .,
  "detail-type": "API Destination status",
  "source": "aws.events",
  . . .,
  "detail": {
    "ApiDestinationName" : "String",
    "Timestamp" : "DateTime"
  }
}
```

`detail-type`  <a name="api-destination-state-detail-type"></a>
識別事件的類型。  
對於此事件，此值為下列其中一項：  
+ `API Destination Activated`
+ `API Destination Deactivated`
必要：是

`source`  <a name="api-destination-state-source"></a>
識別產生事件的服務。對於 EventBridge 事件，此值為 `aws.events`。  
必要：是

`detail`  <a name="api-destination-state-detail"></a>
包含事件相關資訊的 JSON 物件。產生事件的服務會決定此欄位的內容。  
必要：是  
對於此事件，此資料包含：    
`ApiDestinationName`  <a name="api-destination-state-connection-name"></a>
API 目的地的名稱。  
必要：是  
`Timestamp`  <a name="api-destination-state-timestamp"></a>
API 目的地狀態變更的時間和日期。  
必要：是

**Example API 目的地狀態事件範例**  <a name="event-detail-api-destination-state.example"></a>

```
{
    "version": "0",
    "id": "1d7a4ac6-a50a-745f-a331-a0d802f7badb",
    "detail-type": "API Destination Deactivated",
    "source": "aws.events",
    "account": "123456789012",
    "time": "2024-10-28T09:08:20Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:events:us-east-1:123456789012:api-destination/sample-api-destination/ee7e4d52-8df0-4bed-a0d5-fa7dea43fcf8"
    ],
    "detail": {
        "ApiDestinationName": "sample-api-destination",
        "Timestamp": "2024-10-24 09:26:35 +0000 UTC"
    }
}
```