Skip to content

Commit

Permalink
Documentation for new feature: Lambda functions on Graviton2
Browse files Browse the repository at this point in the history
  • Loading branch information
devlinbd2 committed Sep 30, 2021
1 parent c70b3a8 commit 640845b
Show file tree
Hide file tree
Showing 103 changed files with 1,665 additions and 859 deletions.
22 changes: 15 additions & 7 deletions doc_source/API_CreateEventSourceMapping.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,13 +2,13 @@

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

For details about each event source type, see the following topics\.
+ [ Configuring a Dynamo DB stream as an event source](https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html#services-dynamodb-eventsourcemapping)
+ [ Configuring a Kinesis stream as an event source](https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html#services-kinesis-eventsourcemapping)
+ [ Configuring an Amazon SQS queue as an event source](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#events-sqs-eventsource)
+ [ Configuring an MQ broker as an event source](https://docs.aws.amazon.com/lambda/latest/dg/with-mq.html#services-mq-eventsourcemapping)
+ [ Configuring MSK as an event source](https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html)
+ [ Configuring Self\-Managed Apache Kafka as an event source](https://docs.aws.amazon.com/lambda/latest/dg/kafka-smaa.html)
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)

The following error handling options are only available for stream sources \(DynamoDB and Kinesis\):
+ `BisectBatchOnFunctionError` \- If the function returns an error, split the batch in two and retry\.
Expand All @@ -17,6 +17,14 @@ The following error handling options are only available for stream sources \(Dyn
+ `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\.
+ `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)

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

```
Expand Down
21 changes: 18 additions & 3 deletions doc_source/API_CreateFunction.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ Creates a Lambda function\. To create a function, you need a [deployment package

You set the package type to `Image` if the deployment package is a [container image](https://docs.aws.amazon.com/lambda/latest/dg/lambda-images.html)\. 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\.

You set the package type to `Zip` if the deployment package is a [\.zip file archive](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-package.html#gettingstarted-package-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\.
You set the package type to `Zip` if the deployment package is a [\.zip file archive](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-package.html#gettingstarted-package-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, 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 [Function States](https://docs.aws.amazon.com/lambda/latest/dg/functions-states.html)\.

Expand All @@ -25,6 +25,7 @@ POST /2015-03-31/functions HTTP/1.1
Content-type: application/json
{
"Architectures": [ "string" ],
"Code": {
"ImageUri": "string",
"S3Bucket": "string",
Expand Down Expand Up @@ -84,6 +85,13 @@ The request does not use any URI parameters\.

The request accepts the following data in JSON format\.

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

** [ Code ](#API_CreateFunction_RequestSyntax) ** <a name="SSS-CreateFunction-request-Code"></a>
The code for the function\.
Type: [ FunctionCode ](API_FunctionCode.md) object
Expand Down Expand Up @@ -213,6 +221,7 @@ HTTP/1.1 201
Content-type: application/json
{
"Architectures": [ "string" ],
"CodeSha256": "string",
"CodeSize": number,
"DeadLetterConfig": {
Expand Down Expand Up @@ -291,6 +300,12 @@ 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="SSS-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`

** [ CodeSha256 ](#API_CreateFunction_ResponseSyntax) ** <a name="SSS-CreateFunction-response-CodeSha256"></a>
The SHA256 hash of the function's deployment package\.
Type: String
Expand Down Expand Up @@ -339,7 +354,7 @@ The function's image configuration values\.
Type: [ ImageConfigResponse ](API_ImageConfigResponse.md) object

** [ KMSKeyArn ](#API_CreateFunction_ResponseSyntax) ** <a name="SSS-CreateFunction-response-KMSKeyArn"></a>
The KMS key that's used to encrypt the function's environment variables\. This key is only returned if you've configured a customer managed CMK\.
The AWS KMS key that's used to encrypt the function's environment variables\. This key is only returned if you've configured a customer managed key\.
Type: String
Pattern: `(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()`

Expand All @@ -366,7 +381,7 @@ The function's [ layers](https://docs.aws.amazon.com/lambda/latest/dg/configurat
Type: Array of [ Layer ](API_Layer.md) objects

** [ MasterArn ](#API_CreateFunction_ResponseSyntax) ** <a name="SSS-CreateFunction-response-MasterArn"></a>
For Lambda@Edge functions, the ARN of the master function\.
For Lambda@Edge functions, the ARN of the main function\.
Type: String
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-_]+))?`

Expand Down
11 changes: 9 additions & 2 deletions doc_source/API_FunctionConfiguration.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,13 @@ Details about a function's configuration\.

## Contents<a name="API_FunctionConfiguration_Contents"></a>

** Architectures ** <a name="SSS-Type-FunctionConfiguration-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`
Required: No

** CodeSha256 ** <a name="SSS-Type-FunctionConfiguration-CodeSha256"></a>
The SHA256 hash of the function's deployment package\.
Type: String
Expand Down Expand Up @@ -62,7 +69,7 @@ Type: [ ImageConfigResponse ](API_ImageConfigResponse.md) object
Required: No

** KMSKeyArn ** <a name="SSS-Type-FunctionConfiguration-KMSKeyArn"></a>
The KMS key that's used to encrypt the function's environment variables\. This key is only returned if you've configured a customer managed CMK\.
The AWS KMS key that's used to encrypt the function's environment variables\. This key is only returned if you've configured a customer managed key\.
Type: String
Pattern: `(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()`
Required: No
Expand Down Expand Up @@ -95,7 +102,7 @@ Type: Array of [ Layer ](API_Layer.md) objects
Required: No

** MasterArn ** <a name="SSS-Type-FunctionConfiguration-MasterArn"></a>
For Lambda@Edge functions, the ARN of the master function\.
For Lambda@Edge functions, the ARN of the main function\.
Type: String
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: No
Expand Down
1 change: 1 addition & 0 deletions doc_source/API_GetFunction.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,7 @@ Content-type: application/json
"ReservedConcurrentExecutions": number
},
"Configuration": {
"Architectures": [ "string" ],
"CodeSha256": "string",
"CodeSize": number,
"DeadLetterConfig": {
Expand Down
11 changes: 9 additions & 2 deletions doc_source/API_GetFunctionConfiguration.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,7 @@ HTTP/1.1 200
Content-type: application/json
{
"Architectures": [ "string" ],
"CodeSha256": "string",
"CodeSize": number,
"DeadLetterConfig": {
Expand Down Expand Up @@ -120,6 +121,12 @@ 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="SSS-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`

** [ CodeSha256 ](#API_GetFunctionConfiguration_ResponseSyntax) ** <a name="SSS-GetFunctionConfiguration-response-CodeSha256"></a>
The SHA256 hash of the function's deployment package\.
Type: String
Expand Down Expand Up @@ -168,7 +175,7 @@ The function's image configuration values\.
Type: [ ImageConfigResponse ](API_ImageConfigResponse.md) object

** [ KMSKeyArn ](#API_GetFunctionConfiguration_ResponseSyntax) ** <a name="SSS-GetFunctionConfiguration-response-KMSKeyArn"></a>
The KMS key that's used to encrypt the function's environment variables\. This key is only returned if you've configured a customer managed CMK\.
The AWS KMS key that's used to encrypt the function's environment variables\. This key is only returned if you've configured a customer managed key\.
Type: String
Pattern: `(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()`

Expand All @@ -195,7 +202,7 @@ The function's [ layers](https://docs.aws.amazon.com/lambda/latest/dg/configurat
Type: Array of [ Layer ](API_Layer.md) objects

** [ MasterArn ](#API_GetFunctionConfiguration_ResponseSyntax) ** <a name="SSS-GetFunctionConfiguration-response-MasterArn"></a>
For Lambda@Edge functions, the ARN of the master function\.
For Lambda@Edge functions, the ARN of the main function\.
Type: String
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-_]+))?`

Expand Down
7 changes: 7 additions & 0 deletions doc_source/API_GetLayerVersion.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,7 @@ HTTP/1.1 200
Content-type: application/json
{
"CompatibleArchitectures": [ "string" ],
"CompatibleRuntimes": [ "string" ],
"Content": {
"CodeSha256": "string",
Expand All @@ -56,6 +57,12 @@ 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="SSS-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: Maximum number of 2 items\.
Valid Values:` x86_64 | arm64`

** [ CompatibleRuntimes ](#API_GetLayerVersion_ResponseSyntax) ** <a name="SSS-GetLayerVersion-response-CompatibleRuntimes"></a>
The layer's compatible runtimes\.
Type: Array of strings
Expand Down
7 changes: 7 additions & 0 deletions doc_source/API_GetLayerVersionByArn.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,7 @@ HTTP/1.1 200
Content-type: application/json
{
"CompatibleArchitectures": [ "string" ],
"CompatibleRuntimes": [ "string" ],
"Content": {
"CodeSha256": "string",
Expand All @@ -52,6 +53,12 @@ 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="SSS-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: Maximum number of 2 items\.
Valid Values:` x86_64 | arm64`

** [ CompatibleRuntimes ](#API_GetLayerVersionByArn_ResponseSyntax) ** <a name="SSS-GetLayerVersionByArn-response-CompatibleRuntimes"></a>
The layer's compatible runtimes\.
Type: Array of strings
Expand Down
7 changes: 7 additions & 0 deletions doc_source/API_LayerVersionsListItem.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,13 @@ Details about a version of an [ AWS Lambda layer](https://docs.aws.amazon.com/la

## Contents<a name="API_LayerVersionsListItem_Contents"></a>

** CompatibleArchitectures ** <a name="SSS-Type-LayerVersionsListItem-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: Maximum number of 2 items\.
Valid Values:` x86_64 | arm64`
Required: No

** CompatibleRuntimes ** <a name="SSS-Type-LayerVersionsListItem-CompatibleRuntimes"></a>
The layer's compatible runtimes\.
Type: Array of strings
Expand Down
1 change: 1 addition & 0 deletions doc_source/API_ListFunctions.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,6 +45,7 @@ Content-type: application/json
{
"Functions": [
{
"Architectures": [ "string" ],
"CodeSha256": "string",
"CodeSize": number,
"DeadLetterConfig": {
Expand Down
9 changes: 7 additions & 2 deletions doc_source/API_ListLayerVersions.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,21 @@
# 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\.
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?CompatibleRuntime=CompatibleRuntime&Marker=Marker&MaxItems=MaxItems HTTP/1.1
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="SSS-ListLayerVersions-request-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="SSS-ListLayerVersions-request-CompatibleRuntime"></a>
A runtime identifier\. For example, `go1.x`\.
Valid Values:` nodejs | nodejs4.3 | nodejs6.10 | nodejs8.10 | nodejs10.x | nodejs12.x | nodejs14.x | java8 | java8.al2 | java11 | python2.7 | python3.6 | python3.7 | python3.8 | python3.9 | dotnetcore1.0 | dotnetcore2.0 | dotnetcore2.1 | dotnetcore3.1 | nodejs4.3-edge | go1.x | ruby2.5 | ruby2.7 | provided | provided.al2`
Expand Down Expand Up @@ -42,6 +46,7 @@ Content-type: application/json
{
"LayerVersions": [
{
"CompatibleArchitectures": [ "string" ],
"CompatibleRuntimes": [ "string" ],
"CreatedDate": "string",
"Description": "string",
Expand Down
9 changes: 7 additions & 2 deletions doc_source/API_ListLayers.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,21 @@
# ListLayers<a name="API_ListLayers"></a>

Lists [ AWS Lambda layers](https://docs.aws.amazon.com/lambda/latest/dg/configuration-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\.
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?CompatibleRuntime=CompatibleRuntime&Marker=Marker&MaxItems=MaxItems HTTP/1.1
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="SSS-ListLayers-request-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="SSS-ListLayers-request-CompatibleRuntime"></a>
A runtime identifier\. For example, `go1.x`\.
Valid Values:` nodejs | nodejs4.3 | nodejs6.10 | nodejs8.10 | nodejs10.x | nodejs12.x | nodejs14.x | java8 | java8.al2 | java11 | python2.7 | python3.6 | python3.7 | python3.8 | python3.9 | dotnetcore1.0 | dotnetcore2.0 | dotnetcore2.1 | dotnetcore3.1 | nodejs4.3-edge | go1.x | ruby2.5 | ruby2.7 | provided | provided.al2`
Expand All @@ -37,6 +41,7 @@ Content-type: application/json
"Layers": [
{
"LatestMatchingVersion": {
"CompatibleArchitectures": [ "string" ],
"CompatibleRuntimes": [ "string" ],
"CreatedDate": "string",
"Description": "string",
Expand Down
1 change: 1 addition & 0 deletions doc_source/API_ListVersionsByFunction.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,6 +45,7 @@ Content-type: application/json
"NextMarker": "string",
"Versions": [
{
"Architectures": [ "string" ],
"CodeSha256": "string",
"CodeSize": number,
"DeadLetterConfig": {
Expand Down

0 comments on commit 640845b

Please sign in to comment.