CreateFunctionUrlConfig

Membuat URL fungsi Lambda dengan parameter konfigurasi yang ditentukan. URL fungsi adalah titik akhir HTTP (S) khusus yang dapat Anda gunakan untuk menjalankan fungsi Anda.

Minta Sintaks

POST /2021-10-31/functions/FunctionName/url?Qualifier=Qualifier HTTP/1.1
Content-type: application/json

{
   "AuthType": "string",
   "Cors": { 
      "AllowCredentials": boolean,
      "AllowHeaders": [ "string" ],
      "AllowMethods": [ "string" ],
      "AllowOrigins": [ "string" ],
      "ExposeHeaders": [ "string" ],
      "MaxAge": number
   },
   "InvokeMode": "string"
}

Parameter Permintaan URI

Permintaan menggunakan parameter URI berikut.

FunctionName

Nama fungsi Lambda.

Format nama

• Nama fungsi —my-function.

• Fungsi ARN —. arn:aws:lambda:us-west-2:123456789012:function:my-function

• ARN Sebagian —. 123456789012:function:my-function

Batas panjang hanya berlaku untuk ARN penuh. Jika Anda hanya menentukan nama fungsi, panjang nama dibatasi hingga 64 karakter.

Panjang Batasan: Panjang minimum 1. Panjang maksimum 140.

Pola: (arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}(-gov)?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?

Diperlukan: Ya

Qualifier

Nama alias.

Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.

Pola: (^\$LATEST$)|((?!^[0-9]+$)([a-zA-Z0-9-_]+))

Isi Permintaan

Permintaan menerima data berikut dalam format JSON.

AuthType

Jenis otentikasi yang digunakan URL fungsi Anda. Setel ke AWS_IAM jika Anda ingin membatasi akses ke pengguna yang diautentikasi saja. Setel ke NONE jika Anda ingin melewati otentikasi IAM untuk membuat titik akhir publik. Untuk informasi selengkapnya, lihat Model keamanan dan autentikasi untuk URL fungsi Lambda.

Jenis: String

Nilai yang Valid: NONE | AWS_IAM

Diperlukan: Ya

Cors

Pengaturan berbagi sumber daya lintas asal (CORS) untuk URL fungsi Anda.

Tipe: Objek Cors

Diperlukan: Tidak

InvokeMode

Gunakan salah satu opsi berikut:

• BUFFERED— Ini adalah opsi default. Lambda memanggil fungsi Anda menggunakan operasi API. Invoke Hasil pemanggilan tersedia saat muatan selesai. Ukuran muatan maksimum adalah 6 MB.

• RESPONSE_STREAM— Fungsi Anda mengalirkan hasil payload saat tersedia. Lambda memanggil fungsi Anda menggunakan operasi API. InvokeWithResponseStream Ukuran payload respons maksimum adalah 20 MB, namun Anda dapat meminta peningkatan kuota.

Jenis: String

Nilai yang Valid: BUFFERED | RESPONSE_STREAM

Diperlukan: Tidak

Sintaksis Respons

HTTP/1.1 201
Content-type: application/json

{
   "AuthType": "string",
   "Cors": { 
      "AllowCredentials": boolean,
      "AllowHeaders": [ "string" ],
      "AllowMethods": [ "string" ],
      "AllowOrigins": [ "string" ],
      "ExposeHeaders": [ "string" ],
      "MaxAge": number
   },
   "CreationTime": "string",
   "FunctionArn": "string",
   "FunctionUrl": "string",
   "InvokeMode": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respon HTTP 201.

Layanan mengembalikan data berikut dalam format JSON.

AuthType

Jenis otentikasi yang digunakan URL fungsi Anda. Setel ke AWS_IAM jika Anda ingin membatasi akses ke pengguna yang diautentikasi saja. Setel ke NONE jika Anda ingin melewati otentikasi IAM untuk membuat titik akhir publik. Untuk informasi selengkapnya, lihat Model keamanan dan autentikasi untuk URL fungsi Lambda.

Jenis: String

Nilai yang Valid: NONE | AWS_IAM

Cors

Pengaturan berbagi sumber daya lintas asal (CORS) untuk URL fungsi Anda.

Tipe: Objek Cors

CreationTime

Ketika URL fungsi dibuat, dalam format ISO-8601 (yyyy-mm-ddthh: mm:ss.stzd).

Jenis: String

FunctionArn

Nama Sumber Daya Amazon (ARN) dari fungsi Anda.

Jenis: String

Pola: arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}(-gov)?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?

FunctionUrl

Endpoint URL HTTP untuk fungsi Anda.

Jenis: String

Kendala Panjang: Panjang minimum 40. Panjang maksimum 100.

InvokeMode

Gunakan salah satu opsi berikut:

• BUFFERED— Ini adalah opsi default. Lambda memanggil fungsi Anda menggunakan operasi API. Invoke Hasil pemanggilan tersedia saat muatan selesai. Ukuran muatan maksimum adalah 6 MB.

• RESPONSE_STREAM— Fungsi Anda mengalirkan hasil payload saat tersedia. Lambda memanggil fungsi Anda menggunakan operasi API. InvokeWithResponseStream Ukuran payload respons maksimum adalah 20 MB, namun Anda dapat meminta peningkatan kuota.

Jenis: String

Nilai yang Valid: BUFFERED | RESPONSE_STREAM

Kesalahan

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.

InvalidParameterValueException

Salah satu parameter dalam permintaan tidak valid.

Kode Status HTTP: 400

ResourceConflictException

Sumber daya sudah ada, atau operasi lain sedang berlangsung.

Kode Status HTTP: 409

ResourceNotFoundException

Sumber daya yang ditentukan dalam permintaan tidak ada.

Kode Status HTTP: 404

ServiceException

Layanan AWS Lambda mengalami kesalahan internal.

Kode Status HTTP: 500

TooManyRequestsException

Batas throughput permintaan terlampaui. Untuk informasi lebih lanjut, lihat Kuota Lambda.

Kode Status HTTP: 429

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini:

• AWS Command Line Interface

• AWS SDK for .NET

• AWS SDK for C++

• AWS SDK for Go.

• AWSSDK for Java V2

• AWSSDK untuk V3 JavaScript

• AWS SDK for PHP V3

• AWS SDK for Python

• AWS SDK for Ruby V3