AWS Lambda Funktions- und Parameterreferenz

Im Folgenden finden Sie die Referenz für die Funktionen und Parameter, die zum Aufrufen von Lambda mit Aurora PostgreSQL .

aws_lambda.invoke

Führt eine Lambda-Funktion für eine Aurora PostgreSQL DB-Cluster-RDS aus.

Weitere Informationen zum Aufrufen von Lambda-Funktionen finden Sie unter Invoke (Aufrufen) auch im AWS Lambda-Entwicklerhandbuch.

Syntax

JSON

aws_lambda.invoke(
IN function_name TEXT,
IN payload JSON,
IN region TEXT DEFAULT NULL,
IN invocation_type TEXT DEFAULT 'RequestResponse',
IN log_type TEXT DEFAULT 'None',
IN context JSON DEFAULT NULL,
IN qualifier VARCHAR(128) DEFAULT NULL,
OUT status_code INT,
OUT payload JSON,
OUT executed_version TEXT,
OUT log_result TEXT)

aws_lambda.invoke(
IN function_name aws_commons._lambda_function_arn_1,
IN payload JSON,
IN invocation_type TEXT DEFAULT 'RequestResponse',
IN log_type TEXT DEFAULT 'None',
IN context JSON DEFAULT NULL,
IN qualifier VARCHAR(128) DEFAULT NULL,
OUT status_code INT,
OUT payload JSON,
OUT executed_version TEXT,
OUT log_result TEXT)

JSONB

aws_lambda.invoke(
IN function_name TEXT,
IN payload JSONB,
IN region TEXT DEFAULT NULL,
IN invocation_type TEXT DEFAULT 'RequestResponse',
IN log_type TEXT DEFAULT 'None',
IN context JSONB DEFAULT NULL,
IN qualifier VARCHAR(128) DEFAULT NULL,
OUT status_code INT,
OUT payload JSONB,
OUT executed_version TEXT,
OUT log_result TEXT)

aws_lambda.invoke(
IN function_name aws_commons._lambda_function_arn_1,
IN payload JSONB,
IN invocation_type TEXT DEFAULT 'RequestResponse',
IN log_type TEXT DEFAULT 'None',
IN context JSONB DEFAULT NULL,
IN qualifier VARCHAR(128) DEFAULT NULL,
OUT status_code INT,
OUT payload JSONB,
OUT executed_version TEXT,
OUT log_result TEXT
)

Eingabeparameter

function_name

Der spezifizierte Name der Lambda-Funktion. Der Wert kann der Funktionsname, ein ARN oder ein partieller ARN sein. Eine Auflistung möglicher Formate finden Sie unter Lambda Funktionsnamenformate im AWS Lambda-Entwicklerhandbuch.

Nutzlast

Die Eingabe für die Funktion Lambda. Das Format kann JSON oder JSONB sein. Weitere Informationen finden Sie in der PostgreSQL-Dokumentation zu JSON Types.

region

(Optional) Die Lambda-Region für die Funktion. Standardmäßig verwendet Aurora die AWS-Region aus dem vollständigen ARN in der function_name oder die Aurora PostgreSQL -DB-Instance-Region. Wenn dieser Region-Wert mit dem im function_name ARN angegebenen Wert in Konflikt steht, wird ein Fehler ausgelöst.

invocation_type

Die Aufruftyp der Lambda-Funktion. Bei -Wert ist die Groß- und Kleinschreibung zu beachten. Die folgenden Werte sind möglich:

• RequestResponse – Der Standardwert. Diese Art des Aufrufens für eine Lambda-Funktion ist synchron und gibt eine Antwortnutzlast im Ergebnis zurück. Verwenden Sie den RequestResponse Aufruftyp, wenn Ihr Workflow vom sofortigen Erhalt des Lambda-Funktionsergebnisses abhängt.

