本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
在操作组中定义操作
您可以通过以下方式之一定义操作组(可以对不同的操作组使用不同的方法):
-
设置一个 OpenAPI包含描述、结构和参数的架构,用于将操作组中的每个操作定义为一项API操作。使用此选项,您可以更明确地定义操作并将其映射到系统中的API操作。您可以通过以下方式之一将API架构添加到操作组:
-
将您创建的架构上传到亚马逊简单存储服务 (Amazon S3) 存储桶。
-
将架构写在内联中 OpenAPI 中的架构编辑器 AWS Management Console 当你添加操作组时。只有在操作组所属的代理已经创建之后,此选项才可用。
-
-
使用代理需要从用户那里获得的参数来@@ 设置函数详细信息。使用此选项,您可以简化操作组的创建过程,并将代理设置为引出您定义的一组参数。然后,您可以将参数传递给您的应用程序,并自定义如何使用它们在自己的系统中执行操作。
继续上面的示例,您可以通过以下方式之一来定义CreateBooking
操作:
-
使用API架构,
CreateBooking
可以是具有请求正文的API操作,其中包含诸如HotelName
LengthOfStay
、UserEmail
和之类的字段,以及返回的响应正文BookingId
。 -
使用函数详细信息,
CreateBooking
可以是一个使用诸如HotelName
LengthOfStay
、和之类的参数定义的函数UserEmail
。在您的代理从用户那里获得这些参数的值后,您可以将它们传递给您的系统。
当您的代理与用户交互时,它将决定需要在操作组中调用哪个操作。然后,代理将获取完成API请求所必需的参数和其他信息,或者标记为函数所需的参数和其他信息。
选择一个主题,学习如何使用不同的方法定义操作组。