Skip to content

Latest commit

 

History

History
88 lines (62 loc) · 3.46 KB

API_InvokeAsync.md

File metadata and controls

88 lines (62 loc) · 3.46 KB

InvokeAsync

This action has been deprecated.

Important
For asynchronous function invocation, use Invoke.

Invokes a function asynchronously.

Request Syntax

POST /2014-11-13/functions/FunctionName/invoke-async/ HTTP/1.1

InvokeArgs

URI Request Parameters

The request uses the following URI parameters.

** FunctionName ** The name of the Lambda function.

Name formats

  • Function name - my-function.
  • Function ARN - arn:aws:lambda:us-west-2:123456789012:function:my-function.
  • Partial ARN - 123456789012:function:my-function. The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.
    Length Constraints: Minimum length of 1. Maximum length of 170.
    Pattern: (arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}(-gov)?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?
    Required: Yes

Request Body

The request accepts the following binary data.

** InvokeArgs ** The JSON that you want to provide to your Lambda function as input.
Required: Yes

Response Syntax

HTTP/1.1 Status

Response Elements

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

** Status ** The status code.

Errors

** InvalidRequestContentException **
The request body could not be parsed as JSON.
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.
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

For more information about using this API in one of the language-specific AWS SDKs, see the following: