Specify a version or alias to get details about a published version of the function.

The name of the Lambda function, version, or alias.

Name formats

• Function name - my-function (name-only), my-function:v1 (with alias).
• Function ARN - arn:aws:lambda:us-west-2:123456789012:function:my-function.
• Partial ARN - 123456789012:function:my-function.

You can append a version number or alias to any of the formats. The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

The amount of memory available to the function at runtime.

The runtime environment for the Lambda function.

The current state of the function. When the state is Inactive, you can reactivate the function by invoking it.

The ARN of the signing profile version.

The status of the last update that was performed on the function. This is first set to Successful after function creation completes.

The function's Amazon Resource Name (ARN).

The KMS key that's used to encrypt the function's environment variables. This key is only returned if you've configured a customer managed CMK.

The type of deployment package. Set to Image for container image and set Zip for .zip file archive.

Connection settings for an Amazon EFS file system.

The function's environment variables.

The function's dead letter queue.

The instruction set architecture that the function supports. Architecture is a string array with one of the valid values. The default architecture value is x86_64.

The ARN of the signing job.

The function's execution role.

The function's networking configuration.

The version of the Lambda function.

The name of the function.

The function's layers.

The size of the function's deployment package, in bytes.

The function that Lambda calls to begin executing your function.

The amount of time in seconds that Lambda allows a function to run before stopping it.

The reason for the last update that was performed on the function.

The reason for the function's current state.

The date and time that the function was last updated, in ISO-8601 format (YYYY-MM-DDThh:mm:ss.sTZD).

The SHA256 hash of the function's deployment package.

The function's X-Ray tracing configuration.

The reason code for the function's current state. When the code is Creating, you can't invoke or modify the function.

The function's image configuration values.

The function's description.

The reason code for the last update that was performed on the function.

The latest updated revision of the function or alias.

For Lambda@Edge functions, the ARN of the master function.

The identifier of the event source mapping.

The Amazon Resource Name (ARN) of the event source.

The state of the event source mapping. It can be one of the following: Creating, Enabling, Enabled, Disabling, Disabled, Updating, or Deleting.

With StartingPosition set to AT_TIMESTAMP, the time from which to start reading.

The ARN of the Lambda function.

The name of the Kafka topic.

(Amazon MQ) The name of the Amazon MQ broker destination queue to consume.

(Streams only) If the function returns an error, split the batch in two and retry. The default value is false.

The identifier of the event source mapping.

(Streams only) The number of batches to process concurrently from each shard. The default value is 1.

The result of the last Lambda invocation of your function.

(Streams only) Discard records after the specified number of retries. The default value is -1, which sets the maximum number of retries to infinite. When MaximumRetryAttempts is infinite, Lambda retries failed records until the record expires in the event source.

The maximum number of records in each batch that Lambda pulls from your stream or queue and sends to your function. Lambda passes all of the records in the batch to the function in a single call, up to the payload limit for synchronous invocation (6 MB).

Default value: Varies by service. For Amazon SQS, the default is 10. For all other services, the default is 100.

Related setting: When you set BatchSize to a value greater than 10, you must set MaximumBatchingWindowInSeconds to at least 1.

Indicates whether a user or Lambda made the last change to the event source mapping.

(Streams and Amazon SQS standard queues) The maximum amount of time, in seconds, that Lambda spends gathering records before invoking the function.

Default: 0

Related setting: When you set BatchSize to a value greater than 10, you must set MaximumBatchingWindowInSeconds to at least 1.

An array of the authentication protocol, VPC components, or virtual host to secure and define your event source.

(Streams only) Discard records older than the specified age. The default value is -1, which sets the maximum age to infinite. When the value is set to infinite, Lambda never discards old records.

(Streams only) A list of current response type enums applied to the event source mapping.

(Streams only) The duration in seconds of a processing window. The range is 1–900 seconds.

The self-managed Apache Kafka cluster for your event source.

The date that the event source mapping was last updated or that its state changed.

(Streams only) An Amazon SQS queue or Amazon SNS topic destination for discarded records.

The position in a stream from which to start reading. Required for Amazon Kinesis, Amazon DynamoDB, and Amazon MSK stream sources. AT_TIMESTAMP is supported only for Amazon Kinesis streams.

When true, the event source mapping is active. When false, Lambda pauses polling and invocation.

Default: True

(Streams only) If the function returns an error, split the batch in two and retry.

(Streams only) The number of batches to process from each shard concurrently.

(Streams only) Discard records after the specified number of retries. The default value is infinite (-1). When set to infinite (-1), failed records will be retried until the record expires.

The maximum number of records in each batch that Lambda pulls from your stream or queue and sends to your function. Lambda passes all of the records in the batch to the function in a single call, up to the payload limit for synchronous invocation (6 MB).

• Amazon Kinesis - Default 100. Max 10,000.
• Amazon DynamoDB Streams - Default 100. Max 1,000.
• Amazon Simple Queue Service - Default 10. For standard queues the max is 10,000. For FIFO queues the max is 10.
• Amazon Managed Streaming for Apache Kafka - Default 100. Max 10,000.
• Self-Managed Apache Kafka - Default 100. Max 10,000.

(Streams and Amazon SQS standard queues) The maximum amount of time, in seconds, that Lambda spends gathering records before invoking the function.

Default: 0

Related setting: When you set BatchSize to a value greater than 10, you must set MaximumBatchingWindowInSeconds to at least 1.

An array of authentication protocols or VPC components required to secure your event source.

(Streams only) Discard records older than the specified age. The default value is infinite (-1).

(Streams only) A list of current response type enums applied to the event source mapping.

(Streams only) The duration in seconds of a processing window. The range is between 1 second up to 900 seconds.

The name of the Lambda function.

Name formats

• Function name - MyFunction.
• Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction.
• Version or Alias ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction:PROD.
• Partial ARN - 123456789012:function:MyFunction.

The length constraint applies only to the full ARN. If you specify only the function name, it's limited to 64 characters in length.

(Streams only) An Amazon SQS queue or Amazon SNS topic destination for discarded records.

The identifier of the event source mapping.

The Amazon Resource Name (ARN) of the event source.

The state of the event source mapping. It can be one of the following: Creating, Enabling, Enabled, Disabling, Disabled, Updating, or Deleting.

With StartingPosition set to AT_TIMESTAMP, the time from which to start reading.

The ARN of the Lambda function.

The name of the Kafka topic.

(Amazon MQ) The name of the Amazon MQ broker destination queue to consume.

(Streams only) If the function returns an error, split the batch in two and retry. The default value is false.

The identifier of the event source mapping.

(Streams only) The number of batches to process concurrently from each shard. The default value is 1.

The result of the last Lambda invocation of your function.

(Streams only) Discard records after the specified number of retries. The default value is -1, which sets the maximum number of retries to infinite. When MaximumRetryAttempts is infinite, Lambda retries failed records until the record expires in the event source.

The maximum number of records in each batch that Lambda pulls from your stream or queue and sends to your function. Lambda passes all of the records in the batch to the function in a single call, up to the payload limit for synchronous invocation (6 MB).

Default value: Varies by service. For Amazon SQS, the default is 10. For all other services, the default is 100.

Related setting: When you set BatchSize to a value greater than 10, you must set MaximumBatchingWindowInSeconds to at least 1.

Indicates whether a user or Lambda made the last change to the event source mapping.

(Streams and Amazon SQS standard queues) The maximum amount of time, in seconds, that Lambda spends gathering records before invoking the function.

Default: 0

Related setting: When you set BatchSize to a value greater than 10, you must set MaximumBatchingWindowInSeconds to at least 1.

An array of the authentication protocol, VPC components, or virtual host to secure and define your event source.

(Streams only) Discard records older than the specified age. The default value is -1, which sets the maximum age to infinite. When the value is set to infinite, Lambda never discards old records.

(Streams only) A list of current response type enums applied to the event source mapping.

(Streams only) The duration in seconds of a processing window. The range is 1–900 seconds.

The self-managed Apache Kafka cluster for your event source.

The date that the event source mapping was last updated or that its state changed.

(Streams only) An Amazon SQS queue or Amazon SNS topic destination for discarded records.

The position in a stream from which to start reading. Required for Amazon Kinesis, Amazon DynamoDB, and Amazon MSK stream sources. AT_TIMESTAMP is supported only for Amazon Kinesis streams.

