这可能不是完全API 网关的设计者所想的,但考虑到...
-
AWS Query API(由 SDK 使用)在线上为 SQS 等服务工作的方式——标准 application/x-www-form-urlencoded 格式的 url 编码键/值对,以及
API Gateway (VTL) 中的内置正文映射模板语言公开了$util.urlEncode(),并且
API 网关在将请求发送到后端服务时可以透明地对请求进行签名
...这意味着您可以简单地构造一个有效的 API 请求 - 一个表单帖子 - 就像使用 VTL 模板一样,它封装了原始消息正文 - urlencoded,这就是我们所需要的。我们实际上并不关心它是 JSON,只要它是有效的字符数据。
使用此解决方案,可以避免使用 Lambda 函数,并且客户端无需了解 SQS 期望消息如何格式化的任何信息。
整个传入的请求正文成为 SQS 中的Message。
在 API Gateway 控制台中:
创建资源(例如/)和方法(例如POST)。
在集成请求设置中:
Integration type: AWS Service
AWS Region: [select your region]
AWS Service: Simple Queue Service (SQS)
AWS Subdomain [leave blank]
HTTP Method: POST
Action Type: Use path override
Path override: /
Execution Role: [your role ARN, needs to be able to send a message to the queue]
Credentials cache: Do not add caller credentials to cache key
Content Handling: Passthrough
在HTTP Headers 下,添加一个标题Content-Type。该值应指定为“映射自”'application/x-www-form-urlencoded'——注意这是一个单引号字符串。
在Body Mapping Templates 下,选择Never。
添加Content-Type 的Content-Type 并使用以下映射模板:
Action=SendMessage##
&QueueUrl=$util.urlEncode('https://sqs.us-east-2.amazonaws.com/000000000000/my-queue-name')##
&MessageBody=$util.urlEncode($input.body)##
您有一个 API,可以将原始 JSON 输入正文转换为 SQS SendMessage API 请求。
每行末尾的## 是为了便于阅读——VTL 是一种文本模板语言,因此保留了空格和换行符。将## 放在每行的末尾会导致换行符被剥离,这对于构建正确的Web 表单是必要的。否则,整个身体映射模板需要在一行中。
部署然后测试:
$ curl -X POST https://xxxxxxxxxx.execute-api.us-east-2.amazonaws.com/v1 --data '{"works": true}' -H 'Content-Type: application/json'
回复:
{"SendMessageResponse":{"ResponseMetadata":{"RequestId":"bbbbbbbb-aaaa-5555-8888-334ed25bb6b3"},"SendMessageResult":{"MD5OfMessageAttributes":null,"MD5OfMessageBody":"81f2ecc3cb027268138bdfe7af0f8a3f","MessageId":"cccccccc-dddd-4444-1111-542e08bb39af","SequenceNumber":null}}}
对于额外的功劳,集成响应中的正文映射模板也可以用于自定义响应。