Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Informations de référence sur les variables d’étape API Gateway pour les API HTTP dans API Gateway
Vous pouvez utiliser les variables d’étape API Gateway pour les API HTTP dans les cas suivants.
URI d’intégration HTTP
Une variable d’étape peut être utilisée dans une URI d’intégration HTTP, comme illustré dans les exemples suivants.
-
URI complet sans protocole –
http://${stageVariables.<variable_name>} -
Domaine complet –
http://${stageVariables.<variable_name>}/resource/operation -
Sous-domaine –
http://${stageVariables.<variable_name>}.example.com/resource/operation -
Chemin –
http://example.com/${stageVariables.<variable_name>}/bar -
Chaîne de requête –
http://example.com/foo?q=${stageVariables.<variable_name>}
Fonctions Lambda
Vous pouvez utiliser une variable d’étape à la place d’un nom d’intégration ou d’un alias de fonction Lambda, comme illustré dans les exemples suivants.
-
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
Note
Pour utiliser une variable d’étape pour une fonction Lambda, la fonction doit se trouver dans le même compte que l’API. Les variables d’étape ne prennent pas en charge les fonctions Lambda inter-comptes.
Informations d’identification d’intégration AWS
Vous pouvez utiliser une variable d’étape dans le cadre d’un ARN d’informations d’identification d’utilisateur AWS ou de rôle, comme illustré dans l’exemple suivant.
-
arn:aws:iam::<account_id>:${stageVariables.<variable_name>}
