本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
使用設定API閘道的 Lambda 代理伺服器整合 AWS CLI
在本節中,我們將示範 API Lambda 何使用 AWS CLI. 如需使用API閘道主控台設定具有 Lambda Proxy 整合的代理資源的詳細指示,請參閱教學課程:使RESTAPI用 Lambda 代理整合建立。
舉例來說,我們使用下列 Lambda 函數範例做為後端API:
export const handler = function(event, context, callback) { console.log('Received event:', JSON.stringify(event, null, 2)); var res ={ "statusCode": 200, "headers": { "Content-Type": "*/*" } }; var greeter = 'World'; if (event.greeter && event.greeter!=="") { greeter = event.greeter; } else if (event.body && event.body !== "") { var body = JSON.parse(event.body); if (body.greeter && body.greeter !== "") { greeter = body.greeter; } } else if (event.queryStringParameters && event.queryStringParameters.greeter && event.queryStringParameters.greeter !== "") { greeter = event.queryStringParameters.greeter; } else if (event.multiValueHeaders && event.multiValueHeaders.greeter && event.multiValueHeaders.greeter != "") { greeter = event.multiValueHeaders.greeter.join(" and "); } else if (event.headers && event.headers.greeter && event.headers.greeter != "") { greeter = event.headers.greeter; } res.body = "Hello, " + greeter + "!"; callback(null, res); };
將此值與中的 Lambda 自訂整合設定相比在API閘道中設定 Lambda 自訂整合,對此 Lambda 函數的輸入可以在請求參數和內文中表示。您可以有更多的自由,讓用戶端傳遞相同的輸入資料。在這裡,用戶端可以傳入接待員名稱以做為查詢字串參數、標頭或內文屬性。此函數也可以支援 Lambda 自訂整合。設API置更簡單。您根本不需要設定方法回應或整合回應。
若要使用設定 Lambda 代理伺服器整合 AWS CLI
-
呼叫指
create-rest-api
令來建立API:aws apigateway create-rest-api --name 'HelloWorld (AWS CLI)' --region us-west-2
在響應中注意結果API的
id
值(te6si5ach7
):{ "name": "HelloWorldProxy (AWS CLI)", "id": "te6si5ach7", "createdDate": 1508461860 }
您需要API
id
整個本節。 -
呼叫
get-resources
命令來取得根資源id
:aws apigateway get-resources --rest-api-id te6si5ach7 --region us-west-2
成功回應顯示如下:
{ "items": [ { "path": "/", "id": "krznpq9xpg" } ] }
記下根資源
id
值 (krznpq9xpg
)。下一個步驟和之後的步驟都需要它。 -
調用
create-resource
以創建以下內容的API網關資源/greeting
:aws apigateway create-resource --rest-api-id te6si5ach7 \ --region us-west-2 \ --parent-id krznpq9xpg \ --path-part {proxy+}
成功回應類似如下:
{ "path": "/{proxy+}", "pathPart": "{proxy+}", "id": "2jf6xt", "parentId": "krznpq9xpg" }
記下所產生
{proxy+}
資源的id
值 (2jf6xt
)。在下一個步驟中,您需要它才能在/{proxy+}
資源上建立方法。 -
呼叫
put-method
來建立ANY
方法請求ANY /{proxy+}
:aws apigateway put-method --rest-api-id te6si5ach7 \ --region us-west-2 \ --resource-id 2jf6xt \ --http-method ANY \ --authorization-type "NONE"
成功回應類似如下:
{ "apiKeyRequired": false, "httpMethod": "ANY", "authorizationType": "NONE" }
此API方法可讓用戶端在後端從 Lambda 函數接收或傳送問候語。
-
呼叫
put-integration
來設定具有 Lambda 函數 (即ANY /{proxy+}
) 之HelloWorld
方法的整合。如果提供"Hello, {name}!"
參數,則此函數會以greeter
訊息來回應請求,如果未設定查詢字串參數,則會以"Hello, World!"
來回應請求。aws apigateway put-integration \ --region us-west-2 \ --rest-api-id te6si5ach7 \ --resource-id 2jf6xt \ --http-method ANY \ --type AWS_PROXY \ --integration-http-method POST \ --uri arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:123456789012:function:HelloWorld/invocations \ --credentials arn:aws:iam::123456789012:role/apigAwsProxyRole
重要
對於 Lambda 整合,您必須根據 L ambda 服務動作的規格,
POST
針對函數叫用使用的HTTP方法來處理整合請求。的IAM角色apigAwsProxyRole
必須具有允許apigateway
服務叫用 Lambda 函數的政策。如需有關IAM權限的詳細資訊,請參閱 API呼叫的閘道權限模型 API。成功輸出類似如下:
{ "passthroughBehavior": "WHEN_NO_MATCH", "cacheKeyParameters": [], "uri": "arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:1234567890:function:HelloWorld/invocations", "httpMethod": "POST", "cacheNamespace": "vvom7n", "credentials": "arn:aws:iam::1234567890:role/apigAwsProxyRole", "type": "AWS_PROXY" }
您可以呼叫 add 權限命令來新增以資源為基礎的權限
credentials
,而不是提供的IAM角色。這就是API閘道主控台的作用。 -
呼叫
create-deployment
部署API到test
階段:aws apigateway create-deployment --rest-api-id te6si5ach7 --stage-name test --region us-west-2
-
在終端機中API使用以下 c URL 命令進行測試。
API使用下列項目的查詢字串參數呼叫
?greeter=jane
:curl -X GET 'https://te6si5ach7.execute-api.us-west-2.amazonaws.com/test/greeting?greeter=jane'
API使用以下標題參數調用
greeter:jane
:curl -X GET https://te6si5ach7.execute-api.us-west-2.amazonaws.com/test/hi \ -H 'content-type: application/json' \ -H 'greeter: jane'
調API用一個身體
{"greeter":"jane"}
:curl -X POST https://te6si5ach7.execute-api.us-west-2.amazonaws.com/test/hi \ -H 'content-type: application/json' \ -d '{ "greeter": "jane" }'
在所有情況下,輸出都是具有下列回應內文的 200 回應:
Hello, jane!