如何通过AWS CLI将API Gateway集成类型改为HTTP_PROXY并批量更新？

1. 修正单个方法的集成配置命令 #

你遇到的update-integration命令错误，是因为该命令仅用于增量更新现有集成的属性，并不支持直接修改集成类型。要切换到HTTP_PROXY类型，必须使用put-integration命令（该命令会创建或完全替换目标方法的集成配置）。

单个方法的正确配置命令 #

# 设置集成为HTTP_PROXY
aws apigateway put-integration `
    --rest-api-id x0cm5muxxx `
    --resource-id x1lxxx `
    --http-method GET `
    --type HTTP_PROXY `
    --integration-http-method GET `
    --uri "https://${stageVariables.Url}/api/v1/Productlist/CanOrder/{fnprodId}" `
    --request-parameters "integration.request.path.fnprodId=method.request.path.fnprodId" `
    --passthrough-behavior WHEN_NO_MATCH `
    --profile user2

# 配置200状态码的集成响应
aws apigateway put-integration-response `
    --rest-api-id x0cm5muxxx `
    --resource-id x1lxxx `
    --http-method GET `
    --status-code 200 `
    --response-status-code 200 `
    --profile user2

2. 批量遍历所有方法的PowerShell脚本 #

以下脚本会自动遍历指定API的所有资源与方法，统一配置为HTTP_PROXY集成，同时保留路径参数映射、透传行为和基础集成响应：

# 配置参数
$REST_API_ID = "x0cm5muxxx"
$PROFILE = "user2"
$BASE_URI = "https://`${stageVariables.Url}" # 转义$符号避免PowerShell提前解析

# 获取API的所有资源
$resources = aws apigateway get-resources --rest-api-id $REST_API_ID --profile $PROFILE | ConvertFrom-Json

foreach ($resource in $resources.items) {
    # 跳过无方法的资源
    if (-not $resource.methods) {
        continue
    }

    foreach ($method in $resource.methods.PSObject.Properties) {
        $httpMethod = $method.Name
        $methodDetails = $method.Value

        # 构建目标URI：拼接基础URI与资源路径
        $targetUri = "$BASE_URI$($resource.path)"
        # 自动提取路径参数并生成映射规则
        $requestParams = @{}
        if ($methodDetails.requestParameters) {
            foreach ($param in $methodDetails.requestParameters.PSObject.Properties) {
                if ($param.Name -match "method\.request\.path\.(\w+)") {
                    $paramKey = "integration.request.path.$($matches[1])"
                    $requestParams[$paramKey] = $param.Name
                }
            }
        }

        # 转换参数为CLI接受的格式
        $requestParamsStr = $requestParams.GetEnumerator() | ForEach-Object { "$($_.Key)=$($_.Value)" }

        # 执行集成配置
        Write-Host "Configuring $httpMethod $($resource.path)..."
        aws apigateway put-integration `
            --rest-api-id $REST_API_ID `
            --resource-id $resource.id `
            --http-method $httpMethod `
            --type HTTP_PROXY `
            --integration-http-method $httpMethod `
            --uri $targetUri `
            --passthrough-behavior WHEN_NO_MATCH `
            --request-parameters $requestParamsStr `
            --profile $PROFILE

        # 配置默认200集成响应
        aws apigateway put-integration-response `
            --rest-api-id $REST_API_ID `
            --resource-id $resource.id `
            --http-method $httpMethod `
            --status-code 200 `
            --response-status-code 200 `
            --profile $PROFILE
    }
}

Write-Host "批量配置完成"

脚本说明 #

• 自动适配路径：根据资源路径自动生成目标URI，无需手动逐个填写
• 参数映射自动化：识别方法中的路径参数，自动生成集成请求参数映射规则
• 多方法支持：兼容GET/POST/PUT/DELETE等所有HTTP方法，保持方法与集成的HTTP方法一致
• 透传逻辑固定：设置WHEN_NO_MATCH透传行为，确保请求与响应按预期透传

3. 验证配置 #

执行完成后，可通过以下命令验证单个方法的集成配置是否符合预期：

aws apigateway get-integration --rest-api-id x0cm5muxxx --resource-id x1lxxx --http-method GET --profile user2

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