---
title: "POST /2015-03-31/functions/{FunctionName}/aliases"
method: POST
path: "/2015-03-31/functions/{FunctionName}/aliases"
---

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

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

Creates an [alias](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html) 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.

## Path parameters

- `FunctionName` string, required

## Request body

- object
  - `Name` string, required — The name of the alias.
  - `FunctionVersion` string, required — The function version that the alias invokes.
  - `Description` string — A description of the alias.
  - `RoutingConfig` object — 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.
    - `AdditionalVersionWeights` object — The second version, and the percentage of traffic that's routed to it.

## Response `201`

Success

- AliasConfiguration — Provides configuration information about a Lambda function <a href="https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html">alias</a>.
  - `AliasArn` string — The Amazon Resource Name (ARN) of the alias.
  - `Name` string — The name of the alias.
  - `FunctionVersion` string — The function version that the alias invokes.
  - `Description` string — A description of the alias.
  - `RoutingConfig` object — The <a href="https://docs.aws.amazon.com/lambda/latest/dg/lambda-traffic-shifting-using-aliases.html">routing configuration</a> of the alias.
    - `AdditionalVersionWeights` object — The second version, and the percentage of traffic that's routed to it.
  - `RevisionId` string — A unique identifier that changes when you update the alias.

## Other responses

- `480` — ServiceException
- `481` — ResourceNotFoundException
- `482` — ResourceConflictException
- `483` — InvalidParameterValueException
- `484` — TooManyRequestsException

---

[API](https://skmtc.net/aws/apis/lambda.md) · [All operations](https://skmtc.net/aws/apis/lambda/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/lambda/versions/2d9fde023ce9/schema)