The name or Amazon Resource Name (ARN) of the layer.

The version number.

The ARN of the layer version.

Details about the layer version.

The date that the layer version was created, in ISO-8601 format (YYYY-MM-DDThh:mm:ss.sTZD).

The version number.

The layer's software license.

A list of compatible instruction set architectures.

The ARN of the layer.

The description of the version.

The layer's compatible runtimes.

The name of the Lambda function.

Name formats

• Function name - MyFunction.
• Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction.
• Partial ARN - 123456789012:function:MyFunction.

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

The The Amazon Resource Name (ARN) of the code signing configuration.

The name of the Lambda function.

Name formats

• Function name - MyFunction.
• Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction.
• Partial ARN - 123456789012:function:MyFunction.

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

The response's http status code.

The The Amazon Resource Name (ARN) of the code signing configuration.

The name of the Lambda function.

Name formats

• Function name - MyFunction.
• Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction.
• Partial ARN - 123456789012:function:MyFunction.

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

The routing configuration of the alias.

A description of the alias.

The name of the Lambda function.

Name formats

• Function name - MyFunction.
• Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction.
• Partial ARN - 123456789012:function:MyFunction.

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

The name of the alias.

The function version that the alias invokes.

The routing configuration of the alias.

The name of the alias.

The function version that the alias invokes.

The Amazon Resource Name (ARN) of the alias.

A description of the alias.

A unique identifier that changes when you update the alias.

Specify the pagination token that's returned by a previous request to retrieve the next page of results.

The maximum number of versions to return. Note that ListVersionsByFunction returns a maximum of 50 items in each response, even if you set the number higher.

The name of the Lambda function.

Name formats

• Function name - MyFunction.
• Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction.
• Partial ARN - 123456789012:function:MyFunction.

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

A list of Lambda function versions.

The pagination token that's included if more results are available.

The response's http status code.

Specify the pagination token that's returned by a previous request to retrieve the next page of results.

Limit the number of aliases returned.

Specify a function version to only list aliases that invoke that version.

The name of the Lambda function.

Name formats

• Function name - MyFunction.
• Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction.
• Partial ARN - 123456789012:function:MyFunction.

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

A list of aliases.

The pagination token that's included if more results are available.

The response's http status code.

The The Amazon Resource Name (ARN) of the code signing configuration.

The response's http status code.

Signing profiles for this code signing configuration.

The code signing policy.

Descriptive name for this code signing configuration.

The The Amazon Resource Name (ARN) of the code signing configuration.

The response's http status code.

The code signing configuration

Specify a version or alias to remove permissions from a published version of the function.

Only update the policy if the revision ID matches the ID that's specified. Use this option to avoid modifying a policy that has changed since you last read it.

The name of the Lambda function, version, or alias.

Name formats

• Function name - my-function (name-only), my-function:v1 (with alias).
• Function ARN - arn:aws:lambda:us-west-2:123456789012:function:my-function.
• Partial ARN - 123456789012:function:my-function.

You can append a version number or alias to any of the formats. The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

Statement ID of the permission to remove.

A version number or alias name.

The name of the Lambda function, version, or alias.

Name formats

• Function name - my-function (name-only), my-function:v1 (with alias).
• Function ARN - arn:aws:lambda:us-west-2:123456789012:function:my-function.
• Partial ARN - 123456789012:function:my-function.

You can append a version number or alias to any of the formats. The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

The maximum age of a request that Lambda sends to a function for processing.

The maximum number of times to retry when the function returns an error.

A version number or alias name.

A destination for events after they have been sent to a function for processing.

Destinations

• Function - The Amazon Resource Name (ARN) of a Lambda function.
• Queue - The ARN of an SQS queue.
• Topic - The ARN of an SNS topic.
• Event Bus - The ARN of an Amazon EventBridge event bus.

The name of the Lambda function, version, or alias.

Name formats

• Function name - my-function (name-only), my-function:v1 (with alias).
• Function ARN - arn:aws:lambda:us-west-2:123456789012:function:my-function.
• Partial ARN - 123456789012:function:my-function.

You can append a version number or alias to any of the formats. The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

The Amazon Resource Name (ARN) of the function.

The maximum age of a request that Lambda sends to a function for processing.

