Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Membuat dan mengelola URL fungsi Lambda

URL fungsi adalah titik akhir HTTP (S) khusus untuk fungsi Lambda Anda. Anda dapat membuat dan mengkonfigurasi URL fungsi melalui konsol Lambda atau API Lambda.

Saat Anda membuat URL fungsi, Lambda secara otomatis menghasilkan titik akhir URL unik untuk Anda. Setelah Anda membuat URL fungsi, titik akhir URL-nya tidak pernah berubah. Titik akhir URL fungsi memiliki format berikut:

https://<url-id>.lambda-url.<region>.on.aws

URL fungsi mendukung tumpukan ganda, mendukung IPv4 dan IPv6. Setelah Anda mengonfigurasi URL fungsi untuk fungsi Anda, Anda dapat memanggil fungsi Anda melalui titik akhir HTTP (S) dengan menggunakan browser web, curl, Postman, atau klien HTTP apa pun.

URL fungsi Lambda menggunakan kebijakan berbasis sumber daya untuk keamanan dan kontrol akses. URL fungsi juga mendukung opsi konfigurasi cross-origin resource sharing (CORS).

Anda dapat menerapkan URL fungsi ke alias fungsi apa pun, atau ke versi fungsi yang $LATEST tidak dipublikasikan. Anda tidak dapat menambahkan URL fungsi ke versi fungsi lainnya.

Bagian berikut menunjukkan cara membuat dan mengelola URL fungsi menggunakan konsol Lambda, AWS CLI, dan CloudFormation template. Untuk tutorial langkah demi langkah tentang menggunakan URL fungsi sebagai titik akhir webhook, lihat. Tutorial: Membuat titik akhir webhook menggunakan URL fungsi Lambda

Membuat URL fungsi (konsol)

Ikuti langkah-langkah ini untuk membuat URL fungsi menggunakan konsol.

Membuat URL fungsi (AWS CLI)

Untuk membuat URL fungsi untuk fungsi Lambda yang ada menggunakan AWS Command Line Interface (AWS CLI), jalankan perintah berikut:

aws lambda create-function-url-config \
    --function-name my-function \
    --qualifier prod \ // optional
    --auth-type AWS_IAM
    --cors-config {AllowOrigins="https://example.com"} // optional

Ini menambahkan URL fungsi ke ku prod alifikasi untuk fungsi my-function tersebut. Untuk informasi selengkapnya tentang parameter konfigurasi ini, lihat CreateFunctionUrlConfig di referensi API.

Menambahkan URL fungsi ke CloudFormation template

Untuk menambahkan AWS::Lambda::Url sumber daya ke CloudFormation template Anda, gunakan sintaks berikut:

JSON

{
  "Type" : "AWS::Lambda::Url",
  "Properties" : {
      "AuthType" : String,
      "Cors" : Cors,
      "Qualifier" : String,
      "TargetFunctionArn" : String
    }
}

YAML

Type: AWS::Lambda::Url
Properties: 
  AuthType: String
  Cors: 
    Cors
  Qualifier: String
  TargetFunctionArn: String

Parameter

Cross-origin berbagi sumber daya (CORS)

Untuk menentukan bagaimana asal yang berbeda dapat mengakses URL fungsi Anda, gunakan cross-origin resource sharing (CORS). Sebaiknya konfigurasi CORS jika Anda ingin memanggil URL fungsi Anda dari domain yang berbeda. Lambda mendukung header CORS berikut untuk URL fungsi.

Ketika Anda mengonfigurasi CORS untuk URL fungsi menggunakan konsol Lambda atau AWS CLI, Lambda secara otomatis menambahkan header CORS ke semua respons melalui URL fungsi. Atau, Anda dapat menambahkan header CORS secara manual ke respons fungsi Anda. Jika ada header yang saling bertentangan, perilaku yang diharapkan tergantung pada jenis permintaan:

Secara umum, kami sarankan mengonfigurasi semua pengaturan CORS pada URL fungsi, daripada mengirim header CORS secara manual dalam respons fungsi.

URL fungsi pembatasan

Throttling membatasi tingkat di mana fungsi Anda memproses permintaan. Ini berguna dalam banyak situasi, seperti mencegah fungsi Anda membebani sumber daya hilir, atau menangani lonjakan permintaan yang tiba-tiba.

Anda dapat membatasi tingkat permintaan yang diproses fungsi Lambda Anda melalui URL fungsi dengan mengonfigurasi konkurensi yang dicadangkan. Konkurensi yang dicadangkan membatasi jumlah pemanggilan bersamaan maksimum untuk fungsi Anda. Tingkat permintaan maksimum per detik (RPS) fungsi Anda setara dengan 10 kali konkurensi cadangan yang dikonfigurasi. Misalnya, jika Anda mengonfigurasi fungsi Anda dengan konkurensi cadangan 100, maka RPS maksimum adalah 1.000.

Setiap kali konkurensi fungsi Anda melebihi konkurensi yang dicadangkan, URL fungsi Anda mengembalikan kode 429 status HTTP. Jika fungsi Anda menerima permintaan yang melebihi maksimum RPS 10x berdasarkan konkurensi cadangan yang dikonfigurasi, Anda juga menerima kesalahan HTTP. 429 Untuk informasi selengkapnya tentang konkurensi yang dipesan, lihatMengkonfigurasi konkurensi yang dicadangkan untuk suatu fungsi.

Menonaktifkan URL fungsi

Dalam keadaan darurat, Anda mungkin ingin menolak semua lalu lintas ke URL fungsi Anda. Untuk menonaktifkan URL fungsi Anda, atur konkurensi yang dicadangkan ke nol. Ini membatasi semua permintaan ke URL fungsi Anda, menghasilkan respons 429 status HTTP. Untuk mengaktifkan kembali URL fungsi Anda, hapus konfigurasi konkurensi yang dicadangkan, atau atur konfigurasi ke jumlah yang lebih besar dari nol.

Menghapus URL fungsi

Saat Anda menghapus URL fungsi, Anda tidak dapat memulihkannya. Membuat URL fungsi baru menghasilkan alamat URL yang berbeda.