CreateAlias
为 Lambda 函数版本创建一个别名。别名用来为客户端提供函数标识符，您可以更新该标识符以调用其他版本。
您还可以映射别名以在两个版本之间拆分调用请求。使用 RoutingConfig 参数可指定另一个版本以及该版本收到的调用请求的百分比。
请求语法
POST /2015-03-31/functions/FunctionName/aliases HTTP/1.1
Content-type: application/json
{
"Description": "string",
"FunctionVersion": "string",
"Name": "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-_]+))?必需：是
-
请求体
请求接受采用 JSON 格式的以下数据。
- Description
-
别名的描述。
类型：字符串
长度约束：最小长度为 0。长度上限为 256。
必需：否
- FunctionVersion
-
别名调用的函数版本。
类型：字符串
长度限制：最小长度为 1。长度上限为 1024。
模式：
(\$LATEST|[0-9]+)必需：是
- Name
-
别名的名称。
类型：字符串
长度限制：长度下限为 1。长度上限为 128。
模式：
(?!^[0-9]+$)([a-zA-Z0-9-_]+)必需：是
- RoutingConfig
-
别名的路由配置。
类型：AliasRoutingConfiguration 对象
必需：否
响应语法
HTTP/1.1 201
Content-type: application/json
{
"AliasArn": "string",
"Description": "string",
"FunctionVersion": "string",
"Name": "string",
"RevisionId": "string",
"RoutingConfig": {
"AdditionalVersionWeights": {
"string" : number
}
}
}响应元素
如果此操作成功，则该服务将会发送回 HTTP 201 响应。
服务以 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
- ResourceConflictException
-
资源已存在，或者其他操作正在进行中。
HTTP 状态代码：409
- ResourceNotFoundException
-
请求中指定的资源不存在。
HTTP 状态代码：404
- ServiceException
-
Amazon Lambda 服务遇到了内部错误。
HTTP 状态代码：500
- TooManyRequestsException
-
超出了请求吞吐量限制。有关更多信息，请参阅 Lambda 限额。
HTTP 状态代码：429
另请参阅
有关在特定语言的 Amazon SDK 中使用此 API 的更多信息，请参阅以下内容：