Function Compute:İşlev çağırmak için HTTP tetikleyicisi kullanın

Biçim

Function Compute gelen HTTP isteğini aşağıdaki yapıya sahip bir olay nesnesine eşler:

{
    "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"
    }
}

Parametreler

Eşleme mantığı

Function Compute HTTP isteğini olay nesnesine şu şekilde eşler:

• HTTP istek üst bilgileri → event.headers

• HTTP sorgu parametreleri → event.queryParameters

• İstek bağlamı (istek kimliği, zaman damgası, arayan kimliği) → event.requestContext

• POST istek gövdesi → event.body

Base64 kodlama

Function Compute, istek gövdesinin Base64 ile kodlanıp kodlanmayacağını belirlemek için Content-Type üst bilgisini denetler.

İstek eşleme örnekleri

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"

Biçim

İşlev çıkışınız HTTP yanıtına eşlenmeden önce bir yanıt yapısına ayrıştırılır:

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

Eşleme mantığı

Function Compute, işlev çıkışınızı statusCode alanı içeren geçerli bir JSON olup olmamasına göre HTTP yanıtına eşler.

**Çıkış, statusCode içeren geçerli bir JSON olduğunda:**

**Çıkış, statusCode içermeyen geçerli bir JSON olduğunda veya JSON olmadığında:**

Function Compute aşağıdaki varsayılanları kullanır:

Yanıt eşleme örnekleri

Aşağıdaki örneklerde işlev çıkışının ayrıştırmadan geçerek nihai HTTP yanıtına nasıl dönüştürüldüğü gösterilmektedir.

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!"}

Base64 kod çözme

İşleviniz isBase64Encoded değeri true olarak ayarlanmış geçerli bir JSON döndürürse Function Compute, body değerini HTTP yanıt gövdesine eşlemeden önce Base64 ile kodunu çözer. Kod çözme işlemi başarısız olursa Function Compute bir hata bildirmeden body değerini doğrudan döndürür.

Yanıt üst bilgileri

Function Compute, her yanıta otomatik olarak X-Fc-Request-Id üst bilgisini ekler. Bu üst bilgi isteği benzersiz şekilde tanımlar ve günlüklerin izlenmesi ile hataların teşhis edilmesi için kullanışlıdır. X-Fc-Request-Id dışında Function Compute varsayılan olarak başka herhangi bir yanıt üst bilgisi eklemez.

Hata işleme

HTTP tetikleyicisi çağrıları ile doğrudan API çağrıları işlev hatalarını farklı şekilde işler.

Örneğin, bir Python ModuleNotFoundError hatasıyla karşılaşan doğrudan bir API çağrısı aşağıdaki hata ayrıntılarını döndürür:

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

HTTP tetikleyicisi aracılığıyla çağrılan bir işlev bir hatayla karşılaştığında istemci şu şekilde bir yanıt alır:

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

İşlevinizin çağrı günlüklerinde tam hata ayrıntılarını aramak için X-Fc-Request-Id değerini kullanın.