Minta Sintaks Parameter Permintaan URI Isi Permintaan Sintaksis Respons Elemen Respons Kesalahan Lihat Juga

UpdateFunctionConfiguration

Ubah pengaturan khusus versi dari fungsi Lambda.

Ketika Anda memperbarui fungsi, Lambda menyediakan instans dari fungsi dan sumber daya pendukungnya. Jika fungsi Anda terhubung ke VPC, proses ini bisa memakan waktu satu menit. Selama waktu ini, Anda tidak dapat memodifikasi fungsi, tetapi Anda masih dapat memanggilnya. Bidang LastUpdateStatus, LastUpdateStatusReason, dan LastUpdateStatusReasonCode dalam respons dari GetFunctionConfiguration menunjukkan ketika pembaruan selesai dan fungsi memproses peristiwa dengan konfigurasi baru. Untuk informasi selengkapnya, lihat Status fungsi Lambda.

Pengaturan ini dapat bervariasi antara versi fungsi dan terkunci saat Anda memublikasikan versi. Anda tidak dapat mengubah konfigurasi versi yang dipublikasikan, hanya versi yang tidak dipublikasikan.

Untuk mengonfigurasi konkurensi fungsi, gunakan PutFunctionConcurrency. Untuk memberikan izin pemanggilan ke Akun AWS atauLayanan AWS, gunakan. AddPermission

Minta Sintaks


PUT /2015-03-31/functions/FunctionName/configuration HTTP/1.1
Content-type: application/json

{
   "DeadLetterConfig": { 
      "TargetArn": "string"
   },
   "Description": "string",
   "Environment": { 
      "Variables": { 
         "string" : "string" 
      }
   },
   "EphemeralStorage": { 
      "Size": number
   },
   "FileSystemConfigs": [ 
      { 
         "Arn": "string",
         "LocalMountPath": "string"
      }
   ],
   "Handler": "string",
   "ImageConfig": { 
      "Command": [ "string" ],
      "EntryPoint": [ "string" ],
      "WorkingDirectory": "string"
   },
   "KMSKeyArn": "string",
   "Layers": [ "string" ],
   "LoggingConfig": { 
      "ApplicationLogLevel": "string",
      "LogFormat": "string",
      "LogGroup": "string",
      "SystemLogLevel": "string"
   },
   "MemorySize": number,
   "RevisionId": "string",
   "Role": "string",
   "Runtime": "string",
   "SnapStart": { 
      "ApplyOn": "string"
   },
   "Timeout": number,
   "TracingConfig": { 
      "Mode": "string"
   },
   "VpcConfig": { 
      "Ipv6AllowedForDualStack": boolean,
      "SecurityGroupIds": [ "string" ],
      "SubnetIds": [ "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-_]+))?

Wajib: Ya

Isi Permintaan

Permintaan menerima data berikut dalam format JSON.

DeadLetterConfig

Konfigurasi antrian huruf mati yang menentukan antrian atau topik tempat Lambda mengirimkan peristiwa asinkron saat gagal diproses. Untuk informasi selengkapnya, lihat Antrian surat mati.

Tipe: Objek DeadLetterConfig

Diperlukan: Tidak

Description

Deskripsi fungsi.

Tipe: String

Batasan Panjang: Panjang minimum 0. Panjang maksimum 256.

Diperlukan: Tidak

Environment

Variabel lingkungan yang dapat diakses dari kode fungsi selama eksekusi.

Tipe: Objek Environment.

Diperlukan: Tidak

EphemeralStorage

Ukuran /tmp direktori fungsi dalam MB. Nilai defaultnya adalah 512, tetapi bisa berupa bilangan bulat antara 512 dan 10.240 MB. Untuk informasi selengkapnya, lihat Mengonfigurasi penyimpanan sementara (konsol).

Tipe: Objek EphemeralStorage

Diperlukan: Tidak

FileSystemConfigs

Pengaturan koneksi untuk sistem file Amazon EFS.

Tipe: Array objek FileSystemConfig

Anggota Array: Jumlah maksimum 1 item.

Diperlukan: Tidak

Handler

Nama metode dalam kode Anda yang dipanggil Lambda untuk menjalankan fungsi Anda. Handler diperlukan jika paket penyebaran adalah arsip file.zip. Formatnya termasuk nama file. Ini juga dapat mencakup namespace dan kualifikasi lainnya, tergantung pada runtime. Untuk informasi selengkapnya, lihat Model pemrograman Lambda.

Jenis: String

Batasan Panjang: Panjang maksimum 128.

Pola: [^\s]+

Diperlukan: Tidak

ImageConfig

Nilai konfigurasi gambar kontainer yang mengesampingkan nilai dalam file Docker image kontainer.

Tipe: Objek ImageConfig

Diperlukan: Tidak

KMSKeyArn

ARN dari AWS Key Management Service (AWS KMS) kunci terkelola pelanggan yang digunakan untuk mengenkripsi variabel lingkungan fungsi Anda. Ketika Lambda SnapStart diaktifkan, Lambda juga menggunakan kunci ini untuk mengenkripsi snapshot fungsi Anda. Jika Anda menerapkan fungsi Anda menggunakan gambar kontainer, Lambda juga menggunakan kunci ini untuk mengenkripsi fungsi Anda saat di-deploy. Perhatikan bahwa ini bukan kunci yang sama yang digunakan untuk melindungi gambar kontainer Anda di Amazon Elastic Container Registry (Amazon ECR). Jika Anda tidak memberikan kunci terkelola pelanggan, Lambda menggunakan kunci layanan default.

Jenis: String

Pola: (arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()

Diperlukan: Tidak

Layers

Daftar lapisan fungsi untuk menambah lingkungan eksekusi fungsi. Tentukan tiap lapisan berdasarkan ARN-nya, termasuk versi.

Tipe: Array string.

Panjang Batasan: Panjang minimum 1. Panjang maksimum 140.

Pola: arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+:[0-9]+

Diperlukan: Tidak

LoggingConfig

Pengaturan konfigurasi Amazon CloudWatch Logs fungsi.

Tipe: Objek LoggingConfig

Diperlukan: Tidak

MemorySize

Jumlah memori yang tersedia untuk fungsi saat waktu aktif. Meningkatkan memori fungsi juga meningkatkan alokasi CPU-nya. Nilai default adalah 128 MB. Nilai dapat berupa kelipatan 1 MB.

Tipe: Integer

Rentang yang Valid: Nilai minimum 128. Nilai maksimum 10240.

Diperlukan: Tidak

RevisionId

Perbarui fungsi hanya jika ID revisi cocok dengan ID yang ditentukan. Gunakan opsi ini untuk menghindari memodifikasi fungsi yang sudah berubah sejak terakhir kali Anda membacanya.

Tipe: String

Wajib: Tidak

Role

Amazon Resource Name (ARN) dari peran eksekusi fungsi.

Tipe: String

Pola: arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+

Diperlukan: Tidak

Runtime

Pengenal waktu aktif fungsi. Runtime diperlukan jika paket penerapan adalah arsip file.zip.

Daftar berikut mencakup runtime usang. Untuk informasi selengkapnya, lihat Kebijakan penghentian waktu proses.

Jenis: String

Diperlukan: Tidak

SnapStart

SnapStartPengaturan fungsi.

Tipe: Objek SnapStart

Diperlukan: Tidak

Timeout

Jumlah waktu (dalam detik) yang memungkinkan Lambda menjalankan fungsi sebelum menghentikannya. Waktu default adalah 3 detik. Nilai maksimum yang diizinkan adalah 900 detik. Untuk informasi selengkapnya, lihat Lingkungan eksekusi Lambda.

Jenis: Integer

Rentang yang Valid: Nilai minimum 1.

Diperlukan: Tidak

TracingConfig

Atur Mode ke Active untuk mengambil sampel dan melacak subset dari permintaan masuk dengan X-Ray.

Tipe: Objek TracingConfig.

Diperlukan: Tidak

VpcConfig

Untuk konektivitas jaringan ke sumber daya AWS dalam VPC, tentukan daftar grup keamanan dan subnet di VPC. Ketika Anda menghubungkan fungsi ke VPC, ia dapat mengakses sumber daya dan internet hanya melalui VPC itu. Untuk informasi selengkapnya, lihat Mengonfigurasi fungsi Lambda untuk mengakses sumber daya di VPC.

Tipe: Objek VpcConfig

Wajib: Tidak

Sintaksis Respons


HTTP/1.1 200
Content-type: application/json

{
   "Architectures": [ "string" ],
   "CodeSha256": "string",
   "CodeSize": number,
   "DeadLetterConfig": { 
      "TargetArn": "string"
   },
   "Description": "string",
   "Environment": { 
      "Error": { 
         "ErrorCode": "string",
         "Message": "string"
      },
      "Variables": { 
         "string" : "string" 
      }
   },
   "EphemeralStorage": { 
      "Size": number
   },
   "FileSystemConfigs": [ 
      { 
         "Arn": "string",
         "LocalMountPath": "string"
      }
   ],
   "FunctionArn": "string",
   "FunctionName": "string",
   "Handler": "string",
   "ImageConfigResponse": { 
      "Error": { 
         "ErrorCode": "string",
         "Message": "string"
      },
      "ImageConfig": { 
         "Command": [ "string" ],
         "EntryPoint": [ "string" ],
         "WorkingDirectory": "string"
      }
   },
   "KMSKeyArn": "string",
   "LastModified": "string",
   "LastUpdateStatus": "string",
   "LastUpdateStatusReason": "string",
   "LastUpdateStatusReasonCode": "string",
   "Layers": [ 
      { 
         "Arn": "string",
         "CodeSize": number,
         "SigningJobArn": "string",
         "SigningProfileVersionArn": "string"
      }
   ],
   "LoggingConfig": { 
      "ApplicationLogLevel": "string",
      "LogFormat": "string",
      "LogGroup": "string",
      "SystemLogLevel": "string"
   },
   "MasterArn": "string",
   "MemorySize": number,
   "PackageType": "string",
   "RevisionId": "string",
   "Role": "string",
   "Runtime": "string",
   "RuntimeVersionConfig": { 
      "Error": { 
         "ErrorCode": "string",
         "Message": "string"
      },
      "RuntimeVersionArn": "string"
   },
   "SigningJobArn": "string",
   "SigningProfileVersionArn": "string",
   "SnapStart": { 
      "ApplyOn": "string",
      "OptimizationStatus": "string"
   },
   "State": "string",
   "StateReason": "string",
   "StateReasonCode": "string",
   "Timeout": number,
   "TracingConfig": { 
      "Mode": "string"
   },
   "Version": "string",
   "VpcConfig": { 
      "Ipv6AllowedForDualStack": boolean,
      "SecurityGroupIds": [ "string" ],
      "SubnetIds": [ "string" ],
      "VpcId": "string"
   }
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

Architectures

Arsitektur set instruksi yang didukung fungsi. Arsitektur adalah array string dengan salah satu nilai yang valid. Nilai arsitektur default adalahx86_64.

Tipe: Array string

Anggota Array: Jumlah tetap 1 item.

Nilai yang Valid: x86_64 | arm64

CodeSha256

Hash SHA256 dari paket deployment fungsi.

Jenis: String

CodeSize

Ukuran paket deployment fungsi, dalam byte.

Tipe: Long

DeadLetterConfig

Antrean surat mati fungsi.

Tipe: Objek DeadLetterConfig

Description

Deskripsi fungsi.

Tipe: String

Batasan Panjang: Panjang minimum 0. Panjang maksimum 256.

Environment

Variabel lingkungan fungsi. Dihilangkan dari AWS CloudTrail log.

Tipe: Objek EnvironmentResponse

EphemeralStorage

Tipe: Objek EphemeralStorage

FileSystemConfigs

Pengaturan koneksi untuk sistem file Amazon EFS.

Tipe: Array objek FileSystemConfig

Anggota Array: Jumlah maksimum 1 item.

FunctionArn

Amazon Resource Name (ARN) fungsi.

Tipe: 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-_]+))?

FunctionName

Nama fungsi.

Tipe: String

Panjang Batasan: Panjang minimum 1. Panjang maksimum 170.

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-_]+))?

Handler

Fungsi yang dipanggil Lambda untuk mulai menjalankan fungsi Anda.

Jenis: String

Batasan Panjang: Panjang maksimum 128.

Pola: [^\s]+

ImageConfigResponse

Nilai konfigurasi gambar fungsi.

Tipe: Objek ImageConfigResponse

KMSKeyArn

AWS KMS keyYang digunakan untuk mengenkripsi variabel lingkungan fungsi. Ketika Lambda SnapStart diaktifkan, kunci ini juga digunakan untuk mengenkripsi snapshot fungsi. Kunci ini dikembalikan hanya jika Anda telah mengonfigurasi kunci yang dikelola pelanggan.

Jenis: String

Pola: (arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()

LastModified

Tanggal dan waktu fungsi terakhir diperbarui, dalam format ISO-8601 (YYYY-MM-DDThh:mm:ss.sTZD).

Jenis: String

LastUpdateStatus

Status pembaruan terakhir yang dilakukan pada fungsi. Ini adalah set pertama untuk Successful setelah fungsi selesai dibuat.

Jenis: String

Nilai yang Valid: Successful | Failed | InProgress

LastUpdateStatusReason

Alasan pembaruan terakhir yang dilakukan pada fungsi.

Jenis: String

LastUpdateStatusReasonCode

Kode alasan pembaruan terakhir yang dilakukan pada fungsi.

Jenis: String

Layers

Lapisan fungsi.

Tipe: Array objek Layer

LoggingConfig

Pengaturan konfigurasi Amazon CloudWatch Logs fungsi.

Tipe: Objek LoggingConfig

MasterArn

Untuk fungsi Lambda @Edge, ARN dari fungsi utama.

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-_]+))?

MemorySize

Jumlah memori yang tersedia untuk fungsi saat waktu aktif.

Tipe: Integer

Rentang yang Valid: Nilai minimum 128. Nilai maksimum 10240.

PackageType

Tipe paket deployment. Atur ke Image untuk gambar kontainer dan atur Zip untuk arsip file .zip.

Jenis: String

Nilai yang Valid: Zip | Image

RevisionId

Revisi paling baru dari fungsi atau alias.

Jenis: String

Role

Peran eksekusi fungsi.

Tipe: String

Pola: arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+

Runtime

Pengenal waktu aktif fungsi. Runtime diperlukan jika paket penerapan adalah arsip file.zip.

Daftar berikut mencakup runtime usang. Untuk informasi selengkapnya, lihat Kebijakan penghentian waktu proses.

Jenis: String

RuntimeVersionConfig

ARN runtime dan kesalahan apa pun yang terjadi.

Tipe: Objek RuntimeVersionConfig

SigningJobArn

ARN tugas penandatanganan.

Tipe: String

Pola: arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)

SigningProfileVersionArn

ARN dari versi profil penandatanganan.

Tipe: String

Pola: arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)

SnapStart

Setel ApplyOn PublishedVersions untuk membuat snapshot dari lingkungan eksekusi yang diinisialisasi saat Anda memublikasikan versi fungsi. Untuk informasi selengkapnya, lihat Meningkatkan kinerja startup dengan Lambda SnapStart.

Tipe: Objek SnapStartResponse

State

Status fungsi saat ini. Ketika statusnya adalah Inactive, Anda dapat mengaktifkan kembali fungsi dengan memanggilnya.

Jenis: String

Nilai yang Valid: Pending | Active | Inactive | Failed

StateReason

Alasan untuk status fungsi saat ini.

Jenis: String

StateReasonCode

Kode alasan untuk status fungsi saat ini. Ketika kode adalah Creating, Anda tidak dapat memanggil atau memodifikasi fungsi.

Jenis: String

Timeout

Jumlah waktu yang dalam detik diizinkan Lambda untuk menjalankan fungsi sebelum menghentikannya.

Tipe: Integer

Rentang yang Valid: Nilai minimum 1.

TracingConfig

Konfigurasi pelacakan AWS X-Ray fungsi.

Tipe: Objek TracingConfigResponse

Version

Versi fungsi Lambda.

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 1024.

Pola: (\$LATEST|[0-9]+)

VpcConfig

Konfigurasi jaringan fungsi.

Tipe: Objek VpcConfigResponse

Kesalahan

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

CodeSigningConfigNotFoundException

Konfigurasi penandatanganan kode yang ditentukan tidak ada.

Kode Status HTTP: 404

CodeVerificationFailedException

Tanda tangan kode gagal dalam satu atau beberapa pemeriksaan validasi untuk ketidakcocokan atau masa berakhir tanda tangan, dan kebijakan penandatanganan kode diatur ke ENFORCE. Lambda memblokir deployment.

Kode Status HTTP: 400

InvalidCodeSignatureException

Tanda tangan kode gagal dalam pemeriksaan integritas. Jika pemeriksaan integritas gagal, Lambda memblokir penerapan, meskipun kebijakan penandatanganan kode disetel ke WARN.

Kode Status HTTP: 400

InvalidParameterValueException

Salah satu parameter dalam permintaan tidak valid.

Kode Status HTTP: 400

PreconditionFailedException

Yang RevisionId disediakan tidak cocok dengan yang terbaru RevisionId untuk fungsi atau alias Lambda. Panggil GetFunction atau operasi GetAlias API untuk mengambil yang terbaru RevisionId untuk sumber daya Anda.

Kode Status HTTP: 412

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:

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

UpdateFunctionCode

UpdateFunctionEventInvokeConfig