ListFunctions
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
action returns a subset of the FunctionConfiguration fields.
To get the additional fields (State, StateReasonCode, StateReason, LastUpdateStatus,
LastUpdateStatusReason, LastUpdateStatusReasonCode)
for a function or version, use GetFunction.
Request Syntax
GET /2015-03-31/functions/?FunctionVersion=FunctionVersion
&Marker=Marker
&MasterRegion=MasterRegion
&MaxItems=MaxItems
HTTP/1.1
URI Request Parameters
The request uses the following URI parameters.
- FunctionVersion
-
Set to
ALL
to include entries for all published versions of each function.Valid Values:
ALL
- Marker
-
Specify the pagination token that's returned by a previous request to retrieve the next page of results.
- MasterRegion
-
For Lambda@Edge functions, the AWS Region of the master function. For example,
us-east-1
filters the list of functions to only include Lambda@Edge functions replicated from a master function in US East (N. Virginia). If specified, you must setFunctionVersion
toALL
.Pattern:
ALL|[a-z]{2}(-gov)?-[a-z]+-\d{1}
- MaxItems
-
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.Valid Range: Minimum value of 1. Maximum value of 10000.
Request Body
The request does not have a request body.
Response Syntax
HTTP/1.1 200
Content-type: application/json
{
"Functions": [
{
"CodeSha256": "string",
"CodeSize": number,
"DeadLetterConfig": {
"TargetArn": "string"
},
"Description": "string",
"Environment": {
"Error": {
"ErrorCode": "string",
"Message": "string"
},
"Variables": {
"string" : "string"
}
},
"FileSystemConfigs": [
{
"Arn": "string",
"LocalMountPath": "string"
}
],
"FunctionArn": "string",
"FunctionName": "string",
"Handler": "string",
"ImageConfigResponse": {
"Error": {
"ErrorCode": "string",
"Message": "string"
},
"ImageConfig": {
"Command": [ "string" ],
"EntryPoint": [ "string" ],
"WorkingDirectory": "string"
}
},
"KMSKeyArn": "string",
"LastModified": "string",
"LastUpdateStatus": "string",
"LastUpdateStatusReason": "string",
"LastUpdateStatusReasonCode": "string",
"Layers": [
{
"Arn": "string",
"CodeSize": number,
"SigningJobArn": "string",
"SigningProfileVersionArn": "string"
}
],
"MasterArn": "string",
"MemorySize": number,
"PackageType": "string",
"RevisionId": "string",
"Role": "string",
"Runtime": "string",
"SigningJobArn": "string",
"SigningProfileVersionArn": "string",
"State": "string",
"StateReason": "string",
"StateReasonCode": "string",
"Timeout": number,
"TracingConfig": {
"Mode": "string"
},
"Version": "string",
"VpcConfig": {
"SecurityGroupIds": [ "string" ],
"SubnetIds": [ "string" ],
"VpcId": "string"
}
}
],
"NextMarker": "string"
}
Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
- Functions
-
A list of Lambda functions.
Type: Array of FunctionConfiguration objects
- NextMarker
-
The pagination token that's included if more results are available.
Type: String
Errors
- InvalidParameterValueException
-
One of the parameters in the request is invalid.
HTTP Status Code: 400
- ServiceException
-
The AWS Lambda service encountered an internal error.
HTTP Status Code: 500
- TooManyRequestsException
-
The request throughput limit was exceeded.
HTTP Status Code: 429
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: