CreateAlias - AWS Lambda

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

别名的路由配置

类型:AliasRoutingConfiguration 对象

错误

InvalidParameterValueException

请求中的参数之一无效。

HTTP 状态代码:400

ResourceConflictException

资源已存在,或者其他操作正在进行中。

HTTP 状态代码:409

ResourceNotFoundException

请求中指定的资源不存在。

HTTP 状态代码:404

ServiceException

AWS Lambda 服务遇到了内部错误。

HTTP 状态代码:500

TooManyRequestsException

超出了请求吞吐量限制。

HTTP 状态代码:429

另请参阅

有关在特定语言的AWS软件开发工具包中使用此 API 的更多信息,请参阅以下内容: