文件 AWS 開發套件範例 GitHub 儲存庫中有更多可用的 [AWS SDK 範例](https://github.com/awsdocs/aws-doc-sdk-examples)。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用適用於 Kotlin 的 SDK 的 Lambda 範例
下列程式碼範例示範如何使用適用於 Kotlin 的 AWS SDK 搭配 Lambda 來執行動作和實作常見案例。
*基本概念*是程式碼範例，這些範例說明如何在服務內執行基本操作。
*Actions* 是大型程式的程式碼摘錄，必須在內容中執行。雖然動作會告訴您如何呼叫個別服務函數，但您可以在其相關情境中查看內容中的動作。
*案例*是向您展示如何呼叫服務中的多個函數或與其他 AWS 服務組合來完成特定任務的程式碼範例。
每個範例均包含完整原始碼的連結，您可在連結中找到如何設定和執行內容中程式碼的相關指示。
**Topics**
+ [基本概念](#basics)
+ [動作](#actions)
+ [案例](#scenarios)
## 基本概念
### 了解基本概念
以下程式碼範例顯示做法：
+ 建立 IAM 角色和 Lambda 函數，然後上傳處理常式程式碼。
+ 調用具有單一參數的函數並取得結果。
+ 更新函數程式碼並使用環境變數進行設定。
+ 調用具有新參數的函數並取得結果。顯示傳回的執行日誌。
+ 列出您帳戶的函數，然後清理相關資源。
如需詳細資訊，請參閱[使用主控台建立 Lambda 函數](https://docs.aws.amazon.com/lambda/latest/dg/getting-started-create-function.html)。
**適用於 Kotlin 的 SDK**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/lambda#code-examples)中設定和執行。
```
suspend fun main(args: Array) {
val usage = """
Usage:
Where:
functionName - The name of the AWS Lambda function.
role - The AWS Identity and Access Management (IAM) service role that has AWS Lambda permissions.
handler - The fully qualified method name (for example, example.Handler::handleRequest).
bucketName - The Amazon Simple Storage Service (Amazon S3) bucket name that contains the ZIP or JAR used for the Lambda function's code.
updatedBucketName - The Amazon S3 bucket name that contains the .zip or .jar used to update the Lambda function's code.
key - The Amazon S3 key name that represents the .zip or .jar file (for example, LambdaHello-1.0-SNAPSHOT.jar).
"""
if (args.size != 6) {
println(usage)
exitProcess(1)
}
val functionName = args[0]
val role = args[1]
val handler = args[2]
val bucketName = args[3]
val updatedBucketName = args[4]
val key = args[5]
println("Creating a Lambda function named $functionName.")
val funArn = createScFunction(functionName, bucketName, key, handler, role)
println("The AWS Lambda ARN is $funArn")
// Get a specific Lambda function.
println("Getting the $functionName AWS Lambda function.")
getFunction(functionName)
// List the Lambda functions.
println("Listing all AWS Lambda functions.")
listFunctionsSc()
// Invoke the Lambda function.
println("*** Invoke the Lambda function.")
invokeFunctionSc(functionName)
// Update the AWS Lambda function code.
println("*** Update the Lambda function code.")
updateFunctionCode(functionName, updatedBucketName, key)
// println("*** Invoke the function again after updating the code.")
invokeFunctionSc(functionName)
// Update the AWS Lambda function configuration.
println("Update the run time of the function.")
updateFunctionConfiguration(functionName, handler)
// Delete the AWS Lambda function.
println("Delete the AWS Lambda function.")
delFunction(functionName)
}
suspend fun createScFunction(
myFunctionName: String,
s3BucketName: String,
myS3Key: String,
myHandler: String,
myRole: String,
): String {
val functionCode =
FunctionCode {
s3Bucket = s3BucketName
s3Key = myS3Key
}
val request =
CreateFunctionRequest {
functionName = myFunctionName
code = functionCode
description = "Created by the Lambda Kotlin API"
handler = myHandler
role = myRole
runtime = Runtime.Java17
}
// Create a Lambda function using a waiter
LambdaClient { region = "us-east-1" }.use { awsLambda ->
val functionResponse = awsLambda.createFunction(request)
awsLambda.waitUntilFunctionActive {
functionName = myFunctionName
}
return functionResponse.functionArn.toString()
}
}
suspend fun getFunction(functionNameVal: String) {
val functionRequest =
GetFunctionRequest {
functionName = functionNameVal
}
LambdaClient { region = "us-east-1" }.use { awsLambda ->
val response = awsLambda.getFunction(functionRequest)
println("The runtime of this Lambda function is ${response.configuration?.runtime}")
}
}
suspend fun listFunctionsSc() {
val request =
ListFunctionsRequest {
maxItems = 10
}
LambdaClient { region = "us-east-1" }.use { awsLambda ->
val response = awsLambda.listFunctions(request)
response.functions?.forEach { function ->
println("The function name is ${function.functionName}")
}
}
}
suspend fun invokeFunctionSc(functionNameVal: String) {
val json = """{"inputValue":"1000"}"""
val byteArray = json.trimIndent().encodeToByteArray()
val request =
InvokeRequest {
functionName = functionNameVal
payload = byteArray
logType = LogType.Tail
}
LambdaClient { region = "us-east-1" }.use { awsLambda ->
val res = awsLambda.invoke(request)
println("The function payload is ${res.payload?.toString(Charsets.UTF_8)}")
}
}
suspend fun updateFunctionCode(
functionNameVal: String?,
bucketName: String?,
key: String?,
) {
val functionCodeRequest =
UpdateFunctionCodeRequest {
functionName = functionNameVal
publish = true
s3Bucket = bucketName
s3Key = key
}
LambdaClient { region = "us-east-1" }.use { awsLambda ->
val response = awsLambda.updateFunctionCode(functionCodeRequest)
awsLambda.waitUntilFunctionUpdated {
functionName = functionNameVal
}
println("The last modified value is " + response.lastModified)
}
}
suspend fun updateFunctionConfiguration(
functionNameVal: String?,
handlerVal: String?,
) {
val configurationRequest =
UpdateFunctionConfigurationRequest {
functionName = functionNameVal
handler = handlerVal
runtime = Runtime.Java17
}
LambdaClient { region = "us-east-1" }.use { awsLambda ->
awsLambda.updateFunctionConfiguration(configurationRequest)
}
}
suspend fun delFunction(myFunctionName: String) {
val request =
DeleteFunctionRequest {
functionName = myFunctionName
}
LambdaClient { region = "us-east-1" }.use { awsLambda ->
awsLambda.deleteFunction(request)
println("$myFunctionName was deleted")
}
}
```
+ 如需 API 詳細資訊，請參閱《*AWS SDK for Kotlin API 參考*》中的下列主題。
+ [CreateFunction](https://sdk.amazonaws.com/kotlin/api/latest/index.html)
+ [DeleteFunction](https://sdk.amazonaws.com/kotlin/api/latest/index.html)
+ [GetFunction](https://sdk.amazonaws.com/kotlin/api/latest/index.html)
+ [Invoke](https://sdk.amazonaws.com/kotlin/api/latest/index.html)
+ [ListFunctions](https://sdk.amazonaws.com/kotlin/api/latest/index.html)
+ [UpdateFunctionCode](https://sdk.amazonaws.com/kotlin/api/latest/index.html)
+ [UpdateFunctionConfiguration](https://sdk.amazonaws.com/kotlin/api/latest/index.html)
## 動作
### `CreateFunction`
以下程式碼範例顯示如何使用 `CreateFunction`。
**適用於 Kotlin 的 SDK**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/lambda#code-examples)中設定和執行。
```
suspend fun createNewFunction(
myFunctionName: String,
s3BucketName: String,
myS3Key: String,
myHandler: String,
myRole: String,
): String? {
val functionCode =
FunctionCode {
s3Bucket = s3BucketName
s3Key = myS3Key
}
val request =
CreateFunctionRequest {
functionName = myFunctionName
code = functionCode
description = "Created by the Lambda Kotlin API"
handler = myHandler
role = myRole
runtime = Runtime.Java17
}
LambdaClient { region = "us-east-1" }.use { awsLambda ->
val functionResponse = awsLambda.createFunction(request)
awsLambda.waitUntilFunctionActive {
functionName = myFunctionName
}
return functionResponse.functionArn
}
}
```
+ 如需 API 詳細資訊，請參閱《*適用於 Kotlin 的AWS 開發套件 API 參考*》中的「[CreateFunction](https://sdk.amazonaws.com/kotlin/api/latest/index.html)」。
### `DeleteFunction`
以下程式碼範例顯示如何使用 `DeleteFunction`。
**適用於 Kotlin 的 SDK**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/lambda#code-examples)中設定和執行。
```
suspend fun delLambdaFunction(myFunctionName: String) {
val request =
DeleteFunctionRequest {
functionName = myFunctionName
}
LambdaClient { region = "us-east-1" }.use { awsLambda ->
awsLambda.deleteFunction(request)
println("$myFunctionName was deleted")
}
}
```
+ 如需 API 詳細資訊，請參閱《*適用於 Kotlin 的AWS 開發套件 API 參考*》中的「[DeleteFunction](https://sdk.amazonaws.com/kotlin/api/latest/index.html)」。
### `Invoke`
以下程式碼範例顯示如何使用 `Invoke`。
**適用於 Kotlin 的 SDK**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/lambda#code-examples)中設定和執行。
```
suspend fun invokeFunction(functionNameVal: String) {
val json = """{"inputValue":"1000"}"""
val byteArray = json.trimIndent().encodeToByteArray()
val request =
InvokeRequest {
functionName = functionNameVal
logType = LogType.Tail
payload = byteArray
}
LambdaClient { region = "us-west-2" }.use { awsLambda ->
val res = awsLambda.invoke(request)
println("${res.payload?.toString(Charsets.UTF_8)}")
println("The log result is ${res.logResult}")
}
}
```
+ 如需 API 的詳細資訊，請參閱《*適用於 Kotlin 的AWS 開發套件 API 參考*》中的「[Invoke](https://sdk.amazonaws.com/kotlin/api/latest/index.html)」。
## 案例
### 建立無伺服器應用程式來管理相片
下列程式碼範例示範如何建立無伺服器應用程式，讓使用者以標籤管理相片。
**SDK for Kotlin**
顯示如何開發照片資產管理應用程式，以便使用 Amazon Rekognition 偵測圖片中的標籤，並將其儲存以供日後擷取。
如需完整的原始碼和如何設定及執行的指示，請參閱 [GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/usecases/creating_pam) 上的完整範例。
如要深入探索此範例的來源，請參閱 [AWS 社群](https://community.aws/posts/cloud-journeys/01-serverless-image-recognition-app)上的文章。
**此範例中使用的服務**
+ API Gateway
+ DynamoDB
+ Lambda
+ Amazon Rekognition
+ Amazon S3
+ Amazon SNS