ListFunctionsCommand

Suggest an Edit

Returns a list of Lambda functions, with the version-specific configuration of each. Lambda returns up to 50 functions per call.

Set FunctionVersion to ALL to include all published versions of each function in addition to the unpublished version.

The ListFunctions operation returns a subset of the FunctionConfiguration fields. To get the additional fields (State, StateReasonCode, StateReason, LastUpdateStatus, LastUpdateStatusReason, LastUpdateStatusReasonCode, RuntimeVersionConfig) for a function or version, use GetFunction.

Example Syntax

Use a bare-bones client and the command you need to make an API call.

import { LambdaClient, ListFunctionsCommand } from "@aws-sdk/client-lambda"; // ES Modules import
// const { LambdaClient, ListFunctionsCommand } = require("@aws-sdk/client-lambda"); // CommonJS import
const client = new LambdaClient(config);
const input = { // ListFunctionsRequest
  MasterRegion: "STRING_VALUE",
  FunctionVersion: "ALL",
  Marker: "STRING_VALUE",
  MaxItems: Number("int"),
};
const command = new ListFunctionsCommand(input);
const response = await client.send(command);
// { // ListFunctionsResponse
//   NextMarker: "STRING_VALUE",
//   Functions: [ // FunctionList
//     { // FunctionConfiguration
//       FunctionName: "STRING_VALUE",
//       FunctionArn: "STRING_VALUE",
//       Runtime: "nodejs" || "nodejs4.3" || "nodejs6.10" || "nodejs8.10" || "nodejs10.x" || "nodejs12.x" || "nodejs14.x" || "nodejs16.x" || "java8" || "java8.al2" || "java11" || "python2.7" || "python3.6" || "python3.7" || "python3.8" || "python3.9" || "dotnetcore1.0" || "dotnetcore2.0" || "dotnetcore2.1" || "dotnetcore3.1" || "dotnet6" || "dotnet8" || "nodejs4.3-edge" || "go1.x" || "ruby2.5" || "ruby2.7" || "provided" || "provided.al2" || "nodejs18.x" || "python3.10" || "java17" || "ruby3.2" || "ruby3.3" || "ruby3.4" || "python3.11" || "nodejs20.x" || "provided.al2023" || "python3.12" || "java21" || "python3.13" || "nodejs22.x",
//       Role: "STRING_VALUE",
//       Handler: "STRING_VALUE",
//       CodeSize: Number("long"),
//       Description: "STRING_VALUE",
//       Timeout: Number("int"),
//       MemorySize: Number("int"),
//       LastModified: "STRING_VALUE",
//       CodeSha256: "STRING_VALUE",
//       Version: "STRING_VALUE",
//       VpcConfig: { // VpcConfigResponse
//         SubnetIds: [ // SubnetIds
//           "STRING_VALUE",
//         ],
//         SecurityGroupIds: [ // SecurityGroupIds
//           "STRING_VALUE",
//         ],
//         VpcId: "STRING_VALUE",
//         Ipv6AllowedForDualStack: true || false,
//       },
//       DeadLetterConfig: { // DeadLetterConfig
//         TargetArn: "STRING_VALUE",
//       },
//       Environment: { // EnvironmentResponse
//         Variables: { // EnvironmentVariables
//           "<keys>": "STRING_VALUE",
//         },
//         Error: { // EnvironmentError
//           ErrorCode: "STRING_VALUE",
//           Message: "STRING_VALUE",
//         },
//       },
//       KMSKeyArn: "STRING_VALUE",
//       TracingConfig: { // TracingConfigResponse
//         Mode: "Active" || "PassThrough",
//       },
//       MasterArn: "STRING_VALUE",
//       RevisionId: "STRING_VALUE",
//       Layers: [ // LayersReferenceList
//         { // Layer
//           Arn: "STRING_VALUE",
//           CodeSize: Number("long"),
//           SigningProfileVersionArn: "STRING_VALUE",
//           SigningJobArn: "STRING_VALUE",
//         },
//       ],
//       State: "Pending" || "Active" || "Inactive" || "Failed",
//       StateReason: "STRING_VALUE",
//       StateReasonCode: "Idle" || "Creating" || "Restoring" || "EniLimitExceeded" || "InsufficientRolePermissions" || "InvalidConfiguration" || "InternalError" || "SubnetOutOfIPAddresses" || "InvalidSubnet" || "InvalidSecurityGroup" || "ImageDeleted" || "ImageAccessDenied" || "InvalidImage" || "KMSKeyAccessDenied" || "KMSKeyNotFound" || "InvalidStateKMSKey" || "DisabledKMSKey" || "EFSIOError" || "EFSMountConnectivityError" || "EFSMountFailure" || "EFSMountTimeout" || "InvalidRuntime" || "InvalidZipFileException" || "FunctionError",
//       LastUpdateStatus: "Successful" || "Failed" || "InProgress",
//       LastUpdateStatusReason: "STRING_VALUE",
//       LastUpdateStatusReasonCode: "EniLimitExceeded" || "InsufficientRolePermissions" || "InvalidConfiguration" || "InternalError" || "SubnetOutOfIPAddresses" || "InvalidSubnet" || "InvalidSecurityGroup" || "ImageDeleted" || "ImageAccessDenied" || "InvalidImage" || "KMSKeyAccessDenied" || "KMSKeyNotFound" || "InvalidStateKMSKey" || "DisabledKMSKey" || "EFSIOError" || "EFSMountConnectivityError" || "EFSMountFailure" || "EFSMountTimeout" || "InvalidRuntime" || "InvalidZipFileException" || "FunctionError",
//       FileSystemConfigs: [ // FileSystemConfigList
//         { // FileSystemConfig
//           Arn: "STRING_VALUE", // required
//           LocalMountPath: "STRING_VALUE", // required
//         },
//       ],
//       PackageType: "Zip" || "Image",
//       ImageConfigResponse: { // ImageConfigResponse
//         ImageConfig: { // ImageConfig
//           EntryPoint: [ // StringList
//             "STRING_VALUE",
//           ],
//           Command: [
//             "STRING_VALUE",
//           ],
//           WorkingDirectory: "STRING_VALUE",
//         },
//         Error: { // ImageConfigError
//           ErrorCode: "STRING_VALUE",
//           Message: "STRING_VALUE",
//         },
//       },
//       SigningProfileVersionArn: "STRING_VALUE",
//       SigningJobArn: "STRING_VALUE",
//       Architectures: [ // ArchitecturesList
//         "x86_64" || "arm64",
//       ],
//       EphemeralStorage: { // EphemeralStorage
//         Size: Number("int"), // required
//       },
//       SnapStart: { // SnapStartResponse
//         ApplyOn: "PublishedVersions" || "None",
//         OptimizationStatus: "On" || "Off",
//       },
//       RuntimeVersionConfig: { // RuntimeVersionConfig
//         RuntimeVersionArn: "STRING_VALUE",
//         Error: { // RuntimeVersionError
//           ErrorCode: "STRING_VALUE",
//           Message: "STRING_VALUE",
//         },
//       },
//       LoggingConfig: { // LoggingConfig
//         LogFormat: "JSON" || "Text",
//         ApplicationLogLevel: "TRACE" || "DEBUG" || "INFO" || "WARN" || "ERROR" || "FATAL",
//         SystemLogLevel: "DEBUG" || "INFO" || "WARN",
//         LogGroup: "STRING_VALUE",
//       },
//     },
//   ],
// };

Example Usage

 There was an error loading the code editor. Retry

ListFunctionsCommand Input

See ListFunctionsCommandInput for more details

Parameter
Type
Description
FunctionVersion
FunctionVersion | undefined

Set to ALL to include entries for all published versions of each function.

Marker
string | undefined

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

MasterRegion
string | undefined

For LambdaEdge functions, the Amazon Web Services Region of the master function. For example, us-east-1 filters the list of functions to include only LambdaEdge functions replicated from a master function in US East (N. Virginia). If specified, you must set FunctionVersion to ALL.

MaxItems
number | undefined

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

ListFunctionsCommand Output

See ListFunctionsCommandOutput for details

Parameter
Type
Description
$metadata
Required
ResponseMetadata
Metadata pertaining to this request.
Functions
FunctionConfiguration[] | undefined

A list of Lambda functions.

NextMarker
string | undefined

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

Throws

Name
Fault
Details
InvalidParameterValueException
client

One of the parameters in the request is not valid.

ServiceException
server

The Lambda service encountered an internal error.

TooManyRequestsException
client

The request throughput limit was exceeded. For more information, see Lambda quotas .

LambdaServiceException
Base exception class for all service exceptions from Lambda service.