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

Membuat dan mengelola fungsi Lambda URLs

Fungsi URL adalah titik akhir khusus HTTP (S) untuk fungsi Lambda Anda. Anda dapat membuat dan mengonfigurasi fungsi URL melalui konsol Lambda atau Lambda. API Saat Anda membuat fungsiURL, Lambda secara otomatis menghasilkan URL titik akhir yang unik untuk Anda. Setelah Anda membuat fungsiURL, URL titik akhirnya tidak pernah berubah. URLTitik akhir fungsi memiliki format berikut:

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

Fungsi URLs adalah dual stack-enabled, mendukung dan. IPv4 IPv6 Setelah Anda mengkonfigurasi fungsi URL untuk fungsi Anda, Anda dapat memanggil fungsi Anda melalui titik akhir HTTP (S) melalui browser web, curl, Postman, atau klien apa pun. HTTP

Fungsi Lambda URLs menggunakan kebijakan berbasis sumber daya untuk keamanan dan kontrol akses. Fungsi URLs juga mendukung opsi konfigurasi berbagi sumber daya lintas asal (CORS).

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

Bagian berikut menunjukkan cara membuat dan mengelola fungsi URL menggunakan konsol Lambda, AWS CLI, dan template AWS CloudFormation

Membuat fungsi URL (konsol)

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

Membuat fungsi URL (AWS CLI)

Untuk membuat fungsi URL 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 fungsi URL ke prod qualifier untuk fungsi my-function tersebut. Untuk informasi selengkapnya tentang parameter konfigurasi ini, lihat CreateFunctionUrlConfigdi API referensi.

Menambahkan fungsi URL ke CloudFormation template

Untuk menambahkan AWS::Lambda::Url sumber daya ke AWS 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

Berbagi sumber daya lintas asal () CORS

Untuk menentukan cara asal yang berbeda dapat mengakses fungsi AndaURL, gunakan berbagi sumber daya lintas asal (CORS). Sebaiknya konfigurasi CORS jika Anda bermaksud memanggil fungsi Anda URL dari domain yang berbeda. Lambda mendukung CORS header berikut untuk fungsi. URLs

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

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

Fungsi pelambatan URLs

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

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

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

Menonaktifkan fungsi URLs

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

Menghapus fungsi URLs

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