Function Compute：Konfigurasi dan penggunaan pemicu HTTP

Langkah 1: Buat pemicu

1. Masuk ke Konsol Function Compute. Di panel navigasi kiri, klik Services & Functions.

2. Di bilah navigasi atas, pilih wilayah. Di halaman Services, klik layanan yang diinginkan.

3. Di halaman Functions, klik Create Function.

4. Di halaman Create Function, pilih Use Built-in Runtime dan konfigurasikan parameter untuk membuat fungsi sesuai kebutuhan bisnis Anda.

   Tabel berikut menjelaskan parameter yang perlu dikonfigurasi. Pertahankan nilai default untuk parameter lainnya. Untuk informasi lebih lanjut, lihat Buat Fungsi.

   Parameter	Deskripsi
   Basic Settings
   Function Name	Tentukan nama fungsi.
   Handler Type	Pilih HTTP Handler.
   (Opsional) Trigger Configurations
   Name	Tentukan nama pemicu.
   Request Method	Tentukan metode HTTP yang dapat digunakan untuk memicu pemicu.
   Disable Internet URL	Secara default, parameter ini disetel ke No dan domain publik diperbolehkan untuk mengakses pemicu. Jika Anda memilih Yes, tidak ada domain publik default yang tersedia untuk pemicu. Dalam hal ini, pesan kesalahan access denied due to function internet URL is disable akan dikembalikan jika Anda menggunakan domain publik untuk memanggil fungsi. Namun, jika Anda menggunakan domain kustom, fungsi dapat dipanggil seperti yang diharapkan.
   Authentication Method	Metode yang digunakan untuk mengotentikasi permintaan HTTP. Nilai valid: No Authentication: Function Compute tidak mengotentikasi permintaan HTTP dan mendukung akses anonim ke fungsi. Semua pengguna dapat memanggil fungsi menggunakan permintaan HTTP. Signature Authentication: Otentikasi identitas diperlukan untuk permintaan HTTP. Untuk informasi lebih lanjut tentang kode contoh untuk otentikasi tanda tangan, lihat Otentikasi tanda tangan. JWT Authentication: Permintaan HTTP harus diautentikasi menggunakan JSON Web Token (JWT). Untuk informasi lebih lanjut, lihat Konfigurasikan otentikasi JWT untuk pemicu HTTP.

   Anda dapat memodifikasi konfigurasi pemicu HTTP yang telah dibuat sesuai kebutuhan bisnis Anda. Sebagai contoh, Anda dapat memodifikasi parameter berikut dari pemicu: Version or Alias, Request Method, Disable Internet URL, dan Authentication Method.

Langkah 2: Tulis dan terapkan kode

Setelah pemicu HTTP dibuat, Anda dapat menulis kode untuk fungsi tersebut.

var getRawBody = require('raw-body')
module.exports.handler = function (request, response, context) {
    // dapatkan info permintaan
    getRawBody(request, function (err, data) {
        var params = {
            path: request.path,
            queries: request.queries,
            headers: request.headers,
            method: request.method,
            body: data,
            url: request.url,
            clientIP: request.clientIP,
        }
        // Anda dapat menangani logika Anda sendiri di sini
        // atur respons
        var respBody = new Buffer.from(JSON.stringify(params));
        // var respBody = new Buffer( )
        response.setStatusCode(200)
        response.setHeader('content-type', 'application/json')
        response.send(respBody)
    })
};

# -*- coding: utf-8 -*-
import json
HELLO_WORLD = b"Hello world!\n"
def handler(environ, start_response):
    request_uri = environ['fc.request_uri']
    response_body = {
      'uri':environ['fc.request_uri'],
      'method':environ['REQUEST_METHOD']
    }
    # lakukan sesuatu di sini
    status = '200 OK'
    response_headers = [('Content-type', 'text/json')]
    start_response(status, response_headers)
    # Python2
    return [json.dumps(response_body)]
    # Tips Python3: Saat menggunakan Python3, tipe str dan bytes tidak dapat dicampur.
    # Gunakan str.encode() untuk mengubah str menjadi bytes
    # return [json.dumps(response_body).encode()]

