本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 私密事件通知
當預備標籤在您的秘密上變更時，Secrets Manager 會將事件發佈至 Amazon EventBridge。您可以建立符合這些事件的 EventBridge 規則，並將其路由至目標以建置事件驅動的工作流程。
## EventBridge 如何路由 Secrets Manager 事件
以下說明 EventBridge 如何與 Secrets Manager 事件搭配使用。
如同許多 AWS 服務，Secrets Manager 會產生事件並將其傳送至 EventBridge 預設*事件匯流排*。事件匯流排是接收事件並將其路由至您指定目的地或*目標*的路由器。目標可以包含其他服務 AWS 、自訂應用程式和 SaaS 合作夥伴應用程式。
EventBridge 會根據您在事件匯流排上建立的*規則*路由事件。對於每個規則，您可以指定篩選條件或*事件模式*，以僅選取您想要的事件。每當事件傳送到事件匯流排時，EventBridge 都會將其與每個規則進行比較。如果事件符合規則，EventBridge 會將事件路由到指定的目標。
下圖顯示 EventBridge 如何將 Secrets Manager 事件從預設事件匯流排路由到您指定的目標。
如需詳細資訊，請參閱《*EventBridge 使用者指南*》中的[建立規則](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html)。
## Secrets Manager 事件
Secrets Manager 會在臨時標籤變更時，將`Secret Label Updated`事件發佈至預設 EventBridge 事件匯流排，但 `AWSPENDING`和 除外`AWSPREVIOUS`。這包括自訂標籤。根據預設，所有秘密都會啟用事件。若要使用這些事件，您可以建立符合它們的 EventBridge 規則，並將其路由至目標。如需可用作目標的服務完整清單，請參閱[EventBridge 使用者指南》中的 EventBridge 目標](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html)。 *EventBridge *
Secrets Manager 不會發佈中繼資料變更的事件，例如標籤、描述、輪換組態或資源政策更新。
| 事件詳細資訊類型 | 說明 |
| --- | --- |
| [秘密標籤已更新](event-detail-secret-label-updated-secretsmanager.md) | Secrets Manager 將預備標籤移至秘密的新版本。 |
### 事件結構
AWS 服務的所有事件都包含兩種類型的資料：
+ 包含事件中繼資料的常見欄位集，例如事件來源 AWS 的服務、產生事件的時間、事件發生的帳戶和區域，以及其他。如需這些一般欄位的定義，請參閱《*Amazon EventBridge Events Reference*》中的事件[結構](https://docs.aws.amazon.com/eventbridge/latest/ref/overview-event-structure.html)。
+ 包含該特定服務事件特定資料`detail`的欄位。
## 建立符合 Secrets Manager 事件的事件模式
事件模式是篩選條件，您可以在其中指定要選取的事件應包含哪些資料。
每個事件模式都是 JSON 物件，它包含：
+ 識別傳送事件之服務的 `source` 屬性。對於 Secrets Manager 事件，來源為 `aws.secretsmanager`。
+ （選用）：包含要比對之事件名稱陣列的`detail-type`屬性。
+ (選擇性)：包含要比對的任何其他事件資料的 `detail` 屬性。
當`AWSCURRENT`標籤移至新版本時，下列事件模式會比對事件，這表示作用中的秘密值已變更：
```
{
"source": ["aws.secretsmanager"],
"detail-type": ["Secret Label Updated"],
"detail": {
"labelUpdated": ["AWSCURRENT"]
}
}
```
下列事件模式只會針對名稱開頭為 的秘密，比對標籤變更`MyTestSecret`：
```
{
"source": ["aws.secretsmanager"],
"detail-type": ["Secret Label Updated"],
"detail": {
"name": [{"prefix": "MyTestSecret"}]
}
}
```
下列事件模式會結合篩選條件，只有在名稱開頭為 的秘密`AWSCURRENT`變更時才能比對`prod/`：
```
{
"source": ["aws.secretsmanager"],
"detail-type": ["Secret Label Updated"],
"detail": {
"name": [{"prefix": "prod/"}],
"labelUpdated": ["AWSCURRENT"]
}
}
```
如果您在工作流程中使用自訂預備標籤，您可以比對這些標籤的事件。移動名為 的標籤時，下列範例`MyLabel`會相符：
```
{
"source": ["aws.secretsmanager"],
"detail-type": ["Secret Label Updated"],
"detail": {
"labelUpdated": ["MyLabel"]
}
}
```
如需撰寫事件模式的詳細資訊，請參閱《*EventBridge 使用者指南*》中的事件[模式](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html)。
建立事件模式是建立規則之較大程序中的步驟。如需詳細資訊，請參閱《*EventBridge 使用者指南*》中的[建立規則](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html)。