UpdateAlias - AWS Lambda

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

UpdateAlias

更新 Lambda 函數別名的組態。

請求語法

PUT /2015-03-31/functions/FunctionName/aliases/Name HTTP/1.1 Content-type: application/json { "Description": "string", "FunctionVersion": "string", "RevisionId": "string", "RoutingConfig": { "AdditionalVersionWeights": { "string" : number } } }

URI 請求參數

請求會使用下列 URI 參數。

FunctionName

Lambda 函數的名稱。

名稱格式
  • 函數名稱 - MyFunction

  • 函數 ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction

  • 部分 ARN - 123456789012:function:MyFunction

長度限制條件僅會套用到完整的 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-_]+))?

必要:是

Name

別名的名稱。

長度限制:長度下限為 1。長度上限為 128。

模式:(?!^[0-9]+$)([a-zA-Z0-9-_]+)

必要:是

請求主體

請求接受採用 JSON 格式的下列資料。

Description

別名的描述。

類型:字串

長度限制:長度下限為 0。長度上限為 256。

必要:否

FunctionVersion

別名呼叫的函數版本。

類型:字串

長度限制:長度下限為 1。長度上限為 1024。

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

必要:否

RevisionId

只有在修訂版本 ID 符合指定的 ID 時才更新別名。使用此選項來避免修改自您最近一次讀取之後產生變更的別名。

類型:字串

必要:否

RoutingConfig

別名的路由組態

類型:AliasRoutingConfiguration 物件

必要:否

回應語法

HTTP/1.1 200 Content-type: application/json { "AliasArn": "string", "Description": "string", "FunctionVersion": "string", "Name": "string", "RevisionId": "string", "RoutingConfig": { "AdditionalVersionWeights": { "string" : number } } }

回應元素

如果動作成功,則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

AliasArn

別名的 Amazon Resource Name (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-_]+))?

Description

別名的描述。

類型:字串

長度限制:長度下限為 0。長度上限為 256。

FunctionVersion

別名呼叫的函數版本。

類型:字串

長度限制:長度下限為 1。長度上限為 1024。

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

Name

別名的名稱。

類型:字串

長度限制:長度下限為 1。長度上限為 128。

模式:(?!^[0-9]+$)([a-zA-Z0-9-_]+)

RevisionId

當您更新別名時,會變更的唯一識別符。

類型:字串

RoutingConfig

別名的路由組態

類型:AliasRoutingConfiguration 物件

錯誤

如需所有動作常見錯誤的資訊,請參閱常見錯誤

InvalidParameterValueException

請求中的其中一個參數無效。

HTTP 狀態碼:400

PreconditionFailedException

RevisionId 提供的與 Lambda 函數或別名 RevisionId 的最新版本不相符。呼叫GetFunctionGetAlias API 作業以擷取資源 RevisionId 的最新資源。

HTTP 狀態碼:412

ResourceConflictException

資源已存在,或另一個操作正在進行中。

HTTP 狀態碼:409

ResourceNotFoundException

請求中指定的資源不存在。

HTTP 狀態碼:404

ServiceException

AWS Lambda 服務發生內部錯誤。

HTTP 狀態碼:500

TooManyRequestsException

超出請求輸送量限制。如需詳細資訊,請參閱 Lambda 配額

HTTP 狀態碼:429

另請參閱

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊,請參閱下列說明: