Merge branch 'master' into master

doc_source/API_AccountLimit.md

@@ -1,31 +1,31 @@
 # AccountLimit<a name="API_AccountLimit"></a>
 
-Provides limits of code size and concurrency associated with the current account and region\. For more information or to request a limit increase for concurrent executions, see [Lambda Limits](https://docs.aws.amazon.com/lambda/latest/dg/limits.html)\. 
+Limits that are related to concurrency and code storage\. All file and storage sizes are in bytes\.
 
 ## Contents<a name="API_AccountLimit_Contents"></a>
 
  **CodeSizeUnzipped**   <a name="SSS-Type-AccountLimit-CodeSizeUnzipped"></a>
-Size, in bytes, of code/dependencies that you can zip into a deployment package \(uncompressed zip/jar size\) for uploading\. The default limit is 250 MB\.  
+The maximum size of your function's code and layers when they're extracted\.  
 Type: Long  
 Required: No
 
  **CodeSizeZipped**   <a name="SSS-Type-AccountLimit-CodeSizeZipped"></a>
-Size, in bytes, of a single zipped code/dependencies package you can upload for your Lambda function\(\.zip/\.jar file\)\. Try using Amazon S3 for uploading larger files\. Default limit is 50 MB\.  
+The maximum size of a deployment package when it's uploaded directly to AWS Lambda\. Use Amazon S3 for larger files\.  
 Type: Long  
 Required: No
 
  **ConcurrentExecutions**   <a name="SSS-Type-AccountLimit-ConcurrentExecutions"></a>
-Number of simultaneous executions of your function per region\. The default limit is 1000\.  
+The maximum number of simultaneous function executions\.  
 Type: Integer  
 Required: No
 
  **TotalCodeSize**   <a name="SSS-Type-AccountLimit-TotalCodeSize"></a>
-Maximum size, in bytes, of a code package you can upload per region\. The default size is 75 GB\.   
+The amount of storage space that you can use for all deployment packages and layer archives\.  
 Type: Long  
 Required: No
 
  **UnreservedConcurrentExecutions**   <a name="SSS-Type-AccountLimit-UnreservedConcurrentExecutions"></a>
-The number of concurrent executions available to functions that do not have concurrency limits set\. For more information, see [Managing Concurrency](https://docs.aws.amazon.com/lambda/latest/dg/concurrent-executions.html)\.  
+The maximum number of simultaneous function executions, minus the capacity that's reserved for individual functions with [PutFunctionConcurrency](API_PutFunctionConcurrency.md)\.  
 Type: Integer  
 Valid Range: Minimum value of 0\.  
 Required: No
@@ -35,5 +35,6 @@ Required: No
 For more information about using this API in one of the language\-specific AWS SDKs, see the following:
 +  [AWS SDK for C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/AccountLimit) 
 +  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/AccountLimit) 
++  [AWS SDK for Go \- Pilot](https://docs.aws.amazon.com/goto/SdkForGoPilot/lambda-2015-03-31/AccountLimit) 
 +  [AWS SDK for Java](https://docs.aws.amazon.com/goto/SdkForJava/lambda-2015-03-31/AccountLimit) 
 +  [AWS SDK for Ruby V2](https://docs.aws.amazon.com/goto/SdkForRubyV2/lambda-2015-03-31/AccountLimit) 

doc_source/API_AccountUsage.md

@@ -1,16 +1,16 @@
 # AccountUsage<a name="API_AccountUsage"></a>
 
-Provides code size usage and function count associated with the current account and region\.
+The number of functions and amount of storage in use\.
 
 ## Contents<a name="API_AccountUsage_Contents"></a>
 
  **FunctionCount**   <a name="SSS-Type-AccountUsage-FunctionCount"></a>
-The number of your account's existing functions per region\.  
+The number of Lambda functions\.  
 Type: Long  
 Required: No
 
  **TotalCodeSize**   <a name="SSS-Type-AccountUsage-TotalCodeSize"></a>
-Total size, in bytes, of the account's deployment packages per region\.  
+The amount of storage space, in bytes, that's being used by deployment packages and layer archives\.  
 Type: Long  
 Required: No
 
@@ -19,5 +19,6 @@ Required: No
 For more information about using this API in one of the language\-specific AWS SDKs, see the following:
 +  [AWS SDK for C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/AccountUsage) 
 +  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/AccountUsage) 
++  [AWS SDK for Go \- Pilot](https://docs.aws.amazon.com/goto/SdkForGoPilot/lambda-2015-03-31/AccountUsage) 
 +  [AWS SDK for Java](https://docs.aws.amazon.com/goto/SdkForJava/lambda-2015-03-31/AccountUsage) 
 +  [AWS SDK for Ruby V2](https://docs.aws.amazon.com/goto/SdkForRubyV2/lambda-2015-03-31/AccountUsage) 

doc_source/API_AddLayerVersionPermission.md

@@ -1,6 +1,6 @@
 # AddLayerVersionPermission<a name="API_AddLayerVersionPermission"></a>
 
-Adds permissions to the resource\-based policy of a version of a function layer\. Use this action to grant layer usage permission to other accounts\. You can grant permission to a single account, all AWS accounts, or all accounts in an organization\.
+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 AWS accounts, or all accounts in an organization\.
 
 To revoke permission, call [RemoveLayerVersionPermission](API_RemoveLayerVersionPermission.md) with the statement ID that you specified when you added it\.
 
@@ -23,7 +23,7 @@ Content-type: application/json
 The request requires the following URI parameters\.
 
  ** [LayerName](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="SSS-AddLayerVersionPermission-request-LayerName"></a>
-The name of the layer\.  
+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-_]+` 
 
@@ -95,7 +95,7 @@ One of the parameters in the request is invalid\. For example, if you provided a
 HTTP Status Code: 400
 
  **PolicyLengthExceededException**   
-Lambda function access policy is limited to 20 KB\.  
+The permissions policy for the resource is too large\. [Learn more](https://docs.aws.amazon.com/lambda/latest/dg/limits.html)   
 HTTP Status Code: 400
 
  **PreconditionFailedException**   
@@ -115,7 +115,7 @@ The AWS Lambda service encountered an internal error\.
 HTTP Status Code: 500
 
  **TooManyRequestsException**   
-Request throughput limit exceeded  
+Request throughput limit exceeded\.  
 HTTP Status Code: 429
 
 ## See Also<a name="API_AddLayerVersionPermission_SeeAlso"></a>
@@ -125,6 +125,7 @@ For more information about using this API in one of the language\-specific AWS S
 +  [AWS SDK for \.NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/AddLayerVersionPermission) 
 +  [AWS SDK for C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/AddLayerVersionPermission) 
 +  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/AddLayerVersionPermission) 
++  [AWS SDK for Go \- Pilot](https://docs.aws.amazon.com/goto/SdkForGoPilot/lambda-2015-03-31/AddLayerVersionPermission) 
 +  [AWS SDK for Java](https://docs.aws.amazon.com/goto/SdkForJava/lambda-2015-03-31/AddLayerVersionPermission) 
 +  [AWS SDK for JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/lambda-2015-03-31/AddLayerVersionPermission) 
 +  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/AddLayerVersionPermission) 

doc_source/API_AddPermission.md

@@ -1,10 +1,10 @@
 # AddPermission<a name="API_AddPermission"></a>
 
-Adds a permission to the resource policy associated with the specified AWS Lambda function\. You use resource policies to grant permissions to event sources that use the *push* model\. In a *push* model, event sources \(such as Amazon S3 and custom applications\) invoke your Lambda function\. Each permission you add to the resource policy allows an event source permission to invoke the Lambda function\. 
+Grants an AWS service or another account 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\.
 
-Permissions apply to the Amazon Resource Name \(ARN\) used to invoke the function, which can be unqualified \(the unpublished version of the function\), or include a version or alias\. If a client uses a version or alias to invoke a function, use the `Qualifier` parameter to apply permissions to that ARN\. For more information about versioning, see [AWS Lambda Function Versioning and Aliases](https://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html)\. 
+To grant permission to another account, specify the account ID as the `Principal`\. For AWS services, the principal is a domain\-style identifier defined by the service, like `s3.amazonaws.com` or `sns.amazonaws.com`\. For AWS services, you can also specify the ARN or owning account of the associated resource as the `SourceArn` or `SourceAccount`\. 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 requires permission for the `lambda:AddPermission` action\.
+This action adds a statement to a resource\-based permission policy for the function\. For more information about function policies, see [Lambda Function Policies](https://docs.aws.amazon.com/lambda/latest/dg/access-control-resource-based.html)\. 
 
 ## Request Syntax<a name="API_AddPermission_RequestSyntax"></a>
 
@@ -28,13 +28,13 @@ Content-type: application/json
 The request requires the following URI parameters\.
 
  ** [FunctionName](#API_AddPermission_RequestSyntax) **   <a name="SSS-AddPermission-request-FunctionName"></a>
-The name of the lambda function\.  
+The name of the Lambda function, version, or alias\.  
 
 **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\.  
++  **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 140\.  
 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-_]+))?` 
 
@@ -48,44 +48,43 @@ Pattern: `(|[a-zA-Z0-9$_-]+)`
 The request accepts the following data in JSON format\.
 
  ** [Action](#API_AddPermission_RequestSyntax) **   <a name="SSS-AddPermission-request-Action"></a>
-The AWS Lambda action you want to allow in this statement\. Each Lambda action is a string starting with `lambda:` followed by the API name \(see [Actions](https://docs.aws.amazon.com/lambda/latest/dg/API_Operations.html)\) \. For example, `lambda:CreateFunction`\. You can use wildcard \(`lambda:*`\) to grant permission for all AWS Lambda actions\.   
+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="SSS-AddPermission-request-EventSourceToken"></a>
-A unique token that must be supplied by the principal invoking the function\. This is currently only used for Alexa Smart Home functions\.  
+For Alexa Smart Home functions, a token that must be supplied by the invoker\.  
 Type: String  
 Length Constraints: Minimum length of 0\. Maximum length of 256\.  
 Pattern: `[a-zA-Z0-9._\-]+`   
 Required: No
 
  ** [Principal](#API_AddPermission_RequestSyntax) **   <a name="SSS-AddPermission-request-Principal"></a>
-The principal who is getting this permission\. The principal can be an AWS service \(e\.g\. `s3.amazonaws.com` or `sns.amazonaws.com`\) for service triggers, or an account ID for cross\-account access\. If you specify a service as a principal, use the `SourceArn` parameter to limit who can invoke the function through that service\.  
+The AWS service or account 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: `.*`   
 Required: Yes
 
  ** [RevisionId](#API_AddPermission_RequestSyntax) **   <a name="SSS-AddPermission-request-RevisionId"></a>
-An optional value you can use to ensure you are updating the latest update of the function version or alias\. If the `RevisionID` you pass doesn't match the latest `RevisionId` of the function or alias, it will fail with an error message, advising you to retrieve the latest function version or alias `RevisionID` using either [GetFunction](API_GetFunction.md) or [GetAlias](API_GetAlias.md)   
+Only update the policy 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="SSS-AddPermission-request-SourceAccount"></a>
-This parameter is used for S3 and SES\. The AWS account ID \(without a hyphen\) of the source owner\. For example, if the `SourceArn` identifies a bucket, then this is the bucket owner's account ID\. You can use this additional condition to ensure the bucket you specify is owned by a specific account \(it is possible the bucket owner deleted the bucket and some other AWS account created the bucket\)\. You can also use this condition to specify all sources \(that is, you don't specify the `SourceArn`\) owned by a specific account\.   
+For AWS services, the ID of the account that owns the resource\. Use this instead of `SourceArn` to grant permission to resources that are owned by another account \(for example, all of an account's Amazon S3 buckets\)\. Or use it together with `SourceArn` to ensure that the resource is owned by the specified account\. For example, an Amazon S3 bucket could be deleted by its owner and recreated by another account\.  
 Type: String  
 Pattern: `\d{12}`   
 Required: No
 
  ** [SourceArn](#API_AddPermission_RequestSyntax) **   <a name="SSS-AddPermission-request-SourceArn"></a>
-The Amazon Resource Name of the invoker\.   
-If you add a permission to a service principal without providing the source ARN, any AWS account that creates a mapping to your function ARN can invoke your Lambda function\.
+For AWS services, the ARN of the AWS resource that invokes the function\. For example, an Amazon S3 bucket or Amazon SNS topic\.  
 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="SSS-AddPermission-request-StatementId"></a>
-A unique statement identifier\.  
+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-_]+)`   
@@ -109,7 +108,7 @@ 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="SSS-AddPermission-response-Statement"></a>
-The permission statement you specified in the request\. The response returns the same as a string using a backslash \("\\"\) as an escape character in the JSON\.  
+The permission statement that's added to the function policy\.  
 Type: String
 
 ## Errors<a name="API_AddPermission_Errors"></a>
@@ -119,7 +118,7 @@ One of the parameters in the request is invalid\. For example, if you provided a
 HTTP Status Code: 400
 
  **PolicyLengthExceededException**   
-Lambda function access policy is limited to 20 KB\.  
+The permissions policy for the resource is too large\. [Learn more](https://docs.aws.amazon.com/lambda/latest/dg/limits.html)   
 HTTP Status Code: 400
 
  **PreconditionFailedException**   
@@ -139,7 +138,7 @@ The AWS Lambda service encountered an internal error\.
 HTTP Status Code: 500
 
  **TooManyRequestsException**   
-Request throughput limit exceeded  
+Request throughput limit exceeded\.  
 HTTP Status Code: 429
 
 ## See Also<a name="API_AddPermission_SeeAlso"></a>
@@ -149,6 +148,7 @@ For more information about using this API in one of the language\-specific AWS S
 +  [AWS SDK for \.NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/AddPermission) 
 +  [AWS SDK for C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/AddPermission) 
 +  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/AddPermission) 
++  [AWS SDK for Go \- Pilot](https://docs.aws.amazon.com/goto/SdkForGoPilot/lambda-2015-03-31/AddPermission) 
 +  [AWS SDK for Java](https://docs.aws.amazon.com/goto/SdkForJava/lambda-2015-03-31/AddPermission) 
 +  [AWS SDK for JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/lambda-2015-03-31/AddPermission) 
 +  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/AddPermission)