GetFunctionConfiguration - AWS Lambda

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

GetFunctionConfiguration

Mengembalikan pengaturan khusus versi dari fungsi atau versi Lambda. Output hanya mencakup opsi yang dapat bervariasi di antara versi fungsi. Untuk mengubah pengaturan ini, gunakan UpdateFunctionConfiguration.

Untuk mendapatkan semua detail fungsi, termasuk pengaturan tingkat fungsi, gunakan GetFunction.

Sintaks Permintaan

GET /2015-03-31/functions/FunctionName/configuration?Qualifier=Qualifier HTTP/1.1

Parameter Permintaan URI

Permintaan menggunakan parameter URI berikut.

FunctionName

Nama fungsi Lambda, versi, atau alias.

Format nama
  • Nama fungsimy-function (hanya nama), my-function:v1 (dengan alias).

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

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

Anda dapat menambahkan nomor versi atau alias ke salah satu format. 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 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-_]+))?

Diperlukan: Ya

Qualifier

Tentukan versi atau alias untuk mendapatkan detail tentang versi fungsi yang diterbitkan.

Panjang Batasan: Panjang minimum 1. Panjang maksimum 128.

Pola: (|[a-zA-Z0-9$_-]+)

Isi Permintaan

Permintaan tidak memiliki isi permintaan.

Sintaks 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

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

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

Nilai yang Valid: EniLimitExceeded | InsufficientRolePermissions | InvalidConfiguration | InternalError | SubnetOutOfIPAddresses | InvalidSubnet | InvalidSecurityGroup | ImageDeleted | ImageAccessDenied | InvalidImage | KMSKeyAccessDenied | KMSKeyNotFound | InvalidStateKMSKey | DisabledKMSKey | EFSIOError | EFSMountConnectivityError | EFSMountFailure | EFSMountTimeout | InvalidRuntime | InvalidZipFileException | FunctionError

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

Nilai yang Valid: nodejs | nodejs4.3 | nodejs6.10 | nodejs8.10 | nodejs10.x | nodejs12.x | nodejs14.x | nodejs16.x | java8 | java8.al2 | java11 | python2.7 | python3.6 | python3.7 | python3.8 | python3.9 | dotnetcore1.0 | dotnetcore2.0 | dotnetcore2.1 | dotnetcore3.1 | dotnet6 | nodejs4.3-edge | go1.x | ruby2.5 | ruby2.7 | provided | provided.al2 | nodejs18.x | python3.10 | java17 | ruby3.2 | python3.11 | nodejs20.x | provided.al2023 | python3.12 | java21

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

Nilai yang Valid: Idle | Creating | Restoring | EniLimitExceeded | InsufficientRolePermissions | InvalidConfiguration | InternalError | SubnetOutOfIPAddresses | InvalidSubnet | InvalidSecurityGroup | ImageDeleted | ImageAccessDenied | InvalidImage | KMSKeyAccessDenied | KMSKeyNotFound | InvalidStateKMSKey | DisabledKMSKey | EFSIOError | EFSMountConnectivityError | EFSMountFailure | EFSMountTimeout | InvalidRuntime | InvalidZipFileException | FunctionError

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.

InvalidParameterValueException

Salah satu parameter dalam permintaan tidak valid.

Kode Status HTTP: 400

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: