Function Compute:Utiliser un déclencheur HTTP pour invoquer une fonction

Format

Function Compute mappe la requête HTTP entrante vers un objet événement présentant la structure suivante :

{
    "version": "v1",
    "rawPath": "/example",
    "body": "Hello FC!",
    "isBase64Encoded": false,
    "headers": {
        "header1": "value1",
        "header2": "value1,value2"
    },
    "queryParameters": {
        "parameter1": "value1",
        "parameter2": "value1,value2"
    },
    "requestContext": {
        "accountId": "123456*********",
        "domainName": "<http-trigger-id>.<region-id>.fcapp.run",
        "domainPrefix": "<http-trigger-id>",
        "http": {
            "method": "GET",
            "path": "/example",
            "protocol": "HTTP/1.1",
            "sourceIp": "11.11.11.**",
            "userAgent": "PostmanRuntime/7.32.3"
        },
        "requestId": "1-64f6cd87-*************",
        "time": "2023-09-05T06:41:11Z",
        "timeEpoch": "1693896071895"
    }
}

Paramètres

Logique de mappage

Function Compute mappe la requête HTTP vers l'objet événement comme suit :

• En-têtes de requête HTTP → event.headers

• Paramètres de requête HTTP → event.queryParameters

• Contexte de la requête (ID de requête, horodatage, identité de l'appelant) → event.requestContext

• Corps de la requête POST → event.body

Encodage Base64

Function Compute vérifie l'en-tête Content-Type pour décider s'il faut encoder le corps de la requête en Base64.

Exemples de mappage de requête

curl -v "https://example.cn-hangzhou.fcapp.run?parameter1=value1&parameter2=value2"

POST / HTTP/1,1
Content-Type: application/json

curl -v -H "Content-Type: application/json" -d '{"message": "Hello"}' "https://example.cn-hangzhou.fcapp.run"

Format

La sortie de votre fonction est analysée dans une structure de réponse avant d'être mappée vers la réponse HTTP :

{
    "statusCode": 200,
    "headers": {
        "Content-Type": "application/json",
        "Custom-Header-1": "Custom Value"
    },
    "isBase64Encoded": false,
    "body": "{\"message\":\"Hello FC!\"}"
}

Logique de mappage

Function Compute mappe la sortie de votre fonction vers la réponse HTTP selon que la sortie est un JSON valide contenant un champ statusCode.

**Lorsque la sortie est un JSON valide avec statusCode :**

**Lorsque la sortie est un JSON valide sans statusCode, ou n'est pas du JSON :**

Function Compute utilise les valeurs par défaut suivantes :

Exemples de mappage de réponse

Les exemples suivants illustrent le flux de la sortie de fonction, de l'analyse jusqu'à la réponse HTTP finale.

HTTP/1,1 200 OK
Content-Disposition: attachment
Content-Length: 12
Content-Type: application/json
X-Fc-Request-Id: 1-64f6d6e7-e01edb1cce58240ed59b59d9

Hello World!

HTTP/1,1 200 OK
Content-Disposition: attachment
Content-Length: 27
Content-Type: application/json
X-Fc-Request-Id: 1-64f6d867-7302fc1ac6338b6fd2adb782

{"message": "Hello World!"}

HTTP/1,1 201 OK
Content-Type: application/json
My-Custom-Header: Custom Value
X-Fc-Request-Id: 1-64f6dcb3-e787580749d3ba13b047ce14

{"message": "Hello world!"}

Décodage Base64

Si votre fonction renvoie un JSON valide avec isBase64Encoded défini sur true, Function Compute décode le body en Base64 avant de le mapper vers le corps de la réponse HTTP. Si le décodage échoue, Function Compute renvoie la valeur de body directement sans signaler d'erreur.

En-têtes de réponse

Function Compute ajoute automatiquement l'en-tête X-Fc-Request-Id à chaque réponse. Cet en-tête identifie de manière unique la requête et s'avère utile pour tracer les journaux et diagnostiquer les erreurs. À l'exception de X-Fc-Request-Id, Function Compute n'ajoute aucun autre en-tête de réponse par défaut.

Gestion des erreurs

Les invocations via déclencheur HTTP et les invocations directes par API gèrent différemment les erreurs de fonction.

Par exemple, une invocation directe par API rencontrant une erreur Python ModuleNotFoundError renvoie les détails d'erreur suivants :

{
    "errorMessage": "Unable to import module 'index'",
    "errorType": "ImportModuleError",
    "stackTrace": [
        "ModuleNotFoundError: No module named 'not_exist_module'"
    ]
}

Lorsqu'une fonction invoquée via un déclencheur HTTP rencontre une erreur, le client reçoit une réponse semblable à :

HTTP/1.1 502 Bad Gateway
Content-Disposition: attachment
Content-Type: application/json
X-Fc-Request-Id: 1-64f6df91-fe144d52e4fd27afe3d8dd6f
Content-Length: 21

Internal Server Error

Utilisez la valeur X-Fc-Request-Id pour rechercher les détails complets de l'erreur dans les journaux d'invocation de votre fonction.