Function Compute:Ikhtisar Pemicu HTTP

Batasan pemicu

• Anda dapat membuat paling banyak satu pemicu HTTP per versi atau alias. Untuk informasi lebih lanjut, lihat Version management dan Alias management.

• Nama domain bawaan hanya untuk pengujian. Jangan menggunakannya untuk layanan produksi karena stabilitasnya tidak dijamin.

  Catatan

  Untuk menghosting layanan bergaya website secara publik, gunakan nama domain kustom yang telah terdaftar ICP. Bind nama domain tersebut ke fungsi Anda sebelum mengeksposnya. Untuk informasi lebih lanjut, lihat Configure a custom domain name.

Batasan protokol HTTP/HTTPS

• Batasan permintaan HTTP

  • Header permintaan kustom yang diawali dengan x-fc- tidak didukung. Header kustom berikut juga tidak didukung:

    • connection

    • keep-alive

  • Jika permintaan melebihi salah satu batasan berikut, Function Compute mengembalikan kode status HTTP 400 dan kode kesalahan InvalidArgument.

    • Ukuran header: Ukuran gabungan semua kunci dan nilai header tidak boleh melebihi 8 KB.

    • Ukuran path: Ukuran total path, termasuk semua parameter kueri, tidak boleh melebihi 4 KB.

    • Ukuran badan: Untuk pemanggilan sinkron, badan permintaan tidak boleh melebihi 32 MB. Untuk pemanggilan asinkron, lihat Function execution resource limits.

• Batasan respons HTTP

  • Header respons kustom yang diawali dengan x-fc- tidak didukung. Header kustom berikut juga tidak didukung:

    • connection

    • content-length

    • date

    • keep-alive

    • server

    • upgrade

    • content-disposition:attachment

      Catatan

      Untuk alasan keamanan, Function Compute menambahkan content-disposition: attachment ke header respons saat Anda menggunakan nama domain Function Compute bawaan (aliyuncs.com). Hal ini menyebabkan browser mengunduh respons sebagai lampiran. Untuk menghapus perilaku ini, konfigurasikan nama domain kustom. Untuk informasi lebih lanjut, lihat Configure a custom domain name.

  • Jika respons melebihi batasan berikut, Function Compute mengembalikan kode status HTTP 502 dan kode kesalahan BadResponse.

    • Ukuran header: Ukuran gabungan semua kunci dan nilai header tidak boleh melebihi 8 KB.

Pemanggilan sinkron

Pada pemanggilan sinkron, fungsi memproses event dan segera mengembalikan hasilnya. Pemicu HTTP menggunakan pemanggilan sinkron secara default. Untuk informasi lebih lanjut, lihat Synchronous invocation.

Pemanggilan asinkron

Pada pemanggilan asinkron, Function Compute menyimpan permintaan dan segera mengembalikan respons, tanpa menunggu fungsi selesai dieksekusi.

• Asynchronous invocation: Tambahkan header permintaan "X-Fc-Invocation-Type":"Async" untuk mengaktifkan pemanggilan asinkron tingkat permintaan.

• Asynchronous task: Setelah mengonfigurasi tugas asinkron untuk fungsi HTTP Anda, tambahkan header permintaan "X-Fc-Async-Task-Id":"g6u*****iyvhd3jk8s6bhj0hh" untuk menentukan ID pemanggilan.

Untuk informasi lebih lanjut tentang header permintaan, lihat Invoke a function.

Setelah pemanggilan asinkron berhasil, Function Compute mengembalikan kode status HTTP 202, yang menunjukkan permintaan diterima. Respons tersebut juga mengembalikan ID permintaan dalam header respons, contohnya: "X-Fc-Request-Id": "80bf7****281713e1".

Permintaan simple

Permintaan simple tidak mengirim permintaan preflight, sehingga Anda dapat langsung mengatur header yang diawali dengan Access-Control-Allow-* dalam kode fungsi Anda untuk menerapkan kontrol akses sederhana. Untuk permintaan simple, Function Compute mendukung header kustom berikut: Access-Control-Allow-Origin, Access-Control-Allow-Headers, , dan Access-Control-Max-Age.

Jika Anda tidak mengatur header kustom, Function Compute mengatur header respons berikut secara default, berdasarkan header permintaan yang sesuai:

• Access-Control-Allow-Origin: Header Origin dari permintaan.

• Access-Control-Allow-Credentials: Nilai default adalah true.

• Access-Control-Expose-Headers: Header yang didefinisikan oleh Function Compute.

Permintaan tidak sederhana

Permintaan tidak sederhana mengirim permintaan preflight sebelum permintaan aktual. Permintaan tidak sederhana mencakup satu pemanggilan metode OPTIONS dan satu pemanggilan fungsi aktual. Aturan untuk permintaan aktual sama dengan aturan untuk permintaan simple. Untuk menyesuaikan respons preflight, tambahkan metode OPTIONS ke pemicu HTTP Anda dan tangani permintaan OPTIONS dalam kode fungsi Anda. Atur header respons yang diawali dengan Access-Control-Allow- untuk mengontrol perilaku lintas asal.

Untuk permintaan preflight, Function Compute mendukung header yang dapat dikustomisasi berikut: Access-Control-Allow-Origin, Access-Control-Allow-Headers, Access-Control-Allow-Methods, dan Access-Control-Max-Age.

Sebagai contoh, berikut cara menangani permintaan preflight dalam kode runtime Node.js:

exports.handler =  (event, context,callback) => {
      console.log('hello world');
      const method = JSON.parse(event).requestContext.http.method;
      if (method === 'OPTIONS') {
          // Set response headers to handle preflight requests
          const fcResponse = {
            'statusCode': 204,
            'headers': {
              'Access-Control-Allow-Origin': 'http://www.fc.com',
              'Access-Control-Allow-Methods': 'POST',
              'Access-Control-Allow-Headers': 'Content-Type, Authorization',
              'Access-Control-Max-Age':'3600'
            },
            'body': 'hello world'
        };
        callback(null, fcResponse);
      } else {
        callback(null, {
            'statusCode': 500,
            'body': 'hello world'
        });
      }
    };

API Configured CORS

API Configured CORS saat ini tersedia sebagai pratinjau undangan. Untuk mengaktifkannya, hubungi kami dan berikan ID akun Alibaba Cloud (UID) Anda.