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)。
类型:字符串
模式:
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
-
别名的路由配置。
错误
有关所有操作返回的常见错误的信息,请参阅 常见错误。
- InvalidParameterValueException
-
请求中的参数之一无效。
HTTP 状态代码:400
- PreconditionFailedException
-
提供的 RevisionId 与 Lambda 函数或别名的最新 RevisionId 不匹配。调用
GetFunction
或GetAlias
API 操作来检索您的资源的最新 RevisionId。HTTP 状态代码:412
- ResourceConflictException
-
资源已存在,或者其他操作正在进行中。
HTTP 状态代码:409
- ResourceNotFoundException
-
请求中指定的资源不存在。
HTTP 状态代码:404
- ServiceException
-
Amazon Lambda 服务遇到了内部错误。
HTTP 状态代码:500
- TooManyRequestsException
-
超出了请求吞吐量限制。有关更多信息,请参阅 Lambda 限额。
HTTP 状态代码:429
另请参阅
有关在特定语言的 Amazon SDK 中使用此 API 的更多信息,请参阅以下内容: