AWS Lambda Core 2026-04-30
- 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
VpcEgressConfigurationto 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
-
- Type: NetworkConnectorConfiguration structure
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. ForUpdateNetworkConnector, 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
-
- Type: NetworkConnectorConfiguration structure
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
DELETINGafter 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
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
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
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
-
- Type: NetworkConnectorConfiguration structure
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, orInProgress). - 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
VersionArnis 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
FAILEDorDELETE_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
LatestVersionArnandLatestVersionfields 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
ListNetworkConnectorVersionsresponse. 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,
ACTIVEorFAILED).
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
ListNetworkConnectorsresponse. 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,
ACTIVEorFAILED).
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
-
- Type: NetworkConnectorConfiguration structure
The updated network configuration for the connector. Provide the full
VpcEgressConfigurationincluding 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
-
- Type: NetworkConnectorConfiguration structure
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
InProgressimmediately 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. ForUpdateNetworkConnector, 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
-
- Type: NetworkConnectorVpcEgressConfiguration structure
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
MicroVmandWebFunction. Specify exactly one value. - ElasticIpConfiguration
-
- Type: ElasticIpConfiguration structure
The Elastic IP configuration for the connector's ENIs. Specify
ServiceManagedto have Lambda assign a service-managed Elastic IP address to each ENI. The operator role must allowec2:AllocateAddressandec2:AssociateAddress. - NetworkProtocol
-
- Type: string
The network protocol for the connector. Specify
IPv4for IPv4-only networking, orDualStackfor 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.