# 使用 Amazon EventBridge 結構描述
<a name="eventbridge-schemas"></a>

您可以透過 AWS Toolkit for JetBrains 使用 Amazon EventBridge 結構描述，方法如下。

**注意**  
目前僅 AWS Toolkit for IntelliJ 和 AWS Toolkit for PyCharm 支援使用 EventBridge 結構描述。

以下資訊假設您已[設定 AWS Toolkit for JetBrains](getting-started.md)。

**Contents**
+ [檢視結構描述](#eventbridge-schemas-view)
+ [尋找結構描述](#eventbridge-schemas-find)
+ [產生結構描述的程式碼](#eventbridge-schemas-generate-code)
+ [建立使用結構描述的 AWS SAM 應用程式](#eventbridge-schemas-serverless-app)

## 檢視可用的結構描述
<a name="eventbridge-schemas-view"></a>

1. 在 [**AWS Explorer**](aws-explorer.md) 工具視窗顯示的情況下，展開 **Schemas (結構描述)**。

1. 展開登錄的名稱，內含您要檢視的結構描述。例如，AWS 提供的許多結構描述都在 **aws.events** 登錄中。

1. 如要在編輯器中檢視結構描述，請以滑鼠右鍵按一下結構描述標題，然後在內容選單上，選擇 **View Schema (檢視結構描述)**。

## 尋找可用的結構描述
<a name="eventbridge-schemas-find"></a>

在顯示 [**AWS Explorer**](aws-explorer.md)工具視窗的情況下，執行以下其中一項作業：
+ 開始輸入您要尋找的結構描述的標題。**AWS Explorer** 會反白顯示包含相符項目的結構描述標題。
+ 以滑鼠右鍵按一下 **Schemas (結構描述)**，然後在內容選單上，選擇 **Search Schemas (搜尋結構描述)**。在**搜尋 EventBridge 結構描述**對話方塊中，開始輸入您要尋找的結構描述名稱。對話方塊會顯示包含相符項目的結構描述標題。
+ 展開 **Schemas (結構描述)**。以滑鼠右鍵按一下包含您要尋找結構描述的登錄名稱，然後選擇 **Search Schemas in Registry (在登錄中搜尋結構描述)**。在**搜尋 EventBridge 結構描述**對話方塊中，開始輸入您要尋找的結構描述名稱。對話方塊會顯示包含相符項目的結構描述標題。

如要在相符項目清單中檢視結構描述，請執行以下其中一項作業：
+ 如要在編輯器中顯示結構描述，請在 **AWS Explorer** 中，以滑鼠右鍵按一下結構描述的標題，然後選擇 **View Schema (檢視結構描述)**。
+ 在**搜尋 EventBridge 結構描述**對話方塊中，選擇結構描述標題以顯示該結構描述。

## 為可用的結構描述產生程式碼
<a name="eventbridge-schemas-generate-code"></a>

1. 在 [**AWS Explorer**](aws-explorer.md) 工具視窗顯示的情況下，展開 **Schemas (結構描述)**。

1. 展開登錄的名稱，內含您想產生程式碼的結構描述。

1. 在結構描述的標題上按一下滑鼠右鍵，然後選擇 **Download code bindings (下載程式碼繫結)**。

1. 在 **Download code bindings (下載程式碼繫結)** 對話方塊中，選擇以下項目：
   + 要為其產生程式碼的結構描述 **Version (版本)**。
   + 要為其產生程式碼的支援程式設計 **Language (語言)** 和語言版本。
   + 您要在本機開發機器上存放產生程式碼的 **File location (檔案位置)**。

1. 選擇 **Download** (下載)。

## 建立使用可用結構描述的 AWS Serverless Application Model 應用程式
<a name="eventbridge-schemas-serverless-app"></a>

1. 在 **File (檔案)** 選單上，選擇 **New (新增)**、**Project (專案)**。

1. 在 **New Project (新增專案)** 對話方塊中，選擇 **AWS**。

1. 選擇 **AWS 無伺服器應用程式**，然後選擇 **Next (下一步)**。

1. 指定下列內容：
   + 專案的 **Project name (專案名稱)**。
   + 專案在您本機開發電腦上的 **Project location (專案位置)**。
   + 專案的支援 AWS Lambda **Runtime (執行時間)**。
   + 專案的 AWS Serverless Application Model (AWS SAM) **SAM Template (SAM 範本)**。目前的選項包括下列項目：
     + **AWS SAM EventBridge Hello World (EC2 執行個體狀態變更)**：若部署此項，系統會在您的 AWS 帳戶中建立 AWS Lambda 函數和相關聯的 Amazon API Gateway 端點。根據預設，函數和端點只會回應 Amazon EC2 執行個體狀態變更。
     + **從頭開始建立 AWS SAM EventBridge 應用程式 (適用於結構描述登錄檔中的任何事件觸發程序)**：若部署此項，系統會在您的 AWS 帳戶中建立 AWS Lambda 函數和相關聯的 Amazon API Gateway 端點。此函數和端點可以回應您指定結構描述中可用的事件。

       如果您選擇此範本，您還必須指定下列項目：
       + 要使用的具名描述檔、**Credentials (登入資料)**。
       + 要使用的 AWS **Region (區域)**。
       + 要使用的 EventBridge **事件結構描述**。
   + 要用於專案的軟體開發套件版本 (**Project SDK (專案開發套件))**。

在建立 AWS 無伺服器應用程式專案後，您可以執行以下作業：
+ [部署應用程式](sam-sync.md)
+ [變更 (更新) 應用程式的設定](sam-update.md)
+ [刪除已部署的應用程式](sam-delete.md)

您也可以使用屬於應用程式一部分的 Lambda 函數執行下列操作：
+ [執行 (呼叫) 或偵錯函數的本機版本](invoke-lambda.md)
+ [執行 (呼叫) 函數的遠端版本](lambda-remote.md)
+ [變更函數設定](lambda-update.md)
+ [刪除函數](lambda-delete.md)