为何Snowflake调用AWS API Gateway默认用POST？能否强制用GET？

问题背景 #

配置Snowflake调用AWS API Gateway的外部函数时，出现API Gateway资源策略403错误，错误显示Snowflake发起的POST请求未获授权，但该POST路由本身测试可正常运行。

错误信息 #

Request failed for external function SEND_REMINDER_EMAIL_EXTERNAL_FUNCTION with remote service error: 403 '{"Message":"User: arn:aws:sts::####:assumed-role/SnowflakeExternalFunctionRole/snowflake is not authorized to perform: execute-api:Invoke on resource: arn:aws:execute-api:xx-xxxx-1:********xxxx:xxxx/v1/POST/sendemail"}'

配置代码 #

API集成配置

create or replace api integration send_email_api_integration
    api_provider = aws_api_gateway
    api_aws_role_arn = 'arn:aws:iam::xxxxxxx:role/SnowflakeExternalFunctionRole'
    enabled = true
    api_allowed_prefixes = ('https://xxxxx.execute-api.xx-xxxx-1.amazonaws.com/v1/sendemail');

外部函数配置

create or replace external function xxxxx.send_reminder_email_external_function
    ()
    returns variant
    api_integration = send_email_api_integration
    as 'https://xxxx.execute-api.xx-xxxx-1.amazonaws.com/v1/sendemail';

解答 #

1. Snowflake默认使用POST请求的原因 #

• 外部函数设计为批量处理数据请求，POST请求通过请求体承载数据，能高效传递多行/批量输入参数，适配Snowflake的批量数据处理场景。
• GET请求受URL长度限制，无法支持大规模数据传递，不符合外部函数的核心设计需求。

2. 能否强制使用GET请求？ #

Snowflake外部函数不支持强制切换为GET请求，其底层调用逻辑固定为POST方法，属于外部函数服务的固有设计，无法通过配置修改。

问题修正方案 #

既然POST路由本身可正常运行，问题根源在API Gateway资源策略权限配置，可按以下操作修正：

• 更新API Gateway的资源策略，允许Snowflake角色对目标路径的POST方法拥有execute-api:Invoke权限，确保策略中的资源ARN包含POST方法路径（即错误信息中显示的arn:aws:execute-api:xx-xxxx-1:********xxxx:xxxx/v1/POST/sendemail）。
• 确认Snowflake的API集成配置中api_allowed_prefixes设置正确，只要前缀是实际请求URL的起始部分即可，无需额外修改。

内容的提问来源于stack exchange，提问作者user68288