v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1466347371.7 KB

Creates an alias for a Lambda function version. Use aliases to provide clients with a function identifier that you can update to invoke a different version.

You can also map an alias to split invocation requests between two versions. Use the RoutingConfig parameter to specify a second version and the percentage of invocation requests that it receives.

post/2015-03-31/functions/{FunctionName}/aliases

Path parameters

FunctionNamestring required
<p>The name of the Lambda function.</p> <p class="title"> <b>Name formats</b> </p> <ul> <li> <p> <b>Function name</b> - <code>MyFunction</code>.</p> </li> <li> <p> <b>Function ARN</b> - <code>arn:aws:lambda:us-west-2:123456789012:function:MyFunction</code>.</p> </li> <li> <p> <b>Partial ARN</b> - <code>123456789012:function:MyFunction</code>.</p> </li> </ul> <p>The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.</p>

Request body

Namestring required

The name of the alias.

FunctionVersionstring required

The function version that the alias invokes.

Descriptionstring

A description of the alias.

Response

Success

AliasArnstring

The Amazon Resource Name (ARN) of the alias.

Namestring

The name of the alias.

FunctionVersionstring

The function version that the alias invokes.

Descriptionstring

A description of the alias.

RevisionIdstring

A unique identifier that changes when you update the alias.