Menggunakan objek konteks Lambda untuk mengambil informasi fungsi Go - AWS Lambda

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

Menggunakan objek konteks Lambda untuk mengambil informasi fungsi Go

Di Lambda, objek konteks menyediakan metode dan properti dengan informasi tentang lingkungan invokasi, fungsi, dan eksekusi. Saat Lambda menjalankan fungsi Anda, ia meneruskan objek konteks ke handler. Untuk menggunakan objek konteks di handler Anda, Anda dapat secara opsional mendeklarasikannya sebagai parameter input ke handler Anda. Objek konteks diperlukan jika Anda ingin melakukan hal berikut di handler Anda:

Variabel, metode, dan properti yang didukung dalam objek konteks

Pustaka konteks Lambda menyediakan variabel, metode, dan sifat global berikut.

Variabel global
  • FunctionName – Nama fungsi Lambda.

  • FunctionVersionVersi fungsi.

  • MemoryLimitInMB – Jumlah memori yang dialokasikan untuk fungsi tersebut.

  • LogGroupName – Grup log untuk fungsi.

  • LogStreamName – Aliran log untuk instans fungsi.

Metode konteks
  • Deadline – Mengembalikan tanggal saat waktu pelaksanaan habis, dalam waktu Unix milidetik.

Properti konteks
  • InvokedFunctionArnAmazon Resource Name (ARN) yang digunakan untuk memicu fungsi. Menunjukkan jika pemicu menyebutkan nomor versi atau alias.

  • AwsRequestID – Pengidentifikasi permintaan invokasi.

  • Identity – (aplikasi seluler) Informasi tentang identitas Amazon Cognito yang mengesahkan permintaan.

  • ClientContext – (aplikasi seluler) Konteks klien yang disediakan untuk Lambda oleh aplikasi klien.

Mengakses informasi konteks aktif

Fungsi Lambda memiliki akses ke metadata tentang lingkungan mereka dan permintaan invokasi. Ini dapat diakses di Konteks paket. Jika handler Anda mencakup context.Context sebagai parameter, Lambda akan memasukkan informasi tentang fungsi Anda ke dalam Value properti konteks. Perhatikan bahwa Anda perlu mengimpor pustaka lambdacontext untuk mengakses konten dari context.Context objek.

package main import ( "context" "log" "github.com/aws/aws-lambda-go/lambda" "github.com/aws/aws-lambda-go/lambdacontext" ) func CognitoHandler(ctx context.Context) { lc, _ := lambdacontext.FromContext(ctx) log.Print(lc.Identity.CognitoIdentityPoolID) } func main() { lambda.Start(CognitoHandler) }

Dalam contoh di atas, lc adalah variabel yang digunakan untuk menggunakan informasi yang ditangkap oleh objek konteks dan log.Print(lc.Identity.CognitoIdentityPoolID) mencetak informasi tersebut, dalam kasus ini, CognitoIdentityPool ID.

Contoh berikut memperkenalkan cara menggunakan objek konteks untuk memantau berapa lama waktu yang dibutuhkan fungsi Lambda untuk menyelesaikannya. Ini memungkinkan Anda untuk menganalisis ekspektasi kinerja dan menyesuaikan kode fungsi Anda, jika diperlukan.

package main import ( "context" "log" "time" "github.com/aws/aws-lambda-go/lambda" ) func LongRunningHandler(ctx context.Context) (string, error) { deadline, _ := ctx.Deadline() deadline = deadline.Add(-100 * time.Millisecond) timeoutChannel := time.After(time.Until(deadline)) for { select { case <- timeoutChannel: return "Finished before timing out.", nil default: log.Print("hello!") time.Sleep(50 * time.Millisecond) } } } func main() { lambda.Start(LongRunningHandler) }

Menggunakan konteks dalam inisialisasi dan panggilan AWS SDK klien

Jika handler Anda perlu menggunakan untuk melakukan panggilan AWS SDK for Go ke layanan lain, sertakan objek konteks sebagai input ke handler Anda. Di AWS, ini adalah praktik terbaik untuk meneruskan objek konteks di sebagian besar AWS SDK panggilan. Misalnya, PutObject panggilan Amazon S3 menerima objek konteks (ctx) sebagai argumen pertamanya:

// Upload an object to S3 _, err = s3Client.PutObject(ctx, &s3.PutObjectInput{ ... })

Untuk menginisialisasi SDK klien Anda dengan benar, Anda juga dapat menggunakan objek konteks untuk memuat konfigurasi yang benar sebelum meneruskan objek konfigurasi itu ke klien:

// Load AWS SDK configuration using the default credential provider chain cfg, err := config.LoadDefaultConfig(ctx) ... s3Client = s3.NewFromConfig(cfg)

Jika Anda ingin menginisialisasi SDK klien Anda di luar handler utama Anda (yaitu selama fase inisialisasi), Anda dapat meneruskan objek konteks placeholder:

func init() { // Initialize the S3 client outside of the handler, during the init phase cfg, err := config.LoadDefaultConfig(context.TODO()) ... s3Client = s3.NewFromConfig(cfg) }

Jika Anda menginisialisasi klien Anda dengan cara ini, pastikan Anda meneruskan objek konteks yang benar dalam SDK panggilan dari pengendali utama Anda.