The maximum number of times to retry when the function returns an error.

The date and time that the configuration was last updated.

A destination for events after they have been sent to a function for processing.

Destinations

• Function - The Amazon Resource Name (ARN) of a Lambda function.
• Queue - The ARN of an SQS queue.
• Topic - The ARN of an SNS topic.
• Event Bus - The ARN of an Amazon EventBridge event bus.

The maximum age of a request that Lambda sends to a function for processing.

The maximum number of times to retry when the function returns an error.

A version number or alias name.

A destination for events after they have been sent to a function for processing.

Destinations

• Function - The Amazon Resource Name (ARN) of a Lambda function.
• Queue - The ARN of an SQS queue.
• Topic - The ARN of an SNS topic.
• Event Bus - The ARN of an Amazon EventBridge event bus.

The name of the Lambda function, version, or alias.

Name formats

• Function name - my-function (name-only), my-function:v1 (with alias).
• Function ARN - arn:aws:lambda:us-west-2:123456789012:function:my-function.
• Partial ARN - 123456789012:function:my-function.

You can append a version number or alias to any of the formats. The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

The Amazon Resource Name (ARN) of the function.

The maximum age of a request that Lambda sends to a function for processing.

The maximum number of times to retry when the function returns an error.

The date and time that the configuration was last updated.

A destination for events after they have been sent to a function for processing.

Destinations

• Function - The Amazon Resource Name (ARN) of a Lambda function.
• Queue - The ARN of an SQS queue.
• Topic - The ARN of an SNS topic.
• Event Bus - The ARN of an Amazon EventBridge event bus.

Choose from the following options.

• RequestResponse (default) - Invoke the function synchronously. Keep the connection open until the function returns a response or times out. The API response includes the function response and additional data.
• Event - Invoke the function asynchronously. Send events that fail multiple times to the function's dead-letter queue (if it's configured). The API response only includes a status code.
• DryRun - Validate parameter values and verify that the user or role has permission to invoke the function.

Set to Tail to include the execution log in the response. Applies to synchronously invoked functions only.

Specify a version or alias to invoke a published version of the function.

Up to 3583 bytes of base64-encoded data about the invoking client to pass to the function in the context object.

The name of the Lambda function, version, or alias.

Name formats

• Function name - my-function (name-only), my-function:v1 (with alias).
• Function ARN - arn:aws:lambda:us-west-2:123456789012:function:my-function.
• Partial ARN - 123456789012:function:my-function.

You can append a version number or alias to any of the formats. The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

The JSON that you want to provide to your Lambda function as input.

If present, indicates that an error occurred during function execution. Details about the error are included in the response payload.

The last 4 KB of the execution log, which is base64 encoded.

The response from the function, or an error object.

The version of the function that executed. When you invoke a function with an alias, this indicates which version the alias resolved to.

The HTTP status code is in the 200 range for a successful request. For the RequestResponse invocation type, this status code is 200. For the Event invocation type, this status code is 202. For the DryRun invocation type, the status code is 204.

The name or Amazon Resource Name (ARN) of the layer.

The version number.

The name of the Lambda function.

Name formats

• Function name - MyFunction.
• Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction.
• Partial ARN - 123456789012:function:MyFunction.

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

The name of the alias.

The routing configuration of the alias.

The name of the alias.

The function version that the alias invokes.

The Amazon Resource Name (ARN) of the alias.

A description of the alias.

A unique identifier that changes when you update the alias.

The layer's software license. It can be any of the following:

• An SPDX license identifier. For example, MIT.
• The URL of a license hosted on the internet. For example, https://opensource.org/licenses/MIT.
• The full text of the license.

A list of compatible instruction set architectures.

The description of the version.

A list of compatible function runtimes. Used for filtering with ListLayers and ListLayerVersions.

The name or Amazon Resource Name (ARN) of the layer.

The function layer archive.

The ARN of the layer version.

Details about the layer version.

The date that the layer version was created, in ISO-8601 format (YYYY-MM-DDThh:mm:ss.sTZD).

The version number.

The layer's software license.

A list of compatible instruction set architectures.

The ARN of the layer.

The description of the version.

The layer's compatible runtimes.

The response's http status code.

The identifier of the event source mapping.