• Event – Diese Art des Aufrufs für eine Lambda-Funktion ist asynchron und wird sofort ohne Rückgabe einer Nutzlast zurückgegeben. Verwenden Sie den Event-Aufruftyp, wenn Sie keine Ergebnisse der Lambda-Funktion benötigen, bevor Ihr Workflow weitergeht.

• DryRun – Diese Art des Aufrufs testet den Zugriff, ohne die Lambda-Funktion auszuführen.

log_typ

Der Typ des Lambda-Protokolls, das im Ausgabeparameter log_result ausgegeben werden soll. Bei -Wert ist die Groß- und Kleinschreibung zu beachten. Die folgenden Werte sind möglich:

• Tail – Der zurückgegebene Ausgabeparameter log_result enthält die letzten 4 KB des Ausführungsprotokolls.

• Keiner – Es werden keine Lambda-Protokollinformationen zurückgegeben.

context

Client-Kontext im JSON- oder JSONB-Format. Zu verwendende Felder sind dann custom und env.

Qualifier

Ein Qualifier, der die aufzurufende Version einer Lambda-Funktion spezifiziert. Wenn dieser Wert mit einem im function_name ARN angegebenen Wert in Konflikt steht, wird ein Fehler ausgelöst.

Ausgabeparameter

status_code

Ein HTTP-Status-Antwortcode. Weitere Informationen finden Sie unter Lambda Antwortelemente aufrufen im AWS Lambda-Entwicklerhandbuch.

Nutzlast

Die von der ausgeführten Lambda-Funktion zurückgegebenen Daten. Das Format ist in JSON oder JSONB.

executed_version

Die Version der Lambda-Funktion, die ausgeführt wurde.

log_resultat

Die Ausführungsprotokollinformationen werden zurückgegeben, wenn der Wert log_type beim Aufruf der Lambda-Funktion Tail beträgt. Das Ergebnis enthält die letzten 4 KB des in Base64 codierten Ausführungsprotokolls.

aws_commons.create_lambda_function_arn

Erstellt eine aws_commons._lambda_function_arn_1-Struktur für Daten zum Lambda Funktionsnamen. Sie können die Ergebnisse der aws_commons.create_lambda_function_arn-Funktion im Parameter function_name der aws_lambda.invoke-Funktion aws_lambda.invoke verwenden.

Syntax

aws_commons.create_lambda_function_arn(
    function_name TEXT,
    region TEXT DEFAULT NULL
    )
    RETURNS aws_commons._lambda_function_arn_1

Eingabeparameter

function_name

Eine erforderliche Textzeichenfolge mit dem Lambda-Funktionsnamen. Der Wert kann ein Funktionsname, ein partieller ARN oder ein vollständiger ARN sein.

region

Eine optionale Textzeichenfolge mit der AWS-Region, in der sich die Lambda-Funktion befindet. Eine Liste der -Regionsnamen und der zugehörigen Werte finden Sie unter Regionen und Availability Zones.

aws_lambda-Parameter

In dieser Tabelle finden Sie Parameter, die der aws_lambda Funktion zugeordnet sind.

Parameter	Beschreibung
aws_lambda.connect_timeout_ms	Dies ist ein dynamischer Parameter, der die maximale Wartezeit beim Herstellen einer Verbindung mit AWS Lambda festlegt. Die Standardwerte sind 1000. Zulässige Werte für diesen Parameter sind 1 bis 90 000.
aws_lambda.request_timeout_ms	Dies ist ein dynamischer Parameter und er legt die maximale Wartezeit fest, während er auf die Antwort von AWS Lambda wartet. Die Standardwerte sind 3000. Zulässige Werte für diesen Parameter sind 1 bis 90 000.
aws_lambda.endpoint_override	Gibt den Endpunkt an, der für die Verbindung mit AWS Lambda verwendet werden kann. Eine leere Zeichenfolge wählt den StandardAWS-Lambda-Endpunkt für die Region aus. Sie müssen die Datenbank neu starten, damit diese statische Parameteränderung wirksam wird.