เป้าหมาย
เปิด Lambda ให้เรียกผ่าน HTTP ได้สามแบบ เลือกแบบที่เหมาะ (Function URL, HTTP API, REST API) ตั้ง auth ให้ปลอดภัย ตั้ง CORS ให้ browser เรียกได้เฉพาะโดเมนของเรา และจำกัด rate กันบิลบาน
สามทางสู่ HTTP
| Lambda Function URL | API Gateway HTTP API | API Gateway REST API | |
|---|---|---|---|
| คืออะไร | URL ตรงของฟังก์ชันเดียว | API gateway รุ่นใหม่ เบาและถูก | API gateway รุ่นแรก ฟีเจอร์ครบ |
| ราคา | ไม่มีค่าเพิ่ม (จ่ายแค่ Lambda) | ~$1.00 ต่อล้าน request | ~$3.50 ต่อล้าน request |
| route หลายเส้น → หลายฟังก์ชัน | ❌ (route เองในโค้ด) | ✅ | ✅ |
| auth | AWS_IAM หรือ NONE |
IAM, JWT (Cognito/Auth0/...), Lambda authorizer | IAM, Cognito, Lambda authorizer, API key + usage plan |
| custom domain | ❌ ตรงๆ (ใช้ CloudFront หน้า) | ✅ | ✅ |
| throttling ต่อ route | ❌ (ใช้ reserved concurrency) | ✅ | ✅ + ต่อ client ด้วย usage plan |
| อื่นๆ | response streaming | CORS ในตัว, auto-deploy | request validation, cache, WAF ตรง, private API |
เลือกง่ายๆ: webhook/ฟังก์ชันเดียว/หลัง CloudFront → Function URL · API ทั่วไปของเว็บ/แอป → HTTP API · ต้องการ API key ขายให้ลูกค้า, WAF ตรง, validation, private API → REST API
⚠️ ต้องตรวจสอบ: ราคาและฟีเจอร์ต่าง region/เปลี่ยนได้ ดู https://aws.amazon.com/api-gateway/pricing/ และหน้า "Choose between REST APIs and HTTP APIs" ในเอกสาร
event ที่ Lambda ได้รับ (payload 2.0)
HTTP API และ Function URL ส่ง event รูปแบบเดียวกัน:
{
"rawPath": "/hello",
"rawQueryString": "name=dao",
"queryStringParameters": { "name": "dao" },
"headers": { "content-type": "application/json", "origin": "https://example.com" },
"requestContext": { "http": { "method": "POST", "sourceIp": "203.0.113.10" } },
"body": "{\"item\":\"latte\"}",
"isBase64Encoded": false
}ตอบกลับด้วย { statusCode, headers, body } — body ต้องเป็น string (ใช้ JSON.stringify)
Auth — ใครเรียกได้
| วิธี | ใช้เมื่อ |
|---|---|
NONE / ไม่มี authorizer |
API สาธารณะจริงๆ (ต้องมี throttling และ validate input เอง) |
| IAM (SigV4) | service-to-service ใน AWS, ข้ามบัญชี |
| JWT authorizer (HTTP API) | ผู้ใช้ล็อกอินผ่าน Cognito/Auth0/Google — gateway ตรวจ token ให้ก่อนถึง Lambda |
| Lambda authorizer | logic เฉพาะ เช่น ตรวจ API key จากฐานข้อมูลของเรา |
Function URL แบบ
NONE= ใครมี URL ก็เรียกได้และคุณจ่ายทุกครั้ง — ใส่ reserved concurrency จำกัดเพดานเสมอ
CORS ในสองนาที
- browser ที่หน้าเว็บอยู่
https://example.comเรียก API ที่อีกโดเมน → browser ถามก่อนด้วย preflightOPTIONSแล้วดู headerAccess-Control-Allow-Origin - CORS ไม่ใช่ระบบความปลอดภัยของ API — curl/สคริปต์เรียกได้เสมอ มันแค่บอก browser ว่าหน้าเว็บโดเมนไหนอ่านผลได้
- ตั้งที่ gateway หรือ Function URL ที่เดียว อย่าตั้งซ้ำในโค้ด Lambda ด้วย (header ซ้ำ → browser ปฏิเสธ)
- อย่าใช้
*คู่กับ credentials (cookie) — ระบุโดเมนจริง
ลองเลย 🧪
อยู่ในโควตาฟรี/ค่าใช้จ่ายระดับเศษสตางค์ — เก็บกวาดท้ายบท
export AWS_PROFILE=learn # profile SSO ที่ตั้งไว้ในระดับ 2
export AWS_REGION=ap-southeast-1
aws sso login
export ACCOUNT_ID=$(aws sts get-caller-identity --query Account --output text)
mkdir -p api-lab && cd api-labทดลอง A — ฟังก์ชันที่เข้าใจ HTTP event
cat > trust.json <<'EOF'
{ "Version": "2012-10-17",
"Statement": [{ "Effect": "Allow", "Principal": { "Service": "lambda.amazonaws.com" }, "Action": "sts:AssumeRole" }] }
EOF
aws iam create-role --role-name lab-api-role --assume-role-policy-document file://trust.json > /dev/null
aws iam attach-role-policy --role-name lab-api-role \
--policy-arn arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole
sleep 10
cat > index.mjs <<'EOF'
const json = (statusCode, data) => ({
statusCode,
headers: { "content-type": "application/json; charset=utf-8" },
body: JSON.stringify(data),
});
export const handler = async (event) => {
const method = event.requestContext?.http?.method;
const path = event.rawPath;
if (method === "GET" && path === "/hello") {
return json(200, { message: `สวัสดี ${event.queryStringParameters?.name ?? "คุณ"}` });
}
if (method === "POST" && path === "/orders") {
let body;
try { body = JSON.parse(event.body ?? ""); } catch { return json(400, { error: "body ต้องเป็น JSON" }); }
if (typeof body.item !== "string" || body.item.length > 50) return json(400, { error: "item ไม่ถูกต้อง" });
return json(201, { orderId: crypto.randomUUID(), item: body.item });
}
return json(404, { error: "not found" });
};
EOF
zip -q fn.zip index.mjs
aws lambda create-function --function-name lab-api-fn --runtime nodejs24.x --architectures arm64 \
--handler index.handler --zip-file fileb://fn.zip --memory-size 256 --timeout 5 \
--role arn:aws:iam::$ACCOUNT_ID:role/lab-api-role --query FunctionArn --output text
aws lambda wait function-active-v2 --function-name lab-api-fnทดลอง B — Function URL (ต้องเพิ่มสิทธิ์ 2 ข้อ)
FURL=$(aws lambda create-function-url-config --function-name lab-api-fn --auth-type NONE \
--cors '{"AllowOrigins":["https://example.com"],"AllowMethods":["GET","POST"],"AllowHeaders":["content-type"]}' \
--query FunctionUrl --output text)
curl -s -o /dev/null -w "ก่อนเพิ่มสิทธิ์: %{http_code}\n" "${FURL}hello"
aws lambda add-permission --function-name lab-api-fn --statement-id url-invoke-url \
--action lambda:InvokeFunctionUrl --principal '*' --function-url-auth-type NONE > /dev/null
aws lambda add-permission --function-name lab-api-fn --statement-id url-invoke-fn \
--action lambda:InvokeFunction --principal '*' --invoked-via-function-url > /dev/null
sleep 5
curl -s "${FURL}hello?name=dao"; echo
curl -s -X POST "${FURL}orders" -H 'content-type: application/json' -d '{"item":"latte"}'; echo
curl -s -X POST "${FURL}orders" -H 'content-type: application/json' -d 'not-json'; echoผลที่ควรเห็น:
ก่อนเพิ่มสิทธิ์: 403
{"message":"สวัสดี dao"}
{"orderId":"5f0c...","item":"latte"}
{"error":"body ต้องเป็น JSON"}→ auth type NONE ไม่ได้แปลว่าเปิดเอง ต้องมี resource policy ครบสองข้อ (CLI ไม่สร้างให้ ต่างจาก console)
จำกัดเพดานความเสียหาย:
aws lambda put-function-concurrency --function-name lab-api-fn --reserved-concurrent-executions 5⚠️ ถ้าบัญชีใหม่มี concurrency รวมต่ำ คำสั่งนี้อาจถูกปฏิเสธเพราะต้องเหลือ unreserved ขั้นต่ำ — ข้ามได้ (ดู quota ด้วย
aws lambda get-account-settings)
ทดลอง C — HTTP API แบบ quick create + CORS
API_ID=$(aws apigatewayv2 create-api --name lab-http-api --protocol-type HTTP \
--target arn:aws:lambda:$AWS_REGION:$ACCOUNT_ID:function:lab-api-fn \
--cors-configuration '{"AllowOrigins":["https://example.com"],"AllowMethods":["GET","POST"],"AllowHeaders":["content-type"]}' \
--query ApiId --output text)
aws lambda add-permission --function-name lab-api-fn --statement-id apigw-invoke \
--action lambda:InvokeFunction --principal apigateway.amazonaws.com \
--source-arn "arn:aws:execute-api:$AWS_REGION:$ACCOUNT_ID:$API_ID/*" > /dev/null
API=$(aws apigatewayv2 get-api --api-id $API_ID --query ApiEndpoint --output text)
curl -s "$API/hello?name=api"; echo
curl -s -i -X OPTIONS "$API/orders" -H "Origin: https://example.com" \
-H "Access-Control-Request-Method: POST" | grep -i access-control-allow-origin
curl -s -i -X OPTIONS "$API/orders" -H "Origin: https://evil.example" \
-H "Access-Control-Request-Method: POST" | grep -i access-control-allow-origin || echo "(ไม่มี header = browser จะบล็อก)"ผลที่ควรเห็น:
{"message":"สวัสดี api"}
access-control-allow-origin: https://example.com
(ไม่มี header = browser จะบล็อก)→ quick create สร้าง route $default, integration แบบ proxy และ stage $default ที่ auto-deploy ให้ในคำสั่งเดียว · --source-arn จำกัดให้เฉพาะ API นี้เรียกฟังก์ชันได้
ทดลอง D — throttling กันโดนยิง
aws apigatewayv2 update-stage --api-id $API_ID --stage-name '$default' \
--default-route-settings ThrottlingBurstLimit=2,ThrottlingRateLimit=1 > /dev/null
sleep 5
for i in $(seq 1 10); do curl -s -o /dev/null -w "%{http_code} " "$API/hello"; done; echoผลที่ควรเห็น (ตัวเลขสลับกันได้):
200 200 429 429 200 429 429 429 429 429→ เกินเพดานได้ 429 Too Many Requests จาก gateway โดยไม่ปลุก Lambda (ไม่เสียค่า Lambda)
ภาคต่อ (อ่านอย่างเดียว) — JWT authorizer กับ Cognito
aws apigatewayv2 create-authorizer --api-id $API_ID --name cognito-jwt \
--authorizer-type JWT --identity-source '$request.header.Authorization' \
--jwt-configuration '{"Audience":["[app client id]"],"Issuer":"https://cognito-idp.ap-southeast-1.amazonaws.com/[user pool id]"}'แล้วผูก authorizer กับ route ที่ต้องล็อกอิน — gateway ปฏิเสธ token ผิด/หมดอายุด้วย 401 ก่อนถึงโค้ดเรา
เก็บกวาด
aws apigatewayv2 delete-api --api-id $API_ID
aws lambda delete-function-url-config --function-name lab-api-fn
aws lambda delete-function --function-name lab-api-fn
aws logs delete-log-group --log-group-name /aws/lambda/lab-api-fn
aws iam detach-role-policy --role-name lab-api-role \
--policy-arn arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole
aws iam delete-role --role-name lab-api-role
cd .. && rm -rf api-labกับดักที่เจอบ่อย
| อาการ | สาเหตุ / แก้ |
|---|---|
Function URL ได้ 403 ทั้งที่ auth NONE |
ขาด permission lambda:InvokeFunctionUrl หรือ lambda:InvokeFunction (ต้องมีทั้งคู่) |
HTTP API ได้ {"message":"Internal Server Error"} |
API Gateway ไม่มีสิทธิ์เรียก Lambda (ลืม add-permission) หรือ Lambda คืน body ที่ไม่ใช่ string |
| browser ขึ้น CORS error แต่ curl ปกติ | origin ไม่ตรงทุกตัวอักษร (https://, www, port) หรือ header ซ้ำจากโค้ด + gateway |
| ส่ง Authorization header แล้ว CORS พัง | ไม่ได้ใส่ authorization ใน AllowHeaders |
| request ยาวแล้วได้ 503/504 | integration timeout ของ gateway (ราว 30 วินาที) — งานยาวให้ตอบ 202 แล้วทำต่อแบบ async (บท 03) |
| บิล Lambda พุ่งจาก URL สาธารณะ | ไม่มี throttling/reserved concurrency — ตั้งเพดาน ใช้ CloudFront + WAF หน้า |
สรุปจำง่าย
ฟังก์ชันเดียว/webhook → Function URL — API ทั่วไป → HTTP API — ต้องการ API key/WAF/validation → REST API — auth ที่ gateway ก่อนถึงโค้ด — CORS ตั้งที่เดียวและไม่ใช่ความปลอดภัย — ตั้ง throttling และ reserved concurrency เสมอ