Invocación de funciones de Lambda con aislamiento de inquilinos

Cuando invoca una función que tiene habilitado el aislamiento de inquilinos, debe proporcionar un parámetro de tenant-id. Este parámetro garantiza que la invocación de la función se procese en un entorno de ejecución dedicado a ese inquilino específico.

Invocación de funciones con aislamiento de inquilinos (AWS CLI)

Invocación síncrona

Para las invocaciones sincrónicas, añada el parámetro --tenant-id a su comando Invocar:

aws lambda invoke \
    --function-name image-analysis \
    --tenant-id blue \
    response.json

Invocación asincrónica

Para las invocaciones asíncronas, incluya los parámetros --tenant-id y --invocation-type Event:

aws lambda invoke \
    --function-name image-analysis \
    --tenant-id blue \
    --invocation-type Event \
    response.json

Invocación de funciones con aislamiento de inquilinos (API)

Cuando utilice la acción de la API Invocar directamente, incluya el identificador del inquilino mediante el parámetro X-Amzn-Tenant-Id en su solicitud.

Ejemplo de solicitud de API

POST /2015-03-31/functions/image-analysis/invocations HTTP/1.1
Host: lambda.us-east-1.amazonaws.com
Content-Type: application/json
Authorization: AWS4-HMAC-SHA256 Credential=...
X-Amz-Tenant-Id: blue

{
    "key1": "value1",
    "key2": "value2"
}

Invocación de funciones con aislamiento de inquilinos (API Gateway)

Cuando utilice las API de REST de API Gateway para desencadenar funciones de Lambda aisladas por inquilino, debe configurar API Gateway para asignar las propiedades de las solicitudes del cliente al encabezado X-Amz-Tenant-Id que Lambda espera. API Gateway utiliza la acción de la API invocar de Lambda, que requiere que el identificador de inquilino se envíe mediante el encabezado HTTP X-Amz-Tenant-Id. Puede configurar API Gateway para que inyecte este encabezado HTTP en la solicitud de invocación de Lambda con un valor obtenido de las propiedades de la solicitud del cliente, como los encabezados HTTP, los parámetros de consulta o los parámetros de ruta. Primero debe asignar la propiedad de la solicitud del cliente antes de anular el encabezado X-Amz-Tenant-Id.

Uso de encabezados de solicitud

Configure la integración con API Gateway para asignar un encabezado personalizado de la solicitud del cliente al encabezado X-Amz-Tenant-Id. A continuación, se muestra un ejemplo de solicitud del cliente con un encabezado x-tenant-id:

POST /api/process HTTP/1.1
Host: your-api-id.execute-api.us-east-1.amazonaws.com
Content-Type: application/json
x-tenant-id: blue

{
    "data": "sample payload"
}

En la configuración del método API Gateway, debe realizar lo siguiente:

Uso de parámetros de consulta

Del mismo modo, puede asignar los parámetros de consulta al encabezado X-Amz-Tenant-Id:

GET /api/process?tenant-id=blue&data=sample HTTP/1.1
Host: your-api-id.execute-api.us-east-1.amazonaws.com

Configure el método para habilitar el parámetro de consulta y asignarlo al encabezado de integración.

Invocación de funciones con aislamiento de inquilinos (SDK)

Cuando utilice los AWS SDK para invocar funciones aisladas por inquilino, incluya el identificador del inquilino en su solicitud de invocación.

Python

import boto3
import json

lambda_client = boto3.client('lambda')

response = lambda_client.invoke(
    FunctionName='image-analysis',
    TenantId='blue',
    Payload=json.dumps({
        'key1': 'value1',
        'key2': 'value2'
    })
)

result = json.loads(response['Payload'].read())

Node.js

const AWS = require('aws-sdk');
const lambda = new AWS.Lambda();

const params = {
    FunctionName: 'image-analysis',
    TenantId: 'blue',
    Payload: JSON.stringify({
        key1: 'value1',
        key2: 'value2'
    })
};

lambda.invoke(params, (err, data) => {
    if (err) {
        console.error(err);
    } else {
        const result = JSON.parse(data.Payload);
        console.log(result);
    }
});

Java

import software.amazon.awssdk.services.lambda.LambdaClient;
import software.amazon.awssdk.services.lambda.model.InvokeRequest;
import software.amazon.awssdk.services.lambda.model.InvokeResponse;
import software.amazon.awssdk.core.SdkBytes;

public class TenantIsolationExample {

    public static void main(String[] args) {
        LambdaClient lambdaClient = LambdaClient.create();

        String payload = "{\"key1\": \"value1\", \"key2\": \"value2\"}";

        InvokeRequest request = InvokeRequest.builder()
                .functionName("image-analysis")
                .tenantId("blue")
                .payload(SdkBytes.fromUtf8String(payload))
                .build();

        InvokeResponse response = lambdaClient.invoke(request);
    }
}