LambdaCore / Client / create_runtime_version

create_runtime_version

LambdaCore.Client.create_runtime_version(**kwargs)

Creates a new runtime version. A runtime version defines the function execution environment by referencing a container image. Runtime versions are immutable. To update the runtime, create a new runtime version and migrate functions by updating the runtime aliases to point to the new runtime version.

See also: AWS API Documentation

Request Syntax

response = client.create_runtime_version(
    RuntimeName='string',
    ImageUri='string',
    Name='string',
    ReleaseNotes='string',
    DryRun=True|False
)
Parameters:

  • RuntimeName (string) –

    [REQUIRED]

    The name or ARN of the runtime to create a version for.

  • ImageUri (string) –

    [REQUIRED]

    The URI of the container image used to define the function execution environment for this runtime version.

  • Name (string) –

    [REQUIRED]

    The name to assign to the new runtime version.

  • ReleaseNotes (string) – The release notes to associate with the runtime version.

  • DryRun (boolean) – When set to true, the request is validated without creating a new runtime version. Use this to check that the request would succeed. No runtime version is created and no changes are made.

Return type:

dict

Returns:

Response Syntax

{
    'Name': 'string',
    'Arn': 'string',
    'ResolvedUri': 'string',
    'State': 'CREATING'|'ACTIVE'|'FAILED'|'DELETING'|'PENDING_DELETION',
    'ReleaseNotes': 'string',
    'Platforms': [
        {
            'Architecture': 'string',
            'Os': 'string',
            'Digest': 'string'
        },
    ],
    'Compatibility': {
        'IntegrationModels': [
            'RuntimeAPI',
        ],
        'Architectures': [
            'x86_64'|'arm64',
        ],
        'ManagedInstances': 'Supported'|'NotSupported'
    },
    'Created': 'string',
    'LastModified': 'string'
}

Response Structure

  • (dict) –

    • Name (string) –

      The name of the runtime version.

    • Arn (string) –

      The Amazon Resource Name (ARN) of the runtime version.

    • ResolvedUri (string) –

      The resolved image URI of the runtime version.

    • State (string) –

      The current state of the runtime version.

    • ReleaseNotes (string) –

      The release notes associated with the runtime version.

    • Platforms (list) –

      The platforms (architecture and OS combinations) available for the runtime version.

      • (dict) –

        A platform available for the runtime version.

        • Architecture (string) –

          The CPU architecture of the platform, for example x86_64 or arm64.

        • Os (string) –

          The operating system of the platform.

        • Digest (string) –

          The content digest of the platform-specific image.

    • Compatibility (dict) –

      The compatibility matrix of the runtime version.

      • IntegrationModels (list) –

        Supported integration models for the runtime version.

        • (string) –

          A supported integration model.

      • Architectures (list) –

        Supported architectures for the runtime version.

        • (string) –

          A supported CPU architecture.

      • ManagedInstances (string) –

        Whether the runtime version is compatible with managed instances.

    • Created (string) –

      The date and time when the runtime version was created.

    • LastModified (string) –

      The date and time when the runtime version was last modified.

Exceptions