Invocation de la fonction Lambda URLs

version

La version du format de la charge utile pour cet événement. La fonction Lambda prend URLs actuellement en charge le format de charge utile version 2.0.

2.0

routeKey

Fonction : URLs n'utilisez pas ce paramètre. Lambda le définit sur $default comme espace réservé.

$default

rawPath

Chemin d’accès de la demande. Par exemple, si l’URL de la demande est https://{url-id}.lambda-url.{region}.on.aws/example/test/demo, alors la valeur du chemin brut est /example/test/demo.

/example/test/demo

rawQueryString

La chaîne brute contenant les paramètres de la chaîne de la requête de la demande. Les caractères pris en charge sont les suivants : a-z, A-Z, 0-9, ., _, -, %, &, =, et +.

"?parameter1=value1&parameter2=value2"

cookies

Un tableau contenant tous les cookies envoyés dans le cadre de la demande.

["Cookie_1=Value_1", "Cookie_2=Value_2"]

headers

La liste des en-têtes de demande, présentée sous forme de paires valeur-clé.

{"header1": "value1", "header2": "value2"}

queryStringParameters

Paramètres de requête pour la demande. Par exemple, si l’URL de la demande est https://{url-id}.lambda-url.{region}.on.aws/example?name=Jane, alors la valeur queryStringParameters est un objet JSON avec une clé name et une valeur Jane.

{"name": "Jane"}

requestContext

Un objet qui contient des informations supplémentaires sur la demande, comme requestId, l’heure de la demande, et l’identité de l’appelant s’il est autorisé via AWS Identity and Access Management (IAM).

requestContext.accountId

Compte AWS ID du propriétaire de la fonction.

"123456789012"

requestContext.apiId

L’identifiant de l’URL de la fonction.

"33anwqw8fj"

requestContext.authentication

Fonction : URLs n'utilisez pas ce paramètre. Lambda le définit sur null.

null

requestContext.authorizer

Un objet qui contient des informations sur l’identité de l’appelant si l’URL de la fonction utilise le type d’authentification AWS_IAM. Sinon, Lambda définit cette valeur sur null.

requestContext.authorizer.iam.accessKey

La clé d’accès de l’identité de l’appelant.

"AKIAIOSFODNN7EXAMPLE"

requestContext.authorizer.iam.accountId

Compte AWS Identifiant de l'identité de l'appelant.

"111122223333"

requestContext.authorizer.iam.callerId

L’ID (ID d’utilisateur) de l’appelant.

"AIDACKCEVSQ6C2EXAMPLE"

requestContext.authorizer.iam.cognitoIdentity

Fonction : URLs n'utilisez pas ce paramètre. Lambda le définit sur null ou l’exclut de JSON.

null

requestContext.authorizer.iam.principalOrgId

L’ID de l’organisation du principal associé à l’ID de l’appelant.

"AIDACKCEVSQORGEXAMPLE"

requestContext.authorizer.iam.userArn

L’Amazon Resource Name (ARN) utilisateur de l’identité de l’appelant.

"arn:aws:iam::111122223333:user/example-user"

requestContext.authorizer.iam.userId

L’identifiant utilisateur de l’identité de l’appelant.

"AIDACOSFODNN7EXAMPLE2"

requestContext.domainName

Le nom de domaine de l’URL de la fonction.

"<url-id>.lambda-url.us-west-2.on.aws"

requestContext.domainPrefix

Le nom de domaine de l’URL de la fonction.

"<url-id>"

requestContext.http

Un objet qui contient des informations sur la demande HTTP.

requestContext.http.method

La méthode HTTP utilisée dans cette demande. Les valeurs valides sont les suivantes : GET, POST, PUT, HEAD, OPTIONS, PATCH et DELETE.

GET

requestContext.http.path

Chemin d’accès de la demande. Par exemple, si l’URL de la demande est https://{url-id}.lambda-url.{region}.on.aws/example/test/demo, alors la valeur du chemin est /example/test/demo.