The Amazon Resource Name (ARN) of the event source.

The state of the event source mapping. It can be one of the following: Creating, Enabling, Enabled, Disabling, Disabled, Updating, or Deleting.

With StartingPosition set to AT_TIMESTAMP, the time from which to start reading.

The ARN of the Lambda function.

The name of the Kafka topic.

(Amazon MQ) The name of the Amazon MQ broker destination queue to consume.

(Streams only) If the function returns an error, split the batch in two and retry. The default value is false.

The identifier of the event source mapping.

(Streams only) The number of batches to process concurrently from each shard. The default value is 1.

The result of the last Lambda invocation of your function.

(Streams only) Discard records after the specified number of retries. The default value is -1, which sets the maximum number of retries to infinite. When MaximumRetryAttempts is infinite, Lambda retries failed records until the record expires in the event source.

The maximum number of records in each batch that Lambda pulls from your stream or queue and sends to your function. Lambda passes all of the records in the batch to the function in a single call, up to the payload limit for synchronous invocation (6 MB).

Default value: Varies by service. For Amazon SQS, the default is 10. For all other services, the default is 100.

Related setting: When you set BatchSize to a value greater than 10, you must set MaximumBatchingWindowInSeconds to at least 1.

Indicates whether a user or Lambda made the last change to the event source mapping.

(Streams and Amazon SQS standard queues) The maximum amount of time, in seconds, that Lambda spends gathering records before invoking the function.

Default: 0

Related setting: When you set BatchSize to a value greater than 10, you must set MaximumBatchingWindowInSeconds to at least 1.

An array of the authentication protocol, VPC components, or virtual host to secure and define your event source.

(Streams only) Discard records older than the specified age. The default value is -1, which sets the maximum age to infinite. When the value is set to infinite, Lambda never discards old records.

(Streams only) A list of current response type enums applied to the event source mapping.

(Streams only) The duration in seconds of a processing window. The range is 1–900 seconds.

The self-managed Apache Kafka cluster for your event source.

The date that the event source mapping was last updated or that its state changed.

(Streams only) An Amazon SQS queue or Amazon SNS topic destination for discarded records.

The position in a stream from which to start reading. Required for Amazon Kinesis, Amazon DynamoDB, and Amazon MSK stream sources. AT_TIMESTAMP is supported only for Amazon Kinesis streams.

Only update the policy if the revision ID matches the ID specified. Use this option to avoid modifying a policy that has changed since you last read it.

With the principal set to *, grant permission to all accounts in the specified organization.

The name or Amazon Resource Name (ARN) of the layer.

The version number.

An identifier that distinguishes the policy from others on the same layer version.

The API action that grants access to the layer. For example, lambda:GetLayerVersion.

An account ID, or * to grant layer usage permission to all accounts in an organization, or all Amazon Web Services accounts (if organizationId is not specified). For the last case, make sure that you really do want all Amazon Web Services accounts to have usage permission to this layer.

The permission statement.

A unique identifier for the current revision of the policy.

The response's http status code.

Specify the pagination token that's returned by a previous request to retrieve the next page of results.

Specify a number to limit the number of configurations returned.

The name of the Lambda function.

Name formats

• Function name - my-function.
• Function ARN - arn:aws:lambda:us-west-2:123456789012:function:my-function.
• Partial ARN - 123456789012:function:my-function.

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

A list of provisioned concurrency configurations.

The pagination token that's included if more results are available.

The response's http status code.

The name of the Lambda function.

Name formats

• Function name - my-function.
• Function ARN - arn:aws:lambda:us-west-2:123456789012:function:my-function.
• Partial ARN - 123456789012:function:my-function.

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

The number of simultaneous executions to reserve for the function.

The number of concurrent executions that are reserved for this function. For more information, see Managing Concurrency.

The amount of memory available to the function at runtime. Increasing the function memory also increases its CPU allocation. The default value is 128 MB. The value can be any multiple of 1 MB.

The identifier of the function's runtime.

The ARN of the Amazon Web Services Key Management Service (KMS) key that's used to encrypt your function's environment variables. If it's not provided, Lambda uses a default service key.

The type of deployment package. Set to Image for container image and set Zip for ZIP archive.

Connection settings for an Amazon EFS file system.