POST

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

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

Creates a <a href="https://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html">version</a> from the current code and configuration of a function. Use versions to create a snapshot of your function code and configuration that doesn't change. Lambda doesn't publish a version if the function's configuration and code haven't changed since the last version. Use <a>UpdateFunctionCode</a> or <a>UpdateFunctionConfiguration</a> to update the function before publishing a version. Clients can invoke versions directly or with an alias. To create an alias, use <a>CreateAlias</a>.

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

CodeSha256string

Only publish a version if the hash value matches the value that's specified. Use this option to avoid publishing a version if the function code has changed since you last updated it. You can get the hash for the version that you uploaded from the output of <a>UpdateFunctionCode</a>.

RevisionIdstring

Only update the function if the revision ID matches the ID that's specified. Use this option to avoid publishing a version if the function configuration has changed since you last updated it.

Descriptionstring

A description for the version to override the description in the function configuration.

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}/versions' \
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}