Function Compute：Gunakan pemicu HTTP untuk memanggil fungsi

Format struktur permintaan

Format struktur permintaan adalah sebagai berikut:

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

Tabel berikut menjelaskan parameter:

Logika pemetaan permintaan

Function Compute memetakan permintaan HTTP masuk ke objek acara sebelum meneruskannya ke penanganan fungsi Anda. Logika pemetaan adalah sebagai berikut:

• Header dari permintaan HTTP dipetakan ke event headers.

• Parameter query dari permintaan HTTP dipetakan ke queryParameters.

• Informasi kontekstual tentang permintaan HTTP dipetakan ke requestContext.

• Body permintaan dari permintaan POST dipetakan ke body.

Contoh pemetaan permintaan

GET /?parameter1=nilai1&parameter2=nilai2 HTTP/1.1

{
  "version": "v1",
  "rawPath": "/",
  "headers": {
    "Accept": "*/*",
    "User-Agent": "CurlHttpClient"
  },
  "queryParameters": {
    "parameter1": "nilai1",
    "parameter2": "nilai2"
  },
  "body": "",
  "isBase64Encoded": true,
  "requestContext": {
    "accountId": "1327************",
    "domainName": "contoh.cn-hangzhou.fcapp.run",
    "domainPrefix": "contoh",
    "requestId": "1-67aee50c-********-************",
    "time": "2025-02-14T06:39:08Z",
    "timeEpoch": "1739515148145",
    "http": {
      "method": "GET",
      "path": "/",
      "protocol": "HTTP/1.1",
      "sourceIp": "40.XX.XX.XX",
      "userAgent": "CurlHttpClient"
    }
  }
}

curl -v "https://contoh.cn-hangzhou.fcapp.run?parameter1=nilai1&parameter2=nilai2"

POST / HTTP/1.1
Content-Type: application/json

{
  "version": "v1",
  "rawPath": "/",
  "headers": {
    "Accept": "*/*",
    "Content-Length": "20",
    "Content-Type": "application/json",
    "User-Agent": "curl/8.7.1"
  },
  "queryParameters": {},
  "body": "{\"message\": \"Halo\"}",
  "isBase64Encoded": false,
  "requestContext": {
    "accountId": "1327************",
    "domainName": "contoh.cn-hangzhou.fcapp.run",
    "domainPrefix": "contoh",
    "requestId": "1-67aee50c-********-************",
    "time": "2025-02-14T06:39:08Z",
    "timeEpoch": "1739515148145",
    "http": {
      "method": "POST",
      "path": "/",
      "protocol": "HTTP/1.1",
      "sourceIp": "40.XX.XX.XX",
      "userAgent": "CurlHttpClient"
    }
  }
}

Format struktur respons

Format struktur respons adalah sebagai berikut. Function Compute mengurai output fungsi Anda, mentransformasikannya menjadi struktur respons, dan memetakan struktur ini ke respons HTTP.

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

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

HTTP/1.1 200 OK
Content-Disposition: attachment
Content-Length: 12
Content-Type: application/json
X-Fc-Request-Id: 1-64f6d6e7-e01edb1cce58240ed59b59d9
Date: Tue, 05 Sep 2023 07:21:11 GMT

Halo Dunia!

{
  "statusCode": 200,
  "body": "{\"message\": \"Halo Dunia!\"}",
  "headers": {
    "content-type": "application/json"
  },
  "isBase64Encoded": false
}

HTTP/1.1 200 OK
Content-Disposition: attachment
Content-Length: 27
Content-Type: application/json
X-Fc-Request-Id: 1-64f6d867-7302fc1ac6338b6fd2adb782
Date: Tue, 05 Sep 2023 07:27:35 GMT

{"message": "Halo Dunia!"}

{
   "statusCode": 201,
    "headers": {
        "Content-Type": "application/json",
        "My-Custom-Header": "Nilai Kustom"
    },
    "body": {
        "message": "Halo, dunia!"
    },
    "isBase64Encoded": false
}

{
   "statusCode": 201,
    "headers": {
        "Content-Type": "application/json",
        "My-Custom-Header": "Nilai Kustom"
    },
    "body": {
        "message": "Halo, dunia!"
    },
    "isBase64Encoded": false
}

HTTP/1.1 201 OK
Content-Disposition: attachment
Content-Length: 27
Content-Type: application/json
Custom-Header-1: Nilai Kustom
X-Fc-Request-Id: 1-64f6dcb3-e787580749d3ba13b047ce14
Date: Tue, 05 Sep 2023 07:45:55 GMT

{"message": "Halo dunia!"}

Mekanisme dekode Base64

Jika fungsi Anda mengembalikan JSON yang valid dengan parameter isBase64Encoded yang nilainya true, Function Compute melakukan dekode Base64 pada body JSON dan kemudian memetakan data yang didekodekan ke body respons HTTP.

Jika body JSON gagal didekode, Function Compute tidak melaporkan kesalahan. Sebagai gantinya, ia langsung mengembalikan nilai dari body JSON ke klien.

Header respons HTTP

Dalam pemanggilan URL fungsi, header respons X-Fc-Request-Id, yang secara otomatis ditambahkan oleh Function Compute, secara unik mengidentifikasi permintaan yang memicu pemanggilan fungsi. Function Compute tidak secara otomatis menambahkan header respons lainnya.

Anda dapat mengembalikan header kustom dari fungsi Anda. Perhatikan bahwa header kustom yang dimulai dengan X-Fc- tidak didukung. Selain itu, header respons berikut tidak dapat digunakan sebagai header kustom karena dicadangkan oleh Function Compute.

• connection

• content-length

• date

• keep-alive

• server

• content-disposition

Jika salah satu header cadangan ini digunakan sebagai header kustom, Function Compute akan mengabaikannya.

Penanganan kesalahan

Ketika fungsi yang dipanggil melalui API mengalami kesalahan, pesan kesalahan dikembalikan sebagai bagian dari respons, dan kode status HTTP 200 dikembalikan. Sebagai contoh, kode sampel berikut menunjukkan respons terhadap kesalahan ModuleNotFound dalam Python:

{
    "errorMessage": "Tidak dapat mengimpor modul 'index'",
    "errorType": "ImportModuleError",
    "stackTrace": [
        "ModuleNotFoundError: Tidak ada modul bernama 'not_exist_module'"
    ]
}

Namun, dalam kasus pemanggilan URL fungsi, Function Compute menyembunyikan pesan kesalahan dan hanya mengembalikan Internal Server Error. Kode status HTTP adalah 502. Kode sampel berikut menunjukkan sebuah contoh:

HTTP/1.1 502 Bad Gateway
Content-Disposition: attachment
Content-Type: application/json
X-Fc-Request-Id: 1-64f6df91-fe144d52e4fd27afe3d8dd6f
Date: Tue, 05 Sep 2023 07:58:09 GMT
Content-Length: 21

Internal Server Error

Anda dapat menggunakan header respons X-Fc-Request-Id untuk secara efisien menemukan log yang relevan dan mengidentifikasi pesan kesalahan yang terkait dengan permintaan.