# Actions
<a name="API_Operations"></a>

The following actions are supported:
+  [AddLayerVersionPermission](API_AddLayerVersionPermission.md) 
+  [AddPermission](API_AddPermission.md) 
+  [CheckpointDurableExecution](API_CheckpointDurableExecution.md) 
+  [CreateAlias](API_CreateAlias.md) 
+  [CreateCapacityProvider](API_CreateCapacityProvider.md) 
+  [CreateCodeSigningConfig](API_CreateCodeSigningConfig.md) 
+  [CreateEventSourceMapping](API_CreateEventSourceMapping.md) 
+  [CreateFunction](API_CreateFunction.md) 
+  [CreateFunctionUrlConfig](API_CreateFunctionUrlConfig.md) 
+  [DeleteAlias](API_DeleteAlias.md) 
+  [DeleteCapacityProvider](API_DeleteCapacityProvider.md) 
+  [DeleteCodeSigningConfig](API_DeleteCodeSigningConfig.md) 
+  [DeleteEventSourceMapping](API_DeleteEventSourceMapping.md) 
+  [DeleteFunction](API_DeleteFunction.md) 
+  [DeleteFunctionCodeSigningConfig](API_DeleteFunctionCodeSigningConfig.md) 
+  [DeleteFunctionConcurrency](API_DeleteFunctionConcurrency.md) 
+  [DeleteFunctionEventInvokeConfig](API_DeleteFunctionEventInvokeConfig.md) 
+  [DeleteFunctionUrlConfig](API_DeleteFunctionUrlConfig.md) 
+  [DeleteLayerVersion](API_DeleteLayerVersion.md) 
+  [DeleteProvisionedConcurrencyConfig](API_DeleteProvisionedConcurrencyConfig.md) 
+  [GetAccountSettings](API_GetAccountSettings.md) 
+  [GetAlias](API_GetAlias.md) 
+  [GetCapacityProvider](API_GetCapacityProvider.md) 
+  [GetCodeSigningConfig](API_GetCodeSigningConfig.md) 
+  [GetDurableExecution](API_GetDurableExecution.md) 
+  [GetDurableExecutionHistory](API_GetDurableExecutionHistory.md) 
+  [GetDurableExecutionState](API_GetDurableExecutionState.md) 
+  [GetEventSourceMapping](API_GetEventSourceMapping.md) 
+  [GetFunction](API_GetFunction.md) 
+  [GetFunctionCodeSigningConfig](API_GetFunctionCodeSigningConfig.md) 
+  [GetFunctionConcurrency](API_GetFunctionConcurrency.md) 
+  [GetFunctionConfiguration](API_GetFunctionConfiguration.md) 
+  [GetFunctionEventInvokeConfig](API_GetFunctionEventInvokeConfig.md) 
+  [GetFunctionRecursionConfig](API_GetFunctionRecursionConfig.md) 
+  [GetFunctionScalingConfig](API_GetFunctionScalingConfig.md) 
+  [GetFunctionUrlConfig](API_GetFunctionUrlConfig.md) 
+  [GetLayerVersion](API_GetLayerVersion.md) 
+  [GetLayerVersionByArn](API_GetLayerVersionByArn.md) 
+  [GetLayerVersionPolicy](API_GetLayerVersionPolicy.md) 
+  [GetPolicy](API_GetPolicy.md) 
+  [GetProvisionedConcurrencyConfig](API_GetProvisionedConcurrencyConfig.md) 
+  [GetRuntimeManagementConfig](API_GetRuntimeManagementConfig.md) 
+  [Invoke](API_Invoke.md) 
+  [InvokeAsync](API_InvokeAsync.md) 
+  [InvokeWithResponseStream](API_InvokeWithResponseStream.md) 
+  [ListAliases](API_ListAliases.md) 
+  [ListCapacityProviders](API_ListCapacityProviders.md) 
+  [ListCodeSigningConfigs](API_ListCodeSigningConfigs.md) 
+  [ListDurableExecutionsByFunction](API_ListDurableExecutionsByFunction.md) 
+  [ListEventSourceMappings](API_ListEventSourceMappings.md) 
+  [ListFunctionEventInvokeConfigs](API_ListFunctionEventInvokeConfigs.md) 
+  [ListFunctions](API_ListFunctions.md) 
+  [ListFunctionsByCodeSigningConfig](API_ListFunctionsByCodeSigningConfig.md) 
+  [ListFunctionUrlConfigs](API_ListFunctionUrlConfigs.md) 
+  [ListFunctionVersionsByCapacityProvider](API_ListFunctionVersionsByCapacityProvider.md) 
+  [ListLayers](API_ListLayers.md) 
+  [ListLayerVersions](API_ListLayerVersions.md) 
+  [ListProvisionedConcurrencyConfigs](API_ListProvisionedConcurrencyConfigs.md) 
+  [ListTags](API_ListTags.md) 
+  [ListVersionsByFunction](API_ListVersionsByFunction.md) 
+  [PublishLayerVersion](API_PublishLayerVersion.md) 
+  [PublishVersion](API_PublishVersion.md) 
+  [PutFunctionCodeSigningConfig](API_PutFunctionCodeSigningConfig.md) 
+  [PutFunctionConcurrency](API_PutFunctionConcurrency.md) 
+  [PutFunctionEventInvokeConfig](API_PutFunctionEventInvokeConfig.md) 
+  [PutFunctionRecursionConfig](API_PutFunctionRecursionConfig.md) 
+  [PutFunctionScalingConfig](API_PutFunctionScalingConfig.md) 
+  [PutProvisionedConcurrencyConfig](API_PutProvisionedConcurrencyConfig.md) 
+  [PutRuntimeManagementConfig](API_PutRuntimeManagementConfig.md) 
+  [RemoveLayerVersionPermission](API_RemoveLayerVersionPermission.md) 
+  [RemovePermission](API_RemovePermission.md) 
+  [SendDurableExecutionCallbackFailure](API_SendDurableExecutionCallbackFailure.md) 
+  [SendDurableExecutionCallbackHeartbeat](API_SendDurableExecutionCallbackHeartbeat.md) 
+  [SendDurableExecutionCallbackSuccess](API_SendDurableExecutionCallbackSuccess.md) 
+  [StopDurableExecution](API_StopDurableExecution.md) 
+  [TagResource](API_TagResource.md) 
+  [UntagResource](API_UntagResource.md) 
+  [UpdateAlias](API_UpdateAlias.md) 
+  [UpdateCapacityProvider](API_UpdateCapacityProvider.md) 
+  [UpdateCodeSigningConfig](API_UpdateCodeSigningConfig.md) 
+  [UpdateEventSourceMapping](API_UpdateEventSourceMapping.md) 
+  [UpdateFunctionCode](API_UpdateFunctionCode.md) 
+  [UpdateFunctionConfiguration](API_UpdateFunctionConfiguration.md) 
+  [UpdateFunctionEventInvokeConfig](API_UpdateFunctionEventInvokeConfig.md) 
+  [UpdateFunctionUrlConfig](API_UpdateFunctionUrlConfig.md) 

# AddLayerVersionPermission
<a name="API_AddLayerVersionPermission"></a>

Adds permissions to the resource-based policy of a version of an [AWS Lambda layer](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html). Use this action to grant layer usage permission to other accounts. You can grant permission to a single account, all accounts in an organization, or all AWS accounts. 

To revoke permission, call [RemoveLayerVersionPermission](API_RemoveLayerVersionPermission.md) with the statement ID that you specified when you added it.

## Request Syntax
<a name="API_AddLayerVersionPermission_RequestSyntax"></a>

```
POST /2018-10-31/layers/LayerName/versions/VersionNumber/policy?RevisionId=RevisionId HTTP/1.1
Content-type: application/json

{
   "Action": "string",
   "OrganizationId": "string",
   "Principal": "string",
   "StatementId": "string"
}
```

## URI Request Parameters
<a name="API_AddLayerVersionPermission_RequestParameters"></a>

The request uses the following URI parameters.

 ** [LayerName](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-uri-LayerName"></a>
The name or Amazon Resource Name (ARN) of the layer.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+)|[a-zA-Z0-9-_]+`   
Required: Yes

 ** [RevisionId](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-uri-RevisionId"></a>
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.

 ** [VersionNumber](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-uri-VersionNumber"></a>
The version number.  
Required: Yes

## Request Body
<a name="API_AddLayerVersionPermission_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [Action](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-Action"></a>
The API action that grants access to the layer. For example, `lambda:GetLayerVersion`.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 22.  
Pattern: `lambda:GetLayerVersion`   
Required: Yes

 ** [OrganizationId](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-OrganizationId"></a>
With the principal set to `*`, grant permission to all accounts in the specified organization.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 34.  
Pattern: `o-[a-z0-9]{10,32}`   
Required: No

 ** [Principal](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-Principal"></a>
An account ID, or `*` to grant layer usage permission to all accounts in an organization, or all AWS accounts (if `organizationId` is not specified). For the last case, make sure that you really do want all AWS accounts to have usage permission to this layer.   
Type: String  
Pattern: `\d{12}|\*|arn:(aws[a-zA-Z-]*):iam::\d{12}:root`   
Required: Yes

 ** [StatementId](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-StatementId"></a>
An identifier that distinguishes the policy from others on the same layer version.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 100.  
Pattern: `([a-zA-Z0-9-_]+)`   
Required: Yes

## Response Syntax
<a name="API_AddLayerVersionPermission_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "RevisionId": "string",
   "Statement": "string"
}
```

## Response Elements
<a name="API_AddLayerVersionPermission_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 201 response.

The following data is returned in JSON format by the service.

 ** [RevisionId](#API_AddLayerVersionPermission_ResponseSyntax) **   <a name="lambda-AddLayerVersionPermission-response-RevisionId"></a>
A unique identifier for the current revision of the policy.  
Type: String

 ** [Statement](#API_AddLayerVersionPermission_ResponseSyntax) **   <a name="lambda-AddLayerVersionPermission-response-Statement"></a>
The permission statement.  
Type: String

## Errors
<a name="API_AddLayerVersionPermission_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** PolicyLengthExceededException **   
The permissions policy for the resource is too large. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html).  
HTTP Status Code: 400

 ** PreconditionFailedException **   
The RevisionId provided does not match the latest RevisionId for the Lambda function or alias.  
+  **For AddPermission and RemovePermission API operations:** Call `GetPolicy` to retrieve the latest RevisionId for your resource.
+  **For all other API operations:** Call `GetFunction` or `GetAlias` to retrieve the latest RevisionId for your resource.  
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 412

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_AddLayerVersionPermission_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/AddLayerVersionPermission) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/AddLayerVersionPermission) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/AddLayerVersionPermission) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/AddLayerVersionPermission) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/AddLayerVersionPermission) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/AddLayerVersionPermission) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/AddLayerVersionPermission) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/AddLayerVersionPermission) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/AddLayerVersionPermission) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/AddLayerVersionPermission) 

# AddPermission
<a name="API_AddPermission"></a>

Grants a [principal](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html#Principal_specifying) permission to use a function. You can apply the policy at the function level, or specify a qualifier to restrict access to a single version or alias. If you use a qualifier, the invoker must use the full Amazon Resource Name (ARN) of that version or alias to invoke the function. Note: Lambda does not support adding policies to version \$1LATEST.

To grant permission to another account, specify the account ID as the `Principal`. To grant permission to an organization defined in AWS Organizations, specify the organization ID as the `PrincipalOrgID`. For AWS services, the principal is a domain-style identifier that the service defines, such as `s3.amazonaws.com` or `sns.amazonaws.com`. For AWS services, you can also specify the ARN of the associated resource as the `SourceArn`. If you grant permission to a service principal without specifying the source, other accounts could potentially configure resources in their account to invoke your Lambda function.

This operation adds a statement to a resource-based permissions policy for the function. For more information about function policies, see [Using resource-based policies for Lambda](https://docs.aws.amazon.com/lambda/latest/dg/access-control-resource-based.html).

## Request Syntax
<a name="API_AddPermission_RequestSyntax"></a>

```
POST /2015-03-31/functions/FunctionName/policy?Qualifier=Qualifier HTTP/1.1
Content-type: application/json

{
   "Action": "string",
   "EventSourceToken": "string",
   "FunctionUrlAuthType": "string",
   "InvokedViaFunctionUrl": boolean,
   "Principal": "string",
   "PrincipalOrgID": "string",
   "RevisionId": "string",
   "SourceAccount": "string",
   "SourceArn": "string",
   "StatementId": "string"
}
```

## URI Request Parameters
<a name="API_AddPermission_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_AddPermission_RequestSyntax) **   <a name="lambda-AddPermission-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?`   
Required: Yes

 ** [Qualifier](#API_AddPermission_RequestSyntax) **   <a name="lambda-AddPermission-request-uri-Qualifier"></a>
Specify a version or alias to add permissions to a published version of the function.  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `\$(LATEST(\.PUBLISHED)?)|[a-zA-Z0-9-_$]+` 

## Request Body
<a name="API_AddPermission_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [Action](#API_AddPermission_RequestSyntax) **   <a name="lambda-AddPermission-request-Action"></a>
The action that the principal can use on the function. For example, `lambda:InvokeFunction` or `lambda:GetFunction`.  
Type: String  
Pattern: `(lambda:[*]|lambda:[a-zA-Z]+|[*])`   
Required: Yes

 ** [EventSourceToken](#API_AddPermission_RequestSyntax) **   <a name="lambda-AddPermission-request-EventSourceToken"></a>
For Alexa Smart Home functions, a token that the invoker must supply.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 256.  
Pattern: `[a-zA-Z0-9._\-]+`   
Required: No

 ** [FunctionUrlAuthType](#API_AddPermission_RequestSyntax) **   <a name="lambda-AddPermission-request-FunctionUrlAuthType"></a>
The type of authentication that your function URL uses. Set to `AWS_IAM` if you want to restrict access to authenticated users only. Set to `NONE` if you want to bypass IAM authentication to create a public endpoint. For more information, see [Control access to Lambda function URLs](https://docs.aws.amazon.com/lambda/latest/dg/urls-auth.html).  
Type: String  
Valid Values: `NONE | AWS_IAM`   
Required: No

 ** [InvokedViaFunctionUrl](#API_AddPermission_RequestSyntax) **   <a name="lambda-AddPermission-request-InvokedViaFunctionUrl"></a>
Indicates whether the permission applies when the function is invoked through a function URL.   
Type: Boolean  
Required: No

 ** [Principal](#API_AddPermission_RequestSyntax) **   <a name="lambda-AddPermission-request-Principal"></a>
The AWS service, AWS account, IAM user, or IAM role that invokes the function. If you specify a service, use `SourceArn` or `SourceAccount` to limit who can invoke the function through that service.  
Type: String  
Pattern: `[^\s]+`   
Required: Yes

 ** [PrincipalOrgID](#API_AddPermission_RequestSyntax) **   <a name="lambda-AddPermission-request-PrincipalOrgID"></a>
The identifier for your organization in AWS Organizations. Use this to grant permissions to all the AWS accounts under this organization.  
Type: String  
Length Constraints: Minimum length of 12. Maximum length of 34.  
Pattern: `o-[a-z0-9]{10,32}`   
Required: No

 ** [RevisionId](#API_AddPermission_RequestSyntax) **   <a name="lambda-AddPermission-request-RevisionId"></a>
Update the policy only 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.  
Type: String  
Required: No

 ** [SourceAccount](#API_AddPermission_RequestSyntax) **   <a name="lambda-AddPermission-request-SourceAccount"></a>
For AWS service, the ID of the AWS account that owns the resource. Use this together with `SourceArn` to ensure that the specified account owns the resource. It is possible for an Amazon S3 bucket to be deleted by its owner and recreated by another account.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 12.  
Pattern: `\d{12}`   
Required: No

 ** [SourceArn](#API_AddPermission_RequestSyntax) **   <a name="lambda-AddPermission-request-SourceArn"></a>
For AWS services, the ARN of the AWS resource that invokes the function. For example, an Amazon S3 bucket or Amazon SNS topic.  
Note that Lambda configures the comparison using the `StringLike` operator.  
Type: String  
Pattern: `arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)`   
Required: No

 ** [StatementId](#API_AddPermission_RequestSyntax) **   <a name="lambda-AddPermission-request-StatementId"></a>
A statement identifier that differentiates the statement from others in the same policy.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 100.  
Pattern: `([a-zA-Z0-9-_]+)`   
Required: Yes

## Response Syntax
<a name="API_AddPermission_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "Statement": "string"
}
```

## Response Elements
<a name="API_AddPermission_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 201 response.

The following data is returned in JSON format by the service.

 ** [Statement](#API_AddPermission_ResponseSyntax) **   <a name="lambda-AddPermission-response-Statement"></a>
The permission statement that's added to the function policy.  
Type: String

## Errors
<a name="API_AddPermission_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** PolicyLengthExceededException **   
The permissions policy for the resource is too large. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html).  
HTTP Status Code: 400

 ** PreconditionFailedException **   
The RevisionId provided does not match the latest RevisionId for the Lambda function or alias.  
+  **For AddPermission and RemovePermission API operations:** Call `GetPolicy` to retrieve the latest RevisionId for your resource.
+  **For all other API operations:** Call `GetFunction` or `GetAlias` to retrieve the latest RevisionId for your resource.  
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 412

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_AddPermission_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/AddPermission) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/AddPermission) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/AddPermission) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/AddPermission) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/AddPermission) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/AddPermission) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/AddPermission) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/AddPermission) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/AddPermission) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/AddPermission) 

# CheckpointDurableExecution
<a name="API_CheckpointDurableExecution"></a>

Saves the progress of a [durable function](https://docs.aws.amazon.com/lambda/latest/dg/durable-functions.html) execution during runtime. This API is used by the Lambda durable functions SDK to checkpoint completed steps and schedule asynchronous operations. You typically don't need to call this API directly as the SDK handles checkpointing automatically.

Each checkpoint operation consumes the current checkpoint token and returns a new one for the next checkpoint. This ensures that checkpoints are applied in the correct order and prevents duplicate or out-of-order state updates.

## Request Syntax
<a name="API_CheckpointDurableExecution_RequestSyntax"></a>

```
POST /2025-12-01/durable-executions/DurableExecutionArn/checkpoint HTTP/1.1
Content-type: application/json

{
   "CheckpointToken": "string",
   "ClientToken": "string",
   "Updates": [ 
      { 
         "Action": "string",
         "CallbackOptions": { 
            "HeartbeatTimeoutSeconds": number,
            "TimeoutSeconds": number
         },
         "ChainedInvokeOptions": { 
            "FunctionName": "string",
            "TenantId": "string"
         },
         "ContextOptions": { 
            "ReplayChildren": boolean
         },
         "Error": { 
            "ErrorData": "string",
            "ErrorMessage": "string",
            "ErrorType": "string",
            "StackTrace": [ "string" ]
         },
         "Id": "string",
         "Name": "string",
         "ParentId": "string",
         "Payload": "string",
         "StepOptions": { 
            "NextAttemptDelaySeconds": number
         },
         "SubType": "string",
         "Type": "string",
         "WaitOptions": { 
            "WaitSeconds": number
         }
      }
   ]
}
```

## URI Request Parameters
<a name="API_CheckpointDurableExecution_RequestParameters"></a>

The request uses the following URI parameters.

 ** [DurableExecutionArn](#API_CheckpointDurableExecution_RequestSyntax) **   <a name="lambda-CheckpointDurableExecution-request-uri-DurableExecutionArn"></a>
The Amazon Resource Name (ARN) of the durable execution.  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Pattern: `arn:([a-zA-Z0-9-]+):lambda:([a-zA-Z0-9-]+):(\d{12}):function:([a-zA-Z0-9_-]+):(\$LATEST(?:\.PUBLISHED)?|[0-9]+)/durable-execution/([a-zA-Z0-9_-]+)/([a-zA-Z0-9_-]+)`   
Required: Yes

## Request Body
<a name="API_CheckpointDurableExecution_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [CheckpointToken](#API_CheckpointDurableExecution_RequestSyntax) **   <a name="lambda-CheckpointDurableExecution-request-CheckpointToken"></a>
A unique token that identifies the current checkpoint state. This token is provided by the Lambda runtime and must be used to ensure checkpoints are applied in the correct order. Each checkpoint operation consumes this token and returns a new one.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 2048.  
Pattern: `[A-Za-z0-9+/]+={0,2}`   
Required: Yes

 ** [ClientToken](#API_CheckpointDurableExecution_RequestSyntax) **   <a name="lambda-CheckpointDurableExecution-request-ClientToken"></a>
An optional idempotency token to ensure that duplicate checkpoint requests are handled correctly. If provided, Lambda uses this token to detect and handle duplicate requests within a 15-minute window.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 64.  
Pattern: `[\x21-\x7E]+`   
Required: No

 ** [Updates](#API_CheckpointDurableExecution_RequestSyntax) **   <a name="lambda-CheckpointDurableExecution-request-Updates"></a>
An array of state updates to apply during this checkpoint. Each update represents a change to the execution state, such as completing a step, starting a callback, or scheduling a timer. Updates are applied atomically as part of the checkpoint operation.  
Type: Array of [OperationUpdate](API_OperationUpdate.md) objects  
Required: No

## Response Syntax
<a name="API_CheckpointDurableExecution_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CheckpointToken": "string",
   "NewExecutionState": { 
      "NextMarker": "string",
      "Operations": [ 
         { 
            "CallbackDetails": { 
               "CallbackId": "string",
               "Error": { 
                  "ErrorData": "string",
                  "ErrorMessage": "string",
                  "ErrorType": "string",
                  "StackTrace": [ "string" ]
               },
               "Result": "string"
            },
            "ChainedInvokeDetails": { 
               "Error": { 
                  "ErrorData": "string",
                  "ErrorMessage": "string",
                  "ErrorType": "string",
                  "StackTrace": [ "string" ]
               },
               "Result": "string"
            },
            "ContextDetails": { 
               "Error": { 
                  "ErrorData": "string",
                  "ErrorMessage": "string",
                  "ErrorType": "string",
                  "StackTrace": [ "string" ]
               },
               "ReplayChildren": boolean,
               "Result": "string"
            },
            "EndTimestamp": number,
            "ExecutionDetails": { 
               "InputPayload": "string"
            },
            "Id": "string",
            "Name": "string",
            "ParentId": "string",
            "StartTimestamp": number,
            "Status": "string",
            "StepDetails": { 
               "Attempt": number,
               "Error": { 
                  "ErrorData": "string",
                  "ErrorMessage": "string",
                  "ErrorType": "string",
                  "StackTrace": [ "string" ]
               },
               "NextAttemptTimestamp": number,
               "Result": "string"
            },
            "SubType": "string",
            "Type": "string",
            "WaitDetails": { 
               "ScheduledEndTimestamp": number
            }
         }
      ]
   }
}
```

## Response Elements
<a name="API_CheckpointDurableExecution_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [CheckpointToken](#API_CheckpointDurableExecution_ResponseSyntax) **   <a name="lambda-CheckpointDurableExecution-response-CheckpointToken"></a>
A new checkpoint token to use for the next checkpoint operation. This token replaces the one provided in the request and must be used for subsequent checkpoints to maintain proper ordering.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 2048.  
Pattern: `[A-Za-z0-9+/]+={0,2}` 

 ** [NewExecutionState](#API_CheckpointDurableExecution_ResponseSyntax) **   <a name="lambda-CheckpointDurableExecution-response-NewExecutionState"></a>
Updated execution state information that includes any changes that occurred since the last checkpoint, such as completed callbacks or expired timers. This allows the SDK to update its internal state during replay.  
Type: [CheckpointUpdatedExecutionState](API_CheckpointUpdatedExecutionState.md) object

## Errors
<a name="API_CheckpointDurableExecution_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_CheckpointDurableExecution_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/CheckpointDurableExecution) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/CheckpointDurableExecution) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/CheckpointDurableExecution) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/CheckpointDurableExecution) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/CheckpointDurableExecution) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/CheckpointDurableExecution) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/CheckpointDurableExecution) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/CheckpointDurableExecution) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/CheckpointDurableExecution) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/CheckpointDurableExecution) 

# CreateAlias
<a name="API_CreateAlias"></a>

Creates an [alias](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html) for a Lambda function version. Use aliases to provide clients with a function identifier that you can update to invoke a different version.

You can also map an alias to split invocation requests between two versions. Use the `RoutingConfig` parameter to specify a second version and the percentage of invocation requests that it receives.

## Request Syntax
<a name="API_CreateAlias_RequestSyntax"></a>

```
POST /2015-03-31/functions/FunctionName/aliases HTTP/1.1
Content-type: application/json

{
   "Description": "string",
   "FunctionVersion": "string",
   "Name": "string",
   "RoutingConfig": { 
      "AdditionalVersionWeights": { 
         "string" : number 
      }
   }
}
```

## URI Request Parameters
<a name="API_CreateAlias_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?`   
Required: Yes

## Request Body
<a name="API_CreateAlias_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [Description](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-Description"></a>
A description of the alias.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 256.  
Required: No

 ** [FunctionVersion](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-FunctionVersion"></a>
The function version that the alias invokes.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Pattern: `(\$LATEST(\.PUBLISHED)?|[0-9]+)`   
Required: Yes

 ** [Name](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-Name"></a>
The name of the alias.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `(?!^[0-9]+$)([a-zA-Z0-9-_]+)`   
Required: Yes

 ** [RoutingConfig](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-RoutingConfig"></a>
The [routing configuration](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html#configuring-alias-routing) of the alias.  
Type: [AliasRoutingConfiguration](API_AliasRoutingConfiguration.md) object  
Required: No

## Response Syntax
<a name="API_CreateAlias_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "AliasArn": "string",
   "Description": "string",
   "FunctionVersion": "string",
   "Name": "string",
   "RevisionId": "string",
   "RoutingConfig": { 
      "AdditionalVersionWeights": { 
         "string" : number 
      }
   }
}
```

## Response Elements
<a name="API_CreateAlias_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 201 response.

The following data is returned in JSON format by the service.

 ** [AliasArn](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-AliasArn"></a>
The Amazon Resource Name (ARN) of the alias.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 10000.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?` 

 ** [Description](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-Description"></a>
A description of the alias.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 256.

 ** [FunctionVersion](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-FunctionVersion"></a>
The function version that the alias invokes.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Pattern: `(\$LATEST|[0-9]+)` 

 ** [Name](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-Name"></a>
The name of the alias.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `(?!^[0-9]+$)([a-zA-Z0-9-_]+)` 

 ** [RevisionId](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-RevisionId"></a>
A unique identifier that changes when you update the alias.  
Type: String

 ** [RoutingConfig](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-RoutingConfig"></a>
The [routing configuration](https://docs.aws.amazon.com/lambda/latest/dg/lambda-traffic-shifting-using-aliases.html) of the alias.  
Type: [AliasRoutingConfiguration](API_AliasRoutingConfiguration.md) object

## Errors
<a name="API_CreateAlias_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_CreateAlias_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/CreateAlias) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/CreateAlias) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/CreateAlias) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/CreateAlias) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/CreateAlias) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/CreateAlias) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/CreateAlias) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/CreateAlias) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/CreateAlias) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/CreateAlias) 

# CreateCapacityProvider
<a name="API_CreateCapacityProvider"></a>

Creates a capacity provider that manages compute resources for Lambda functions

## Request Syntax
<a name="API_CreateCapacityProvider_RequestSyntax"></a>

```
POST /2025-11-30/capacity-providers HTTP/1.1
Content-type: application/json

{
   "CapacityProviderName": "string",
   "CapacityProviderScalingConfig": { 
      "MaxVCpuCount": number,
      "ScalingMode": "string",
      "ScalingPolicies": [ 
         { 
            "PredefinedMetricType": "string",
            "TargetValue": number
         }
      ]
   },
   "InstanceRequirements": { 
      "AllowedInstanceTypes": [ "string" ],
      "Architectures": [ "string" ],
      "ExcludedInstanceTypes": [ "string" ]
   },
   "KmsKeyArn": "string",
   "PermissionsConfig": { 
      "CapacityProviderOperatorRoleArn": "string"
   },
   "Tags": { 
      "string" : "string" 
   },
   "VpcConfig": { 
      "SecurityGroupIds": [ "string" ],
      "SubnetIds": [ "string" ]
   }
}
```

## URI Request Parameters
<a name="API_CreateCapacityProvider_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_CreateCapacityProvider_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [CapacityProviderName](#API_CreateCapacityProvider_RequestSyntax) **   <a name="lambda-CreateCapacityProvider-request-CapacityProviderName"></a>
The name of the capacity provider.   
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:aws[a-zA-Z-]*:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:capacity-provider:[a-zA-Z0-9-_]+)|[a-zA-Z0-9-_]+`   
Required: Yes

 ** [CapacityProviderScalingConfig](#API_CreateCapacityProvider_RequestSyntax) **   <a name="lambda-CreateCapacityProvider-request-CapacityProviderScalingConfig"></a>
The scaling configuration that defines how the capacity provider scales compute instances, including maximum vCPU count and scaling policies.  
Type: [CapacityProviderScalingConfig](API_CapacityProviderScalingConfig.md) object  
Required: No

 ** [InstanceRequirements](#API_CreateCapacityProvider_RequestSyntax) **   <a name="lambda-CreateCapacityProvider-request-InstanceRequirements"></a>
The instance requirements that specify the compute instance characteristics, including architectures and allowed or excluded instance types.  
Type: [InstanceRequirements](API_InstanceRequirements.md) object  
Required: No

 ** [KmsKeyArn](#API_CreateCapacityProvider_RequestSyntax) **   <a name="lambda-CreateCapacityProvider-request-KmsKeyArn"></a>
The ARN of the KMS key used to encrypt data associated with the capacity provider.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 10000.  
Pattern: `arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*`   
Required: No

 ** [PermissionsConfig](#API_CreateCapacityProvider_RequestSyntax) **   <a name="lambda-CreateCapacityProvider-request-PermissionsConfig"></a>
The permissions configuration that specifies the IAM role ARN used by the capacity provider to manage compute resources.  
Type: [CapacityProviderPermissionsConfig](API_CapacityProviderPermissionsConfig.md) object  
Required: Yes

 ** [Tags](#API_CreateCapacityProvider_RequestSyntax) **   <a name="lambda-CreateCapacityProvider-request-Tags"></a>
A list of tags to associate with the capacity provider.  
Type: String to string map  
Required: No

 ** [VpcConfig](#API_CreateCapacityProvider_RequestSyntax) **   <a name="lambda-CreateCapacityProvider-request-VpcConfig"></a>
The VPC configuration for the capacity provider, including subnet IDs and security group IDs where compute instances will be launched.  
Type: [CapacityProviderVpcConfig](API_CapacityProviderVpcConfig.md) object  
Required: Yes

## Response Syntax
<a name="API_CreateCapacityProvider_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "CapacityProvider": { 
      "CapacityProviderArn": "string",
      "CapacityProviderScalingConfig": { 
         "MaxVCpuCount": number,
         "ScalingMode": "string",
         "ScalingPolicies": [ 
            { 
               "PredefinedMetricType": "string",
               "TargetValue": number
            }
         ]
      },
      "InstanceRequirements": { 
         "AllowedInstanceTypes": [ "string" ],
         "Architectures": [ "string" ],
         "ExcludedInstanceTypes": [ "string" ]
      },
      "KmsKeyArn": "string",
      "LastModified": "string",
      "PermissionsConfig": { 
         "CapacityProviderOperatorRoleArn": "string"
      },
      "State": "string",
      "VpcConfig": { 
         "SecurityGroupIds": [ "string" ],
         "SubnetIds": [ "string" ]
      }
   }
}
```

## Response Elements
<a name="API_CreateCapacityProvider_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [CapacityProvider](#API_CreateCapacityProvider_ResponseSyntax) **   <a name="lambda-CreateCapacityProvider-response-CapacityProvider"></a>
Information about the capacity provider that was created.  
Type: [CapacityProvider](API_CapacityProvider.md) object

## Errors
<a name="API_CreateCapacityProvider_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** CapacityProviderLimitExceededException **   
The maximum number of capacity providers for your account has been exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html)     
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_CreateCapacityProvider_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/CreateCapacityProvider) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/CreateCapacityProvider) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/CreateCapacityProvider) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/CreateCapacityProvider) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/CreateCapacityProvider) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/CreateCapacityProvider) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/CreateCapacityProvider) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/CreateCapacityProvider) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/CreateCapacityProvider) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/CreateCapacityProvider) 

# CreateCodeSigningConfig
<a name="API_CreateCodeSigningConfig"></a>

Creates a code signing configuration. A [code signing configuration](https://docs.aws.amazon.com/lambda/latest/dg/configuration-codesigning.html) defines a list of allowed signing profiles and defines the code-signing validation policy (action to be taken if deployment validation checks fail). 

## Request Syntax
<a name="API_CreateCodeSigningConfig_RequestSyntax"></a>

```
POST /2020-04-22/code-signing-configs HTTP/1.1
Content-type: application/json

{
   "AllowedPublishers": { 
      "SigningProfileVersionArns": [ "string" ]
   },
   "CodeSigningPolicies": { 
      "UntrustedArtifactOnDeployment": "string"
   },
   "Description": "string",
   "Tags": { 
      "string" : "string" 
   }
}
```

## URI Request Parameters
<a name="API_CreateCodeSigningConfig_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_CreateCodeSigningConfig_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [AllowedPublishers](#API_CreateCodeSigningConfig_RequestSyntax) **   <a name="lambda-CreateCodeSigningConfig-request-AllowedPublishers"></a>
Signing profiles for this code signing configuration.  
Type: [AllowedPublishers](API_AllowedPublishers.md) object  
Required: Yes

 ** [CodeSigningPolicies](#API_CreateCodeSigningConfig_RequestSyntax) **   <a name="lambda-CreateCodeSigningConfig-request-CodeSigningPolicies"></a>
The code signing policies define the actions to take if the validation checks fail.   
Type: [CodeSigningPolicies](API_CodeSigningPolicies.md) object  
Required: No

 ** [Description](#API_CreateCodeSigningConfig_RequestSyntax) **   <a name="lambda-CreateCodeSigningConfig-request-Description"></a>
Descriptive name for this code signing configuration.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 256.  
Required: No

 ** [Tags](#API_CreateCodeSigningConfig_RequestSyntax) **   <a name="lambda-CreateCodeSigningConfig-request-Tags"></a>
A list of tags to add to the code signing configuration.  
Type: String to string map  
Required: No

## Response Syntax
<a name="API_CreateCodeSigningConfig_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "CodeSigningConfig": { 
      "AllowedPublishers": { 
         "SigningProfileVersionArns": [ "string" ]
      },
      "CodeSigningConfigArn": "string",
      "CodeSigningConfigId": "string",
      "CodeSigningPolicies": { 
         "UntrustedArtifactOnDeployment": "string"
      },
      "Description": "string",
      "LastModified": "string"
   }
}
```

## Response Elements
<a name="API_CreateCodeSigningConfig_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 201 response.

The following data is returned in JSON format by the service.

 ** [CodeSigningConfig](#API_CreateCodeSigningConfig_ResponseSyntax) **   <a name="lambda-CreateCodeSigningConfig-response-CodeSigningConfig"></a>
The code signing configuration.  
Type: [CodeSigningConfig](API_CodeSigningConfig.md) object

## Errors
<a name="API_CreateCodeSigningConfig_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

## See Also
<a name="API_CreateCodeSigningConfig_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/CreateCodeSigningConfig) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/CreateCodeSigningConfig) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/CreateCodeSigningConfig) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/CreateCodeSigningConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/CreateCodeSigningConfig) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/CreateCodeSigningConfig) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/CreateCodeSigningConfig) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/CreateCodeSigningConfig) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/CreateCodeSigningConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/CreateCodeSigningConfig) 

# CreateEventSourceMapping
<a name="API_CreateEventSourceMapping"></a>

Creates a mapping between an event source and an AWS Lambda function. Lambda reads items from the event source and invokes the function.

For details about how to configure different event sources, see the following topics. 
+  [ Amazon DynamoDB Streams](https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html#services-dynamodb-eventsourcemapping) 
+  [ Amazon Kinesis](https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html#services-kinesis-eventsourcemapping) 
+  [ Amazon SQS](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#events-sqs-eventsource) 
+  [ Amazon MQ and RabbitMQ](https://docs.aws.amazon.com/lambda/latest/dg/with-mq.html#services-mq-eventsourcemapping) 
+  [ Amazon MSK](https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html) 
+  [ Apache Kafka](https://docs.aws.amazon.com/lambda/latest/dg/kafka-smaa.html) 
+  [ Amazon DocumentDB](https://docs.aws.amazon.com/lambda/latest/dg/with-documentdb.html) 

The following error handling options are available for stream sources (DynamoDB, Kinesis, Amazon MSK, and self-managed Apache Kafka):
+  `BisectBatchOnFunctionError` – If the function returns an error, split the batch in two and retry.
+  `MaximumRecordAgeInSeconds` – Discard records older than the specified age. The default value is infinite (-1). When set to infinite (-1), failed records are retried until the record expires
+  `MaximumRetryAttempts` – Discard records after the specified number of retries. The default value is infinite (-1). When set to infinite (-1), failed records are retried until the record expires.
+  `OnFailure` – Send discarded records to an Amazon SQS queue, Amazon SNS topic, Kafka topic, or Amazon S3 bucket. For more information, see [Adding a destination](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async-retain-records.html#invocation-async-destinations).

The following option is available only for DynamoDB and Kinesis event sources:
+  `ParallelizationFactor` – Process multiple batches from each shard concurrently.

For information about which configuration parameters apply to each event source, see the following topics.
+  [ Amazon DynamoDB Streams](https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html#services-ddb-params) 
+  [ Amazon Kinesis](https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html#services-kinesis-params) 
+  [ Amazon SQS](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#services-sqs-params) 
+  [ Amazon MQ and RabbitMQ](https://docs.aws.amazon.com/lambda/latest/dg/with-mq.html#services-mq-params) 
+  [ Amazon MSK](https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html#services-msk-parms) 
+  [ Apache Kafka](https://docs.aws.amazon.com/lambda/latest/dg/with-kafka.html#services-kafka-parms) 
+  [ Amazon DocumentDB](https://docs.aws.amazon.com/lambda/latest/dg/with-documentdb.html#docdb-configuration) 

## Request Syntax
<a name="API_CreateEventSourceMapping_RequestSyntax"></a>

```
POST /2015-03-31/event-source-mappings HTTP/1.1
Content-type: application/json

{
   "AmazonManagedKafkaEventSourceConfig": { 
      "ConsumerGroupId": "string",
      "SchemaRegistryConfig": { 
         "AccessConfigs": [ 
            { 
               "Type": "string",
               "URI": "string"
            }
         ],
         "EventRecordFormat": "string",
         "SchemaRegistryURI": "string",
         "SchemaValidationConfigs": [ 
            { 
               "Attribute": "string"
            }
         ]
      }
   },
   "BatchSize": number,
   "BisectBatchOnFunctionError": boolean,
   "DestinationConfig": { 
      "OnFailure": { 
         "Destination": "string"
      },
      "OnSuccess": { 
         "Destination": "string"
      }
   },
   "DocumentDBEventSourceConfig": { 
      "CollectionName": "string",
      "DatabaseName": "string",
      "FullDocument": "string"
   },
   "Enabled": boolean,
   "EventSourceArn": "string",
   "FilterCriteria": { 
      "Filters": [ 
         { 
            "Pattern": "string"
         }
      ]
   },
   "FunctionName": "string",
   "FunctionResponseTypes": [ "string" ],
   "KMSKeyArn": "string",
   "LoggingConfig": { 
      "SystemLogLevel": "string"
   },
   "MaximumBatchingWindowInSeconds": number,
   "MaximumRecordAgeInSeconds": number,
   "MaximumRetryAttempts": number,
   "MetricsConfig": { 
      "Metrics": [ "string" ]
   },
   "ParallelizationFactor": number,
   "ProvisionedPollerConfig": { 
      "MaximumPollers": number,
      "MinimumPollers": number,
      "PollerGroupName": "string"
   },
   "Queues": [ "string" ],
   "ScalingConfig": { 
      "MaximumConcurrency": number
   },
   "SelfManagedEventSource": { 
      "Endpoints": { 
         "string" : [ "string" ]
      }
   },
   "SelfManagedKafkaEventSourceConfig": { 
      "ConsumerGroupId": "string",
      "SchemaRegistryConfig": { 
         "AccessConfigs": [ 
            { 
               "Type": "string",
               "URI": "string"
            }
         ],
         "EventRecordFormat": "string",
         "SchemaRegistryURI": "string",
         "SchemaValidationConfigs": [ 
            { 
               "Attribute": "string"
            }
         ]
      }
   },
   "SourceAccessConfigurations": [ 
      { 
         "Type": "string",
         "URI": "string"
      }
   ],
   "StartingPosition": "string",
   "StartingPositionTimestamp": number,
   "Tags": { 
      "string" : "string" 
   },
   "Topics": [ "string" ],
   "TumblingWindowInSeconds": number
}
```

## URI Request Parameters
<a name="API_CreateEventSourceMapping_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_CreateEventSourceMapping_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [AmazonManagedKafkaEventSourceConfig](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-AmazonManagedKafkaEventSourceConfig"></a>
Specific configuration settings for an Amazon Managed Streaming for Apache Kafka (Amazon MSK) event source.  
Type: [AmazonManagedKafkaEventSourceConfig](API_AmazonManagedKafkaEventSourceConfig.md) object  
Required: No

 ** [BatchSize](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-BatchSize"></a>
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 10,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.
+  **Amazon MQ (ActiveMQ and RabbitMQ)** – Default 100. Max 10,000.
+  **DocumentDB** – Default 100. Max 10,000.
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 10000.  
Required: No

 ** [BisectBatchOnFunctionError](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-BisectBatchOnFunctionError"></a>
(Kinesis, DynamoDB Streams, Amazon MSK, and self-managed Apache Kafka) If the function returns an error, split the batch in two and retry.  
Type: Boolean  
Required: No

 ** [DestinationConfig](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-DestinationConfig"></a>
(Kinesis, DynamoDB Streams, Amazon MSK, and self-managed Apache Kafka) A configuration object that specifies the destination of an event after Lambda processes it.  
Type: [DestinationConfig](API_DestinationConfig.md) object  
Required: No

 ** [DocumentDBEventSourceConfig](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-DocumentDBEventSourceConfig"></a>
Specific configuration settings for a DocumentDB event source.  
Type: [DocumentDBEventSourceConfig](API_DocumentDBEventSourceConfig.md) object  
Required: No

 ** [Enabled](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-Enabled"></a>
When true, the event source mapping is active. When false, Lambda pauses polling and invocation.  
Default: True  
Type: Boolean  
Required: No

 ** [EventSourceArn](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-EventSourceArn"></a>
The Amazon Resource Name (ARN) of the event source.  
+  **Amazon Kinesis** – The ARN of the data stream or a stream consumer.
+  **Amazon DynamoDB Streams** – The ARN of the stream.
+  **Amazon Simple Queue Service** – The ARN of the queue.
+  **Amazon Managed Streaming for Apache Kafka** – The ARN of the cluster or the ARN of the VPC connection (for [cross-account event source mappings](https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html#msk-multi-vpc)).
+  **Amazon MQ** – The ARN of the broker.
+  **Amazon DocumentDB** – The ARN of the DocumentDB change stream.
Type: String  
Pattern: `arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)`   
Required: No

 ** [FilterCriteria](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-FilterCriteria"></a>
An object that defines the filter criteria that determine whether Lambda should process an event. For more information, see [Lambda event filtering](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html).  
Type: [FilterCriteria](API_FilterCriteria.md) object  
Required: No

 ** [FunctionName](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-FunctionName"></a>
The name or ARN 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.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?`   
Required: Yes

 ** [FunctionResponseTypes](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-FunctionResponseTypes"></a>
(Kinesis, DynamoDB Streams, Amazon MSK, self-managed Apache Kafka, and Amazon SQS) A list of current response type enums applied to the event source mapping.  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 1 item.  
Valid Values: `ReportBatchItemFailures`   
Required: No

 ** [KMSKeyArn](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-KMSKeyArn"></a>
 The ARN of the AWS Key Management Service (AWS KMS) customer managed key that Lambda uses to encrypt your function's [filter criteria](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html#filtering-basics). By default, Lambda does not encrypt your filter criteria object. Specify this property to encrypt data using your own customer managed key.   
Type: String  
Pattern: `(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()`   
Required: No

 ** [LoggingConfig](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-LoggingConfig"></a>
(Amazon MSK, and self-managed Apache Kafka only) The logging configuration for your event source. For more information, see [Event source mapping logging](https://docs.aws.amazon.com/lambda/latest/dg/esm-logging.html).  
Type: [EventSourceMappingLoggingConfig](API_EventSourceMappingLoggingConfig.md) object  
Required: No

 ** [MaximumBatchingWindowInSeconds](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-MaximumBatchingWindowInSeconds"></a>
The maximum amount of time, in seconds, that Lambda spends gathering records before invoking the function. You can configure `MaximumBatchingWindowInSeconds` to any value from 0 seconds to 300 seconds in increments of seconds.  
For Kinesis, DynamoDB, and Amazon SQS event sources, the default batching window is 0 seconds. For Amazon MSK, Self-managed Apache Kafka, Amazon MQ, and DocumentDB event sources, the default batching window is 500 ms. Note that because you can only change `MaximumBatchingWindowInSeconds` in increments of seconds, you cannot revert back to the 500 ms default batching window after you have changed it. To restore the default batching window, you must create a new event source mapping.  
Related setting: For Kinesis, DynamoDB, and Amazon SQS event sources, when you set `BatchSize` to a value greater than 10, you must set `MaximumBatchingWindowInSeconds` to at least 1.  
Type: Integer  
Valid Range: Minimum value of 0. Maximum value of 300.  
Required: No

 ** [MaximumRecordAgeInSeconds](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-MaximumRecordAgeInSeconds"></a>
(Kinesis, DynamoDB Streams, Amazon MSK, and self-managed Apache Kafka) Discard records older than the specified age. The default value is infinite (-1).  
Type: Integer  
Valid Range: Minimum value of -1. Maximum value of 604800.  
Required: No

 ** [MaximumRetryAttempts](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-MaximumRetryAttempts"></a>
(Kinesis, DynamoDB Streams, Amazon MSK, and self-managed Apache Kafka) Discard records after the specified number of retries. The default value is infinite (-1). When set to infinite (-1), failed records are retried until the record expires.  
Type: Integer  
Valid Range: Minimum value of -1. Maximum value of 10000.  
Required: No

 ** [MetricsConfig](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-MetricsConfig"></a>
The metrics configuration for your event source. For more information, see [Event source mapping metrics](https://docs.aws.amazon.com/lambda/latest/dg/monitoring-metrics-types.html#event-source-mapping-metrics).  
Type: [EventSourceMappingMetricsConfig](API_EventSourceMappingMetricsConfig.md) object  
Required: No

 ** [ParallelizationFactor](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-ParallelizationFactor"></a>
(Kinesis and DynamoDB Streams only) The number of batches to process from each shard concurrently.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 10.  
Required: No

 ** [ProvisionedPollerConfig](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-ProvisionedPollerConfig"></a>
(Amazon SQS, Amazon MSK, and self-managed Apache Kafka only) The provisioned mode configuration for the event source. For more information, see [provisioned mode](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventsourcemapping.html#invocation-eventsourcemapping-provisioned-mode).  
Type: [ProvisionedPollerConfig](API_ProvisionedPollerConfig.md) object  
Required: No

 ** [Queues](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-Queues"></a>
 (MQ) The name of the Amazon MQ broker destination queue to consume.   
Type: Array of strings  
Array Members: Fixed number of 1 item.  
Length Constraints: Minimum length of 1. Maximum length of 1000.  
Pattern: `[\s\S]*`   
Required: No

 ** [ScalingConfig](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-ScalingConfig"></a>
(Amazon SQS only) The scaling configuration for the event source. For more information, see [Configuring maximum concurrency for Amazon SQS event sources](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#events-sqs-max-concurrency).  
Type: [ScalingConfig](API_ScalingConfig.md) object  
Required: No

 ** [SelfManagedEventSource](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-SelfManagedEventSource"></a>
The self-managed Apache Kafka cluster to receive records from.  
Type: [SelfManagedEventSource](API_SelfManagedEventSource.md) object  
Required: No

 ** [SelfManagedKafkaEventSourceConfig](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-SelfManagedKafkaEventSourceConfig"></a>
Specific configuration settings for a self-managed Apache Kafka event source.  
Type: [SelfManagedKafkaEventSourceConfig](API_SelfManagedKafkaEventSourceConfig.md) object  
Required: No

 ** [SourceAccessConfigurations](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-SourceAccessConfigurations"></a>
An array of authentication protocols or VPC components required to secure your event source.  
Type: Array of [SourceAccessConfiguration](API_SourceAccessConfiguration.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 22 items.  
Required: No

 ** [StartingPosition](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-StartingPosition"></a>
The position in a stream from which to start reading. Required for Amazon Kinesis and Amazon DynamoDB Stream event sources. `AT_TIMESTAMP` is supported only for Amazon Kinesis streams, Amazon DocumentDB, Amazon MSK, and self-managed Apache Kafka.  
Type: String  
Valid Values: `TRIM_HORIZON | LATEST | AT_TIMESTAMP`   
Required: No

 ** [StartingPositionTimestamp](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-StartingPositionTimestamp"></a>
With `StartingPosition` set to `AT_TIMESTAMP`, the time from which to start reading, in Unix time seconds. `StartingPositionTimestamp` cannot be in the future.  
Type: Timestamp  
Required: No

 ** [Tags](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-Tags"></a>
A list of tags to apply to the event source mapping.  
Type: String to string map  
Required: No

 ** [Topics](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-Topics"></a>
The name of the Kafka topic.  
Type: Array of strings  
Array Members: Fixed number of 1 item.  
Length Constraints: Minimum length of 1. Maximum length of 249.  
Pattern: `[^.]([a-zA-Z0-9\-_.]+)`   
Required: No

 ** [TumblingWindowInSeconds](#API_CreateEventSourceMapping_RequestSyntax) **   <a name="lambda-CreateEventSourceMapping-request-TumblingWindowInSeconds"></a>
(Kinesis and DynamoDB Streams only) The duration in seconds of a processing window for DynamoDB and Kinesis Streams event sources. A value of 0 seconds indicates no tumbling window.  
Type: Integer  
Valid Range: Minimum value of 0. Maximum value of 900.  
Required: No

## Response Syntax
<a name="API_CreateEventSourceMapping_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "AmazonManagedKafkaEventSourceConfig": { 
      "ConsumerGroupId": "string",
      "SchemaRegistryConfig": { 
         "AccessConfigs": [ 
            { 
               "Type": "string",
               "URI": "string"
            }
         ],
         "EventRecordFormat": "string",
         "SchemaRegistryURI": "string",
         "SchemaValidationConfigs": [ 
            { 
               "Attribute": "string"
            }
         ]
      }
   },
   "BatchSize": number,
   "BisectBatchOnFunctionError": boolean,
   "DestinationConfig": { 
      "OnFailure": { 
         "Destination": "string"
      },
      "OnSuccess": { 
         "Destination": "string"
      }
   },
   "DocumentDBEventSourceConfig": { 
      "CollectionName": "string",
      "DatabaseName": "string",
      "FullDocument": "string"
   },
   "EventSourceArn": "string",
   "EventSourceMappingArn": "string",
   "FilterCriteria": { 
      "Filters": [ 
         { 
            "Pattern": "string"
         }
      ]
   },
   "FilterCriteriaError": { 
      "ErrorCode": "string",
      "Message": "string"
   },
   "FunctionArn": "string",
   "FunctionResponseTypes": [ "string" ],
   "KMSKeyArn": "string",
   "LastModified": number,
   "LastProcessingResult": "string",
   "LoggingConfig": { 
      "SystemLogLevel": "string"
   },
   "MaximumBatchingWindowInSeconds": number,
   "MaximumRecordAgeInSeconds": number,
   "MaximumRetryAttempts": number,
   "MetricsConfig": { 
      "Metrics": [ "string" ]
   },
   "ParallelizationFactor": number,
   "ProvisionedPollerConfig": { 
      "MaximumPollers": number,
      "MinimumPollers": number,
      "PollerGroupName": "string"
   },
   "Queues": [ "string" ],
   "ScalingConfig": { 
      "MaximumConcurrency": number
   },
   "SelfManagedEventSource": { 
      "Endpoints": { 
         "string" : [ "string" ]
      }
   },
   "SelfManagedKafkaEventSourceConfig": { 
      "ConsumerGroupId": "string",
      "SchemaRegistryConfig": { 
         "AccessConfigs": [ 
            { 
               "Type": "string",
               "URI": "string"
            }
         ],
         "EventRecordFormat": "string",
         "SchemaRegistryURI": "string",
         "SchemaValidationConfigs": [ 
            { 
               "Attribute": "string"
            }
         ]
      }
   },
   "SourceAccessConfigurations": [ 
      { 
         "Type": "string",
         "URI": "string"
      }
   ],
   "StartingPosition": "string",
   "StartingPositionTimestamp": number,
   "State": "string",
   "StateTransitionReason": "string",
   "Topics": [ "string" ],
   "TumblingWindowInSeconds": number,
   "UUID": "string"
}
```

## Response Elements
<a name="API_CreateEventSourceMapping_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [AmazonManagedKafkaEventSourceConfig](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-AmazonManagedKafkaEventSourceConfig"></a>
Specific configuration settings for an Amazon Managed Streaming for Apache Kafka (Amazon MSK) event source.  
Type: [AmazonManagedKafkaEventSourceConfig](API_AmazonManagedKafkaEventSourceConfig.md) object

 ** [BatchSize](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-BatchSize"></a>
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.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 10000.

 ** [BisectBatchOnFunctionError](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-BisectBatchOnFunctionError"></a>
(Kinesis, DynamoDB Streams, Amazon MSK, and self-managed Apache Kafka) If the function returns an error, split the batch in two and retry. The default value is false.  
Type: Boolean

 ** [DestinationConfig](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-DestinationConfig"></a>
(Kinesis, DynamoDB Streams, Amazon MSK, and self-managed Apache Kafka) A configuration object that specifies the destination of an event after Lambda processes it.  
Type: [DestinationConfig](API_DestinationConfig.md) object

 ** [DocumentDBEventSourceConfig](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-DocumentDBEventSourceConfig"></a>
Specific configuration settings for a DocumentDB event source.  
Type: [DocumentDBEventSourceConfig](API_DocumentDBEventSourceConfig.md) object

 ** [EventSourceArn](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-EventSourceArn"></a>
The Amazon Resource Name (ARN) of the event source.  
Type: String  
Pattern: `arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` 

 ** [EventSourceMappingArn](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-EventSourceMappingArn"></a>
The Amazon Resource Name (ARN) of the event source mapping.  
Type: String  
Length Constraints: Minimum length of 85. Maximum length of 120.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:event-source-mapping:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}` 

 ** [FilterCriteria](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-FilterCriteria"></a>
An object that defines the filter criteria that determine whether Lambda should process an event. For more information, see [Lambda event filtering](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html).  
If filter criteria is encrypted, this field shows up as `null` in the response of ListEventSourceMapping API calls. You can view this field in plaintext in the response of GetEventSourceMapping and DeleteEventSourceMapping calls if you have `kms:Decrypt` permissions for the correct AWS KMS key.  
Type: [FilterCriteria](API_FilterCriteria.md) object

 ** [FilterCriteriaError](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-FilterCriteriaError"></a>
An object that contains details about an error related to filter criteria encryption.  
Type: [FilterCriteriaError](API_FilterCriteriaError.md) object

 ** [FunctionArn](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-FunctionArn"></a>
The ARN of the Lambda function.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 10000.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?` 

 ** [FunctionResponseTypes](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-FunctionResponseTypes"></a>
(Kinesis, DynamoDB Streams, Amazon MSK, self-managed Apache Kafka, and Amazon SQS) A list of current response type enums applied to the event source mapping.  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 1 item.  
Valid Values: `ReportBatchItemFailures` 

 ** [KMSKeyArn](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-KMSKeyArn"></a>
 The ARN of the AWS Key Management Service (AWS KMS) customer managed key that Lambda uses to encrypt your function's [filter criteria](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html#filtering-basics).  
Type: String  
Pattern: `(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()` 

 ** [LastModified](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-LastModified"></a>
The date that the event source mapping was last updated or that its state changed, in Unix time seconds.  
Type: Timestamp

 ** [LastProcessingResult](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-LastProcessingResult"></a>
The result of the event source mapping's last processing attempt.  
Type: String

 ** [LoggingConfig](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-LoggingConfig"></a>
(Amazon MSK, and self-managed Apache Kafka only) The logging configuration for your event source. For more information, see [Event source mapping logging](https://docs.aws.amazon.com/lambda/latest/dg/esm-logging.html).  
Type: [EventSourceMappingLoggingConfig](API_EventSourceMappingLoggingConfig.md) object

 ** [MaximumBatchingWindowInSeconds](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-MaximumBatchingWindowInSeconds"></a>
The maximum amount of time, in seconds, that Lambda spends gathering records before invoking the function. You can configure `MaximumBatchingWindowInSeconds` to any value from 0 seconds to 300 seconds in increments of seconds.  
For streams and Amazon SQS event sources, the default batching window is 0 seconds. For Amazon MSK, Self-managed Apache Kafka, Amazon MQ, and DocumentDB event sources, the default batching window is 500 ms. Note that because you can only change `MaximumBatchingWindowInSeconds` in increments of seconds, you cannot revert back to the 500 ms default batching window after you have changed it. To restore the default batching window, you must create a new event source mapping.  
Related setting: For streams and Amazon SQS event sources, when you set `BatchSize` to a value greater than 10, you must set `MaximumBatchingWindowInSeconds` to at least 1.  
Type: Integer  
Valid Range: Minimum value of 0. Maximum value of 300.

 ** [MaximumRecordAgeInSeconds](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-MaximumRecordAgeInSeconds"></a>
(Kinesis, DynamoDB Streams, Amazon MSK, and self-managed Apache Kafka) 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.  
The minimum valid value for maximum record age is 60s. Although values less than 60 and greater than -1 fall within the parameter's absolute range, they are not allowed
Type: Integer  
Valid Range: Minimum value of -1. Maximum value of 604800.

 ** [MaximumRetryAttempts](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-MaximumRetryAttempts"></a>
(Kinesis, DynamoDB Streams, Amazon MSK, and self-managed Apache Kafka) 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.  
Type: Integer  
Valid Range: Minimum value of -1. Maximum value of 10000.

 ** [MetricsConfig](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-MetricsConfig"></a>
The metrics configuration for your event source. For more information, see [Event source mapping metrics](https://docs.aws.amazon.com/lambda/latest/dg/monitoring-metrics-types.html#event-source-mapping-metrics).  
Type: [EventSourceMappingMetricsConfig](API_EventSourceMappingMetricsConfig.md) object

 ** [ParallelizationFactor](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-ParallelizationFactor"></a>
(Kinesis and DynamoDB Streams only) The number of batches to process concurrently from each shard. The default value is 1.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 10.

 ** [ProvisionedPollerConfig](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-ProvisionedPollerConfig"></a>
(Amazon SQS, Amazon MSK, and self-managed Apache Kafka only) The provisioned mode configuration for the event source. For more information, see [provisioned mode](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventsourcemapping.html#invocation-eventsourcemapping-provisioned-mode).  
Type: [ProvisionedPollerConfig](API_ProvisionedPollerConfig.md) object

 ** [Queues](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-Queues"></a>
 (Amazon MQ) The name of the Amazon MQ broker destination queue to consume.  
Type: Array of strings  
Array Members: Fixed number of 1 item.  
Length Constraints: Minimum length of 1. Maximum length of 1000.  
Pattern: `[\s\S]*` 

 ** [ScalingConfig](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-ScalingConfig"></a>
(Amazon SQS only) The scaling configuration for the event source. For more information, see [Configuring maximum concurrency for Amazon SQS event sources](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#events-sqs-max-concurrency).  
Type: [ScalingConfig](API_ScalingConfig.md) object

 ** [SelfManagedEventSource](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-SelfManagedEventSource"></a>
The self-managed Apache Kafka cluster for your event source.  
Type: [SelfManagedEventSource](API_SelfManagedEventSource.md) object

 ** [SelfManagedKafkaEventSourceConfig](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-SelfManagedKafkaEventSourceConfig"></a>
Specific configuration settings for a self-managed Apache Kafka event source.  
Type: [SelfManagedKafkaEventSourceConfig](API_SelfManagedKafkaEventSourceConfig.md) object

 ** [SourceAccessConfigurations](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-SourceAccessConfigurations"></a>
An array of the authentication protocol, VPC components, or virtual host to secure and define your event source.  
Type: Array of [SourceAccessConfiguration](API_SourceAccessConfiguration.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 22 items.

 ** [StartingPosition](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-StartingPosition"></a>
The position in a stream from which to start reading. Required for Amazon Kinesis and Amazon DynamoDB Stream event sources. `AT_TIMESTAMP` is supported only for Amazon Kinesis streams, Amazon DocumentDB, Amazon MSK, and self-managed Apache Kafka.  
Type: String  
Valid Values: `TRIM_HORIZON | LATEST | AT_TIMESTAMP` 

 ** [StartingPositionTimestamp](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-StartingPositionTimestamp"></a>
With `StartingPosition` set to `AT_TIMESTAMP`, the time from which to start reading, in Unix time seconds. `StartingPositionTimestamp` cannot be in the future.  
Type: Timestamp

 ** [State](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-State"></a>
The state of the event source mapping. It can be one of the following: `Creating`, `Enabling`, `Enabled`, `Disabling`, `Disabled`, `Updating`, or `Deleting`.  
Type: String

 ** [StateTransitionReason](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-StateTransitionReason"></a>
Indicates whether a user or Lambda made the last change to the event source mapping.  
Type: String

 ** [Topics](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-Topics"></a>
The name of the Kafka topic.  
Type: Array of strings  
Array Members: Fixed number of 1 item.  
Length Constraints: Minimum length of 1. Maximum length of 249.  
Pattern: `[^.]([a-zA-Z0-9\-_.]+)` 

 ** [TumblingWindowInSeconds](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-TumblingWindowInSeconds"></a>
(Kinesis and DynamoDB Streams only) The duration in seconds of a processing window for DynamoDB and Kinesis Streams event sources. A value of 0 seconds indicates no tumbling window.  
Type: Integer  
Valid Range: Minimum value of 0. Maximum value of 900.

 ** [UUID](#API_CreateEventSourceMapping_ResponseSyntax) **   <a name="lambda-CreateEventSourceMapping-response-UUID"></a>
The identifier of the event source mapping.  
Type: String

## Errors
<a name="API_CreateEventSourceMapping_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_CreateEventSourceMapping_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/CreateEventSourceMapping) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/CreateEventSourceMapping) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/CreateEventSourceMapping) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/CreateEventSourceMapping) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/CreateEventSourceMapping) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/CreateEventSourceMapping) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/CreateEventSourceMapping) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/CreateEventSourceMapping) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/CreateEventSourceMapping) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/CreateEventSourceMapping) 

# CreateFunction
<a name="API_CreateFunction"></a>

Creates a Lambda function. To create a function, you need a [deployment package](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-package.html) and an [execution role](https://docs.aws.amazon.com/lambda/latest/dg/intro-permission-model.html#lambda-intro-execution-role). The deployment package is a .zip file archive or container image that contains your function code. The execution role grants the function permission to use AWS services, such as Amazon CloudWatch Logs for log streaming and AWS X-Ray for request tracing.

If the deployment package is a [container image](https://docs.aws.amazon.com/lambda/latest/dg/lambda-images.html), then you set the package type to `Image`. For a container image, the code property must include the URI of a container image in the Amazon ECR registry. You do not need to specify the handler and runtime properties.

If the deployment package is a [.zip file archive](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-package.html#gettingstarted-package-zip), then you set the package type to `Zip`. For a .zip file archive, the code property specifies the location of the .zip file. You must also specify the handler and runtime properties. The code in the deployment package must be compatible with the target instruction set architecture of the function (`x86-64` or `arm64`). If you do not specify the architecture, then the default value is `x86-64`.

When you create a function, Lambda provisions an instance of the function and its supporting resources. If your function connects to a VPC, this process can take a minute or so. During this time, you can't invoke or modify the function. The `State`, `StateReason`, and `StateReasonCode` fields in the response from [GetFunctionConfiguration](API_GetFunctionConfiguration.md) indicate when the function is ready to invoke. For more information, see [Lambda function states](https://docs.aws.amazon.com/lambda/latest/dg/functions-states.html).

A function has an unpublished version, and can have published versions and aliases. The unpublished version changes when you update your function's code and configuration. A published version is a snapshot of your function code and configuration that can't be changed. An alias is a named resource that maps to a version, and can be changed to map to a different version. Use the `Publish` parameter to create version `1` of your function from its initial configuration.

The other parameters let you configure version-specific and function-level settings. You can modify version-specific settings later with [UpdateFunctionConfiguration](API_UpdateFunctionConfiguration.md). Function-level settings apply to both the unpublished and published versions of the function, and include tags ([TagResource](API_TagResource.md)) and per-function concurrency limits ([PutFunctionConcurrency](API_PutFunctionConcurrency.md)).

You can use code signing if your deployment package is a .zip file archive. To enable code signing for this function, specify the ARN of a code-signing configuration. When a user attempts to deploy a code package with [UpdateFunctionCode](API_UpdateFunctionCode.md), Lambda checks that the code package has a valid signature from a trusted publisher. The code-signing configuration includes set of signing profiles, which define the trusted publishers for this function.

If another AWS account or an AWS service invokes your function, use [AddPermission](API_AddPermission.md) to grant permission by creating a resource-based AWS Identity and Access Management (IAM) policy. You can grant permissions at the function level, on a version, or on an alias.

To invoke your function directly, use [Invoke](API_Invoke.md). To invoke your function in response to events in other AWS services, create an event source mapping ([CreateEventSourceMapping](API_CreateEventSourceMapping.md)), or configure a function trigger in the other service. For more information, see [Invoking Lambda functions](https://docs.aws.amazon.com/lambda/latest/dg/lambda-invocation.html).

## Request Syntax
<a name="API_CreateFunction_RequestSyntax"></a>

```
POST /2015-03-31/functions HTTP/1.1
Content-type: application/json

{
   "Architectures": [ "string" ],
   "CapacityProviderConfig": { 
      "LambdaManagedInstancesCapacityProviderConfig": { 
         "CapacityProviderArn": "string",
         "ExecutionEnvironmentMemoryGiBPerVCpu": number,
         "PerExecutionEnvironmentMaxConcurrency": number
      }
   },
   "Code": { 
      "ImageUri": "string",
      "S3Bucket": "string",
      "S3Key": "string",
      "S3ObjectVersion": "string",
      "SourceKMSKeyArn": "string",
      "ZipFile": blob
   },
   "CodeSigningConfigArn": "string",
   "DeadLetterConfig": { 
      "TargetArn": "string"
   },
   "Description": "string",
   "DurableConfig": { 
      "ExecutionTimeout": number,
      "RetentionPeriodInDays": number
   },
   "Environment": { 
      "Variables": { 
         "string" : "string" 
      }
   },
   "EphemeralStorage": { 
      "Size": number
   },
   "FileSystemConfigs": [ 
      { 
         "Arn": "string",
         "LocalMountPath": "string"
      }
   ],
   "FunctionName": "string",
   "Handler": "string",
   "ImageConfig": { 
      "Command": [ "string" ],
      "EntryPoint": [ "string" ],
      "WorkingDirectory": "string"
   },
   "KMSKeyArn": "string",
   "Layers": [ "string" ],
   "LoggingConfig": { 
      "ApplicationLogLevel": "string",
      "LogFormat": "string",
      "LogGroup": "string",
      "SystemLogLevel": "string"
   },
   "MemorySize": number,
   "PackageType": "string",
   "Publish": boolean,
   "PublishTo": "string",
   "Role": "string",
   "Runtime": "string",
   "SnapStart": { 
      "ApplyOn": "string"
   },
   "Tags": { 
      "string" : "string" 
   },
   "TenancyConfig": { 
      "TenantIsolationMode": "string"
   },
   "Timeout": number,
   "TracingConfig": { 
      "Mode": "string"
   },
   "VpcConfig": { 
      "Ipv6AllowedForDualStack": boolean,
      "SecurityGroupIds": [ "string" ],
      "SubnetIds": [ "string" ]
   }
}
```

## URI Request Parameters
<a name="API_CreateFunction_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_CreateFunction_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [Architectures](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Architectures"></a>
The instruction set architecture that the function supports. Enter a string array with one of the valid values (arm64 or x86\$164). The default value is `x86_64`.  
Type: Array of strings  
Array Members: Fixed number of 1 item.  
Valid Values: `x86_64 | arm64`   
Required: No

 ** [CapacityProviderConfig](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-CapacityProviderConfig"></a>
Configuration for the capacity provider that manages compute resources for Lambda functions.  
Type: [CapacityProviderConfig](API_CapacityProviderConfig.md) object  
Required: No

 ** [Code](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Code"></a>
The code for the function.  
Type: [FunctionCode](API_FunctionCode.md) object  
Required: Yes

 ** [CodeSigningConfigArn](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-CodeSigningConfigArn"></a>
To enable code signing for this function, specify the ARN of a code-signing configuration. A code-signing configuration includes a set of signing profiles, which define the trusted publishers for this function.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 200.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}:\d{12}:code-signing-config:csc-[a-z0-9]{17}`   
Required: No

 ** [DeadLetterConfig](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-DeadLetterConfig"></a>
A dead-letter queue configuration that specifies the queue or topic where Lambda sends asynchronous events when they fail processing. For more information, see [Dead-letter queues](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-dlq).  
Type: [DeadLetterConfig](API_DeadLetterConfig.md) object  
Required: No

 ** [Description](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Description"></a>
A description of the function.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 256.  
Required: No

 ** [DurableConfig](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-DurableConfig"></a>
Configuration settings for durable functions. Enables creating functions with durability that can remember their state and continue execution even after interruptions.  
Type: [DurableConfig](API_DurableConfig.md) object  
Required: No

 ** [Environment](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Environment"></a>
Environment variables that are accessible from function code during execution.  
Type: [Environment](API_Environment.md) object  
Required: No

 ** [EphemeralStorage](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-EphemeralStorage"></a>
The size of the function's `/tmp` directory in MB. The default value is 512, but can be any whole number between 512 and 10,240 MB. For more information, see [Configuring ephemeral storage (console)](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-ephemeral-storage).  
Type: [EphemeralStorage](API_EphemeralStorage.md) object  
Required: No

 ** [FileSystemConfigs](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-FileSystemConfigs"></a>
Connection settings for an Amazon EFS file system or an Amazon S3 Files file system.  
Type: Array of [FileSystemConfig](API_FileSystemConfig.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 1 item.  
Required: No

 ** [FunctionName](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-FunctionName"></a>
The name or ARN 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.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?`   
Required: Yes

 ** [Handler](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Handler"></a>
The name of the method within your code that Lambda calls to run your function. Handler is required if the deployment package is a .zip file archive. The format includes the file name. It can also include namespaces and other qualifiers, depending on the runtime. For more information, see [Lambda programming model](https://docs.aws.amazon.com/lambda/latest/dg/foundation-progmodel.html).  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 128.  
Pattern: `[^\s]+`   
Required: No

 ** [ImageConfig](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-ImageConfig"></a>
Container image [configuration values](https://docs.aws.amazon.com/lambda/latest/dg/images-create.html#images-parms) that override the values in the container image Dockerfile.  
Type: [ImageConfig](API_ImageConfig.md) object  
Required: No

 ** [KMSKeyArn](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-KMSKeyArn"></a>
The ARN of the AWS Key Management Service (AWS KMS) customer managed key that's used to encrypt the following resources:  
+ The function's [environment variables](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html#configuration-envvars-encryption).
+ The function's [Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart-security.html) snapshots.
+ When used with `SourceKMSKeyArn`, the unzipped version of the .zip deployment package that's used for function invocations. For more information, see [ Specifying a customer managed key for Lambda](https://docs.aws.amazon.com/lambda/latest/dg/encrypt-zip-package.html#enable-zip-custom-encryption).
+ The optimized version of the container image that's used for function invocations. Note that this is not the same key that's used to protect your container image in the Amazon Elastic Container Registry (Amazon ECR). For more information, see [Function lifecycle](https://docs.aws.amazon.com/lambda/latest/dg/images-create.html#images-lifecycle).
If you don't provide a customer managed key, Lambda uses an [AWS owned key](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-owned-cmk) or an [AWS managed key](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk).  
Type: String  
Pattern: `(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()`   
Required: No

 ** [Layers](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Layers"></a>
A list of [function layers](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html) to add to the function's execution environment. Specify each layer by its ARN, including the version.  
Type: Array of strings  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+:[0-9]+`   
Required: No

 ** [LoggingConfig](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-LoggingConfig"></a>
The function's Amazon CloudWatch Logs configuration settings.  
Type: [LoggingConfig](API_LoggingConfig.md) object  
Required: No

 ** [MemorySize](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-MemorySize"></a>
The amount of [memory available to the function](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-memory-console) 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.  
Type: Integer  
Valid Range: Minimum value of 128. Maximum value of 32768.  
Required: No

 ** [PackageType](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-PackageType"></a>
The type of deployment package. Set to `Image` for container image and set to `Zip` for .zip file archive.  
Type: String  
Valid Values: `Zip | Image`   
Required: No

 ** [Publish](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Publish"></a>
Set to true to publish the first version of the function during creation.  
Type: Boolean  
Required: No

 ** [PublishTo](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-PublishTo"></a>
Specifies where to publish the function version or configuration.  
Type: String  
Valid Values: `LATEST_PUBLISHED`   
Required: No

 ** [Role](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Role"></a>
The Amazon Resource Name (ARN) of the function's execution role.  
Type: String  
Pattern: `arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`   
Required: Yes

 ** [Runtime](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Runtime"></a>
The identifier of the function's [ runtime](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html). Runtime is required if the deployment package is a .zip file archive. Specifying a runtime results in an error if you're deploying a function using a container image.  
The following list includes deprecated runtimes. Lambda blocks creating new functions and updating existing functions shortly after each runtime is deprecated. For more information, see [Runtime use after deprecation](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-deprecation-levels).  
For a list of all currently supported runtimes, see [Supported runtimes](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtimes-supported).  
Type: String  
Valid Values: `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 | nodejs24.x | python3.14 | java25 | dotnet10`   
Required: No

 ** [SnapStart](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-SnapStart"></a>
The function's [SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html) setting.  
Type: [SnapStart](API_SnapStart.md) object  
Required: No

 ** [Tags](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Tags"></a>
A list of [tags](https://docs.aws.amazon.com/lambda/latest/dg/tagging.html) to apply to the function.  
Type: String to string map  
Required: No

 ** [TenancyConfig](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-TenancyConfig"></a>
Configuration for multi-tenant applications that use Lambda functions. Defines tenant isolation settings and resource allocations. Required for functions supporting multiple tenants.  
Type: [TenancyConfig](API_TenancyConfig.md) object  
Required: No

 ** [Timeout](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Timeout"></a>
The amount of time (in seconds) that Lambda allows a function to run before stopping it. The default is 3 seconds. The maximum allowed value is 900 seconds. For more information, see [Lambda execution environment](https://docs.aws.amazon.com/lambda/latest/dg/runtimes-context.html).  
Type: Integer  
Valid Range: Minimum value of 1.  
Required: No

 ** [TracingConfig](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-TracingConfig"></a>
Set `Mode` to `Active` to sample and trace a subset of incoming requests with [X-Ray](https://docs.aws.amazon.com/lambda/latest/dg/services-xray.html).  
Type: [TracingConfig](API_TracingConfig.md) object  
Required: No

 ** [VpcConfig](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-VpcConfig"></a>
For network connectivity to AWS resources in a VPC, specify a list of security groups and subnets in the VPC. When you connect a function to a VPC, it can access resources and the internet only through that VPC. For more information, see [Configuring a Lambda function to access resources in a VPC](https://docs.aws.amazon.com/lambda/latest/dg/configuration-vpc.html).  
Type: [VpcConfig](API_VpcConfig.md) object  
Required: No

## Response Syntax
<a name="API_CreateFunction_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "Architectures": [ "string" ],
   "CapacityProviderConfig": { 
      "LambdaManagedInstancesCapacityProviderConfig": { 
         "CapacityProviderArn": "string",
         "ExecutionEnvironmentMemoryGiBPerVCpu": number,
         "PerExecutionEnvironmentMaxConcurrency": number
      }
   },
   "CodeSha256": "string",
   "CodeSize": number,
   "ConfigSha256": "string",
   "DeadLetterConfig": { 
      "TargetArn": "string"
   },
   "Description": "string",
   "DurableConfig": { 
      "ExecutionTimeout": number,
      "RetentionPeriodInDays": number
   },
   "Environment": { 
      "Error": { 
         "ErrorCode": "string",
         "Message": "string"
      },
      "Variables": { 
         "string" : "string" 
      }
   },
   "EphemeralStorage": { 
      "Size": number
   },
   "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"
      }
   ],
   "LoggingConfig": { 
      "ApplicationLogLevel": "string",
      "LogFormat": "string",
      "LogGroup": "string",
      "SystemLogLevel": "string"
   },
   "MasterArn": "string",
   "MemorySize": number,
   "PackageType": "string",
   "RevisionId": "string",
   "Role": "string",
   "Runtime": "string",
   "RuntimeVersionConfig": { 
      "Error": { 
         "ErrorCode": "string",
         "Message": "string"
      },
      "RuntimeVersionArn": "string"
   },
   "SigningJobArn": "string",
   "SigningProfileVersionArn": "string",
   "SnapStart": { 
      "ApplyOn": "string",
      "OptimizationStatus": "string"
   },
   "State": "string",
   "StateReason": "string",
   "StateReasonCode": "string",
   "TenancyConfig": { 
      "TenantIsolationMode": "string"
   },
   "Timeout": number,
   "TracingConfig": { 
      "Mode": "string"
   },
   "Version": "string",
   "VpcConfig": { 
      "Ipv6AllowedForDualStack": boolean,
      "SecurityGroupIds": [ "string" ],
      "SubnetIds": [ "string" ],
      "VpcId": "string"
   }
}
```

## Response Elements
<a name="API_CreateFunction_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 201 response.

The following data is returned in JSON format by the service.

 ** [Architectures](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Architectures"></a>
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`.  
Type: Array of strings  
Array Members: Fixed number of 1 item.  
Valid Values: `x86_64 | arm64` 

 ** [CapacityProviderConfig](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-CapacityProviderConfig"></a>
Configuration for the capacity provider that manages compute resources for Lambda functions.  
Type: [CapacityProviderConfig](API_CapacityProviderConfig.md) object

 ** [CodeSha256](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-CodeSha256"></a>
The SHA256 hash of the function's deployment package.  
Type: String

 ** [CodeSize](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-CodeSize"></a>
The size of the function's deployment package, in bytes.  
Type: Long

 ** [ConfigSha256](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-ConfigSha256"></a>
The SHA256 hash of the function configuration.  
Type: String

 ** [DeadLetterConfig](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-DeadLetterConfig"></a>
The function's dead letter queue.  
Type: [DeadLetterConfig](API_DeadLetterConfig.md) object

 ** [Description](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Description"></a>
The function's description.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 256.

 ** [DurableConfig](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-DurableConfig"></a>
The function's durable execution configuration settings, if the function is configured for durability.  
Type: [DurableConfig](API_DurableConfig.md) object

 ** [Environment](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Environment"></a>
The function's [environment variables](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html). Omitted from AWS CloudTrail logs.  
Type: [EnvironmentResponse](API_EnvironmentResponse.md) object

 ** [EphemeralStorage](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-EphemeralStorage"></a>
The size of the function's `/tmp` directory in MB. The default value is 512, but can be any whole number between 512 and 10,240 MB. For more information, see [Configuring ephemeral storage (console)](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-ephemeral-storage).  
Type: [EphemeralStorage](API_EphemeralStorage.md) object

 ** [FileSystemConfigs](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-FileSystemConfigs"></a>
Connection settings for an [Amazon EFS file system](https://docs.aws.amazon.com/lambda/latest/dg/configuration-filesystem.html) or an [Amazon S3 Files file system](https://docs.aws.amazon.com/lambda/latest/dg/configuration-filesystem.html).  
Type: Array of [FileSystemConfig](API_FileSystemConfig.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 1 item.

 ** [FunctionArn](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-FunctionArn"></a>
The function's Amazon Resource Name (ARN).  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 10000.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_\.]+(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?` 

 ** [FunctionName](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-FunctionName"></a>
The name of the function.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?` 

 ** [Handler](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Handler"></a>
The function that Lambda calls to begin running your function.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 128.  
Pattern: `[^\s]+` 

 ** [ImageConfigResponse](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-ImageConfigResponse"></a>
The function's image configuration values.  
Type: [ImageConfigResponse](API_ImageConfigResponse.md) object

 ** [KMSKeyArn](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-KMSKeyArn"></a>
The ARN of the AWS Key Management Service (AWS KMS) customer managed key that's used to encrypt the following resources:  
+ The function's [environment variables](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html#configuration-envvars-encryption).
+ The function's [Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart-security.html) snapshots.
+ When used with `SourceKMSKeyArn`, the unzipped version of the .zip deployment package that's used for function invocations. For more information, see [ Specifying a customer managed key for Lambda](https://docs.aws.amazon.com/lambda/latest/dg/encrypt-zip-package.html#enable-zip-custom-encryption).
+ The optimized version of the container image that's used for function invocations. Note that this is not the same key that's used to protect your container image in the Amazon Elastic Container Registry (Amazon ECR). For more information, see [Function lifecycle](https://docs.aws.amazon.com/lambda/latest/dg/images-create.html#images-lifecycle).
If you don't provide a customer managed key, Lambda uses an [AWS owned key](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-owned-cmk) or an [AWS managed key](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk).  
Type: String  
Pattern: `(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()` 

 ** [LastModified](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-LastModified"></a>
The date and time that the function was last updated, in [ISO-8601 format](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD).  
Type: String

 ** [LastUpdateStatus](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-LastUpdateStatus"></a>
The status of the last update that was performed on the function. This is first set to `Successful` after function creation completes.  
Type: String  
Valid Values: `Successful | Failed | InProgress` 

 ** [LastUpdateStatusReason](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-LastUpdateStatusReason"></a>
The reason for the last update that was performed on the function.  
Type: String

 ** [LastUpdateStatusReasonCode](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-LastUpdateStatusReasonCode"></a>
The reason code for the last update that was performed on the function.  
Type: String  
Valid Values: `EniLimitExceeded | InsufficientRolePermissions | InvalidConfiguration | InternalError | SubnetOutOfIPAddresses | InvalidSubnet | InvalidSecurityGroup | ImageDeleted | ImageAccessDenied | InvalidImage | KMSKeyAccessDenied | KMSKeyNotFound | InvalidStateKMSKey | DisabledKMSKey | EFSIOError | EFSMountConnectivityError | EFSMountFailure | EFSMountTimeout | InvalidRuntime | InvalidZipFileException | FunctionError | VcpuLimitExceeded | CapacityProviderScalingLimitExceeded | InsufficientCapacity | EC2RequestLimitExceeded | FunctionError.InitTimeout | FunctionError.RuntimeInitError | FunctionError.ExtensionInitError | FunctionError.InvalidEntryPoint | FunctionError.InvalidWorkingDirectory | FunctionError.PermissionDenied | FunctionError.TooManyExtensions | FunctionError.InitResourceExhausted | DisallowedByVpcEncryptionControl` 

 ** [Layers](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Layers"></a>
The function's [layers](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html).  
Type: Array of [Layer](API_Layer.md) objects

 ** [LoggingConfig](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-LoggingConfig"></a>
The function's Amazon CloudWatch Logs configuration settings.  
Type: [LoggingConfig](API_LoggingConfig.md) object

 ** [MasterArn](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-MasterArn"></a>
For Lambda@Edge functions, the ARN of the main function.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 10000.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?` 

 ** [MemorySize](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-MemorySize"></a>
The amount of memory available to the function at runtime.  
Type: Integer  
Valid Range: Minimum value of 128. Maximum value of 32768.

 ** [PackageType](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-PackageType"></a>
The type of deployment package. Set to `Image` for container image and set `Zip` for .zip file archive.  
Type: String  
Valid Values: `Zip | Image` 

 ** [RevisionId](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-RevisionId"></a>
The latest updated revision of the function or alias.  
Type: String

 ** [Role](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Role"></a>
The function's execution role.  
Type: String  
Pattern: `arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 

 ** [Runtime](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Runtime"></a>
The identifier of the function's [ runtime](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html). Runtime is required if the deployment package is a .zip file archive. Specifying a runtime results in an error if you're deploying a function using a container image.  
The following list includes deprecated runtimes. Lambda blocks creating new functions and updating existing functions shortly after each runtime is deprecated. For more information, see [Runtime use after deprecation](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-deprecation-levels).  
For a list of all currently supported runtimes, see [Supported runtimes](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtimes-supported).  
Type: String  
Valid Values: `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 | nodejs24.x | python3.14 | java25 | dotnet10` 

 ** [RuntimeVersionConfig](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-RuntimeVersionConfig"></a>
The ARN of the runtime and any errors that occured.  
Type: [RuntimeVersionConfig](API_RuntimeVersionConfig.md) object

 ** [SigningJobArn](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-SigningJobArn"></a>
The ARN of the signing job.  
Type: String  
Pattern: `arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` 

 ** [SigningProfileVersionArn](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-SigningProfileVersionArn"></a>
The ARN of the signing profile version.  
Type: String  
Pattern: `arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` 

 ** [SnapStart](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-SnapStart"></a>
Set `ApplyOn` to `PublishedVersions` to create a snapshot of the initialized execution environment when you publish a function version. For more information, see [Improving startup performance with Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html).  
Type: [SnapStartResponse](API_SnapStartResponse.md) object

 ** [State](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-State"></a>
The current state of the function. When the state is `Inactive`, you can reactivate the function by invoking it.  
Type: String  
Valid Values: `Pending | Active | Inactive | Failed | Deactivating | Deactivated | ActiveNonInvocable | Deleting` 

 ** [StateReason](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-StateReason"></a>
The reason for the function's current state.  
Type: String

 ** [StateReasonCode](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-StateReasonCode"></a>
The reason code for the function's current state. When the code is `Creating`, you can't invoke or modify the function.  
Type: String  
Valid Values: `Idle | Creating | Restoring | EniLimitExceeded | InsufficientRolePermissions | InvalidConfiguration | InternalError | SubnetOutOfIPAddresses | InvalidSubnet | InvalidSecurityGroup | ImageDeleted | ImageAccessDenied | InvalidImage | KMSKeyAccessDenied | KMSKeyNotFound | InvalidStateKMSKey | DisabledKMSKey | EFSIOError | EFSMountConnectivityError | EFSMountFailure | EFSMountTimeout | InvalidRuntime | InvalidZipFileException | FunctionError | DrainingDurableExecutions | VcpuLimitExceeded | CapacityProviderScalingLimitExceeded | InsufficientCapacity | EC2RequestLimitExceeded | FunctionError.InitTimeout | FunctionError.RuntimeInitError | FunctionError.ExtensionInitError | FunctionError.InvalidEntryPoint | FunctionError.InvalidWorkingDirectory | FunctionError.PermissionDenied | FunctionError.TooManyExtensions | FunctionError.InitResourceExhausted | DisallowedByVpcEncryptionControl` 

 ** [TenancyConfig](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-TenancyConfig"></a>
The function's tenant isolation configuration settings. Determines whether the Lambda function runs on a shared or dedicated infrastructure per unique tenant.  
Type: [TenancyConfig](API_TenancyConfig.md) object

 ** [Timeout](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Timeout"></a>
The amount of time in seconds that Lambda allows a function to run before stopping it.  
Type: Integer  
Valid Range: Minimum value of 1.

 ** [TracingConfig](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-TracingConfig"></a>
The function's AWS X-Ray tracing configuration.  
Type: [TracingConfigResponse](API_TracingConfigResponse.md) object

 ** [Version](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Version"></a>
The version of the Lambda function.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Pattern: `(\$LATEST|[0-9]+)` 

 ** [VpcConfig](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-VpcConfig"></a>
The function's networking configuration.  
Type: [VpcConfigResponse](API_VpcConfigResponse.md) object

## Errors
<a name="API_CreateFunction_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** CodeSigningConfigNotFoundException **   
The specified code signing configuration does not exist.  
HTTP Status Code: 404

 ** CodeStorageExceededException **   
Your AWS account has exceeded its maximum total code size. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html).    
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** CodeVerificationFailedException **   
The code signature failed one or more of the validation checks for signature mismatch or expiry, and the code signing policy is set to ENFORCE. Lambda blocks the deployment.  
HTTP Status Code: 400

 ** FunctionVersionsPerCapacityProviderLimitExceededException **   
The maximum number of function versions that can be associated with a single capacity provider has been exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html).    
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** InvalidCodeSignatureException **   
The code signature failed the integrity check. If the integrity check fails, then Lambda blocks deployment, even if the code signing policy is set to WARN.  
HTTP Status Code: 400

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_CreateFunction_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/CreateFunction) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/CreateFunction) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/CreateFunction) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/CreateFunction) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/CreateFunction) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/CreateFunction) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/CreateFunction) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/CreateFunction) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/CreateFunction) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/CreateFunction) 

# CreateFunctionUrlConfig
<a name="API_CreateFunctionUrlConfig"></a>

Creates a Lambda function URL with the specified configuration parameters. A function URL is a dedicated HTTP(S) endpoint that you can use to invoke your function.

## Request Syntax
<a name="API_CreateFunctionUrlConfig_RequestSyntax"></a>

```
POST /2021-10-31/functions/FunctionName/url?Qualifier=Qualifier HTTP/1.1
Content-type: application/json

{
   "AuthType": "string",
   "Cors": { 
      "AllowCredentials": boolean,
      "AllowHeaders": [ "string" ],
      "AllowMethods": [ "string" ],
      "AllowOrigins": [ "string" ],
      "ExposeHeaders": [ "string" ],
      "MaxAge": number
   },
   "InvokeMode": "string"
}
```

## URI Request Parameters
<a name="API_CreateFunctionUrlConfig_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_CreateFunctionUrlConfig_RequestSyntax) **   <a name="lambda-CreateFunctionUrlConfig-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?`   
Required: Yes

 ** [Qualifier](#API_CreateFunctionUrlConfig_RequestSyntax) **   <a name="lambda-CreateFunctionUrlConfig-request-uri-Qualifier"></a>
The alias name.  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `((?!^\d+$)^[0-9a-zA-Z-_]+$)` 

## Request Body
<a name="API_CreateFunctionUrlConfig_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [AuthType](#API_CreateFunctionUrlConfig_RequestSyntax) **   <a name="lambda-CreateFunctionUrlConfig-request-AuthType"></a>
The type of authentication that your function URL uses. Set to `AWS_IAM` if you want to restrict access to authenticated users only. Set to `NONE` if you want to bypass IAM authentication to create a public endpoint. For more information, see [Control access to Lambda function URLs](https://docs.aws.amazon.com/lambda/latest/dg/urls-auth.html).  
Type: String  
Valid Values: `NONE | AWS_IAM`   
Required: Yes

 ** [Cors](#API_CreateFunctionUrlConfig_RequestSyntax) **   <a name="lambda-CreateFunctionUrlConfig-request-Cors"></a>
The [cross-origin resource sharing (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) settings for your function URL.  
Type: [Cors](API_Cors.md) object  
Required: No

 ** [InvokeMode](#API_CreateFunctionUrlConfig_RequestSyntax) **   <a name="lambda-CreateFunctionUrlConfig-request-InvokeMode"></a>
Use one of the following options:  
+  `BUFFERED` – This is the default option. Lambda invokes your function using the `Invoke` API operation. Invocation results are available when the payload is complete. The maximum payload size is 6 MB.
+  `RESPONSE_STREAM` – Your function streams payload results as they become available. Lambda invokes your function using the `InvokeWithResponseStream` API operation. The maximum response payload size is 200 MB.
Type: String  
Valid Values: `BUFFERED | RESPONSE_STREAM`   
Required: No

## Response Syntax
<a name="API_CreateFunctionUrlConfig_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "AuthType": "string",
   "Cors": { 
      "AllowCredentials": boolean,
      "AllowHeaders": [ "string" ],
      "AllowMethods": [ "string" ],
      "AllowOrigins": [ "string" ],
      "ExposeHeaders": [ "string" ],
      "MaxAge": number
   },
   "CreationTime": "string",
   "FunctionArn": "string",
   "FunctionUrl": "string",
   "InvokeMode": "string"
}
```

## Response Elements
<a name="API_CreateFunctionUrlConfig_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 201 response.

The following data is returned in JSON format by the service.

 ** [AuthType](#API_CreateFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-CreateFunctionUrlConfig-response-AuthType"></a>
The type of authentication that your function URL uses. Set to `AWS_IAM` if you want to restrict access to authenticated users only. Set to `NONE` if you want to bypass IAM authentication to create a public endpoint. For more information, see [Control access to Lambda function URLs](https://docs.aws.amazon.com/lambda/latest/dg/urls-auth.html).  
Type: String  
Valid Values: `NONE | AWS_IAM` 

 ** [Cors](#API_CreateFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-CreateFunctionUrlConfig-response-Cors"></a>
The [cross-origin resource sharing (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) settings for your function URL.  
Type: [Cors](API_Cors.md) object

 ** [CreationTime](#API_CreateFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-CreateFunctionUrlConfig-response-CreationTime"></a>
When the function URL was created, in [ISO-8601 format](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD).  
Type: String

 ** [FunctionArn](#API_CreateFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-CreateFunctionUrlConfig-response-FunctionArn"></a>
The Amazon Resource Name (ARN) of your function.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 10000.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?` 

 ** [FunctionUrl](#API_CreateFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-CreateFunctionUrlConfig-response-FunctionUrl"></a>
The HTTP URL endpoint for your function.  
Type: String  
Length Constraints: Minimum length of 40. Maximum length of 100.

 ** [InvokeMode](#API_CreateFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-CreateFunctionUrlConfig-response-InvokeMode"></a>
Use one of the following options:  
+  `BUFFERED` – This is the default option. Lambda invokes your function using the `Invoke` API operation. Invocation results are available when the payload is complete. The maximum payload size is 6 MB.
+  `RESPONSE_STREAM` – Your function streams payload results as they become available. Lambda invokes your function using the `InvokeWithResponseStream` API operation. The maximum response payload size is 200 MB.
Type: String  
Valid Values: `BUFFERED | RESPONSE_STREAM` 

## Errors
<a name="API_CreateFunctionUrlConfig_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_CreateFunctionUrlConfig_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/CreateFunctionUrlConfig) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/CreateFunctionUrlConfig) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/CreateFunctionUrlConfig) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/CreateFunctionUrlConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/CreateFunctionUrlConfig) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/CreateFunctionUrlConfig) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/CreateFunctionUrlConfig) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/CreateFunctionUrlConfig) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/CreateFunctionUrlConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/CreateFunctionUrlConfig) 

# DeleteAlias
<a name="API_DeleteAlias"></a>

Deletes a Lambda function [alias](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html).

## Request Syntax
<a name="API_DeleteAlias_RequestSyntax"></a>

```
DELETE /2015-03-31/functions/FunctionName/aliases/Name HTTP/1.1
```

## URI Request Parameters
<a name="API_DeleteAlias_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_DeleteAlias_RequestSyntax) **   <a name="lambda-DeleteAlias-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?`   
Required: Yes

 ** [Name](#API_DeleteAlias_RequestSyntax) **   <a name="lambda-DeleteAlias-request-uri-Name"></a>
The name of the alias.  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `(?!^[0-9]+$)([a-zA-Z0-9-_]+)`   
Required: Yes

## Request Body
<a name="API_DeleteAlias_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DeleteAlias_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_DeleteAlias_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 204 response with an empty HTTP body.

## Errors
<a name="API_DeleteAlias_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_DeleteAlias_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/DeleteAlias) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/DeleteAlias) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/DeleteAlias) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/DeleteAlias) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/DeleteAlias) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/DeleteAlias) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/DeleteAlias) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/DeleteAlias) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/DeleteAlias) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/DeleteAlias) 

# DeleteCapacityProvider
<a name="API_DeleteCapacityProvider"></a>

Deletes a capacity provider. You cannot delete a capacity provider that is currently being used by Lambda functions.

## Request Syntax
<a name="API_DeleteCapacityProvider_RequestSyntax"></a>

```
DELETE /2025-11-30/capacity-providers/CapacityProviderName HTTP/1.1
```

## URI Request Parameters
<a name="API_DeleteCapacityProvider_RequestParameters"></a>

The request uses the following URI parameters.

 ** [CapacityProviderName](#API_DeleteCapacityProvider_RequestSyntax) **   <a name="lambda-DeleteCapacityProvider-request-uri-CapacityProviderName"></a>
The name of the capacity provider to delete.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:aws[a-zA-Z-]*:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:capacity-provider:[a-zA-Z0-9-_]+)|[a-zA-Z0-9-_]+`   
Required: Yes

## Request Body
<a name="API_DeleteCapacityProvider_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DeleteCapacityProvider_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "CapacityProvider": { 
      "CapacityProviderArn": "string",
      "CapacityProviderScalingConfig": { 
         "MaxVCpuCount": number,
         "ScalingMode": "string",
         "ScalingPolicies": [ 
            { 
               "PredefinedMetricType": "string",
               "TargetValue": number
            }
         ]
      },
      "InstanceRequirements": { 
         "AllowedInstanceTypes": [ "string" ],
         "Architectures": [ "string" ],
         "ExcludedInstanceTypes": [ "string" ]
      },
      "KmsKeyArn": "string",
      "LastModified": "string",
      "PermissionsConfig": { 
         "CapacityProviderOperatorRoleArn": "string"
      },
      "State": "string",
      "VpcConfig": { 
         "SecurityGroupIds": [ "string" ],
         "SubnetIds": [ "string" ]
      }
   }
}
```

## Response Elements
<a name="API_DeleteCapacityProvider_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [CapacityProvider](#API_DeleteCapacityProvider_ResponseSyntax) **   <a name="lambda-DeleteCapacityProvider-response-CapacityProvider"></a>
Information about the deleted capacity provider.  
Type: [CapacityProvider](API_CapacityProvider.md) object

## Errors
<a name="API_DeleteCapacityProvider_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_DeleteCapacityProvider_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/DeleteCapacityProvider) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/DeleteCapacityProvider) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/DeleteCapacityProvider) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/DeleteCapacityProvider) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/DeleteCapacityProvider) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/DeleteCapacityProvider) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/DeleteCapacityProvider) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/DeleteCapacityProvider) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/DeleteCapacityProvider) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/DeleteCapacityProvider) 

# DeleteCodeSigningConfig
<a name="API_DeleteCodeSigningConfig"></a>

Deletes the code signing configuration. You can delete the code signing configuration only if no function is using it. 

## Request Syntax
<a name="API_DeleteCodeSigningConfig_RequestSyntax"></a>

```
DELETE /2020-04-22/code-signing-configs/CodeSigningConfigArn HTTP/1.1
```

## URI Request Parameters
<a name="API_DeleteCodeSigningConfig_RequestParameters"></a>

The request uses the following URI parameters.

 ** [CodeSigningConfigArn](#API_DeleteCodeSigningConfig_RequestSyntax) **   <a name="lambda-DeleteCodeSigningConfig-request-uri-CodeSigningConfigArn"></a>
The The Amazon Resource Name (ARN) of the code signing configuration.  
Length Constraints: Minimum length of 0. Maximum length of 200.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}:\d{12}:code-signing-config:csc-[a-z0-9]{17}`   
Required: Yes

## Request Body
<a name="API_DeleteCodeSigningConfig_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DeleteCodeSigningConfig_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_DeleteCodeSigningConfig_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 204 response with an empty HTTP body.

## Errors
<a name="API_DeleteCodeSigningConfig_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

## See Also
<a name="API_DeleteCodeSigningConfig_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/DeleteCodeSigningConfig) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/DeleteCodeSigningConfig) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/DeleteCodeSigningConfig) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/DeleteCodeSigningConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/DeleteCodeSigningConfig) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/DeleteCodeSigningConfig) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/DeleteCodeSigningConfig) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/DeleteCodeSigningConfig) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/DeleteCodeSigningConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/DeleteCodeSigningConfig) 

# DeleteEventSourceMapping
<a name="API_DeleteEventSourceMapping"></a>

Deletes an [event source mapping](https://docs.aws.amazon.com/lambda/latest/dg/intro-invocation-modes.html). You can get the identifier of a mapping from the output of [ListEventSourceMappings](API_ListEventSourceMappings.md).

When you delete an event source mapping, it enters a `Deleting` state and might not be completely deleted for several seconds.

## Request Syntax
<a name="API_DeleteEventSourceMapping_RequestSyntax"></a>

```
DELETE /2015-03-31/event-source-mappings/UUID HTTP/1.1
```

## URI Request Parameters
<a name="API_DeleteEventSourceMapping_RequestParameters"></a>

The request uses the following URI parameters.

 ** [UUID](#API_DeleteEventSourceMapping_RequestSyntax) **   <a name="lambda-DeleteEventSourceMapping-request-uri-UUID"></a>
The identifier of the event source mapping.  
Required: Yes

## Request Body
<a name="API_DeleteEventSourceMapping_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DeleteEventSourceMapping_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "AmazonManagedKafkaEventSourceConfig": { 
      "ConsumerGroupId": "string",
      "SchemaRegistryConfig": { 
         "AccessConfigs": [ 
            { 
               "Type": "string",
               "URI": "string"
            }
         ],
         "EventRecordFormat": "string",
         "SchemaRegistryURI": "string",
         "SchemaValidationConfigs": [ 
            { 
               "Attribute": "string"
            }
         ]
      }
   },
   "BatchSize": number,
   "BisectBatchOnFunctionError": boolean,
   "DestinationConfig": { 
      "OnFailure": { 
         "Destination": "string"
      },
      "OnSuccess": { 
         "Destination": "string"
      }
   },
   "DocumentDBEventSourceConfig": { 
      "CollectionName": "string",
      "DatabaseName": "string",
      "FullDocument": "string"
   },
   "EventSourceArn": "string",
   "EventSourceMappingArn": "string",
   "FilterCriteria": { 
      "Filters": [ 
         { 
            "Pattern": "string"
         }
      ]
   },
   "FilterCriteriaError": { 
      "ErrorCode": "string",
      "Message": "string"
   },
   "FunctionArn": "string",
   "FunctionResponseTypes": [ "string" ],
   "KMSKeyArn": "string",
   "LastModified": number,
   "LastProcessingResult": "string",
   "LoggingConfig": { 
      "SystemLogLevel": "string"
   },
   "MaximumBatchingWindowInSeconds": number,
   "MaximumRecordAgeInSeconds": number,
   "MaximumRetryAttempts": number,
   "MetricsConfig": { 
      "Metrics": [ "string" ]
   },
   "ParallelizationFactor": number,
   "ProvisionedPollerConfig": { 
      "MaximumPollers": number,
      "MinimumPollers": number,
      "PollerGroupName": "string"
   },
   "Queues": [ "string" ],
   "ScalingConfig": { 
      "MaximumConcurrency": number
   },
   "SelfManagedEventSource": { 
      "Endpoints": { 
         "string" : [ "string" ]
      }
   },
   "SelfManagedKafkaEventSourceConfig": { 
      "ConsumerGroupId": "string",
      "SchemaRegistryConfig": { 
         "AccessConfigs": [ 
            { 
               "Type": "string",
               "URI": "string"
            }
         ],
         "EventRecordFormat": "string",
         "SchemaRegistryURI": "string",
         "SchemaValidationConfigs": [ 
            { 
               "Attribute": "string"
            }
         ]
      }
   },
   "SourceAccessConfigurations": [ 
      { 
         "Type": "string",
         "URI": "string"
      }
   ],
   "StartingPosition": "string",
   "StartingPositionTimestamp": number,
   "State": "string",
   "StateTransitionReason": "string",
   "Topics": [ "string" ],
   "TumblingWindowInSeconds": number,
   "UUID": "string"
}
```

## Response Elements
<a name="API_DeleteEventSourceMapping_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [AmazonManagedKafkaEventSourceConfig](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-AmazonManagedKafkaEventSourceConfig"></a>
Specific configuration settings for an Amazon Managed Streaming for Apache Kafka (Amazon MSK) event source.  
Type: [AmazonManagedKafkaEventSourceConfig](API_AmazonManagedKafkaEventSourceConfig.md) object

 ** [BatchSize](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-BatchSize"></a>
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.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 10000.

 ** [BisectBatchOnFunctionError](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-BisectBatchOnFunctionError"></a>
(Kinesis, DynamoDB Streams, Amazon MSK, and self-managed Apache Kafka) If the function returns an error, split the batch in two and retry. The default value is false.  
Type: Boolean

 ** [DestinationConfig](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-DestinationConfig"></a>
(Kinesis, DynamoDB Streams, Amazon MSK, and self-managed Apache Kafka) A configuration object that specifies the destination of an event after Lambda processes it.  
Type: [DestinationConfig](API_DestinationConfig.md) object

 ** [DocumentDBEventSourceConfig](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-DocumentDBEventSourceConfig"></a>
Specific configuration settings for a DocumentDB event source.  
Type: [DocumentDBEventSourceConfig](API_DocumentDBEventSourceConfig.md) object

 ** [EventSourceArn](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-EventSourceArn"></a>
The Amazon Resource Name (ARN) of the event source.  
Type: String  
Pattern: `arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` 

 ** [EventSourceMappingArn](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-EventSourceMappingArn"></a>
The Amazon Resource Name (ARN) of the event source mapping.  
Type: String  
Length Constraints: Minimum length of 85. Maximum length of 120.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:event-source-mapping:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}` 

 ** [FilterCriteria](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-FilterCriteria"></a>
An object that defines the filter criteria that determine whether Lambda should process an event. For more information, see [Lambda event filtering](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html).  
If filter criteria is encrypted, this field shows up as `null` in the response of ListEventSourceMapping API calls. You can view this field in plaintext in the response of GetEventSourceMapping and DeleteEventSourceMapping calls if you have `kms:Decrypt` permissions for the correct AWS KMS key.  
Type: [FilterCriteria](API_FilterCriteria.md) object

 ** [FilterCriteriaError](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-FilterCriteriaError"></a>
An object that contains details about an error related to filter criteria encryption.  
Type: [FilterCriteriaError](API_FilterCriteriaError.md) object

 ** [FunctionArn](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-FunctionArn"></a>
The ARN of the Lambda function.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 10000.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?` 

 ** [FunctionResponseTypes](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-FunctionResponseTypes"></a>
(Kinesis, DynamoDB Streams, Amazon MSK, self-managed Apache Kafka, and Amazon SQS) A list of current response type enums applied to the event source mapping.  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 1 item.  
Valid Values: `ReportBatchItemFailures` 

 ** [KMSKeyArn](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-KMSKeyArn"></a>
 The ARN of the AWS Key Management Service (AWS KMS) customer managed key that Lambda uses to encrypt your function's [filter criteria](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html#filtering-basics).  
Type: String  
Pattern: `(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()` 

 ** [LastModified](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-LastModified"></a>
The date that the event source mapping was last updated or that its state changed, in Unix time seconds.  
Type: Timestamp

 ** [LastProcessingResult](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-LastProcessingResult"></a>
The result of the event source mapping's last processing attempt.  
Type: String

 ** [LoggingConfig](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-LoggingConfig"></a>
(Amazon MSK, and self-managed Apache Kafka only) The logging configuration for your event source. For more information, see [Event source mapping logging](https://docs.aws.amazon.com/lambda/latest/dg/esm-logging.html).  
Type: [EventSourceMappingLoggingConfig](API_EventSourceMappingLoggingConfig.md) object

 ** [MaximumBatchingWindowInSeconds](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-MaximumBatchingWindowInSeconds"></a>
The maximum amount of time, in seconds, that Lambda spends gathering records before invoking the function. You can configure `MaximumBatchingWindowInSeconds` to any value from 0 seconds to 300 seconds in increments of seconds.  
For streams and Amazon SQS event sources, the default batching window is 0 seconds. For Amazon MSK, Self-managed Apache Kafka, Amazon MQ, and DocumentDB event sources, the default batching window is 500 ms. Note that because you can only change `MaximumBatchingWindowInSeconds` in increments of seconds, you cannot revert back to the 500 ms default batching window after you have changed it. To restore the default batching window, you must create a new event source mapping.  
Related setting: For streams and Amazon SQS event sources, when you set `BatchSize` to a value greater than 10, you must set `MaximumBatchingWindowInSeconds` to at least 1.  
Type: Integer  
Valid Range: Minimum value of 0. Maximum value of 300.

 ** [MaximumRecordAgeInSeconds](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-MaximumRecordAgeInSeconds"></a>
(Kinesis, DynamoDB Streams, Amazon MSK, and self-managed Apache Kafka) 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.  
The minimum valid value for maximum record age is 60s. Although values less than 60 and greater than -1 fall within the parameter's absolute range, they are not allowed
Type: Integer  
Valid Range: Minimum value of -1. Maximum value of 604800.

 ** [MaximumRetryAttempts](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-MaximumRetryAttempts"></a>
(Kinesis, DynamoDB Streams, Amazon MSK, and self-managed Apache Kafka) 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.  
Type: Integer  
Valid Range: Minimum value of -1. Maximum value of 10000.

 ** [MetricsConfig](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-MetricsConfig"></a>
The metrics configuration for your event source. For more information, see [Event source mapping metrics](https://docs.aws.amazon.com/lambda/latest/dg/monitoring-metrics-types.html#event-source-mapping-metrics).  
Type: [EventSourceMappingMetricsConfig](API_EventSourceMappingMetricsConfig.md) object

 ** [ParallelizationFactor](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-ParallelizationFactor"></a>
(Kinesis and DynamoDB Streams only) The number of batches to process concurrently from each shard. The default value is 1.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 10.

 ** [ProvisionedPollerConfig](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-ProvisionedPollerConfig"></a>
(Amazon SQS, Amazon MSK, and self-managed Apache Kafka only) The provisioned mode configuration for the event source. For more information, see [provisioned mode](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventsourcemapping.html#invocation-eventsourcemapping-provisioned-mode).  
Type: [ProvisionedPollerConfig](API_ProvisionedPollerConfig.md) object

 ** [Queues](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-Queues"></a>
 (Amazon MQ) The name of the Amazon MQ broker destination queue to consume.  
Type: Array of strings  
Array Members: Fixed number of 1 item.  
Length Constraints: Minimum length of 1. Maximum length of 1000.  
Pattern: `[\s\S]*` 

 ** [ScalingConfig](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-ScalingConfig"></a>
(Amazon SQS only) The scaling configuration for the event source. For more information, see [Configuring maximum concurrency for Amazon SQS event sources](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#events-sqs-max-concurrency).  
Type: [ScalingConfig](API_ScalingConfig.md) object

 ** [SelfManagedEventSource](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-SelfManagedEventSource"></a>
The self-managed Apache Kafka cluster for your event source.  
Type: [SelfManagedEventSource](API_SelfManagedEventSource.md) object

 ** [SelfManagedKafkaEventSourceConfig](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-SelfManagedKafkaEventSourceConfig"></a>
Specific configuration settings for a self-managed Apache Kafka event source.  
Type: [SelfManagedKafkaEventSourceConfig](API_SelfManagedKafkaEventSourceConfig.md) object

 ** [SourceAccessConfigurations](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-SourceAccessConfigurations"></a>
An array of the authentication protocol, VPC components, or virtual host to secure and define your event source.  
Type: Array of [SourceAccessConfiguration](API_SourceAccessConfiguration.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 22 items.

 ** [StartingPosition](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-StartingPosition"></a>
The position in a stream from which to start reading. Required for Amazon Kinesis and Amazon DynamoDB Stream event sources. `AT_TIMESTAMP` is supported only for Amazon Kinesis streams, Amazon DocumentDB, Amazon MSK, and self-managed Apache Kafka.  
Type: String  
Valid Values: `TRIM_HORIZON | LATEST | AT_TIMESTAMP` 

 ** [StartingPositionTimestamp](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-StartingPositionTimestamp"></a>
With `StartingPosition` set to `AT_TIMESTAMP`, the time from which to start reading, in Unix time seconds. `StartingPositionTimestamp` cannot be in the future.  
Type: Timestamp

 ** [State](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-State"></a>
The state of the event source mapping. It can be one of the following: `Creating`, `Enabling`, `Enabled`, `Disabling`, `Disabled`, `Updating`, or `Deleting`.  
Type: String

 ** [StateTransitionReason](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-StateTransitionReason"></a>
Indicates whether a user or Lambda made the last change to the event source mapping.  
Type: String

 ** [Topics](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-Topics"></a>
The name of the Kafka topic.  
Type: Array of strings  
Array Members: Fixed number of 1 item.  
Length Constraints: Minimum length of 1. Maximum length of 249.  
Pattern: `[^.]([a-zA-Z0-9\-_.]+)` 

 ** [TumblingWindowInSeconds](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-TumblingWindowInSeconds"></a>
(Kinesis and DynamoDB Streams only) The duration in seconds of a processing window for DynamoDB and Kinesis Streams event sources. A value of 0 seconds indicates no tumbling window.  
Type: Integer  
Valid Range: Minimum value of 0. Maximum value of 900.

 ** [UUID](#API_DeleteEventSourceMapping_ResponseSyntax) **   <a name="lambda-DeleteEventSourceMapping-response-UUID"></a>
The identifier of the event source mapping.  
Type: String

## Errors
<a name="API_DeleteEventSourceMapping_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceInUseException **   
The operation conflicts with the resource's availability. For example, you tried to update an event source mapping in the CREATING state, or you tried to delete an event source mapping currently UPDATING.  
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_DeleteEventSourceMapping_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/DeleteEventSourceMapping) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/DeleteEventSourceMapping) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/DeleteEventSourceMapping) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/DeleteEventSourceMapping) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/DeleteEventSourceMapping) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/DeleteEventSourceMapping) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/DeleteEventSourceMapping) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/DeleteEventSourceMapping) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/DeleteEventSourceMapping) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/DeleteEventSourceMapping) 

# DeleteFunction
<a name="API_DeleteFunction"></a>

Deletes a Lambda function. To delete a specific function version, use the `Qualifier` parameter. Otherwise, all versions and aliases are deleted. This doesn't require the user to have explicit permissions for [DeleteAlias](API_DeleteAlias.md).

**Note**  
A deleted Lambda function cannot be recovered. Ensure that you specify the correct function name and version before deleting.

To delete Lambda event source mappings that invoke a function, use [DeleteEventSourceMapping](API_DeleteEventSourceMapping.md). For AWS services and resources that invoke your function directly, delete the trigger in the service where you originally configured it.

## Request Syntax
<a name="API_DeleteFunction_RequestSyntax"></a>

```
DELETE /2015-03-31/functions/FunctionName?Qualifier=Qualifier HTTP/1.1
```

## URI Request Parameters
<a name="API_DeleteFunction_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_DeleteFunction_RequestSyntax) **   <a name="lambda-DeleteFunction-request-uri-FunctionName"></a>
The name or ARN of the Lambda function or version.  

**Name formats**
+  **Function name** – `my-function` (name-only), `my-function:1` (with version).
+  **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.  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?`   
Required: Yes

 ** [Qualifier](#API_DeleteFunction_RequestSyntax) **   <a name="lambda-DeleteFunction-request-uri-Qualifier"></a>
Specify a version to delete. You can't delete a version that an alias references.  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `\$(LATEST(\.PUBLISHED)?)|[a-zA-Z0-9-_$]+` 

## Request Body
<a name="API_DeleteFunction_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DeleteFunction_ResponseSyntax"></a>

```
HTTP/1.1 StatusCode
```

## Response Elements
<a name="API_DeleteFunction_ResponseElements"></a>

If the action is successful, the service sends back the following HTTP response.

 ** [StatusCode](#API_DeleteFunction_ResponseSyntax) **   <a name="lambda-DeleteFunction-response-StatusCode"></a>
The HTTP status code returned by the operation.

## Errors
<a name="API_DeleteFunction_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_DeleteFunction_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/DeleteFunction) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/DeleteFunction) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/DeleteFunction) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/DeleteFunction) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/DeleteFunction) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/DeleteFunction) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/DeleteFunction) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/DeleteFunction) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/DeleteFunction) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/DeleteFunction) 

# DeleteFunctionCodeSigningConfig
<a name="API_DeleteFunctionCodeSigningConfig"></a>

Removes the code signing configuration from the function.

## Request Syntax
<a name="API_DeleteFunctionCodeSigningConfig_RequestSyntax"></a>

```
DELETE /2020-06-30/functions/FunctionName/code-signing-config HTTP/1.1
```

## URI Request Parameters
<a name="API_DeleteFunctionCodeSigningConfig_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_DeleteFunctionCodeSigningConfig_RequestSyntax) **   <a name="lambda-DeleteFunctionCodeSigningConfig-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?`   
Required: Yes

## Request Body
<a name="API_DeleteFunctionCodeSigningConfig_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DeleteFunctionCodeSigningConfig_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_DeleteFunctionCodeSigningConfig_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 204 response with an empty HTTP body.

## Errors
<a name="API_DeleteFunctionCodeSigningConfig_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** CodeSigningConfigNotFoundException **   
The specified code signing configuration does not exist.  
HTTP Status Code: 404

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_DeleteFunctionCodeSigningConfig_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/DeleteFunctionCodeSigningConfig) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/DeleteFunctionCodeSigningConfig) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/DeleteFunctionCodeSigningConfig) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/DeleteFunctionCodeSigningConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/DeleteFunctionCodeSigningConfig) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/DeleteFunctionCodeSigningConfig) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/DeleteFunctionCodeSigningConfig) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/DeleteFunctionCodeSigningConfig) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/DeleteFunctionCodeSigningConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/DeleteFunctionCodeSigningConfig) 

# DeleteFunctionConcurrency
<a name="API_DeleteFunctionConcurrency"></a>

Removes a concurrent execution limit from a function.

## Request Syntax
<a name="API_DeleteFunctionConcurrency_RequestSyntax"></a>

```
DELETE /2017-10-31/functions/FunctionName/concurrency HTTP/1.1
```

## URI Request Parameters
<a name="API_DeleteFunctionConcurrency_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_DeleteFunctionConcurrency_RequestSyntax) **   <a name="lambda-DeleteFunctionConcurrency-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?`   
Required: Yes

## Request Body
<a name="API_DeleteFunctionConcurrency_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DeleteFunctionConcurrency_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_DeleteFunctionConcurrency_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 204 response with an empty HTTP body.

## Errors
<a name="API_DeleteFunctionConcurrency_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_DeleteFunctionConcurrency_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/DeleteFunctionConcurrency) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/DeleteFunctionConcurrency) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/DeleteFunctionConcurrency) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/DeleteFunctionConcurrency) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/DeleteFunctionConcurrency) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/DeleteFunctionConcurrency) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/DeleteFunctionConcurrency) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/DeleteFunctionConcurrency) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/DeleteFunctionConcurrency) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/DeleteFunctionConcurrency) 

# DeleteFunctionEventInvokeConfig
<a name="API_DeleteFunctionEventInvokeConfig"></a>

Deletes the configuration for asynchronous invocation for a function, version, or alias.

To configure options for asynchronous invocation, use [PutFunctionEventInvokeConfig](API_PutFunctionEventInvokeConfig.md).

## Request Syntax
<a name="API_DeleteFunctionEventInvokeConfig_RequestSyntax"></a>

```
DELETE /2019-09-25/functions/FunctionName/event-invoke-config?Qualifier=Qualifier HTTP/1.1
```

## URI Request Parameters
<a name="API_DeleteFunctionEventInvokeConfig_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_DeleteFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-DeleteFunctionEventInvokeConfig-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?`   
Required: Yes

 ** [Qualifier](#API_DeleteFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-DeleteFunctionEventInvokeConfig-request-uri-Qualifier"></a>
A version number or alias name.  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `\$(LATEST(\.PUBLISHED)?)|[a-zA-Z0-9-_$]+` 

## Request Body
<a name="API_DeleteFunctionEventInvokeConfig_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DeleteFunctionEventInvokeConfig_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_DeleteFunctionEventInvokeConfig_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 204 response with an empty HTTP body.

## Errors
<a name="API_DeleteFunctionEventInvokeConfig_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_DeleteFunctionEventInvokeConfig_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/DeleteFunctionEventInvokeConfig) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/DeleteFunctionEventInvokeConfig) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/DeleteFunctionEventInvokeConfig) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/DeleteFunctionEventInvokeConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/DeleteFunctionEventInvokeConfig) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/DeleteFunctionEventInvokeConfig) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/DeleteFunctionEventInvokeConfig) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/DeleteFunctionEventInvokeConfig) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/DeleteFunctionEventInvokeConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/DeleteFunctionEventInvokeConfig) 

# DeleteFunctionUrlConfig
<a name="API_DeleteFunctionUrlConfig"></a>

Deletes a Lambda function URL. When you delete a function URL, you can't recover it. Creating a new function URL results in a different URL address.

## Request Syntax
<a name="API_DeleteFunctionUrlConfig_RequestSyntax"></a>

```
DELETE /2021-10-31/functions/FunctionName/url?Qualifier=Qualifier HTTP/1.1
```

## URI Request Parameters
<a name="API_DeleteFunctionUrlConfig_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_DeleteFunctionUrlConfig_RequestSyntax) **   <a name="lambda-DeleteFunctionUrlConfig-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?`   
Required: Yes

 ** [Qualifier](#API_DeleteFunctionUrlConfig_RequestSyntax) **   <a name="lambda-DeleteFunctionUrlConfig-request-uri-Qualifier"></a>
The alias name.  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `((?!^\d+$)^[0-9a-zA-Z-_]+$)` 

## Request Body
<a name="API_DeleteFunctionUrlConfig_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DeleteFunctionUrlConfig_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_DeleteFunctionUrlConfig_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 204 response with an empty HTTP body.

## Errors
<a name="API_DeleteFunctionUrlConfig_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_DeleteFunctionUrlConfig_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/DeleteFunctionUrlConfig) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/DeleteFunctionUrlConfig) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/DeleteFunctionUrlConfig) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/DeleteFunctionUrlConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/DeleteFunctionUrlConfig) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/DeleteFunctionUrlConfig) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/DeleteFunctionUrlConfig) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/DeleteFunctionUrlConfig) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/DeleteFunctionUrlConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/DeleteFunctionUrlConfig) 

# DeleteLayerVersion
<a name="API_DeleteLayerVersion"></a>

Deletes a version of an [AWS Lambda layer](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html). Deleted versions can no longer be viewed or added to functions. To avoid breaking functions, a copy of the version remains in Lambda until no functions refer to it.

## Request Syntax
<a name="API_DeleteLayerVersion_RequestSyntax"></a>

```
DELETE /2018-10-31/layers/LayerName/versions/VersionNumber HTTP/1.1
```

## URI Request Parameters
<a name="API_DeleteLayerVersion_RequestParameters"></a>

The request uses the following URI parameters.

 ** [LayerName](#API_DeleteLayerVersion_RequestSyntax) **   <a name="lambda-DeleteLayerVersion-request-uri-LayerName"></a>
The name or Amazon Resource Name (ARN) of the layer.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+)|[a-zA-Z0-9-_]+`   
Required: Yes

 ** [VersionNumber](#API_DeleteLayerVersion_RequestSyntax) **   <a name="lambda-DeleteLayerVersion-request-uri-VersionNumber"></a>
The version number.  
Required: Yes

## Request Body
<a name="API_DeleteLayerVersion_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DeleteLayerVersion_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_DeleteLayerVersion_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 204 response with an empty HTTP body.

## Errors
<a name="API_DeleteLayerVersion_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_DeleteLayerVersion_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/DeleteLayerVersion) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/DeleteLayerVersion) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/DeleteLayerVersion) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/DeleteLayerVersion) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/DeleteLayerVersion) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/DeleteLayerVersion) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/DeleteLayerVersion) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/DeleteLayerVersion) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/DeleteLayerVersion) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/DeleteLayerVersion) 

# DeleteProvisionedConcurrencyConfig
<a name="API_DeleteProvisionedConcurrencyConfig"></a>

Deletes the provisioned concurrency configuration for a function.

## Request Syntax
<a name="API_DeleteProvisionedConcurrencyConfig_RequestSyntax"></a>

```
DELETE /2019-09-30/functions/FunctionName/provisioned-concurrency?Qualifier=Qualifier HTTP/1.1
```

## URI Request Parameters
<a name="API_DeleteProvisionedConcurrencyConfig_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_DeleteProvisionedConcurrencyConfig_RequestSyntax) **   <a name="lambda-DeleteProvisionedConcurrencyConfig-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?`   
Required: Yes

 ** [Qualifier](#API_DeleteProvisionedConcurrencyConfig_RequestSyntax) **   <a name="lambda-DeleteProvisionedConcurrencyConfig-request-uri-Qualifier"></a>
The version number or alias name.  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `(|[a-zA-Z0-9$_-]+)`   
Required: Yes

## Request Body
<a name="API_DeleteProvisionedConcurrencyConfig_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DeleteProvisionedConcurrencyConfig_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_DeleteProvisionedConcurrencyConfig_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 204 response with an empty HTTP body.

## Errors
<a name="API_DeleteProvisionedConcurrencyConfig_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_DeleteProvisionedConcurrencyConfig_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/DeleteProvisionedConcurrencyConfig) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/DeleteProvisionedConcurrencyConfig) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/DeleteProvisionedConcurrencyConfig) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/DeleteProvisionedConcurrencyConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/DeleteProvisionedConcurrencyConfig) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/DeleteProvisionedConcurrencyConfig) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/DeleteProvisionedConcurrencyConfig) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/DeleteProvisionedConcurrencyConfig) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/DeleteProvisionedConcurrencyConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/DeleteProvisionedConcurrencyConfig) 

# GetAccountSettings
<a name="API_GetAccountSettings"></a>

Retrieves details about your account's [limits](https://docs.aws.amazon.com/lambda/latest/dg/limits.html) and usage in an AWS Region.

## Request Syntax
<a name="API_GetAccountSettings_RequestSyntax"></a>

```
GET /2016-08-19/account-settings HTTP/1.1
```

## URI Request Parameters
<a name="API_GetAccountSettings_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_GetAccountSettings_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetAccountSettings_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AccountLimit": { 
      "CodeSizeUnzipped": number,
      "CodeSizeZipped": number,
      "ConcurrentExecutions": number,
      "TotalCodeSize": number,
      "UnreservedConcurrentExecutions": number
   },
   "AccountUsage": { 
      "FunctionCount": number,
      "TotalCodeSize": number
   }
}
```

## Response Elements
<a name="API_GetAccountSettings_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [AccountLimit](#API_GetAccountSettings_ResponseSyntax) **   <a name="lambda-GetAccountSettings-response-AccountLimit"></a>
Limits that are related to concurrency and code storage.  
Type: [AccountLimit](API_AccountLimit.md) object

 ** [AccountUsage](#API_GetAccountSettings_ResponseSyntax) **   <a name="lambda-GetAccountSettings-response-AccountUsage"></a>
The number of functions and amount of storage in use.  
Type: [AccountUsage](API_AccountUsage.md) object

## Errors
<a name="API_GetAccountSettings_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_GetAccountSettings_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/GetAccountSettings) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/GetAccountSettings) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetAccountSettings) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/GetAccountSettings) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetAccountSettings) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetAccountSettings) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/GetAccountSettings) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetAccountSettings) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetAccountSettings) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetAccountSettings) 

# GetAlias
<a name="API_GetAlias"></a>

Returns details about a Lambda function [alias](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html).

## Request Syntax
<a name="API_GetAlias_RequestSyntax"></a>

```
GET /2015-03-31/functions/FunctionName/aliases/Name HTTP/1.1
```

## URI Request Parameters
<a name="API_GetAlias_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_GetAlias_RequestSyntax) **   <a name="lambda-GetAlias-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?`   
Required: Yes

 ** [Name](#API_GetAlias_RequestSyntax) **   <a name="lambda-GetAlias-request-uri-Name"></a>
The name of the alias.  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `(?!^[0-9]+$)([a-zA-Z0-9-_]+)`   
Required: Yes

## Request Body
<a name="API_GetAlias_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetAlias_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AliasArn": "string",
   "Description": "string",
   "FunctionVersion": "string",
   "Name": "string",
   "RevisionId": "string",
   "RoutingConfig": { 
      "AdditionalVersionWeights": { 
         "string" : number 
      }
   }
}
```

## Response Elements
<a name="API_GetAlias_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [AliasArn](#API_GetAlias_ResponseSyntax) **   <a name="lambda-GetAlias-response-AliasArn"></a>
The Amazon Resource Name (ARN) of the alias.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 10000.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?` 

 ** [Description](#API_GetAlias_ResponseSyntax) **   <a name="lambda-GetAlias-response-Description"></a>
A description of the alias.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 256.

 ** [FunctionVersion](#API_GetAlias_ResponseSyntax) **   <a name="lambda-GetAlias-response-FunctionVersion"></a>
The function version that the alias invokes.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Pattern: `(\$LATEST|[0-9]+)` 

 ** [Name](#API_GetAlias_ResponseSyntax) **   <a name="lambda-GetAlias-response-Name"></a>
The name of the alias.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `(?!^[0-9]+$)([a-zA-Z0-9-_]+)` 

 ** [RevisionId](#API_GetAlias_ResponseSyntax) **   <a name="lambda-GetAlias-response-RevisionId"></a>
A unique identifier that changes when you update the alias.  
Type: String

 ** [RoutingConfig](#API_GetAlias_ResponseSyntax) **   <a name="lambda-GetAlias-response-RoutingConfig"></a>
The [routing configuration](https://docs.aws.amazon.com/lambda/latest/dg/lambda-traffic-shifting-using-aliases.html) of the alias.  
Type: [AliasRoutingConfiguration](API_AliasRoutingConfiguration.md) object

## Errors
<a name="API_GetAlias_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_GetAlias_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/GetAlias) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/GetAlias) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetAlias) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/GetAlias) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetAlias) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetAlias) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/GetAlias) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetAlias) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetAlias) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetAlias) 

# GetCapacityProvider
<a name="API_GetCapacityProvider"></a>

Retrieves information about a specific capacity provider, including its configuration, state, and associated resources.

## Request Syntax
<a name="API_GetCapacityProvider_RequestSyntax"></a>

```
GET /2025-11-30/capacity-providers/CapacityProviderName HTTP/1.1
```

## URI Request Parameters
<a name="API_GetCapacityProvider_RequestParameters"></a>

The request uses the following URI parameters.

 ** [CapacityProviderName](#API_GetCapacityProvider_RequestSyntax) **   <a name="lambda-GetCapacityProvider-request-uri-CapacityProviderName"></a>
The name of the capacity provider to retrieve.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:aws[a-zA-Z-]*:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:capacity-provider:[a-zA-Z0-9-_]+)|[a-zA-Z0-9-_]+`   
Required: Yes

## Request Body
<a name="API_GetCapacityProvider_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetCapacityProvider_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CapacityProvider": { 
      "CapacityProviderArn": "string",
      "CapacityProviderScalingConfig": { 
         "MaxVCpuCount": number,
         "ScalingMode": "string",
         "ScalingPolicies": [ 
            { 
               "PredefinedMetricType": "string",
               "TargetValue": number
            }
         ]
      },
      "InstanceRequirements": { 
         "AllowedInstanceTypes": [ "string" ],
         "Architectures": [ "string" ],
         "ExcludedInstanceTypes": [ "string" ]
      },
      "KmsKeyArn": "string",
      "LastModified": "string",
      "PermissionsConfig": { 
         "CapacityProviderOperatorRoleArn": "string"
      },
      "State": "string",
      "VpcConfig": { 
         "SecurityGroupIds": [ "string" ],
         "SubnetIds": [ "string" ]
      }
   }
}
```

## Response Elements
<a name="API_GetCapacityProvider_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [CapacityProvider](#API_GetCapacityProvider_ResponseSyntax) **   <a name="lambda-GetCapacityProvider-response-CapacityProvider"></a>
Information about the capacity provider, including its configuration and current state.  
Type: [CapacityProvider](API_CapacityProvider.md) object

## Errors
<a name="API_GetCapacityProvider_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_GetCapacityProvider_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/GetCapacityProvider) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/GetCapacityProvider) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetCapacityProvider) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/GetCapacityProvider) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetCapacityProvider) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetCapacityProvider) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/GetCapacityProvider) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetCapacityProvider) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetCapacityProvider) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetCapacityProvider) 

# GetCodeSigningConfig
<a name="API_GetCodeSigningConfig"></a>

Returns information about the specified code signing configuration.

## Request Syntax
<a name="API_GetCodeSigningConfig_RequestSyntax"></a>

```
GET /2020-04-22/code-signing-configs/CodeSigningConfigArn HTTP/1.1
```

## URI Request Parameters
<a name="API_GetCodeSigningConfig_RequestParameters"></a>

The request uses the following URI parameters.

 ** [CodeSigningConfigArn](#API_GetCodeSigningConfig_RequestSyntax) **   <a name="lambda-GetCodeSigningConfig-request-uri-CodeSigningConfigArn"></a>
The The Amazon Resource Name (ARN) of the code signing configuration.   
Length Constraints: Minimum length of 0. Maximum length of 200.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}:\d{12}:code-signing-config:csc-[a-z0-9]{17}`   
Required: Yes

## Request Body
<a name="API_GetCodeSigningConfig_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetCodeSigningConfig_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CodeSigningConfig": { 
      "AllowedPublishers": { 
         "SigningProfileVersionArns": [ "string" ]
      },
      "CodeSigningConfigArn": "string",
      "CodeSigningConfigId": "string",
      "CodeSigningPolicies": { 
         "UntrustedArtifactOnDeployment": "string"
      },
      "Description": "string",
      "LastModified": "string"
   }
}
```

## Response Elements
<a name="API_GetCodeSigningConfig_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [CodeSigningConfig](#API_GetCodeSigningConfig_ResponseSyntax) **   <a name="lambda-GetCodeSigningConfig-response-CodeSigningConfig"></a>
The code signing configuration  
Type: [CodeSigningConfig](API_CodeSigningConfig.md) object

## Errors
<a name="API_GetCodeSigningConfig_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

## See Also
<a name="API_GetCodeSigningConfig_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/GetCodeSigningConfig) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/GetCodeSigningConfig) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetCodeSigningConfig) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/GetCodeSigningConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetCodeSigningConfig) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetCodeSigningConfig) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/GetCodeSigningConfig) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetCodeSigningConfig) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetCodeSigningConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetCodeSigningConfig) 

# GetDurableExecution
<a name="API_GetDurableExecution"></a>

Retrieves detailed information about a specific [durable execution](https://docs.aws.amazon.com/lambda/latest/dg/durable-functions.html), including its current status, input payload, result or error information, and execution metadata such as start time and usage statistics.

## Request Syntax
<a name="API_GetDurableExecution_RequestSyntax"></a>

```
GET /2025-12-01/durable-executions/DurableExecutionArn HTTP/1.1
```

## URI Request Parameters
<a name="API_GetDurableExecution_RequestParameters"></a>

The request uses the following URI parameters.

 ** [DurableExecutionArn](#API_GetDurableExecution_RequestSyntax) **   <a name="lambda-GetDurableExecution-request-uri-DurableExecutionArn"></a>
The Amazon Resource Name (ARN) of the durable execution.  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Pattern: `arn:([a-zA-Z0-9-]+):lambda:([a-zA-Z0-9-]+):(\d{12}):function:([a-zA-Z0-9_-]+):(\$LATEST(?:\.PUBLISHED)?|[0-9]+)/durable-execution/([a-zA-Z0-9_-]+)/([a-zA-Z0-9_-]+)`   
Required: Yes

## Request Body
<a name="API_GetDurableExecution_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetDurableExecution_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "DurableExecutionArn": "string",
   "DurableExecutionName": "string",
   "EndTimestamp": number,
   "Error": { 
      "ErrorData": "string",
      "ErrorMessage": "string",
      "ErrorType": "string",
      "StackTrace": [ "string" ]
   },
   "FunctionArn": "string",
   "InputPayload": "string",
   "Result": "string",
   "StartTimestamp": number,
   "Status": "string",
   "TraceHeader": { 
      "XAmznTraceId": "string"
   },
   "Version": "string"
}
```

## Response Elements
<a name="API_GetDurableExecution_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [DurableExecutionArn](#API_GetDurableExecution_ResponseSyntax) **   <a name="lambda-GetDurableExecution-response-DurableExecutionArn"></a>
The Amazon Resource Name (ARN) of the durable execution.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Pattern: `arn:([a-zA-Z0-9-]+):lambda:([a-zA-Z0-9-]+):(\d{12}):function:([a-zA-Z0-9_-]+):(\$LATEST(?:\.PUBLISHED)?|[0-9]+)/durable-execution/([a-zA-Z0-9_-]+)/([a-zA-Z0-9_-]+)` 

 ** [DurableExecutionName](#API_GetDurableExecution_ResponseSyntax) **   <a name="lambda-GetDurableExecution-response-DurableExecutionName"></a>
The name of the durable execution. This is either the name you provided when invoking the function, or a system-generated unique identifier if no name was provided.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 64.  
Pattern: `[a-zA-Z0-9-_]+` 

 ** [EndTimestamp](#API_GetDurableExecution_ResponseSyntax) **   <a name="lambda-GetDurableExecution-response-EndTimestamp"></a>
The date and time when the durable execution ended, in Unix timestamp format. This field is only present if the execution has completed (status is `SUCCEEDED`, `FAILED`, `TIMED_OUT`, or `STOPPED`).  
Type: Timestamp

 ** [Error](#API_GetDurableExecution_ResponseSyntax) **   <a name="lambda-GetDurableExecution-response-Error"></a>
Error information if the durable execution failed. This field is only present when the execution status is `FAILED`, `TIMED_OUT`, or `STOPPED`. The combined size of all error fields is limited to 256 KB.  
Type: [ErrorObject](API_ErrorObject.md) object

 ** [FunctionArn](#API_GetDurableExecution_ResponseSyntax) **   <a name="lambda-GetDurableExecution-response-FunctionArn"></a>
The Amazon Resource Name (ARN) of the Lambda function that was invoked to start this durable execution.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 10000.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_\.]+(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?` 

 ** [InputPayload](#API_GetDurableExecution_ResponseSyntax) **   <a name="lambda-GetDurableExecution-response-InputPayload"></a>
The JSON input payload that was provided when the durable execution was started. For asynchronous invocations, this is limited to 256 KB. For synchronous invocations, this can be up to 6 MB.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 6291456.

 ** [Result](#API_GetDurableExecution_ResponseSyntax) **   <a name="lambda-GetDurableExecution-response-Result"></a>
The JSON result returned by the durable execution if it completed successfully. This field is only present when the execution status is `SUCCEEDED`. The result is limited to 256 KB.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 6291456.

 ** [StartTimestamp](#API_GetDurableExecution_ResponseSyntax) **   <a name="lambda-GetDurableExecution-response-StartTimestamp"></a>
The date and time when the durable execution started, in Unix timestamp format.  
Type: Timestamp

 ** [Status](#API_GetDurableExecution_ResponseSyntax) **   <a name="lambda-GetDurableExecution-response-Status"></a>
The current status of the durable execution. Valid values are `RUNNING`, `SUCCEEDED`, `FAILED`, `TIMED_OUT`, and `STOPPED`.  
Type: String  
Valid Values: `RUNNING | SUCCEEDED | FAILED | TIMED_OUT | STOPPED` 

 ** [TraceHeader](#API_GetDurableExecution_ResponseSyntax) **   <a name="lambda-GetDurableExecution-response-TraceHeader"></a>
The trace headers associated with the durable execution.  
Type: [TraceHeader](API_TraceHeader.md) object

 ** [Version](#API_GetDurableExecution_ResponseSyntax) **   <a name="lambda-GetDurableExecution-response-Version"></a>
The version of the Lambda function that was invoked for this durable execution. This ensures that all replays during the execution use the same function version.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Pattern: `(\$LATEST(\.PUBLISHED)?|[0-9]+)` 

## Errors
<a name="API_GetDurableExecution_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_GetDurableExecution_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/GetDurableExecution) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/GetDurableExecution) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetDurableExecution) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/GetDurableExecution) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetDurableExecution) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetDurableExecution) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/GetDurableExecution) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetDurableExecution) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetDurableExecution) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetDurableExecution) 

# GetDurableExecutionHistory
<a name="API_GetDurableExecutionHistory"></a>

Retrieves the execution history for a [durable execution](https://docs.aws.amazon.com/lambda/latest/dg/durable-functions.html), showing all the steps, callbacks, and events that occurred during the execution. This provides a detailed audit trail of the execution's progress over time.

The history is available while the execution is running and for a retention period after it completes (1-90 days, default 30 days). You can control whether to include execution data such as step results and callback payloads.

## Request Syntax
<a name="API_GetDurableExecutionHistory_RequestSyntax"></a>

```
GET /2025-12-01/durable-executions/DurableExecutionArn/history?IncludeExecutionData=IncludeExecutionData&Marker=Marker&MaxItems=MaxItems&ReverseOrder=ReverseOrder HTTP/1.1
```

## URI Request Parameters
<a name="API_GetDurableExecutionHistory_RequestParameters"></a>

The request uses the following URI parameters.

 ** [DurableExecutionArn](#API_GetDurableExecutionHistory_RequestSyntax) **   <a name="lambda-GetDurableExecutionHistory-request-uri-DurableExecutionArn"></a>
The Amazon Resource Name (ARN) of the durable execution.  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Pattern: `arn:([a-zA-Z0-9-]+):lambda:([a-zA-Z0-9-]+):(\d{12}):function:([a-zA-Z0-9_-]+):(\$LATEST(?:\.PUBLISHED)?|[0-9]+)/durable-execution/([a-zA-Z0-9_-]+)/([a-zA-Z0-9_-]+)`   
Required: Yes

 ** [IncludeExecutionData](#API_GetDurableExecutionHistory_RequestSyntax) **   <a name="lambda-GetDurableExecutionHistory-request-uri-IncludeExecutionData"></a>
Specifies whether to include execution data such as step results and callback payloads in the history events. Set to `true` to include data, or `false` to exclude it for a more compact response. The default is `true`.

 ** [Marker](#API_GetDurableExecutionHistory_RequestSyntax) **   <a name="lambda-GetDurableExecutionHistory-request-uri-Marker"></a>
If `NextMarker` was returned from a previous request, use this value to retrieve the next page of results. Each pagination token expires after 24 hours.

 ** [MaxItems](#API_GetDurableExecutionHistory_RequestSyntax) **   <a name="lambda-GetDurableExecutionHistory-request-uri-MaxItems"></a>
The maximum number of history events to return per call. You can use `Marker` to retrieve additional pages of results. The default is 100 and the maximum allowed is 1000. A value of 0 uses the default.  
Valid Range: Minimum value of 0. Maximum value of 1000.

 ** [ReverseOrder](#API_GetDurableExecutionHistory_RequestSyntax) **   <a name="lambda-GetDurableExecutionHistory-request-uri-ReverseOrder"></a>
When set to `true`, returns the history events in reverse chronological order (newest first). By default, events are returned in chronological order (oldest first).

## Request Body
<a name="API_GetDurableExecutionHistory_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetDurableExecutionHistory_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Events": [ 
      { 
         "CallbackFailedDetails": { 
            "Error": { 
               "Payload": { 
                  "ErrorData": "string",
                  "ErrorMessage": "string",
                  "ErrorType": "string",
                  "StackTrace": [ "string" ]
               },
               "Truncated": boolean
            }
         },
         "CallbackStartedDetails": { 
            "CallbackId": "string",
            "HeartbeatTimeout": number,
            "Timeout": number
         },
         "CallbackSucceededDetails": { 
            "Result": { 
               "Payload": "string",
               "Truncated": boolean
            }
         },
         "CallbackTimedOutDetails": { 
            "Error": { 
               "Payload": { 
                  "ErrorData": "string",
                  "ErrorMessage": "string",
                  "ErrorType": "string",
                  "StackTrace": [ "string" ]
               },
               "Truncated": boolean
            }
         },
         "ChainedInvokeFailedDetails": { 
            "Error": { 
               "Payload": { 
                  "ErrorData": "string",
                  "ErrorMessage": "string",
                  "ErrorType": "string",
                  "StackTrace": [ "string" ]
               },
               "Truncated": boolean
            }
         },
         "ChainedInvokeStartedDetails": { 
            "DurableExecutionArn": "string",
            "ExecutedVersion": "string",
            "FunctionName": "string",
            "Input": { 
               "Payload": "string",
               "Truncated": boolean
            },
            "TenantId": "string"
         },
         "ChainedInvokeStoppedDetails": { 
            "Error": { 
               "Payload": { 
                  "ErrorData": "string",
                  "ErrorMessage": "string",
                  "ErrorType": "string",
                  "StackTrace": [ "string" ]
               },
               "Truncated": boolean
            }
         },
         "ChainedInvokeSucceededDetails": { 
            "Result": { 
               "Payload": "string",
               "Truncated": boolean
            }
         },
         "ChainedInvokeTimedOutDetails": { 
            "Error": { 
               "Payload": { 
                  "ErrorData": "string",
                  "ErrorMessage": "string",
                  "ErrorType": "string",
                  "StackTrace": [ "string" ]
               },
               "Truncated": boolean
            }
         },
         "ContextFailedDetails": { 
            "Error": { 
               "Payload": { 
                  "ErrorData": "string",
                  "ErrorMessage": "string",
                  "ErrorType": "string",
                  "StackTrace": [ "string" ]
               },
               "Truncated": boolean
            }
         },
         "ContextStartedDetails": { 
         },
         "ContextSucceededDetails": { 
            "Result": { 
               "Payload": "string",
               "Truncated": boolean
            }
         },
         "EventId": number,
         "EventTimestamp": number,
         "EventType": "string",
         "ExecutionFailedDetails": { 
            "Error": { 
               "Payload": { 
                  "ErrorData": "string",
                  "ErrorMessage": "string",
                  "ErrorType": "string",
                  "StackTrace": [ "string" ]
               },
               "Truncated": boolean
            }
         },
         "ExecutionStartedDetails": { 
            "ExecutionTimeout": number,
            "Input": { 
               "Payload": "string",
               "Truncated": boolean
            }
         },
         "ExecutionStoppedDetails": { 
            "Error": { 
               "Payload": { 
                  "ErrorData": "string",
                  "ErrorMessage": "string",
                  "ErrorType": "string",
                  "StackTrace": [ "string" ]
               },
               "Truncated": boolean
            }
         },
         "ExecutionSucceededDetails": { 
            "Result": { 
               "Payload": "string",
               "Truncated": boolean
            }
         },
         "ExecutionTimedOutDetails": { 
            "Error": { 
               "Payload": { 
                  "ErrorData": "string",
                  "ErrorMessage": "string",
                  "ErrorType": "string",
                  "StackTrace": [ "string" ]
               },
               "Truncated": boolean
            }
         },
         "Id": "string",
         "InvocationCompletedDetails": { 
            "EndTimestamp": number,
            "Error": { 
               "Payload": { 
                  "ErrorData": "string",
                  "ErrorMessage": "string",
                  "ErrorType": "string",
                  "StackTrace": [ "string" ]
               },
               "Truncated": boolean
            },
            "RequestId": "string",
            "StartTimestamp": number
         },
         "Name": "string",
         "ParentId": "string",
         "StepFailedDetails": { 
            "Error": { 
               "Payload": { 
                  "ErrorData": "string",
                  "ErrorMessage": "string",
                  "ErrorType": "string",
                  "StackTrace": [ "string" ]
               },
               "Truncated": boolean
            },
            "RetryDetails": { 
               "CurrentAttempt": number,
               "NextAttemptDelaySeconds": number
            }
         },
         "StepStartedDetails": { 
         },
         "StepSucceededDetails": { 
            "Result": { 
               "Payload": "string",
               "Truncated": boolean
            },
            "RetryDetails": { 
               "CurrentAttempt": number,
               "NextAttemptDelaySeconds": number
            }
         },
         "SubType": "string",
         "WaitCancelledDetails": { 
            "Error": { 
               "Payload": { 
                  "ErrorData": "string",
                  "ErrorMessage": "string",
                  "ErrorType": "string",
                  "StackTrace": [ "string" ]
               },
               "Truncated": boolean
            }
         },
         "WaitStartedDetails": { 
            "Duration": number,
            "ScheduledEndTimestamp": number
         },
         "WaitSucceededDetails": { 
            "Duration": number
         }
      }
   ],
   "NextMarker": "string"
}
```

## Response Elements
<a name="API_GetDurableExecutionHistory_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [Events](#API_GetDurableExecutionHistory_ResponseSyntax) **   <a name="lambda-GetDurableExecutionHistory-response-Events"></a>
An array of execution history events, ordered chronologically unless `ReverseOrder` is set to `true`. Each event represents a significant occurrence during the execution, such as step completion or callback resolution.  
Type: Array of [Event](API_Event.md) objects

 ** [NextMarker](#API_GetDurableExecutionHistory_ResponseSyntax) **   <a name="lambda-GetDurableExecutionHistory-response-NextMarker"></a>
If present, indicates that more history events are available. Use this value as the `Marker` parameter in a subsequent request to retrieve the next page of results.  
Type: String

## Errors
<a name="API_GetDurableExecutionHistory_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_GetDurableExecutionHistory_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/GetDurableExecutionHistory) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/GetDurableExecutionHistory) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetDurableExecutionHistory) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/GetDurableExecutionHistory) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetDurableExecutionHistory) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetDurableExecutionHistory) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/GetDurableExecutionHistory) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetDurableExecutionHistory) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetDurableExecutionHistory) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetDurableExecutionHistory) 

# GetDurableExecutionState
<a name="API_GetDurableExecutionState"></a>

Retrieves the current execution state required for the replay process during [durable function](https://docs.aws.amazon.com/lambda/latest/dg/durable-functions.html) execution. This API is used by the Lambda durable functions SDK to get state information needed for replay. You typically don't need to call this API directly as the SDK handles state management automatically.

The response contains operations ordered by start sequence number in ascending order. Completed operations with children don't include child operation details since they don't need to be replayed.

## Request Syntax
<a name="API_GetDurableExecutionState_RequestSyntax"></a>

```
GET /2025-12-01/durable-executions/DurableExecutionArn/state?CheckpointToken=CheckpointToken&Marker=Marker&MaxItems=MaxItems HTTP/1.1
```

## URI Request Parameters
<a name="API_GetDurableExecutionState_RequestParameters"></a>

The request uses the following URI parameters.

 ** [CheckpointToken](#API_GetDurableExecutionState_RequestSyntax) **   <a name="lambda-GetDurableExecutionState-request-uri-CheckpointToken"></a>
A checkpoint token that identifies the current state of the execution. This token is provided by the Lambda runtime and ensures that state retrieval is consistent with the current execution context.  
Length Constraints: Minimum length of 1. Maximum length of 2048.  
Pattern: `[A-Za-z0-9+/]+={0,2}`   
Required: Yes

 ** [DurableExecutionArn](#API_GetDurableExecutionState_RequestSyntax) **   <a name="lambda-GetDurableExecutionState-request-uri-DurableExecutionArn"></a>
The Amazon Resource Name (ARN) of the durable execution.  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Pattern: `arn:([a-zA-Z0-9-]+):lambda:([a-zA-Z0-9-]+):(\d{12}):function:([a-zA-Z0-9_-]+):(\$LATEST(?:\.PUBLISHED)?|[0-9]+)/durable-execution/([a-zA-Z0-9_-]+)/([a-zA-Z0-9_-]+)`   
Required: Yes

 ** [Marker](#API_GetDurableExecutionState_RequestSyntax) **   <a name="lambda-GetDurableExecutionState-request-uri-Marker"></a>
If `NextMarker` was returned from a previous request, use this value to retrieve the next page of operations. Each pagination token expires after 24 hours.

 ** [MaxItems](#API_GetDurableExecutionState_RequestSyntax) **   <a name="lambda-GetDurableExecutionState-request-uri-MaxItems"></a>
The maximum number of operations to return per call. You can use `Marker` to retrieve additional pages of results. The default is 100 and the maximum allowed is 1000. A value of 0 uses the default.  
Valid Range: Minimum value of 0. Maximum value of 1000.

## Request Body
<a name="API_GetDurableExecutionState_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetDurableExecutionState_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextMarker": "string",
   "Operations": [ 
      { 
         "CallbackDetails": { 
            "CallbackId": "string",
            "Error": { 
               "ErrorData": "string",
               "ErrorMessage": "string",
               "ErrorType": "string",
               "StackTrace": [ "string" ]
            },
            "Result": "string"
         },
         "ChainedInvokeDetails": { 
            "Error": { 
               "ErrorData": "string",
               "ErrorMessage": "string",
               "ErrorType": "string",
               "StackTrace": [ "string" ]
            },
            "Result": "string"
         },
         "ContextDetails": { 
            "Error": { 
               "ErrorData": "string",
               "ErrorMessage": "string",
               "ErrorType": "string",
               "StackTrace": [ "string" ]
            },
            "ReplayChildren": boolean,
            "Result": "string"
         },
         "EndTimestamp": number,
         "ExecutionDetails": { 
            "InputPayload": "string"
         },
         "Id": "string",
         "Name": "string",
         "ParentId": "string",
         "StartTimestamp": number,
         "Status": "string",
         "StepDetails": { 
            "Attempt": number,
            "Error": { 
               "ErrorData": "string",
               "ErrorMessage": "string",
               "ErrorType": "string",
               "StackTrace": [ "string" ]
            },
            "NextAttemptTimestamp": number,
            "Result": "string"
         },
         "SubType": "string",
         "Type": "string",
         "WaitDetails": { 
            "ScheduledEndTimestamp": number
         }
      }
   ]
}
```

## Response Elements
<a name="API_GetDurableExecutionState_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [NextMarker](#API_GetDurableExecutionState_ResponseSyntax) **   <a name="lambda-GetDurableExecutionState-response-NextMarker"></a>
If present, indicates that more operations are available. Use this value as the `Marker` parameter in a subsequent request to retrieve the next page of results.  
Type: String

 ** [Operations](#API_GetDurableExecutionState_ResponseSyntax) **   <a name="lambda-GetDurableExecutionState-response-Operations"></a>
An array of operations that represent the current state of the durable execution. Operations are ordered by their start sequence number in ascending order and include information needed for replay processing.  
Type: Array of [Operation](API_Operation.md) objects

## Errors
<a name="API_GetDurableExecutionState_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_GetDurableExecutionState_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/GetDurableExecutionState) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/GetDurableExecutionState) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetDurableExecutionState) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/GetDurableExecutionState) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetDurableExecutionState) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetDurableExecutionState) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/GetDurableExecutionState) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetDurableExecutionState) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetDurableExecutionState) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetDurableExecutionState) 

# GetEventSourceMapping
<a name="API_GetEventSourceMapping"></a>

Returns details about an event source mapping. You can get the identifier of a mapping from the output of [ListEventSourceMappings](API_ListEventSourceMappings.md).

## Request Syntax
<a name="API_GetEventSourceMapping_RequestSyntax"></a>

```
GET /2015-03-31/event-source-mappings/UUID HTTP/1.1
```

## URI Request Parameters
<a name="API_GetEventSourceMapping_RequestParameters"></a>

The request uses the following URI parameters.

 ** [UUID](#API_GetEventSourceMapping_RequestSyntax) **   <a name="lambda-GetEventSourceMapping-request-uri-UUID"></a>
The identifier of the event source mapping.  
Required: Yes

## Request Body
<a name="API_GetEventSourceMapping_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetEventSourceMapping_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AmazonManagedKafkaEventSourceConfig": { 
      "ConsumerGroupId": "string",
      "SchemaRegistryConfig": { 
         "AccessConfigs": [ 
            { 
               "Type": "string",
               "URI": "string"
            }
         ],
         "EventRecordFormat": "string",
         "SchemaRegistryURI": "string",
         "SchemaValidationConfigs": [ 
            { 
               "Attribute": "string"
            }
         ]
      }
   },
   "BatchSize": number,
   "BisectBatchOnFunctionError": boolean,
   "DestinationConfig": { 
      "OnFailure": { 
         "Destination": "string"
      },
      "OnSuccess": { 
         "Destination": "string"
      }
   },
   "DocumentDBEventSourceConfig": { 
      "CollectionName": "string",
      "DatabaseName": "string",
      "FullDocument": "string"
   },
   "EventSourceArn": "string",
   "EventSourceMappingArn": "string",
   "FilterCriteria": { 
      "Filters": [ 
         { 
            "Pattern": "string"
         }
      ]
   },
   "FilterCriteriaError": { 
      "ErrorCode": "string",
      "Message": "string"
   },
   "FunctionArn": "string",
   "FunctionResponseTypes": [ "string" ],
   "KMSKeyArn": "string",
   "LastModified": number,
   "LastProcessingResult": "string",
   "LoggingConfig": { 
      "SystemLogLevel": "string"
   },
   "MaximumBatchingWindowInSeconds": number,
   "MaximumRecordAgeInSeconds": number,
   "MaximumRetryAttempts": number,
   "MetricsConfig": { 
      "Metrics": [ "string" ]
   },
   "ParallelizationFactor": number,
   "ProvisionedPollerConfig": { 
      "MaximumPollers": number,
      "MinimumPollers": number,
      "PollerGroupName": "string"
   },
   "Queues": [ "string" ],
   "ScalingConfig": { 
      "MaximumConcurrency": number
   },
   "SelfManagedEventSource": { 
      "Endpoints": { 
         "string" : [ "string" ]
      }
   },
   "SelfManagedKafkaEventSourceConfig": { 
      "ConsumerGroupId": "string",
      "SchemaRegistryConfig": { 
         "AccessConfigs": [ 
            { 
               "Type": "string",
               "URI": "string"
            }
         ],
         "EventRecordFormat": "string",
         "SchemaRegistryURI": "string",
         "SchemaValidationConfigs": [ 
            { 
               "Attribute": "string"
            }
         ]
      }
   },
   "SourceAccessConfigurations": [ 
      { 
         "Type": "string",
         "URI": "string"
      }
   ],
   "StartingPosition": "string",
   "StartingPositionTimestamp": number,
   "State": "string",
   "StateTransitionReason": "string",
   "Topics": [ "string" ],
   "TumblingWindowInSeconds": number,
   "UUID": "string"
}
```

## Response Elements
<a name="API_GetEventSourceMapping_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [AmazonManagedKafkaEventSourceConfig](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-AmazonManagedKafkaEventSourceConfig"></a>
Specific configuration settings for an Amazon Managed Streaming for Apache Kafka (Amazon MSK) event source.  
Type: [AmazonManagedKafkaEventSourceConfig](API_AmazonManagedKafkaEventSourceConfig.md) object

 ** [BatchSize](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-BatchSize"></a>
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.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 10000.

 ** [BisectBatchOnFunctionError](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-BisectBatchOnFunctionError"></a>
(Kinesis, DynamoDB Streams, Amazon MSK, and self-managed Apache Kafka) If the function returns an error, split the batch in two and retry. The default value is false.  
Type: Boolean

 ** [DestinationConfig](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-DestinationConfig"></a>
(Kinesis, DynamoDB Streams, Amazon MSK, and self-managed Apache Kafka) A configuration object that specifies the destination of an event after Lambda processes it.  
Type: [DestinationConfig](API_DestinationConfig.md) object

 ** [DocumentDBEventSourceConfig](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-DocumentDBEventSourceConfig"></a>
Specific configuration settings for a DocumentDB event source.  
Type: [DocumentDBEventSourceConfig](API_DocumentDBEventSourceConfig.md) object

 ** [EventSourceArn](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-EventSourceArn"></a>
The Amazon Resource Name (ARN) of the event source.  
Type: String  
Pattern: `arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` 

 ** [EventSourceMappingArn](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-EventSourceMappingArn"></a>
The Amazon Resource Name (ARN) of the event source mapping.  
Type: String  
Length Constraints: Minimum length of 85. Maximum length of 120.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:event-source-mapping:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}` 

 ** [FilterCriteria](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-FilterCriteria"></a>
An object that defines the filter criteria that determine whether Lambda should process an event. For more information, see [Lambda event filtering](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html).  
If filter criteria is encrypted, this field shows up as `null` in the response of ListEventSourceMapping API calls. You can view this field in plaintext in the response of GetEventSourceMapping and DeleteEventSourceMapping calls if you have `kms:Decrypt` permissions for the correct AWS KMS key.  
Type: [FilterCriteria](API_FilterCriteria.md) object

 ** [FilterCriteriaError](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-FilterCriteriaError"></a>
An object that contains details about an error related to filter criteria encryption.  
Type: [FilterCriteriaError](API_FilterCriteriaError.md) object

 ** [FunctionArn](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-FunctionArn"></a>
The ARN of the Lambda function.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 10000.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?` 

 ** [FunctionResponseTypes](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-FunctionResponseTypes"></a>
(Kinesis, DynamoDB Streams, Amazon MSK, self-managed Apache Kafka, and Amazon SQS) A list of current response type enums applied to the event source mapping.  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 1 item.  
Valid Values: `ReportBatchItemFailures` 

 ** [KMSKeyArn](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-KMSKeyArn"></a>
 The ARN of the AWS Key Management Service (AWS KMS) customer managed key that Lambda uses to encrypt your function's [filter criteria](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html#filtering-basics).  
Type: String  
Pattern: `(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()` 

 ** [LastModified](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-LastModified"></a>
The date that the event source mapping was last updated or that its state changed, in Unix time seconds.  
Type: Timestamp

 ** [LastProcessingResult](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-LastProcessingResult"></a>
The result of the event source mapping's last processing attempt.  
Type: String

 ** [LoggingConfig](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-LoggingConfig"></a>
(Amazon MSK, and self-managed Apache Kafka only) The logging configuration for your event source. For more information, see [Event source mapping logging](https://docs.aws.amazon.com/lambda/latest/dg/esm-logging.html).  
Type: [EventSourceMappingLoggingConfig](API_EventSourceMappingLoggingConfig.md) object

 ** [MaximumBatchingWindowInSeconds](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-MaximumBatchingWindowInSeconds"></a>
The maximum amount of time, in seconds, that Lambda spends gathering records before invoking the function. You can configure `MaximumBatchingWindowInSeconds` to any value from 0 seconds to 300 seconds in increments of seconds.  
For streams and Amazon SQS event sources, the default batching window is 0 seconds. For Amazon MSK, Self-managed Apache Kafka, Amazon MQ, and DocumentDB event sources, the default batching window is 500 ms. Note that because you can only change `MaximumBatchingWindowInSeconds` in increments of seconds, you cannot revert back to the 500 ms default batching window after you have changed it. To restore the default batching window, you must create a new event source mapping.  
Related setting: For streams and Amazon SQS event sources, when you set `BatchSize` to a value greater than 10, you must set `MaximumBatchingWindowInSeconds` to at least 1.  
Type: Integer  
Valid Range: Minimum value of 0. Maximum value of 300.

 ** [MaximumRecordAgeInSeconds](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-MaximumRecordAgeInSeconds"></a>
(Kinesis, DynamoDB Streams, Amazon MSK, and self-managed Apache Kafka) 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.  
The minimum valid value for maximum record age is 60s. Although values less than 60 and greater than -1 fall within the parameter's absolute range, they are not allowed
Type: Integer  
Valid Range: Minimum value of -1. Maximum value of 604800.

 ** [MaximumRetryAttempts](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-MaximumRetryAttempts"></a>
(Kinesis, DynamoDB Streams, Amazon MSK, and self-managed Apache Kafka) 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.  
Type: Integer  
Valid Range: Minimum value of -1. Maximum value of 10000.

 ** [MetricsConfig](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-MetricsConfig"></a>
The metrics configuration for your event source. For more information, see [Event source mapping metrics](https://docs.aws.amazon.com/lambda/latest/dg/monitoring-metrics-types.html#event-source-mapping-metrics).  
Type: [EventSourceMappingMetricsConfig](API_EventSourceMappingMetricsConfig.md) object

 ** [ParallelizationFactor](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-ParallelizationFactor"></a>
(Kinesis and DynamoDB Streams only) The number of batches to process concurrently from each shard. The default value is 1.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 10.

 ** [ProvisionedPollerConfig](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-ProvisionedPollerConfig"></a>
(Amazon SQS, Amazon MSK, and self-managed Apache Kafka only) The provisioned mode configuration for the event source. For more information, see [provisioned mode](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventsourcemapping.html#invocation-eventsourcemapping-provisioned-mode).  
Type: [ProvisionedPollerConfig](API_ProvisionedPollerConfig.md) object

 ** [Queues](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-Queues"></a>
 (Amazon MQ) The name of the Amazon MQ broker destination queue to consume.  
Type: Array of strings  
Array Members: Fixed number of 1 item.  
Length Constraints: Minimum length of 1. Maximum length of 1000.  
Pattern: `[\s\S]*` 

 ** [ScalingConfig](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-ScalingConfig"></a>
(Amazon SQS only) The scaling configuration for the event source. For more information, see [Configuring maximum concurrency for Amazon SQS event sources](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#events-sqs-max-concurrency).  
Type: [ScalingConfig](API_ScalingConfig.md) object

 ** [SelfManagedEventSource](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-SelfManagedEventSource"></a>
The self-managed Apache Kafka cluster for your event source.  
Type: [SelfManagedEventSource](API_SelfManagedEventSource.md) object

 ** [SelfManagedKafkaEventSourceConfig](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-SelfManagedKafkaEventSourceConfig"></a>
Specific configuration settings for a self-managed Apache Kafka event source.  
Type: [SelfManagedKafkaEventSourceConfig](API_SelfManagedKafkaEventSourceConfig.md) object

 ** [SourceAccessConfigurations](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-SourceAccessConfigurations"></a>
An array of the authentication protocol, VPC components, or virtual host to secure and define your event source.  
Type: Array of [SourceAccessConfiguration](API_SourceAccessConfiguration.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 22 items.

 ** [StartingPosition](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-StartingPosition"></a>
The position in a stream from which to start reading. Required for Amazon Kinesis and Amazon DynamoDB Stream event sources. `AT_TIMESTAMP` is supported only for Amazon Kinesis streams, Amazon DocumentDB, Amazon MSK, and self-managed Apache Kafka.  
Type: String  
Valid Values: `TRIM_HORIZON | LATEST | AT_TIMESTAMP` 

 ** [StartingPositionTimestamp](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-StartingPositionTimestamp"></a>
With `StartingPosition` set to `AT_TIMESTAMP`, the time from which to start reading, in Unix time seconds. `StartingPositionTimestamp` cannot be in the future.  
Type: Timestamp

 ** [State](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-State"></a>
The state of the event source mapping. It can be one of the following: `Creating`, `Enabling`, `Enabled`, `Disabling`, `Disabled`, `Updating`, or `Deleting`.  
Type: String

 ** [StateTransitionReason](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-StateTransitionReason"></a>
Indicates whether a user or Lambda made the last change to the event source mapping.  
Type: String

 ** [Topics](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-Topics"></a>
The name of the Kafka topic.  
Type: Array of strings  
Array Members: Fixed number of 1 item.  
Length Constraints: Minimum length of 1. Maximum length of 249.  
Pattern: `[^.]([a-zA-Z0-9\-_.]+)` 

 ** [TumblingWindowInSeconds](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-TumblingWindowInSeconds"></a>
(Kinesis and DynamoDB Streams only) The duration in seconds of a processing window for DynamoDB and Kinesis Streams event sources. A value of 0 seconds indicates no tumbling window.  
Type: Integer  
Valid Range: Minimum value of 0. Maximum value of 900.

 ** [UUID](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-UUID"></a>
The identifier of the event source mapping.  
Type: String

## Errors
<a name="API_GetEventSourceMapping_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_GetEventSourceMapping_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/GetEventSourceMapping) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/GetEventSourceMapping) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetEventSourceMapping) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/GetEventSourceMapping) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetEventSourceMapping) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetEventSourceMapping) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/GetEventSourceMapping) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetEventSourceMapping) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetEventSourceMapping) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetEventSourceMapping) 

# GetFunction
<a name="API_GetFunction"></a>

Returns information about the function or function version, with a link to download the deployment package that's valid for 10 minutes. If you specify a function version, only details that are specific to that version are returned.

## Request Syntax
<a name="API_GetFunction_RequestSyntax"></a>

```
GET /2015-03-31/functions/FunctionName?Qualifier=Qualifier HTTP/1.1
```

## URI Request Parameters
<a name="API_GetFunction_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_GetFunction_RequestSyntax) **   <a name="lambda-GetFunction-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?`   
Required: Yes

 ** [Qualifier](#API_GetFunction_RequestSyntax) **   <a name="lambda-GetFunction-request-uri-Qualifier"></a>
Specify a version or alias to get details about a published version of the function.  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `\$(LATEST(\.PUBLISHED)?)|[a-zA-Z0-9-_$]+` 

## Request Body
<a name="API_GetFunction_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetFunction_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Code": { 
      "ImageUri": "string",
      "Location": "string",
      "RepositoryType": "string",
      "ResolvedImageUri": "string",
      "SourceKMSKeyArn": "string"
   },
   "Concurrency": { 
      "ReservedConcurrentExecutions": number
   },
   "Configuration": { 
      "Architectures": [ "string" ],
      "CapacityProviderConfig": { 
         "LambdaManagedInstancesCapacityProviderConfig": { 
            "CapacityProviderArn": "string",
            "ExecutionEnvironmentMemoryGiBPerVCpu": number,
            "PerExecutionEnvironmentMaxConcurrency": number
         }
      },
      "CodeSha256": "string",
      "CodeSize": number,
      "ConfigSha256": "string",
      "DeadLetterConfig": { 
         "TargetArn": "string"
      },
      "Description": "string",
      "DurableConfig": { 
         "ExecutionTimeout": number,
         "RetentionPeriodInDays": number
      },
      "Environment": { 
         "Error": { 
            "ErrorCode": "string",
            "Message": "string"
         },
         "Variables": { 
            "string" : "string" 
         }
      },
      "EphemeralStorage": { 
         "Size": number
      },
      "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"
         }
      ],
      "LoggingConfig": { 
         "ApplicationLogLevel": "string",
         "LogFormat": "string",
         "LogGroup": "string",
         "SystemLogLevel": "string"
      },
      "MasterArn": "string",
      "MemorySize": number,
      "PackageType": "string",
      "RevisionId": "string",
      "Role": "string",
      "Runtime": "string",
      "RuntimeVersionConfig": { 
         "Error": { 
            "ErrorCode": "string",
            "Message": "string"
         },
         "RuntimeVersionArn": "string"
      },
      "SigningJobArn": "string",
      "SigningProfileVersionArn": "string",
      "SnapStart": { 
         "ApplyOn": "string",
         "OptimizationStatus": "string"
      },
      "State": "string",
      "StateReason": "string",
      "StateReasonCode": "string",
      "TenancyConfig": { 
         "TenantIsolationMode": "string"
      },
      "Timeout": number,
      "TracingConfig": { 
         "Mode": "string"
      },
      "Version": "string",
      "VpcConfig": { 
         "Ipv6AllowedForDualStack": boolean,
         "SecurityGroupIds": [ "string" ],
         "SubnetIds": [ "string" ],
         "VpcId": "string"
      }
   },
   "Tags": { 
      "string" : "string" 
   },
   "TagsError": { 
      "ErrorCode": "string",
      "Message": "string"
   }
}
```

## Response Elements
<a name="API_GetFunction_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [Code](#API_GetFunction_ResponseSyntax) **   <a name="lambda-GetFunction-response-Code"></a>
The deployment package of the function or version.  
Type: [FunctionCodeLocation](API_FunctionCodeLocation.md) object

 ** [Concurrency](#API_GetFunction_ResponseSyntax) **   <a name="lambda-GetFunction-response-Concurrency"></a>
The function's [reserved concurrency](https://docs.aws.amazon.com/lambda/latest/dg/concurrent-executions.html).  
Type: [Concurrency](API_Concurrency.md) object

 ** [Configuration](#API_GetFunction_ResponseSyntax) **   <a name="lambda-GetFunction-response-Configuration"></a>
The configuration of the function or version.  
Type: [FunctionConfiguration](API_FunctionConfiguration.md) object

 ** [Tags](#API_GetFunction_ResponseSyntax) **   <a name="lambda-GetFunction-response-Tags"></a>
The function's [tags](https://docs.aws.amazon.com/lambda/latest/dg/tagging.html). Lambda returns tag data only if you have explicit allow permissions for [lambda:ListTags](https://docs.aws.amazon.com/lambda/latest/api/API_ListTags.html).  
Type: String to string map

 ** [TagsError](#API_GetFunction_ResponseSyntax) **   <a name="lambda-GetFunction-response-TagsError"></a>
An object that contains details about an error related to retrieving tags.  
Type: [TagsError](API_TagsError.md) object

## Errors
<a name="API_GetFunction_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_GetFunction_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/GetFunction) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/GetFunction) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetFunction) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/GetFunction) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetFunction) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetFunction) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/GetFunction) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetFunction) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetFunction) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetFunction) 

# GetFunctionCodeSigningConfig
<a name="API_GetFunctionCodeSigningConfig"></a>

Returns the code signing configuration for the specified function.

## Request Syntax
<a name="API_GetFunctionCodeSigningConfig_RequestSyntax"></a>

```
GET /2020-06-30/functions/FunctionName/code-signing-config HTTP/1.1
```

## URI Request Parameters
<a name="API_GetFunctionCodeSigningConfig_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_GetFunctionCodeSigningConfig_RequestSyntax) **   <a name="lambda-GetFunctionCodeSigningConfig-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?`   
Required: Yes

## Request Body
<a name="API_GetFunctionCodeSigningConfig_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetFunctionCodeSigningConfig_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CodeSigningConfigArn": "string",
   "FunctionName": "string"
}
```

## Response Elements
<a name="API_GetFunctionCodeSigningConfig_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [CodeSigningConfigArn](#API_GetFunctionCodeSigningConfig_ResponseSyntax) **   <a name="lambda-GetFunctionCodeSigningConfig-response-CodeSigningConfigArn"></a>
The The Amazon Resource Name (ARN) of the code signing configuration.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 200.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}:\d{12}:code-signing-config:csc-[a-z0-9]{17}` 

 ** [FunctionName](#API_GetFunctionCodeSigningConfig_ResponseSyntax) **   <a name="lambda-GetFunctionCodeSigningConfig-response-FunctionName"></a>
The name or ARN 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.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?` 

## Errors
<a name="API_GetFunctionCodeSigningConfig_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_GetFunctionCodeSigningConfig_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/GetFunctionCodeSigningConfig) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/GetFunctionCodeSigningConfig) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetFunctionCodeSigningConfig) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/GetFunctionCodeSigningConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetFunctionCodeSigningConfig) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetFunctionCodeSigningConfig) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/GetFunctionCodeSigningConfig) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetFunctionCodeSigningConfig) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetFunctionCodeSigningConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetFunctionCodeSigningConfig) 

# GetFunctionConcurrency
<a name="API_GetFunctionConcurrency"></a>

Returns details about the reserved concurrency configuration for a function. To set a concurrency limit for a function, use [PutFunctionConcurrency](API_PutFunctionConcurrency.md).

## Request Syntax
<a name="API_GetFunctionConcurrency_RequestSyntax"></a>

```
GET /2019-09-30/functions/FunctionName/concurrency HTTP/1.1
```

## URI Request Parameters
<a name="API_GetFunctionConcurrency_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_GetFunctionConcurrency_RequestSyntax) **   <a name="lambda-GetFunctionConcurrency-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?`   
Required: Yes

## Request Body
<a name="API_GetFunctionConcurrency_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetFunctionConcurrency_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ReservedConcurrentExecutions": number
}
```

## Response Elements
<a name="API_GetFunctionConcurrency_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [ReservedConcurrentExecutions](#API_GetFunctionConcurrency_ResponseSyntax) **   <a name="lambda-GetFunctionConcurrency-response-ReservedConcurrentExecutions"></a>
The number of simultaneous executions that are reserved for the function.  
Type: Integer  
Valid Range: Minimum value of 0.

## Errors
<a name="API_GetFunctionConcurrency_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_GetFunctionConcurrency_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/GetFunctionConcurrency) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/GetFunctionConcurrency) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetFunctionConcurrency) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/GetFunctionConcurrency) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetFunctionConcurrency) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetFunctionConcurrency) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/GetFunctionConcurrency) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetFunctionConcurrency) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetFunctionConcurrency) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetFunctionConcurrency) 

# GetFunctionConfiguration
<a name="API_GetFunctionConfiguration"></a>

Returns the version-specific settings of a Lambda function or version. The output includes only options that can vary between versions of a function. To modify these settings, use [UpdateFunctionConfiguration](API_UpdateFunctionConfiguration.md).

To get all of a function's details, including function-level settings, use [GetFunction](API_GetFunction.md).

## Request Syntax
<a name="API_GetFunctionConfiguration_RequestSyntax"></a>

```
GET /2015-03-31/functions/FunctionName/configuration?Qualifier=Qualifier HTTP/1.1
```

## URI Request Parameters
<a name="API_GetFunctionConfiguration_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_GetFunctionConfiguration_RequestSyntax) **   <a name="lambda-GetFunctionConfiguration-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?`   
Required: Yes

 ** [Qualifier](#API_GetFunctionConfiguration_RequestSyntax) **   <a name="lambda-GetFunctionConfiguration-request-uri-Qualifier"></a>
Specify a version or alias to get details about a published version of the function.  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `\$(LATEST(\.PUBLISHED)?)|[a-zA-Z0-9-_$]+` 

## Request Body
<a name="API_GetFunctionConfiguration_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetFunctionConfiguration_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Architectures": [ "string" ],
   "CapacityProviderConfig": { 
      "LambdaManagedInstancesCapacityProviderConfig": { 
         "CapacityProviderArn": "string",
         "ExecutionEnvironmentMemoryGiBPerVCpu": number,
         "PerExecutionEnvironmentMaxConcurrency": number
      }
   },
   "CodeSha256": "string",
   "CodeSize": number,
   "ConfigSha256": "string",
   "DeadLetterConfig": { 
      "TargetArn": "string"
   },
   "Description": "string",
   "DurableConfig": { 
      "ExecutionTimeout": number,
      "RetentionPeriodInDays": number
   },
   "Environment": { 
      "Error": { 
         "ErrorCode": "string",
         "Message": "string"
      },
      "Variables": { 
         "string" : "string" 
      }
   },
   "EphemeralStorage": { 
      "Size": number
   },
   "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"
      }
   ],
   "LoggingConfig": { 
      "ApplicationLogLevel": "string",
      "LogFormat": "string",
      "LogGroup": "string",
      "SystemLogLevel": "string"
   },
   "MasterArn": "string",
   "MemorySize": number,
   "PackageType": "string",
   "RevisionId": "string",
   "Role": "string",
   "Runtime": "string",
   "RuntimeVersionConfig": { 
      "Error": { 
         "ErrorCode": "string",
         "Message": "string"
      },
      "RuntimeVersionArn": "string"
   },
   "SigningJobArn": "string",
   "SigningProfileVersionArn": "string",
   "SnapStart": { 
      "ApplyOn": "string",
      "OptimizationStatus": "string"
   },
   "State": "string",
   "StateReason": "string",
   "StateReasonCode": "string",
   "TenancyConfig": { 
      "TenantIsolationMode": "string"
   },
   "Timeout": number,
   "TracingConfig": { 
      "Mode": "string"
   },
   "Version": "string",
   "VpcConfig": { 
      "Ipv6AllowedForDualStack": boolean,
      "SecurityGroupIds": [ "string" ],
      "SubnetIds": [ "string" ],
      "VpcId": "string"
   }
}
```

## Response Elements
<a name="API_GetFunctionConfiguration_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [Architectures](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-Architectures"></a>
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`.  
Type: Array of strings  
Array Members: Fixed number of 1 item.  
Valid Values: `x86_64 | arm64` 

 ** [CapacityProviderConfig](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-CapacityProviderConfig"></a>
Configuration for the capacity provider that manages compute resources for Lambda functions.  
Type: [CapacityProviderConfig](API_CapacityProviderConfig.md) object

 ** [CodeSha256](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-CodeSha256"></a>
The SHA256 hash of the function's deployment package.  
Type: String

 ** [CodeSize](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-CodeSize"></a>
The size of the function's deployment package, in bytes.  
Type: Long

 ** [ConfigSha256](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-ConfigSha256"></a>
The SHA256 hash of the function configuration.  
Type: String

 ** [DeadLetterConfig](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-DeadLetterConfig"></a>
The function's dead letter queue.  
Type: [DeadLetterConfig](API_DeadLetterConfig.md) object

 ** [Description](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-Description"></a>
The function's description.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 256.

 ** [DurableConfig](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-DurableConfig"></a>
The function's durable execution configuration settings, if the function is configured for durability.  
Type: [DurableConfig](API_DurableConfig.md) object

 ** [Environment](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-Environment"></a>
The function's [environment variables](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html). Omitted from AWS CloudTrail logs.  
Type: [EnvironmentResponse](API_EnvironmentResponse.md) object

 ** [EphemeralStorage](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-EphemeralStorage"></a>
The size of the function's `/tmp` directory in MB. The default value is 512, but can be any whole number between 512 and 10,240 MB. For more information, see [Configuring ephemeral storage (console)](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-ephemeral-storage).  
Type: [EphemeralStorage](API_EphemeralStorage.md) object

 ** [FileSystemConfigs](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-FileSystemConfigs"></a>
Connection settings for an [Amazon EFS file system](https://docs.aws.amazon.com/lambda/latest/dg/configuration-filesystem.html) or an [Amazon S3 Files file system](https://docs.aws.amazon.com/lambda/latest/dg/configuration-filesystem.html).  
Type: Array of [FileSystemConfig](API_FileSystemConfig.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 1 item.

 ** [FunctionArn](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-FunctionArn"></a>
The function's Amazon Resource Name (ARN).  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 10000.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_\.]+(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?` 

 ** [FunctionName](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-FunctionName"></a>
The name of the function.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?` 

 ** [Handler](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-Handler"></a>
The function that Lambda calls to begin running your function.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 128.  
Pattern: `[^\s]+` 

 ** [ImageConfigResponse](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-ImageConfigResponse"></a>
The function's image configuration values.  
Type: [ImageConfigResponse](API_ImageConfigResponse.md) object

 ** [KMSKeyArn](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-KMSKeyArn"></a>
The ARN of the AWS Key Management Service (AWS KMS) customer managed key that's used to encrypt the following resources:  
+ The function's [environment variables](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html#configuration-envvars-encryption).
+ The function's [Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart-security.html) snapshots.
+ When used with `SourceKMSKeyArn`, the unzipped version of the .zip deployment package that's used for function invocations. For more information, see [ Specifying a customer managed key for Lambda](https://docs.aws.amazon.com/lambda/latest/dg/encrypt-zip-package.html#enable-zip-custom-encryption).
+ The optimized version of the container image that's used for function invocations. Note that this is not the same key that's used to protect your container image in the Amazon Elastic Container Registry (Amazon ECR). For more information, see [Function lifecycle](https://docs.aws.amazon.com/lambda/latest/dg/images-create.html#images-lifecycle).
If you don't provide a customer managed key, Lambda uses an [AWS owned key](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-owned-cmk) or an [AWS managed key](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk).  
Type: String  
Pattern: `(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()` 

 ** [LastModified](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-LastModified"></a>
The date and time that the function was last updated, in [ISO-8601 format](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD).  
Type: String

 ** [LastUpdateStatus](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-LastUpdateStatus"></a>
The status of the last update that was performed on the function. This is first set to `Successful` after function creation completes.  
Type: String  
Valid Values: `Successful | Failed | InProgress` 

 ** [LastUpdateStatusReason](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-LastUpdateStatusReason"></a>
The reason for the last update that was performed on the function.  
Type: String

 ** [LastUpdateStatusReasonCode](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-LastUpdateStatusReasonCode"></a>
The reason code for the last update that was performed on the function.  
Type: String  
Valid Values: `EniLimitExceeded | InsufficientRolePermissions | InvalidConfiguration | InternalError | SubnetOutOfIPAddresses | InvalidSubnet | InvalidSecurityGroup | ImageDeleted | ImageAccessDenied | InvalidImage | KMSKeyAccessDenied | KMSKeyNotFound | InvalidStateKMSKey | DisabledKMSKey | EFSIOError | EFSMountConnectivityError | EFSMountFailure | EFSMountTimeout | InvalidRuntime | InvalidZipFileException | FunctionError | VcpuLimitExceeded | CapacityProviderScalingLimitExceeded | InsufficientCapacity | EC2RequestLimitExceeded | FunctionError.InitTimeout | FunctionError.RuntimeInitError | FunctionError.ExtensionInitError | FunctionError.InvalidEntryPoint | FunctionError.InvalidWorkingDirectory | FunctionError.PermissionDenied | FunctionError.TooManyExtensions | FunctionError.InitResourceExhausted | DisallowedByVpcEncryptionControl` 

 ** [Layers](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-Layers"></a>
The function's [layers](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html).  
Type: Array of [Layer](API_Layer.md) objects

 ** [LoggingConfig](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-LoggingConfig"></a>
The function's Amazon CloudWatch Logs configuration settings.  
Type: [LoggingConfig](API_LoggingConfig.md) object

 ** [MasterArn](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-MasterArn"></a>
For Lambda@Edge functions, the ARN of the main function.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 10000.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?` 

 ** [MemorySize](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-MemorySize"></a>
The amount of memory available to the function at runtime.  
Type: Integer  
Valid Range: Minimum value of 128. Maximum value of 32768.

 ** [PackageType](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-PackageType"></a>
The type of deployment package. Set to `Image` for container image and set `Zip` for .zip file archive.  
Type: String  
Valid Values: `Zip | Image` 

 ** [RevisionId](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-RevisionId"></a>
The latest updated revision of the function or alias.  
Type: String

 ** [Role](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-Role"></a>
The function's execution role.  
Type: String  
Pattern: `arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 

 ** [Runtime](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-Runtime"></a>
The identifier of the function's [ runtime](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html). Runtime is required if the deployment package is a .zip file archive. Specifying a runtime results in an error if you're deploying a function using a container image.  
The following list includes deprecated runtimes. Lambda blocks creating new functions and updating existing functions shortly after each runtime is deprecated. For more information, see [Runtime use after deprecation](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-deprecation-levels).  
For a list of all currently supported runtimes, see [Supported runtimes](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtimes-supported).  
Type: String  
Valid Values: `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 | nodejs24.x | python3.14 | java25 | dotnet10` 

 ** [RuntimeVersionConfig](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-RuntimeVersionConfig"></a>
The ARN of the runtime and any errors that occured.  
Type: [RuntimeVersionConfig](API_RuntimeVersionConfig.md) object

 ** [SigningJobArn](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-SigningJobArn"></a>
The ARN of the signing job.  
Type: String  
Pattern: `arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` 

 ** [SigningProfileVersionArn](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-SigningProfileVersionArn"></a>
The ARN of the signing profile version.  
Type: String  
Pattern: `arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` 

 ** [SnapStart](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-SnapStart"></a>
Set `ApplyOn` to `PublishedVersions` to create a snapshot of the initialized execution environment when you publish a function version. For more information, see [Improving startup performance with Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html).  
Type: [SnapStartResponse](API_SnapStartResponse.md) object

 ** [State](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-State"></a>
The current state of the function. When the state is `Inactive`, you can reactivate the function by invoking it.  
Type: String  
Valid Values: `Pending | Active | Inactive | Failed | Deactivating | Deactivated | ActiveNonInvocable | Deleting` 

 ** [StateReason](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-StateReason"></a>
The reason for the function's current state.  
Type: String

 ** [StateReasonCode](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-StateReasonCode"></a>
The reason code for the function's current state. When the code is `Creating`, you can't invoke or modify the function.  
Type: String  
Valid Values: `Idle | Creating | Restoring | EniLimitExceeded | InsufficientRolePermissions | InvalidConfiguration | InternalError | SubnetOutOfIPAddresses | InvalidSubnet | InvalidSecurityGroup | ImageDeleted | ImageAccessDenied | InvalidImage | KMSKeyAccessDenied | KMSKeyNotFound | InvalidStateKMSKey | DisabledKMSKey | EFSIOError | EFSMountConnectivityError | EFSMountFailure | EFSMountTimeout | InvalidRuntime | InvalidZipFileException | FunctionError | DrainingDurableExecutions | VcpuLimitExceeded | CapacityProviderScalingLimitExceeded | InsufficientCapacity | EC2RequestLimitExceeded | FunctionError.InitTimeout | FunctionError.RuntimeInitError | FunctionError.ExtensionInitError | FunctionError.InvalidEntryPoint | FunctionError.InvalidWorkingDirectory | FunctionError.PermissionDenied | FunctionError.TooManyExtensions | FunctionError.InitResourceExhausted | DisallowedByVpcEncryptionControl` 

 ** [TenancyConfig](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-TenancyConfig"></a>
The function's tenant isolation configuration settings. Determines whether the Lambda function runs on a shared or dedicated infrastructure per unique tenant.  
Type: [TenancyConfig](API_TenancyConfig.md) object

 ** [Timeout](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-Timeout"></a>
The amount of time in seconds that Lambda allows a function to run before stopping it.  
Type: Integer  
Valid Range: Minimum value of 1.

 ** [TracingConfig](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-TracingConfig"></a>
The function's AWS X-Ray tracing configuration.  
Type: [TracingConfigResponse](API_TracingConfigResponse.md) object

 ** [Version](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-Version"></a>
The version of the Lambda function.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Pattern: `(\$LATEST|[0-9]+)` 

 ** [VpcConfig](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-VpcConfig"></a>
The function's networking configuration.  
Type: [VpcConfigResponse](API_VpcConfigResponse.md) object

## Errors
<a name="API_GetFunctionConfiguration_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_GetFunctionConfiguration_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/GetFunctionConfiguration) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/GetFunctionConfiguration) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetFunctionConfiguration) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/GetFunctionConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetFunctionConfiguration) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetFunctionConfiguration) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/GetFunctionConfiguration) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetFunctionConfiguration) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetFunctionConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetFunctionConfiguration) 

# GetFunctionEventInvokeConfig
<a name="API_GetFunctionEventInvokeConfig"></a>

Retrieves the configuration for asynchronous invocation for a function, version, or alias.

To configure options for asynchronous invocation, use [PutFunctionEventInvokeConfig](API_PutFunctionEventInvokeConfig.md).

## Request Syntax
<a name="API_GetFunctionEventInvokeConfig_RequestSyntax"></a>

```
GET /2019-09-25/functions/FunctionName/event-invoke-config?Qualifier=Qualifier HTTP/1.1
```

## URI Request Parameters
<a name="API_GetFunctionEventInvokeConfig_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_GetFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-GetFunctionEventInvokeConfig-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?`   
Required: Yes

 ** [Qualifier](#API_GetFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-GetFunctionEventInvokeConfig-request-uri-Qualifier"></a>
A version number or alias name.  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `\$(LATEST(\.PUBLISHED)?)|[a-zA-Z0-9-_$]+` 

## Request Body
<a name="API_GetFunctionEventInvokeConfig_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetFunctionEventInvokeConfig_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "DestinationConfig": { 
      "OnFailure": { 
         "Destination": "string"
      },
      "OnSuccess": { 
         "Destination": "string"
      }
   },
   "FunctionArn": "string",
   "LastModified": number,
   "MaximumEventAgeInSeconds": number,
   "MaximumRetryAttempts": number
}
```

## Response Elements
<a name="API_GetFunctionEventInvokeConfig_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [DestinationConfig](#API_GetFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-GetFunctionEventInvokeConfig-response-DestinationConfig"></a>
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 a standard SQS queue.
+  **Bucket** - The ARN of an Amazon S3 bucket.
+  **Topic** - The ARN of a standard SNS topic.
+  **Event Bus** - The ARN of an Amazon EventBridge event bus.
S3 buckets are supported only for on-failure destinations. To retain records of successful invocations, use another destination type.
Type: [DestinationConfig](API_DestinationConfig.md) object

 ** [FunctionArn](#API_GetFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-GetFunctionEventInvokeConfig-response-FunctionArn"></a>
The Amazon Resource Name (ARN) of the function.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 10000.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?` 

 ** [LastModified](#API_GetFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-GetFunctionEventInvokeConfig-response-LastModified"></a>
The date and time that the configuration was last updated, in Unix time seconds.  
Type: Timestamp

 ** [MaximumEventAgeInSeconds](#API_GetFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-GetFunctionEventInvokeConfig-response-MaximumEventAgeInSeconds"></a>
The maximum age of a request that Lambda sends to a function for processing.  
Type: Integer  
Valid Range: Minimum value of 60. Maximum value of 21600.

 ** [MaximumRetryAttempts](#API_GetFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-GetFunctionEventInvokeConfig-response-MaximumRetryAttempts"></a>
The maximum number of times to retry when the function returns an error.  
Type: Integer  
Valid Range: Minimum value of 0. Maximum value of 2.

## Errors
<a name="API_GetFunctionEventInvokeConfig_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_GetFunctionEventInvokeConfig_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/GetFunctionEventInvokeConfig) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/GetFunctionEventInvokeConfig) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetFunctionEventInvokeConfig) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/GetFunctionEventInvokeConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetFunctionEventInvokeConfig) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetFunctionEventInvokeConfig) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/GetFunctionEventInvokeConfig) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetFunctionEventInvokeConfig) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetFunctionEventInvokeConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetFunctionEventInvokeConfig) 

# GetFunctionRecursionConfig
<a name="API_GetFunctionRecursionConfig"></a>

Returns your function's [recursive loop detection](https://docs.aws.amazon.com/lambda/latest/dg/invocation-recursion.html) configuration. 

## Request Syntax
<a name="API_GetFunctionRecursionConfig_RequestSyntax"></a>

```
GET /2024-08-31/functions/FunctionName/recursion-config HTTP/1.1
```

## URI Request Parameters
<a name="API_GetFunctionRecursionConfig_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_GetFunctionRecursionConfig_RequestSyntax) **   <a name="lambda-GetFunctionRecursionConfig-request-uri-FunctionName"></a>
The name of the function.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)`   
Required: Yes

## Request Body
<a name="API_GetFunctionRecursionConfig_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetFunctionRecursionConfig_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "RecursiveLoop": "string"
}
```

## Response Elements
<a name="API_GetFunctionRecursionConfig_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [RecursiveLoop](#API_GetFunctionRecursionConfig_ResponseSyntax) **   <a name="lambda-GetFunctionRecursionConfig-response-RecursiveLoop"></a>
If your function's recursive loop detection configuration is `Allow`, Lambda doesn't take any action when it detects your function being invoked as part of a recursive loop.  
If your function's recursive loop detection configuration is `Terminate`, Lambda stops your function being invoked and notifies you when it detects your function being invoked as part of a recursive loop.  
By default, Lambda sets your function's configuration to `Terminate`. You can update this configuration using the [PutFunctionRecursionConfig](API_PutFunctionRecursionConfig.md) action.  
Type: String  
Valid Values: `Allow | Terminate` 

## Errors
<a name="API_GetFunctionRecursionConfig_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_GetFunctionRecursionConfig_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/GetFunctionRecursionConfig) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/GetFunctionRecursionConfig) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetFunctionRecursionConfig) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/GetFunctionRecursionConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetFunctionRecursionConfig) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetFunctionRecursionConfig) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/GetFunctionRecursionConfig) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetFunctionRecursionConfig) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetFunctionRecursionConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetFunctionRecursionConfig) 

# GetFunctionScalingConfig
<a name="API_GetFunctionScalingConfig"></a>

Retrieves the scaling configuration for a Lambda Managed Instances function.

## Request Syntax
<a name="API_GetFunctionScalingConfig_RequestSyntax"></a>

```
GET /2025-11-30/functions/FunctionName/function-scaling-config?Qualifier=Qualifier HTTP/1.1
```

## URI Request Parameters
<a name="API_GetFunctionScalingConfig_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_GetFunctionScalingConfig_RequestSyntax) **   <a name="lambda-GetFunctionScalingConfig-request-uri-FunctionName"></a>
The name or ARN of the Lambda function.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)`   
Required: Yes

 ** [Qualifier](#API_GetFunctionScalingConfig_RequestSyntax) **   <a name="lambda-GetFunctionScalingConfig-request-uri-Qualifier"></a>
Specify a version or alias to get the scaling configuration for a published version of the function.  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `(\$LATEST\.PUBLISHED|[0-9]+)`   
Required: Yes

## Request Body
<a name="API_GetFunctionScalingConfig_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetFunctionScalingConfig_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AppliedFunctionScalingConfig": { 
      "MaxExecutionEnvironments": number,
      "MinExecutionEnvironments": number
   },
   "FunctionArn": "string",
   "RequestedFunctionScalingConfig": { 
      "MaxExecutionEnvironments": number,
      "MinExecutionEnvironments": number
   }
}
```

## Response Elements
<a name="API_GetFunctionScalingConfig_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [AppliedFunctionScalingConfig](#API_GetFunctionScalingConfig_ResponseSyntax) **   <a name="lambda-GetFunctionScalingConfig-response-AppliedFunctionScalingConfig"></a>
The scaling configuration that is currently applied to the function. This represents the actual scaling settings in effect.  
Type: [FunctionScalingConfig](API_FunctionScalingConfig.md) object

 ** [FunctionArn](#API_GetFunctionScalingConfig_ResponseSyntax) **   <a name="lambda-GetFunctionScalingConfig-response-FunctionArn"></a>
The Amazon Resource Name (ARN) of the function.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 10000.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?` 

 ** [RequestedFunctionScalingConfig](#API_GetFunctionScalingConfig_ResponseSyntax) **   <a name="lambda-GetFunctionScalingConfig-response-RequestedFunctionScalingConfig"></a>
The scaling configuration that was requested for the function.  
Type: [FunctionScalingConfig](API_FunctionScalingConfig.md) object

## Errors
<a name="API_GetFunctionScalingConfig_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_GetFunctionScalingConfig_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/GetFunctionScalingConfig) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/GetFunctionScalingConfig) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetFunctionScalingConfig) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/GetFunctionScalingConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetFunctionScalingConfig) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetFunctionScalingConfig) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/GetFunctionScalingConfig) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetFunctionScalingConfig) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetFunctionScalingConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetFunctionScalingConfig) 

# GetFunctionUrlConfig
<a name="API_GetFunctionUrlConfig"></a>

Returns details about a Lambda function URL.

## Request Syntax
<a name="API_GetFunctionUrlConfig_RequestSyntax"></a>

```
GET /2021-10-31/functions/FunctionName/url?Qualifier=Qualifier HTTP/1.1
```

## URI Request Parameters
<a name="API_GetFunctionUrlConfig_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_GetFunctionUrlConfig_RequestSyntax) **   <a name="lambda-GetFunctionUrlConfig-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?`   
Required: Yes

 ** [Qualifier](#API_GetFunctionUrlConfig_RequestSyntax) **   <a name="lambda-GetFunctionUrlConfig-request-uri-Qualifier"></a>
The alias name.  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `((?!^\d+$)^[0-9a-zA-Z-_]+$)` 

## Request Body
<a name="API_GetFunctionUrlConfig_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetFunctionUrlConfig_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AuthType": "string",
   "Cors": { 
      "AllowCredentials": boolean,
      "AllowHeaders": [ "string" ],
      "AllowMethods": [ "string" ],
      "AllowOrigins": [ "string" ],
      "ExposeHeaders": [ "string" ],
      "MaxAge": number
   },
   "CreationTime": "string",
   "FunctionArn": "string",
   "FunctionUrl": "string",
   "InvokeMode": "string",
   "LastModifiedTime": "string"
}
```

## Response Elements
<a name="API_GetFunctionUrlConfig_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [AuthType](#API_GetFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-GetFunctionUrlConfig-response-AuthType"></a>
The type of authentication that your function URL uses. Set to `AWS_IAM` if you want to restrict access to authenticated users only. Set to `NONE` if you want to bypass IAM authentication to create a public endpoint. For more information, see [Control access to Lambda function URLs](https://docs.aws.amazon.com/lambda/latest/dg/urls-auth.html).  
Type: String  
Valid Values: `NONE | AWS_IAM` 

 ** [Cors](#API_GetFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-GetFunctionUrlConfig-response-Cors"></a>
The [cross-origin resource sharing (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) settings for your function URL.  
Type: [Cors](API_Cors.md) object

 ** [CreationTime](#API_GetFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-GetFunctionUrlConfig-response-CreationTime"></a>
When the function URL was created, in [ISO-8601 format](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD).  
Type: String

 ** [FunctionArn](#API_GetFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-GetFunctionUrlConfig-response-FunctionArn"></a>
The Amazon Resource Name (ARN) of your function.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 10000.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?` 

 ** [FunctionUrl](#API_GetFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-GetFunctionUrlConfig-response-FunctionUrl"></a>
The HTTP URL endpoint for your function.  
Type: String  
Length Constraints: Minimum length of 40. Maximum length of 100.

 ** [InvokeMode](#API_GetFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-GetFunctionUrlConfig-response-InvokeMode"></a>
Use one of the following options:  
+  `BUFFERED` – This is the default option. Lambda invokes your function using the `Invoke` API operation. Invocation results are available when the payload is complete. The maximum payload size is 6 MB.
+  `RESPONSE_STREAM` – Your function streams payload results as they become available. Lambda invokes your function using the `InvokeWithResponseStream` API operation. The maximum response payload size is 200 MB.
Type: String  
Valid Values: `BUFFERED | RESPONSE_STREAM` 

 ** [LastModifiedTime](#API_GetFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-GetFunctionUrlConfig-response-LastModifiedTime"></a>
When the function URL configuration was last updated, in [ISO-8601 format](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD).  
Type: String

## Errors
<a name="API_GetFunctionUrlConfig_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_GetFunctionUrlConfig_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/GetFunctionUrlConfig) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/GetFunctionUrlConfig) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetFunctionUrlConfig) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/GetFunctionUrlConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetFunctionUrlConfig) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetFunctionUrlConfig) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/GetFunctionUrlConfig) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetFunctionUrlConfig) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetFunctionUrlConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetFunctionUrlConfig) 

# GetLayerVersion
<a name="API_GetLayerVersion"></a>

Returns information about a version of an [AWS Lambda layer](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html), with a link to download the layer archive that's valid for 10 minutes.

## Request Syntax
<a name="API_GetLayerVersion_RequestSyntax"></a>

```
GET /2018-10-31/layers/LayerName/versions/VersionNumber HTTP/1.1
```

## URI Request Parameters
<a name="API_GetLayerVersion_RequestParameters"></a>

The request uses the following URI parameters.

 ** [LayerName](#API_GetLayerVersion_RequestSyntax) **   <a name="lambda-GetLayerVersion-request-uri-LayerName"></a>
The name or Amazon Resource Name (ARN) of the layer.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+)|[a-zA-Z0-9-_]+`   
Required: Yes

 ** [VersionNumber](#API_GetLayerVersion_RequestSyntax) **   <a name="lambda-GetLayerVersion-request-uri-VersionNumber"></a>
The version number.  
Required: Yes

## Request Body
<a name="API_GetLayerVersion_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetLayerVersion_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CompatibleArchitectures": [ "string" ],
   "CompatibleRuntimes": [ "string" ],
   "Content": { 
      "CodeSha256": "string",
      "CodeSize": number,
      "Location": "string",
      "SigningJobArn": "string",
      "SigningProfileVersionArn": "string"
   },
   "CreatedDate": "string",
   "Description": "string",
   "LayerArn": "string",
   "LayerVersionArn": "string",
   "LicenseInfo": "string",
   "Version": number
}
```

## Response Elements
<a name="API_GetLayerVersion_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [CompatibleArchitectures](#API_GetLayerVersion_ResponseSyntax) **   <a name="lambda-GetLayerVersion-response-CompatibleArchitectures"></a>
A list of compatible [instruction set architectures](https://docs.aws.amazon.com/lambda/latest/dg/foundation-arch.html).  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 2 items.  
Valid Values: `x86_64 | arm64` 

 ** [CompatibleRuntimes](#API_GetLayerVersion_ResponseSyntax) **   <a name="lambda-GetLayerVersion-response-CompatibleRuntimes"></a>
The layer's compatible runtimes.  
The following list includes deprecated runtimes. For more information, see [Runtime use after deprecation](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-deprecation-levels).  
For a list of all currently supported runtimes, see [Supported runtimes](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtimes-supported).  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 15 items.  
Valid Values: `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 | nodejs24.x | python3.14 | java25 | dotnet10` 

 ** [Content](#API_GetLayerVersion_ResponseSyntax) **   <a name="lambda-GetLayerVersion-response-Content"></a>
Details about the layer version.  
Type: [LayerVersionContentOutput](API_LayerVersionContentOutput.md) object

 ** [CreatedDate](#API_GetLayerVersion_ResponseSyntax) **   <a name="lambda-GetLayerVersion-response-CreatedDate"></a>
The date that the layer version was created, in [ISO-8601 format](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD).  
Type: String

 ** [Description](#API_GetLayerVersion_ResponseSyntax) **   <a name="lambda-GetLayerVersion-response-Description"></a>
The description of the version.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 256.

 ** [LayerArn](#API_GetLayerVersion_ResponseSyntax) **   <a name="lambda-GetLayerVersion-response-LayerArn"></a>
The ARN of the layer.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+` 

 ** [LayerVersionArn](#API_GetLayerVersion_ResponseSyntax) **   <a name="lambda-GetLayerVersion-response-LayerVersionArn"></a>
The ARN of the layer version.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+:[0-9]+` 

 ** [LicenseInfo](#API_GetLayerVersion_ResponseSyntax) **   <a name="lambda-GetLayerVersion-response-LicenseInfo"></a>
The layer's software license.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 512.

 ** [Version](#API_GetLayerVersion_ResponseSyntax) **   <a name="lambda-GetLayerVersion-response-Version"></a>
The version number.  
Type: Long

## Errors
<a name="API_GetLayerVersion_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_GetLayerVersion_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/GetLayerVersion) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/GetLayerVersion) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetLayerVersion) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/GetLayerVersion) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetLayerVersion) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetLayerVersion) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/GetLayerVersion) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetLayerVersion) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetLayerVersion) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetLayerVersion) 

# GetLayerVersionByArn
<a name="API_GetLayerVersionByArn"></a>

Returns information about a version of an [AWS Lambda layer](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html), with a link to download the layer archive that's valid for 10 minutes.

## Request Syntax
<a name="API_GetLayerVersionByArn_RequestSyntax"></a>

```
GET /2018-10-31/layers?find=LayerVersion&Arn=Arn HTTP/1.1
```

## URI Request Parameters
<a name="API_GetLayerVersionByArn_RequestParameters"></a>

The request uses the following URI parameters.

 ** [Arn](#API_GetLayerVersionByArn_RequestSyntax) **   <a name="lambda-GetLayerVersionByArn-request-uri-Arn"></a>
The ARN of the layer version.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+:[0-9]+`   
Required: Yes

## Request Body
<a name="API_GetLayerVersionByArn_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetLayerVersionByArn_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CompatibleArchitectures": [ "string" ],
   "CompatibleRuntimes": [ "string" ],
   "Content": { 
      "CodeSha256": "string",
      "CodeSize": number,
      "Location": "string",
      "SigningJobArn": "string",
      "SigningProfileVersionArn": "string"
   },
   "CreatedDate": "string",
   "Description": "string",
   "LayerArn": "string",
   "LayerVersionArn": "string",
   "LicenseInfo": "string",
   "Version": number
}
```

## Response Elements
<a name="API_GetLayerVersionByArn_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [CompatibleArchitectures](#API_GetLayerVersionByArn_ResponseSyntax) **   <a name="lambda-GetLayerVersionByArn-response-CompatibleArchitectures"></a>
A list of compatible [instruction set architectures](https://docs.aws.amazon.com/lambda/latest/dg/foundation-arch.html).  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 2 items.  
Valid Values: `x86_64 | arm64` 

 ** [CompatibleRuntimes](#API_GetLayerVersionByArn_ResponseSyntax) **   <a name="lambda-GetLayerVersionByArn-response-CompatibleRuntimes"></a>
The layer's compatible runtimes.  
The following list includes deprecated runtimes. For more information, see [Runtime use after deprecation](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-deprecation-levels).  
For a list of all currently supported runtimes, see [Supported runtimes](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtimes-supported).  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 15 items.  
Valid Values: `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 | nodejs24.x | python3.14 | java25 | dotnet10` 

 ** [Content](#API_GetLayerVersionByArn_ResponseSyntax) **   <a name="lambda-GetLayerVersionByArn-response-Content"></a>
Details about the layer version.  
Type: [LayerVersionContentOutput](API_LayerVersionContentOutput.md) object

 ** [CreatedDate](#API_GetLayerVersionByArn_ResponseSyntax) **   <a name="lambda-GetLayerVersionByArn-response-CreatedDate"></a>
The date that the layer version was created, in [ISO-8601 format](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD).  
Type: String

 ** [Description](#API_GetLayerVersionByArn_ResponseSyntax) **   <a name="lambda-GetLayerVersionByArn-response-Description"></a>
The description of the version.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 256.

 ** [LayerArn](#API_GetLayerVersionByArn_ResponseSyntax) **   <a name="lambda-GetLayerVersionByArn-response-LayerArn"></a>
The ARN of the layer.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+` 

 ** [LayerVersionArn](#API_GetLayerVersionByArn_ResponseSyntax) **   <a name="lambda-GetLayerVersionByArn-response-LayerVersionArn"></a>
The ARN of the layer version.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+:[0-9]+` 

 ** [LicenseInfo](#API_GetLayerVersionByArn_ResponseSyntax) **   <a name="lambda-GetLayerVersionByArn-response-LicenseInfo"></a>
The layer's software license.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 512.

 ** [Version](#API_GetLayerVersionByArn_ResponseSyntax) **   <a name="lambda-GetLayerVersionByArn-response-Version"></a>
The version number.  
Type: Long

## Errors
<a name="API_GetLayerVersionByArn_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_GetLayerVersionByArn_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/GetLayerVersionByArn) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/GetLayerVersionByArn) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetLayerVersionByArn) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/GetLayerVersionByArn) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetLayerVersionByArn) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetLayerVersionByArn) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/GetLayerVersionByArn) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetLayerVersionByArn) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetLayerVersionByArn) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetLayerVersionByArn) 

# GetLayerVersionPolicy
<a name="API_GetLayerVersionPolicy"></a>

Returns the permission policy for a version of an [AWS Lambda layer](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html). For more information, see [AddLayerVersionPermission](API_AddLayerVersionPermission.md).

## Request Syntax
<a name="API_GetLayerVersionPolicy_RequestSyntax"></a>

```
GET /2018-10-31/layers/LayerName/versions/VersionNumber/policy HTTP/1.1
```

## URI Request Parameters
<a name="API_GetLayerVersionPolicy_RequestParameters"></a>

The request uses the following URI parameters.

 ** [LayerName](#API_GetLayerVersionPolicy_RequestSyntax) **   <a name="lambda-GetLayerVersionPolicy-request-uri-LayerName"></a>
The name or Amazon Resource Name (ARN) of the layer.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+)|[a-zA-Z0-9-_]+`   
Required: Yes

 ** [VersionNumber](#API_GetLayerVersionPolicy_RequestSyntax) **   <a name="lambda-GetLayerVersionPolicy-request-uri-VersionNumber"></a>
The version number.  
Required: Yes

## Request Body
<a name="API_GetLayerVersionPolicy_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetLayerVersionPolicy_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Policy": "string",
   "RevisionId": "string"
}
```

## Response Elements
<a name="API_GetLayerVersionPolicy_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [Policy](#API_GetLayerVersionPolicy_ResponseSyntax) **   <a name="lambda-GetLayerVersionPolicy-response-Policy"></a>
The policy document.  
Type: String

 ** [RevisionId](#API_GetLayerVersionPolicy_ResponseSyntax) **   <a name="lambda-GetLayerVersionPolicy-response-RevisionId"></a>
A unique identifier for the current revision of the policy.  
Type: String

## Errors
<a name="API_GetLayerVersionPolicy_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_GetLayerVersionPolicy_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/GetLayerVersionPolicy) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/GetLayerVersionPolicy) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetLayerVersionPolicy) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/GetLayerVersionPolicy) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetLayerVersionPolicy) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetLayerVersionPolicy) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/GetLayerVersionPolicy) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetLayerVersionPolicy) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetLayerVersionPolicy) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetLayerVersionPolicy) 

# GetPolicy
<a name="API_GetPolicy"></a>

Returns the [resource-based IAM policy](https://docs.aws.amazon.com/lambda/latest/dg/access-control-resource-based.html) for a function, version, or alias.

## Request Syntax
<a name="API_GetPolicy_RequestSyntax"></a>

```
GET /2015-03-31/functions/FunctionName/policy?Qualifier=Qualifier HTTP/1.1
```

## URI Request Parameters
<a name="API_GetPolicy_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_GetPolicy_RequestSyntax) **   <a name="lambda-GetPolicy-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?`   
Required: Yes

 ** [Qualifier](#API_GetPolicy_RequestSyntax) **   <a name="lambda-GetPolicy-request-uri-Qualifier"></a>
Specify a version or alias to get the policy for that resource.  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `\$(LATEST(\.PUBLISHED)?)|[a-zA-Z0-9-_$]+` 

## Request Body
<a name="API_GetPolicy_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetPolicy_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Policy": "string",
   "RevisionId": "string"
}
```

## Response Elements
<a name="API_GetPolicy_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [Policy](#API_GetPolicy_ResponseSyntax) **   <a name="lambda-GetPolicy-response-Policy"></a>
The resource-based policy.  
Type: String

 ** [RevisionId](#API_GetPolicy_ResponseSyntax) **   <a name="lambda-GetPolicy-response-RevisionId"></a>
A unique identifier for the current revision of the policy.  
Type: String

## Errors
<a name="API_GetPolicy_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_GetPolicy_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/GetPolicy) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/GetPolicy) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetPolicy) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/GetPolicy) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetPolicy) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetPolicy) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/GetPolicy) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetPolicy) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetPolicy) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetPolicy) 

# GetProvisionedConcurrencyConfig
<a name="API_GetProvisionedConcurrencyConfig"></a>

Retrieves the provisioned concurrency configuration for a function's alias or version.

## Request Syntax
<a name="API_GetProvisionedConcurrencyConfig_RequestSyntax"></a>

```
GET /2019-09-30/functions/FunctionName/provisioned-concurrency?Qualifier=Qualifier HTTP/1.1
```

## URI Request Parameters
<a name="API_GetProvisionedConcurrencyConfig_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_GetProvisionedConcurrencyConfig_RequestSyntax) **   <a name="lambda-GetProvisionedConcurrencyConfig-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?`   
Required: Yes

 ** [Qualifier](#API_GetProvisionedConcurrencyConfig_RequestSyntax) **   <a name="lambda-GetProvisionedConcurrencyConfig-request-uri-Qualifier"></a>
The version number or alias name.  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `(|[a-zA-Z0-9$_-]+)`   
Required: Yes

## Request Body
<a name="API_GetProvisionedConcurrencyConfig_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetProvisionedConcurrencyConfig_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AllocatedProvisionedConcurrentExecutions": number,
   "AvailableProvisionedConcurrentExecutions": number,
   "LastModified": "string",
   "RequestedProvisionedConcurrentExecutions": number,
   "Status": "string",
   "StatusReason": "string"
}
```

## Response Elements
<a name="API_GetProvisionedConcurrencyConfig_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [AllocatedProvisionedConcurrentExecutions](#API_GetProvisionedConcurrencyConfig_ResponseSyntax) **   <a name="lambda-GetProvisionedConcurrencyConfig-response-AllocatedProvisionedConcurrentExecutions"></a>
The amount of provisioned concurrency allocated. When a weighted alias is used during linear and canary deployments, this value fluctuates depending on the amount of concurrency that is provisioned for the function versions.  
Type: Integer  
Valid Range: Minimum value of 0.

 ** [AvailableProvisionedConcurrentExecutions](#API_GetProvisionedConcurrencyConfig_ResponseSyntax) **   <a name="lambda-GetProvisionedConcurrencyConfig-response-AvailableProvisionedConcurrentExecutions"></a>
The amount of provisioned concurrency available.  
Type: Integer  
Valid Range: Minimum value of 0.

 ** [LastModified](#API_GetProvisionedConcurrencyConfig_ResponseSyntax) **   <a name="lambda-GetProvisionedConcurrencyConfig-response-LastModified"></a>
The date and time that a user last updated the configuration, in [ISO 8601 format](https://www.iso.org/iso-8601-date-and-time-format.html).  
Type: String

 ** [RequestedProvisionedConcurrentExecutions](#API_GetProvisionedConcurrencyConfig_ResponseSyntax) **   <a name="lambda-GetProvisionedConcurrencyConfig-response-RequestedProvisionedConcurrentExecutions"></a>
The amount of provisioned concurrency requested.  
Type: Integer  
Valid Range: Minimum value of 1.

 ** [Status](#API_GetProvisionedConcurrencyConfig_ResponseSyntax) **   <a name="lambda-GetProvisionedConcurrencyConfig-response-Status"></a>
The status of the allocation process.  
Type: String  
Valid Values: `IN_PROGRESS | READY | FAILED` 

 ** [StatusReason](#API_GetProvisionedConcurrencyConfig_ResponseSyntax) **   <a name="lambda-GetProvisionedConcurrencyConfig-response-StatusReason"></a>
For failed allocations, the reason that provisioned concurrency could not be allocated.  
Type: String

## Errors
<a name="API_GetProvisionedConcurrencyConfig_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ProvisionedConcurrencyConfigNotFoundException **   
The specified configuration does not exist.  
HTTP Status Code: 404

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_GetProvisionedConcurrencyConfig_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/GetProvisionedConcurrencyConfig) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/GetProvisionedConcurrencyConfig) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetProvisionedConcurrencyConfig) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/GetProvisionedConcurrencyConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetProvisionedConcurrencyConfig) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetProvisionedConcurrencyConfig) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/GetProvisionedConcurrencyConfig) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetProvisionedConcurrencyConfig) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetProvisionedConcurrencyConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetProvisionedConcurrencyConfig) 

# GetRuntimeManagementConfig
<a name="API_GetRuntimeManagementConfig"></a>

Retrieves the runtime management configuration for a function's version. If the runtime update mode is **Manual**, this includes the ARN of the runtime version and the runtime update mode. If the runtime update mode is **Auto** or **Function update**, this includes the runtime update mode and `null` is returned for the ARN. For more information, see [Runtime updates](https://docs.aws.amazon.com/lambda/latest/dg/runtimes-update.html).

## Request Syntax
<a name="API_GetRuntimeManagementConfig_RequestSyntax"></a>

```
GET /2021-07-20/functions/FunctionName/runtime-management-config?Qualifier=Qualifier HTTP/1.1
```

## URI Request Parameters
<a name="API_GetRuntimeManagementConfig_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_GetRuntimeManagementConfig_RequestSyntax) **   <a name="lambda-GetRuntimeManagementConfig-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?`   
Required: Yes

 ** [Qualifier](#API_GetRuntimeManagementConfig_RequestSyntax) **   <a name="lambda-GetRuntimeManagementConfig-request-uri-Qualifier"></a>
Specify a version of the function. This can be `$LATEST` or a published version number. If no value is specified, the configuration for the `$LATEST` version is returned.  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `\$(LATEST(\.PUBLISHED)?)|[a-zA-Z0-9-_$]+` 

## Request Body
<a name="API_GetRuntimeManagementConfig_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetRuntimeManagementConfig_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "FunctionArn": "string",
   "RuntimeVersionArn": "string",
   "UpdateRuntimeOn": "string"
}
```

## Response Elements
<a name="API_GetRuntimeManagementConfig_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [FunctionArn](#API_GetRuntimeManagementConfig_ResponseSyntax) **   <a name="lambda-GetRuntimeManagementConfig-response-FunctionArn"></a>
The Amazon Resource Name (ARN) of your function.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 10000.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_\.]+(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?` 

 ** [RuntimeVersionArn](#API_GetRuntimeManagementConfig_ResponseSyntax) **   <a name="lambda-GetRuntimeManagementConfig-response-RuntimeVersionArn"></a>
The ARN of the runtime the function is configured to use. If the runtime update mode is **Manual**, the ARN is returned, otherwise `null` is returned.  
Type: String  
Length Constraints: Minimum length of 26. Maximum length of 2048.  
Pattern: `arn:(aws[a-zA-Z-]*):lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}::runtime:.+` 

 ** [UpdateRuntimeOn](#API_GetRuntimeManagementConfig_ResponseSyntax) **   <a name="lambda-GetRuntimeManagementConfig-response-UpdateRuntimeOn"></a>
The current runtime update mode of the function.  
Type: String  
Valid Values: `Auto | Manual | FunctionUpdate` 

## Errors
<a name="API_GetRuntimeManagementConfig_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_GetRuntimeManagementConfig_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/GetRuntimeManagementConfig) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/GetRuntimeManagementConfig) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetRuntimeManagementConfig) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/GetRuntimeManagementConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetRuntimeManagementConfig) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetRuntimeManagementConfig) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/GetRuntimeManagementConfig) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetRuntimeManagementConfig) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetRuntimeManagementConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetRuntimeManagementConfig) 

# Invoke
<a name="API_Invoke"></a>

Invokes a Lambda function. You can invoke a function synchronously (and wait for the response), or asynchronously. By default, Lambda invokes your function synchronously (i.e. the`InvocationType` is `RequestResponse`). To invoke a function asynchronously, set `InvocationType` to `Event`. Lambda passes the `ClientContext` object to your function for synchronous invocations only.

For synchronous invocations, the maximum payload size is 6 MB. For asynchronous invocations, the maximum payload size is 1 MB.

For [synchronous invocation](https://docs.aws.amazon.com/lambda/latest/dg/invocation-sync.html), details about the function response, including errors, are included in the response body and headers. For either invocation type, you can find more information in the [execution log](https://docs.aws.amazon.com/lambda/latest/dg/monitoring-functions.html) and [trace](https://docs.aws.amazon.com/lambda/latest/dg/lambda-x-ray.html).

When an error occurs, your function may be invoked multiple times. Retry behavior varies by error type, client, event source, and invocation type. For example, if you invoke a function asynchronously and it returns an error, Lambda executes the function up to two more times. For more information, see [Error handling and automatic retries in Lambda](https://docs.aws.amazon.com/lambda/latest/dg/invocation-retries.html).

For [asynchronous invocation](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html), Lambda adds events to a queue before sending them to your function. If your function does not have enough capacity to keep up with the queue, events may be lost. Occasionally, your function may receive the same event multiple times, even if no error occurs. To retain events that were not processed, configure your function with a [dead-letter queue](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-dlq).

The status code in the API response doesn't reflect function errors. Error codes are reserved for errors that prevent your function from executing, such as permissions errors, [quota](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html) errors, or issues with your function's code and configuration. For example, Lambda returns `TooManyRequestsException` if running the function would cause you to exceed a concurrency limit at either the account level (`ConcurrentInvocationLimitExceeded`) or function level (`ReservedFunctionConcurrentInvocationLimitExceeded`).

For functions with a long timeout, your client might disconnect during synchronous invocation while it waits for a response. Configure your HTTP client, SDK, firewall, proxy, or operating system to allow for long connections with timeout or keep-alive settings.

This operation requires permission for the [lambda:InvokeFunction](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_awslambda.html) action. For details on how to set up permissions for cross-account invocations, see [Granting function access to other accounts](https://docs.aws.amazon.com/lambda/latest/dg/access-control-resource-based.html#permissions-resource-xaccountinvoke).

## Request Syntax
<a name="API_Invoke_RequestSyntax"></a>

```
POST /2015-03-31/functions/FunctionName/invocations?Qualifier=Qualifier HTTP/1.1
X-Amz-Invocation-Type: InvocationType
X-Amz-Log-Type: LogType
X-Amz-Client-Context: ClientContext
X-Amz-Durable-Execution-Name: DurableExecutionName
X-Amz-Tenant-Id: TenantId

Payload
```

## URI Request Parameters
<a name="API_Invoke_RequestParameters"></a>

The request uses the following URI parameters.

 ** [ClientContext](#API_Invoke_RequestSyntax) **   <a name="lambda-Invoke-request-ClientContext"></a>
Up to 3,583 bytes of base64-encoded data about the invoking client to pass to the function in the context object. Lambda passes the `ClientContext` object to your function for synchronous invocations only.

 ** [DurableExecutionName](#API_Invoke_RequestSyntax) **   <a name="lambda-Invoke-request-DurableExecutionName"></a>
Optional unique name for the durable execution. When you start your special function, you can give it a unique name to identify this specific execution. It's like giving a nickname to a task.  
Length Constraints: Minimum length of 1. Maximum length of 64.  
Pattern: `[a-zA-Z0-9-_]+` 

 ** [FunctionName](#API_Invoke_RequestSyntax) **   <a name="lambda-Invoke-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?`   
Required: Yes

 ** [InvocationType](#API_Invoke_RequestSyntax) **   <a name="lambda-Invoke-request-InvocationType"></a>
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 one is 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.
Valid Values: `Event | RequestResponse | DryRun` 

 ** [LogType](#API_Invoke_RequestSyntax) **   <a name="lambda-Invoke-request-LogType"></a>
Set to `Tail` to include the execution log in the response. Applies to synchronously invoked functions only.  
Valid Values: `None | Tail` 

 ** [Qualifier](#API_Invoke_RequestSyntax) **   <a name="lambda-Invoke-request-uri-Qualifier"></a>
Specify a version or alias to invoke a published version of the function.  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `\$(LATEST(\.PUBLISHED)?)|[a-zA-Z0-9-_$]+` 

 ** [TenantId](#API_Invoke_RequestSyntax) **   <a name="lambda-Invoke-request-TenantId"></a>
The identifier of the tenant in a multi-tenant Lambda function.  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `[a-zA-Z0-9\._:\/=+\-@ ]+` 

## Request Body
<a name="API_Invoke_RequestBody"></a>

The request accepts the following binary data.

 ** [Payload](#API_Invoke_RequestSyntax) **   <a name="lambda-Invoke-request-Payload"></a>
The JSON that you want to provide to your Lambda function as input. The maximum payload size is 6 MB for synchronous invocations and 1 MB for asynchronous invocations.  
You can enter the JSON directly. For example, `--payload '{ "key": "value" }'`. You can also specify a file path. For example, `--payload file://payload.json`.

## Response Syntax
<a name="API_Invoke_ResponseSyntax"></a>

```
HTTP/1.1 StatusCode
X-Amz-Function-Error: FunctionError
X-Amz-Log-Result: LogResult
X-Amz-Executed-Version: ExecutedVersion
X-Amz-Durable-Execution-Arn: DurableExecutionArn

Payload
```

## Response Elements
<a name="API_Invoke_ResponseElements"></a>

If the action is successful, the service sends back the following HTTP response.

 ** [StatusCode](#API_Invoke_ResponseSyntax) **   <a name="lambda-Invoke-response-StatusCode"></a>
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 response returns the following HTTP headers.

 ** [DurableExecutionArn](#API_Invoke_ResponseSyntax) **   <a name="lambda-Invoke-response-DurableExecutionArn"></a>
The ARN of the durable execution that was started. This is returned when invoking a durable function and provides a unique identifier for tracking the execution.  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Pattern: `arn:([a-zA-Z0-9-]+):lambda:([a-zA-Z0-9-]+):(\d{12}):function:([a-zA-Z0-9_-]+):(\$LATEST(?:\.PUBLISHED)?|[0-9]+)/durable-execution/([a-zA-Z0-9_-]+)/([a-zA-Z0-9_-]+)` 

 ** [ExecutedVersion](#API_Invoke_ResponseSyntax) **   <a name="lambda-Invoke-response-ExecutedVersion"></a>
The version of the function that executed. When you invoke a function with an alias, this indicates which version the alias resolved to.  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Pattern: `(\$LATEST|[0-9]+)` 

 ** [FunctionError](#API_Invoke_ResponseSyntax) **   <a name="lambda-Invoke-response-FunctionError"></a>
If present, indicates that an error occurred during function execution. Details about the error are included in the response payload.

 ** [LogResult](#API_Invoke_ResponseSyntax) **   <a name="lambda-Invoke-response-LogResult"></a>
The last 4 KB of the execution log, which is base64-encoded.

The response returns the following as the HTTP body.

 ** [Payload](#API_Invoke_ResponseSyntax) **   <a name="lambda-Invoke-response-Payload"></a>
The response from the function, or an error object.

## Errors
<a name="API_Invoke_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** DurableExecutionAlreadyStartedException **   
The durable execution with the specified name has already been started. Each durable execution name must be unique within the function. Use a different name or check the status of the existing execution.    
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** EC2AccessDeniedException **   
Need additional permissions to configure VPC settings.  
HTTP Status Code: 502

 ** EC2ThrottledException **   
Amazon EC2 throttled AWS Lambda during Lambda function initialization using the execution role provided for the function.  
HTTP Status Code: 502

 ** EC2UnexpectedException **   
 AWS Lambda received an unexpected Amazon EC2 client exception while setting up for the Lambda function.  
HTTP Status Code: 502

 ** EFSIOException **   
An error occurred when reading from or writing to a connected file system.  
HTTP Status Code: 410

 ** EFSMountConnectivityException **   
The Lambda function couldn't make a network connection to the configured file system.  
HTTP Status Code: 408

 ** EFSMountFailureException **   
The Lambda function couldn't mount the configured file system due to a permission or configuration issue.  
HTTP Status Code: 403

 ** EFSMountTimeoutException **   
The Lambda function made a network connection to the configured file system, but the mount operation timed out.  
HTTP Status Code: 408

 ** ENILimitReachedException **   
 AWS Lambda couldn't create an elastic network interface in the VPC, specified as part of Lambda function configuration, because the limit for network interfaces has been reached. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html).  
HTTP Status Code: 502

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** InvalidRequestContentException **   
The request body could not be parsed as JSON, or a request header is invalid. For example, the 'x-amzn-RequestId' header is not a valid UUID string.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** InvalidRuntimeException **   
The runtime or runtime version specified is not supported.  
HTTP Status Code: 502

 ** InvalidSecurityGroupIDException **   
The security group ID provided in the Lambda function VPC configuration is not valid.  
HTTP Status Code: 502

 ** InvalidSubnetIDException **   
The subnet ID provided in the Lambda function VPC configuration is not valid.  
HTTP Status Code: 502

 ** InvalidZipFileException **   
 AWS Lambda could not unzip the deployment package.  
HTTP Status Code: 502

 ** KMSAccessDeniedException **   
Lambda couldn't decrypt the environment variables because AWS KMS access was denied. Check the Lambda function's KMS permissions.  
HTTP Status Code: 502

 ** KMSDisabledException **   
Lambda couldn't decrypt the environment variables because the AWS KMS key used is disabled. Check the Lambda function's KMS key settings.  
HTTP Status Code: 502

 ** KMSInvalidStateException **   
Lambda couldn't decrypt the environment variables because the state of the AWS KMS key used is not valid for Decrypt. Check the function's KMS key settings.  
HTTP Status Code: 502

 ** KMSNotFoundException **   
Lambda couldn't decrypt the environment variables because the AWS KMS key was not found. Check the function's KMS key settings.  
HTTP Status Code: 502

 ** NoPublishedVersionException **   
The function has no published versions available.    
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** RecursiveInvocationException **   
Lambda has detected your function being invoked in a recursive loop with other AWS resources and stopped your function's invocation.    
 ** Message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** RequestTooLargeException **   
The request payload exceeded the `Invoke` request body JSON input quota. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html).  
HTTP Status Code: 413

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ResourceNotReadyException **   
The function is inactive and its VPC connection is no longer available. Wait for the VPC connection to reestablish and try again.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 502

 ** S3FilesMountConnectivityException **   
The Lambda function couldn't make a network connection to the configured S3 Files access point.    
 ** Message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 408

 ** S3FilesMountFailureException **   
The Lambda function couldn't mount the configured S3 Files access point due to a permission or configuration issue.    
 ** Message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 403

 ** S3FilesMountTimeoutException **   
The Lambda function made a network connection to the configured S3 Files access point, but the mount operation timed out.    
 ** Message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 408

 ** SerializedRequestEntityTooLargeException **   
The request payload exceeded the maximum allowed size for serialized request entities.    
 ** Type **   
The error type.
HTTP Status Code: 413

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** SnapStartException **   
The `afterRestore()` [runtime hook](https://docs.aws.amazon.com/lambda/latest/dg/snapstart-runtime-hooks.html) encountered an error. For more information, check the Amazon CloudWatch logs.  
HTTP Status Code: 400

 ** SnapStartNotReadyException **   
Lambda is initializing your function. You can invoke the function when the [function state](https://docs.aws.amazon.com/lambda/latest/dg/functions-states.html) becomes `Active`.  
HTTP Status Code: 409

 ** SnapStartTimeoutException **   
Lambda couldn't restore the snapshot within the timeout limit.  
HTTP Status Code: 408

 ** SubnetIPAddressLimitReachedException **   
 AWS Lambda couldn't set up VPC access for the Lambda function because one or more configured subnets has no available IP addresses.  
HTTP Status Code: 502

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

 ** UnsupportedMediaTypeException **   
The content type of the `Invoke` request body is not JSON.  
HTTP Status Code: 415

## See Also
<a name="API_Invoke_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/Invoke) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/Invoke) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/Invoke) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/Invoke) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/Invoke) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/Invoke) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/Invoke) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/Invoke) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/Invoke) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/Invoke) 

# InvokeAsync
<a name="API_InvokeAsync"></a>

 *This action has been deprecated.* 

**Note**  
For asynchronous function invocation, use [Invoke](API_Invoke.md).

Invokes a function asynchronously.

**Note**  
The payload limit is 256KB. For larger payloads, for up to 1MB, use [Invoke](API_Invoke.md).

**Note**  
If you do use the InvokeAsync action, note that it doesn't support the use of X-Ray active tracing. Trace ID is not propagated to the function, even if X-Ray active tracing is turned on.

## Request Syntax
<a name="API_InvokeAsync_RequestSyntax"></a>

```
POST /2014-11-13/functions/FunctionName/invoke-async HTTP/1.1

InvokeArgs
```

## URI Request Parameters
<a name="API_InvokeAsync_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_InvokeAsync_RequestSyntax) **   <a name="lambda-InvokeAsync-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?`   
Required: Yes

## Request Body
<a name="API_InvokeAsync_RequestBody"></a>

The request accepts the following binary data.

 ** [InvokeArgs](#API_InvokeAsync_RequestSyntax) **   <a name="lambda-InvokeAsync-request-InvokeArgs"></a>
The JSON that you want to provide to your Lambda function as input.  
Required: Yes

## Response Syntax
<a name="API_InvokeAsync_ResponseSyntax"></a>

```
HTTP/1.1 Status
```

## Response Elements
<a name="API_InvokeAsync_ResponseElements"></a>

If the action is successful, the service sends back the following HTTP response.

 ** [Status](#API_InvokeAsync_ResponseSyntax) **   <a name="lambda-InvokeAsync-response-Status"></a>
The status code.

## Errors
<a name="API_InvokeAsync_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidRequestContentException **   
The request body could not be parsed as JSON, or a request header is invalid. For example, the 'x-amzn-RequestId' header is not a valid UUID string.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** InvalidRuntimeException **   
The runtime or runtime version specified is not supported.  
HTTP Status Code: 502

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

## See Also
<a name="API_InvokeAsync_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/InvokeAsync) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/InvokeAsync) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/InvokeAsync) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/InvokeAsync) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/InvokeAsync) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/InvokeAsync) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/InvokeAsync) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/InvokeAsync) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/InvokeAsync) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/InvokeAsync) 

# InvokeWithResponseStream
<a name="API_InvokeWithResponseStream"></a>

Configure your Lambda functions to stream response payloads back to clients. For more information, see [Configuring a Lambda function to stream responses](https://docs.aws.amazon.com/lambda/latest/dg/configuration-response-streaming.html).

This operation requires permission for the [lambda:InvokeFunction](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_awslambda.html) action. For details on how to set up permissions for cross-account invocations, see [Granting function access to other accounts](https://docs.aws.amazon.com/lambda/latest/dg/access-control-resource-based.html#permissions-resource-xaccountinvoke).

## Request Syntax
<a name="API_InvokeWithResponseStream_RequestSyntax"></a>

```
POST /2021-11-15/functions/FunctionName/response-streaming-invocations?Qualifier=Qualifier HTTP/1.1
X-Amz-Invocation-Type: InvocationType
X-Amz-Log-Type: LogType
X-Amz-Client-Context: ClientContext
X-Amz-Tenant-Id: TenantId

Payload
```

## URI Request Parameters
<a name="API_InvokeWithResponseStream_RequestParameters"></a>

The request uses the following URI parameters.

 ** [ClientContext](#API_InvokeWithResponseStream_RequestSyntax) **   <a name="lambda-InvokeWithResponseStream-request-ClientContext"></a>
Up to 3,583 bytes of base64-encoded data about the invoking client to pass to the function in the context object.

 ** [FunctionName](#API_InvokeWithResponseStream_RequestSyntax) **   <a name="lambda-InvokeWithResponseStream-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?`   
Required: Yes

 ** [InvocationType](#API_InvokeWithResponseStream_RequestSyntax) **   <a name="lambda-InvokeWithResponseStream-request-InvocationType"></a>
Use one of the following options:  
+  `RequestResponse` (default) – Invoke the function synchronously. Keep the connection open until the function returns a response or times out. The API operation response includes the function response and additional data.
+  `DryRun` – Validate parameter values and verify that the IAM user or role has permission to invoke the function.
Valid Values: `RequestResponse | DryRun` 

 ** [LogType](#API_InvokeWithResponseStream_RequestSyntax) **   <a name="lambda-InvokeWithResponseStream-request-LogType"></a>
Set to `Tail` to include the execution log in the response. Applies to synchronously invoked functions only.  
Valid Values: `None | Tail` 

 ** [Qualifier](#API_InvokeWithResponseStream_RequestSyntax) **   <a name="lambda-InvokeWithResponseStream-request-uri-Qualifier"></a>
The alias name.  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `\$(LATEST(\.PUBLISHED)?)|[a-zA-Z0-9-_$]+` 

 ** [TenantId](#API_InvokeWithResponseStream_RequestSyntax) **   <a name="lambda-InvokeWithResponseStream-request-TenantId"></a>
The identifier of the tenant in a multi-tenant Lambda function.  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `[a-zA-Z0-9\._:\/=+\-@ ]+` 

## Request Body
<a name="API_InvokeWithResponseStream_RequestBody"></a>

The request accepts the following binary data.

 ** [Payload](#API_InvokeWithResponseStream_RequestSyntax) **   <a name="lambda-InvokeWithResponseStream-request-Payload"></a>
The JSON that you want to provide to your Lambda function as input.  
You can enter the JSON directly. For example, `--payload '{ "key": "value" }'`. You can also specify a file path. For example, `--payload file://payload.json`.

## Response Syntax
<a name="API_InvokeWithResponseStream_ResponseSyntax"></a>

```
HTTP/1.1 StatusCode
X-Amz-Executed-Version: ExecutedVersion
Content-Type: ResponseStreamContentType
Content-type: application/json

{
   "InvokeComplete": { 
      "ErrorCode": "string",
      "ErrorDetails": "string",
      "LogResult": "string"
   },
   "PayloadChunk": { 
      "Payload": blob
   }
}
```

## Response Elements
<a name="API_InvokeWithResponseStream_ResponseElements"></a>

If the action is successful, the service sends back the following HTTP response.

 ** [StatusCode](#API_InvokeWithResponseStream_ResponseSyntax) **   <a name="lambda-InvokeWithResponseStream-response-StatusCode"></a>
For a successful request, the HTTP status code is in the 200 range. For the `RequestResponse` invocation type, this status code is 200. For the `DryRun` invocation type, this status code is 204.

The response returns the following HTTP headers.

 ** [ExecutedVersion](#API_InvokeWithResponseStream_ResponseSyntax) **   <a name="lambda-InvokeWithResponseStream-response-ExecutedVersion"></a>
The version of the function that executed. When you invoke a function with an alias, this indicates which version the alias resolved to.  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Pattern: `(\$LATEST|[0-9]+)` 

 ** [ResponseStreamContentType](#API_InvokeWithResponseStream_ResponseSyntax) **   <a name="lambda-InvokeWithResponseStream-response-ResponseStreamContentType"></a>
The type of data the stream is returning.

The following data is returned in JSON format by the service.

 ** [InvokeComplete](#API_InvokeWithResponseStream_ResponseSyntax) **   <a name="lambda-InvokeWithResponseStream-response-InvokeComplete"></a>
An object that's returned when the stream has ended and all the payload chunks have been returned.  
Type: [InvokeWithResponseStreamCompleteEvent](API_InvokeWithResponseStreamCompleteEvent.md) object

 ** [PayloadChunk](#API_InvokeWithResponseStream_ResponseSyntax) **   <a name="lambda-InvokeWithResponseStream-response-PayloadChunk"></a>
A chunk of the streamed response payload.  
Type: [InvokeResponseStreamUpdate](API_InvokeResponseStreamUpdate.md) object

## Errors
<a name="API_InvokeWithResponseStream_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** EC2AccessDeniedException **   
Need additional permissions to configure VPC settings.  
HTTP Status Code: 502

 ** EC2ThrottledException **   
Amazon EC2 throttled AWS Lambda during Lambda function initialization using the execution role provided for the function.  
HTTP Status Code: 502

 ** EC2UnexpectedException **   
 AWS Lambda received an unexpected Amazon EC2 client exception while setting up for the Lambda function.  
HTTP Status Code: 502

 ** EFSIOException **   
An error occurred when reading from or writing to a connected file system.  
HTTP Status Code: 410

 ** EFSMountConnectivityException **   
The Lambda function couldn't make a network connection to the configured file system.  
HTTP Status Code: 408

 ** EFSMountFailureException **   
The Lambda function couldn't mount the configured file system due to a permission or configuration issue.  
HTTP Status Code: 403

 ** EFSMountTimeoutException **   
The Lambda function made a network connection to the configured file system, but the mount operation timed out.  
HTTP Status Code: 408

 ** ENILimitReachedException **   
 AWS Lambda couldn't create an elastic network interface in the VPC, specified as part of Lambda function configuration, because the limit for network interfaces has been reached. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html).  
HTTP Status Code: 502

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** InvalidRequestContentException **   
The request body could not be parsed as JSON, or a request header is invalid. For example, the 'x-amzn-RequestId' header is not a valid UUID string.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** InvalidRuntimeException **   
The runtime or runtime version specified is not supported.  
HTTP Status Code: 502

 ** InvalidSecurityGroupIDException **   
The security group ID provided in the Lambda function VPC configuration is not valid.  
HTTP Status Code: 502

 ** InvalidSubnetIDException **   
The subnet ID provided in the Lambda function VPC configuration is not valid.  
HTTP Status Code: 502

 ** InvalidZipFileException **   
 AWS Lambda could not unzip the deployment package.  
HTTP Status Code: 502

 ** KMSAccessDeniedException **   
Lambda couldn't decrypt the environment variables because AWS KMS access was denied. Check the Lambda function's KMS permissions.  
HTTP Status Code: 502

 ** KMSDisabledException **   
Lambda couldn't decrypt the environment variables because the AWS KMS key used is disabled. Check the Lambda function's KMS key settings.  
HTTP Status Code: 502

 ** KMSInvalidStateException **   
Lambda couldn't decrypt the environment variables because the state of the AWS KMS key used is not valid for Decrypt. Check the function's KMS key settings.  
HTTP Status Code: 502

 ** KMSNotFoundException **   
Lambda couldn't decrypt the environment variables because the AWS KMS key was not found. Check the function's KMS key settings.  
HTTP Status Code: 502

 ** NoPublishedVersionException **   
The function has no published versions available.    
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** RecursiveInvocationException **   
Lambda has detected your function being invoked in a recursive loop with other AWS resources and stopped your function's invocation.    
 ** Message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** RequestTooLargeException **   
The request payload exceeded the `Invoke` request body JSON input quota. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html).  
HTTP Status Code: 413

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ResourceNotReadyException **   
The function is inactive and its VPC connection is no longer available. Wait for the VPC connection to reestablish and try again.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 502

 ** S3FilesMountConnectivityException **   
The Lambda function couldn't make a network connection to the configured S3 Files access point.    
 ** Message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 408

 ** S3FilesMountFailureException **   
The Lambda function couldn't mount the configured S3 Files access point due to a permission or configuration issue.    
 ** Message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 403

 ** S3FilesMountTimeoutException **   
The Lambda function made a network connection to the configured S3 Files access point, but the mount operation timed out.    
 ** Message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 408

 ** SerializedRequestEntityTooLargeException **   
The request payload exceeded the maximum allowed size for serialized request entities.    
 ** Type **   
The error type.
HTTP Status Code: 413

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** SnapStartException **   
The `afterRestore()` [runtime hook](https://docs.aws.amazon.com/lambda/latest/dg/snapstart-runtime-hooks.html) encountered an error. For more information, check the Amazon CloudWatch logs.  
HTTP Status Code: 400

 ** SnapStartNotReadyException **   
Lambda is initializing your function. You can invoke the function when the [function state](https://docs.aws.amazon.com/lambda/latest/dg/functions-states.html) becomes `Active`.  
HTTP Status Code: 409

 ** SnapStartTimeoutException **   
Lambda couldn't restore the snapshot within the timeout limit.  
HTTP Status Code: 408

 ** SubnetIPAddressLimitReachedException **   
 AWS Lambda couldn't set up VPC access for the Lambda function because one or more configured subnets has no available IP addresses.  
HTTP Status Code: 502

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

 ** UnsupportedMediaTypeException **   
The content type of the `Invoke` request body is not JSON.  
HTTP Status Code: 415

## See Also
<a name="API_InvokeWithResponseStream_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/InvokeWithResponseStream) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/InvokeWithResponseStream) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/InvokeWithResponseStream) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/InvokeWithResponseStream) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/InvokeWithResponseStream) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/InvokeWithResponseStream) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/InvokeWithResponseStream) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/InvokeWithResponseStream) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/InvokeWithResponseStream) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/InvokeWithResponseStream) 

# ListAliases
<a name="API_ListAliases"></a>

Returns a list of [aliases](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html) for a Lambda function.

## Request Syntax
<a name="API_ListAliases_RequestSyntax"></a>

```
GET /2015-03-31/functions/FunctionName/aliases?FunctionVersion=FunctionVersion&Marker=Marker&MaxItems=MaxItems HTTP/1.1
```

## URI Request Parameters
<a name="API_ListAliases_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_ListAliases_RequestSyntax) **   <a name="lambda-ListAliases-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?`   
Required: Yes

 ** [FunctionVersion](#API_ListAliases_RequestSyntax) **   <a name="lambda-ListAliases-request-uri-FunctionVersion"></a>
Specify a function version to only list aliases that invoke that version.  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Pattern: `(\$LATEST(\.PUBLISHED)?|[0-9]+)` 

 ** [Marker](#API_ListAliases_RequestSyntax) **   <a name="lambda-ListAliases-request-uri-Marker"></a>
Specify the pagination token that's returned by a previous request to retrieve the next page of results.

 ** [MaxItems](#API_ListAliases_RequestSyntax) **   <a name="lambda-ListAliases-request-uri-MaxItems"></a>
Limit the number of aliases returned.  
Valid Range: Minimum value of 1. Maximum value of 10000.

## Request Body
<a name="API_ListAliases_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListAliases_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Aliases": [ 
      { 
         "AliasArn": "string",
         "Description": "string",
         "FunctionVersion": "string",
         "Name": "string",
         "RevisionId": "string",
         "RoutingConfig": { 
            "AdditionalVersionWeights": { 
               "string" : number 
            }
         }
      }
   ],
   "NextMarker": "string"
}
```

## Response Elements
<a name="API_ListAliases_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [Aliases](#API_ListAliases_ResponseSyntax) **   <a name="lambda-ListAliases-response-Aliases"></a>
A list of aliases.  
Type: Array of [AliasConfiguration](API_AliasConfiguration.md) objects

 ** [NextMarker](#API_ListAliases_ResponseSyntax) **   <a name="lambda-ListAliases-response-NextMarker"></a>
The pagination token that's included if more results are available.  
Type: String

## Errors
<a name="API_ListAliases_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_ListAliases_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/ListAliases) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/ListAliases) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListAliases) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/ListAliases) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListAliases) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListAliases) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/ListAliases) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListAliases) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListAliases) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListAliases) 

# ListCapacityProviders
<a name="API_ListCapacityProviders"></a>

Returns a list of capacity providers in your account.

## Request Syntax
<a name="API_ListCapacityProviders_RequestSyntax"></a>

```
GET /2025-11-30/capacity-providers?Marker=Marker&MaxItems=MaxItems&State=State HTTP/1.1
```

## URI Request Parameters
<a name="API_ListCapacityProviders_RequestParameters"></a>

The request uses the following URI parameters.

 ** [Marker](#API_ListCapacityProviders_RequestSyntax) **   <a name="lambda-ListCapacityProviders-request-uri-Marker"></a>
Specify the pagination token that's returned by a previous request to retrieve the next page of results.

 ** [MaxItems](#API_ListCapacityProviders_RequestSyntax) **   <a name="lambda-ListCapacityProviders-request-uri-MaxItems"></a>
The maximum number of capacity providers to return.  
Valid Range: Minimum value of 1. Maximum value of 50.

 ** [State](#API_ListCapacityProviders_RequestSyntax) **   <a name="lambda-ListCapacityProviders-request-uri-State"></a>
Filter capacity providers by their current state.  
Valid Values: `Pending | Active | Failed | Deleting` 

## Request Body
<a name="API_ListCapacityProviders_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListCapacityProviders_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CapacityProviders": [ 
      { 
         "CapacityProviderArn": "string",
         "CapacityProviderScalingConfig": { 
            "MaxVCpuCount": number,
            "ScalingMode": "string",
            "ScalingPolicies": [ 
               { 
                  "PredefinedMetricType": "string",
                  "TargetValue": number
               }
            ]
         },
         "InstanceRequirements": { 
            "AllowedInstanceTypes": [ "string" ],
            "Architectures": [ "string" ],
            "ExcludedInstanceTypes": [ "string" ]
         },
         "KmsKeyArn": "string",
         "LastModified": "string",
         "PermissionsConfig": { 
            "CapacityProviderOperatorRoleArn": "string"
         },
         "State": "string",
         "VpcConfig": { 
            "SecurityGroupIds": [ "string" ],
            "SubnetIds": [ "string" ]
         }
      }
   ],
   "NextMarker": "string"
}
```

## Response Elements
<a name="API_ListCapacityProviders_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [CapacityProviders](#API_ListCapacityProviders_ResponseSyntax) **   <a name="lambda-ListCapacityProviders-response-CapacityProviders"></a>
A list of capacity providers in your account.  
Type: Array of [CapacityProvider](API_CapacityProvider.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 50 items.

 ** [NextMarker](#API_ListCapacityProviders_ResponseSyntax) **   <a name="lambda-ListCapacityProviders-response-NextMarker"></a>
The pagination token that's included if more results are available.  
Type: String

## Errors
<a name="API_ListCapacityProviders_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_ListCapacityProviders_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/ListCapacityProviders) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/ListCapacityProviders) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListCapacityProviders) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/ListCapacityProviders) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListCapacityProviders) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListCapacityProviders) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/ListCapacityProviders) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListCapacityProviders) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListCapacityProviders) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListCapacityProviders) 

# ListCodeSigningConfigs
<a name="API_ListCodeSigningConfigs"></a>

Returns a list of [code signing configurations](https://docs.aws.amazon.com/lambda/latest/dg/configuring-codesigning.html). A request returns up to 10,000 configurations per call. You can use the `MaxItems` parameter to return fewer configurations per call. 

## Request Syntax
<a name="API_ListCodeSigningConfigs_RequestSyntax"></a>

```
GET /2020-04-22/code-signing-configs?Marker=Marker&MaxItems=MaxItems HTTP/1.1
```

## URI Request Parameters
<a name="API_ListCodeSigningConfigs_RequestParameters"></a>

The request uses the following URI parameters.

 ** [Marker](#API_ListCodeSigningConfigs_RequestSyntax) **   <a name="lambda-ListCodeSigningConfigs-request-uri-Marker"></a>
Specify the pagination token that's returned by a previous request to retrieve the next page of results.

 ** [MaxItems](#API_ListCodeSigningConfigs_RequestSyntax) **   <a name="lambda-ListCodeSigningConfigs-request-uri-MaxItems"></a>
Maximum number of items to return.  
Valid Range: Minimum value of 1. Maximum value of 10000.

## Request Body
<a name="API_ListCodeSigningConfigs_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListCodeSigningConfigs_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CodeSigningConfigs": [ 
      { 
         "AllowedPublishers": { 
            "SigningProfileVersionArns": [ "string" ]
         },
         "CodeSigningConfigArn": "string",
         "CodeSigningConfigId": "string",
         "CodeSigningPolicies": { 
            "UntrustedArtifactOnDeployment": "string"
         },
         "Description": "string",
         "LastModified": "string"
      }
   ],
   "NextMarker": "string"
}
```

## Response Elements
<a name="API_ListCodeSigningConfigs_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [CodeSigningConfigs](#API_ListCodeSigningConfigs_ResponseSyntax) **   <a name="lambda-ListCodeSigningConfigs-response-CodeSigningConfigs"></a>
The code signing configurations  
Type: Array of [CodeSigningConfig](API_CodeSigningConfig.md) objects

 ** [NextMarker](#API_ListCodeSigningConfigs_ResponseSyntax) **   <a name="lambda-ListCodeSigningConfigs-response-NextMarker"></a>
The pagination token that's included if more results are available.  
Type: String

## Errors
<a name="API_ListCodeSigningConfigs_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

## See Also
<a name="API_ListCodeSigningConfigs_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/ListCodeSigningConfigs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/ListCodeSigningConfigs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListCodeSigningConfigs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/ListCodeSigningConfigs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListCodeSigningConfigs) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListCodeSigningConfigs) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/ListCodeSigningConfigs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListCodeSigningConfigs) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListCodeSigningConfigs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListCodeSigningConfigs) 

# ListDurableExecutionsByFunction
<a name="API_ListDurableExecutionsByFunction"></a>

Returns a list of [durable executions](https://docs.aws.amazon.com/lambda/latest/dg/durable-functions.html) for a specified Lambda function. You can filter the results by execution name, status, and start time range. This API supports pagination for large result sets.

## Request Syntax
<a name="API_ListDurableExecutionsByFunction_RequestSyntax"></a>

```
GET /2025-12-01/functions/FunctionName/durable-executions?DurableExecutionName=DurableExecutionName&Marker=Marker&MaxItems=MaxItems&Qualifier=Qualifier&ReverseOrder=ReverseOrder&StartedAfter=StartedAfter&StartedBefore=StartedBefore&Statuses=Statuses HTTP/1.1
```

## URI Request Parameters
<a name="API_ListDurableExecutionsByFunction_RequestParameters"></a>

The request uses the following URI parameters.

 ** [DurableExecutionName](#API_ListDurableExecutionsByFunction_RequestSyntax) **   <a name="lambda-ListDurableExecutionsByFunction-request-uri-DurableExecutionName"></a>
Filter executions by name. Only executions with names that matches this string are returned.  
Length Constraints: Minimum length of 1. Maximum length of 64.  
Pattern: `[a-zA-Z0-9-_]+` 

 ** [FunctionName](#API_ListDurableExecutionsByFunction_RequestSyntax) **   <a name="lambda-ListDurableExecutionsByFunction-request-uri-FunctionName"></a>
The name or ARN of the Lambda function. You can specify a function name, a partial ARN, or a full ARN.  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?`   
Required: Yes

 ** [Marker](#API_ListDurableExecutionsByFunction_RequestSyntax) **   <a name="lambda-ListDurableExecutionsByFunction-request-uri-Marker"></a>
Pagination token from a previous request to continue retrieving results.

 ** [MaxItems](#API_ListDurableExecutionsByFunction_RequestSyntax) **   <a name="lambda-ListDurableExecutionsByFunction-request-uri-MaxItems"></a>
Maximum number of executions to return (1-1000). Default is 100.  
Valid Range: Minimum value of 0. Maximum value of 1000.

 ** [Qualifier](#API_ListDurableExecutionsByFunction_RequestSyntax) **   <a name="lambda-ListDurableExecutionsByFunction-request-uri-Qualifier"></a>
The function version or alias. If not specified, lists executions for the \$1LATEST version.  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `\$(LATEST(\.PUBLISHED)?)|[a-zA-Z0-9-_$]+` 

 ** [ReverseOrder](#API_ListDurableExecutionsByFunction_RequestSyntax) **   <a name="lambda-ListDurableExecutionsByFunction-request-uri-ReverseOrder"></a>
Set to true to return results in reverse chronological order (newest first). Default is false.

 ** [StartedAfter](#API_ListDurableExecutionsByFunction_RequestSyntax) **   <a name="lambda-ListDurableExecutionsByFunction-request-uri-StartedAfter"></a>
Filter executions that started after this timestamp (ISO 8601 format).

 ** [StartedBefore](#API_ListDurableExecutionsByFunction_RequestSyntax) **   <a name="lambda-ListDurableExecutionsByFunction-request-uri-StartedBefore"></a>
Filter executions that started before this timestamp (ISO 8601 format).

 ** [Statuses](#API_ListDurableExecutionsByFunction_RequestSyntax) **   <a name="lambda-ListDurableExecutionsByFunction-request-uri-Statuses"></a>
Filter executions by status. Valid values: RUNNING, SUCCEEDED, FAILED, TIMED\$1OUT, STOPPED.  
Array Members: Fixed number of 1 item.  
Valid Values: `RUNNING | SUCCEEDED | FAILED | TIMED_OUT | STOPPED` 

## Request Body
<a name="API_ListDurableExecutionsByFunction_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListDurableExecutionsByFunction_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "DurableExecutions": [ 
      { 
         "DurableExecutionArn": "string",
         "DurableExecutionName": "string",
         "EndTimestamp": number,
         "FunctionArn": "string",
         "StartTimestamp": number,
         "Status": "string"
      }
   ],
   "NextMarker": "string"
}
```

## Response Elements
<a name="API_ListDurableExecutionsByFunction_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [DurableExecutions](#API_ListDurableExecutionsByFunction_ResponseSyntax) **   <a name="lambda-ListDurableExecutionsByFunction-response-DurableExecutions"></a>
List of durable execution summaries matching the filter criteria.  
Type: Array of [Execution](API_Execution.md) objects

 ** [NextMarker](#API_ListDurableExecutionsByFunction_ResponseSyntax) **   <a name="lambda-ListDurableExecutionsByFunction-response-NextMarker"></a>
Pagination token for retrieving additional results. Present only if there are more results available.  
Type: String

## Errors
<a name="API_ListDurableExecutionsByFunction_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_ListDurableExecutionsByFunction_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/ListDurableExecutionsByFunction) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/ListDurableExecutionsByFunction) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListDurableExecutionsByFunction) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/ListDurableExecutionsByFunction) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListDurableExecutionsByFunction) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListDurableExecutionsByFunction) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/ListDurableExecutionsByFunction) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListDurableExecutionsByFunction) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListDurableExecutionsByFunction) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListDurableExecutionsByFunction) 

# ListEventSourceMappings
<a name="API_ListEventSourceMappings"></a>

Lists event source mappings. Specify an `EventSourceArn` to show only event source mappings for a single event source.

## Request Syntax
<a name="API_ListEventSourceMappings_RequestSyntax"></a>

```
GET /2015-03-31/event-source-mappings?EventSourceArn=EventSourceArn&FunctionName=FunctionName&Marker=Marker&MaxItems=MaxItems HTTP/1.1
```

## URI Request Parameters
<a name="API_ListEventSourceMappings_RequestParameters"></a>

The request uses the following URI parameters.

 ** [EventSourceArn](#API_ListEventSourceMappings_RequestSyntax) **   <a name="lambda-ListEventSourceMappings-request-uri-EventSourceArn"></a>
The Amazon Resource Name (ARN) of the event source.  
+  **Amazon Kinesis** – The ARN of the data stream or a stream consumer.
+  **Amazon DynamoDB Streams** – The ARN of the stream.
+  **Amazon Simple Queue Service** – The ARN of the queue.
+  **Amazon Managed Streaming for Apache Kafka** – The ARN of the cluster or the ARN of the VPC connection (for [cross-account event source mappings](https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html#msk-multi-vpc)).
+  **Amazon MQ** – The ARN of the broker.
+  **Amazon DocumentDB** – The ARN of the DocumentDB change stream.
Pattern: `arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` 

 ** [FunctionName](#API_ListEventSourceMappings_RequestSyntax) **   <a name="lambda-ListEventSourceMappings-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?` 

 ** [Marker](#API_ListEventSourceMappings_RequestSyntax) **   <a name="lambda-ListEventSourceMappings-request-uri-Marker"></a>
A pagination token returned by a previous call.

 ** [MaxItems](#API_ListEventSourceMappings_RequestSyntax) **   <a name="lambda-ListEventSourceMappings-request-uri-MaxItems"></a>
The maximum number of event source mappings to return. Note that ListEventSourceMappings returns a maximum of 100 items in each response, even if you set the number higher.  
Valid Range: Minimum value of 1. Maximum value of 10000.

## Request Body
<a name="API_ListEventSourceMappings_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListEventSourceMappings_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "EventSourceMappings": [ 
      { 
         "AmazonManagedKafkaEventSourceConfig": { 
            "ConsumerGroupId": "string",
            "SchemaRegistryConfig": { 
               "AccessConfigs": [ 
                  { 
                     "Type": "string",
                     "URI": "string"
                  }
               ],
               "EventRecordFormat": "string",
               "SchemaRegistryURI": "string",
               "SchemaValidationConfigs": [ 
                  { 
                     "Attribute": "string"
                  }
               ]
            }
         },
         "BatchSize": number,
         "BisectBatchOnFunctionError": boolean,
         "DestinationConfig": { 
            "OnFailure": { 
               "Destination": "string"
            },
            "OnSuccess": { 
               "Destination": "string"
            }
         },
         "DocumentDBEventSourceConfig": { 
            "CollectionName": "string",
            "DatabaseName": "string",
            "FullDocument": "string"
         },
         "EventSourceArn": "string",
         "EventSourceMappingArn": "string",
         "FilterCriteria": { 
            "Filters": [ 
               { 
                  "Pattern": "string"
               }
            ]
         },
         "FilterCriteriaError": { 
            "ErrorCode": "string",
            "Message": "string"
         },
         "FunctionArn": "string",
         "FunctionResponseTypes": [ "string" ],
         "KMSKeyArn": "string",
         "LastModified": number,
         "LastProcessingResult": "string",
         "LoggingConfig": { 
            "SystemLogLevel": "string"
         },
         "MaximumBatchingWindowInSeconds": number,
         "MaximumRecordAgeInSeconds": number,
         "MaximumRetryAttempts": number,
         "MetricsConfig": { 
            "Metrics": [ "string" ]
         },
         "ParallelizationFactor": number,
         "ProvisionedPollerConfig": { 
            "MaximumPollers": number,
            "MinimumPollers": number,
            "PollerGroupName": "string"
         },
         "Queues": [ "string" ],
         "ScalingConfig": { 
            "MaximumConcurrency": number
         },
         "SelfManagedEventSource": { 
            "Endpoints": { 
               "string" : [ "string" ]
            }
         },
         "SelfManagedKafkaEventSourceConfig": { 
            "ConsumerGroupId": "string",
            "SchemaRegistryConfig": { 
               "AccessConfigs": [ 
                  { 
                     "Type": "string",
                     "URI": "string"
                  }
               ],
               "EventRecordFormat": "string",
               "SchemaRegistryURI": "string",
               "SchemaValidationConfigs": [ 
                  { 
                     "Attribute": "string"
                  }
               ]
            }
         },
         "SourceAccessConfigurations": [ 
            { 
               "Type": "string",
               "URI": "string"
            }
         ],
         "StartingPosition": "string",
         "StartingPositionTimestamp": number,
         "State": "string",
         "StateTransitionReason": "string",
         "Topics": [ "string" ],
         "TumblingWindowInSeconds": number,
         "UUID": "string"
      }
   ],
   "NextMarker": "string"
}
```

## Response Elements
<a name="API_ListEventSourceMappings_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [EventSourceMappings](#API_ListEventSourceMappings_ResponseSyntax) **   <a name="lambda-ListEventSourceMappings-response-EventSourceMappings"></a>
A list of event source mappings.  
Type: Array of [EventSourceMappingConfiguration](API_EventSourceMappingConfiguration.md) objects

 ** [NextMarker](#API_ListEventSourceMappings_ResponseSyntax) **   <a name="lambda-ListEventSourceMappings-response-NextMarker"></a>
A pagination token that's returned when the response doesn't contain all event source mappings.  
Type: String

## Errors
<a name="API_ListEventSourceMappings_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_ListEventSourceMappings_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/ListEventSourceMappings) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/ListEventSourceMappings) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListEventSourceMappings) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/ListEventSourceMappings) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListEventSourceMappings) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListEventSourceMappings) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/ListEventSourceMappings) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListEventSourceMappings) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListEventSourceMappings) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListEventSourceMappings) 

# ListFunctionEventInvokeConfigs
<a name="API_ListFunctionEventInvokeConfigs"></a>

Retrieves a list of configurations for asynchronous invocation for a function.

To configure options for asynchronous invocation, use [PutFunctionEventInvokeConfig](API_PutFunctionEventInvokeConfig.md).

## Request Syntax
<a name="API_ListFunctionEventInvokeConfigs_RequestSyntax"></a>

```
GET /2019-09-25/functions/FunctionName/event-invoke-config/list?Marker=Marker&MaxItems=MaxItems HTTP/1.1
```

## URI Request Parameters
<a name="API_ListFunctionEventInvokeConfigs_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_ListFunctionEventInvokeConfigs_RequestSyntax) **   <a name="lambda-ListFunctionEventInvokeConfigs-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?`   
Required: Yes

 ** [Marker](#API_ListFunctionEventInvokeConfigs_RequestSyntax) **   <a name="lambda-ListFunctionEventInvokeConfigs-request-uri-Marker"></a>
Specify the pagination token that's returned by a previous request to retrieve the next page of results.

 ** [MaxItems](#API_ListFunctionEventInvokeConfigs_RequestSyntax) **   <a name="lambda-ListFunctionEventInvokeConfigs-request-uri-MaxItems"></a>
The maximum number of configurations to return.  
Valid Range: Minimum value of 1. Maximum value of 50.

## Request Body
<a name="API_ListFunctionEventInvokeConfigs_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListFunctionEventInvokeConfigs_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "FunctionEventInvokeConfigs": [ 
      { 
         "DestinationConfig": { 
            "OnFailure": { 
               "Destination": "string"
            },
            "OnSuccess": { 
               "Destination": "string"
            }
         },
         "FunctionArn": "string",
         "LastModified": number,
         "MaximumEventAgeInSeconds": number,
         "MaximumRetryAttempts": number
      }
   ],
   "NextMarker": "string"
}
```

## Response Elements
<a name="API_ListFunctionEventInvokeConfigs_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [FunctionEventInvokeConfigs](#API_ListFunctionEventInvokeConfigs_ResponseSyntax) **   <a name="lambda-ListFunctionEventInvokeConfigs-response-FunctionEventInvokeConfigs"></a>
A list of configurations.  
Type: Array of [FunctionEventInvokeConfig](API_FunctionEventInvokeConfig.md) objects

 ** [NextMarker](#API_ListFunctionEventInvokeConfigs_ResponseSyntax) **   <a name="lambda-ListFunctionEventInvokeConfigs-response-NextMarker"></a>
The pagination token that's included if more results are available.  
Type: String

## Errors
<a name="API_ListFunctionEventInvokeConfigs_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_ListFunctionEventInvokeConfigs_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/ListFunctionEventInvokeConfigs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/ListFunctionEventInvokeConfigs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListFunctionEventInvokeConfigs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/ListFunctionEventInvokeConfigs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListFunctionEventInvokeConfigs) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListFunctionEventInvokeConfigs) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/ListFunctionEventInvokeConfigs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListFunctionEventInvokeConfigs) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListFunctionEventInvokeConfigs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListFunctionEventInvokeConfigs) 

# ListFunctions
<a name="API_ListFunctions"></a>

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.

**Note**  
The `ListFunctions` operation returns a subset of the [FunctionConfiguration](API_FunctionConfiguration.md) fields. To get the additional fields (State, StateReasonCode, StateReason, LastUpdateStatus, LastUpdateStatusReason, LastUpdateStatusReasonCode, RuntimeVersionConfig) for a function or version, use [GetFunction](API_GetFunction.md).

## Request Syntax
<a name="API_ListFunctions_RequestSyntax"></a>

```
GET /2015-03-31/functions?FunctionVersion=FunctionVersion&Marker=Marker&MasterRegion=MasterRegion&MaxItems=MaxItems HTTP/1.1
```

## URI Request Parameters
<a name="API_ListFunctions_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionVersion](#API_ListFunctions_RequestSyntax) **   <a name="lambda-ListFunctions-request-uri-FunctionVersion"></a>
Set to `ALL` to include entries for all published versions of each function.  
Valid Values: `ALL` 

 ** [Marker](#API_ListFunctions_RequestSyntax) **   <a name="lambda-ListFunctions-request-uri-Marker"></a>
Specify the pagination token that's returned by a previous request to retrieve the next page of results.

 ** [MasterRegion](#API_ListFunctions_RequestSyntax) **   <a name="lambda-ListFunctions-request-uri-MasterRegion"></a>
For Lambda@Edge functions, the AWS Region of the master function. For example, `us-east-1` filters the list of functions to include only Lambda@Edge functions replicated from a master function in US East (N. Virginia). If specified, you must set `FunctionVersion` to `ALL`.  
Pattern: `ALL|[a-z]{2}(-gov)?-[a-z]+-\d{1}` 

 ** [MaxItems](#API_ListFunctions_RequestSyntax) **   <a name="lambda-ListFunctions-request-uri-MaxItems"></a>
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
<a name="API_ListFunctions_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListFunctions_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Functions": [ 
      { 
         "Architectures": [ "string" ],
         "CapacityProviderConfig": { 
            "LambdaManagedInstancesCapacityProviderConfig": { 
               "CapacityProviderArn": "string",
               "ExecutionEnvironmentMemoryGiBPerVCpu": number,
               "PerExecutionEnvironmentMaxConcurrency": number
            }
         },
         "CodeSha256": "string",
         "CodeSize": number,
         "ConfigSha256": "string",
         "DeadLetterConfig": { 
            "TargetArn": "string"
         },
         "Description": "string",
         "DurableConfig": { 
            "ExecutionTimeout": number,
            "RetentionPeriodInDays": number
         },
         "Environment": { 
            "Error": { 
               "ErrorCode": "string",
               "Message": "string"
            },
            "Variables": { 
               "string" : "string" 
            }
         },
         "EphemeralStorage": { 
            "Size": number
         },
         "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"
            }
         ],
         "LoggingConfig": { 
            "ApplicationLogLevel": "string",
            "LogFormat": "string",
            "LogGroup": "string",
            "SystemLogLevel": "string"
         },
         "MasterArn": "string",
         "MemorySize": number,
         "PackageType": "string",
         "RevisionId": "string",
         "Role": "string",
         "Runtime": "string",
         "RuntimeVersionConfig": { 
            "Error": { 
               "ErrorCode": "string",
               "Message": "string"
            },
            "RuntimeVersionArn": "string"
         },
         "SigningJobArn": "string",
         "SigningProfileVersionArn": "string",
         "SnapStart": { 
            "ApplyOn": "string",
            "OptimizationStatus": "string"
         },
         "State": "string",
         "StateReason": "string",
         "StateReasonCode": "string",
         "TenancyConfig": { 
            "TenantIsolationMode": "string"
         },
         "Timeout": number,
         "TracingConfig": { 
            "Mode": "string"
         },
         "Version": "string",
         "VpcConfig": { 
            "Ipv6AllowedForDualStack": boolean,
            "SecurityGroupIds": [ "string" ],
            "SubnetIds": [ "string" ],
            "VpcId": "string"
         }
      }
   ],
   "NextMarker": "string"
}
```

## Response Elements
<a name="API_ListFunctions_ResponseElements"></a>

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](#API_ListFunctions_ResponseSyntax) **   <a name="lambda-ListFunctions-response-Functions"></a>
A list of Lambda functions.  
Type: Array of [FunctionConfiguration](API_FunctionConfiguration.md) objects

 ** [NextMarker](#API_ListFunctions_ResponseSyntax) **   <a name="lambda-ListFunctions-response-NextMarker"></a>
The pagination token that's included if more results are available.  
Type: String

## Errors
<a name="API_ListFunctions_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_ListFunctions_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/ListFunctions) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/ListFunctions) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListFunctions) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/ListFunctions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListFunctions) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListFunctions) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/ListFunctions) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListFunctions) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListFunctions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListFunctions) 

# ListFunctionsByCodeSigningConfig
<a name="API_ListFunctionsByCodeSigningConfig"></a>

List the functions that use the specified code signing configuration. You can use this method prior to deleting a code signing configuration, to verify that no functions are using it.

## Request Syntax
<a name="API_ListFunctionsByCodeSigningConfig_RequestSyntax"></a>

```
GET /2020-04-22/code-signing-configs/CodeSigningConfigArn/functions?Marker=Marker&MaxItems=MaxItems HTTP/1.1
```

## URI Request Parameters
<a name="API_ListFunctionsByCodeSigningConfig_RequestParameters"></a>

The request uses the following URI parameters.

 ** [CodeSigningConfigArn](#API_ListFunctionsByCodeSigningConfig_RequestSyntax) **   <a name="lambda-ListFunctionsByCodeSigningConfig-request-uri-CodeSigningConfigArn"></a>
The The Amazon Resource Name (ARN) of the code signing configuration.  
Length Constraints: Minimum length of 0. Maximum length of 200.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}:\d{12}:code-signing-config:csc-[a-z0-9]{17}`   
Required: Yes

 ** [Marker](#API_ListFunctionsByCodeSigningConfig_RequestSyntax) **   <a name="lambda-ListFunctionsByCodeSigningConfig-request-uri-Marker"></a>
Specify the pagination token that's returned by a previous request to retrieve the next page of results.

 ** [MaxItems](#API_ListFunctionsByCodeSigningConfig_RequestSyntax) **   <a name="lambda-ListFunctionsByCodeSigningConfig-request-uri-MaxItems"></a>
Maximum number of items to return.  
Valid Range: Minimum value of 1. Maximum value of 10000.

## Request Body
<a name="API_ListFunctionsByCodeSigningConfig_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListFunctionsByCodeSigningConfig_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "FunctionArns": [ "string" ],
   "NextMarker": "string"
}
```

## Response Elements
<a name="API_ListFunctionsByCodeSigningConfig_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [FunctionArns](#API_ListFunctionsByCodeSigningConfig_ResponseSyntax) **   <a name="lambda-ListFunctionsByCodeSigningConfig-response-FunctionArns"></a>
The function ARNs.   
Type: Array of strings  
Length Constraints: Minimum length of 0. Maximum length of 10000.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?` 

 ** [NextMarker](#API_ListFunctionsByCodeSigningConfig_ResponseSyntax) **   <a name="lambda-ListFunctionsByCodeSigningConfig-response-NextMarker"></a>
The pagination token that's included if more results are available.  
Type: String

## Errors
<a name="API_ListFunctionsByCodeSigningConfig_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

## See Also
<a name="API_ListFunctionsByCodeSigningConfig_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/ListFunctionsByCodeSigningConfig) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/ListFunctionsByCodeSigningConfig) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListFunctionsByCodeSigningConfig) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/ListFunctionsByCodeSigningConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListFunctionsByCodeSigningConfig) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListFunctionsByCodeSigningConfig) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/ListFunctionsByCodeSigningConfig) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListFunctionsByCodeSigningConfig) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListFunctionsByCodeSigningConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListFunctionsByCodeSigningConfig) 

# ListFunctionUrlConfigs
<a name="API_ListFunctionUrlConfigs"></a>

Returns a list of Lambda function URLs for the specified function.

## Request Syntax
<a name="API_ListFunctionUrlConfigs_RequestSyntax"></a>

```
GET /2021-10-31/functions/FunctionName/urls?Marker=Marker&MaxItems=MaxItems HTTP/1.1
```

## URI Request Parameters
<a name="API_ListFunctionUrlConfigs_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_ListFunctionUrlConfigs_RequestSyntax) **   <a name="lambda-ListFunctionUrlConfigs-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?`   
Required: Yes

 ** [Marker](#API_ListFunctionUrlConfigs_RequestSyntax) **   <a name="lambda-ListFunctionUrlConfigs-request-uri-Marker"></a>
Specify the pagination token that's returned by a previous request to retrieve the next page of results.

 ** [MaxItems](#API_ListFunctionUrlConfigs_RequestSyntax) **   <a name="lambda-ListFunctionUrlConfigs-request-uri-MaxItems"></a>
The maximum number of function URLs to return in the response. Note that `ListFunctionUrlConfigs` 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 50.

## Request Body
<a name="API_ListFunctionUrlConfigs_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListFunctionUrlConfigs_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "FunctionUrlConfigs": [ 
      { 
         "AuthType": "string",
         "Cors": { 
            "AllowCredentials": boolean,
            "AllowHeaders": [ "string" ],
            "AllowMethods": [ "string" ],
            "AllowOrigins": [ "string" ],
            "ExposeHeaders": [ "string" ],
            "MaxAge": number
         },
         "CreationTime": "string",
         "FunctionArn": "string",
         "FunctionUrl": "string",
         "InvokeMode": "string",
         "LastModifiedTime": "string"
      }
   ],
   "NextMarker": "string"
}
```

## Response Elements
<a name="API_ListFunctionUrlConfigs_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [FunctionUrlConfigs](#API_ListFunctionUrlConfigs_ResponseSyntax) **   <a name="lambda-ListFunctionUrlConfigs-response-FunctionUrlConfigs"></a>
A list of function URL configurations.  
Type: Array of [FunctionUrlConfig](API_FunctionUrlConfig.md) objects

 ** [NextMarker](#API_ListFunctionUrlConfigs_ResponseSyntax) **   <a name="lambda-ListFunctionUrlConfigs-response-NextMarker"></a>
The pagination token that's included if more results are available.  
Type: String

## Errors
<a name="API_ListFunctionUrlConfigs_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_ListFunctionUrlConfigs_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/ListFunctionUrlConfigs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/ListFunctionUrlConfigs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListFunctionUrlConfigs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/ListFunctionUrlConfigs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListFunctionUrlConfigs) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListFunctionUrlConfigs) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/ListFunctionUrlConfigs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListFunctionUrlConfigs) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListFunctionUrlConfigs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListFunctionUrlConfigs) 

# ListFunctionVersionsByCapacityProvider
<a name="API_ListFunctionVersionsByCapacityProvider"></a>

Returns a list of function versions that are configured to use a specific capacity provider.

## Request Syntax
<a name="API_ListFunctionVersionsByCapacityProvider_RequestSyntax"></a>

```
GET /2025-11-30/capacity-providers/CapacityProviderName/function-versions?Marker=Marker&MaxItems=MaxItems HTTP/1.1
```

## URI Request Parameters
<a name="API_ListFunctionVersionsByCapacityProvider_RequestParameters"></a>

The request uses the following URI parameters.

 ** [CapacityProviderName](#API_ListFunctionVersionsByCapacityProvider_RequestSyntax) **   <a name="lambda-ListFunctionVersionsByCapacityProvider-request-uri-CapacityProviderName"></a>
The name of the capacity provider to list function versions for.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:aws[a-zA-Z-]*:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:capacity-provider:[a-zA-Z0-9-_]+)|[a-zA-Z0-9-_]+`   
Required: Yes

 ** [Marker](#API_ListFunctionVersionsByCapacityProvider_RequestSyntax) **   <a name="lambda-ListFunctionVersionsByCapacityProvider-request-uri-Marker"></a>
Specify the pagination token that's returned by a previous request to retrieve the next page of results.

 ** [MaxItems](#API_ListFunctionVersionsByCapacityProvider_RequestSyntax) **   <a name="lambda-ListFunctionVersionsByCapacityProvider-request-uri-MaxItems"></a>
The maximum number of function versions to return in the response.  
Valid Range: Minimum value of 1. Maximum value of 50.

## Request Body
<a name="API_ListFunctionVersionsByCapacityProvider_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListFunctionVersionsByCapacityProvider_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CapacityProviderArn": "string",
   "FunctionVersions": [ 
      { 
         "FunctionArn": "string",
         "State": "string"
      }
   ],
   "NextMarker": "string"
}
```

## Response Elements
<a name="API_ListFunctionVersionsByCapacityProvider_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [CapacityProviderArn](#API_ListFunctionVersionsByCapacityProvider_ResponseSyntax) **   <a name="lambda-ListFunctionVersionsByCapacityProvider-response-CapacityProviderArn"></a>
The Amazon Resource Name (ARN) of the capacity provider.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `arn:aws[a-zA-Z-]*:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:capacity-provider:[a-zA-Z0-9-_]+` 

 ** [FunctionVersions](#API_ListFunctionVersionsByCapacityProvider_ResponseSyntax) **   <a name="lambda-ListFunctionVersionsByCapacityProvider-response-FunctionVersions"></a>
A list of function versions that use the specified capacity provider.  
Type: Array of [FunctionVersionsByCapacityProviderListItem](API_FunctionVersionsByCapacityProviderListItem.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 50 items.

 ** [NextMarker](#API_ListFunctionVersionsByCapacityProvider_ResponseSyntax) **   <a name="lambda-ListFunctionVersionsByCapacityProvider-response-NextMarker"></a>
The pagination token that's included if more results are available.  
Type: String

## Errors
<a name="API_ListFunctionVersionsByCapacityProvider_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_ListFunctionVersionsByCapacityProvider_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/ListFunctionVersionsByCapacityProvider) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/ListFunctionVersionsByCapacityProvider) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListFunctionVersionsByCapacityProvider) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/ListFunctionVersionsByCapacityProvider) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListFunctionVersionsByCapacityProvider) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListFunctionVersionsByCapacityProvider) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/ListFunctionVersionsByCapacityProvider) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListFunctionVersionsByCapacityProvider) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListFunctionVersionsByCapacityProvider) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListFunctionVersionsByCapacityProvider) 

# ListLayers
<a name="API_ListLayers"></a>

Lists [AWS Lambda layers](https://docs.aws.amazon.com/lambda/latest/dg/invocation-layers.html) and shows information about the latest version of each. Specify a [runtime identifier](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html) to list only layers that indicate that they're compatible with that runtime. Specify a compatible architecture to include only layers that are compatible with that [instruction set architecture](https://docs.aws.amazon.com/lambda/latest/dg/foundation-arch.html).

## Request Syntax
<a name="API_ListLayers_RequestSyntax"></a>

```
GET /2018-10-31/layers?CompatibleArchitecture=CompatibleArchitecture&CompatibleRuntime=CompatibleRuntime&Marker=Marker&MaxItems=MaxItems HTTP/1.1
```

## URI Request Parameters
<a name="API_ListLayers_RequestParameters"></a>

The request uses the following URI parameters.

 ** [CompatibleArchitecture](#API_ListLayers_RequestSyntax) **   <a name="lambda-ListLayers-request-uri-CompatibleArchitecture"></a>
The compatible [instruction set architecture](https://docs.aws.amazon.com/lambda/latest/dg/foundation-arch.html).  
Valid Values: `x86_64 | arm64` 

 ** [CompatibleRuntime](#API_ListLayers_RequestSyntax) **   <a name="lambda-ListLayers-request-uri-CompatibleRuntime"></a>
A runtime identifier.  
The following list includes deprecated runtimes. For more information, see [Runtime use after deprecation](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-deprecation-levels).  
For a list of all currently supported runtimes, see [Supported runtimes](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtimes-supported).  
Valid Values: `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 | nodejs24.x | python3.14 | java25 | dotnet10` 

 ** [Marker](#API_ListLayers_RequestSyntax) **   <a name="lambda-ListLayers-request-uri-Marker"></a>
A pagination token returned by a previous call.

 ** [MaxItems](#API_ListLayers_RequestSyntax) **   <a name="lambda-ListLayers-request-uri-MaxItems"></a>
The maximum number of layers to return.  
Valid Range: Minimum value of 1. Maximum value of 50.

## Request Body
<a name="API_ListLayers_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListLayers_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Layers": [ 
      { 
         "LatestMatchingVersion": { 
            "CompatibleArchitectures": [ "string" ],
            "CompatibleRuntimes": [ "string" ],
            "CreatedDate": "string",
            "Description": "string",
            "LayerVersionArn": "string",
            "LicenseInfo": "string",
            "Version": number
         },
         "LayerArn": "string",
         "LayerName": "string"
      }
   ],
   "NextMarker": "string"
}
```

## Response Elements
<a name="API_ListLayers_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [Layers](#API_ListLayers_ResponseSyntax) **   <a name="lambda-ListLayers-response-Layers"></a>
A list of function layers.  
Type: Array of [LayersListItem](API_LayersListItem.md) objects

 ** [NextMarker](#API_ListLayers_ResponseSyntax) **   <a name="lambda-ListLayers-response-NextMarker"></a>
A pagination token returned when the response doesn't contain all layers.  
Type: String

## Errors
<a name="API_ListLayers_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_ListLayers_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/ListLayers) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/ListLayers) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListLayers) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/ListLayers) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListLayers) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListLayers) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/ListLayers) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListLayers) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListLayers) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListLayers) 

# ListLayerVersions
<a name="API_ListLayerVersions"></a>

Lists the versions of an [AWS Lambda layer](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html). Versions that have been deleted aren't listed. Specify a [runtime identifier](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html) to list only versions that indicate that they're compatible with that runtime. Specify a compatible architecture to include only layer versions that are compatible with that architecture.

## Request Syntax
<a name="API_ListLayerVersions_RequestSyntax"></a>

```
GET /2018-10-31/layers/LayerName/versions?CompatibleArchitecture=CompatibleArchitecture&CompatibleRuntime=CompatibleRuntime&Marker=Marker&MaxItems=MaxItems HTTP/1.1
```

## URI Request Parameters
<a name="API_ListLayerVersions_RequestParameters"></a>

The request uses the following URI parameters.

 ** [CompatibleArchitecture](#API_ListLayerVersions_RequestSyntax) **   <a name="lambda-ListLayerVersions-request-uri-CompatibleArchitecture"></a>
The compatible [instruction set architecture](https://docs.aws.amazon.com/lambda/latest/dg/foundation-arch.html).  
Valid Values: `x86_64 | arm64` 

 ** [CompatibleRuntime](#API_ListLayerVersions_RequestSyntax) **   <a name="lambda-ListLayerVersions-request-uri-CompatibleRuntime"></a>
A runtime identifier.  
The following list includes deprecated runtimes. For more information, see [Runtime use after deprecation](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-deprecation-levels).  
For a list of all currently supported runtimes, see [Supported runtimes](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtimes-supported).  
Valid Values: `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 | nodejs24.x | python3.14 | java25 | dotnet10` 

 ** [LayerName](#API_ListLayerVersions_RequestSyntax) **   <a name="lambda-ListLayerVersions-request-uri-LayerName"></a>
The name or Amazon Resource Name (ARN) of the layer.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+)|[a-zA-Z0-9-_]+`   
Required: Yes

 ** [Marker](#API_ListLayerVersions_RequestSyntax) **   <a name="lambda-ListLayerVersions-request-uri-Marker"></a>
A pagination token returned by a previous call.

 ** [MaxItems](#API_ListLayerVersions_RequestSyntax) **   <a name="lambda-ListLayerVersions-request-uri-MaxItems"></a>
The maximum number of versions to return.  
Valid Range: Minimum value of 1. Maximum value of 50.

## Request Body
<a name="API_ListLayerVersions_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListLayerVersions_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "LayerVersions": [ 
      { 
         "CompatibleArchitectures": [ "string" ],
         "CompatibleRuntimes": [ "string" ],
         "CreatedDate": "string",
         "Description": "string",
         "LayerVersionArn": "string",
         "LicenseInfo": "string",
         "Version": number
      }
   ],
   "NextMarker": "string"
}
```

## Response Elements
<a name="API_ListLayerVersions_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [LayerVersions](#API_ListLayerVersions_ResponseSyntax) **   <a name="lambda-ListLayerVersions-response-LayerVersions"></a>
A list of versions.  
Type: Array of [LayerVersionsListItem](API_LayerVersionsListItem.md) objects

 ** [NextMarker](#API_ListLayerVersions_ResponseSyntax) **   <a name="lambda-ListLayerVersions-response-NextMarker"></a>
A pagination token returned when the response doesn't contain all versions.  
Type: String

## Errors
<a name="API_ListLayerVersions_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_ListLayerVersions_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/ListLayerVersions) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/ListLayerVersions) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListLayerVersions) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/ListLayerVersions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListLayerVersions) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListLayerVersions) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/ListLayerVersions) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListLayerVersions) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListLayerVersions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListLayerVersions) 

# ListProvisionedConcurrencyConfigs
<a name="API_ListProvisionedConcurrencyConfigs"></a>

Retrieves a list of provisioned concurrency configurations for a function.

## Request Syntax
<a name="API_ListProvisionedConcurrencyConfigs_RequestSyntax"></a>

```
GET /2019-09-30/functions/FunctionName/provisioned-concurrency?List=ALL&Marker=Marker&MaxItems=MaxItems HTTP/1.1
```

## URI Request Parameters
<a name="API_ListProvisionedConcurrencyConfigs_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_ListProvisionedConcurrencyConfigs_RequestSyntax) **   <a name="lambda-ListProvisionedConcurrencyConfigs-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?`   
Required: Yes

 ** [Marker](#API_ListProvisionedConcurrencyConfigs_RequestSyntax) **   <a name="lambda-ListProvisionedConcurrencyConfigs-request-uri-Marker"></a>
Specify the pagination token that's returned by a previous request to retrieve the next page of results.

 ** [MaxItems](#API_ListProvisionedConcurrencyConfigs_RequestSyntax) **   <a name="lambda-ListProvisionedConcurrencyConfigs-request-uri-MaxItems"></a>
Specify a number to limit the number of configurations returned.  
Valid Range: Minimum value of 1. Maximum value of 50.

## Request Body
<a name="API_ListProvisionedConcurrencyConfigs_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListProvisionedConcurrencyConfigs_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextMarker": "string",
   "ProvisionedConcurrencyConfigs": [ 
      { 
         "AllocatedProvisionedConcurrentExecutions": number,
         "AvailableProvisionedConcurrentExecutions": number,
         "FunctionArn": "string",
         "LastModified": "string",
         "RequestedProvisionedConcurrentExecutions": number,
         "Status": "string",
         "StatusReason": "string"
      }
   ]
}
```

## Response Elements
<a name="API_ListProvisionedConcurrencyConfigs_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [NextMarker](#API_ListProvisionedConcurrencyConfigs_ResponseSyntax) **   <a name="lambda-ListProvisionedConcurrencyConfigs-response-NextMarker"></a>
The pagination token that's included if more results are available.  
Type: String

 ** [ProvisionedConcurrencyConfigs](#API_ListProvisionedConcurrencyConfigs_ResponseSyntax) **   <a name="lambda-ListProvisionedConcurrencyConfigs-response-ProvisionedConcurrencyConfigs"></a>
A list of provisioned concurrency configurations.  
Type: Array of [ProvisionedConcurrencyConfigListItem](API_ProvisionedConcurrencyConfigListItem.md) objects

## Errors
<a name="API_ListProvisionedConcurrencyConfigs_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_ListProvisionedConcurrencyConfigs_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/ListProvisionedConcurrencyConfigs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/ListProvisionedConcurrencyConfigs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListProvisionedConcurrencyConfigs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/ListProvisionedConcurrencyConfigs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListProvisionedConcurrencyConfigs) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListProvisionedConcurrencyConfigs) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/ListProvisionedConcurrencyConfigs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListProvisionedConcurrencyConfigs) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListProvisionedConcurrencyConfigs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListProvisionedConcurrencyConfigs) 

# ListTags
<a name="API_ListTags"></a>

Returns a function, event source mapping, or code signing configuration's [tags](https://docs.aws.amazon.com/lambda/latest/dg/tagging.html). You can also view function tags with [GetFunction](API_GetFunction.md).

## Request Syntax
<a name="API_ListTags_RequestSyntax"></a>

```
GET /2017-03-31/tags/Resource HTTP/1.1
```

## URI Request Parameters
<a name="API_ListTags_RequestParameters"></a>

The request uses the following URI parameters.

 ** [Resource](#API_ListTags_RequestSyntax) **   <a name="lambda-ListTags-request-uri-Resource"></a>
The resource's Amazon Resource Name (ARN). Note: Lambda does not support adding tags to function aliases or versions.  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `arn:(aws[a-zA-Z-]*):lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:(function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?|code-signing-config:csc-[a-z0-9]{17}|event-source-mapping:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}|capacity-provider:[a-zA-Z0-9-_]+)`   
Required: Yes

## Request Body
<a name="API_ListTags_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListTags_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Tags": { 
      "string" : "string" 
   }
}
```

## Response Elements
<a name="API_ListTags_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [Tags](#API_ListTags_ResponseSyntax) **   <a name="lambda-ListTags-response-Tags"></a>
The function's tags.  
Type: String to string map

## Errors
<a name="API_ListTags_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_ListTags_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/ListTags) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/ListTags) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListTags) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/ListTags) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListTags) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListTags) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/ListTags) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListTags) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListTags) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListTags) 

# ListVersionsByFunction
<a name="API_ListVersionsByFunction"></a>

Returns a list of [versions](https://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html), with the version-specific configuration of each. Lambda returns up to 50 versions per call.

## Request Syntax
<a name="API_ListVersionsByFunction_RequestSyntax"></a>

```
GET /2015-03-31/functions/FunctionName/versions?Marker=Marker&MaxItems=MaxItems HTTP/1.1
```

## URI Request Parameters
<a name="API_ListVersionsByFunction_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_ListVersionsByFunction_RequestSyntax) **   <a name="lambda-ListVersionsByFunction-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?`   
Required: Yes

 ** [Marker](#API_ListVersionsByFunction_RequestSyntax) **   <a name="lambda-ListVersionsByFunction-request-uri-Marker"></a>
Specify the pagination token that's returned by a previous request to retrieve the next page of results.

 ** [MaxItems](#API_ListVersionsByFunction_RequestSyntax) **   <a name="lambda-ListVersionsByFunction-request-uri-MaxItems"></a>
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.  
Valid Range: Minimum value of 1. Maximum value of 10000.

## Request Body
<a name="API_ListVersionsByFunction_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListVersionsByFunction_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextMarker": "string",
   "Versions": [ 
      { 
         "Architectures": [ "string" ],
         "CapacityProviderConfig": { 
            "LambdaManagedInstancesCapacityProviderConfig": { 
               "CapacityProviderArn": "string",
               "ExecutionEnvironmentMemoryGiBPerVCpu": number,
               "PerExecutionEnvironmentMaxConcurrency": number
            }
         },
         "CodeSha256": "string",
         "CodeSize": number,
         "ConfigSha256": "string",
         "DeadLetterConfig": { 
            "TargetArn": "string"
         },
         "Description": "string",
         "DurableConfig": { 
            "ExecutionTimeout": number,
            "RetentionPeriodInDays": number
         },
         "Environment": { 
            "Error": { 
               "ErrorCode": "string",
               "Message": "string"
            },
            "Variables": { 
               "string" : "string" 
            }
         },
         "EphemeralStorage": { 
            "Size": number
         },
         "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"
            }
         ],
         "LoggingConfig": { 
            "ApplicationLogLevel": "string",
            "LogFormat": "string",
            "LogGroup": "string",
            "SystemLogLevel": "string"
         },
         "MasterArn": "string",
         "MemorySize": number,
         "PackageType": "string",
         "RevisionId": "string",
         "Role": "string",
         "Runtime": "string",
         "RuntimeVersionConfig": { 
            "Error": { 
               "ErrorCode": "string",
               "Message": "string"
            },
            "RuntimeVersionArn": "string"
         },
         "SigningJobArn": "string",
         "SigningProfileVersionArn": "string",
         "SnapStart": { 
            "ApplyOn": "string",
            "OptimizationStatus": "string"
         },
         "State": "string",
         "StateReason": "string",
         "StateReasonCode": "string",
         "TenancyConfig": { 
            "TenantIsolationMode": "string"
         },
         "Timeout": number,
         "TracingConfig": { 
            "Mode": "string"
         },
         "Version": "string",
         "VpcConfig": { 
            "Ipv6AllowedForDualStack": boolean,
            "SecurityGroupIds": [ "string" ],
            "SubnetIds": [ "string" ],
            "VpcId": "string"
         }
      }
   ]
}
```

## Response Elements
<a name="API_ListVersionsByFunction_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [NextMarker](#API_ListVersionsByFunction_ResponseSyntax) **   <a name="lambda-ListVersionsByFunction-response-NextMarker"></a>
The pagination token that's included if more results are available.  
Type: String

 ** [Versions](#API_ListVersionsByFunction_ResponseSyntax) **   <a name="lambda-ListVersionsByFunction-response-Versions"></a>
A list of Lambda function versions.  
Type: Array of [FunctionConfiguration](API_FunctionConfiguration.md) objects

## Errors
<a name="API_ListVersionsByFunction_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_ListVersionsByFunction_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/ListVersionsByFunction) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/ListVersionsByFunction) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/ListVersionsByFunction) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/ListVersionsByFunction) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/ListVersionsByFunction) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/ListVersionsByFunction) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/ListVersionsByFunction) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/ListVersionsByFunction) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/ListVersionsByFunction) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/ListVersionsByFunction) 

# PublishLayerVersion
<a name="API_PublishLayerVersion"></a>

Creates an [AWS Lambda layer](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html) from a ZIP archive. Each time you call `PublishLayerVersion` with the same layer name, a new version is created.

Add layers to your function with [CreateFunction](API_CreateFunction.md) or [UpdateFunctionConfiguration](API_UpdateFunctionConfiguration.md).

## Request Syntax
<a name="API_PublishLayerVersion_RequestSyntax"></a>

```
POST /2018-10-31/layers/LayerName/versions HTTP/1.1
Content-type: application/json

{
   "CompatibleArchitectures": [ "string" ],
   "CompatibleRuntimes": [ "string" ],
   "Content": { 
      "S3Bucket": "string",
      "S3Key": "string",
      "S3ObjectVersion": "string",
      "ZipFile": blob
   },
   "Description": "string",
   "LicenseInfo": "string"
}
```

## URI Request Parameters
<a name="API_PublishLayerVersion_RequestParameters"></a>

The request uses the following URI parameters.

 ** [LayerName](#API_PublishLayerVersion_RequestSyntax) **   <a name="lambda-PublishLayerVersion-request-uri-LayerName"></a>
The name or Amazon Resource Name (ARN) of the layer.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+)|[a-zA-Z0-9-_]+`   
Required: Yes

## Request Body
<a name="API_PublishLayerVersion_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [CompatibleArchitectures](#API_PublishLayerVersion_RequestSyntax) **   <a name="lambda-PublishLayerVersion-request-CompatibleArchitectures"></a>
A list of compatible [instruction set architectures](https://docs.aws.amazon.com/lambda/latest/dg/foundation-arch.html).  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 2 items.  
Valid Values: `x86_64 | arm64`   
Required: No

 ** [CompatibleRuntimes](#API_PublishLayerVersion_RequestSyntax) **   <a name="lambda-PublishLayerVersion-request-CompatibleRuntimes"></a>
A list of compatible [function runtimes](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html). Used for filtering with [ListLayers](API_ListLayers.md) and [ListLayerVersions](API_ListLayerVersions.md).  
The following list includes deprecated runtimes. For more information, see [Runtime deprecation policy](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy).  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 15 items.  
Valid Values: `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 | nodejs24.x | python3.14 | java25 | dotnet10`   
Required: No

 ** [Content](#API_PublishLayerVersion_RequestSyntax) **   <a name="lambda-PublishLayerVersion-request-Content"></a>
The function layer archive.  
Type: [LayerVersionContentInput](API_LayerVersionContentInput.md) object  
Required: Yes

 ** [Description](#API_PublishLayerVersion_RequestSyntax) **   <a name="lambda-PublishLayerVersion-request-Description"></a>
The description of the version.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 256.  
Required: No

 ** [LicenseInfo](#API_PublishLayerVersion_RequestSyntax) **   <a name="lambda-PublishLayerVersion-request-LicenseInfo"></a>
The layer's software license. It can be any of the following:  
+ An [SPDX license identifier](https://spdx.org/licenses/). 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.
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 512.  
Required: No

## Response Syntax
<a name="API_PublishLayerVersion_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "CompatibleArchitectures": [ "string" ],
   "CompatibleRuntimes": [ "string" ],
   "Content": { 
      "CodeSha256": "string",
      "CodeSize": number,
      "Location": "string",
      "SigningJobArn": "string",
      "SigningProfileVersionArn": "string"
   },
   "CreatedDate": "string",
   "Description": "string",
   "LayerArn": "string",
   "LayerVersionArn": "string",
   "LicenseInfo": "string",
   "Version": number
}
```

## Response Elements
<a name="API_PublishLayerVersion_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 201 response.

The following data is returned in JSON format by the service.

 ** [CompatibleArchitectures](#API_PublishLayerVersion_ResponseSyntax) **   <a name="lambda-PublishLayerVersion-response-CompatibleArchitectures"></a>
A list of compatible [instruction set architectures](https://docs.aws.amazon.com/lambda/latest/dg/foundation-arch.html).  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 2 items.  
Valid Values: `x86_64 | arm64` 

 ** [CompatibleRuntimes](#API_PublishLayerVersion_ResponseSyntax) **   <a name="lambda-PublishLayerVersion-response-CompatibleRuntimes"></a>
The layer's compatible runtimes.  
The following list includes deprecated runtimes. For more information, see [Runtime use after deprecation](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-deprecation-levels).  
For a list of all currently supported runtimes, see [Supported runtimes](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtimes-supported).  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 15 items.  
Valid Values: `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 | nodejs24.x | python3.14 | java25 | dotnet10` 

 ** [Content](#API_PublishLayerVersion_ResponseSyntax) **   <a name="lambda-PublishLayerVersion-response-Content"></a>
Details about the layer version.  
Type: [LayerVersionContentOutput](API_LayerVersionContentOutput.md) object

 ** [CreatedDate](#API_PublishLayerVersion_ResponseSyntax) **   <a name="lambda-PublishLayerVersion-response-CreatedDate"></a>
The date that the layer version was created, in [ISO-8601 format](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD).  
Type: String

 ** [Description](#API_PublishLayerVersion_ResponseSyntax) **   <a name="lambda-PublishLayerVersion-response-Description"></a>
The description of the version.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 256.

 ** [LayerArn](#API_PublishLayerVersion_ResponseSyntax) **   <a name="lambda-PublishLayerVersion-response-LayerArn"></a>
The ARN of the layer.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+` 

 ** [LayerVersionArn](#API_PublishLayerVersion_ResponseSyntax) **   <a name="lambda-PublishLayerVersion-response-LayerVersionArn"></a>
The ARN of the layer version.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+:[0-9]+` 

 ** [LicenseInfo](#API_PublishLayerVersion_ResponseSyntax) **   <a name="lambda-PublishLayerVersion-response-LicenseInfo"></a>
The layer's software license.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 512.

 ** [Version](#API_PublishLayerVersion_ResponseSyntax) **   <a name="lambda-PublishLayerVersion-response-Version"></a>
The version number.  
Type: Long

## Errors
<a name="API_PublishLayerVersion_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** CodeStorageExceededException **   
Your AWS account has exceeded its maximum total code size. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html).    
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_PublishLayerVersion_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/PublishLayerVersion) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/PublishLayerVersion) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/PublishLayerVersion) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/PublishLayerVersion) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/PublishLayerVersion) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/PublishLayerVersion) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/PublishLayerVersion) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/PublishLayerVersion) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/PublishLayerVersion) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/PublishLayerVersion) 

# PublishVersion
<a name="API_PublishVersion"></a>

Creates a [version](https://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html) from the current code and configuration of a function. Use versions to create a snapshot of your function code and configuration that doesn't change.

 AWS Lambda doesn't publish a version if the function's configuration and code haven't changed since the last version. Use [UpdateFunctionCode](API_UpdateFunctionCode.md) or [UpdateFunctionConfiguration](API_UpdateFunctionConfiguration.md) to update the function before publishing a version.

Clients can invoke versions directly or with an alias. To create an alias, use [CreateAlias](API_CreateAlias.md).

## Request Syntax
<a name="API_PublishVersion_RequestSyntax"></a>

```
POST /2015-03-31/functions/FunctionName/versions HTTP/1.1
Content-type: application/json

{
   "CodeSha256": "string",
   "Description": "string",
   "PublishTo": "string",
   "RevisionId": "string"
}
```

## URI Request Parameters
<a name="API_PublishVersion_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_PublishVersion_RequestSyntax) **   <a name="lambda-PublishVersion-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?`   
Required: Yes

## Request Body
<a name="API_PublishVersion_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [CodeSha256](#API_PublishVersion_RequestSyntax) **   <a name="lambda-PublishVersion-request-CodeSha256"></a>
Only publish a version if the hash value matches the value that's specified. Use this option to avoid publishing a version if the function code has changed since you last updated it. You can get the hash for the version that you uploaded from the output of [UpdateFunctionCode](API_UpdateFunctionCode.md).  
Type: String  
Required: No

 ** [Description](#API_PublishVersion_RequestSyntax) **   <a name="lambda-PublishVersion-request-Description"></a>
A description for the version to override the description in the function configuration.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 256.  
Required: No

 ** [PublishTo](#API_PublishVersion_RequestSyntax) **   <a name="lambda-PublishVersion-request-PublishTo"></a>
Specifies where to publish the function version or configuration.  
Type: String  
Valid Values: `LATEST_PUBLISHED`   
Required: No

 ** [RevisionId](#API_PublishVersion_RequestSyntax) **   <a name="lambda-PublishVersion-request-RevisionId"></a>
Only update the function if the revision ID matches the ID that's specified. Use this option to avoid publishing a version if the function configuration has changed since you last updated it.  
Type: String  
Required: No

## Response Syntax
<a name="API_PublishVersion_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "Architectures": [ "string" ],
   "CapacityProviderConfig": { 
      "LambdaManagedInstancesCapacityProviderConfig": { 
         "CapacityProviderArn": "string",
         "ExecutionEnvironmentMemoryGiBPerVCpu": number,
         "PerExecutionEnvironmentMaxConcurrency": number
      }
   },
   "CodeSha256": "string",
   "CodeSize": number,
   "ConfigSha256": "string",
   "DeadLetterConfig": { 
      "TargetArn": "string"
   },
   "Description": "string",
   "DurableConfig": { 
      "ExecutionTimeout": number,
      "RetentionPeriodInDays": number
   },
   "Environment": { 
      "Error": { 
         "ErrorCode": "string",
         "Message": "string"
      },
      "Variables": { 
         "string" : "string" 
      }
   },
   "EphemeralStorage": { 
      "Size": number
   },
   "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"
      }
   ],
   "LoggingConfig": { 
      "ApplicationLogLevel": "string",
      "LogFormat": "string",
      "LogGroup": "string",
      "SystemLogLevel": "string"
   },
   "MasterArn": "string",
   "MemorySize": number,
   "PackageType": "string",
   "RevisionId": "string",
   "Role": "string",
   "Runtime": "string",
   "RuntimeVersionConfig": { 
      "Error": { 
         "ErrorCode": "string",
         "Message": "string"
      },
      "RuntimeVersionArn": "string"
   },
   "SigningJobArn": "string",
   "SigningProfileVersionArn": "string",
   "SnapStart": { 
      "ApplyOn": "string",
      "OptimizationStatus": "string"
   },
   "State": "string",
   "StateReason": "string",
   "StateReasonCode": "string",
   "TenancyConfig": { 
      "TenantIsolationMode": "string"
   },
   "Timeout": number,
   "TracingConfig": { 
      "Mode": "string"
   },
   "Version": "string",
   "VpcConfig": { 
      "Ipv6AllowedForDualStack": boolean,
      "SecurityGroupIds": [ "string" ],
      "SubnetIds": [ "string" ],
      "VpcId": "string"
   }
}
```

## Response Elements
<a name="API_PublishVersion_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 201 response.

The following data is returned in JSON format by the service.

 ** [Architectures](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-Architectures"></a>
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`.  
Type: Array of strings  
Array Members: Fixed number of 1 item.  
Valid Values: `x86_64 | arm64` 

 ** [CapacityProviderConfig](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-CapacityProviderConfig"></a>
Configuration for the capacity provider that manages compute resources for Lambda functions.  
Type: [CapacityProviderConfig](API_CapacityProviderConfig.md) object

 ** [CodeSha256](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-CodeSha256"></a>
The SHA256 hash of the function's deployment package.  
Type: String

 ** [CodeSize](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-CodeSize"></a>
The size of the function's deployment package, in bytes.  
Type: Long

 ** [ConfigSha256](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-ConfigSha256"></a>
The SHA256 hash of the function configuration.  
Type: String

 ** [DeadLetterConfig](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-DeadLetterConfig"></a>
The function's dead letter queue.  
Type: [DeadLetterConfig](API_DeadLetterConfig.md) object

 ** [Description](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-Description"></a>
The function's description.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 256.

 ** [DurableConfig](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-DurableConfig"></a>
The function's durable execution configuration settings, if the function is configured for durability.  
Type: [DurableConfig](API_DurableConfig.md) object

 ** [Environment](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-Environment"></a>
The function's [environment variables](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html). Omitted from AWS CloudTrail logs.  
Type: [EnvironmentResponse](API_EnvironmentResponse.md) object

 ** [EphemeralStorage](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-EphemeralStorage"></a>
The size of the function's `/tmp` directory in MB. The default value is 512, but can be any whole number between 512 and 10,240 MB. For more information, see [Configuring ephemeral storage (console)](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-ephemeral-storage).  
Type: [EphemeralStorage](API_EphemeralStorage.md) object

 ** [FileSystemConfigs](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-FileSystemConfigs"></a>
Connection settings for an [Amazon EFS file system](https://docs.aws.amazon.com/lambda/latest/dg/configuration-filesystem.html) or an [Amazon S3 Files file system](https://docs.aws.amazon.com/lambda/latest/dg/configuration-filesystem.html).  
Type: Array of [FileSystemConfig](API_FileSystemConfig.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 1 item.

 ** [FunctionArn](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-FunctionArn"></a>
The function's Amazon Resource Name (ARN).  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 10000.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_\.]+(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?` 

 ** [FunctionName](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-FunctionName"></a>
The name of the function.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?` 

 ** [Handler](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-Handler"></a>
The function that Lambda calls to begin running your function.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 128.  
Pattern: `[^\s]+` 

 ** [ImageConfigResponse](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-ImageConfigResponse"></a>
The function's image configuration values.  
Type: [ImageConfigResponse](API_ImageConfigResponse.md) object

 ** [KMSKeyArn](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-KMSKeyArn"></a>
The ARN of the AWS Key Management Service (AWS KMS) customer managed key that's used to encrypt the following resources:  
+ The function's [environment variables](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html#configuration-envvars-encryption).
+ The function's [Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart-security.html) snapshots.
+ When used with `SourceKMSKeyArn`, the unzipped version of the .zip deployment package that's used for function invocations. For more information, see [ Specifying a customer managed key for Lambda](https://docs.aws.amazon.com/lambda/latest/dg/encrypt-zip-package.html#enable-zip-custom-encryption).
+ The optimized version of the container image that's used for function invocations. Note that this is not the same key that's used to protect your container image in the Amazon Elastic Container Registry (Amazon ECR). For more information, see [Function lifecycle](https://docs.aws.amazon.com/lambda/latest/dg/images-create.html#images-lifecycle).
If you don't provide a customer managed key, Lambda uses an [AWS owned key](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-owned-cmk) or an [AWS managed key](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk).  
Type: String  
Pattern: `(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()` 

 ** [LastModified](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-LastModified"></a>
The date and time that the function was last updated, in [ISO-8601 format](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD).  
Type: String

 ** [LastUpdateStatus](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-LastUpdateStatus"></a>
The status of the last update that was performed on the function. This is first set to `Successful` after function creation completes.  
Type: String  
Valid Values: `Successful | Failed | InProgress` 

 ** [LastUpdateStatusReason](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-LastUpdateStatusReason"></a>
The reason for the last update that was performed on the function.  
Type: String

 ** [LastUpdateStatusReasonCode](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-LastUpdateStatusReasonCode"></a>
The reason code for the last update that was performed on the function.  
Type: String  
Valid Values: `EniLimitExceeded | InsufficientRolePermissions | InvalidConfiguration | InternalError | SubnetOutOfIPAddresses | InvalidSubnet | InvalidSecurityGroup | ImageDeleted | ImageAccessDenied | InvalidImage | KMSKeyAccessDenied | KMSKeyNotFound | InvalidStateKMSKey | DisabledKMSKey | EFSIOError | EFSMountConnectivityError | EFSMountFailure | EFSMountTimeout | InvalidRuntime | InvalidZipFileException | FunctionError | VcpuLimitExceeded | CapacityProviderScalingLimitExceeded | InsufficientCapacity | EC2RequestLimitExceeded | FunctionError.InitTimeout | FunctionError.RuntimeInitError | FunctionError.ExtensionInitError | FunctionError.InvalidEntryPoint | FunctionError.InvalidWorkingDirectory | FunctionError.PermissionDenied | FunctionError.TooManyExtensions | FunctionError.InitResourceExhausted | DisallowedByVpcEncryptionControl` 

 ** [Layers](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-Layers"></a>
The function's [layers](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html).  
Type: Array of [Layer](API_Layer.md) objects

 ** [LoggingConfig](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-LoggingConfig"></a>
The function's Amazon CloudWatch Logs configuration settings.  
Type: [LoggingConfig](API_LoggingConfig.md) object

 ** [MasterArn](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-MasterArn"></a>
For Lambda@Edge functions, the ARN of the main function.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 10000.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?` 

 ** [MemorySize](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-MemorySize"></a>
The amount of memory available to the function at runtime.  
Type: Integer  
Valid Range: Minimum value of 128. Maximum value of 32768.

 ** [PackageType](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-PackageType"></a>
The type of deployment package. Set to `Image` for container image and set `Zip` for .zip file archive.  
Type: String  
Valid Values: `Zip | Image` 

 ** [RevisionId](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-RevisionId"></a>
The latest updated revision of the function or alias.  
Type: String

 ** [Role](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-Role"></a>
The function's execution role.  
Type: String  
Pattern: `arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 

 ** [Runtime](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-Runtime"></a>
The identifier of the function's [ runtime](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html). Runtime is required if the deployment package is a .zip file archive. Specifying a runtime results in an error if you're deploying a function using a container image.  
The following list includes deprecated runtimes. Lambda blocks creating new functions and updating existing functions shortly after each runtime is deprecated. For more information, see [Runtime use after deprecation](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-deprecation-levels).  
For a list of all currently supported runtimes, see [Supported runtimes](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtimes-supported).  
Type: String  
Valid Values: `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 | nodejs24.x | python3.14 | java25 | dotnet10` 

 ** [RuntimeVersionConfig](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-RuntimeVersionConfig"></a>
The ARN of the runtime and any errors that occured.  
Type: [RuntimeVersionConfig](API_RuntimeVersionConfig.md) object

 ** [SigningJobArn](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-SigningJobArn"></a>
The ARN of the signing job.  
Type: String  
Pattern: `arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` 

 ** [SigningProfileVersionArn](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-SigningProfileVersionArn"></a>
The ARN of the signing profile version.  
Type: String  
Pattern: `arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` 

 ** [SnapStart](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-SnapStart"></a>
Set `ApplyOn` to `PublishedVersions` to create a snapshot of the initialized execution environment when you publish a function version. For more information, see [Improving startup performance with Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html).  
Type: [SnapStartResponse](API_SnapStartResponse.md) object

 ** [State](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-State"></a>
The current state of the function. When the state is `Inactive`, you can reactivate the function by invoking it.  
Type: String  
Valid Values: `Pending | Active | Inactive | Failed | Deactivating | Deactivated | ActiveNonInvocable | Deleting` 

 ** [StateReason](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-StateReason"></a>
The reason for the function's current state.  
Type: String

 ** [StateReasonCode](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-StateReasonCode"></a>
The reason code for the function's current state. When the code is `Creating`, you can't invoke or modify the function.  
Type: String  
Valid Values: `Idle | Creating | Restoring | EniLimitExceeded | InsufficientRolePermissions | InvalidConfiguration | InternalError | SubnetOutOfIPAddresses | InvalidSubnet | InvalidSecurityGroup | ImageDeleted | ImageAccessDenied | InvalidImage | KMSKeyAccessDenied | KMSKeyNotFound | InvalidStateKMSKey | DisabledKMSKey | EFSIOError | EFSMountConnectivityError | EFSMountFailure | EFSMountTimeout | InvalidRuntime | InvalidZipFileException | FunctionError | DrainingDurableExecutions | VcpuLimitExceeded | CapacityProviderScalingLimitExceeded | InsufficientCapacity | EC2RequestLimitExceeded | FunctionError.InitTimeout | FunctionError.RuntimeInitError | FunctionError.ExtensionInitError | FunctionError.InvalidEntryPoint | FunctionError.InvalidWorkingDirectory | FunctionError.PermissionDenied | FunctionError.TooManyExtensions | FunctionError.InitResourceExhausted | DisallowedByVpcEncryptionControl` 

 ** [TenancyConfig](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-TenancyConfig"></a>
The function's tenant isolation configuration settings. Determines whether the Lambda function runs on a shared or dedicated infrastructure per unique tenant.  
Type: [TenancyConfig](API_TenancyConfig.md) object

 ** [Timeout](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-Timeout"></a>
The amount of time in seconds that Lambda allows a function to run before stopping it.  
Type: Integer  
Valid Range: Minimum value of 1.

 ** [TracingConfig](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-TracingConfig"></a>
The function's AWS X-Ray tracing configuration.  
Type: [TracingConfigResponse](API_TracingConfigResponse.md) object

 ** [Version](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-Version"></a>
The version of the Lambda function.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Pattern: `(\$LATEST|[0-9]+)` 

 ** [VpcConfig](#API_PublishVersion_ResponseSyntax) **   <a name="lambda-PublishVersion-response-VpcConfig"></a>
The function's networking configuration.  
Type: [VpcConfigResponse](API_VpcConfigResponse.md) object

## Errors
<a name="API_PublishVersion_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** CodeStorageExceededException **   
Your AWS account has exceeded its maximum total code size. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html).    
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** FunctionVersionsPerCapacityProviderLimitExceededException **   
The maximum number of function versions that can be associated with a single capacity provider has been exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html).    
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** PreconditionFailedException **   
The RevisionId provided does not match the latest RevisionId for the Lambda function or alias.  
+  **For AddPermission and RemovePermission API operations:** Call `GetPolicy` to retrieve the latest RevisionId for your resource.
+  **For all other API operations:** Call `GetFunction` or `GetAlias` to retrieve the latest RevisionId for your resource.  
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 412

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_PublishVersion_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/PublishVersion) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/PublishVersion) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/PublishVersion) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/PublishVersion) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/PublishVersion) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/PublishVersion) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/PublishVersion) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/PublishVersion) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/PublishVersion) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/PublishVersion) 

# PutFunctionCodeSigningConfig
<a name="API_PutFunctionCodeSigningConfig"></a>

Update the code signing configuration for the function. Changes to the code signing configuration take effect the next time a user tries to deploy a code package to the function. 

## Request Syntax
<a name="API_PutFunctionCodeSigningConfig_RequestSyntax"></a>

```
PUT /2020-06-30/functions/FunctionName/code-signing-config HTTP/1.1
Content-type: application/json

{
   "CodeSigningConfigArn": "string"
}
```

## URI Request Parameters
<a name="API_PutFunctionCodeSigningConfig_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_PutFunctionCodeSigningConfig_RequestSyntax) **   <a name="lambda-PutFunctionCodeSigningConfig-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?`   
Required: Yes

## Request Body
<a name="API_PutFunctionCodeSigningConfig_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [CodeSigningConfigArn](#API_PutFunctionCodeSigningConfig_RequestSyntax) **   <a name="lambda-PutFunctionCodeSigningConfig-request-CodeSigningConfigArn"></a>
The The Amazon Resource Name (ARN) of the code signing configuration.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 200.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}:\d{12}:code-signing-config:csc-[a-z0-9]{17}`   
Required: Yes

## Response Syntax
<a name="API_PutFunctionCodeSigningConfig_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CodeSigningConfigArn": "string",
   "FunctionName": "string"
}
```

## Response Elements
<a name="API_PutFunctionCodeSigningConfig_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [CodeSigningConfigArn](#API_PutFunctionCodeSigningConfig_ResponseSyntax) **   <a name="lambda-PutFunctionCodeSigningConfig-response-CodeSigningConfigArn"></a>
The The Amazon Resource Name (ARN) of the code signing configuration.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 200.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}:\d{12}:code-signing-config:csc-[a-z0-9]{17}` 

 ** [FunctionName](#API_PutFunctionCodeSigningConfig_ResponseSyntax) **   <a name="lambda-PutFunctionCodeSigningConfig-response-FunctionName"></a>
The name or ARN 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.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?` 

## Errors
<a name="API_PutFunctionCodeSigningConfig_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** CodeSigningConfigNotFoundException **   
The specified code signing configuration does not exist.  
HTTP Status Code: 404

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_PutFunctionCodeSigningConfig_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/PutFunctionCodeSigningConfig) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/PutFunctionCodeSigningConfig) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/PutFunctionCodeSigningConfig) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/PutFunctionCodeSigningConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/PutFunctionCodeSigningConfig) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/PutFunctionCodeSigningConfig) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/PutFunctionCodeSigningConfig) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/PutFunctionCodeSigningConfig) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/PutFunctionCodeSigningConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/PutFunctionCodeSigningConfig) 

# PutFunctionConcurrency
<a name="API_PutFunctionConcurrency"></a>

Sets the maximum number of simultaneous executions for a function, and reserves capacity for that concurrency level.

Concurrency settings apply to the function as a whole, including all published versions and the unpublished version. Reserving concurrency both ensures that your function has capacity to process the specified number of events simultaneously, and prevents it from scaling beyond that level. Use [GetFunction](API_GetFunction.md) to see the current setting for a function.

Use [GetAccountSettings](API_GetAccountSettings.md) to see your Regional concurrency limit. You can reserve concurrency for as many functions as you like, as long as you leave at least 100 simultaneous executions unreserved for functions that aren't configured with a per-function limit. For more information, see [Lambda function scaling](https://docs.aws.amazon.com/lambda/latest/dg/invocation-scaling.html).

## Request Syntax
<a name="API_PutFunctionConcurrency_RequestSyntax"></a>

```
PUT /2017-10-31/functions/FunctionName/concurrency HTTP/1.1
Content-type: application/json

{
   "ReservedConcurrentExecutions": number
}
```

## URI Request Parameters
<a name="API_PutFunctionConcurrency_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_PutFunctionConcurrency_RequestSyntax) **   <a name="lambda-PutFunctionConcurrency-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?`   
Required: Yes

## Request Body
<a name="API_PutFunctionConcurrency_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ReservedConcurrentExecutions](#API_PutFunctionConcurrency_RequestSyntax) **   <a name="lambda-PutFunctionConcurrency-request-ReservedConcurrentExecutions"></a>
The number of simultaneous executions to reserve for the function.  
Type: Integer  
Valid Range: Minimum value of 0.  
Required: Yes

## Response Syntax
<a name="API_PutFunctionConcurrency_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ReservedConcurrentExecutions": number
}
```

## Response Elements
<a name="API_PutFunctionConcurrency_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [ReservedConcurrentExecutions](#API_PutFunctionConcurrency_ResponseSyntax) **   <a name="lambda-PutFunctionConcurrency-response-ReservedConcurrentExecutions"></a>
The number of concurrent executions that are reserved for this function. For more information, see [Managing Lambda reserved concurrency](https://docs.aws.amazon.com/lambda/latest/dg/configuration-concurrency.html).  
Type: Integer  
Valid Range: Minimum value of 0.

## Errors
<a name="API_PutFunctionConcurrency_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_PutFunctionConcurrency_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/PutFunctionConcurrency) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/PutFunctionConcurrency) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/PutFunctionConcurrency) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/PutFunctionConcurrency) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/PutFunctionConcurrency) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/PutFunctionConcurrency) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/PutFunctionConcurrency) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/PutFunctionConcurrency) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/PutFunctionConcurrency) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/PutFunctionConcurrency) 

# PutFunctionEventInvokeConfig
<a name="API_PutFunctionEventInvokeConfig"></a>

Configures options for [asynchronous invocation](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html) on a function, version, or alias. If a configuration already exists for a function, version, or alias, this operation overwrites it. If you exclude any settings, they are removed. To set one option without affecting existing settings for other options, use [UpdateFunctionEventInvokeConfig](API_UpdateFunctionEventInvokeConfig.md).

By default, Lambda retries an asynchronous invocation twice if the function returns an error. It retains events in a queue for up to six hours. When an event fails all processing attempts or stays in the asynchronous invocation queue for too long, Lambda discards it. To retain discarded events, configure a dead-letter queue with [UpdateFunctionConfiguration](API_UpdateFunctionConfiguration.md).

To send an invocation record to a queue, topic, S3 bucket, function, or event bus, specify a [destination](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-async-destinations). You can configure separate destinations for successful invocations (on-success) and events that fail all processing attempts (on-failure). You can configure destinations in addition to or instead of a dead-letter queue.

**Note**  
S3 buckets are supported only for on-failure destinations. To retain records of successful invocations, use another destination type.

## Request Syntax
<a name="API_PutFunctionEventInvokeConfig_RequestSyntax"></a>

```
PUT /2019-09-25/functions/FunctionName/event-invoke-config?Qualifier=Qualifier HTTP/1.1
Content-type: application/json

{
   "DestinationConfig": { 
      "OnFailure": { 
         "Destination": "string"
      },
      "OnSuccess": { 
         "Destination": "string"
      }
   },
   "MaximumEventAgeInSeconds": number,
   "MaximumRetryAttempts": number
}
```

## URI Request Parameters
<a name="API_PutFunctionEventInvokeConfig_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_PutFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?`   
Required: Yes

 ** [Qualifier](#API_PutFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-request-uri-Qualifier"></a>
A version number or alias name.  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `\$(LATEST(\.PUBLISHED)?)|[a-zA-Z0-9-_$]+` 

## Request Body
<a name="API_PutFunctionEventInvokeConfig_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [DestinationConfig](#API_PutFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-request-DestinationConfig"></a>
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 a standard SQS queue.
+  **Bucket** - The ARN of an Amazon S3 bucket.
+  **Topic** - The ARN of a standard SNS topic.
+  **Event Bus** - The ARN of an Amazon EventBridge event bus.
S3 buckets are supported only for on-failure destinations. To retain records of successful invocations, use another destination type.
Type: [DestinationConfig](API_DestinationConfig.md) object  
Required: No

 ** [MaximumEventAgeInSeconds](#API_PutFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-request-MaximumEventAgeInSeconds"></a>
The maximum age of a request that Lambda sends to a function for processing.  
Type: Integer  
Valid Range: Minimum value of 60. Maximum value of 21600.  
Required: No

 ** [MaximumRetryAttempts](#API_PutFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-request-MaximumRetryAttempts"></a>
The maximum number of times to retry when the function returns an error.  
Type: Integer  
Valid Range: Minimum value of 0. Maximum value of 2.  
Required: No

## Response Syntax
<a name="API_PutFunctionEventInvokeConfig_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "DestinationConfig": { 
      "OnFailure": { 
         "Destination": "string"
      },
      "OnSuccess": { 
         "Destination": "string"
      }
   },
   "FunctionArn": "string",
   "LastModified": number,
   "MaximumEventAgeInSeconds": number,
   "MaximumRetryAttempts": number
}
```

## Response Elements
<a name="API_PutFunctionEventInvokeConfig_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [DestinationConfig](#API_PutFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-response-DestinationConfig"></a>
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 a standard SQS queue.
+  **Bucket** - The ARN of an Amazon S3 bucket.
+  **Topic** - The ARN of a standard SNS topic.
+  **Event Bus** - The ARN of an Amazon EventBridge event bus.
S3 buckets are supported only for on-failure destinations. To retain records of successful invocations, use another destination type.
Type: [DestinationConfig](API_DestinationConfig.md) object

 ** [FunctionArn](#API_PutFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-response-FunctionArn"></a>
The Amazon Resource Name (ARN) of the function.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 10000.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?` 

 ** [LastModified](#API_PutFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-response-LastModified"></a>
The date and time that the configuration was last updated, in Unix time seconds.  
Type: Timestamp

 ** [MaximumEventAgeInSeconds](#API_PutFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-response-MaximumEventAgeInSeconds"></a>
The maximum age of a request that Lambda sends to a function for processing.  
Type: Integer  
Valid Range: Minimum value of 60. Maximum value of 21600.

 ** [MaximumRetryAttempts](#API_PutFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-response-MaximumRetryAttempts"></a>
The maximum number of times to retry when the function returns an error.  
Type: Integer  
Valid Range: Minimum value of 0. Maximum value of 2.

## Errors
<a name="API_PutFunctionEventInvokeConfig_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_PutFunctionEventInvokeConfig_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/PutFunctionEventInvokeConfig) 

# PutFunctionRecursionConfig
<a name="API_PutFunctionRecursionConfig"></a>

Sets your function's [recursive loop detection](https://docs.aws.amazon.com/lambda/latest/dg/invocation-recursion.html) configuration.

When you configure a Lambda function to output to the same service or resource that invokes the function, it's possible to create an infinite recursive loop. For example, a Lambda function might write a message to an Amazon Simple Queue Service (Amazon SQS) queue, which then invokes the same function. This invocation causes the function to write another message to the queue, which in turn invokes the function again.

Lambda can detect certain types of recursive loops shortly after they occur. When Lambda detects a recursive loop and your function's recursive loop detection configuration is set to `Terminate`, it stops your function being invoked and notifies you.

## Request Syntax
<a name="API_PutFunctionRecursionConfig_RequestSyntax"></a>

```
PUT /2024-08-31/functions/FunctionName/recursion-config HTTP/1.1
Content-type: application/json

{
   "RecursiveLoop": "string"
}
```

## URI Request Parameters
<a name="API_PutFunctionRecursionConfig_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_PutFunctionRecursionConfig_RequestSyntax) **   <a name="lambda-PutFunctionRecursionConfig-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)`   
Required: Yes

## Request Body
<a name="API_PutFunctionRecursionConfig_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [RecursiveLoop](#API_PutFunctionRecursionConfig_RequestSyntax) **   <a name="lambda-PutFunctionRecursionConfig-request-RecursiveLoop"></a>
If you set your function's recursive loop detection configuration to `Allow`, Lambda doesn't take any action when it detects your function being invoked as part of a recursive loop. We recommend that you only use this setting if your design intentionally uses a Lambda function to write data back to the same AWS resource that invokes it.  
If you set your function's recursive loop detection configuration to `Terminate`, Lambda stops your function being invoked and notifies you when it detects your function being invoked as part of a recursive loop.  
By default, Lambda sets your function's configuration to `Terminate`.  
If your design intentionally uses a Lambda function to write data back to the same AWS resource that invokes the function, then use caution and implement suitable guard rails to prevent unexpected charges being billed to your AWS account. To learn more about best practices for using recursive invocation patterns, see [Recursive patterns that cause run-away Lambda functions](https://serverlessland.com/content/service/lambda/guides/aws-lambda-operator-guide/recursive-runaway) in Serverless Land.
Type: String  
Valid Values: `Allow | Terminate`   
Required: Yes

## Response Syntax
<a name="API_PutFunctionRecursionConfig_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "RecursiveLoop": "string"
}
```

## Response Elements
<a name="API_PutFunctionRecursionConfig_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [RecursiveLoop](#API_PutFunctionRecursionConfig_ResponseSyntax) **   <a name="lambda-PutFunctionRecursionConfig-response-RecursiveLoop"></a>
The status of your function's recursive loop detection configuration.  
When this value is set to `Allow`and Lambda detects your function being invoked as part of a recursive loop, it doesn't take any action.  
When this value is set to `Terminate` and Lambda detects your function being invoked as part of a recursive loop, it stops your function being invoked and notifies you.   
Type: String  
Valid Values: `Allow | Terminate` 

## Errors
<a name="API_PutFunctionRecursionConfig_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_PutFunctionRecursionConfig_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/PutFunctionRecursionConfig) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/PutFunctionRecursionConfig) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/PutFunctionRecursionConfig) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/PutFunctionRecursionConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/PutFunctionRecursionConfig) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/PutFunctionRecursionConfig) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/PutFunctionRecursionConfig) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/PutFunctionRecursionConfig) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/PutFunctionRecursionConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/PutFunctionRecursionConfig) 

# PutFunctionScalingConfig
<a name="API_PutFunctionScalingConfig"></a>

Sets the scaling configuration for a Lambda Managed Instances function. The scaling configuration defines the minimum and maximum number of execution environments that can be provisioned for the function, allowing you to control scaling behavior and resource allocation.

## Request Syntax
<a name="API_PutFunctionScalingConfig_RequestSyntax"></a>

```
PUT /2025-11-30/functions/FunctionName/function-scaling-config?Qualifier=Qualifier HTTP/1.1
Content-type: application/json

{
   "FunctionScalingConfig": { 
      "MaxExecutionEnvironments": number,
      "MinExecutionEnvironments": number
   }
}
```

## URI Request Parameters
<a name="API_PutFunctionScalingConfig_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_PutFunctionScalingConfig_RequestSyntax) **   <a name="lambda-PutFunctionScalingConfig-request-uri-FunctionName"></a>
The name or ARN of the Lambda function.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)`   
Required: Yes

 ** [Qualifier](#API_PutFunctionScalingConfig_RequestSyntax) **   <a name="lambda-PutFunctionScalingConfig-request-uri-Qualifier"></a>
Specify a version or alias to set the scaling configuration for a published version of the function.  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `(\$LATEST\.PUBLISHED|[0-9]+)`   
Required: Yes

## Request Body
<a name="API_PutFunctionScalingConfig_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [FunctionScalingConfig](#API_PutFunctionScalingConfig_RequestSyntax) **   <a name="lambda-PutFunctionScalingConfig-request-FunctionScalingConfig"></a>
The scaling configuration to apply to the function, including minimum and maximum execution environment limits.  
Type: [FunctionScalingConfig](API_FunctionScalingConfig.md) object  
Required: No

## Response Syntax
<a name="API_PutFunctionScalingConfig_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "FunctionState": "string"
}
```

## Response Elements
<a name="API_PutFunctionScalingConfig_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [FunctionState](#API_PutFunctionScalingConfig_ResponseSyntax) **   <a name="lambda-PutFunctionScalingConfig-response-FunctionState"></a>
The current state of the function after applying the scaling configuration.  
Type: String  
Valid Values: `Pending | Active | Inactive | Failed | Deactivating | Deactivated | ActiveNonInvocable | Deleting` 

## Errors
<a name="API_PutFunctionScalingConfig_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_PutFunctionScalingConfig_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/PutFunctionScalingConfig) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/PutFunctionScalingConfig) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/PutFunctionScalingConfig) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/PutFunctionScalingConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/PutFunctionScalingConfig) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/PutFunctionScalingConfig) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/PutFunctionScalingConfig) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/PutFunctionScalingConfig) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/PutFunctionScalingConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/PutFunctionScalingConfig) 

# PutProvisionedConcurrencyConfig
<a name="API_PutProvisionedConcurrencyConfig"></a>

Adds a provisioned concurrency configuration to a function's alias or version.

## Request Syntax
<a name="API_PutProvisionedConcurrencyConfig_RequestSyntax"></a>

```
PUT /2019-09-30/functions/FunctionName/provisioned-concurrency?Qualifier=Qualifier HTTP/1.1
Content-type: application/json

{
   "ProvisionedConcurrentExecutions": number
}
```

## URI Request Parameters
<a name="API_PutProvisionedConcurrencyConfig_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_PutProvisionedConcurrencyConfig_RequestSyntax) **   <a name="lambda-PutProvisionedConcurrencyConfig-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?`   
Required: Yes

 ** [Qualifier](#API_PutProvisionedConcurrencyConfig_RequestSyntax) **   <a name="lambda-PutProvisionedConcurrencyConfig-request-uri-Qualifier"></a>
The version number or alias name.  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `(|[a-zA-Z0-9$_-]+)`   
Required: Yes

## Request Body
<a name="API_PutProvisionedConcurrencyConfig_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ProvisionedConcurrentExecutions](#API_PutProvisionedConcurrencyConfig_RequestSyntax) **   <a name="lambda-PutProvisionedConcurrencyConfig-request-ProvisionedConcurrentExecutions"></a>
The amount of provisioned concurrency to allocate for the version or alias.  
Type: Integer  
Valid Range: Minimum value of 1.  
Required: Yes

## Response Syntax
<a name="API_PutProvisionedConcurrencyConfig_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "AllocatedProvisionedConcurrentExecutions": number,
   "AvailableProvisionedConcurrentExecutions": number,
   "LastModified": "string",
   "RequestedProvisionedConcurrentExecutions": number,
   "Status": "string",
   "StatusReason": "string"
}
```

## Response Elements
<a name="API_PutProvisionedConcurrencyConfig_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [AllocatedProvisionedConcurrentExecutions](#API_PutProvisionedConcurrencyConfig_ResponseSyntax) **   <a name="lambda-PutProvisionedConcurrencyConfig-response-AllocatedProvisionedConcurrentExecutions"></a>
The amount of provisioned concurrency allocated. When a weighted alias is used during linear and canary deployments, this value fluctuates depending on the amount of concurrency that is provisioned for the function versions.  
Type: Integer  
Valid Range: Minimum value of 0.

 ** [AvailableProvisionedConcurrentExecutions](#API_PutProvisionedConcurrencyConfig_ResponseSyntax) **   <a name="lambda-PutProvisionedConcurrencyConfig-response-AvailableProvisionedConcurrentExecutions"></a>
The amount of provisioned concurrency available.  
Type: Integer  
Valid Range: Minimum value of 0.

 ** [LastModified](#API_PutProvisionedConcurrencyConfig_ResponseSyntax) **   <a name="lambda-PutProvisionedConcurrencyConfig-response-LastModified"></a>
The date and time that a user last updated the configuration, in [ISO 8601 format](https://www.iso.org/iso-8601-date-and-time-format.html).  
Type: String

 ** [RequestedProvisionedConcurrentExecutions](#API_PutProvisionedConcurrencyConfig_ResponseSyntax) **   <a name="lambda-PutProvisionedConcurrencyConfig-response-RequestedProvisionedConcurrentExecutions"></a>
The amount of provisioned concurrency requested.  
Type: Integer  
Valid Range: Minimum value of 1.

 ** [Status](#API_PutProvisionedConcurrencyConfig_ResponseSyntax) **   <a name="lambda-PutProvisionedConcurrencyConfig-response-Status"></a>
The status of the allocation process.  
Type: String  
Valid Values: `IN_PROGRESS | READY | FAILED` 

 ** [StatusReason](#API_PutProvisionedConcurrencyConfig_ResponseSyntax) **   <a name="lambda-PutProvisionedConcurrencyConfig-response-StatusReason"></a>
For failed allocations, the reason that provisioned concurrency could not be allocated.  
Type: String

## Errors
<a name="API_PutProvisionedConcurrencyConfig_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_PutProvisionedConcurrencyConfig_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/PutProvisionedConcurrencyConfig) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/PutProvisionedConcurrencyConfig) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/PutProvisionedConcurrencyConfig) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/PutProvisionedConcurrencyConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/PutProvisionedConcurrencyConfig) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/PutProvisionedConcurrencyConfig) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/PutProvisionedConcurrencyConfig) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/PutProvisionedConcurrencyConfig) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/PutProvisionedConcurrencyConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/PutProvisionedConcurrencyConfig) 

# PutRuntimeManagementConfig
<a name="API_PutRuntimeManagementConfig"></a>

Sets the runtime management configuration for a function's version. For more information, see [Runtime updates](https://docs.aws.amazon.com/lambda/latest/dg/runtimes-update.html).

## Request Syntax
<a name="API_PutRuntimeManagementConfig_RequestSyntax"></a>

```
PUT /2021-07-20/functions/FunctionName/runtime-management-config?Qualifier=Qualifier HTTP/1.1
Content-type: application/json

{
   "RuntimeVersionArn": "string",
   "UpdateRuntimeOn": "string"
}
```

## URI Request Parameters
<a name="API_PutRuntimeManagementConfig_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_PutRuntimeManagementConfig_RequestSyntax) **   <a name="lambda-PutRuntimeManagementConfig-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?`   
Required: Yes

 ** [Qualifier](#API_PutRuntimeManagementConfig_RequestSyntax) **   <a name="lambda-PutRuntimeManagementConfig-request-uri-Qualifier"></a>
Specify a version of the function. This can be `$LATEST` or a published version number. If no value is specified, the configuration for the `$LATEST` version is returned.  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `\$(LATEST(\.PUBLISHED)?)|[a-zA-Z0-9-_$]+` 

## Request Body
<a name="API_PutRuntimeManagementConfig_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [RuntimeVersionArn](#API_PutRuntimeManagementConfig_RequestSyntax) **   <a name="lambda-PutRuntimeManagementConfig-request-RuntimeVersionArn"></a>
The ARN of the runtime version you want the function to use.  
This is only required if you're using the **Manual** runtime update mode.
Type: String  
Length Constraints: Minimum length of 26. Maximum length of 2048.  
Pattern: `arn:(aws[a-zA-Z-]*):lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}::runtime:.+`   
Required: No

 ** [UpdateRuntimeOn](#API_PutRuntimeManagementConfig_RequestSyntax) **   <a name="lambda-PutRuntimeManagementConfig-request-UpdateRuntimeOn"></a>
Specify the runtime update mode.  
+  **Auto (default)** - Automatically update to the most recent and secure runtime version using a [Two-phase runtime version rollout](https://docs.aws.amazon.com/lambda/latest/dg/runtimes-update.html#runtime-management-two-phase). This is the best choice for most customers to ensure they always benefit from runtime updates.
+  **Function update** - Lambda updates the runtime of your function to the most recent and secure runtime version when you update your function. This approach synchronizes runtime updates with function deployments, giving you control over when runtime updates are applied and allowing you to detect and mitigate rare runtime update incompatibilities early. When using this setting, you need to regularly update your functions to keep their runtime up-to-date.
+  **Manual** - You specify a runtime version in your function configuration. The function will use this runtime version indefinitely. In the rare case where a new runtime version is incompatible with an existing function, this allows you to roll back your function to an earlier runtime version. For more information, see [Roll back a runtime version](https://docs.aws.amazon.com/lambda/latest/dg/runtimes-update.html#runtime-management-rollback).
Type: String  
Valid Values: `Auto | Manual | FunctionUpdate`   
Required: Yes

## Response Syntax
<a name="API_PutRuntimeManagementConfig_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "FunctionArn": "string",
   "RuntimeVersionArn": "string",
   "UpdateRuntimeOn": "string"
}
```

## Response Elements
<a name="API_PutRuntimeManagementConfig_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [FunctionArn](#API_PutRuntimeManagementConfig_ResponseSyntax) **   <a name="lambda-PutRuntimeManagementConfig-response-FunctionArn"></a>
The ARN of the function  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 10000.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?` 

 ** [RuntimeVersionArn](#API_PutRuntimeManagementConfig_ResponseSyntax) **   <a name="lambda-PutRuntimeManagementConfig-response-RuntimeVersionArn"></a>
The ARN of the runtime the function is configured to use. If the runtime update mode is **manual**, the ARN is returned, otherwise `null` is returned.  
Type: String  
Length Constraints: Minimum length of 26. Maximum length of 2048.  
Pattern: `arn:(aws[a-zA-Z-]*):lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}::runtime:.+` 

 ** [UpdateRuntimeOn](#API_PutRuntimeManagementConfig_ResponseSyntax) **   <a name="lambda-PutRuntimeManagementConfig-response-UpdateRuntimeOn"></a>
The runtime update mode.  
Type: String  
Valid Values: `Auto | Manual | FunctionUpdate` 

## Errors
<a name="API_PutRuntimeManagementConfig_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_PutRuntimeManagementConfig_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/PutRuntimeManagementConfig) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/PutRuntimeManagementConfig) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/PutRuntimeManagementConfig) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/PutRuntimeManagementConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/PutRuntimeManagementConfig) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/PutRuntimeManagementConfig) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/PutRuntimeManagementConfig) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/PutRuntimeManagementConfig) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/PutRuntimeManagementConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/PutRuntimeManagementConfig) 

# RemoveLayerVersionPermission
<a name="API_RemoveLayerVersionPermission"></a>

Removes a statement from the permissions policy for a version of an [AWS Lambda layer](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html). For more information, see [AddLayerVersionPermission](API_AddLayerVersionPermission.md).

## Request Syntax
<a name="API_RemoveLayerVersionPermission_RequestSyntax"></a>

```
DELETE /2018-10-31/layers/LayerName/versions/VersionNumber/policy/StatementId?RevisionId=RevisionId HTTP/1.1
```

## URI Request Parameters
<a name="API_RemoveLayerVersionPermission_RequestParameters"></a>

The request uses the following URI parameters.

 ** [LayerName](#API_RemoveLayerVersionPermission_RequestSyntax) **   <a name="lambda-RemoveLayerVersionPermission-request-uri-LayerName"></a>
The name or Amazon Resource Name (ARN) of the layer.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+)|[a-zA-Z0-9-_]+`   
Required: Yes

 ** [RevisionId](#API_RemoveLayerVersionPermission_RequestSyntax) **   <a name="lambda-RemoveLayerVersionPermission-request-uri-RevisionId"></a>
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.

 ** [StatementId](#API_RemoveLayerVersionPermission_RequestSyntax) **   <a name="lambda-RemoveLayerVersionPermission-request-uri-StatementId"></a>
The identifier that was specified when the statement was added.  
Length Constraints: Minimum length of 1. Maximum length of 100.  
Pattern: `([a-zA-Z0-9-_]+)`   
Required: Yes

 ** [VersionNumber](#API_RemoveLayerVersionPermission_RequestSyntax) **   <a name="lambda-RemoveLayerVersionPermission-request-uri-VersionNumber"></a>
The version number.  
Required: Yes

## Request Body
<a name="API_RemoveLayerVersionPermission_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_RemoveLayerVersionPermission_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_RemoveLayerVersionPermission_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 204 response with an empty HTTP body.

## Errors
<a name="API_RemoveLayerVersionPermission_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** PreconditionFailedException **   
The RevisionId provided does not match the latest RevisionId for the Lambda function or alias.  
+  **For AddPermission and RemovePermission API operations:** Call `GetPolicy` to retrieve the latest RevisionId for your resource.
+  **For all other API operations:** Call `GetFunction` or `GetAlias` to retrieve the latest RevisionId for your resource.  
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 412

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_RemoveLayerVersionPermission_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/RemoveLayerVersionPermission) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/RemoveLayerVersionPermission) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/RemoveLayerVersionPermission) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/RemoveLayerVersionPermission) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/RemoveLayerVersionPermission) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/RemoveLayerVersionPermission) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/RemoveLayerVersionPermission) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/RemoveLayerVersionPermission) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/RemoveLayerVersionPermission) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/RemoveLayerVersionPermission) 

# RemovePermission
<a name="API_RemovePermission"></a>

Revokes function-use permission from an AWS service or another AWS account. You can get the ID of the statement from the output of [GetPolicy](API_GetPolicy.md).

## Request Syntax
<a name="API_RemovePermission_RequestSyntax"></a>

```
DELETE /2015-03-31/functions/FunctionName/policy/StatementId?Qualifier=Qualifier&RevisionId=RevisionId HTTP/1.1
```

## URI Request Parameters
<a name="API_RemovePermission_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_RemovePermission_RequestSyntax) **   <a name="lambda-RemovePermission-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?`   
Required: Yes

 ** [Qualifier](#API_RemovePermission_RequestSyntax) **   <a name="lambda-RemovePermission-request-uri-Qualifier"></a>
Specify a version or alias to remove permissions from a published version of the function.  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `\$(LATEST(\.PUBLISHED)?)|[a-zA-Z0-9-_$]+` 

 ** [RevisionId](#API_RemovePermission_RequestSyntax) **   <a name="lambda-RemovePermission-request-uri-RevisionId"></a>
Update the policy only 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.

 ** [StatementId](#API_RemovePermission_RequestSyntax) **   <a name="lambda-RemovePermission-request-uri-StatementId"></a>
Statement ID of the permission to remove.  
Length Constraints: Minimum length of 1. Maximum length of 100.  
Pattern: `([a-zA-Z0-9-_.]+)`   
Required: Yes

## Request Body
<a name="API_RemovePermission_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_RemovePermission_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_RemovePermission_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 204 response with an empty HTTP body.

## Errors
<a name="API_RemovePermission_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** PreconditionFailedException **   
The RevisionId provided does not match the latest RevisionId for the Lambda function or alias.  
+  **For AddPermission and RemovePermission API operations:** Call `GetPolicy` to retrieve the latest RevisionId for your resource.
+  **For all other API operations:** Call `GetFunction` or `GetAlias` to retrieve the latest RevisionId for your resource.  
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 412

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_RemovePermission_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/RemovePermission) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/RemovePermission) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/RemovePermission) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/RemovePermission) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/RemovePermission) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/RemovePermission) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/RemovePermission) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/RemovePermission) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/RemovePermission) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/RemovePermission) 

# SendDurableExecutionCallbackFailure
<a name="API_SendDurableExecutionCallbackFailure"></a>

Sends a failure response for a callback operation in a durable execution. Use this API when an external system cannot complete a callback operation successfully.

## Request Syntax
<a name="API_SendDurableExecutionCallbackFailure_RequestSyntax"></a>

```
POST /2025-12-01/durable-execution-callbacks/CallbackId/fail HTTP/1.1
Content-type: application/json

{
   "ErrorData": "string",
   "ErrorMessage": "string",
   "ErrorType": "string",
   "StackTrace": [ "string" ]
}
```

## URI Request Parameters
<a name="API_SendDurableExecutionCallbackFailure_RequestParameters"></a>

The request uses the following URI parameters.

 ** [CallbackId](#API_SendDurableExecutionCallbackFailure_RequestSyntax) **   <a name="lambda-SendDurableExecutionCallbackFailure-request-uri-CallbackId"></a>
The unique identifier for the callback operation.  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Pattern: `[A-Za-z0-9+/]+={0,2}`   
Required: Yes

## Request Body
<a name="API_SendDurableExecutionCallbackFailure_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ErrorData](#API_SendDurableExecutionCallbackFailure_RequestSyntax) **   <a name="lambda-SendDurableExecutionCallbackFailure-request-ErrorData"></a>
Machine-readable error data.  
Type: String  
Required: No

 ** [ErrorMessage](#API_SendDurableExecutionCallbackFailure_RequestSyntax) **   <a name="lambda-SendDurableExecutionCallbackFailure-request-ErrorMessage"></a>
A human-readable error message.  
Type: String  
Required: No

 ** [ErrorType](#API_SendDurableExecutionCallbackFailure_RequestSyntax) **   <a name="lambda-SendDurableExecutionCallbackFailure-request-ErrorType"></a>
The error type.  
Type: String  
Required: No

 ** [StackTrace](#API_SendDurableExecutionCallbackFailure_RequestSyntax) **   <a name="lambda-SendDurableExecutionCallbackFailure-request-StackTrace"></a>
Stack trace information for the error.  
Type: Array of strings  
Required: No

## Response Syntax
<a name="API_SendDurableExecutionCallbackFailure_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_SendDurableExecutionCallbackFailure_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_SendDurableExecutionCallbackFailure_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** CallbackTimeoutException **   
The callback ID token has either expired or the callback associated with the token has already been closed.    
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_SendDurableExecutionCallbackFailure_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/SendDurableExecutionCallbackFailure) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/SendDurableExecutionCallbackFailure) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/SendDurableExecutionCallbackFailure) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/SendDurableExecutionCallbackFailure) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/SendDurableExecutionCallbackFailure) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/SendDurableExecutionCallbackFailure) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/SendDurableExecutionCallbackFailure) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/SendDurableExecutionCallbackFailure) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/SendDurableExecutionCallbackFailure) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/SendDurableExecutionCallbackFailure) 

# SendDurableExecutionCallbackHeartbeat
<a name="API_SendDurableExecutionCallbackHeartbeat"></a>

Sends a heartbeat signal for a long-running callback operation to prevent timeout. Use this API to extend the callback timeout period while the external operation is still in progress.

## Request Syntax
<a name="API_SendDurableExecutionCallbackHeartbeat_RequestSyntax"></a>

```
POST /2025-12-01/durable-execution-callbacks/CallbackId/heartbeat HTTP/1.1
```

## URI Request Parameters
<a name="API_SendDurableExecutionCallbackHeartbeat_RequestParameters"></a>

The request uses the following URI parameters.

 ** [CallbackId](#API_SendDurableExecutionCallbackHeartbeat_RequestSyntax) **   <a name="lambda-SendDurableExecutionCallbackHeartbeat-request-uri-CallbackId"></a>
The unique identifier for the callback operation.  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Pattern: `[A-Za-z0-9+/]+={0,2}`   
Required: Yes

## Request Body
<a name="API_SendDurableExecutionCallbackHeartbeat_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_SendDurableExecutionCallbackHeartbeat_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_SendDurableExecutionCallbackHeartbeat_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_SendDurableExecutionCallbackHeartbeat_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** CallbackTimeoutException **   
The callback ID token has either expired or the callback associated with the token has already been closed.    
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_SendDurableExecutionCallbackHeartbeat_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/SendDurableExecutionCallbackHeartbeat) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/SendDurableExecutionCallbackHeartbeat) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/SendDurableExecutionCallbackHeartbeat) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/SendDurableExecutionCallbackHeartbeat) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/SendDurableExecutionCallbackHeartbeat) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/SendDurableExecutionCallbackHeartbeat) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/SendDurableExecutionCallbackHeartbeat) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/SendDurableExecutionCallbackHeartbeat) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/SendDurableExecutionCallbackHeartbeat) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/SendDurableExecutionCallbackHeartbeat) 

# SendDurableExecutionCallbackSuccess
<a name="API_SendDurableExecutionCallbackSuccess"></a>

Sends a successful completion response for a callback operation in a durable execution. Use this API when an external system has successfully completed a callback operation.

## Request Syntax
<a name="API_SendDurableExecutionCallbackSuccess_RequestSyntax"></a>

```
POST /2025-12-01/durable-execution-callbacks/CallbackId/succeed HTTP/1.1

Result
```

## URI Request Parameters
<a name="API_SendDurableExecutionCallbackSuccess_RequestParameters"></a>

The request uses the following URI parameters.

 ** [CallbackId](#API_SendDurableExecutionCallbackSuccess_RequestSyntax) **   <a name="lambda-SendDurableExecutionCallbackSuccess-request-uri-CallbackId"></a>
The unique identifier for the callback operation.  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Pattern: `[A-Za-z0-9+/]+={0,2}`   
Required: Yes

## Request Body
<a name="API_SendDurableExecutionCallbackSuccess_RequestBody"></a>

The request accepts the following binary data.

 ** [Result](#API_SendDurableExecutionCallbackSuccess_RequestSyntax) **   <a name="lambda-SendDurableExecutionCallbackSuccess-request-Result"></a>
The result data from the successful callback operation. Maximum size is 256 KB.  
Length Constraints: Minimum length of 0. Maximum length of 262144.

## Response Syntax
<a name="API_SendDurableExecutionCallbackSuccess_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_SendDurableExecutionCallbackSuccess_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_SendDurableExecutionCallbackSuccess_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** CallbackTimeoutException **   
The callback ID token has either expired or the callback associated with the token has already been closed.    
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_SendDurableExecutionCallbackSuccess_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/SendDurableExecutionCallbackSuccess) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/SendDurableExecutionCallbackSuccess) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/SendDurableExecutionCallbackSuccess) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/SendDurableExecutionCallbackSuccess) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/SendDurableExecutionCallbackSuccess) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/SendDurableExecutionCallbackSuccess) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/SendDurableExecutionCallbackSuccess) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/SendDurableExecutionCallbackSuccess) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/SendDurableExecutionCallbackSuccess) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/SendDurableExecutionCallbackSuccess) 

# StopDurableExecution
<a name="API_StopDurableExecution"></a>

Stops a running [durable execution](https://docs.aws.amazon.com/lambda/latest/dg/durable-functions.html). The execution transitions to STOPPED status and cannot be resumed. Any in-progress operations are terminated.

## Request Syntax
<a name="API_StopDurableExecution_RequestSyntax"></a>

```
POST /2025-12-01/durable-executions/DurableExecutionArn/stop HTTP/1.1
Content-type: application/json

{
   "ErrorData": "string",
   "ErrorMessage": "string",
   "ErrorType": "string",
   "StackTrace": [ "string" ]
}
```

## URI Request Parameters
<a name="API_StopDurableExecution_RequestParameters"></a>

The request uses the following URI parameters.

 ** [DurableExecutionArn](#API_StopDurableExecution_RequestSyntax) **   <a name="lambda-StopDurableExecution-request-uri-DurableExecutionArn"></a>
The Amazon Resource Name (ARN) of the durable execution.  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Pattern: `arn:([a-zA-Z0-9-]+):lambda:([a-zA-Z0-9-]+):(\d{12}):function:([a-zA-Z0-9_-]+):(\$LATEST(?:\.PUBLISHED)?|[0-9]+)/durable-execution/([a-zA-Z0-9_-]+)/([a-zA-Z0-9_-]+)`   
Required: Yes

## Request Body
<a name="API_StopDurableExecution_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ErrorData](#API_StopDurableExecution_RequestSyntax) **   <a name="lambda-StopDurableExecution-request-ErrorData"></a>
Machine-readable error data.  
Type: String  
Required: No

 ** [ErrorMessage](#API_StopDurableExecution_RequestSyntax) **   <a name="lambda-StopDurableExecution-request-ErrorMessage"></a>
A human-readable error message.  
Type: String  
Required: No

 ** [ErrorType](#API_StopDurableExecution_RequestSyntax) **   <a name="lambda-StopDurableExecution-request-ErrorType"></a>
The error type.  
Type: String  
Required: No

 ** [StackTrace](#API_StopDurableExecution_RequestSyntax) **   <a name="lambda-StopDurableExecution-request-StackTrace"></a>
Stack trace information for the error.  
Type: Array of strings  
Required: No

## Response Syntax
<a name="API_StopDurableExecution_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "StopTimestamp": number
}
```

## Response Elements
<a name="API_StopDurableExecution_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [StopTimestamp](#API_StopDurableExecution_ResponseSyntax) **   <a name="lambda-StopDurableExecution-response-StopTimestamp"></a>
The timestamp when the execution was stopped (ISO 8601 format).  
Type: Timestamp

## Errors
<a name="API_StopDurableExecution_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_StopDurableExecution_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/StopDurableExecution) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/StopDurableExecution) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/StopDurableExecution) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/StopDurableExecution) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/StopDurableExecution) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/StopDurableExecution) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/StopDurableExecution) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/StopDurableExecution) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/StopDurableExecution) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/StopDurableExecution) 

# TagResource
<a name="API_TagResource"></a>

Adds [tags](https://docs.aws.amazon.com/lambda/latest/dg/tagging.html) to a function, event source mapping, or code signing configuration.

## Request Syntax
<a name="API_TagResource_RequestSyntax"></a>

```
POST /2017-03-31/tags/Resource HTTP/1.1
Content-type: application/json

{
   "Tags": { 
      "string" : "string" 
   }
}
```

## URI Request Parameters
<a name="API_TagResource_RequestParameters"></a>

The request uses the following URI parameters.

 ** [Resource](#API_TagResource_RequestSyntax) **   <a name="lambda-TagResource-request-uri-Resource"></a>
The resource's Amazon Resource Name (ARN).  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `arn:(aws[a-zA-Z-]*):lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:(function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?|code-signing-config:csc-[a-z0-9]{17}|event-source-mapping:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}|capacity-provider:[a-zA-Z0-9-_]+)`   
Required: Yes

## Request Body
<a name="API_TagResource_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [Tags](#API_TagResource_RequestSyntax) **   <a name="lambda-TagResource-request-Tags"></a>
A list of tags to apply to the resource.  
Type: String to string map  
Required: Yes

## Response Syntax
<a name="API_TagResource_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_TagResource_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 204 response with an empty HTTP body.

## Errors
<a name="API_TagResource_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_TagResource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/TagResource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/TagResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/TagResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/TagResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/TagResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/TagResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/TagResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/TagResource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/TagResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/TagResource) 

# UntagResource
<a name="API_UntagResource"></a>

Removes [tags](https://docs.aws.amazon.com/lambda/latest/dg/tagging.html) from a function, event source mapping, or code signing configuration.

## Request Syntax
<a name="API_UntagResource_RequestSyntax"></a>

```
DELETE /2017-03-31/tags/Resource?tagKeys=TagKeys HTTP/1.1
```

## URI Request Parameters
<a name="API_UntagResource_RequestParameters"></a>

The request uses the following URI parameters.

 ** [Resource](#API_UntagResource_RequestSyntax) **   <a name="lambda-UntagResource-request-uri-Resource"></a>
The resource's Amazon Resource Name (ARN).  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `arn:(aws[a-zA-Z-]*):lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:(function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?|code-signing-config:csc-[a-z0-9]{17}|event-source-mapping:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}|capacity-provider:[a-zA-Z0-9-_]+)`   
Required: Yes

 ** [TagKeys](#API_UntagResource_RequestSyntax) **   <a name="lambda-UntagResource-request-uri-TagKeys"></a>
A list of tag keys to remove from the resource.  
Required: Yes

## Request Body
<a name="API_UntagResource_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_UntagResource_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_UntagResource_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 204 response with an empty HTTP body.

## Errors
<a name="API_UntagResource_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_UntagResource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/UntagResource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/UntagResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/UntagResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/UntagResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/UntagResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/UntagResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/UntagResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/UntagResource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/UntagResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/UntagResource) 

# UpdateAlias
<a name="API_UpdateAlias"></a>

Updates the configuration of a Lambda function [alias](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html).

## Request Syntax
<a name="API_UpdateAlias_RequestSyntax"></a>

```
PUT /2015-03-31/functions/FunctionName/aliases/Name HTTP/1.1
Content-type: application/json

{
   "Description": "string",
   "FunctionVersion": "string",
   "RevisionId": "string",
   "RoutingConfig": { 
      "AdditionalVersionWeights": { 
         "string" : number 
      }
   }
}
```

## URI Request Parameters
<a name="API_UpdateAlias_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_UpdateAlias_RequestSyntax) **   <a name="lambda-UpdateAlias-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?`   
Required: Yes

 ** [Name](#API_UpdateAlias_RequestSyntax) **   <a name="lambda-UpdateAlias-request-uri-Name"></a>
The name of the alias.  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `(?!^[0-9]+$)([a-zA-Z0-9-_]+)`   
Required: Yes

## Request Body
<a name="API_UpdateAlias_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [Description](#API_UpdateAlias_RequestSyntax) **   <a name="lambda-UpdateAlias-request-Description"></a>
A description of the alias.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 256.  
Required: No

 ** [FunctionVersion](#API_UpdateAlias_RequestSyntax) **   <a name="lambda-UpdateAlias-request-FunctionVersion"></a>
The function version that the alias invokes.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Pattern: `(\$LATEST(\.PUBLISHED)?|[0-9]+)`   
Required: No

 ** [RevisionId](#API_UpdateAlias_RequestSyntax) **   <a name="lambda-UpdateAlias-request-RevisionId"></a>
Only update the alias if the revision ID matches the ID that's specified. Use this option to avoid modifying an alias that has changed since you last read it.  
Type: String  
Required: No

 ** [RoutingConfig](#API_UpdateAlias_RequestSyntax) **   <a name="lambda-UpdateAlias-request-RoutingConfig"></a>
The [routing configuration](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html#configuring-alias-routing) of the alias.  
Type: [AliasRoutingConfiguration](API_AliasRoutingConfiguration.md) object  
Required: No

## Response Syntax
<a name="API_UpdateAlias_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AliasArn": "string",
   "Description": "string",
   "FunctionVersion": "string",
   "Name": "string",
   "RevisionId": "string",
   "RoutingConfig": { 
      "AdditionalVersionWeights": { 
         "string" : number 
      }
   }
}
```

## Response Elements
<a name="API_UpdateAlias_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [AliasArn](#API_UpdateAlias_ResponseSyntax) **   <a name="lambda-UpdateAlias-response-AliasArn"></a>
The Amazon Resource Name (ARN) of the alias.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 10000.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?` 

 ** [Description](#API_UpdateAlias_ResponseSyntax) **   <a name="lambda-UpdateAlias-response-Description"></a>
A description of the alias.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 256.

 ** [FunctionVersion](#API_UpdateAlias_ResponseSyntax) **   <a name="lambda-UpdateAlias-response-FunctionVersion"></a>
The function version that the alias invokes.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Pattern: `(\$LATEST|[0-9]+)` 

 ** [Name](#API_UpdateAlias_ResponseSyntax) **   <a name="lambda-UpdateAlias-response-Name"></a>
The name of the alias.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `(?!^[0-9]+$)([a-zA-Z0-9-_]+)` 

 ** [RevisionId](#API_UpdateAlias_ResponseSyntax) **   <a name="lambda-UpdateAlias-response-RevisionId"></a>
A unique identifier that changes when you update the alias.  
Type: String

 ** [RoutingConfig](#API_UpdateAlias_ResponseSyntax) **   <a name="lambda-UpdateAlias-response-RoutingConfig"></a>
The [routing configuration](https://docs.aws.amazon.com/lambda/latest/dg/lambda-traffic-shifting-using-aliases.html) of the alias.  
Type: [AliasRoutingConfiguration](API_AliasRoutingConfiguration.md) object

## Errors
<a name="API_UpdateAlias_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** PreconditionFailedException **   
The RevisionId provided does not match the latest RevisionId for the Lambda function or alias.  
+  **For AddPermission and RemovePermission API operations:** Call `GetPolicy` to retrieve the latest RevisionId for your resource.
+  **For all other API operations:** Call `GetFunction` or `GetAlias` to retrieve the latest RevisionId for your resource.  
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 412

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_UpdateAlias_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/UpdateAlias) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/UpdateAlias) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/UpdateAlias) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/UpdateAlias) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/UpdateAlias) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/UpdateAlias) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/UpdateAlias) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/UpdateAlias) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/UpdateAlias) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/UpdateAlias) 

# UpdateCapacityProvider
<a name="API_UpdateCapacityProvider"></a>

Updates the configuration of an existing capacity provider.

## Request Syntax
<a name="API_UpdateCapacityProvider_RequestSyntax"></a>

```
PUT /2025-11-30/capacity-providers/CapacityProviderName HTTP/1.1
Content-type: application/json

{
   "CapacityProviderScalingConfig": { 
      "MaxVCpuCount": number,
      "ScalingMode": "string",
      "ScalingPolicies": [ 
         { 
            "PredefinedMetricType": "string",
            "TargetValue": number
         }
      ]
   }
}
```

## URI Request Parameters
<a name="API_UpdateCapacityProvider_RequestParameters"></a>

The request uses the following URI parameters.

 ** [CapacityProviderName](#API_UpdateCapacityProvider_RequestSyntax) **   <a name="lambda-UpdateCapacityProvider-request-uri-CapacityProviderName"></a>
The name of the capacity provider to update.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:aws[a-zA-Z-]*:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:capacity-provider:[a-zA-Z0-9-_]+)|[a-zA-Z0-9-_]+`   
Required: Yes

## Request Body
<a name="API_UpdateCapacityProvider_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [CapacityProviderScalingConfig](#API_UpdateCapacityProvider_RequestSyntax) **   <a name="lambda-UpdateCapacityProvider-request-CapacityProviderScalingConfig"></a>
The updated scaling configuration for the capacity provider.  
Type: [CapacityProviderScalingConfig](API_CapacityProviderScalingConfig.md) object  
Required: No

## Response Syntax
<a name="API_UpdateCapacityProvider_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "CapacityProvider": { 
      "CapacityProviderArn": "string",
      "CapacityProviderScalingConfig": { 
         "MaxVCpuCount": number,
         "ScalingMode": "string",
         "ScalingPolicies": [ 
            { 
               "PredefinedMetricType": "string",
               "TargetValue": number
            }
         ]
      },
      "InstanceRequirements": { 
         "AllowedInstanceTypes": [ "string" ],
         "Architectures": [ "string" ],
         "ExcludedInstanceTypes": [ "string" ]
      },
      "KmsKeyArn": "string",
      "LastModified": "string",
      "PermissionsConfig": { 
         "CapacityProviderOperatorRoleArn": "string"
      },
      "State": "string",
      "VpcConfig": { 
         "SecurityGroupIds": [ "string" ],
         "SubnetIds": [ "string" ]
      }
   }
}
```

## Response Elements
<a name="API_UpdateCapacityProvider_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [CapacityProvider](#API_UpdateCapacityProvider_ResponseSyntax) **   <a name="lambda-UpdateCapacityProvider-response-CapacityProvider"></a>
Information about the updated capacity provider.  
Type: [CapacityProvider](API_CapacityProvider.md) object

## Errors
<a name="API_UpdateCapacityProvider_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_UpdateCapacityProvider_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/UpdateCapacityProvider) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/UpdateCapacityProvider) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/UpdateCapacityProvider) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/UpdateCapacityProvider) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/UpdateCapacityProvider) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/UpdateCapacityProvider) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/UpdateCapacityProvider) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/UpdateCapacityProvider) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/UpdateCapacityProvider) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/UpdateCapacityProvider) 

# UpdateCodeSigningConfig
<a name="API_UpdateCodeSigningConfig"></a>

Update the code signing configuration. Changes to the code signing configuration take effect the next time a user tries to deploy a code package to the function. 

## Request Syntax
<a name="API_UpdateCodeSigningConfig_RequestSyntax"></a>

```
PUT /2020-04-22/code-signing-configs/CodeSigningConfigArn HTTP/1.1
Content-type: application/json

{
   "AllowedPublishers": { 
      "SigningProfileVersionArns": [ "string" ]
   },
   "CodeSigningPolicies": { 
      "UntrustedArtifactOnDeployment": "string"
   },
   "Description": "string"
}
```

## URI Request Parameters
<a name="API_UpdateCodeSigningConfig_RequestParameters"></a>

The request uses the following URI parameters.

 ** [CodeSigningConfigArn](#API_UpdateCodeSigningConfig_RequestSyntax) **   <a name="lambda-UpdateCodeSigningConfig-request-uri-CodeSigningConfigArn"></a>
The The Amazon Resource Name (ARN) of the code signing configuration.  
Length Constraints: Minimum length of 0. Maximum length of 200.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}:\d{12}:code-signing-config:csc-[a-z0-9]{17}`   
Required: Yes

## Request Body
<a name="API_UpdateCodeSigningConfig_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [AllowedPublishers](#API_UpdateCodeSigningConfig_RequestSyntax) **   <a name="lambda-UpdateCodeSigningConfig-request-AllowedPublishers"></a>
Signing profiles for this code signing configuration.  
Type: [AllowedPublishers](API_AllowedPublishers.md) object  
Required: No

 ** [CodeSigningPolicies](#API_UpdateCodeSigningConfig_RequestSyntax) **   <a name="lambda-UpdateCodeSigningConfig-request-CodeSigningPolicies"></a>
The code signing policy.  
Type: [CodeSigningPolicies](API_CodeSigningPolicies.md) object  
Required: No

 ** [Description](#API_UpdateCodeSigningConfig_RequestSyntax) **   <a name="lambda-UpdateCodeSigningConfig-request-Description"></a>
Descriptive name for this code signing configuration.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 256.  
Required: No

## Response Syntax
<a name="API_UpdateCodeSigningConfig_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CodeSigningConfig": { 
      "AllowedPublishers": { 
         "SigningProfileVersionArns": [ "string" ]
      },
      "CodeSigningConfigArn": "string",
      "CodeSigningConfigId": "string",
      "CodeSigningPolicies": { 
         "UntrustedArtifactOnDeployment": "string"
      },
      "Description": "string",
      "LastModified": "string"
   }
}
```

## Response Elements
<a name="API_UpdateCodeSigningConfig_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [CodeSigningConfig](#API_UpdateCodeSigningConfig_ResponseSyntax) **   <a name="lambda-UpdateCodeSigningConfig-response-CodeSigningConfig"></a>
The code signing configuration  
Type: [CodeSigningConfig](API_CodeSigningConfig.md) object

## Errors
<a name="API_UpdateCodeSigningConfig_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

## See Also
<a name="API_UpdateCodeSigningConfig_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/UpdateCodeSigningConfig) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/UpdateCodeSigningConfig) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/UpdateCodeSigningConfig) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/UpdateCodeSigningConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/UpdateCodeSigningConfig) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/UpdateCodeSigningConfig) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/UpdateCodeSigningConfig) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/UpdateCodeSigningConfig) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/UpdateCodeSigningConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/UpdateCodeSigningConfig) 

# UpdateEventSourceMapping
<a name="API_UpdateEventSourceMapping"></a>

Updates an event source mapping. You can change the function that AWS Lambda invokes, or pause invocation and resume later from the same location.

For details about how to configure different event sources, see the following topics. 
+  [ Amazon DynamoDB Streams](https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html#services-dynamodb-eventsourcemapping) 
+  [ Amazon Kinesis](https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html#services-kinesis-eventsourcemapping) 
+  [ Amazon SQS](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#events-sqs-eventsource) 
+  [ Amazon MQ and RabbitMQ](https://docs.aws.amazon.com/lambda/latest/dg/with-mq.html#services-mq-eventsourcemapping) 
+  [ Amazon MSK](https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html) 
+  [ Apache Kafka](https://docs.aws.amazon.com/lambda/latest/dg/kafka-smaa.html) 
+  [ Amazon DocumentDB](https://docs.aws.amazon.com/lambda/latest/dg/with-documentdb.html) 

The following error handling options are available for stream sources (DynamoDB, Kinesis, Amazon MSK, and self-managed Apache Kafka):
+  `BisectBatchOnFunctionError` – If the function returns an error, split the batch in two and retry.
+  `MaximumRecordAgeInSeconds` – Discard records older than the specified age. The default value is infinite (-1). When set to infinite (-1), failed records are retried until the record expires
+  `MaximumRetryAttempts` – Discard records after the specified number of retries. The default value is infinite (-1). When set to infinite (-1), failed records are retried until the record expires.
+  `OnFailure` – Send discarded records to an Amazon SQS queue, Amazon SNS topic, Kafka topic, or Amazon S3 bucket. For more information, see [Adding a destination](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async-retain-records.html#invocation-async-destinations).

The following option is available only for DynamoDB and Kinesis event sources:
+  `ParallelizationFactor` – Process multiple batches from each shard concurrently.

For information about which configuration parameters apply to each event source, see the following topics.
+  [ Amazon DynamoDB Streams](https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html#services-ddb-params) 
+  [ Amazon Kinesis](https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html#services-kinesis-params) 
+  [ Amazon SQS](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#services-sqs-params) 
+  [ Amazon MQ and RabbitMQ](https://docs.aws.amazon.com/lambda/latest/dg/with-mq.html#services-mq-params) 
+  [ Amazon MSK](https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html#services-msk-parms) 
+  [ Apache Kafka](https://docs.aws.amazon.com/lambda/latest/dg/with-kafka.html#services-kafka-parms) 
+  [ Amazon DocumentDB](https://docs.aws.amazon.com/lambda/latest/dg/with-documentdb.html#docdb-configuration) 

## Request Syntax
<a name="API_UpdateEventSourceMapping_RequestSyntax"></a>

```
PUT /2015-03-31/event-source-mappings/UUID HTTP/1.1
Content-type: application/json

{
   "AmazonManagedKafkaEventSourceConfig": { 
      "ConsumerGroupId": "string",
      "SchemaRegistryConfig": { 
         "AccessConfigs": [ 
            { 
               "Type": "string",
               "URI": "string"
            }
         ],
         "EventRecordFormat": "string",
         "SchemaRegistryURI": "string",
         "SchemaValidationConfigs": [ 
            { 
               "Attribute": "string"
            }
         ]
      }
   },
   "BatchSize": number,
   "BisectBatchOnFunctionError": boolean,
   "DestinationConfig": { 
      "OnFailure": { 
         "Destination": "string"
      },
      "OnSuccess": { 
         "Destination": "string"
      }
   },
   "DocumentDBEventSourceConfig": { 
      "CollectionName": "string",
      "DatabaseName": "string",
      "FullDocument": "string"
   },
   "Enabled": boolean,
   "FilterCriteria": { 
      "Filters": [ 
         { 
            "Pattern": "string"
         }
      ]
   },
   "FunctionName": "string",
   "FunctionResponseTypes": [ "string" ],
   "KMSKeyArn": "string",
   "LoggingConfig": { 
      "SystemLogLevel": "string"
   },
   "MaximumBatchingWindowInSeconds": number,
   "MaximumRecordAgeInSeconds": number,
   "MaximumRetryAttempts": number,
   "MetricsConfig": { 
      "Metrics": [ "string" ]
   },
   "ParallelizationFactor": number,
   "ProvisionedPollerConfig": { 
      "MaximumPollers": number,
      "MinimumPollers": number,
      "PollerGroupName": "string"
   },
   "ScalingConfig": { 
      "MaximumConcurrency": number
   },
   "SelfManagedKafkaEventSourceConfig": { 
      "ConsumerGroupId": "string",
      "SchemaRegistryConfig": { 
         "AccessConfigs": [ 
            { 
               "Type": "string",
               "URI": "string"
            }
         ],
         "EventRecordFormat": "string",
         "SchemaRegistryURI": "string",
         "SchemaValidationConfigs": [ 
            { 
               "Attribute": "string"
            }
         ]
      }
   },
   "SourceAccessConfigurations": [ 
      { 
         "Type": "string",
         "URI": "string"
      }
   ],
   "TumblingWindowInSeconds": number
}
```

## URI Request Parameters
<a name="API_UpdateEventSourceMapping_RequestParameters"></a>

The request uses the following URI parameters.

 ** [UUID](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-uri-UUID"></a>
The identifier of the event source mapping.  
Required: Yes

## Request Body
<a name="API_UpdateEventSourceMapping_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [AmazonManagedKafkaEventSourceConfig](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-AmazonManagedKafkaEventSourceConfig"></a>
Specific configuration settings for an Amazon Managed Streaming for Apache Kafka (Amazon MSK) event source.  
Type: [AmazonManagedKafkaEventSourceConfig](API_AmazonManagedKafkaEventSourceConfig.md) object  
Required: No

 ** [BatchSize](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-BatchSize"></a>
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 10,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.
+  **Amazon MQ (ActiveMQ and RabbitMQ)** – Default 100. Max 10,000.
+  **DocumentDB** – Default 100. Max 10,000.
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 10000.  
Required: No

 ** [BisectBatchOnFunctionError](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-BisectBatchOnFunctionError"></a>
(Kinesis, DynamoDB Streams, Amazon MSK, and self-managed Apache Kafka) If the function returns an error, split the batch in two and retry.  
Type: Boolean  
Required: No

 ** [DestinationConfig](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-DestinationConfig"></a>
(Kinesis, DynamoDB Streams, Amazon MSK, and self-managed Apache Kafka) A configuration object that specifies the destination of an event after Lambda processes it.  
Type: [DestinationConfig](API_DestinationConfig.md) object  
Required: No

 ** [DocumentDBEventSourceConfig](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-DocumentDBEventSourceConfig"></a>
Specific configuration settings for a DocumentDB event source.  
Type: [DocumentDBEventSourceConfig](API_DocumentDBEventSourceConfig.md) object  
Required: No

 ** [Enabled](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-Enabled"></a>
When true, the event source mapping is active. When false, Lambda pauses polling and invocation.  
Default: True  
Type: Boolean  
Required: No

 ** [FilterCriteria](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-FilterCriteria"></a>
An object that defines the filter criteria that determine whether Lambda should process an event. For more information, see [Lambda event filtering](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html).  
Type: [FilterCriteria](API_FilterCriteria.md) object  
Required: No

 ** [FunctionName](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-FunctionName"></a>
The name or ARN 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.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?`   
Required: No

 ** [FunctionResponseTypes](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-FunctionResponseTypes"></a>
(Kinesis, DynamoDB Streams, Amazon MSK, self-managed Apache Kafka, and Amazon SQS) A list of current response type enums applied to the event source mapping.  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 1 item.  
Valid Values: `ReportBatchItemFailures`   
Required: No

 ** [KMSKeyArn](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-KMSKeyArn"></a>
 The ARN of the AWS Key Management Service (AWS KMS) customer managed key that Lambda uses to encrypt your function's [filter criteria](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html#filtering-basics). By default, Lambda does not encrypt your filter criteria object. Specify this property to encrypt data using your own customer managed key.   
Type: String  
Pattern: `(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()`   
Required: No

 ** [LoggingConfig](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-LoggingConfig"></a>
(Amazon MSK, and self-managed Apache Kafka only) The logging configuration for your event source. Use this configuration object to define the level of logs for your event source mapping.   
Type: [EventSourceMappingLoggingConfig](API_EventSourceMappingLoggingConfig.md) object  
Required: No

 ** [MaximumBatchingWindowInSeconds](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-MaximumBatchingWindowInSeconds"></a>
The maximum amount of time, in seconds, that Lambda spends gathering records before invoking the function. You can configure `MaximumBatchingWindowInSeconds` to any value from 0 seconds to 300 seconds in increments of seconds.  
For Kinesis, DynamoDB, and Amazon SQS event sources, the default batching window is 0 seconds. For Amazon MSK, Self-managed Apache Kafka, Amazon MQ, and DocumentDB event sources, the default batching window is 500 ms. Note that because you can only change `MaximumBatchingWindowInSeconds` in increments of seconds, you cannot revert back to the 500 ms default batching window after you have changed it. To restore the default batching window, you must create a new event source mapping.  
Related setting: For Kinesis, DynamoDB, and Amazon SQS event sources, when you set `BatchSize` to a value greater than 10, you must set `MaximumBatchingWindowInSeconds` to at least 1.  
Type: Integer  
Valid Range: Minimum value of 0. Maximum value of 300.  
Required: No

 ** [MaximumRecordAgeInSeconds](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-MaximumRecordAgeInSeconds"></a>
(Kinesis, DynamoDB Streams, Amazon MSK, and self-managed Apache Kafka) Discard records older than the specified age. The default value is infinite (-1).  
Type: Integer  
Valid Range: Minimum value of -1. Maximum value of 604800.  
Required: No

 ** [MaximumRetryAttempts](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-MaximumRetryAttempts"></a>
(Kinesis, DynamoDB Streams, Amazon MSK, and self-managed Apache Kafka) Discard records after the specified number of retries. The default value is infinite (-1). When set to infinite (-1), failed records are retried until the record expires.  
Type: Integer  
Valid Range: Minimum value of -1. Maximum value of 10000.  
Required: No

 ** [MetricsConfig](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-MetricsConfig"></a>
The metrics configuration for your event source. For more information, see [Event source mapping metrics](https://docs.aws.amazon.com/lambda/latest/dg/monitoring-metrics-types.html#event-source-mapping-metrics).  
Type: [EventSourceMappingMetricsConfig](API_EventSourceMappingMetricsConfig.md) object  
Required: No

 ** [ParallelizationFactor](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-ParallelizationFactor"></a>
(Kinesis and DynamoDB Streams only) The number of batches to process from each shard concurrently.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 10.  
Required: No

 ** [ProvisionedPollerConfig](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-ProvisionedPollerConfig"></a>
(Amazon SQS, Amazon MSK, and self-managed Apache Kafka only) The provisioned mode configuration for the event source. For more information, see [provisioned mode](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventsourcemapping.html#invocation-eventsourcemapping-provisioned-mode).  
Type: [ProvisionedPollerConfig](API_ProvisionedPollerConfig.md) object  
Required: No

 ** [ScalingConfig](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-ScalingConfig"></a>
(Amazon SQS only) The scaling configuration for the event source. For more information, see [Configuring maximum concurrency for Amazon SQS event sources](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#events-sqs-max-concurrency).  
Type: [ScalingConfig](API_ScalingConfig.md) object  
Required: No

 ** [SelfManagedKafkaEventSourceConfig](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-SelfManagedKafkaEventSourceConfig"></a>
Specific configuration settings for a self-managed Apache Kafka event source.  
Type: [SelfManagedKafkaEventSourceConfig](API_SelfManagedKafkaEventSourceConfig.md) object  
Required: No

 ** [SourceAccessConfigurations](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-SourceAccessConfigurations"></a>
An array of authentication protocols or VPC components required to secure your event source.  
Type: Array of [SourceAccessConfiguration](API_SourceAccessConfiguration.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 22 items.  
Required: No

 ** [TumblingWindowInSeconds](#API_UpdateEventSourceMapping_RequestSyntax) **   <a name="lambda-UpdateEventSourceMapping-request-TumblingWindowInSeconds"></a>
(Kinesis and DynamoDB Streams only) The duration in seconds of a processing window for DynamoDB and Kinesis Streams event sources. A value of 0 seconds indicates no tumbling window.  
Type: Integer  
Valid Range: Minimum value of 0. Maximum value of 900.  
Required: No

## Response Syntax
<a name="API_UpdateEventSourceMapping_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "AmazonManagedKafkaEventSourceConfig": { 
      "ConsumerGroupId": "string",
      "SchemaRegistryConfig": { 
         "AccessConfigs": [ 
            { 
               "Type": "string",
               "URI": "string"
            }
         ],
         "EventRecordFormat": "string",
         "SchemaRegistryURI": "string",
         "SchemaValidationConfigs": [ 
            { 
               "Attribute": "string"
            }
         ]
      }
   },
   "BatchSize": number,
   "BisectBatchOnFunctionError": boolean,
   "DestinationConfig": { 
      "OnFailure": { 
         "Destination": "string"
      },
      "OnSuccess": { 
         "Destination": "string"
      }
   },
   "DocumentDBEventSourceConfig": { 
      "CollectionName": "string",
      "DatabaseName": "string",
      "FullDocument": "string"
   },
   "EventSourceArn": "string",
   "EventSourceMappingArn": "string",
   "FilterCriteria": { 
      "Filters": [ 
         { 
            "Pattern": "string"
         }
      ]
   },
   "FilterCriteriaError": { 
      "ErrorCode": "string",
      "Message": "string"
   },
   "FunctionArn": "string",
   "FunctionResponseTypes": [ "string" ],
   "KMSKeyArn": "string",
   "LastModified": number,
   "LastProcessingResult": "string",
   "LoggingConfig": { 
      "SystemLogLevel": "string"
   },
   "MaximumBatchingWindowInSeconds": number,
   "MaximumRecordAgeInSeconds": number,
   "MaximumRetryAttempts": number,
   "MetricsConfig": { 
      "Metrics": [ "string" ]
   },
   "ParallelizationFactor": number,
   "ProvisionedPollerConfig": { 
      "MaximumPollers": number,
      "MinimumPollers": number,
      "PollerGroupName": "string"
   },
   "Queues": [ "string" ],
   "ScalingConfig": { 
      "MaximumConcurrency": number
   },
   "SelfManagedEventSource": { 
      "Endpoints": { 
         "string" : [ "string" ]
      }
   },
   "SelfManagedKafkaEventSourceConfig": { 
      "ConsumerGroupId": "string",
      "SchemaRegistryConfig": { 
         "AccessConfigs": [ 
            { 
               "Type": "string",
               "URI": "string"
            }
         ],
         "EventRecordFormat": "string",
         "SchemaRegistryURI": "string",
         "SchemaValidationConfigs": [ 
            { 
               "Attribute": "string"
            }
         ]
      }
   },
   "SourceAccessConfigurations": [ 
      { 
         "Type": "string",
         "URI": "string"
      }
   ],
   "StartingPosition": "string",
   "StartingPositionTimestamp": number,
   "State": "string",
   "StateTransitionReason": "string",
   "Topics": [ "string" ],
   "TumblingWindowInSeconds": number,
   "UUID": "string"
}
```

## Response Elements
<a name="API_UpdateEventSourceMapping_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [AmazonManagedKafkaEventSourceConfig](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-AmazonManagedKafkaEventSourceConfig"></a>
Specific configuration settings for an Amazon Managed Streaming for Apache Kafka (Amazon MSK) event source.  
Type: [AmazonManagedKafkaEventSourceConfig](API_AmazonManagedKafkaEventSourceConfig.md) object

 ** [BatchSize](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-BatchSize"></a>
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.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 10000.

 ** [BisectBatchOnFunctionError](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-BisectBatchOnFunctionError"></a>
(Kinesis, DynamoDB Streams, Amazon MSK, and self-managed Apache Kafka) If the function returns an error, split the batch in two and retry. The default value is false.  
Type: Boolean

 ** [DestinationConfig](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-DestinationConfig"></a>
(Kinesis, DynamoDB Streams, Amazon MSK, and self-managed Apache Kafka) A configuration object that specifies the destination of an event after Lambda processes it.  
Type: [DestinationConfig](API_DestinationConfig.md) object

 ** [DocumentDBEventSourceConfig](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-DocumentDBEventSourceConfig"></a>
Specific configuration settings for a DocumentDB event source.  
Type: [DocumentDBEventSourceConfig](API_DocumentDBEventSourceConfig.md) object

 ** [EventSourceArn](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-EventSourceArn"></a>
The Amazon Resource Name (ARN) of the event source.  
Type: String  
Pattern: `arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` 

 ** [EventSourceMappingArn](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-EventSourceMappingArn"></a>
The Amazon Resource Name (ARN) of the event source mapping.  
Type: String  
Length Constraints: Minimum length of 85. Maximum length of 120.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:event-source-mapping:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}` 

 ** [FilterCriteria](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-FilterCriteria"></a>
An object that defines the filter criteria that determine whether Lambda should process an event. For more information, see [Lambda event filtering](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html).  
If filter criteria is encrypted, this field shows up as `null` in the response of ListEventSourceMapping API calls. You can view this field in plaintext in the response of GetEventSourceMapping and DeleteEventSourceMapping calls if you have `kms:Decrypt` permissions for the correct AWS KMS key.  
Type: [FilterCriteria](API_FilterCriteria.md) object

 ** [FilterCriteriaError](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-FilterCriteriaError"></a>
An object that contains details about an error related to filter criteria encryption.  
Type: [FilterCriteriaError](API_FilterCriteriaError.md) object

 ** [FunctionArn](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-FunctionArn"></a>
The ARN of the Lambda function.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 10000.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?` 

 ** [FunctionResponseTypes](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-FunctionResponseTypes"></a>
(Kinesis, DynamoDB Streams, Amazon MSK, self-managed Apache Kafka, and Amazon SQS) A list of current response type enums applied to the event source mapping.  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 1 item.  
Valid Values: `ReportBatchItemFailures` 

 ** [KMSKeyArn](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-KMSKeyArn"></a>
 The ARN of the AWS Key Management Service (AWS KMS) customer managed key that Lambda uses to encrypt your function's [filter criteria](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html#filtering-basics).  
Type: String  
Pattern: `(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()` 

 ** [LastModified](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-LastModified"></a>
The date that the event source mapping was last updated or that its state changed, in Unix time seconds.  
Type: Timestamp

 ** [LastProcessingResult](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-LastProcessingResult"></a>
The result of the event source mapping's last processing attempt.  
Type: String

 ** [LoggingConfig](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-LoggingConfig"></a>
(Amazon MSK, and self-managed Apache Kafka only) The logging configuration for your event source. For more information, see [Event source mapping logging](https://docs.aws.amazon.com/lambda/latest/dg/esm-logging.html).  
Type: [EventSourceMappingLoggingConfig](API_EventSourceMappingLoggingConfig.md) object

 ** [MaximumBatchingWindowInSeconds](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-MaximumBatchingWindowInSeconds"></a>
The maximum amount of time, in seconds, that Lambda spends gathering records before invoking the function. You can configure `MaximumBatchingWindowInSeconds` to any value from 0 seconds to 300 seconds in increments of seconds.  
For streams and Amazon SQS event sources, the default batching window is 0 seconds. For Amazon MSK, Self-managed Apache Kafka, Amazon MQ, and DocumentDB event sources, the default batching window is 500 ms. Note that because you can only change `MaximumBatchingWindowInSeconds` in increments of seconds, you cannot revert back to the 500 ms default batching window after you have changed it. To restore the default batching window, you must create a new event source mapping.  
Related setting: For streams and Amazon SQS event sources, when you set `BatchSize` to a value greater than 10, you must set `MaximumBatchingWindowInSeconds` to at least 1.  
Type: Integer  
Valid Range: Minimum value of 0. Maximum value of 300.

 ** [MaximumRecordAgeInSeconds](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-MaximumRecordAgeInSeconds"></a>
(Kinesis, DynamoDB Streams, Amazon MSK, and self-managed Apache Kafka) 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.  
The minimum valid value for maximum record age is 60s. Although values less than 60 and greater than -1 fall within the parameter's absolute range, they are not allowed
Type: Integer  
Valid Range: Minimum value of -1. Maximum value of 604800.

 ** [MaximumRetryAttempts](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-MaximumRetryAttempts"></a>
(Kinesis, DynamoDB Streams, Amazon MSK, and self-managed Apache Kafka) 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.  
Type: Integer  
Valid Range: Minimum value of -1. Maximum value of 10000.

 ** [MetricsConfig](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-MetricsConfig"></a>
The metrics configuration for your event source. For more information, see [Event source mapping metrics](https://docs.aws.amazon.com/lambda/latest/dg/monitoring-metrics-types.html#event-source-mapping-metrics).  
Type: [EventSourceMappingMetricsConfig](API_EventSourceMappingMetricsConfig.md) object

 ** [ParallelizationFactor](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-ParallelizationFactor"></a>
(Kinesis and DynamoDB Streams only) The number of batches to process concurrently from each shard. The default value is 1.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 10.

 ** [ProvisionedPollerConfig](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-ProvisionedPollerConfig"></a>
(Amazon SQS, Amazon MSK, and self-managed Apache Kafka only) The provisioned mode configuration for the event source. For more information, see [provisioned mode](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventsourcemapping.html#invocation-eventsourcemapping-provisioned-mode).  
Type: [ProvisionedPollerConfig](API_ProvisionedPollerConfig.md) object

 ** [Queues](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-Queues"></a>
 (Amazon MQ) The name of the Amazon MQ broker destination queue to consume.  
Type: Array of strings  
Array Members: Fixed number of 1 item.  
Length Constraints: Minimum length of 1. Maximum length of 1000.  
Pattern: `[\s\S]*` 

 ** [ScalingConfig](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-ScalingConfig"></a>
(Amazon SQS only) The scaling configuration for the event source. For more information, see [Configuring maximum concurrency for Amazon SQS event sources](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#events-sqs-max-concurrency).  
Type: [ScalingConfig](API_ScalingConfig.md) object

 ** [SelfManagedEventSource](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-SelfManagedEventSource"></a>
The self-managed Apache Kafka cluster for your event source.  
Type: [SelfManagedEventSource](API_SelfManagedEventSource.md) object

 ** [SelfManagedKafkaEventSourceConfig](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-SelfManagedKafkaEventSourceConfig"></a>
Specific configuration settings for a self-managed Apache Kafka event source.  
Type: [SelfManagedKafkaEventSourceConfig](API_SelfManagedKafkaEventSourceConfig.md) object

 ** [SourceAccessConfigurations](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-SourceAccessConfigurations"></a>
An array of the authentication protocol, VPC components, or virtual host to secure and define your event source.  
Type: Array of [SourceAccessConfiguration](API_SourceAccessConfiguration.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 22 items.

 ** [StartingPosition](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-StartingPosition"></a>
The position in a stream from which to start reading. Required for Amazon Kinesis and Amazon DynamoDB Stream event sources. `AT_TIMESTAMP` is supported only for Amazon Kinesis streams, Amazon DocumentDB, Amazon MSK, and self-managed Apache Kafka.  
Type: String  
Valid Values: `TRIM_HORIZON | LATEST | AT_TIMESTAMP` 

 ** [StartingPositionTimestamp](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-StartingPositionTimestamp"></a>
With `StartingPosition` set to `AT_TIMESTAMP`, the time from which to start reading, in Unix time seconds. `StartingPositionTimestamp` cannot be in the future.  
Type: Timestamp

 ** [State](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-State"></a>
The state of the event source mapping. It can be one of the following: `Creating`, `Enabling`, `Enabled`, `Disabling`, `Disabled`, `Updating`, or `Deleting`.  
Type: String

 ** [StateTransitionReason](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-StateTransitionReason"></a>
Indicates whether a user or Lambda made the last change to the event source mapping.  
Type: String

 ** [Topics](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-Topics"></a>
The name of the Kafka topic.  
Type: Array of strings  
Array Members: Fixed number of 1 item.  
Length Constraints: Minimum length of 1. Maximum length of 249.  
Pattern: `[^.]([a-zA-Z0-9\-_.]+)` 

 ** [TumblingWindowInSeconds](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-TumblingWindowInSeconds"></a>
(Kinesis and DynamoDB Streams only) The duration in seconds of a processing window for DynamoDB and Kinesis Streams event sources. A value of 0 seconds indicates no tumbling window.  
Type: Integer  
Valid Range: Minimum value of 0. Maximum value of 900.

 ** [UUID](#API_UpdateEventSourceMapping_ResponseSyntax) **   <a name="lambda-UpdateEventSourceMapping-response-UUID"></a>
The identifier of the event source mapping.  
Type: String

## Errors
<a name="API_UpdateEventSourceMapping_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceInUseException **   
The operation conflicts with the resource's availability. For example, you tried to update an event source mapping in the CREATING state, or you tried to delete an event source mapping currently UPDATING.  
HTTP Status Code: 400

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_UpdateEventSourceMapping_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/UpdateEventSourceMapping) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/UpdateEventSourceMapping) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/UpdateEventSourceMapping) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/UpdateEventSourceMapping) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/UpdateEventSourceMapping) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/UpdateEventSourceMapping) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/UpdateEventSourceMapping) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/UpdateEventSourceMapping) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/UpdateEventSourceMapping) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/UpdateEventSourceMapping) 

# UpdateFunctionCode
<a name="API_UpdateFunctionCode"></a>

Updates a Lambda function's code. If code signing is enabled for the function, the code package must be signed by a trusted publisher. For more information, see [Configuring code signing for Lambda](https://docs.aws.amazon.com/lambda/latest/dg/configuration-codesigning.html).

If the function's package type is `Image`, then you must specify the code package in `ImageUri` as the URI of a [container image](https://docs.aws.amazon.com/lambda/latest/dg/lambda-images.html) in the Amazon ECR registry.

If the function's package type is `Zip`, then you must specify the deployment package as a [.zip file archive](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-package.html#gettingstarted-package-zip). Enter the Amazon S3 bucket and key of the code .zip file location. You can also provide the function code inline using the `ZipFile` field.

The code in the deployment package must be compatible with the target instruction set architecture of the function (`x86-64` or `arm64`).

The function's code is locked when you publish a version. You can't modify the code of a published version, only the unpublished version.

**Note**  
For a function defined as a container image, Lambda resolves the image tag to an image digest. In Amazon ECR, if you update the image tag to a new image, Lambda does not automatically update the function.

## Request Syntax
<a name="API_UpdateFunctionCode_RequestSyntax"></a>

```
PUT /2015-03-31/functions/FunctionName/code HTTP/1.1
Content-type: application/json

{
   "Architectures": [ "string" ],
   "DryRun": boolean,
   "ImageUri": "string",
   "Publish": boolean,
   "PublishTo": "string",
   "RevisionId": "string",
   "S3Bucket": "string",
   "S3Key": "string",
   "S3ObjectVersion": "string",
   "SourceKMSKeyArn": "string",
   "ZipFile": blob
}
```

## URI Request Parameters
<a name="API_UpdateFunctionCode_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_UpdateFunctionCode_RequestSyntax) **   <a name="lambda-UpdateFunctionCode-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?`   
Required: Yes

## Request Body
<a name="API_UpdateFunctionCode_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [Architectures](#API_UpdateFunctionCode_RequestSyntax) **   <a name="lambda-UpdateFunctionCode-request-Architectures"></a>
The instruction set architecture that the function supports. Enter a string array with one of the valid values (arm64 or x86\$164). The default value is `x86_64`.  
Type: Array of strings  
Array Members: Fixed number of 1 item.  
Valid Values: `x86_64 | arm64`   
Required: No

 ** [DryRun](#API_UpdateFunctionCode_RequestSyntax) **   <a name="lambda-UpdateFunctionCode-request-DryRun"></a>
Set to true to validate the request parameters and access permissions without modifying the function code.  
Type: Boolean  
Required: No

 ** [ImageUri](#API_UpdateFunctionCode_RequestSyntax) **   <a name="lambda-UpdateFunctionCode-request-ImageUri"></a>
URI of a container image in the Amazon ECR registry. Do not use for a function defined with a .zip file archive.  
Type: String  
Required: No

 ** [Publish](#API_UpdateFunctionCode_RequestSyntax) **   <a name="lambda-UpdateFunctionCode-request-Publish"></a>
Set to true to publish a new version of the function after updating the code. This has the same effect as calling [PublishVersion](API_PublishVersion.md) separately.  
Type: Boolean  
Required: No

 ** [PublishTo](#API_UpdateFunctionCode_RequestSyntax) **   <a name="lambda-UpdateFunctionCode-request-PublishTo"></a>
Specifies where to publish the function version or configuration.  
Type: String  
Valid Values: `LATEST_PUBLISHED`   
Required: No

 ** [RevisionId](#API_UpdateFunctionCode_RequestSyntax) **   <a name="lambda-UpdateFunctionCode-request-RevisionId"></a>
Update the function only if the revision ID matches the ID that's specified. Use this option to avoid modifying a function that has changed since you last read it.  
Type: String  
Required: No

 ** [S3Bucket](#API_UpdateFunctionCode_RequestSyntax) **   <a name="lambda-UpdateFunctionCode-request-S3Bucket"></a>
An Amazon S3 bucket in the same AWS Region as your function. The bucket can be in a different AWS account. Use only with a function defined with a .zip file archive deployment package.  
Type: String  
Length Constraints: Minimum length of 3. Maximum length of 63.  
Pattern: `[0-9A-Za-z\.\-_]*(?<!\.)`   
Required: No

 ** [S3Key](#API_UpdateFunctionCode_RequestSyntax) **   <a name="lambda-UpdateFunctionCode-request-S3Key"></a>
The Amazon S3 key of the deployment package. Use only with a function defined with a .zip file archive deployment package.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Required: No

 ** [S3ObjectVersion](#API_UpdateFunctionCode_RequestSyntax) **   <a name="lambda-UpdateFunctionCode-request-S3ObjectVersion"></a>
For versioned objects, the version of the deployment package object to use.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Required: No

 ** [SourceKMSKeyArn](#API_UpdateFunctionCode_RequestSyntax) **   <a name="lambda-UpdateFunctionCode-request-SourceKMSKeyArn"></a>
The ARN of the AWS Key Management Service (AWS KMS) customer managed key that's used to encrypt your function's .zip deployment package. If you don't provide a customer managed key, Lambda uses an AWS managed key.  
Type: String  
Pattern: `(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()`   
Required: No

 ** [ZipFile](#API_UpdateFunctionCode_RequestSyntax) **   <a name="lambda-UpdateFunctionCode-request-ZipFile"></a>
The base64-encoded contents of the deployment package. AWS SDK and AWS CLI clients handle the encoding for you. Use only with a function defined with a .zip file archive deployment package.  
Type: Base64-encoded binary data object  
Required: No

## Response Syntax
<a name="API_UpdateFunctionCode_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Architectures": [ "string" ],
   "CapacityProviderConfig": { 
      "LambdaManagedInstancesCapacityProviderConfig": { 
         "CapacityProviderArn": "string",
         "ExecutionEnvironmentMemoryGiBPerVCpu": number,
         "PerExecutionEnvironmentMaxConcurrency": number
      }
   },
   "CodeSha256": "string",
   "CodeSize": number,
   "ConfigSha256": "string",
   "DeadLetterConfig": { 
      "TargetArn": "string"
   },
   "Description": "string",
   "DurableConfig": { 
      "ExecutionTimeout": number,
      "RetentionPeriodInDays": number
   },
   "Environment": { 
      "Error": { 
         "ErrorCode": "string",
         "Message": "string"
      },
      "Variables": { 
         "string" : "string" 
      }
   },
   "EphemeralStorage": { 
      "Size": number
   },
   "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"
      }
   ],
   "LoggingConfig": { 
      "ApplicationLogLevel": "string",
      "LogFormat": "string",
      "LogGroup": "string",
      "SystemLogLevel": "string"
   },
   "MasterArn": "string",
   "MemorySize": number,
   "PackageType": "string",
   "RevisionId": "string",
   "Role": "string",
   "Runtime": "string",
   "RuntimeVersionConfig": { 
      "Error": { 
         "ErrorCode": "string",
         "Message": "string"
      },
      "RuntimeVersionArn": "string"
   },
   "SigningJobArn": "string",
   "SigningProfileVersionArn": "string",
   "SnapStart": { 
      "ApplyOn": "string",
      "OptimizationStatus": "string"
   },
   "State": "string",
   "StateReason": "string",
   "StateReasonCode": "string",
   "TenancyConfig": { 
      "TenantIsolationMode": "string"
   },
   "Timeout": number,
   "TracingConfig": { 
      "Mode": "string"
   },
   "Version": "string",
   "VpcConfig": { 
      "Ipv6AllowedForDualStack": boolean,
      "SecurityGroupIds": [ "string" ],
      "SubnetIds": [ "string" ],
      "VpcId": "string"
   }
}
```

## Response Elements
<a name="API_UpdateFunctionCode_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [Architectures](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-Architectures"></a>
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`.  
Type: Array of strings  
Array Members: Fixed number of 1 item.  
Valid Values: `x86_64 | arm64` 

 ** [CapacityProviderConfig](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-CapacityProviderConfig"></a>
Configuration for the capacity provider that manages compute resources for Lambda functions.  
Type: [CapacityProviderConfig](API_CapacityProviderConfig.md) object

 ** [CodeSha256](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-CodeSha256"></a>
The SHA256 hash of the function's deployment package.  
Type: String

 ** [CodeSize](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-CodeSize"></a>
The size of the function's deployment package, in bytes.  
Type: Long

 ** [ConfigSha256](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-ConfigSha256"></a>
The SHA256 hash of the function configuration.  
Type: String

 ** [DeadLetterConfig](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-DeadLetterConfig"></a>
The function's dead letter queue.  
Type: [DeadLetterConfig](API_DeadLetterConfig.md) object

 ** [Description](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-Description"></a>
The function's description.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 256.

 ** [DurableConfig](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-DurableConfig"></a>
The function's durable execution configuration settings, if the function is configured for durability.  
Type: [DurableConfig](API_DurableConfig.md) object

 ** [Environment](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-Environment"></a>
The function's [environment variables](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html). Omitted from AWS CloudTrail logs.  
Type: [EnvironmentResponse](API_EnvironmentResponse.md) object

 ** [EphemeralStorage](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-EphemeralStorage"></a>
The size of the function's `/tmp` directory in MB. The default value is 512, but can be any whole number between 512 and 10,240 MB. For more information, see [Configuring ephemeral storage (console)](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-ephemeral-storage).  
Type: [EphemeralStorage](API_EphemeralStorage.md) object

 ** [FileSystemConfigs](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-FileSystemConfigs"></a>
Connection settings for an [Amazon EFS file system](https://docs.aws.amazon.com/lambda/latest/dg/configuration-filesystem.html) or an [Amazon S3 Files file system](https://docs.aws.amazon.com/lambda/latest/dg/configuration-filesystem.html).  
Type: Array of [FileSystemConfig](API_FileSystemConfig.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 1 item.

 ** [FunctionArn](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-FunctionArn"></a>
The function's Amazon Resource Name (ARN).  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 10000.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_\.]+(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?` 

 ** [FunctionName](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-FunctionName"></a>
The name of the function.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?` 

 ** [Handler](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-Handler"></a>
The function that Lambda calls to begin running your function.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 128.  
Pattern: `[^\s]+` 

 ** [ImageConfigResponse](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-ImageConfigResponse"></a>
The function's image configuration values.  
Type: [ImageConfigResponse](API_ImageConfigResponse.md) object

 ** [KMSKeyArn](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-KMSKeyArn"></a>
The ARN of the AWS Key Management Service (AWS KMS) customer managed key that's used to encrypt the following resources:  
+ The function's [environment variables](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html#configuration-envvars-encryption).
+ The function's [Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart-security.html) snapshots.
+ When used with `SourceKMSKeyArn`, the unzipped version of the .zip deployment package that's used for function invocations. For more information, see [ Specifying a customer managed key for Lambda](https://docs.aws.amazon.com/lambda/latest/dg/encrypt-zip-package.html#enable-zip-custom-encryption).
+ The optimized version of the container image that's used for function invocations. Note that this is not the same key that's used to protect your container image in the Amazon Elastic Container Registry (Amazon ECR). For more information, see [Function lifecycle](https://docs.aws.amazon.com/lambda/latest/dg/images-create.html#images-lifecycle).
If you don't provide a customer managed key, Lambda uses an [AWS owned key](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-owned-cmk) or an [AWS managed key](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk).  
Type: String  
Pattern: `(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()` 

 ** [LastModified](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-LastModified"></a>
The date and time that the function was last updated, in [ISO-8601 format](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD).  
Type: String

 ** [LastUpdateStatus](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-LastUpdateStatus"></a>
The status of the last update that was performed on the function. This is first set to `Successful` after function creation completes.  
Type: String  
Valid Values: `Successful | Failed | InProgress` 

 ** [LastUpdateStatusReason](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-LastUpdateStatusReason"></a>
The reason for the last update that was performed on the function.  
Type: String

 ** [LastUpdateStatusReasonCode](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-LastUpdateStatusReasonCode"></a>
The reason code for the last update that was performed on the function.  
Type: String  
Valid Values: `EniLimitExceeded | InsufficientRolePermissions | InvalidConfiguration | InternalError | SubnetOutOfIPAddresses | InvalidSubnet | InvalidSecurityGroup | ImageDeleted | ImageAccessDenied | InvalidImage | KMSKeyAccessDenied | KMSKeyNotFound | InvalidStateKMSKey | DisabledKMSKey | EFSIOError | EFSMountConnectivityError | EFSMountFailure | EFSMountTimeout | InvalidRuntime | InvalidZipFileException | FunctionError | VcpuLimitExceeded | CapacityProviderScalingLimitExceeded | InsufficientCapacity | EC2RequestLimitExceeded | FunctionError.InitTimeout | FunctionError.RuntimeInitError | FunctionError.ExtensionInitError | FunctionError.InvalidEntryPoint | FunctionError.InvalidWorkingDirectory | FunctionError.PermissionDenied | FunctionError.TooManyExtensions | FunctionError.InitResourceExhausted | DisallowedByVpcEncryptionControl` 

 ** [Layers](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-Layers"></a>
The function's [layers](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html).  
Type: Array of [Layer](API_Layer.md) objects

 ** [LoggingConfig](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-LoggingConfig"></a>
The function's Amazon CloudWatch Logs configuration settings.  
Type: [LoggingConfig](API_LoggingConfig.md) object

 ** [MasterArn](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-MasterArn"></a>
For Lambda@Edge functions, the ARN of the main function.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 10000.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?` 

 ** [MemorySize](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-MemorySize"></a>
The amount of memory available to the function at runtime.  
Type: Integer  
Valid Range: Minimum value of 128. Maximum value of 32768.

 ** [PackageType](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-PackageType"></a>
The type of deployment package. Set to `Image` for container image and set `Zip` for .zip file archive.  
Type: String  
Valid Values: `Zip | Image` 

 ** [RevisionId](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-RevisionId"></a>
The latest updated revision of the function or alias.  
Type: String

 ** [Role](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-Role"></a>
The function's execution role.  
Type: String  
Pattern: `arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 

 ** [Runtime](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-Runtime"></a>
The identifier of the function's [ runtime](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html). Runtime is required if the deployment package is a .zip file archive. Specifying a runtime results in an error if you're deploying a function using a container image.  
The following list includes deprecated runtimes. Lambda blocks creating new functions and updating existing functions shortly after each runtime is deprecated. For more information, see [Runtime use after deprecation](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-deprecation-levels).  
For a list of all currently supported runtimes, see [Supported runtimes](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtimes-supported).  
Type: String  
Valid Values: `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 | nodejs24.x | python3.14 | java25 | dotnet10` 

 ** [RuntimeVersionConfig](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-RuntimeVersionConfig"></a>
The ARN of the runtime and any errors that occured.  
Type: [RuntimeVersionConfig](API_RuntimeVersionConfig.md) object

 ** [SigningJobArn](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-SigningJobArn"></a>
The ARN of the signing job.  
Type: String  
Pattern: `arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` 

 ** [SigningProfileVersionArn](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-SigningProfileVersionArn"></a>
The ARN of the signing profile version.  
Type: String  
Pattern: `arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` 

 ** [SnapStart](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-SnapStart"></a>
Set `ApplyOn` to `PublishedVersions` to create a snapshot of the initialized execution environment when you publish a function version. For more information, see [Improving startup performance with Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html).  
Type: [SnapStartResponse](API_SnapStartResponse.md) object

 ** [State](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-State"></a>
The current state of the function. When the state is `Inactive`, you can reactivate the function by invoking it.  
Type: String  
Valid Values: `Pending | Active | Inactive | Failed | Deactivating | Deactivated | ActiveNonInvocable | Deleting` 

 ** [StateReason](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-StateReason"></a>
The reason for the function's current state.  
Type: String

 ** [StateReasonCode](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-StateReasonCode"></a>
The reason code for the function's current state. When the code is `Creating`, you can't invoke or modify the function.  
Type: String  
Valid Values: `Idle | Creating | Restoring | EniLimitExceeded | InsufficientRolePermissions | InvalidConfiguration | InternalError | SubnetOutOfIPAddresses | InvalidSubnet | InvalidSecurityGroup | ImageDeleted | ImageAccessDenied | InvalidImage | KMSKeyAccessDenied | KMSKeyNotFound | InvalidStateKMSKey | DisabledKMSKey | EFSIOError | EFSMountConnectivityError | EFSMountFailure | EFSMountTimeout | InvalidRuntime | InvalidZipFileException | FunctionError | DrainingDurableExecutions | VcpuLimitExceeded | CapacityProviderScalingLimitExceeded | InsufficientCapacity | EC2RequestLimitExceeded | FunctionError.InitTimeout | FunctionError.RuntimeInitError | FunctionError.ExtensionInitError | FunctionError.InvalidEntryPoint | FunctionError.InvalidWorkingDirectory | FunctionError.PermissionDenied | FunctionError.TooManyExtensions | FunctionError.InitResourceExhausted | DisallowedByVpcEncryptionControl` 

 ** [TenancyConfig](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-TenancyConfig"></a>
The function's tenant isolation configuration settings. Determines whether the Lambda function runs on a shared or dedicated infrastructure per unique tenant.  
Type: [TenancyConfig](API_TenancyConfig.md) object

 ** [Timeout](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-Timeout"></a>
The amount of time in seconds that Lambda allows a function to run before stopping it.  
Type: Integer  
Valid Range: Minimum value of 1.

 ** [TracingConfig](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-TracingConfig"></a>
The function's AWS X-Ray tracing configuration.  
Type: [TracingConfigResponse](API_TracingConfigResponse.md) object

 ** [Version](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-Version"></a>
The version of the Lambda function.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Pattern: `(\$LATEST|[0-9]+)` 

 ** [VpcConfig](#API_UpdateFunctionCode_ResponseSyntax) **   <a name="lambda-UpdateFunctionCode-response-VpcConfig"></a>
The function's networking configuration.  
Type: [VpcConfigResponse](API_VpcConfigResponse.md) object

## Errors
<a name="API_UpdateFunctionCode_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** CodeSigningConfigNotFoundException **   
The specified code signing configuration does not exist.  
HTTP Status Code: 404

 ** CodeStorageExceededException **   
Your AWS account has exceeded its maximum total code size. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html).    
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** CodeVerificationFailedException **   
The code signature failed one or more of the validation checks for signature mismatch or expiry, and the code signing policy is set to ENFORCE. Lambda blocks the deployment.  
HTTP Status Code: 400

 ** InvalidCodeSignatureException **   
The code signature failed the integrity check. If the integrity check fails, then Lambda blocks deployment, even if the code signing policy is set to WARN.  
HTTP Status Code: 400

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** PreconditionFailedException **   
The RevisionId provided does not match the latest RevisionId for the Lambda function or alias.  
+  **For AddPermission and RemovePermission API operations:** Call `GetPolicy` to retrieve the latest RevisionId for your resource.
+  **For all other API operations:** Call `GetFunction` or `GetAlias` to retrieve the latest RevisionId for your resource.  
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 412

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_UpdateFunctionCode_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/UpdateFunctionCode) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/UpdateFunctionCode) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/UpdateFunctionCode) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/UpdateFunctionCode) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/UpdateFunctionCode) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/UpdateFunctionCode) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/UpdateFunctionCode) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/UpdateFunctionCode) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/UpdateFunctionCode) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/UpdateFunctionCode) 

# UpdateFunctionConfiguration
<a name="API_UpdateFunctionConfiguration"></a>

Modify the version-specific settings of a Lambda function.

When you update a function, Lambda provisions an instance of the function and its supporting resources. If your function connects to a VPC, this process can take a minute. During this time, you can't modify the function, but you can still invoke it. The `LastUpdateStatus`, `LastUpdateStatusReason`, and `LastUpdateStatusReasonCode` fields in the response from [GetFunctionConfiguration](API_GetFunctionConfiguration.md) indicate when the update is complete and the function is processing events with the new configuration. For more information, see [Lambda function states](https://docs.aws.amazon.com/lambda/latest/dg/functions-states.html).

These settings can vary between versions of a function and are locked when you publish a version. You can't modify the configuration of a published version, only the unpublished version.

To configure function concurrency, use [PutFunctionConcurrency](API_PutFunctionConcurrency.md). To grant invoke permissions to an AWS account or AWS service, use [AddPermission](API_AddPermission.md).

## Request Syntax
<a name="API_UpdateFunctionConfiguration_RequestSyntax"></a>

```
PUT /2015-03-31/functions/FunctionName/configuration HTTP/1.1
Content-type: application/json

{
   "CapacityProviderConfig": { 
      "LambdaManagedInstancesCapacityProviderConfig": { 
         "CapacityProviderArn": "string",
         "ExecutionEnvironmentMemoryGiBPerVCpu": number,
         "PerExecutionEnvironmentMaxConcurrency": number
      }
   },
   "DeadLetterConfig": { 
      "TargetArn": "string"
   },
   "Description": "string",
   "DurableConfig": { 
      "ExecutionTimeout": number,
      "RetentionPeriodInDays": number
   },
   "Environment": { 
      "Variables": { 
         "string" : "string" 
      }
   },
   "EphemeralStorage": { 
      "Size": number
   },
   "FileSystemConfigs": [ 
      { 
         "Arn": "string",
         "LocalMountPath": "string"
      }
   ],
   "Handler": "string",
   "ImageConfig": { 
      "Command": [ "string" ],
      "EntryPoint": [ "string" ],
      "WorkingDirectory": "string"
   },
   "KMSKeyArn": "string",
   "Layers": [ "string" ],
   "LoggingConfig": { 
      "ApplicationLogLevel": "string",
      "LogFormat": "string",
      "LogGroup": "string",
      "SystemLogLevel": "string"
   },
   "MemorySize": number,
   "RevisionId": "string",
   "Role": "string",
   "Runtime": "string",
   "SnapStart": { 
      "ApplyOn": "string"
   },
   "Timeout": number,
   "TracingConfig": { 
      "Mode": "string"
   },
   "VpcConfig": { 
      "Ipv6AllowedForDualStack": boolean,
      "SecurityGroupIds": [ "string" ],
      "SubnetIds": [ "string" ]
   }
}
```

## URI Request Parameters
<a name="API_UpdateFunctionConfiguration_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?`   
Required: Yes

## Request Body
<a name="API_UpdateFunctionConfiguration_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [CapacityProviderConfig](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-CapacityProviderConfig"></a>
Configuration for the capacity provider that manages compute resources for Lambda functions.  
Type: [CapacityProviderConfig](API_CapacityProviderConfig.md) object  
Required: No

 ** [DeadLetterConfig](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-DeadLetterConfig"></a>
A dead-letter queue configuration that specifies the queue or topic where Lambda sends asynchronous events when they fail processing. For more information, see [Dead-letter queues](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-dlq).  
Type: [DeadLetterConfig](API_DeadLetterConfig.md) object  
Required: No

 ** [Description](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-Description"></a>
A description of the function.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 256.  
Required: No

 ** [DurableConfig](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-DurableConfig"></a>
Configuration settings for durable functions. Allows updating execution timeout and retention period for functions with durability enabled.  
Type: [DurableConfig](API_DurableConfig.md) object  
Required: No

 ** [Environment](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-Environment"></a>
Environment variables that are accessible from function code during execution.  
Type: [Environment](API_Environment.md) object  
Required: No

 ** [EphemeralStorage](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-EphemeralStorage"></a>
The size of the function's `/tmp` directory in MB. The default value is 512, but can be any whole number between 512 and 10,240 MB. For more information, see [Configuring ephemeral storage (console)](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-ephemeral-storage).  
Type: [EphemeralStorage](API_EphemeralStorage.md) object  
Required: No

 ** [FileSystemConfigs](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-FileSystemConfigs"></a>
Connection settings for an Amazon EFS file system or an Amazon S3 Files file system.  
Type: Array of [FileSystemConfig](API_FileSystemConfig.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 1 item.  
Required: No

 ** [Handler](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-Handler"></a>
The name of the method within your code that Lambda calls to run your function. Handler is required if the deployment package is a .zip file archive. The format includes the file name. It can also include namespaces and other qualifiers, depending on the runtime. For more information, see [Lambda programming model](https://docs.aws.amazon.com/lambda/latest/dg/foundation-progmodel.html).  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 128.  
Pattern: `[^\s]+`   
Required: No

 ** [ImageConfig](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-ImageConfig"></a>
 [Container image configuration values](https://docs.aws.amazon.com/lambda/latest/dg/images-create.html#images-parms) that override the values in the container image Docker file.  
Type: [ImageConfig](API_ImageConfig.md) object  
Required: No

 ** [KMSKeyArn](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-KMSKeyArn"></a>
The ARN of the AWS Key Management Service (AWS KMS) customer managed key that's used to encrypt the following resources:  
+ The function's [environment variables](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html#configuration-envvars-encryption).
+ The function's [Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart-security.html) snapshots.
+ When used with `SourceKMSKeyArn`, the unzipped version of the .zip deployment package that's used for function invocations. For more information, see [ Specifying a customer managed key for Lambda](https://docs.aws.amazon.com/lambda/latest/dg/encrypt-zip-package.html#enable-zip-custom-encryption).
+ The optimized version of the container image that's used for function invocations. Note that this is not the same key that's used to protect your container image in the Amazon Elastic Container Registry (Amazon ECR). For more information, see [Function lifecycle](https://docs.aws.amazon.com/lambda/latest/dg/images-create.html#images-lifecycle).
If you don't provide a customer managed key, Lambda uses an [AWS owned key](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-owned-cmk) or an [AWS managed key](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk).  
Type: String  
Pattern: `(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()`   
Required: No

 ** [Layers](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-Layers"></a>
A list of [function layers](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html) to add to the function's execution environment. Specify each layer by its ARN, including the version.  
Type: Array of strings  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+:[0-9]+`   
Required: No

 ** [LoggingConfig](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-LoggingConfig"></a>
The function's Amazon CloudWatch Logs configuration settings.  
Type: [LoggingConfig](API_LoggingConfig.md) object  
Required: No

 ** [MemorySize](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-MemorySize"></a>
The amount of [memory available to the function](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-memory-console) 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.  
Type: Integer  
Valid Range: Minimum value of 128. Maximum value of 32768.  
Required: No

 ** [RevisionId](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-RevisionId"></a>
Update the function only if the revision ID matches the ID that's specified. Use this option to avoid modifying a function that has changed since you last read it.  
Type: String  
Required: No

 ** [Role](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-Role"></a>
The Amazon Resource Name (ARN) of the function's execution role.  
Type: String  
Pattern: `arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`   
Required: No

 ** [Runtime](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-Runtime"></a>
The identifier of the function's [ runtime](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html). Runtime is required if the deployment package is a .zip file archive. Specifying a runtime results in an error if you're deploying a function using a container image.  
The following list includes deprecated runtimes. Lambda blocks creating new functions and updating existing functions shortly after each runtime is deprecated. For more information, see [Runtime use after deprecation](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-deprecation-levels).  
For a list of all currently supported runtimes, see [Supported runtimes](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtimes-supported).  
Type: String  
Valid Values: `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 | nodejs24.x | python3.14 | java25 | dotnet10`   
Required: No

 ** [SnapStart](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-SnapStart"></a>
The function's [SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html) setting.  
Type: [SnapStart](API_SnapStart.md) object  
Required: No

 ** [Timeout](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-Timeout"></a>
The amount of time (in seconds) that Lambda allows a function to run before stopping it. The default is 3 seconds. The maximum allowed value is 900 seconds. For more information, see [Lambda execution environment](https://docs.aws.amazon.com/lambda/latest/dg/runtimes-context.html).  
Type: Integer  
Valid Range: Minimum value of 1.  
Required: No

 ** [TracingConfig](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-TracingConfig"></a>
Set `Mode` to `Active` to sample and trace a subset of incoming requests with [X-Ray](https://docs.aws.amazon.com/lambda/latest/dg/services-xray.html).  
Type: [TracingConfig](API_TracingConfig.md) object  
Required: No

 ** [VpcConfig](#API_UpdateFunctionConfiguration_RequestSyntax) **   <a name="lambda-UpdateFunctionConfiguration-request-VpcConfig"></a>
For network connectivity to AWS resources in a VPC, specify a list of security groups and subnets in the VPC. When you connect a function to a VPC, it can access resources and the internet only through that VPC. For more information, see [Configuring a Lambda function to access resources in a VPC](https://docs.aws.amazon.com/lambda/latest/dg/configuration-vpc.html).  
Type: [VpcConfig](API_VpcConfig.md) object  
Required: No

## Response Syntax
<a name="API_UpdateFunctionConfiguration_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Architectures": [ "string" ],
   "CapacityProviderConfig": { 
      "LambdaManagedInstancesCapacityProviderConfig": { 
         "CapacityProviderArn": "string",
         "ExecutionEnvironmentMemoryGiBPerVCpu": number,
         "PerExecutionEnvironmentMaxConcurrency": number
      }
   },
   "CodeSha256": "string",
   "CodeSize": number,
   "ConfigSha256": "string",
   "DeadLetterConfig": { 
      "TargetArn": "string"
   },
   "Description": "string",
   "DurableConfig": { 
      "ExecutionTimeout": number,
      "RetentionPeriodInDays": number
   },
   "Environment": { 
      "Error": { 
         "ErrorCode": "string",
         "Message": "string"
      },
      "Variables": { 
         "string" : "string" 
      }
   },
   "EphemeralStorage": { 
      "Size": number
   },
   "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"
      }
   ],
   "LoggingConfig": { 
      "ApplicationLogLevel": "string",
      "LogFormat": "string",
      "LogGroup": "string",
      "SystemLogLevel": "string"
   },
   "MasterArn": "string",
   "MemorySize": number,
   "PackageType": "string",
   "RevisionId": "string",
   "Role": "string",
   "Runtime": "string",
   "RuntimeVersionConfig": { 
      "Error": { 
         "ErrorCode": "string",
         "Message": "string"
      },
      "RuntimeVersionArn": "string"
   },
   "SigningJobArn": "string",
   "SigningProfileVersionArn": "string",
   "SnapStart": { 
      "ApplyOn": "string",
      "OptimizationStatus": "string"
   },
   "State": "string",
   "StateReason": "string",
   "StateReasonCode": "string",
   "TenancyConfig": { 
      "TenantIsolationMode": "string"
   },
   "Timeout": number,
   "TracingConfig": { 
      "Mode": "string"
   },
   "Version": "string",
   "VpcConfig": { 
      "Ipv6AllowedForDualStack": boolean,
      "SecurityGroupIds": [ "string" ],
      "SubnetIds": [ "string" ],
      "VpcId": "string"
   }
}
```

## Response Elements
<a name="API_UpdateFunctionConfiguration_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [Architectures](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-Architectures"></a>
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`.  
Type: Array of strings  
Array Members: Fixed number of 1 item.  
Valid Values: `x86_64 | arm64` 

 ** [CapacityProviderConfig](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-CapacityProviderConfig"></a>
Configuration for the capacity provider that manages compute resources for Lambda functions.  
Type: [CapacityProviderConfig](API_CapacityProviderConfig.md) object

 ** [CodeSha256](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-CodeSha256"></a>
The SHA256 hash of the function's deployment package.  
Type: String

 ** [CodeSize](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-CodeSize"></a>
The size of the function's deployment package, in bytes.  
Type: Long

 ** [ConfigSha256](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-ConfigSha256"></a>
The SHA256 hash of the function configuration.  
Type: String

 ** [DeadLetterConfig](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-DeadLetterConfig"></a>
The function's dead letter queue.  
Type: [DeadLetterConfig](API_DeadLetterConfig.md) object

 ** [Description](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-Description"></a>
The function's description.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 256.

 ** [DurableConfig](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-DurableConfig"></a>
The function's durable execution configuration settings, if the function is configured for durability.  
Type: [DurableConfig](API_DurableConfig.md) object

 ** [Environment](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-Environment"></a>
The function's [environment variables](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html). Omitted from AWS CloudTrail logs.  
Type: [EnvironmentResponse](API_EnvironmentResponse.md) object

 ** [EphemeralStorage](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-EphemeralStorage"></a>
The size of the function's `/tmp` directory in MB. The default value is 512, but can be any whole number between 512 and 10,240 MB. For more information, see [Configuring ephemeral storage (console)](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-ephemeral-storage).  
Type: [EphemeralStorage](API_EphemeralStorage.md) object

 ** [FileSystemConfigs](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-FileSystemConfigs"></a>
Connection settings for an [Amazon EFS file system](https://docs.aws.amazon.com/lambda/latest/dg/configuration-filesystem.html) or an [Amazon S3 Files file system](https://docs.aws.amazon.com/lambda/latest/dg/configuration-filesystem.html).  
Type: Array of [FileSystemConfig](API_FileSystemConfig.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 1 item.

 ** [FunctionArn](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-FunctionArn"></a>
The function's Amazon Resource Name (ARN).  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 10000.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_\.]+(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?` 

 ** [FunctionName](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-FunctionName"></a>
The name of the function.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?` 

 ** [Handler](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-Handler"></a>
The function that Lambda calls to begin running your function.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 128.  
Pattern: `[^\s]+` 

 ** [ImageConfigResponse](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-ImageConfigResponse"></a>
The function's image configuration values.  
Type: [ImageConfigResponse](API_ImageConfigResponse.md) object

 ** [KMSKeyArn](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-KMSKeyArn"></a>
The ARN of the AWS Key Management Service (AWS KMS) customer managed key that's used to encrypt the following resources:  
+ The function's [environment variables](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html#configuration-envvars-encryption).
+ The function's [Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart-security.html) snapshots.
+ When used with `SourceKMSKeyArn`, the unzipped version of the .zip deployment package that's used for function invocations. For more information, see [ Specifying a customer managed key for Lambda](https://docs.aws.amazon.com/lambda/latest/dg/encrypt-zip-package.html#enable-zip-custom-encryption).
+ The optimized version of the container image that's used for function invocations. Note that this is not the same key that's used to protect your container image in the Amazon Elastic Container Registry (Amazon ECR). For more information, see [Function lifecycle](https://docs.aws.amazon.com/lambda/latest/dg/images-create.html#images-lifecycle).
If you don't provide a customer managed key, Lambda uses an [AWS owned key](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-owned-cmk) or an [AWS managed key](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk).  
Type: String  
Pattern: `(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()` 

 ** [LastModified](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-LastModified"></a>
The date and time that the function was last updated, in [ISO-8601 format](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD).  
Type: String

 ** [LastUpdateStatus](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-LastUpdateStatus"></a>
The status of the last update that was performed on the function. This is first set to `Successful` after function creation completes.  
Type: String  
Valid Values: `Successful | Failed | InProgress` 

 ** [LastUpdateStatusReason](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-LastUpdateStatusReason"></a>
The reason for the last update that was performed on the function.  
Type: String

 ** [LastUpdateStatusReasonCode](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-LastUpdateStatusReasonCode"></a>
The reason code for the last update that was performed on the function.  
Type: String  
Valid Values: `EniLimitExceeded | InsufficientRolePermissions | InvalidConfiguration | InternalError | SubnetOutOfIPAddresses | InvalidSubnet | InvalidSecurityGroup | ImageDeleted | ImageAccessDenied | InvalidImage | KMSKeyAccessDenied | KMSKeyNotFound | InvalidStateKMSKey | DisabledKMSKey | EFSIOError | EFSMountConnectivityError | EFSMountFailure | EFSMountTimeout | InvalidRuntime | InvalidZipFileException | FunctionError | VcpuLimitExceeded | CapacityProviderScalingLimitExceeded | InsufficientCapacity | EC2RequestLimitExceeded | FunctionError.InitTimeout | FunctionError.RuntimeInitError | FunctionError.ExtensionInitError | FunctionError.InvalidEntryPoint | FunctionError.InvalidWorkingDirectory | FunctionError.PermissionDenied | FunctionError.TooManyExtensions | FunctionError.InitResourceExhausted | DisallowedByVpcEncryptionControl` 

 ** [Layers](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-Layers"></a>
The function's [layers](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html).  
Type: Array of [Layer](API_Layer.md) objects

 ** [LoggingConfig](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-LoggingConfig"></a>
The function's Amazon CloudWatch Logs configuration settings.  
Type: [LoggingConfig](API_LoggingConfig.md) object

 ** [MasterArn](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-MasterArn"></a>
For Lambda@Edge functions, the ARN of the main function.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 10000.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?` 

 ** [MemorySize](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-MemorySize"></a>
The amount of memory available to the function at runtime.  
Type: Integer  
Valid Range: Minimum value of 128. Maximum value of 32768.

 ** [PackageType](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-PackageType"></a>
The type of deployment package. Set to `Image` for container image and set `Zip` for .zip file archive.  
Type: String  
Valid Values: `Zip | Image` 

 ** [RevisionId](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-RevisionId"></a>
The latest updated revision of the function or alias.  
Type: String

 ** [Role](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-Role"></a>
The function's execution role.  
Type: String  
Pattern: `arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 

 ** [Runtime](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-Runtime"></a>
The identifier of the function's [ runtime](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html). Runtime is required if the deployment package is a .zip file archive. Specifying a runtime results in an error if you're deploying a function using a container image.  
The following list includes deprecated runtimes. Lambda blocks creating new functions and updating existing functions shortly after each runtime is deprecated. For more information, see [Runtime use after deprecation](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-deprecation-levels).  
For a list of all currently supported runtimes, see [Supported runtimes](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtimes-supported).  
Type: String  
Valid Values: `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 | nodejs24.x | python3.14 | java25 | dotnet10` 

 ** [RuntimeVersionConfig](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-RuntimeVersionConfig"></a>
The ARN of the runtime and any errors that occured.  
Type: [RuntimeVersionConfig](API_RuntimeVersionConfig.md) object

 ** [SigningJobArn](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-SigningJobArn"></a>
The ARN of the signing job.  
Type: String  
Pattern: `arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` 

 ** [SigningProfileVersionArn](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-SigningProfileVersionArn"></a>
The ARN of the signing profile version.  
Type: String  
Pattern: `arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` 

 ** [SnapStart](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-SnapStart"></a>
Set `ApplyOn` to `PublishedVersions` to create a snapshot of the initialized execution environment when you publish a function version. For more information, see [Improving startup performance with Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html).  
Type: [SnapStartResponse](API_SnapStartResponse.md) object

 ** [State](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-State"></a>
The current state of the function. When the state is `Inactive`, you can reactivate the function by invoking it.  
Type: String  
Valid Values: `Pending | Active | Inactive | Failed | Deactivating | Deactivated | ActiveNonInvocable | Deleting` 

 ** [StateReason](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-StateReason"></a>
The reason for the function's current state.  
Type: String

 ** [StateReasonCode](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-StateReasonCode"></a>
The reason code for the function's current state. When the code is `Creating`, you can't invoke or modify the function.  
Type: String  
Valid Values: `Idle | Creating | Restoring | EniLimitExceeded | InsufficientRolePermissions | InvalidConfiguration | InternalError | SubnetOutOfIPAddresses | InvalidSubnet | InvalidSecurityGroup | ImageDeleted | ImageAccessDenied | InvalidImage | KMSKeyAccessDenied | KMSKeyNotFound | InvalidStateKMSKey | DisabledKMSKey | EFSIOError | EFSMountConnectivityError | EFSMountFailure | EFSMountTimeout | InvalidRuntime | InvalidZipFileException | FunctionError | DrainingDurableExecutions | VcpuLimitExceeded | CapacityProviderScalingLimitExceeded | InsufficientCapacity | EC2RequestLimitExceeded | FunctionError.InitTimeout | FunctionError.RuntimeInitError | FunctionError.ExtensionInitError | FunctionError.InvalidEntryPoint | FunctionError.InvalidWorkingDirectory | FunctionError.PermissionDenied | FunctionError.TooManyExtensions | FunctionError.InitResourceExhausted | DisallowedByVpcEncryptionControl` 

 ** [TenancyConfig](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-TenancyConfig"></a>
The function's tenant isolation configuration settings. Determines whether the Lambda function runs on a shared or dedicated infrastructure per unique tenant.  
Type: [TenancyConfig](API_TenancyConfig.md) object

 ** [Timeout](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-Timeout"></a>
The amount of time in seconds that Lambda allows a function to run before stopping it.  
Type: Integer  
Valid Range: Minimum value of 1.

 ** [TracingConfig](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-TracingConfig"></a>
The function's AWS X-Ray tracing configuration.  
Type: [TracingConfigResponse](API_TracingConfigResponse.md) object

 ** [Version](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-Version"></a>
The version of the Lambda function.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Pattern: `(\$LATEST|[0-9]+)` 

 ** [VpcConfig](#API_UpdateFunctionConfiguration_ResponseSyntax) **   <a name="lambda-UpdateFunctionConfiguration-response-VpcConfig"></a>
The function's networking configuration.  
Type: [VpcConfigResponse](API_VpcConfigResponse.md) object

## Errors
<a name="API_UpdateFunctionConfiguration_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** CodeSigningConfigNotFoundException **   
The specified code signing configuration does not exist.  
HTTP Status Code: 404

 ** CodeVerificationFailedException **   
The code signature failed one or more of the validation checks for signature mismatch or expiry, and the code signing policy is set to ENFORCE. Lambda blocks the deployment.  
HTTP Status Code: 400

 ** InvalidCodeSignatureException **   
The code signature failed the integrity check. If the integrity check fails, then Lambda blocks deployment, even if the code signing policy is set to WARN.  
HTTP Status Code: 400

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** PreconditionFailedException **   
The RevisionId provided does not match the latest RevisionId for the Lambda function or alias.  
+  **For AddPermission and RemovePermission API operations:** Call `GetPolicy` to retrieve the latest RevisionId for your resource.
+  **For all other API operations:** Call `GetFunction` or `GetAlias` to retrieve the latest RevisionId for your resource.  
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 412

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_UpdateFunctionConfiguration_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/UpdateFunctionConfiguration) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/UpdateFunctionConfiguration) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/UpdateFunctionConfiguration) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/UpdateFunctionConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/UpdateFunctionConfiguration) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/UpdateFunctionConfiguration) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/UpdateFunctionConfiguration) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/UpdateFunctionConfiguration) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/UpdateFunctionConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/UpdateFunctionConfiguration) 

# UpdateFunctionEventInvokeConfig
<a name="API_UpdateFunctionEventInvokeConfig"></a>

Updates the configuration for asynchronous invocation for a function, version, or alias.

To configure options for asynchronous invocation, use [PutFunctionEventInvokeConfig](API_PutFunctionEventInvokeConfig.md).

## Request Syntax
<a name="API_UpdateFunctionEventInvokeConfig_RequestSyntax"></a>

```
POST /2019-09-25/functions/FunctionName/event-invoke-config?Qualifier=Qualifier HTTP/1.1
Content-type: application/json

{
   "DestinationConfig": { 
      "OnFailure": { 
         "Destination": "string"
      },
      "OnSuccess": { 
         "Destination": "string"
      }
   },
   "MaximumEventAgeInSeconds": number,
   "MaximumRetryAttempts": number
}
```

## URI Request Parameters
<a name="API_UpdateFunctionEventInvokeConfig_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_UpdateFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-UpdateFunctionEventInvokeConfig-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?`   
Required: Yes

 ** [Qualifier](#API_UpdateFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-UpdateFunctionEventInvokeConfig-request-uri-Qualifier"></a>
A version number or alias name.  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `\$(LATEST(\.PUBLISHED)?)|[a-zA-Z0-9-_$]+` 

## Request Body
<a name="API_UpdateFunctionEventInvokeConfig_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [DestinationConfig](#API_UpdateFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-UpdateFunctionEventInvokeConfig-request-DestinationConfig"></a>
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 a standard SQS queue.
+  **Bucket** - The ARN of an Amazon S3 bucket.
+  **Topic** - The ARN of a standard SNS topic.
+  **Event Bus** - The ARN of an Amazon EventBridge event bus.
S3 buckets are supported only for on-failure destinations. To retain records of successful invocations, use another destination type.
Type: [DestinationConfig](API_DestinationConfig.md) object  
Required: No

 ** [MaximumEventAgeInSeconds](#API_UpdateFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-UpdateFunctionEventInvokeConfig-request-MaximumEventAgeInSeconds"></a>
The maximum age of a request that Lambda sends to a function for processing.  
Type: Integer  
Valid Range: Minimum value of 60. Maximum value of 21600.  
Required: No

 ** [MaximumRetryAttempts](#API_UpdateFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-UpdateFunctionEventInvokeConfig-request-MaximumRetryAttempts"></a>
The maximum number of times to retry when the function returns an error.  
Type: Integer  
Valid Range: Minimum value of 0. Maximum value of 2.  
Required: No

## Response Syntax
<a name="API_UpdateFunctionEventInvokeConfig_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "DestinationConfig": { 
      "OnFailure": { 
         "Destination": "string"
      },
      "OnSuccess": { 
         "Destination": "string"
      }
   },
   "FunctionArn": "string",
   "LastModified": number,
   "MaximumEventAgeInSeconds": number,
   "MaximumRetryAttempts": number
}
```

## Response Elements
<a name="API_UpdateFunctionEventInvokeConfig_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [DestinationConfig](#API_UpdateFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-UpdateFunctionEventInvokeConfig-response-DestinationConfig"></a>
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 a standard SQS queue.
+  **Bucket** - The ARN of an Amazon S3 bucket.
+  **Topic** - The ARN of a standard SNS topic.
+  **Event Bus** - The ARN of an Amazon EventBridge event bus.
S3 buckets are supported only for on-failure destinations. To retain records of successful invocations, use another destination type.
Type: [DestinationConfig](API_DestinationConfig.md) object

 ** [FunctionArn](#API_UpdateFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-UpdateFunctionEventInvokeConfig-response-FunctionArn"></a>
The Amazon Resource Name (ARN) of the function.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 10000.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?` 

 ** [LastModified](#API_UpdateFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-UpdateFunctionEventInvokeConfig-response-LastModified"></a>
The date and time that the configuration was last updated, in Unix time seconds.  
Type: Timestamp

 ** [MaximumEventAgeInSeconds](#API_UpdateFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-UpdateFunctionEventInvokeConfig-response-MaximumEventAgeInSeconds"></a>
The maximum age of a request that Lambda sends to a function for processing.  
Type: Integer  
Valid Range: Minimum value of 60. Maximum value of 21600.

 ** [MaximumRetryAttempts](#API_UpdateFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-UpdateFunctionEventInvokeConfig-response-MaximumRetryAttempts"></a>
The maximum number of times to retry when the function returns an error.  
Type: Integer  
Valid Range: Minimum value of 0. Maximum value of 2.

## Errors
<a name="API_UpdateFunctionEventInvokeConfig_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_UpdateFunctionEventInvokeConfig_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/UpdateFunctionEventInvokeConfig) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/UpdateFunctionEventInvokeConfig) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/UpdateFunctionEventInvokeConfig) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/UpdateFunctionEventInvokeConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/UpdateFunctionEventInvokeConfig) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/UpdateFunctionEventInvokeConfig) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/UpdateFunctionEventInvokeConfig) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/UpdateFunctionEventInvokeConfig) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/UpdateFunctionEventInvokeConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/UpdateFunctionEventInvokeConfig) 

# UpdateFunctionUrlConfig
<a name="API_UpdateFunctionUrlConfig"></a>

Updates the configuration for a Lambda function URL.

## Request Syntax
<a name="API_UpdateFunctionUrlConfig_RequestSyntax"></a>

```
PUT /2021-10-31/functions/FunctionName/url?Qualifier=Qualifier HTTP/1.1
Content-type: application/json

{
   "AuthType": "string",
   "Cors": { 
      "AllowCredentials": boolean,
      "AllowHeaders": [ "string" ],
      "AllowMethods": [ "string" ],
      "AllowOrigins": [ "string" ],
      "ExposeHeaders": [ "string" ],
      "MaxAge": number
   },
   "InvokeMode": "string"
}
```

## URI Request Parameters
<a name="API_UpdateFunctionUrlConfig_RequestParameters"></a>

The request uses the following URI parameters.

 ** [FunctionName](#API_UpdateFunctionUrlConfig_RequestSyntax) **   <a name="lambda-UpdateFunctionUrlConfig-request-uri-FunctionName"></a>
The name or ARN 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.  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?`   
Required: Yes

 ** [Qualifier](#API_UpdateFunctionUrlConfig_RequestSyntax) **   <a name="lambda-UpdateFunctionUrlConfig-request-uri-Qualifier"></a>
The alias name.  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `((?!^\d+$)^[0-9a-zA-Z-_]+$)` 

## Request Body
<a name="API_UpdateFunctionUrlConfig_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [AuthType](#API_UpdateFunctionUrlConfig_RequestSyntax) **   <a name="lambda-UpdateFunctionUrlConfig-request-AuthType"></a>
The type of authentication that your function URL uses. Set to `AWS_IAM` if you want to restrict access to authenticated users only. Set to `NONE` if you want to bypass IAM authentication to create a public endpoint. For more information, see [Control access to Lambda function URLs](https://docs.aws.amazon.com/lambda/latest/dg/urls-auth.html).  
Type: String  
Valid Values: `NONE | AWS_IAM`   
Required: No

 ** [Cors](#API_UpdateFunctionUrlConfig_RequestSyntax) **   <a name="lambda-UpdateFunctionUrlConfig-request-Cors"></a>
The [cross-origin resource sharing (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) settings for your function URL.  
Type: [Cors](API_Cors.md) object  
Required: No

 ** [InvokeMode](#API_UpdateFunctionUrlConfig_RequestSyntax) **   <a name="lambda-UpdateFunctionUrlConfig-request-InvokeMode"></a>
Use one of the following options:  
+  `BUFFERED` – This is the default option. Lambda invokes your function using the `Invoke` API operation. Invocation results are available when the payload is complete. The maximum payload size is 6 MB.
+  `RESPONSE_STREAM` – Your function streams payload results as they become available. Lambda invokes your function using the `InvokeWithResponseStream` API operation. The maximum response payload size is 200 MB.
Type: String  
Valid Values: `BUFFERED | RESPONSE_STREAM`   
Required: No

## Response Syntax
<a name="API_UpdateFunctionUrlConfig_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AuthType": "string",
   "Cors": { 
      "AllowCredentials": boolean,
      "AllowHeaders": [ "string" ],
      "AllowMethods": [ "string" ],
      "AllowOrigins": [ "string" ],
      "ExposeHeaders": [ "string" ],
      "MaxAge": number
   },
   "CreationTime": "string",
   "FunctionArn": "string",
   "FunctionUrl": "string",
   "InvokeMode": "string",
   "LastModifiedTime": "string"
}
```

## Response Elements
<a name="API_UpdateFunctionUrlConfig_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [AuthType](#API_UpdateFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-UpdateFunctionUrlConfig-response-AuthType"></a>
The type of authentication that your function URL uses. Set to `AWS_IAM` if you want to restrict access to authenticated users only. Set to `NONE` if you want to bypass IAM authentication to create a public endpoint. For more information, see [Control access to Lambda function URLs](https://docs.aws.amazon.com/lambda/latest/dg/urls-auth.html).  
Type: String  
Valid Values: `NONE | AWS_IAM` 

 ** [Cors](#API_UpdateFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-UpdateFunctionUrlConfig-response-Cors"></a>
The [cross-origin resource sharing (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) settings for your function URL.  
Type: [Cors](API_Cors.md) object

 ** [CreationTime](#API_UpdateFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-UpdateFunctionUrlConfig-response-CreationTime"></a>
When the function URL was created, in [ISO-8601 format](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD).  
Type: String

 ** [FunctionArn](#API_UpdateFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-UpdateFunctionUrlConfig-response-FunctionArn"></a>
The Amazon Resource Name (ARN) of your function.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 10000.  
Pattern: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?` 

 ** [FunctionUrl](#API_UpdateFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-UpdateFunctionUrlConfig-response-FunctionUrl"></a>
The HTTP URL endpoint for your function.  
Type: String  
Length Constraints: Minimum length of 40. Maximum length of 100.

 ** [InvokeMode](#API_UpdateFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-UpdateFunctionUrlConfig-response-InvokeMode"></a>
Use one of the following options:  
+  `BUFFERED` – This is the default option. Lambda invokes your function using the `Invoke` API operation. Invocation results are available when the payload is complete. The maximum payload size is 6 MB.
+  `RESPONSE_STREAM` – Your function streams payload results as they become available. Lambda invokes your function using the `InvokeWithResponseStream` API operation. The maximum response payload size is 200 MB.
Type: String  
Valid Values: `BUFFERED | RESPONSE_STREAM` 

 ** [LastModifiedTime](#API_UpdateFunctionUrlConfig_ResponseSyntax) **   <a name="lambda-UpdateFunctionUrlConfig-response-LastModifiedTime"></a>
When the function URL configuration was last updated, in [ISO-8601 format](https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ss.sTZD).  
Type: String

## Errors
<a name="API_UpdateFunctionUrlConfig_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterValueException **   
One of the parameters in the request is not valid.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 400

 ** ResourceConflictException **   
The resource already exists, or another operation is in progress.    
 ** message **   
The exception message.  
 ** Type **   
The exception type.
HTTP Status Code: 409

 ** ResourceNotFoundException **   
The resource specified in the request does not exist.  
HTTP Status Code: 404

 ** ServiceException **   
The AWS Lambda service encountered an internal error.  
HTTP Status Code: 500

 ** TooManyRequestsException **   
The request throughput limit was exceeded. For more information, see [Lambda quotas](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).    
 ** retryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 429

## See Also
<a name="API_UpdateFunctionUrlConfig_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/lambda-2015-03-31/UpdateFunctionUrlConfig) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lambda-2015-03-31/UpdateFunctionUrlConfig) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/UpdateFunctionUrlConfig) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lambda-2015-03-31/UpdateFunctionUrlConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/UpdateFunctionUrlConfig) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/UpdateFunctionUrlConfig) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lambda-2015-03-31/UpdateFunctionUrlConfig) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/UpdateFunctionUrlConfig) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/UpdateFunctionUrlConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/UpdateFunctionUrlConfig)