Documentation for new feature: Lambda functions on Graviton2

doc_source/API_CreateEventSourceMapping.md

@@ -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\.
@@ -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>
 
 ```

doc_source/API_CreateFunction.md

@@ -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)\.
 
@@ -25,6 +25,7 @@ POST /2015-03-31/functions HTTP/1.1
 Content-type: application/json
 
 {
+   "Architectures": [ "string" ],
    "Code": { 
       "ImageUri": "string",
       "S3Bucket": "string",
@@ -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  
@@ -213,6 +221,7 @@ HTTP/1.1 201
 Content-type: application/json
 
 {
+   "Architectures": [ "string" ],
    "CodeSha256": "string",
    "CodeSize": number,
    "DeadLetterConfig": { 
@@ -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
@@ -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-.]+:.*)|()` 
 
@@ -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-_]+))?` 
 

doc_source/API_FunctionConfiguration.md

@@ -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  
@@ -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
@@ -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

doc_source/API_GetFunction.md

@@ -50,6 +50,7 @@ Content-type: application/json
       "ReservedConcurrentExecutions": number
    },
    "Configuration": { 
+      "Architectures": [ "string" ],
       "CodeSha256": "string",
       "CodeSize": number,
       "DeadLetterConfig": { 

doc_source/API_GetFunctionConfiguration.md

@@ -42,6 +42,7 @@ HTTP/1.1 200
 Content-type: application/json
 
 {
+   "Architectures": [ "string" ],
    "CodeSha256": "string",
    "CodeSize": number,
    "DeadLetterConfig": { 
@@ -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
@@ -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-.]+:.*)|()` 
 
@@ -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-_]+))?` 
 

doc_source/API_GetLayerVersion.md

@@ -33,6 +33,7 @@ HTTP/1.1 200
 Content-type: application/json
 
 {
+   "CompatibleArchitectures": [ "string" ],
    "CompatibleRuntimes": [ "string" ],
    "Content": { 
       "CodeSha256": "string",
@@ -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  

doc_source/API_GetLayerVersionByArn.md

@@ -29,6 +29,7 @@ HTTP/1.1 200
 Content-type: application/json
 
 {
+   "CompatibleArchitectures": [ "string" ],
    "CompatibleRuntimes": [ "string" ],
    "Content": { 
       "CodeSha256": "string",
@@ -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  

doc_source/API_LayerVersionsListItem.md

@@ -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  

doc_source/API_ListFunctions.md

@@ -45,6 +45,7 @@ Content-type: application/json
 {
    "Functions": [ 
       { 
+         "Architectures": [ "string" ],
          "CodeSha256": "string",
          "CodeSize": number,
          "DeadLetterConfig": { 

doc_source/API_ListLayerVersions.md

@@ -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` 
@@ -42,6 +46,7 @@ Content-type: application/json
 {
    "LayerVersions": [ 
       { 
+         "CompatibleArchitectures": [ "string" ],
          "CompatibleRuntimes": [ "string" ],
          "CreatedDate": "string",
          "Description": "string",

doc_source/API_ListLayers.md

@@ -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` 
@@ -37,6 +41,7 @@ Content-type: application/json
    "Layers": [ 
       { 
          "LatestMatchingVersion": { 
+            "CompatibleArchitectures": [ "string" ],
             "CompatibleRuntimes": [ "string" ],
             "CreatedDate": "string",
             "Description": "string",

doc_source/API_ListVersionsByFunction.md

@@ -45,6 +45,7 @@ Content-type: application/json
    "NextMarker": "string",
    "Versions": [ 
       { 
+         "Architectures": [ "string" ],
          "CodeSha256": "string",
          "CodeSize": number,
          "DeadLetterConfig": {