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