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

# Amazon EventBridge 結構描述
<a name="eb-schema"></a>

結構描述會定義傳送至 EventBridge 的[事件](eb-events.md)結構。EventBridge 為 AWS 服務產生的所有事件提供結構描述。您也可以[建立或上傳結構描述](eb-schema-create.md)，或直接從[事件匯流排](eb-event-bus.md)上的事件[推斷結構描述](eb-schemas-infer.md)。擁有事件的結構描述後，您就可以下載常用程式設計語言的程式碼繫結以及加速開發。您可以針對結構描述使用程式碼繫結，並從 EventBridge 主控台、使用 API 或直接在 IDE 中使用 AWS 工具組來管理結構描述。若要建置使用事件的無伺服器應用程式，請使用 AWS Serverless Application Model。

**注意**  
使用[輸入轉換器](eb-transform-target-input.md)功能時，結構描述探索會推斷原始事件，而不是傳送至目標的轉換事件。

EventBridge 支援 OpenAPI 3 和 JSONSchema Draft4 格式。

針對 [AWS JetBrains 工具組](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/eventbridge-schemas.html)和 [AWS VS 程式碼工具組](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/working-with-aws.html)，您可以瀏覽或搜尋結構描述，並直接在 IDE 中下載結構描述的程式碼繫結。

 下列影片提供結構描述和結構描述登錄檔的概觀：




## 結構描述登錄檔 API 屬性值遮罩
<a name="eb-schema-mask"></a>

用來建立結構描述登錄檔之事件的某些屬性值可能包含敏感的客戶資訊。為了保護客戶的資訊，數值將以星號 (\*) 遮罩。因為我們要遮罩這些值，所以 EventBridge 建議您不要建置明確依賴下列屬性或其值的應用程式：
+ **[CreateSchema](https://docs.aws.amazon.com/eventbridge/latest/schema-reference/v1-registries-name-registryname-schemas-name-schemaname.html#CreateSchema)**：`requestParameters` 主體的 `Content` 屬性
+ **[GetDiscoveredSchema](https://docs.aws.amazon.com/eventbridge/latest/schema-reference/v1-discover.html#GetDiscoveredSchema)**：`requestParameters` 主體的 `Events` 屬性和 `responseElements` 主體的 `Content` 屬性
+ **[SearchSchemas](https://docs.aws.amazon.com/eventbridge/latest/schema-reference/v1-registries-name-registryname-schemas-search.html#SearchSchemas)**：`requestParameters` 的 `keywords` 屬性
+ **[UpdateSchema](https://docs.aws.amazon.com/eventbridge/latest/schema-reference/v1-registries-name-registryname-schemas-name-schemaname.html#UpdateSchema)**：`requestParameters` 的 `Content` 屬性