Lambda / Client / publish_layer_version

publish_layer_version#

Lambda.Client.publish_layer_version(**kwargs)#

Creates an Lambda layer from a ZIP archive. Each time you call PublishLayerVersion with the same layer name, a new version is created.

Add layers to your function with CreateFunction or UpdateFunctionConfiguration.

Request Syntax

response = client.publish_layer_version(
    LayerName='string',
    Description='string',
    Content={
        'S3Bucket': 'string',
        'S3Key': 'string',
        'S3ObjectVersion': 'string',
        'ZipFile': b'bytes'
    },
    CompatibleRuntimes=[
        'nodejs'|'nodejs4.3'|'nodejs6.10'|'nodejs8.10'|'nodejs10.x'|'nodejs12.x'|'nodejs14.x'|'nodejs16.x'|'java8'|'java8.al2'|'java11'|'python2.7'|'python3.6'|'python3.7'|'python3.8'|'python3.9'|'dotnetcore1.0'|'dotnetcore2.0'|'dotnetcore2.1'|'dotnetcore3.1'|'dotnet6'|'dotnet8'|'nodejs4.3-edge'|'go1.x'|'ruby2.5'|'ruby2.7'|'provided'|'provided.al2'|'nodejs18.x'|'python3.10'|'java17'|'ruby3.2'|'ruby3.3'|'python3.11'|'nodejs20.x'|'provided.al2023'|'python3.12'|'java21'|'python3.13'|'nodejs22.x',
    ],
    LicenseInfo='string',
    CompatibleArchitectures=[
        'x86_64'|'arm64',
    ]
)

Parameters:

LayerName (string) –
[REQUIRED]

The name or Amazon Resource Name (ARN) of the layer.
Description (string) – The description of the version.
Content (dict) –
[REQUIRED]

The function layer archive.
- S3Bucket (string) –
  
  The Amazon S3 bucket of the layer archive.
- S3Key (string) –
  
  The Amazon S3 key of the layer archive.
- S3ObjectVersion (string) –
  
  For versioned objects, the version of the layer archive object to use.
- ZipFile (bytes) –
  
  The base64-encoded contents of the layer archive. Amazon Web Services SDK and Amazon Web Services CLI clients handle the encoding for you.
CompatibleRuntimes (list) –
A list of compatible function runtimes. Used for filtering with ListLayers and ListLayerVersions.

The following list includes deprecated runtimes. For more information, see Runtime deprecation policy.
- (string) –
LicenseInfo (string) –
The layer’s software license. It can be any of the following:
- An SPDX license identifier. For example, MIT.
- The URL of a license hosted on the internet. For example, https://opensource.org/licenses/MIT.
- The full text of the license.
CompatibleArchitectures (list) –
A list of compatible instruction set architectures.
- (string) –

Return type:

dict

Returns:

Response Syntax

{
    'Content': {
        'Location': 'string',
        'CodeSha256': 'string',
        'CodeSize': 123,
        'SigningProfileVersionArn': 'string',
        'SigningJobArn': 'string'
    },
    'LayerArn': 'string',
    'LayerVersionArn': 'string',
    'Description': 'string',
    'CreatedDate': 'string',
    'Version': 123,
    'CompatibleRuntimes': [
        'nodejs'|'nodejs4.3'|'nodejs6.10'|'nodejs8.10'|'nodejs10.x'|'nodejs12.x'|'nodejs14.x'|'nodejs16.x'|'java8'|'java8.al2'|'java11'|'python2.7'|'python3.6'|'python3.7'|'python3.8'|'python3.9'|'dotnetcore1.0'|'dotnetcore2.0'|'dotnetcore2.1'|'dotnetcore3.1'|'dotnet6'|'dotnet8'|'nodejs4.3-edge'|'go1.x'|'ruby2.5'|'ruby2.7'|'provided'|'provided.al2'|'nodejs18.x'|'python3.10'|'java17'|'ruby3.2'|'ruby3.3'|'python3.11'|'nodejs20.x'|'provided.al2023'|'python3.12'|'java21'|'python3.13'|'nodejs22.x',
    ],
    'LicenseInfo': 'string',
    'CompatibleArchitectures': [
        'x86_64'|'arm64',
    ]
}

Response Structure

(dict) –
- Content (dict) –
  
  Details about the layer version.
  - Location (string) –
    
    A link to the layer archive in Amazon S3 that is valid for 10 minutes.
  - CodeSha256 (string) –
    
    The SHA-256 hash of the layer archive.
  - CodeSize (integer) –
    
    The size of the layer archive in bytes.
  - SigningProfileVersionArn (string) –
    
    The Amazon Resource Name (ARN) for a signing profile version.
  - SigningJobArn (string) –
    
    The Amazon Resource Name (ARN) of a signing job.
- LayerArn (string) –
  
  The ARN of the layer.
- LayerVersionArn (string) –
  
  The ARN of the layer version.
- Description (string) –
  
  The description of the version.
- CreatedDate (string) –
  
  The date that the layer version was created, in ISO-8601 format (YYYY-MM-DDThh:mm:ss.sTZD).
- Version (integer) –
  
  The version number.
- CompatibleRuntimes (list) –
  
  The layer’s compatible runtimes.
  
  The following list includes deprecated runtimes. For more information, see Runtime use after deprecation.
  
  For a list of all currently supported runtimes, see Supported runtimes.
  - (string) –
- LicenseInfo (string) –
  
  The layer’s software license.
- CompatibleArchitectures (list) –
  
  A list of compatible instruction set architectures.
  - (string) –

Exceptions

Examples

The following example creates a new Python library layer version. The command retrieves the layer content a file named layer.zip in the specified S3 bucket.

response = client.publish_layer_version(
    CompatibleRuntimes=[
        'python3.6',
        'python3.7',
    ],
    Content={
        'S3Bucket': 'lambda-layers-us-west-2-123456789012',
        'S3Key': 'layer.zip',
    },
    Description='My Python layer',
    LayerName='my-layer',
    LicenseInfo='MIT',
)

print(response)

Expected Output:

{
    'CompatibleRuntimes': [
        'python3.6',
        'python3.7',
    ],
    'Content': {
        'CodeSha256': 'tv9jJO+rPbXUUXuRKi7CwHzKtLDkDRJLB3cC3Z/ouXo=',
        'CodeSize': 169,
        'Location': 'https://awslambda-us-west-2-layers.s3.us-west-2.amazonaws.com/snapshots/123456789012/my-layer-4aaa2fbb-ff77-4b0a-ad92-5b78a716a96a?versionId=27iWyA73cCAYqyH...',
    },
    'CreatedDate': '2018-11-14T23:03:52.894+0000',
    'Description': 'My Python layer',
    'LayerArn': 'arn:aws:lambda:us-west-2:123456789012:layer:my-layer',
    'LayerVersionArn': 'arn:aws:lambda:us-west-2:123456789012:layer:my-layer:1',
    'LicenseInfo': 'MIT',
    'Version': 1,
    'ResponseMetadata': {
        '...': '...',
    },
}