Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Dalam integrasi Lambda non-proxy (kustom), fungsi Lambda backend dipanggil secara sinkron secara default. Ini adalah perilaku yang diinginkan untuk sebagian besar operasi REST API. Beberapa aplikasi, bagaimanapun, memerlukan pekerjaan yang harus dilakukan secara asinkron (sebagai operasi batch atau operasi latensi panjang), biasanya oleh komponen backend terpisah. Dalam hal ini, fungsi Lambda backend dipanggil secara asinkron, dan metode REST API front-end tidak mengembalikan hasilnya.
Anda dapat mengonfigurasi fungsi Lambda agar integrasi non-proxy Lambda dipanggil secara asinkron dengan menentukan sebagai jenis pemanggilan Lambda. 'Event' Ini dilakukan sebagai berikut:
Konfigurasikan pemanggilan asinkron Lambda di konsol API Gateway
Agar semua pemanggilan menjadi asinkron:
-
Dalam permintaan Integrasi, tambahkan
X-Amz-Invocation-Typeheader dengan nilai statis'Event'.
Bagi klien untuk memutuskan apakah pemanggilan asinkron atau sinkron:
-
Dalam permintaan Metode, tambahkan
InvocationTypeheader. -
Dalam permintaan Integrasi tambahkan
X-Amz-Invocation-Typeheader dengan ekspresi pemetaan.method.request.header.InvocationType -
Klien dapat menyertakan
InvocationType: Eventheader dalam permintaan API untuk pemanggilan asinkron atau untuk pemanggilan sinkron.InvocationType: RequestResponse
Konfigurasikan pemanggilan asinkron Lambda menggunakan OpenAPI
Agar semua pemanggilan menjadi asinkron:
-
Tambahkan
X-Amz-Invocation-Typeheader ke x-amazon-apigateway-integrationbagian."x-amazon-apigateway-integration" : { "type" : "aws", "httpMethod" : "POST", "uri" : "arn:aws:apigateway:us-east-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-east-2:123456789012:function:my-function/invocations", "responses" : { "default" : { "statusCode" : "200" } }, "requestParameters" : { "integration.request.header.X-Amz-Invocation-Type" : "'Event'" }, "passthroughBehavior" : "when_no_match", "contentHandling" : "CONVERT_TO_TEXT" }
Bagi klien untuk memutuskan apakah pemanggilan asinkron atau sinkron:
-
Tambahkan header berikut pada OpenAPI Path Item
Object. "parameters" : [ { "name" : "InvocationType", "in" : "header", "schema" : { "type" : "string" } } ] -
Tambahkan
X-Amz-Invocation-Typeheader ke x-amazon-apigateway-integrationbagian."x-amazon-apigateway-integration" : { "type" : "aws", "httpMethod" : "POST", "uri" : "arn:aws:apigateway:us-east-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-east-2:123456789012:function:my-function/invocations", "responses" : { "default" : { "statusCode" : "200" } }, "requestParameters" : { "integration.request.header.X-Amz-Invocation-Type" : "method.request.header.InvocationType" }, "passthroughBehavior" : "when_no_match", "contentHandling" : "CONVERT_TO_TEXT" } -
Klien dapat menyertakan
InvocationType: Eventheader dalam permintaan API untuk pemanggilan asinkron atau untuk pemanggilan sinkron.InvocationType: RequestResponse
Konfigurasikan pemanggilan asinkron Lambda menggunakan AWS CloudFormation
AWS CloudFormation Template berikut menunjukkan cara mengkonfigurasi AWS::ApiGateway::Method untuk pemanggilan asinkron.
Agar semua pemanggilan menjadi asinkron:
AsyncMethodGet: Type: 'AWS::ApiGateway::Method' Properties: RestApiId: !Ref Api ResourceId: !Ref AsyncResource HttpMethod: GET ApiKeyRequired: false AuthorizationType: NONE Integration: Type: AWS RequestParameters: integration.request.header.X-Amz-Invocation-Type: "'Event'" IntegrationResponses: - StatusCode: '200' IntegrationHttpMethod: POST Uri: !Sub arn:aws:apigateway:${AWS::Region}:lambda:path/2015-03-31/functions/${myfunction.Arn}$/invocations MethodResponses: - StatusCode: '200'
Bagi klien untuk memutuskan apakah pemanggilan asinkron atau sinkron:
AsyncMethodGet: Type: 'AWS::ApiGateway::Method' Properties: RestApiId: !Ref Api ResourceId: !Ref AsyncResource HttpMethod: GET ApiKeyRequired: false AuthorizationType: NONE RequestParameters: method.request.header.InvocationType: false Integration: Type: AWS RequestParameters: integration.request.header.X-Amz-Invocation-Type: method.request.header.InvocationType IntegrationResponses: - StatusCode: '200' IntegrationHttpMethod: POST Uri: !Sub arn:aws:apigateway:${AWS::Region}:lambda:path/2015-03-31/functions/${myfunction.Arn}$/invocations MethodResponses: - StatusCode: '200'
Klien dapat menyertakan InvocationType: Event header dalam permintaan API untuk pemanggilan asinkron atau untuk pemanggilan sinkron. InvocationType:
RequestResponse
