Referenz für API-Gateway-Stufenvariablen für HTTP-APIs in API Gateway - Amazon API Gateway

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Referenz für API-Gateway-Stufenvariablen für HTTP-APIs in API Gateway

Sie können die API-Gateway-Stufenvariablen in den folgenden Fällen verwenden.

HTTP-Integrations-URIs

Sie können eine Stufenvariable als Teil einer HTTP-Integrations-URI verwenden, wie in den folgenden Beispielen gezeigt.

  • Eine vollständige URI ohne Protokoll – http://${stageVariables.<variable_name>}

  • Eine vollständige Domäne – http://${stageVariables.<variable_name>}/resource/operation

  • Eine Unterdomäne – http://${stageVariables.<variable_name>}.example.com/resource/operation

  • Ein Pfad – http://example.com/${stageVariables.<variable_name>}/bar

  • Eine Abfragezeichenfolge – http://example.com/foo?q=${stageVariables.<variable_name>}

Lambda-Funktionen

Sie können eine Stufenvariable anstelle eines Integrationsnamens oder Alias für die Lambda-Funktion verwenden, wie in den folgenden Beispielen gezeigt.

  • arn:aws:apigateway:<region>:lambda:path/2015-03-31/functions/arn:aws:lambda:<region>:<account_id>:function:${stageVariables.<function_variable_name>}/invocations

  • arn:aws:apigateway:<region>:lambda:path/2015-03-31/functions/arn:aws:lambda:<region>:<account_id>:function:<function_name>:${stageVariables.<version_variable_name>}/invocations

Anmerkung

Um eine Stufenvariable für eine Lambda-Funktion zu verwenden, muss sich die Funktion im selben Konto wie die API befinden. Stufenvariablen unterstützen keine kontoübergreifenden Lambda-Funktionen.

AWS-Integrationsanmeldeinformationen

Sie können eine Stufenvariable als Teil eines ARN für AWS-Benutzer- oder Rollenanmeldeinformationen verwenden, wie im folgenden Beispiel gezeigt.

  • arn:aws:iam::<account_id>:${stageVariables.<variable_name>}