/example/test/demo

requestContext.http.protocol

Le protocole de la demande.

HTTP/1.1

requestContext.http.sourceIp

L’adresse IP source de la connexion TCP immédiate qui fait la demande.

123.123.123.123

requestContext.http.userAgent

La valeur de l’en-tête de la demande Utilisateur-Agent.

Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) Gecko/20100101 Firefox/42.0

requestContext.requestId

L’identifiant de la demande d’invocation. Vous pouvez utiliser cet ID pour suivre les journaux d’invocation liés à votre fonction.

e1506fd5-9e7b-434f-bd42-4f8fa224b599

requestContext.routeKey

Fonction : URLs n'utilisez pas ce paramètre. Lambda le définit sur $default comme espace réservé.

$default

requestContext.stage

Fonction : URLs n'utilisez pas ce paramètre. Lambda le définit sur $default comme espace réservé.

$default

requestContext.time

Horodatage de la demande.

"07/Sep/2021:22:50:22 +0000"

requestContext.timeEpoch

L’horodatage de la demande, en heure d’époque Unix.

"1631055022677"

body

Le corps de la demande. Si le type de contenu de la demande est binaire, le corps est codé en base64.

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

pathParameters

Fonction : URLs n'utilisez pas ce paramètre. Lambda le définit sur null ou l’exclut de JSON.

null

isBase64Encoded

TRUE si le corps est une charge utile binaire et codé en base64. Sinon FALSE.

FALSE

stageVariables

Fonction : URLs n'utilisez pas ce paramètre. Lambda le définit sur null ou l’exclut du JSON.

null

"Hello, world!"

{
  "statusCode": 200,
  "body": "Hello, world!",
  "headers": {
    "content-type": "application/json"
  },
  "isBase64Encoded": false
}

HTTP/2 200
date: Wed, 08 Sep 2021 18:02:24 GMT
content-type: application/json
content-length: 15

"Hello, world!"

{
  "message": "Hello, world!"
}

{
  "statusCode": 200,
  "body": {
    "message": "Hello, world!"
  },
  "headers": {
    "content-type": "application/json"
  },
  "isBase64Encoded": false
}

HTTP/2 200
date: Wed, 08 Sep 2021 18:02:24 GMT
content-type: application/json
content-length: 34

{
  "message": "Hello, world!"
}

{
   "statusCode": 201,
    "headers": {
        "Content-Type": "application/json",
        "My-Custom-Header": "Custom Value"
    },
    "body": JSON.stringify({
        "message": "Hello, world!"
    }),
    "isBase64Encoded": false
}

{
   "statusCode": 201,
    "headers": {
        "Content-Type": "application/json",
        "My-Custom-Header": "Custom Value"
    },
    "body": JSON.stringify({
        "message": "Hello, world!"
    }),
    "isBase64Encoded": false
}

HTTP/2 201
date: Wed, 08 Sep 2021 18:02:24 GMT
content-type: application/json
content-length: 27
my-custom-header: Custom Value

{
  "message": "Hello, world!"
}

{
   "statusCode": 201,
    "headers": {
        "Content-Type": "application/json",
        "My-Custom-Header": "Custom Value"
    },
    "body": JSON.stringify({
        "message": "Hello, world!"
    }),
    "cookies": [
        "Cookie_1=Value1; Expires=21 Oct 2021 07:48 GMT",
        "Cookie_2=Value2; Max-Age=78000"
    ],
    "isBase64Encoded": false
}

HTTP/2 201
date: Wed, 08 Sep 2021 18:02:24 GMT
content-type: application/json
content-length: 27
my-custom-header: Custom Value
set-cookie: Cookie_1=Value2; Expires=21 Oct 2021 07:48 GMT
set-cookie: Cookie_2=Value2; Max-Age=78000

{
  "message": "Hello, world!"
}