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

http://lambda.{region}.amazonaws.com/2015-03-31/functions/{FunctionName}/aliases

Creates an <a href="https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html">alias</a> 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 <code>RoutingConfig</code> parameter to specify a second version and the percentage of invocation requests that it receives.

Access Token Required: API Key

Path Parameters

FunctionNamestringrequired

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

Body Params

Namestringrequired

The name of the alias.

Descriptionstring

A description of the alias.

RoutingConfigobject

The <a href="https://docs.aws.amazon.com/lambda/latest/dg/lambda-traffic-shifting-using-aliases.html">traffic-shifting</a> configuration of a Lambda function alias.

FunctionVersionstringrequired

The function version that the alias invokes.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request POST \
2     --url 'http://lambda.{region}.amazonaws.com/2015-03-31/functions/{FunctionName}/aliases' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}

POST