AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

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.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to CreateAliasAsync.

Namespace: Amazon.Lambda
Assembly: AWSSDK.Lambda.dll
Version: 3.x.y.z

Syntax

C#
public abstract CreateAliasResponse CreateAlias(
         CreateAliasRequest request
)

Parameters

request
Type: Amazon.Lambda.Model.CreateAliasRequest

Container for the necessary parameters to execute the CreateAlias service method.

Return Value


The response from the CreateAlias service method, as returned by Lambda.

Exceptions

ExceptionCondition
InvalidParameterValueException One of the parameters in the request is not valid.
ResourceConflictException The resource already exists, or another operation is in progress.
ResourceNotFoundException The resource specified in the request does not exist.
ServiceException The Lambda service encountered an internal error.
TooManyRequestsException The request throughput limit was exceeded. For more information, see Lambda quotas.

Examples

The following example creates an alias named LIVE that points to version 1 of the my-function Lambda function.

To create an alias for a Lambda function


var response = client.CreateAlias(new CreateAliasRequest 
{
    Description = "alias for live version of function",
    FunctionName = "my-function",
    FunctionVersion = "1",
    Name = "LIVE"
});

string aliasArn = response.AliasArn;
string description = response.Description;
string functionVersion = response.FunctionVersion;
string name = response.Name;
string revisionId = response.RevisionId;

            

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

See Also