<?php
use RingCentral\Psr7\Response;
function handler($request, $context): Response{
    /*
    $body       = $request->getBody()->getContents();
    $queries    = $request->getQueryParams();
    $method     = $request->getMethod();
    $headers    = $request->getHeaders();
    $path       = $request->getAttribute("path");
    $requestURI = $request->getAttribute("requestURI");
    $clientIP   = $request->getAttribute("clientIP");
    */
    return new Response(
        200,
        array(
            "custom_header1" => "v1",
            "custom_header2" => ["v2", "v3"],
        ),
        "hello world"
    );
}

Langkah 3: Uji fungsi

Metode 1: Uji fungsi di Konsol Function Compute

Metode 2: Uji fungsi menggunakan browser

Anda dapat menggunakan salah satu metode berikut untuk mendapatkan URL pemicu HTTP:

• Untuk pemicu HTTP baru, kami sarankan Anda menggunakan subdomain yang ditetapkan oleh Function Compute sebagai URL pemicu HTTP.

  Format subdomain:

  <subdomain>.<region_id>.fcapp.run/[action?queries] 

  Kode contoh:

  funcname-svcname-khljsjksld.cn-shanghai.fcapp.run/action?hello=world

  Catatan

  Anda juga dapat merakit URL untuk pemicu HTTP yang ada berdasarkan aturan perakitan. Jika Anda menggunakan subdomain yang ditetapkan sebagai URL pemicu HTTP untuk menguji fungsi, ini dapat mencegah kesalahan 404 dan penggabungan nama layanan Function Compute dalam kode fungsi. Ini dapat meningkatkan portabilitas kode. Untuk informasi lebih lanjut tentang cara menangani kesalahan 404, lihat Apa yang harus saya lakukan jika kesalahan 404 terjadi saat saya menggunakan browser atau alat cURL untuk mengakses fungsi?

• Untuk pemicu HTTP yang ada, Anda dapat menghasilkan URL pemicu HTTP berdasarkan aturan perakitan.

  Aturan perakitan:

  <account_id>.<region_id>.fc.aliyuncs.com/<version>/proxy/<serviceName>/<functionName>/[action?queries]            

  Kode contoh:

  164901546557****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/serviceName/functionName/action?hello=world           

  Deskripsi parameter:

  Parameter	Deskripsi
  account_id	ID akun Alibaba Cloud. Anda dapat memperoleh ID akun Alibaba Cloud Anda di halaman Pengaturan Keamanan di Konsol Manajemen Alibaba Cloud. Jika Anda masuk sebagai Pengguna Resource Access Management (RAM), arahkan penunjuk ke foto profil Anda di sudut kanan atas konsol untuk memperoleh ID akun Alibaba Cloud Anda.
  region_id	ID wilayah tempat Function Compute berada.
  version	Versi API Function Compute.
  serviceName	Nama layanan.
  functionName	Nama fungsi.
  action	Path permintaan kustom.
  queries	Parameter query.

Metode 3: Gunakan cURL untuk menguji fungsi

• Pemanggilan Sinkron

  Jalankan perintah berikut. Setelah perintah dieksekusi, hasilnya dikembalikan.

  curl -v https://http-***.cn-shenzhen.fcapp.run/$path

• Pemanggilan Asinkron

  Jalankan perintah berikut. Output perintah menunjukkan apakah Function Compute menerima permintaan pemanggilan asinkron. Jika kode status 202 dikembalikan, permintaan pemanggilan asinkron berhasil. Jika kode status lain dikembalikan, terjadi kesalahan selama pemanggilan asinkron. Untuk informasi lebih lanjut tentang kode status, lihat Pemecahan Masalah.

  curl -v -H "X-Fc-Invocation-Type: Async" https://http-***.cn-shenzhen.fcapp.run/$path

(Opsional) Gunakan API Gateway untuk melindungi fungsi HTTP

Secara default, Function Compute tidak mengotentikasi permintaan HTTP dan mendukung akses anonim ke fungsi HTTP. Siapa pun dapat mengirim permintaan HTTP untuk memanggil fungsi HTTP. Untuk mencegah pemborosan sumber daya dan risiko keamanan yang disebabkan oleh akses anonim, Anda dapat menghubungkan fungsi HTTP ke API Gateway sambil mengaktifkan otentikasi identitas. Anda dapat menggunakan plugin kontrol akses berbasis IP, plugin otentikasi JWT, atau plugin otentikasi dasar dari API Gateway untuk melindungi fungsi HTTP Anda.

1. Di Function Compute console temukan fungsi HTTP yang ingin Anda kelola. Di halaman detail fungsi, klik tab Triggers, lalu edit pemicu HTTP. Di kotak dialog yang muncul, atur Authentication ke Yes.

2. Masuk ke Konsol API Gateway dan beralihlah ke wilayah tempat fungsi HTTP berada.

3. Buat grup. Untuk informasi lebih lanjut, lihat bagian Buat Grup API dari topik "Buat API dengan layanan backend tipe HTTP".

4. Arahkan domain Anda ke domain tingkat kedua yang disediakan oleh API Gateway menggunakan Canonical Name (CNAME). Untuk informasi lebih lanjut, lihat Tambahkan Rekaman CNAME.

5. Buat API.

   Item berikut menjelaskan cara mengonfigurasi parameter utama. Pertahankan nilai default atau konfigurasikan nilai kustom untuk parameter lainnya sesuai kebutuhan bisnis Anda. Untuk informasi lebih lanjut, lihat Buat API.

   • Security Authentication: Pilih No Authentication. Dalam operasi berikutnya, plugin digunakan untuk otentikasi.

   • Request Path: Masukkan direktori root / dan pilih Match All Subpaths.

   • HTTP Method: Pilih ANY.

   • Request Mode: Pilih Pass-through.

   • Backend Service Type: Pilih Function Compute.

   • Function Type: Pilih HTTP Function.

   • Trigger Path: Pilih endpoint internal fungsi HTTP di Function Compute.

   • ContentType: Pilih Pass-through Client Content-type Header.

6. Publikasikan API. Temukan API yang Anda buat, klik Publish di kolom Actions, pilih lingkungan online, lalu klik Publish.

7. Buat plugin dengan tipe Backend Signature. Atur key dan value ke ID AccessKey dan Rahasia AccessKey dari akun Alibaba Cloud Anda. Kemudian, ikat plugin tersebut ke API yang telah Anda buat. Untuk informasi lebih lanjut, lihat Ikhtisar.

Pemecahan Masalah

Mengapa saya tidak dapat mengeksekusi fungsi HTTP?

• Untuk pemicu baru, cache memerlukan waktu sekitar 10 detik untuk diperbarui. Anda dapat mencoba lagi nanti.

• Anda dapat memeriksa apakah handler yang Anda tentukan untuk fungsi Anda valid. Handler untuk fungsi HTTP berbeda dari handler untuk fungsi biasa. Untuk informasi lebih lanjut tentang fungsi HTTP dalam berbagai bahasa, lihat topik berikut:

  • Handler HTTP di Runtime Node.js

  • Handler HTTP di Runtime Python

  • Handler HTTP di Runtime PHP

  • Handler HTTP diRuntime Java

  • Handler HTTP di Runtime C#

  • Handler HTTP di Runtime Kustom

  • Handler HTTP di Runtime Custom Container

Mengapa saya tidak dapat menghentikan eksekusi fungsi?

Pemecahan Masalah

Jika masalah berlanjut, bergabunglah dengan grup pengguna DingTalk (ID: 11721331) dan hubungi dukungan teknis Function Compute.

Informasi lebih lanjut

Untuk memodifikasi atau menghapus pemicu yang ada, lihat Kelola Pemicu.