Function Compute:Gunakan Pemicu HTTP untuk memanggil fungsi

Format

Function Compute memetakan permintaan HTTP masuk ke objek event dengan struktur berikut:

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

Parameter

Logika pemetaan

Function Compute memetakan permintaan HTTP ke objek event sebagai berikut:

• Header permintaan HTTP → event.headers

• Parameter kueri HTTP → event.queryParameters

• Konteks permintaan (ID permintaan, timestamp, identitas pemanggil) → event.requestContext

• Badan permintaan POST → event.body

Pengkodean Base64

Function Compute memeriksa header Content-Type untuk menentukan apakah badan permintaan perlu diencode Base64.

Contoh pemetaan permintaan

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

Output fungsi Anda diurai menjadi struktur respons sebelum dipetakan ke respons HTTP:

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

Logika pemetaan

Function Compute memetakan output fungsi Anda ke respons HTTP berdasarkan apakah output tersebut merupakan JSON valid yang berisi bidang statusCode.

Jika output berupa JSON valid dengan statusCode:

Jika output berupa JSON valid tanpa statusCode, atau bukan JSON:

Function Compute menggunakan nilai default berikut:

Contoh pemetaan respons

Contoh berikut menunjukkan bagaimana output fungsi mengalir melalui proses penguraian hingga menjadi respons HTTP akhir.

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

Pendekodean Base64

Jika fungsi Anda mengembalikan JSON valid dengan isBase64Encoded diatur ke true, Function Compute akan mendekode Base64 body sebelum memetakannya ke badan respons HTTP. Jika pendekodean gagal, Function Compute mengembalikan nilai body secara langsung tanpa melaporkan error.

Header respons

Function Compute secara otomatis menambahkan header X-Fc-Request-Id ke setiap respons. Header ini secara unik mengidentifikasi permintaan dan berguna untuk melacak log serta mendiagnosis error. Selain X-Fc-Request-Id, Function Compute tidak menambahkan header respons lain secara default.

Penanganan error

Pemanggilan melalui Pemicu HTTP dan pemanggilan API langsung menangani error fungsi secara berbeda.

Sebagai contoh, pemanggilan API langsung yang mengalami Python ModuleNotFoundError mengembalikan detail error berikut:

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

Saat fungsi yang dipanggil melalui Pemicu HTTP mengalami error, klien menerima respons seperti:

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

Gunakan nilai X-Fc-Request-Id untuk mencari detail error lengkap di log pemanggilan fungsi Anda.