本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
PutRuntimeManagementConfig
設定函數版本的執行階段管理組態。如需詳細資訊，請參閱執行階段更新。
請求語法
PUT /2021-07-20/functions/FunctionName/runtime-management-config?Qualifier=Qualifier HTTP/1.1
Content-type: application/json
{
"RuntimeVersionArn": "string",
"UpdateRuntimeOn": "string"
}URI 請求參數
請求會使用下列 URI 參數。
- FunctionName
-
Lambda 函數的名稱。
名稱格式
-
函數名稱 -
my-function。 -
函數 ARN -
arn:aws:lambda:us-west-2:123456789012:function:my-function。 -
部分 ARN -
123456789012:function:my-function。
長度限制條件僅會套用到完整的 ARN。若您僅指定函數名稱，則其長度限制為 64 個字元。
長度限制：長度下限為 1。長度上限為 140。
模式：
(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-_]+))?必要：是
-
- Qualifier
-
指定函數的版本。這可以是
$LATEST或已發佈的版本編號。如果未指定任何值，則會傳回$LATEST版本的組態。長度限制：長度下限為 1。長度上限為 128。
模式：
(|[a-zA-Z0-9$_-]+)
請求主體
請求接受採用 JSON 格式的下列資料。
- RuntimeVersionArn
-
您希望函數使用的執行階段版本之 ARN。
注意
只有在使用 Manual (手動) 執行階段更新模式時才需要此項。
類型：字串
長度限制：長度下限為 26。長度上限為 2048。
模式：
^arn:(aws[a-zA-Z-]*):lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}::runtime:.+$必要：否
- UpdateRuntimeOn
-
指定執行階段更新模式。
-
Auto (default) (自動 (預設)) - 使用兩階段執行階段版本推展，自動更新為最新且安全的執行階段版本。對於大多數客戶來說，這是確保總是能受益於執行階段更新的最佳選擇。
-
Function update (函數更新) - 當您更新函數時，Lambda 會將函數的執行階段更新為最新且安全的執行階段版本。這種做法可同步執行階段更新與函數部署，讓您控制何時套用執行階段更新，並及早偵測和減輕罕見的執行階段更新不相容情況。使用此設定時，您需要定期更新函數以保持其執行階段 up-to-date。
-
Manual (手動) - 您可以在函數組態中指定執行階段版本。該函數將無限期使用此執行階段版本。在罕見情況下，新的執行階段版本會與現有函數不相容，這可讓您將函數復原至較舊的執行階段版本。如需詳細資訊，請參閱復原執行階段版本。
類型：字串
有效值:
Auto | Manual | FunctionUpdate必要：是
-
回應語法
HTTP/1.1 200
Content-type: application/json
{
"FunctionArn": "string",
"RuntimeVersionArn": "string",
"UpdateRuntimeOn": "string"
}回應元素
如果動作成功，則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
- FunctionArn
-
函數的 ARN
類型：String
模式：
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-_]+))? - RuntimeVersionArn
-
設定讓函數使用的執行階段之 ARN。如果執行階段更新模式為 Manual (手動)，系統會傳回 ARN，否則傳回
null。類型：字串
長度限制：長度下限為 26。長度上限為 2048。
模式：
^arn:(aws[a-zA-Z-]*):lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}::runtime:.+$ - UpdateRuntimeOn
-
執行階段更新模式。
類型：字串
有效值:
Auto | Manual | FunctionUpdate
錯誤
如需所有動作常見錯誤的資訊，請參閱常見錯誤。
- InvalidParameterValueException
-
請求中的其中一個參數無效。
HTTP 狀態碼：400
- ResourceConflictException
-
資源已存在，或另一個操作正在進行中。
HTTP 狀態碼：409
- ResourceNotFoundException
-
請求中指定的資源不存在。
HTTP 狀態碼：404
- ServiceException
-
AWS Lambda 服務發生內部錯誤。
HTTP 狀態碼：500
- TooManyRequestsException
-
超出請求輸送量限制。如需詳細資訊，請參閱 Lambda 配額。
HTTP 狀態碼：429
另請參閱
如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
