SDK for PHP V3

Client: Aws\LambdaCore\LambdaCoreClient
Service ID: lambda-core
Version: 2026-04-30

This page describes the parameters and results for the operations of the AWS Lambda Core (2026-04-30), and shows how to use the Aws\LambdaCore\LambdaCoreClient object to call the described operations. This documentation is specific to the 2026-04-30 API version of the service.

Operation Summary

Each of the following operations can be created from a client using $client->getCommand('CommandName'), where "CommandName" is the name of one of the following operations. Note: a command is a value that encapsulates an operation and the parameters used to create an HTTP request.

You can also create and send a command immediately using the magic methods available on a client object: $client->commandName(/* parameters */). You can send the command asynchronously (returning a promise) by appending the word "Async" to the operation name: $client->commandNameAsync(/* parameters */).

CreateNetworkConnector ( array $params = [] )
Creates a network connector that enables Lambda compute resources to route outbound traffic through your Amazon VPC.
CreateRuntime ( array $params = [] )
Creates a customer-managed runtime, a resource providing a centrally managed execution environment for your Lambda functions.
CreateRuntimeAlias ( array $params = [] )
Creates a new customer-managed runtime alias.
CreateRuntimeVersion ( array $params = [] )
Creates a new runtime version.
DeleteNetworkConnector ( array $params = [] )
Initiates deletion of a network connector.
DeleteRuntime ( array $params = [] )
Schedules a customer-managed runtime to be deleted.
DeleteRuntimeAlias ( array $params = [] )
Schedules a runtime alias to be deleted.
DeleteRuntimeVersion ( array $params = [] )
Schedules a runtime version to be deleted.
GetNetworkConnector ( array $params = [] )
Retrieves the current configuration, state, and metadata of a network connector.
GetRuntime ( array $params = [] )
Retrieves the configuration and metadata of a runtime.
GetRuntimeAlias ( array $params = [] )
Retrieves the configuration, state, and metadata of a runtime alias.
GetRuntimeVersion ( array $params = [] )
Retrieves the configuration, state, and metadata of a runtime version.
ListNetworkConnectorVersions ( array $params = [] )
Returns a paginated list of the versions of a network connector.
ListNetworkConnectors ( array $params = [] )
Returns a paginated list of network connectors in your account for the current Region.
ListRuntimeAliases ( array $params = [] )
Returns a paginated list of aliases for the specified runtime.
ListRuntimeVersions ( array $params = [] )
Returns a paginated list of versions for the specified runtime.
ListRuntimes ( array $params = [] )
Returns a paginated list of runtimes in your account for the current Region.
RestoreRuntime ( array $params = [] )
Cancels a pending scheduled deletion, returning the resource to the ACTIVE state.
UpdateNetworkConnector ( array $params = [] )
Updates the VPC configuration or operator role of an existing network connector.
UpdateRuntime ( array $params = [] )
Updates the properties of an existing customer-managed runtime, such as its description, license information, or lifecycle information.
UpdateRuntimeAlias ( array $params = [] )
Updates an existing runtime alias to point to a different runtime version or to change its description or lifecycle information.
UpdateRuntimeVersion ( array $params = [] )
Updates the runtime version release notes.

Paginators

Paginators handle automatically iterating over paginated API results. Paginators are associated with specific API operations, and they accept the parameters that the corresponding API operation accepts. You can get a paginator from a client class using getPaginator($paginatorName, $operationParameters). This client supports the following paginators:

ListNetworkConnectorVersions
ListNetworkConnectors
ListRuntimeAliases
ListRuntimeVersions
ListRuntimes

Waiters

Waiters allow you to poll a resource until it enters into a desired state. A waiter has a name used to describe what it does, and is associated with an API operation. When creating a waiter, you can provide the API operation parameters associated with the corresponding operation. Waiters can be accessed using the getWaiter($waiterName, $operationParameters) method of a client object. This client supports the following waiters:

Waiter name API Operation Delay Max Attempts
RuntimeAliasActive GetRuntimeAlias 2 60
RuntimeVersionActive GetRuntimeVersion 2 60

Operations

CreateNetworkConnector

$result = $client->createNetworkConnector([/* ... */]);
$promise = $client->createNetworkConnectorAsync([/* ... */]);

Creates a network connector that enables Lambda compute resources to route outbound traffic through your Amazon VPC. The network connector provisions elastic network interfaces (ENIs) in the subnets you specify, providing a managed network path to private resources such as databases, caches, and internal APIs.

This operation is asynchronous. The network connector starts in PENDING state while ENIs are provisioned in your VPC (provisioning typically takes up to 10 minutes). Use GetNetworkConnector to poll the connector state until it reaches ACTIVE. Once active, you can attach the connector to supported Lambda compute resources — such as MicroVMs and WebFunctions — at run time. For how to attach a connector, see the documentation for the specific compute type.

This operation is idempotent when you provide a ClientToken — if you retry a request that completed successfully using the same client token, the operation returns the existing connector without creating a duplicate.

Parameter Syntax

$result = $client->createNetworkConnector([
    'ClientToken' => '<string>',
    'Configuration' => [ // REQUIRED
        'VpcEgressConfiguration' => [
            'AssociatedComputeResourceTypes' => ['<string>', ...],
            'ElasticIpConfiguration' => [
                'Type' => 'None|ServiceManaged', // REQUIRED
            ],
            'NetworkProtocol' => 'IPv4|DualStack',
            'SecurityGroupIds' => ['<string>', ...],
            'SubnetIds' => ['<string>', ...],
        ],
    ],
    'Name' => '<string>', // REQUIRED
    'OperatorRole' => '<string>',
    'Tags' => ['<string>', ...],
]);

Parameter Details

Members
ClientToken
Type: string

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If you retry a request with the same client token, the API returns the existing connector without creating a duplicate.

Configuration
Required: Yes
Type: NetworkConnectorConfiguration structure

The network configuration for the connector. Specify a VpcEgressConfiguration to enable outbound traffic routing through your VPC.

Name
Required: Yes
Type: string

A unique name for the network connector within your account and Region. You can use the name to identify the connector in subsequent API calls.

OperatorRole
Type: string

The ARN of the IAM role that Lambda assumes to manage elastic network interfaces in your VPC. This role must have permissions for ec2:CreateNetworkInterface, ec2:DeleteNetworkInterface, and related describe operations.

Tags
Type: Associative array of custom strings keys (NetworkConnectorTagKey) to strings

A map of key-value pairs to associate with the network connector for organization, cost allocation, or access control.

Result Syntax

[
    'Arn' => '<string>',
    'Configuration' => [
        'VpcEgressConfiguration' => [
            'AssociatedComputeResourceTypes' => ['<string>', ...],
            'ElasticIpConfiguration' => [
                'Type' => 'None|ServiceManaged',
            ],
            'NetworkProtocol' => 'IPv4|DualStack',
            'SecurityGroupIds' => ['<string>', ...],
            'SubnetIds' => ['<string>', ...],
        ],
    ],
    'Id' => '<string>',
    'Name' => '<string>',
    'OperatorRole' => '<string>',
    'State' => 'PENDING|ACTIVE|INACTIVE|FAILED|DELETING|DELETE_FAILED',
    'Version' => <integer>,
    'VersionArn' => '<string>',
]

Result Details

Members
Arn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the network connector.

Configuration

The network configuration of the connector, including VPC subnets and security groups.

Id
Required: Yes
Type: string

The unique identifier of the network connector.

Name
Required: Yes
Type: string

The name of the network connector.

OperatorRole
Type: string

The ARN of the IAM role that Lambda uses to manage the underlying ENI resources for this connector.

State
Type: string

The current state of the network connector.

Version
Type: long (int|float)

The version number assigned to the connector. A newly created connector starts at version 1.

VersionArn
Type: string

The qualified ARN of the connector version created by this request, including the immutable version suffix.

Errors

InvalidParameterValueException:

One of the parameters in the request is not valid. Check the error message for details about which parameter failed validation.

ResourceConflictException:

The request could not be completed due to a conflict with the current state of the resource. For example, attempting to modify a resource that is not in a state that permits the operation.

NetworkConnectorLimitExceededException:

The request would exceed a network connector limit. For CreateNetworkConnector, the account has reached the maximum number of network connectors allowed. For UpdateNetworkConnector, the connector has reached the maximum number of versions allowed.

ServiceException:

An internal service error occurred. Retry the request with exponential backoff.

TooManyRequestsException:

The request was throttled due to exceeding the allowed request rate. Retry the request after a brief wait using exponential backoff.

CreateRuntime

$result = $client->createRuntime([/* ... */]);
$promise = $client->createRuntimeAsync([/* ... */]);

Creates a customer-managed runtime, a resource providing a centrally managed execution environment for your Lambda functions. The runtime resource is the parent of the runtime version and runtime alias child resources.

Parameter Syntax

$result = $client->createRuntime([
    'Description' => '<string>',
    'LicenseInfo' => '<string>',
    'Name' => '<string>', // REQUIRED
    'ReleaseLifecycle' => [
        'DeprecationDate' => '<string>',
        'FunctionCreateBlockDate' => '<string>',
        'FunctionUpdateBlockDate' => '<string>',
        'ReleaseState' => 'PREVIEW|GA|DEPRECATED',
    ],
    'Tags' => ['<string>', ...],
]);

Parameter Details

Members
Description
Type: string

A description of the runtime.

LicenseInfo
Type: string

The license information for the runtime.

Name
Required: Yes
Type: string

The name of the runtime to create.

ReleaseLifecycle
Type: RuntimeReleaseLifecycle structure

The runtime lifecycle for the runtime (optional). Use this to schedule runtime deprecation.

Tags
Type: Associative array of custom strings keys (String) to strings

A map of tag keys and values to associate with the runtime.

Result Syntax

[
    'Arn' => '<string>',
    'Created' => '<string>',
    'Description' => '<string>',
    'LastModified' => '<string>',
    'LicenseInfo' => '<string>',
    'Name' => '<string>',
    'ReleaseLifecycle' => [
        'DeprecationDate' => '<string>',
        'FunctionCreateBlockDate' => '<string>',
        'FunctionUpdateBlockDate' => '<string>',
        'ReleaseState' => 'PREVIEW|GA|DEPRECATED',
    ],
]

Result Details

Members
Arn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the runtime.

Created
Required: Yes
Type: string

The date and time when the runtime was created.

Description
Type: string

The description of the runtime.

LastModified
Required: Yes
Type: string

The date and time when the runtime was last modified.

LicenseInfo
Type: string

The license information for the runtime.

Name
Required: Yes
Type: string

The name of the runtime.

ReleaseLifecycle
Type: RuntimeReleaseLifecycle structure

The runtime lifecycle for the runtime. Used to schedule runtime deprecation.

Errors

InvalidParameterValueException:

One of the parameters in the request is not valid. Check the error message for details about which parameter failed validation.

ServiceQuotaExceededException:

The request would exceed a service quota for your account. Request a quota increase or reduce the number of resources in use, then retry the request.

ResourceConflictException:

The request could not be completed due to a conflict with the current state of the resource. For example, attempting to modify a resource that is not in a state that permits the operation.

TooManyRequestsException:

The request was throttled due to exceeding the allowed request rate. Retry the request after a brief wait using exponential backoff.

ServiceException:

An internal service error occurred. Retry the request with exponential backoff.

Examples

Example 1: Create a runtime

Creates a customer-managed runtime resource.

$result = $client->createRuntime([
    'Description' => 'PHP 8 custom runtime',
    'LicenseInfo' => 'MIT',
    'Name' => 'php8',
    'Tags' => [
        'team' => 'runtimes',
    ],
]);

Result syntax:

[
    'Arn' => 'arn:aws:lambda:us-west-2:123456789012:runtime/php8',
    'Created' => '2026-10-01T12:00:00.000Z',
    'Description' => 'PHP 8 custom runtime',
    'LastModified' => '2026-10-01T12:00:00.000Z',
    'LicenseInfo' => 'MIT',
    'Name' => 'php8',
]

CreateRuntimeAlias

$result = $client->createRuntimeAlias([/* ... */]);
$promise = $client->createRuntimeAliasAsync([/* ... */]);

Creates a new customer-managed runtime alias. The alias is a named pointer to a runtime version. Functions consume the customer-managed runtime through the runtime alias.

Parameter Syntax

$result = $client->createRuntimeAlias([
    'Description' => '<string>',
    'Name' => '<string>', // REQUIRED
    'ReleaseLifecycle' => [
        'DeprecationDate' => '<string>',
        'FunctionCreateBlockDate' => '<string>',
        'FunctionUpdateBlockDate' => '<string>',
        'ReleaseState' => 'PREVIEW|GA|DEPRECATED',
    ],
    'RuntimeName' => '<string>', // REQUIRED
    'RuntimeVersion' => '<string>', // REQUIRED
]);

Parameter Details

Members
Description
Type: string

A description of the runtime alias.

Name
Required: Yes
Type: string

The name to assign to the new runtime alias.

ReleaseLifecycle
Type: RuntimeReleaseLifecycle structure

The runtime lifecycle for the alias. By default, this is inherited from the runtime lifecycle. Optionally, you can override the lifecycle information at the alias level, if required.

RuntimeName
Required: Yes
Type: string

The name or ARN of the runtime to create an alias for.

RuntimeVersion
Required: Yes
Type: string

The name of the runtime version the alias points to.

Result Syntax

[
    'Arn' => '<string>',
    'Created' => '<string>',
    'Description' => '<string>',
    'LastModified' => '<string>',
    'Name' => '<string>',
    'ReleaseLifecycle' => [
        'DeprecationDate' => '<string>',
        'FunctionCreateBlockDate' => '<string>',
        'FunctionUpdateBlockDate' => '<string>',
        'ReleaseState' => 'PREVIEW|GA|DEPRECATED',
    ],
    'RuntimeVersion' => '<string>',
    'RuntimeVersionArn' => '<string>',
    'State' => 'CREATING|ACTIVE|UPDATING|DELETING|PENDING_DELETION',
]

Result Details

Members
Arn
Required: Yes
Type: string

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

Created
Required: Yes
Type: string

The date and time when the runtime alias was created.

Description
Type: string

A description of the runtime alias.

LastModified
Required: Yes
Type: string

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

Name
Required: Yes
Type: string

The name of the runtime alias.

ReleaseLifecycle
Type: RuntimeReleaseLifecycle structure

The runtime lifecycle for the alias. By default, this is inherited from the runtime lifecycle. Optionally, you can override the lifecycle information at the alias level, if required.

RuntimeVersion
Required: Yes
Type: string

The name of the runtime version the alias points to.

RuntimeVersionArn
Required: Yes
Type: string

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

State
Required: Yes
Type: string

The current state of the runtime alias.

Errors

InvalidParameterValueException:

One of the parameters in the request is not valid. Check the error message for details about which parameter failed validation.

ServiceQuotaExceededException:

The request would exceed a service quota for your account. Request a quota increase or reduce the number of resources in use, then retry the request.

ResourceConflictException:

The request could not be completed due to a conflict with the current state of the resource. For example, attempting to modify a resource that is not in a state that permits the operation.

TooManyRequestsException:

The request was throttled due to exceeding the allowed request rate. Retry the request after a brief wait using exponential backoff.

ServiceException:

An internal service error occurred. Retry the request with exponential backoff.

ResourceNotFoundException:

The specified resource does not exist. Verify the identifier and Region.

Examples

Example 1: Create a runtime alias

Creates an alias that points at a published runtime version.

$result = $client->createRuntimeAlias([
    'Description' => 'Points at the newest published version',
    'Name' => 'latest',
    'RuntimeName' => 'php8',
    'RuntimeVersion' => 'v1',
]);

Result syntax:

[
    'Arn' => 'arn:aws:lambda:us-west-2:123456789012:runtime/php8/alias/latest',
    'Created' => '2026-10-01T12:00:00.000Z',
    'Description' => 'Points at the newest published version',
    'LastModified' => '2026-10-01T12:00:00.000Z',
    'Name' => 'latest',
    'RuntimeVersion' => 'v1',
    'RuntimeVersionArn' => 'arn:aws:lambda:us-west-2:123456789012:runtime/php8/version/v1',
    'State' => 'CREATING',
]

CreateRuntimeVersion

$result = $client->createRuntimeVersion([/* ... */]);
$promise = $client->createRuntimeVersionAsync([/* ... */]);

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.

Parameter Syntax

$result = $client->createRuntimeVersion([
    'DryRun' => true || false,
    'ImageUri' => '<string>', // REQUIRED
    'Name' => '<string>', // REQUIRED
    'ReleaseNotes' => '<string>',
    'RuntimeName' => '<string>', // REQUIRED
]);

Parameter Details

Members
DryRun
Type: 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.

ImageUri
Required: Yes
Type: string

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

Name
Required: Yes
Type: string

The name to assign to the new runtime version.

ReleaseNotes
Type: string

The release notes to associate with the runtime version.

RuntimeName
Required: Yes
Type: string

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

Result Syntax

[
    'Arn' => '<string>',
    'Compatibility' => [
        'Architectures' => ['<string>', ...],
        'IntegrationModels' => ['<string>', ...],
        'ManagedInstances' => 'Supported|NotSupported',
    ],
    'Created' => '<string>',
    'LastModified' => '<string>',
    'Name' => '<string>',
    'Platforms' => [
        [
            'Architecture' => '<string>',
            'Digest' => '<string>',
            'Os' => '<string>',
        ],
        // ...
    ],
    'ReleaseNotes' => '<string>',
    'ResolvedUri' => '<string>',
    'State' => 'CREATING|ACTIVE|FAILED|DELETING|PENDING_DELETION',
]

Result Details

Members
Arn
Required: Yes
Type: string

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

Compatibility
Type: Compatibility structure

The compatibility matrix of the runtime version.

Created
Required: Yes
Type: string

The date and time when the runtime version was created.

LastModified
Required: Yes
Type: string

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

Name
Required: Yes
Type: string

The name of the runtime version.

Platforms
Type: Array of Platform structures

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

ReleaseNotes
Type: string

The release notes associated with the runtime version.

ResolvedUri
Required: Yes
Type: string

The resolved image URI of the runtime version.

State
Required: Yes
Type: string

The current state of the runtime version.

Errors

InvalidParameterValueException:

One of the parameters in the request is not valid. Check the error message for details about which parameter failed validation.

ServiceQuotaExceededException:

The request would exceed a service quota for your account. Request a quota increase or reduce the number of resources in use, then retry the request.

ResourceConflictException:

The request could not be completed due to a conflict with the current state of the resource. For example, attempting to modify a resource that is not in a state that permits the operation.

TooManyRequestsException:

The request was throttled due to exceeding the allowed request rate. Retry the request after a brief wait using exponential backoff.

ServiceException:

An internal service error occurred. Retry the request with exponential backoff.

ResourceNotFoundException:

The specified resource does not exist. Verify the identifier and Region.

Examples

Example 1: Create a runtime version

Creates a new runtime version from a container image.

$result = $client->createRuntimeVersion([
    'ImageUri' => '123456789012.dkr.ecr.us-west-2.amazonaws.com/php8:latest',
    'Name' => 'v1',
    'ReleaseNotes' => 'Initial release',
    'RuntimeName' => 'php8',
]);

Result syntax:

[
    'Arn' => 'arn:aws:lambda:us-west-2:123456789012:runtime/php8/version/v1',
    'Compatibility' => [
        'Architectures' => [
            'arm64',
            'x86_64',
        ],
        'IntegrationModels' => [
            'RuntimeAPI',
        ],
        'ManagedInstances' => 'Supported',
    ],
    'Created' => '2026-10-01T12:00:00.000Z',
    'LastModified' => '2026-10-01T12:00:00.000Z',
    'Name' => 'v1',
    'Platforms' => [
        [
            'Architecture' => 'arm64',
            'Digest' => 'sha256:1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b',
            'Os' => 'linux',
        ],
    ],
    'ReleaseNotes' => 'Initial release',
    'ResolvedUri' => '123456789012.dkr.ecr.us-west-2.amazonaws.com/php8@sha256:1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b',
    'State' => 'CREATING',
]

DeleteNetworkConnector

$result = $client->deleteNetworkConnector([/* ... */]);
$promise = $client->deleteNetworkConnectorAsync([/* ... */]);

Initiates deletion of a network connector. The connector transitions to DELETING state while elastic network interfaces are cleaned up asynchronously. After deletion completes, subsequent calls to GetNetworkConnector return ResourceNotFoundException.

This operation is idempotent — calling delete on a connector that is already deleting or has been deleted succeeds without error. You can delete connectors in ACTIVE or FAILED states. Before deleting a connector, ensure that no Lambda compute resources are using it, as they will lose VPC egress connectivity immediately.

Deleting with an unqualified identifier removes the connector and all of its versions. To remove a single historical version, supply its version-qualified ARN; the connector and its remaining versions are unaffected. You can't delete the latest version on its own — delete the connector to remove it.

Parameter Syntax

$result = $client->deleteNetworkConnector([
    'Identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
Identifier
Required: Yes
Type: string

The identifier of the network connector to delete. Provide an unqualified ARN (or an ID or name) to delete the entire connector and all of its versions, or a version-qualified ARN — one that includes the immutable version suffix — to delete a specific historical version. You can't delete the latest version with a version-qualified identifier; delete the connector instead.

Result Syntax

[
    'Arn' => '<string>',
    'Configuration' => [
        'VpcEgressConfiguration' => [
            'AssociatedComputeResourceTypes' => ['<string>', ...],
            'ElasticIpConfiguration' => [
                'Type' => 'None|ServiceManaged',
            ],
            'NetworkProtocol' => 'IPv4|DualStack',
            'SecurityGroupIds' => ['<string>', ...],
            'SubnetIds' => ['<string>', ...],
        ],
    ],
    'Id' => '<string>',
    'Name' => '<string>',
    'OperatorRole' => '<string>',
    'State' => 'PENDING|ACTIVE|INACTIVE|FAILED|DELETING|DELETE_FAILED',
    'Version' => <integer>,
    'VersionArn' => '<string>',
]

Result Details

Members
Arn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the network connector.

Configuration

The network configuration of the connector, including VPC subnets and security groups.

Id
Required: Yes
Type: string

The unique identifier of the network connector.

Name
Required: Yes
Type: string

The name of the network connector.

OperatorRole
Type: string

The ARN of the IAM role that Lambda uses to manage the underlying ENI resources for this connector.

State
Type: string

The current state of the network connector. The State field is typically DELETING after this call.

Version
Type: long (int|float)

The version number of the connector version affected by this request.

VersionArn
Type: string

The qualified ARN of the connector version affected by this request, including the immutable version suffix.

Errors

InvalidParameterValueException:

One of the parameters in the request is not valid. Check the error message for details about which parameter failed validation.

ResourceConflictException:

The request could not be completed due to a conflict with the current state of the resource. For example, attempting to modify a resource that is not in a state that permits the operation.

ServiceException:

An internal service error occurred. Retry the request with exponential backoff.

TooManyRequestsException:

The request was throttled due to exceeding the allowed request rate. Retry the request after a brief wait using exponential backoff.

ResourceNotFoundException:

The specified resource does not exist. Verify the identifier and Region.

DeleteRuntime

$result = $client->deleteRuntime([/* ... */]);
$promise = $client->deleteRuntimeAsync([/* ... */]);

Schedules a customer-managed runtime to be deleted. Runtimes scheduled for deletion enter the PENDING_DELETION state and can be restored during the scheduled deletion window. Runtime versions and aliases must be deleted or scheduled for deletion before deleting the runtime. Function invokes fail for functions using runtime versions or aliases that are deleted or pending deletion.

Parameter Syntax

$result = $client->deleteRuntime([
    'RecoveryWindowInDays' => <integer>,
    'RuntimeName' => '<string>', // REQUIRED
]);

Parameter Details

Members
RecoveryWindowInDays
Type: int

Optional. The waiting period, in days (7-30), before the runtime is permanently deleted.

RuntimeName
Required: Yes
Type: string

The name or ARN of the runtime to delete.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

InvalidParameterValueException:

One of the parameters in the request is not valid. Check the error message for details about which parameter failed validation.

ResourceConflictException:

The request could not be completed due to a conflict with the current state of the resource. For example, attempting to modify a resource that is not in a state that permits the operation.

TooManyRequestsException:

The request was throttled due to exceeding the allowed request rate. Retry the request after a brief wait using exponential backoff.

ServiceException:

An internal service error occurred. Retry the request with exponential backoff.

ResourceNotFoundException:

The specified resource does not exist. Verify the identifier and Region.

Examples

Example 1: Delete a runtime

Schedules a customer-managed runtime to be deleted.

$result = $client->deleteRuntime([
    'RuntimeName' => 'php8',
]);

Result syntax:

[
]

DeleteRuntimeAlias

$result = $client->deleteRuntimeAlias([/* ... */]);
$promise = $client->deleteRuntimeAliasAsync([/* ... */]);

Schedules a runtime alias to be deleted. Runtime aliases scheduled for deletion enter the PENDING_DELETION state and can be restored during the scheduled deletion window. Function invokes fail for functions using runtime aliases that are deleted or pending deletion.

Parameter Syntax

$result = $client->deleteRuntimeAlias([
    'Name' => '<string>', // REQUIRED
    'RecoveryWindowInDays' => <integer>,
    'RuntimeName' => '<string>', // REQUIRED
]);

Parameter Details

Members
Name
Required: Yes
Type: string

The name of the runtime alias to delete.

RecoveryWindowInDays
Type: int

Optional. The waiting period, in days (7-30), before the runtime alias is permanently deleted.

RuntimeName
Required: Yes
Type: string

The name or ARN of the runtime.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

InvalidParameterValueException:

One of the parameters in the request is not valid. Check the error message for details about which parameter failed validation.

ResourceConflictException:

The request could not be completed due to a conflict with the current state of the resource. For example, attempting to modify a resource that is not in a state that permits the operation.

TooManyRequestsException:

The request was throttled due to exceeding the allowed request rate. Retry the request after a brief wait using exponential backoff.

ServiceException:

An internal service error occurred. Retry the request with exponential backoff.

ResourceNotFoundException:

The specified resource does not exist. Verify the identifier and Region.

Examples

Example 1: Delete a runtime alias

Schedules a runtime alias to be deleted.

$result = $client->deleteRuntimeAlias([
    'Name' => 'latest',
    'RuntimeName' => 'php8',
]);

Result syntax:

[
]

DeleteRuntimeVersion

$result = $client->deleteRuntimeVersion([/* ... */]);
$promise = $client->deleteRuntimeVersionAsync([/* ... */]);

Schedules a runtime version to be deleted. Runtime versions scheduled for deletion enter the PENDING_DELETION state and can be restored during the scheduled deletion window. Function invokes fail for functions using a runtime version that is deleted or pending deletion.

Parameter Syntax

$result = $client->deleteRuntimeVersion([
    'Name' => '<string>', // REQUIRED
    'RecoveryWindowInDays' => <integer>,
    'RuntimeName' => '<string>', // REQUIRED
]);

Parameter Details

Members
Name
Required: Yes
Type: string

The name of the runtime version to delete.

RecoveryWindowInDays
Type: int

Optional. The waiting period, in days (7-30), before the runtime version is permanently deleted.

RuntimeName
Required: Yes
Type: string

The name or ARN of the runtime.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

InvalidParameterValueException:

One of the parameters in the request is not valid. Check the error message for details about which parameter failed validation.

ResourceConflictException:

The request could not be completed due to a conflict with the current state of the resource. For example, attempting to modify a resource that is not in a state that permits the operation.

TooManyRequestsException:

The request was throttled due to exceeding the allowed request rate. Retry the request after a brief wait using exponential backoff.

ServiceException:

An internal service error occurred. Retry the request with exponential backoff.

ResourceNotFoundException:

The specified resource does not exist. Verify the identifier and Region.

Examples

Example 1: Delete a runtime version

Schedules a runtime version to be deleted.

$result = $client->deleteRuntimeVersion([
    'Name' => 'v1',
    'RuntimeName' => 'php8',
]);

Result syntax:

[
]

GetNetworkConnector

$result = $client->getNetworkConnector([/* ... */]);
$promise = $client->getNetworkConnectorAsync([/* ... */]);

Retrieves the current configuration, state, and metadata of a network connector. The Identifier parameter accepts the connector ID, name, or full ARN. Use this operation to poll connector state after creation or update, or to inspect the current VPC configuration and any failure reasons.

The response includes the full connector configuration, current state, and — if the connector has been updated — the LastUpdateStatus and LastUpdateStatusReasonCode fields that indicate whether the most recent update succeeded or failed.

Parameter Syntax

$result = $client->getNetworkConnector([
    'Identifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
Identifier
Required: Yes
Type: string

The identifier of the network connector to retrieve. You can specify the connector ID, name, or ARN. Provide an unqualified ARN (or an ID or name) to retrieve the connector's latest version, or a version-qualified ARN — one that includes the immutable version suffix — to retrieve a specific historical version.

Result Syntax

[
    'Arn' => '<string>',
    'Configuration' => [
        'VpcEgressConfiguration' => [
            'AssociatedComputeResourceTypes' => ['<string>', ...],
            'ElasticIpConfiguration' => [
                'Type' => 'None|ServiceManaged',
            ],
            'NetworkProtocol' => 'IPv4|DualStack',
            'SecurityGroupIds' => ['<string>', ...],
            'SubnetIds' => ['<string>', ...],
        ],
    ],
    'Id' => '<string>',
    'LastModified' => <DateTime>,
    'LastUpdateStatus' => 'Successful|Failed|InProgress',
    'LastUpdateStatusReason' => '<string>',
    'LastUpdateStatusReasonCode' => 'DisallowedByVpcEncryptionControl|Ec2RequestLimitExceeded|InsufficientRolePermissions|InternalError|InternetGatewayNotAttached|InvalidSecurityGroup|InvalidSubnet|SecurityGroupsPerInterfaceLimitExceeded|SubnetOutOfIPAddresses',
    'LatestVersion' => <integer>,
    'LatestVersionArn' => '<string>',
    'Name' => '<string>',
    'OperatorRole' => '<string>',
    'State' => 'PENDING|ACTIVE|INACTIVE|FAILED|DELETING|DELETE_FAILED',
    'StateReason' => '<string>',
    'StateReasonCode' => 'DisallowedByVpcEncryptionControl|Ec2RequestLimitExceeded|InsufficientRolePermissions|InternalError|InternetGatewayNotAttached|InvalidSecurityGroup|InvalidSubnet|SecurityGroupsPerInterfaceLimitExceeded|SubnetOutOfIPAddresses',
    'Version' => <integer>,
    'VersionArn' => '<string>',
]

Result Details

Members
Arn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the network connector.

Configuration

The network configuration of the connector, including VPC subnets and security groups.

Id
Required: Yes
Type: string

The unique identifier of the network connector.

LastModified
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the connector configuration was last modified.

LastUpdateStatus
Type: string

The status of the most recent update operation (Successful, Failed, or InProgress).

LastUpdateStatusReason
Type: string

A human-readable explanation of the last update status.

LastUpdateStatusReasonCode
Type: string

A machine-readable code indicating the reason for the last update status. Use this for programmatic error handling.

LatestVersion
Type: long (int|float)

The version number of the connector's latest active version. Each configuration update creates a new immutable version; this attribute exposes the most recent one. This field is returned only on a standard (unqualified) request.

LatestVersionArn
Type: string

The qualified ARN of the connector's latest active version, including the immutable version suffix. This field is returned only on a standard (unqualified) request; when you supply a version-qualified identifier it is not returned, and VersionArn is returned instead.

Name
Required: Yes
Type: string

The name of the network connector.

OperatorRole
Type: string

The ARN of the IAM role that Lambda uses to manage the underlying ENI resources for this connector.

State
Type: string

The current state of the network connector.

StateReason
Type: string

A human-readable explanation of the current state, populated when the state is FAILED or DELETE_FAILED.

StateReasonCode
Type: string

A machine-readable code indicating the reason for the current state. Use this for programmatic error handling.

Version
Type: long (int|float)

The version number of the network connector. On a standard (unqualified) request, this is the connector's current version; each configuration update increments it. When you supply a version-qualified identifier, this is the specific version you requested.

VersionArn
Type: string

The qualified ARN of the specific connector version returned by this request, including the immutable version suffix. This is populated only when you supply a version-qualified identifier. On a standard (unqualified) request, this field is not populated; the connector's latest active version is returned instead through the LatestVersionArn and LatestVersion fields described below.

Errors

InvalidParameterValueException:

One of the parameters in the request is not valid. Check the error message for details about which parameter failed validation.

ServiceException:

An internal service error occurred. Retry the request with exponential backoff.

TooManyRequestsException:

The request was throttled due to exceeding the allowed request rate. Retry the request after a brief wait using exponential backoff.

ResourceNotFoundException:

The specified resource does not exist. Verify the identifier and Region.

GetRuntime

$result = $client->getRuntime([/* ... */]);
$promise = $client->getRuntimeAsync([/* ... */]);

Retrieves the configuration and metadata of a runtime.

Parameter Syntax

$result = $client->getRuntime([
    'RuntimeName' => '<string>', // REQUIRED
]);

Parameter Details

Members
RuntimeName
Required: Yes
Type: string

The name or ARN of the runtime to retrieve.

Result Syntax

[
    'Arn' => '<string>',
    'Created' => '<string>',
    'Description' => '<string>',
    'Id' => '<string>',
    'LastModified' => '<string>',
    'LicenseInfo' => '<string>',
    'Name' => '<string>',
    'PendingDeletionAt' => '<string>',
    'ReleaseLifecycle' => [
        'DeprecationDate' => '<string>',
        'FunctionCreateBlockDate' => '<string>',
        'FunctionUpdateBlockDate' => '<string>',
        'ReleaseState' => 'PREVIEW|GA|DEPRECATED',
    ],
    'State' => 'ACTIVE|PENDING_DELETION|DELETING|FAILED',
]

Result Details

Members
Arn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the runtime.

Created
Required: Yes
Type: string

The date and time when the runtime was created.

Description
Type: string

The description of the runtime.

Id
Type: string

The unique identifier of the runtime.

LastModified
Required: Yes
Type: string

The date and time when the runtime was last modified.

LicenseInfo
Type: string

The license information for the runtime.

Name
Required: Yes
Type: string

The name of the runtime.

PendingDeletionAt
Type: string

Present only when State is PENDING_DELETION. The date and time at which the runtime will be permanently deleted.

ReleaseLifecycle
Type: RuntimeReleaseLifecycle structure

The runtime lifecycle for the runtime. Used to schedule runtime deprecation.

State
Type: string

The current state of the runtime.

Errors

InvalidParameterValueException:

One of the parameters in the request is not valid. Check the error message for details about which parameter failed validation.

TooManyRequestsException:

The request was throttled due to exceeding the allowed request rate. Retry the request after a brief wait using exponential backoff.

ServiceException:

An internal service error occurred. Retry the request with exponential backoff.

ResourceNotFoundException:

The specified resource does not exist. Verify the identifier and Region.

Examples

Example 1: Get a runtime

Retrieves the metadata for a runtime by name.

$result = $client->getRuntime([
    'RuntimeName' => 'php8',
]);

Result syntax:

[
    'Arn' => 'arn:aws:lambda:us-west-2:123456789012:runtime/php8',
    'Created' => '2026-10-01T12:00:00.000Z',
    'Description' => 'PHP 8 custom runtime',
    'LastModified' => '2026-10-02T09:30:00.000Z',
    'LicenseInfo' => 'MIT',
    'Name' => 'php8',
    'ReleaseLifecycle' => [
        'ReleaseState' => 'GA',
    ],
]

GetRuntimeAlias

$result = $client->getRuntimeAlias([/* ... */]);
$promise = $client->getRuntimeAliasAsync([/* ... */]);

Retrieves the configuration, state, and metadata of a runtime alias.

Parameter Syntax

$result = $client->getRuntimeAlias([
    'Name' => '<string>', // REQUIRED
    'RuntimeName' => '<string>', // REQUIRED
]);

Parameter Details

Members
Name
Required: Yes
Type: string

The name of the runtime alias to retrieve.

RuntimeName
Required: Yes
Type: string

The name or ARN of the runtime.

Result Syntax

[
    'Arn' => '<string>',
    'Compatibility' => [
        'Architectures' => ['<string>', ...],
        'IntegrationModels' => ['<string>', ...],
        'ManagedInstances' => 'Supported|NotSupported',
    ],
    'Created' => '<string>',
    'Description' => '<string>',
    'LastModified' => '<string>',
    'Name' => '<string>',
    'PendingDeletionAt' => '<string>',
    'ReleaseLifecycle' => [
        'DeprecationDate' => '<string>',
        'FunctionCreateBlockDate' => '<string>',
        'FunctionUpdateBlockDate' => '<string>',
        'ReleaseState' => 'PREVIEW|GA|DEPRECATED',
    ],
    'RuntimeVersion' => '<string>',
    'RuntimeVersionArn' => '<string>',
    'State' => 'CREATING|ACTIVE|UPDATING|DELETING|PENDING_DELETION',
]

Result Details

Members
Arn
Required: Yes
Type: string

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

Compatibility
Type: Compatibility structure

The compatibility matrix of the runtime version the alias points to.

Created
Required: Yes
Type: string

The date and time when the runtime alias was created.

Description
Type: string

A description of the runtime alias.

LastModified
Required: Yes
Type: string

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

Name
Required: Yes
Type: string

The name of the runtime alias.

PendingDeletionAt
Type: string

Present only when State is PENDING_DELETION. The date and time at which the runtime alias will be permanently deleted.

ReleaseLifecycle
Type: RuntimeReleaseLifecycle structure

The runtime lifecycle for the alias. By default, this is inherited from the runtime lifecycle. Optionally, you can override the lifecycle information at the alias level, if required.

RuntimeVersion
Required: Yes
Type: string

The name of the runtime version the alias points to.

RuntimeVersionArn
Required: Yes
Type: string

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

State
Required: Yes
Type: string

The current state of the runtime alias.

Errors

InvalidParameterValueException:

One of the parameters in the request is not valid. Check the error message for details about which parameter failed validation.

TooManyRequestsException:

The request was throttled due to exceeding the allowed request rate. Retry the request after a brief wait using exponential backoff.

ServiceException:

An internal service error occurred. Retry the request with exponential backoff.

ResourceNotFoundException:

The specified resource does not exist. Verify the identifier and Region.

Examples

Example 1: Get a runtime alias

Retrieves an alias, including the version it currently points at and its compatibility matrix.

$result = $client->getRuntimeAlias([
    'Name' => 'latest',
    'RuntimeName' => 'php8',
]);

Result syntax:

[
    'Arn' => 'arn:aws:lambda:us-west-2:123456789012:runtime/php8/alias/latest',
    'Compatibility' => [
        'Architectures' => [
            'arm64',
            'x86_64',
        ],
        'IntegrationModels' => [
            'RuntimeAPI',
        ],
        'ManagedInstances' => 'Supported',
    ],
    'Created' => '2026-10-01T12:00:00.000Z',
    'Description' => 'Points at the newest published version',
    'LastModified' => '2026-10-02T09:30:00.000Z',
    'Name' => 'latest',
    'ReleaseLifecycle' => [
        'ReleaseState' => 'GA',
    ],
    'RuntimeVersion' => 'v1',
    'RuntimeVersionArn' => 'arn:aws:lambda:us-west-2:123456789012:runtime/php8/version/v1',
    'State' => 'ACTIVE',
]

GetRuntimeVersion

$result = $client->getRuntimeVersion([/* ... */]);
$promise = $client->getRuntimeVersionAsync([/* ... */]);

Retrieves the configuration, state, and metadata of a runtime version.

Parameter Syntax

$result = $client->getRuntimeVersion([
    'Name' => '<string>', // REQUIRED
    'RuntimeName' => '<string>', // REQUIRED
]);

Parameter Details

Members
Name
Required: Yes
Type: string

The name of the runtime version to retrieve.

RuntimeName
Required: Yes
Type: string

The name or ARN of the runtime.

Result Syntax

[
    'Arn' => '<string>',
    'Compatibility' => [
        'Architectures' => ['<string>', ...],
        'IntegrationModels' => ['<string>', ...],
        'ManagedInstances' => 'Supported|NotSupported',
    ],
    'Created' => '<string>',
    'LastModified' => '<string>',
    'Name' => '<string>',
    'PendingDeletionAt' => '<string>',
    'Platforms' => [
        [
            'Architecture' => '<string>',
            'Digest' => '<string>',
            'Os' => '<string>',
        ],
        // ...
    ],
    'ReleaseNotes' => '<string>',
    'ResolvedUri' => '<string>',
    'State' => 'CREATING|ACTIVE|FAILED|DELETING|PENDING_DELETION',
]

Result Details

Members
Arn
Required: Yes
Type: string

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

Compatibility
Type: Compatibility structure

The compatibility matrix of the runtime version.

Created
Required: Yes
Type: string

The date and time when the runtime version was created.

LastModified
Required: Yes
Type: string

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

Name
Required: Yes
Type: string

The name of the runtime version.

PendingDeletionAt
Type: string

Present only when State is PENDING_DELETION. The date and time at which the runtime version will be permanently deleted.

Platforms
Type: Array of Platform structures

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

ReleaseNotes
Type: string

The release notes associated with the runtime version.

ResolvedUri
Required: Yes
Type: string

The resolved image URI of the runtime version.

State
Required: Yes
Type: string

The current state of the runtime version.

Errors

InvalidParameterValueException:

One of the parameters in the request is not valid. Check the error message for details about which parameter failed validation.

TooManyRequestsException:

The request was throttled due to exceeding the allowed request rate. Retry the request after a brief wait using exponential backoff.

ServiceException:

An internal service error occurred. Retry the request with exponential backoff.

ResourceNotFoundException:

The specified resource does not exist. Verify the identifier and Region.

Examples

Example 1: Get a runtime version

Retrieves a runtime version, including its resolved image URI, per-architecture platforms, and compatibility matrix.

$result = $client->getRuntimeVersion([
    'Name' => 'v1',
    'RuntimeName' => 'php8',
]);

Result syntax:

[
    'Arn' => 'arn:aws:lambda:us-west-2:123456789012:runtime/php8/version/v1',
    'Compatibility' => [
        'Architectures' => [
            'arm64',
            'x86_64',
        ],
        'IntegrationModels' => [
            'RuntimeAPI',
        ],
        'ManagedInstances' => 'Supported',
    ],
    'Created' => '2026-10-01T12:00:00.000Z',
    'LastModified' => '2026-10-01T12:00:00.000Z',
    'Name' => 'v1',
    'Platforms' => [
        [
            'Architecture' => 'arm64',
            'Digest' => 'sha256:1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b',
            'Os' => 'linux',
        ],
        [
            'Architecture' => 'x86_64',
            'Digest' => 'sha256:2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c',
            'Os' => 'linux',
        ],
    ],
    'ReleaseNotes' => 'Initial release',
    'ResolvedUri' => '123456789012.dkr.ecr.us-west-2.amazonaws.com/php8@sha256:1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b',
    'State' => 'ACTIVE',
]

ListNetworkConnectorVersions

$result = $client->listNetworkConnectorVersions([/* ... */]);
$promise = $client->listNetworkConnectorVersionsAsync([/* ... */]);

Returns a paginated list of the versions of a network connector. Each configuration update creates a new immutable version; this operation lists those versions for the connector you specify. You can optionally filter results by version state. Use the Marker parameter from a previous response to retrieve the next page of results.

Each item in the response includes the version-qualified ARN, version number, current state, and last modified timestamp for that version. To retrieve the current (latest) configuration of the connector, use GetNetworkConnector; to inspect a specific version, call GetNetworkConnector with a version-qualified identifier.

Parameter Syntax

$result = $client->listNetworkConnectorVersions([
    'Identifier' => '<string>', // REQUIRED
    'Marker' => '<string>',
    'MaxItems' => <integer>,
    'State' => 'PENDING|ACTIVE|INACTIVE|FAILED|DELETING|DELETE_FAILED',
]);

Parameter Details

Members
Identifier
Required: Yes
Type: string

The identifier of the network connector whose versions you want to list. You can specify the connector ID, name, or full ARN. Specify an unqualified identifier — this operation lists all versions of the connector, not a specific version.

Marker
Type: string

The pagination token from a previous ListNetworkConnectorVersions response. Use this value to retrieve the next page of results.

MaxItems
Type: int

The maximum number of versions to return per page. Valid range: 1 to 100.

State
Type: string

Optional filter to return only versions in the specified state (for example, ACTIVE or FAILED).

Result Syntax

[
    'NetworkConnectorVersions' => [
        [
            'Arn' => '<string>',
            'Id' => '<string>',
            'LastModified' => <DateTime>,
            'Name' => '<string>',
            'State' => 'PENDING|ACTIVE|INACTIVE|FAILED|DELETING|DELETE_FAILED',
            'StateReason' => '<string>',
            'StateReasonCode' => 'DisallowedByVpcEncryptionControl|Ec2RequestLimitExceeded|InsufficientRolePermissions|InternalError|InternetGatewayNotAttached|InvalidSecurityGroup|InvalidSubnet|SecurityGroupsPerInterfaceLimitExceeded|SubnetOutOfIPAddresses',
            'Version' => <integer>,
            'VersionArn' => '<string>',
        ],
        // ...
    ],
    'NextMarker' => '<string>',
]

Result Details

Members
NetworkConnectorVersions
Required: Yes
Type: Array of NetworkConnectorVersionSummary structures

A list of connector version summaries for the current page of results.

NextMarker
Type: string

The pagination token to include in a subsequent request to retrieve the next page. This value is null when there are no more results.

Errors

InvalidParameterValueException:

One of the parameters in the request is not valid. Check the error message for details about which parameter failed validation.

ServiceException:

An internal service error occurred. Retry the request with exponential backoff.

TooManyRequestsException:

The request was throttled due to exceeding the allowed request rate. Retry the request after a brief wait using exponential backoff.

ResourceNotFoundException:

The specified resource does not exist. Verify the identifier and Region.

ListNetworkConnectors

$result = $client->listNetworkConnectors([/* ... */]);
$promise = $client->listNetworkConnectorsAsync([/* ... */]);

Returns a paginated list of network connectors in your account for the current Region. You can optionally filter results by connector state. Use the Marker parameter from a previous response to retrieve the next page of results.

Each item in the response includes the connector ARN, name, ID, type, current state, and last modified timestamp. To retrieve full configuration details for a specific connector, use GetNetworkConnector.

Parameter Syntax

$result = $client->listNetworkConnectors([
    'Marker' => '<string>',
    'MaxItems' => <integer>,
    'State' => 'PENDING|ACTIVE|INACTIVE|FAILED|DELETING|DELETE_FAILED',
]);

Parameter Details

Members
Marker
Type: string

The pagination token from a previous ListNetworkConnectors response. Use this value to retrieve the next page of results.

MaxItems
Type: int

The maximum number of connectors to return per page. Valid range: 1 to 100.

State
Type: string

Optional filter to return only connectors in the specified state (for example, ACTIVE or FAILED).

Result Syntax

[
    'NetworkConnectors' => [
        [
            'Arn' => '<string>',
            'Id' => '<string>',
            'LastModified' => <DateTime>,
            'LatestVersion' => <integer>,
            'LatestVersionArn' => '<string>',
            'Name' => '<string>',
            'State' => 'PENDING|ACTIVE|INACTIVE|FAILED|DELETING|DELETE_FAILED',
            'Type' => 'VPC_EGRESS',
        ],
        // ...
    ],
    'NextMarker' => '<string>',
]

Result Details

Members
NetworkConnectors
Required: Yes
Type: Array of NetworkConnectorSummary structures

A list of network connector summaries for the current page of results.

NextMarker
Type: string

The pagination token to include in a subsequent request to retrieve the next page. This value is null when there are no more results.

Errors

InvalidParameterValueException:

One of the parameters in the request is not valid. Check the error message for details about which parameter failed validation.

ServiceException:

An internal service error occurred. Retry the request with exponential backoff.

TooManyRequestsException:

The request was throttled due to exceeding the allowed request rate. Retry the request after a brief wait using exponential backoff.

ListRuntimeAliases

$result = $client->listRuntimeAliases([/* ... */]);
$promise = $client->listRuntimeAliasesAsync([/* ... */]);

Returns a paginated list of aliases for the specified runtime.

Parameter Syntax

$result = $client->listRuntimeAliases([
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
    'RuntimeName' => '<string>', // REQUIRED
]);

Parameter Details

Members
MaxResults
Type: int

The maximum number of runtime aliases to return per page. Valid range: 1 to 100.

NextToken
Type: string

The pagination token from a previous response. Use it to retrieve the next page of results.

RuntimeName
Required: Yes
Type: string

The name or ARN of the runtime whose aliases to list.

Result Syntax

[
    'Items' => [
        [
            'Arn' => '<string>',
            'Compatibility' => [
                'Architectures' => ['<string>', ...],
                'IntegrationModels' => ['<string>', ...],
                'ManagedInstances' => 'Supported|NotSupported',
            ],
            'Created' => '<string>',
            'Description' => '<string>',
            'LastModified' => '<string>',
            'Name' => '<string>',
            'PendingDeletionAt' => '<string>',
            'ReleaseLifecycle' => [
                'DeprecationDate' => '<string>',
                'FunctionCreateBlockDate' => '<string>',
                'FunctionUpdateBlockDate' => '<string>',
                'ReleaseState' => 'PREVIEW|GA|DEPRECATED',
            ],
            'RuntimeVersion' => '<string>',
            'RuntimeVersionArn' => '<string>',
            'State' => 'CREATING|ACTIVE|UPDATING|DELETING|PENDING_DELETION',
        ],
        // ...
    ],
    'NextToken' => '<string>',
]

Result Details

Members
Items
Required: Yes
Type: Array of RuntimeAliasInfo structures

The list of runtime aliases for the current page of results.

NextToken
Type: string

The pagination token to include in a subsequent request to retrieve the next page of results.

Errors

InvalidParameterValueException:

One of the parameters in the request is not valid. Check the error message for details about which parameter failed validation.

TooManyRequestsException:

The request was throttled due to exceeding the allowed request rate. Retry the request after a brief wait using exponential backoff.

ServiceException:

An internal service error occurred. Retry the request with exponential backoff.

ResourceNotFoundException:

The specified resource does not exist. Verify the identifier and Region.

Examples

Example 1: List runtime aliases

Lists the aliases defined on a runtime.

$result = $client->listRuntimeAliases([
    'MaxResults' => 10,
    'RuntimeName' => 'php8',
]);

Result syntax:

[
    'Items' => [
        [
            'Arn' => 'arn:aws:lambda:us-west-2:123456789012:runtime/php8/alias/latest',
            'Created' => '2026-10-01T12:00:00.000Z',
            'Description' => 'Points at the newest published version',
            'LastModified' => '2026-10-02T09:30:00.000Z',
            'Name' => 'latest',
            'RuntimeVersion' => 'v1',
            'RuntimeVersionArn' => 'arn:aws:lambda:us-west-2:123456789012:runtime/php8/version/v1',
            'State' => 'ACTIVE',
        ],
    ],
]

ListRuntimeVersions

$result = $client->listRuntimeVersions([/* ... */]);
$promise = $client->listRuntimeVersionsAsync([/* ... */]);

Returns a paginated list of versions for the specified runtime.

Parameter Syntax

$result = $client->listRuntimeVersions([
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
    'RuntimeName' => '<string>', // REQUIRED
]);

Parameter Details

Members
MaxResults
Type: int

The maximum number of runtime versions to return per page. Valid range: 1 to 100.

NextToken
Type: string

The pagination token from a previous response. Use it to retrieve the next page of results.

RuntimeName
Required: Yes
Type: string

The name or ARN of the runtime whose versions to list.

Result Syntax

[
    'Items' => [
        [
            'Arn' => '<string>',
            'Compatibility' => [
                'Architectures' => ['<string>', ...],
                'IntegrationModels' => ['<string>', ...],
                'ManagedInstances' => 'Supported|NotSupported',
            ],
            'Created' => '<string>',
            'LastModified' => '<string>',
            'Name' => '<string>',
            'PendingDeletionAt' => '<string>',
            'ReleaseNotes' => '<string>',
            'ResolvedUri' => '<string>',
            'State' => 'CREATING|ACTIVE|FAILED|DELETING|PENDING_DELETION',
        ],
        // ...
    ],
    'NextToken' => '<string>',
]

Result Details

Members
Items
Required: Yes
Type: Array of RuntimeVersionInfo structures

The list of runtime versions for the current page of results.

NextToken
Type: string

The pagination token to include in a subsequent request to retrieve the next page of results.

Errors

InvalidParameterValueException:

One of the parameters in the request is not valid. Check the error message for details about which parameter failed validation.

TooManyRequestsException:

The request was throttled due to exceeding the allowed request rate. Retry the request after a brief wait using exponential backoff.

ServiceException:

An internal service error occurred. Retry the request with exponential backoff.

ResourceNotFoundException:

The specified resource does not exist. Verify the identifier and Region.

Examples

Example 1: List runtime versions

Lists the versions published for a runtime.

$result = $client->listRuntimeVersions([
    'MaxResults' => 10,
    'RuntimeName' => 'php8',
]);

Result syntax:

[
    'Items' => [
        [
            'Arn' => 'arn:aws:lambda:us-west-2:123456789012:runtime/php8/version/v1',
            'Created' => '2026-10-01T12:00:00.000Z',
            'LastModified' => '2026-10-01T12:00:00.000Z',
            'Name' => 'v1',
            'ReleaseNotes' => 'Initial release',
            'ResolvedUri' => '123456789012.dkr.ecr.us-west-2.amazonaws.com/php8@sha256:1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b',
            'State' => 'ACTIVE',
        ],
    ],
]

ListRuntimes

$result = $client->listRuntimes([/* ... */]);
$promise = $client->listRuntimesAsync([/* ... */]);

Returns a paginated list of runtimes in your account for the current Region.

Parameter Syntax

$result = $client->listRuntimes([
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
]);

Parameter Details

Members
MaxResults
Type: int

The maximum number of runtimes to return per page. Valid range: 1 to 100.

NextToken
Type: string

The pagination token from a previous response. Use it to retrieve the next page of results.

Result Syntax

[
    'Items' => [
        [
            'Arn' => '<string>',
            'Created' => '<string>',
            'Description' => '<string>',
            'LastModified' => '<string>',
            'LicenseInfo' => '<string>',
            'Name' => '<string>',
            'PendingDeletionAt' => '<string>',
            'ReleaseLifecycle' => [
                'DeprecationDate' => '<string>',
                'FunctionCreateBlockDate' => '<string>',
                'FunctionUpdateBlockDate' => '<string>',
                'ReleaseState' => 'PREVIEW|GA|DEPRECATED',
            ],
            'State' => 'ACTIVE|PENDING_DELETION|DELETING|FAILED',
        ],
        // ...
    ],
    'NextToken' => '<string>',
]

Result Details

Members
Items
Required: Yes
Type: Array of RuntimeInfo structures

The list of runtimes for the current page of results.

NextToken
Type: string

The pagination token to include in a subsequent request to retrieve the next page of results.

Errors

InvalidParameterValueException:

One of the parameters in the request is not valid. Check the error message for details about which parameter failed validation.

TooManyRequestsException:

The request was throttled due to exceeding the allowed request rate. Retry the request after a brief wait using exponential backoff.

ServiceException:

An internal service error occurred. Retry the request with exponential backoff.

Examples

Example 1: List runtimes

Lists the runtimes in the account and region.

$result = $client->listRuntimes([
    'MaxResults' => 10,
]);

Result syntax:

[
    'Items' => [
        [
            'Arn' => 'arn:aws:lambda:us-west-2:123456789012:runtime/php8',
            'Created' => '2026-10-01T12:00:00.000Z',
            'Description' => 'PHP 8 custom runtime',
            'LastModified' => '2026-10-02T09:30:00.000Z',
            'LicenseInfo' => 'MIT',
            'Name' => 'php8',
            'ReleaseLifecycle' => [
                'ReleaseState' => 'GA',
            ],
        ],
    ],
]

RestoreRuntime

$result = $client->restoreRuntime([/* ... */]);
$promise = $client->restoreRuntimeAsync([/* ... */]);

Cancels a pending scheduled deletion, returning the resource to the ACTIVE state. Scope is determined by the RuntimeName path parameter plus an optional, mutually exclusive RuntimeVersion or RuntimeAlias query parameter: with neither, the runtime itself is restored; with RuntimeVersion, the named runtime version; with RuntimeAlias, the named runtime alias. Restoring a resource that is already ACTIVE is a no-op success. Restore only works while the target is PENDING_DELETION; once the scheduled deletion has begun executing (DELETING) or has completed, the call fails.

Parameter Syntax

$result = $client->restoreRuntime([
    'RuntimeAlias' => '<string>',
    'RuntimeName' => '<string>', // REQUIRED
    'RuntimeVersion' => '<string>',
]);

Parameter Details

Members
RuntimeAlias
Type: string

Optional. Restores the named RuntimeAlias under RuntimeName. Mutually exclusive with RuntimeVersion; supplying both is rejected with InvalidParameterValueException.

RuntimeName
Required: Yes
Type: string

The name or ARN of the runtime to restore. When RuntimeVersion or RuntimeAlias is specified, the runtime that owns the runtime version or runtime alias to restore.

RuntimeVersion
Type: string

Optional. Restores the named RuntimeVersion under RuntimeName. Mutually exclusive with RuntimeAlias; supplying both is rejected with InvalidParameterValueException.

Result Syntax

[
    'Arn' => '<string>',
    'LastModified' => '<string>',
    'RuntimeAlias' => '<string>',
    'RuntimeName' => '<string>',
    'RuntimeVersion' => '<string>',
    'State' => 'ACTIVE|PENDING_DELETION|DELETING|FAILED',
]

Result Details

Members
Arn
Required: Yes
Type: string

The fully qualified ARN of the resource that was restored (runtime, version, or alias).

LastModified
Required: Yes
Type: string

The date and time when the restored resource was last modified.

RuntimeAlias
Type: string

Echoed back only when the request supplied a RuntimeAlias qualifier.

RuntimeName
Required: Yes
Type: string

The name or ARN of the runtime.

RuntimeVersion
Type: string

Echoed back only when the request supplied a RuntimeVersion qualifier.

State
Required: Yes
Type: string

The state of the restored resource, ACTIVE on success.

Errors

InvalidParameterValueException:

One of the parameters in the request is not valid. Check the error message for details about which parameter failed validation.

ResourceConflictException:

The request could not be completed due to a conflict with the current state of the resource. For example, attempting to modify a resource that is not in a state that permits the operation.

TooManyRequestsException:

The request was throttled due to exceeding the allowed request rate. Retry the request after a brief wait using exponential backoff.

ServiceException:

An internal service error occurred. Retry the request with exponential backoff.

ResourceNotFoundException:

The specified resource does not exist. Verify the identifier and Region.

Examples

Example 1: Restore a runtime alias that is scheduled for deletion

Cancels a pending deletion for an alias, returning it to ACTIVE.

$result = $client->restoreRuntime([
    'RuntimeAlias' => 'release',
    'RuntimeName' => 'php8',
]);

Result syntax:

[
    'Arn' => 'arn:aws:lambda:us-west-2:123456789012:runtime/php8/alias/release',
    'LastModified' => '2026-10-02T19:40:00.000Z',
    'RuntimeAlias' => 'release',
    'RuntimeName' => 'php8',
    'State' => 'ACTIVE',
]
Example 2: Restore a customer-managed runtime that is scheduled for deletion

Cancels a pending deletion for the runtime, returning it to ACTIVE.

$result = $client->restoreRuntime([
    'RuntimeName' => 'php8',
]);

Result syntax:

[
    'Arn' => 'arn:aws:lambda:us-west-2:123456789012:runtime/php8',
    'LastModified' => '2026-10-02T19:41:00.000Z',
    'RuntimeName' => 'php8',
    'State' => 'ACTIVE',
]

UpdateNetworkConnector

$result = $client->updateNetworkConnector([/* ... */]);
$promise = $client->updateNetworkConnectorAsync([/* ... */]);

Updates the VPC configuration or operator role of an existing network connector. You can modify the subnet IDs, security group IDs, network protocol, or operator role. The connector must be in ACTIVE state to accept updates.

This operation is asynchronous. The connector remains in ACTIVE state during the update — existing workloads that reference this connector are not disrupted. Use GetNetworkConnector to monitor the LastUpdateStatus field, which transitions through InProgress to Successful or Failed. If the update fails, the LastUpdateStatusReasonCode field provides a specific error code for troubleshooting. This operation is idempotent when you provide a ClientToken.

Each successful configuration change creates a new immutable version. A connector can have a limited number of versions; once that limit is reached, further updates fail with NetworkConnectorLimitExceededException until you delete older versions.

Parameter Syntax

$result = $client->updateNetworkConnector([
    'ClientToken' => '<string>',
    'Configuration' => [
        'VpcEgressConfiguration' => [
            'AssociatedComputeResourceTypes' => ['<string>', ...],
            'ElasticIpConfiguration' => [
                'Type' => 'None|ServiceManaged', // REQUIRED
            ],
            'NetworkProtocol' => 'IPv4|DualStack',
            'SecurityGroupIds' => ['<string>', ...],
            'SubnetIds' => ['<string>', ...],
        ],
    ],
    'Identifier' => '<string>', // REQUIRED
    'OperatorRole' => '<string>',
]);

Parameter Details

Members
ClientToken
Type: string

A unique, case-sensitive identifier to ensure idempotency of the update request.

Configuration

The updated network configuration for the connector. Provide the full VpcEgressConfiguration including all subnet IDs and security group IDs — this replaces the existing configuration.

Identifier
Required: Yes
Type: string

The identifier of the network connector to update. You can specify the connector ID, name, or full ARN.

OperatorRole
Type: string

The updated ARN of the IAM role that Lambda assumes to manage ENIs. Use this to change the operator role without recreating the connector.

Result Syntax

[
    'Arn' => '<string>',
    'Configuration' => [
        'VpcEgressConfiguration' => [
            'AssociatedComputeResourceTypes' => ['<string>', ...],
            'ElasticIpConfiguration' => [
                'Type' => 'None|ServiceManaged',
            ],
            'NetworkProtocol' => 'IPv4|DualStack',
            'SecurityGroupIds' => ['<string>', ...],
            'SubnetIds' => ['<string>', ...],
        ],
    ],
    'Id' => '<string>',
    'LastModified' => <DateTime>,
    'LastUpdateStatus' => 'Successful|Failed|InProgress',
    'LastUpdateStatusReason' => '<string>',
    'Name' => '<string>',
    'OperatorRole' => '<string>',
    'State' => 'PENDING|ACTIVE|INACTIVE|FAILED|DELETING|DELETE_FAILED',
    'Version' => <integer>,
    'VersionArn' => '<string>',
]

Result Details

Members
Arn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the network connector.

Configuration

The network configuration of the connector, including VPC subnets and security groups.

Id
Required: Yes
Type: string

The unique identifier of the network connector.

LastModified
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of this update.

LastUpdateStatus
Type: string

The status of this update operation (typically InProgress immediately after the call).

LastUpdateStatusReason
Type: string

A human-readable explanation of the update status.

Name
Required: Yes
Type: string

The name of the network connector.

OperatorRole
Type: string

The ARN of the IAM role that Lambda uses to manage the underlying ENI resources for this connector.

State
Type: string

The current state of the network connector.

Version
Type: long (int|float)

The version number of the connector version resulting from this update. A configuration change creates a new, incremented version; a no-op update returns the current version number.

VersionArn
Type: string

The qualified ARN of the connector version resulting from this update, including the immutable version suffix.

Errors

InvalidParameterValueException:

One of the parameters in the request is not valid. Check the error message for details about which parameter failed validation.

ResourceConflictException:

The request could not be completed due to a conflict with the current state of the resource. For example, attempting to modify a resource that is not in a state that permits the operation.

NetworkConnectorLimitExceededException:

The request would exceed a network connector limit. For CreateNetworkConnector, the account has reached the maximum number of network connectors allowed. For UpdateNetworkConnector, the connector has reached the maximum number of versions allowed.

ServiceException:

An internal service error occurred. Retry the request with exponential backoff.

TooManyRequestsException:

The request was throttled due to exceeding the allowed request rate. Retry the request after a brief wait using exponential backoff.

ResourceNotFoundException:

The specified resource does not exist. Verify the identifier and Region.

UpdateRuntime

$result = $client->updateRuntime([/* ... */]);
$promise = $client->updateRuntimeAsync([/* ... */]);

Updates the properties of an existing customer-managed runtime, such as its description, license information, or lifecycle information.

Parameter Syntax

$result = $client->updateRuntime([
    'Description' => '<string>',
    'LicenseInfo' => '<string>',
    'ReleaseLifecycle' => [
        'DeprecationDate' => '<string>',
        'FunctionCreateBlockDate' => '<string>',
        'FunctionUpdateBlockDate' => '<string>',
        'ReleaseState' => 'PREVIEW|GA|DEPRECATED',
    ],
    'RuntimeName' => '<string>', // REQUIRED
]);

Parameter Details

Members
Description
Type: string

The updated description of the runtime.

LicenseInfo
Type: string

The updated license information for the runtime.

ReleaseLifecycle
Type: RuntimeReleaseLifecycle structure

The runtime lifecycle for the runtime. Optional. Used to schedule runtime deprecation. Omitting or providing an empty object removes the existing lifecycle.

RuntimeName
Required: Yes
Type: string

The name or ARN of the runtime to update.

Result Syntax

[
    'Arn' => '<string>',
    'Created' => '<string>',
    'Description' => '<string>',
    'LastModified' => '<string>',
    'LicenseInfo' => '<string>',
    'Name' => '<string>',
    'ReleaseLifecycle' => [
        'DeprecationDate' => '<string>',
        'FunctionCreateBlockDate' => '<string>',
        'FunctionUpdateBlockDate' => '<string>',
        'ReleaseState' => 'PREVIEW|GA|DEPRECATED',
    ],
]

Result Details

Members
Arn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the runtime.

Created
Required: Yes
Type: string

The date and time when the runtime was created.

Description
Type: string

The description of the runtime.

LastModified
Required: Yes
Type: string

The date and time when the runtime was last modified.

LicenseInfo
Type: string

The license information for the runtime.

Name
Required: Yes
Type: string

The name of the runtime.

ReleaseLifecycle
Type: RuntimeReleaseLifecycle structure

The runtime lifecycle for the runtime. Used to schedule runtime deprecation.

Errors

InvalidParameterValueException:

One of the parameters in the request is not valid. Check the error message for details about which parameter failed validation.

ResourceConflictException:

The request could not be completed due to a conflict with the current state of the resource. For example, attempting to modify a resource that is not in a state that permits the operation.

TooManyRequestsException:

The request was throttled due to exceeding the allowed request rate. Retry the request after a brief wait using exponential backoff.

ServiceException:

An internal service error occurred. Retry the request with exponential backoff.

ResourceNotFoundException:

The specified resource does not exist. Verify the identifier and Region.

Examples

Example 1: Update a runtime

Updates a runtime's description and declares it generally available.

$result = $client->updateRuntime([
    'Description' => 'PHP 8 custom runtime (updated)',
    'ReleaseLifecycle' => [
        'ReleaseState' => 'GA',
    ],
    'RuntimeName' => 'php8',
]);

Result syntax:

[
    'Arn' => 'arn:aws:lambda:us-west-2:123456789012:runtime/php8',
    'Created' => '2026-10-01T12:00:00.000Z',
    'Description' => 'PHP 8 custom runtime (updated)',
    'LastModified' => '2026-10-02T09:30:00.000Z',
    'LicenseInfo' => 'MIT',
    'Name' => 'php8',
    'ReleaseLifecycle' => [
        'ReleaseState' => 'GA',
    ],
]

UpdateRuntimeAlias

$result = $client->updateRuntimeAlias([/* ... */]);
$promise = $client->updateRuntimeAliasAsync([/* ... */]);

Updates an existing runtime alias to point to a different runtime version or to change its description or lifecycle information.

Parameter Syntax

$result = $client->updateRuntimeAlias([
    'Description' => '<string>',
    'Name' => '<string>', // REQUIRED
    'ReleaseLifecycle' => [
        'DeprecationDate' => '<string>',
        'FunctionCreateBlockDate' => '<string>',
        'FunctionUpdateBlockDate' => '<string>',
        'ReleaseState' => 'PREVIEW|GA|DEPRECATED',
    ],
    'RuntimeName' => '<string>', // REQUIRED
    'RuntimeVersion' => '<string>', // REQUIRED
]);

Parameter Details

Members
Description
Type: string

A description of the runtime alias.

Name
Required: Yes
Type: string

The name of the runtime alias to update.

ReleaseLifecycle
Type: RuntimeReleaseLifecycle structure

The lifecycle for the alias. By default, this is inherited from the runtime lifecycle. Optionally, you can override the lifecycle information at the alias level, if required. Omitting or providing an empty object removes the existing lifecycle override.

RuntimeName
Required: Yes
Type: string

The name or ARN of the runtime.

RuntimeVersion
Required: Yes
Type: string

The name of the runtime version the alias should point to.

Result Syntax

[
    'Arn' => '<string>',
    'Compatibility' => [
        'Architectures' => ['<string>', ...],
        'IntegrationModels' => ['<string>', ...],
        'ManagedInstances' => 'Supported|NotSupported',
    ],
    'Created' => '<string>',
    'Description' => '<string>',
    'LastModified' => '<string>',
    'Name' => '<string>',
    'ReleaseLifecycle' => [
        'DeprecationDate' => '<string>',
        'FunctionCreateBlockDate' => '<string>',
        'FunctionUpdateBlockDate' => '<string>',
        'ReleaseState' => 'PREVIEW|GA|DEPRECATED',
    ],
    'RuntimeName' => '<string>',
    'RuntimeVersion' => '<string>',
    'RuntimeVersionArn' => '<string>',
    'State' => 'CREATING|ACTIVE|UPDATING|DELETING|PENDING_DELETION',
]

Result Details

Members
Arn
Required: Yes
Type: string

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

Compatibility
Type: Compatibility structure

The compatibility matrix of the runtime version the alias points to.

Created
Required: Yes
Type: string

The date and time when the runtime alias was created.

Description
Type: string

A description of the runtime alias.

LastModified
Required: Yes
Type: string

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

Name
Required: Yes
Type: string

The name of the runtime alias.

ReleaseLifecycle
Type: RuntimeReleaseLifecycle structure

The runtime lifecycle for the alias. By default, this is inherited from the runtime lifecycle. Optionally, you can override the lifecycle information at the alias level, if required.

RuntimeName
Required: Yes
Type: string

The name of the runtime.

RuntimeVersion
Required: Yes
Type: string

The name of the runtime version the alias points to.

RuntimeVersionArn
Required: Yes
Type: string

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

State
Required: Yes
Type: string

The current state of the runtime alias.

Errors

InvalidParameterValueException:

One of the parameters in the request is not valid. Check the error message for details about which parameter failed validation.

ResourceConflictException:

The request could not be completed due to a conflict with the current state of the resource. For example, attempting to modify a resource that is not in a state that permits the operation.

TooManyRequestsException:

The request was throttled due to exceeding the allowed request rate. Retry the request after a brief wait using exponential backoff.

ServiceException:

An internal service error occurred. Retry the request with exponential backoff.

ResourceNotFoundException:

The specified resource does not exist. Verify the identifier and Region.

Examples

Example 1: Update a runtime alias

Repoints an alias at a different runtime version.

$result = $client->updateRuntimeAlias([
    'Name' => 'latest',
    'RuntimeName' => 'php8',
    'RuntimeVersion' => 'v2',
]);

Result syntax:

[
    'Arn' => 'arn:aws:lambda:us-west-2:123456789012:runtime/php8/alias/latest',
    'Created' => '2026-10-01T12:00:00.000Z',
    'Description' => 'Points at the newest published version',
    'LastModified' => '2026-10-03T08:15:00.000Z',
    'Name' => 'latest',
    'RuntimeName' => 'php8',
    'RuntimeVersion' => 'v2',
    'RuntimeVersionArn' => 'arn:aws:lambda:us-west-2:123456789012:runtime/php8/version/v2',
    'State' => 'UPDATING',
]

UpdateRuntimeVersion

$result = $client->updateRuntimeVersion([/* ... */]);
$promise = $client->updateRuntimeVersionAsync([/* ... */]);

Updates the runtime version release notes. The runtime version must be in the ACTIVE state. The runtime version image is immutable. To change the runtime contents, create a new runtime version.

Parameter Syntax

$result = $client->updateRuntimeVersion([
    'Name' => '<string>', // REQUIRED
    'ReleaseNotes' => '<string>', // REQUIRED
    'RuntimeName' => '<string>', // REQUIRED
]);

Parameter Details

Members
Name
Required: Yes
Type: string

The name of the runtime version to update.

ReleaseNotes
Required: Yes
Type: string

The release notes to associate with the runtime version.

RuntimeName
Required: Yes
Type: string

The name or ARN of the runtime.

Result Syntax

[
    'Arn' => '<string>',
    'Compatibility' => [
        'Architectures' => ['<string>', ...],
        'IntegrationModels' => ['<string>', ...],
        'ManagedInstances' => 'Supported|NotSupported',
    ],
    'Created' => '<string>',
    'LastModified' => '<string>',
    'Name' => '<string>',
    'Platforms' => [
        [
            'Architecture' => '<string>',
            'Digest' => '<string>',
            'Os' => '<string>',
        ],
        // ...
    ],
    'ReleaseNotes' => '<string>',
    'ResolvedUri' => '<string>',
    'State' => 'CREATING|ACTIVE|FAILED|DELETING|PENDING_DELETION',
]

Result Details

Members
Arn
Required: Yes
Type: string

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

Compatibility
Type: Compatibility structure

The compatibility matrix of the runtime version.

Created
Required: Yes
Type: string

The date and time when the runtime version was created.

LastModified
Required: Yes
Type: string

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

Name
Required: Yes
Type: string

The name of the runtime version.

Platforms
Type: Array of Platform structures

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

ReleaseNotes
Type: string

The release notes associated with the runtime version.

ResolvedUri
Required: Yes
Type: string

The resolved image URI of the runtime version.

State
Required: Yes
Type: string

The current state of the runtime version.

Errors

InvalidParameterValueException:

One of the parameters in the request is not valid. Check the error message for details about which parameter failed validation.

ResourceConflictException:

The request could not be completed due to a conflict with the current state of the resource. For example, attempting to modify a resource that is not in a state that permits the operation.

TooManyRequestsException:

The request was throttled due to exceeding the allowed request rate. Retry the request after a brief wait using exponential backoff.

ServiceException:

An internal service error occurred. Retry the request with exponential backoff.

ResourceNotFoundException:

The specified resource does not exist. Verify the identifier and Region.

Examples

Example 1: Update a runtime version's release notes

Updates the release notes of an ACTIVE runtime version.

$result = $client->updateRuntimeVersion([
    'Name' => 'v1',
    'ReleaseNotes' => 'Patched OpenSSL to 3.0.14',
    'RuntimeName' => 'php8',
]);

Result syntax:

[
    'Arn' => 'arn:aws:lambda:us-west-2:123456789012:runtime/php8/version/v1',
    'Created' => '2026-10-01T12:00:00.000Z',
    'LastModified' => '2026-10-03T08:15:00.000Z',
    'Name' => 'v1',
    'ReleaseNotes' => 'Patched OpenSSL to 3.0.14',
    'ResolvedUri' => '123456789012.dkr.ecr.us-west-2.amazonaws.com/php8@sha256:1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b',
    'State' => 'ACTIVE',
]

Shapes

Compatibility

Description

Defines the compatibility matrix for a runtime version, indicating supported integration models, architectures, and feature availability.

Members
Architectures
Type: Array of strings

Supported architectures for the runtime version.

IntegrationModels
Type: Array of strings

Supported integration models for the runtime version.

ManagedInstances
Type: string

Whether the runtime version is compatible with managed instances.

ElasticIpConfiguration

Description

How the connector's network interfaces get an Elastic IP address.

Members
Type
Required: Yes
Type: string

The Elastic IP type for the connector's network interfaces.

InvalidParameterValueException

Description

One of the parameters in the request is not valid. Check the error message for details about which parameter failed validation.

Members
Type
Type: string

The exception type.

message
Type: string

The error message that describes the exception.

NetworkConnectorConfiguration

Description

The network configuration for a network connector. Different connector types use different configuration shapes; specify the configuration that matches your connector type.

Members
VpcEgressConfiguration

Configuration for a VPC egress network connector. Specifies the subnets, security groups, and network protocol for routing outbound traffic through your VPC.

NetworkConnectorLimitExceededException

Description

The request would exceed a network connector limit. For CreateNetworkConnector, the account has reached the maximum number of network connectors allowed. For UpdateNetworkConnector, the connector has reached the maximum number of versions allowed.

Members
Type
Type: string

The exception type.

message
Type: string

The account has reached the maximum number of network connectors allowed.

NetworkConnectorSummary

Description

Summary information about a network connector returned by ListNetworkConnectors. Contains identifying fields and current state. To retrieve full configuration details, use GetNetworkConnector.

Members
Arn
Required: Yes
Type: string

The ARN of the network connector.

Id
Required: Yes
Type: string

The unique identifier of the network connector.

LastModified
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the connector was last modified.

LatestVersion
Type: long (int|float)

The version number of the connector's latest version. Each configuration update creates a new immutable version; this attribute exposes the most recent one.

LatestVersionArn
Type: string

The qualified ARN of the connector's latest version, including the immutable version suffix.

Name
Required: Yes
Type: string

The name of the network connector.

State
Type: string

The current state of the network connector.

Type
Required: Yes
Type: string

The type of the network connector (VPC_EGRESS).

NetworkConnectorVersionSummary

Description

Summary information about a single version of a network connector returned by ListNetworkConnectorVersions. Each configuration update creates a new immutable version; this shape describes one such version. To retrieve the full configuration of a version, call GetNetworkConnector with a version-qualified identifier.

Members
Arn
Required: Yes
Type: string

The unqualified ARN of the network connector that this version belongs to.

Id
Required: Yes
Type: string

The unique identifier of the network connector.

LastModified
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when this connector version was last modified.

Name
Required: Yes
Type: string

The name of the network connector.

State
Required: Yes
Type: string

The current state of this connector version.

StateReason
Type: string

A human-readable explanation of the current state, populated when the state is FAILED.

StateReasonCode
Type: string

A machine-readable code indicating the reason for the current state. Use this for programmatic error handling.

Version
Required: Yes
Type: long (int|float)

The version number of this connector version.

VersionArn
Required: Yes
Type: string

The qualified ARN of this connector version, including the immutable version suffix.

NetworkConnectorVpcEgressConfiguration

Description

Configuration for a VPC egress network connector. Specifies the VPC subnets, security groups, network protocol, and associated Lambda compute resource types.

Members
AssociatedComputeResourceTypes
Type: Array of strings

The types of Lambda compute resources that can use this connector. Valid values are MicroVm and WebFunction. Specify exactly one value.

ElasticIpConfiguration
Type: ElasticIpConfiguration structure

The Elastic IP configuration for the connector's ENIs. Specify ServiceManaged to have Lambda assign a service-managed Elastic IP address to each ENI. The operator role must allow ec2:AllocateAddress and ec2:AssociateAddress.

NetworkProtocol
Type: string

The network protocol for the connector. Specify IPv4 for IPv4-only networking, or DualStack for both IPv4 and IPv6.

SecurityGroupIds
Type: Array of strings

The IDs of the VPC security groups to attach to the ENIs. All security groups must be in the same VPC as the subnets.

SubnetIds
Type: Array of strings

The IDs of the VPC subnets where Lambda provisions elastic network interfaces (ENIs). Specify 1 to 16 subnets. All subnets must be in the same VPC.

Platform

Description

Describes a single OCI platform (CPU architecture and operating system) available for a runtime version.

Members
Architecture
Required: Yes
Type: string

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

Digest
Required: Yes
Type: string

The content digest of the platform-specific image.

Os
Required: Yes
Type: string

The operating system of the platform.

ResourceConflictException

Description

The request could not be completed due to a conflict with the current state of the resource. For example, attempting to modify a resource that is not in a state that permits the operation.

Members
Type
Type: string

The exception type.

message
Type: string

The error message that describes the exception.

ResourceNotFoundException

Description

The specified resource does not exist. Verify the identifier and Region.

Members
Message
Type: string

The error message that describes the exception.

Type
Type: string

The exception type.

RuntimeAliasInfo

Description

Summary information about a runtime alias returned by ListRuntimeAliases.

Members
Arn
Required: Yes
Type: string

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

Compatibility
Type: Compatibility structure

The compatibility matrix of the runtime version the alias points to.

Created
Required: Yes
Type: string

The date and time when the runtime alias was created.

Description
Type: string

A description of the runtime alias.

LastModified
Required: Yes
Type: string

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

Name
Required: Yes
Type: string

The name of the runtime alias.

PendingDeletionAt
Type: string

Present only when State is PENDING_DELETION. The date and time at which the runtime alias will be permanently deleted.

ReleaseLifecycle
Type: RuntimeReleaseLifecycle structure

The lifecycle for the alias. By default, this is inherited from the runtime lifecycle. Optionally, you can override the lifecycle information at the alias level, if required.

RuntimeVersion
Required: Yes
Type: string

The name of the runtime version the alias points to.

RuntimeVersionArn
Required: Yes
Type: string

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

State
Required: Yes
Type: string

The current state of the runtime alias.

RuntimeInfo

Description

Summary information about a runtime returned by ListRuntimes.

Members
Arn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the runtime.

Created
Required: Yes
Type: string

The date and time when the runtime was created.

Description
Type: string

The description of the runtime.

LastModified
Required: Yes
Type: string

The date and time when the runtime was last modified.

LicenseInfo
Type: string

The license information for the runtime.

Name
Required: Yes
Type: string

The name of the runtime.

PendingDeletionAt
Type: string

Present only when State is PENDING_DELETION. The date and time at which the runtime will be permanently deleted.

ReleaseLifecycle
Type: RuntimeReleaseLifecycle structure

The runtime lifecycle for the runtime. Used to schedule runtime deprecation.

State
Type: string

The current state of the runtime.

RuntimeReleaseLifecycle

Description

The runtime lifecycle for the runtime or alias. Optional. Used to schedule runtime deprecation. Omitting or providing an empty object removes the existing lifecycle.

Members
DeprecationDate
Type: string

The date (UTC) on which the runtime or alias becomes deprecated.

FunctionCreateBlockDate
Type: string

The date (UTC) on which creating new functions that use this runtime or alias is blocked.

FunctionUpdateBlockDate
Type: string

The date (UTC) on which updating existing functions that use this runtime or alias is blocked.

ReleaseState
Type: string

Optional, with no default applied. DEPRECATED requires a DeprecationDate on or before today (UTC); PREVIEW and GA require a later one, or none. Reads report DEPRECATED once DeprecationDate is reached.

RuntimeVersionInfo

Description

Summary information about a runtime version returned by ListRuntimeVersions.

Members
Arn
Required: Yes
Type: string

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

Compatibility
Type: Compatibility structure

The compatibility matrix of the runtime version.

Created
Required: Yes
Type: string

The date and time when the runtime version was created.

LastModified
Required: Yes
Type: string

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

Name
Required: Yes
Type: string

The name of the runtime version.

PendingDeletionAt
Type: string

Present only when State is PENDING_DELETION. The date and time at which the runtime version will be permanently deleted.

ReleaseNotes
Type: string

The release notes associated with the runtime version.

ResolvedUri
Required: Yes
Type: string

The resolved image URI of the runtime version.

State
Required: Yes
Type: string

The current state of the runtime version.

ServiceException

Description

An internal service error occurred. Retry the request with exponential backoff.

Members
Message
Type: string

The error message that describes the exception.

Type
Type: string

The exception type.

ServiceQuotaExceededException

Description

The request would exceed a service quota for your account. Request a quota increase or reduce the number of resources in use, then retry the request.

Members
Message
Type: string

The error message that describes the exception.

Type
Type: string

The exception type.

TooManyRequestsException

Description

The request was throttled due to exceeding the allowed request rate. Retry the request after a brief wait using exponential backoff.

Members
Reason
Type: string

The reason for the throttling.

Type
Type: string

The exception type.

message
Type: string

The error message that describes the exception.

retryAfterSeconds
Type: string

The number of seconds to wait before retrying the request.