本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
在動作群組中定義動作
您可以透過下列其中一種方式定義動作群組 (您可以針對不同的動作群組使用不同的方法):
-
設定具有描述、結構和參數的OpenAPI結構描述,將動作群組中的每個動作定義為 API 操作。使用此選項,您可以更明確地定義動作,並將其映射到系統中的 API 操作。您可以使用下列其中一種方式將 API 結構描述新增至動作群組:
-
將建立的結構描述上傳至 Amazon Simple Storage Service (Amazon S3) 儲存貯體。
-
當您新增動作群組 AWS Management Console 時,請在 的內嵌結構描述編輯器中撰寫OpenAPI結構描述。此選項只有在動作群組所屬的代理程式已建立後才能使用。
-
-
使用代理程式需要從使用者引出的參數來設定函數詳細資訊。使用此選項,您可以簡化動作群組建立程序,並設定代理程式來引出一組您定義的參數。然後,您可以將參數傳遞至您的應用程式,並自訂如何使用它們在您自己的系統中執行動作。
繼續上述範例,您可以使用下列其中一種方式定義CreateBooking
動作:
-
使用 API 結構描述,
CreateBooking
可以是具有請求內文的 API 操作,其中包含HotelName
、 和 等欄位LengthOfStay
,UserEmail
以及傳回 的回應內文BookingId
。 -
使用 函數詳細資訊,
CreateBooking
可以是使用HotelName
、LengthOfStay
和 等參數定義的函數UserEmail
。代理程式從使用者引出這些參數的值之後,您就可以將這些參數傳遞到您的系統。
當您的代理程式與使用者互動時,它將決定其需要調用的動作群組中的哪些動作。代理程式接著會引出完成 API 請求所需的參數和其他資訊,或是標記為 函數所需的參數和其他資訊。
選取主題,了解如何使用不同的方法定義動作群組。