Merge branch 'master' into fix/typo

Author: mwunderl

doc_source/API_AccountLimit.md

@@ -1,6 +1,6 @@
 # AccountLimit<a name="API_AccountLimit"></a>
 
-Provides limits of code size and concurrency associated with the current account and region\.
+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)\. 
 
 ## Contents<a name="API_AccountLimit_Contents"></a>
 
@@ -15,7 +15,7 @@ Type: Long
 Required: No
 
  **ConcurrentExecutions**   <a name="SSS-Type-AccountLimit-ConcurrentExecutions"></a>
-Number of simultaneous executions of your function per region\. For more information or to request a limit increase for concurrent executions, see [Lambda Function Concurrent Executions](https://docs.aws.amazon.com/lambda/latest/dg/concurrent-executions.html)\. The default limit is 1000\.  
+Number of simultaneous executions of your function per region\. The default limit is 1000\.  
 Type: Integer  
 Required: No
 
@@ -25,7 +25,7 @@ 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](concurrent-executions.md)\.  
+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)\.  
 Type: Integer  
 Valid Range: Minimum value of 0\.  
 Required: No

doc_source/API_AddLayerVersionPermission.md

@@ -0,0 +1,132 @@
+# 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\.
+
+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](#SSS-AddLayerVersionPermission-request-Action)": "string",
+   "[OrganizationId](#SSS-AddLayerVersionPermission-request-OrganizationId)": "string",
+   "[Principal](#SSS-AddLayerVersionPermission-request-Principal)": "string",
+   "[StatementId](#SSS-AddLayerVersionPermission-request-StatementId)": "string"
+}
+```
+
+## URI Request Parameters<a name="API_AddLayerVersionPermission_RequestParameters"></a>
+
+The request requires the following URI parameters\.
+
+ ** [LayerName](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="SSS-AddLayerVersionPermission-request-LayerName"></a>
+The name 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-_]+` 
+
+ ** [RevisionId](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="SSS-AddLayerVersionPermission-request-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="SSS-AddLayerVersionPermission-request-VersionNumber"></a>
+The version number\.
+
+## Request Body<a name="API_AddLayerVersionPermission_RequestBody"></a>
+
+The request accepts the following data in JSON format\.
+
+ ** [Action](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="SSS-AddLayerVersionPermission-request-Action"></a>
+The API action that grants access to the layer\. For example, `lambda:GetLayerVersion`\.  
+Type: String  
+Pattern: `lambda:GetLayerVersion`   
+Required: Yes
+
+ ** [OrganizationId](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="SSS-AddLayerVersionPermission-request-OrganizationId"></a>
+With the principal set to `*`, grant permission to all accounts in the specified organization\.  
+Type: String  
+Pattern: `o-[a-z0-9]{10,32}`   
+Required: No
+
+ ** [Principal](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="SSS-AddLayerVersionPermission-request-Principal"></a>
+An account ID, or `*` to grant permission to all AWS accounts\.  
+Type: String  
+Pattern: `\d{12}|\*|arn:(aws[a-zA-Z-]*):iam::\d{12}:root`   
+Required: Yes
+
+ ** [StatementId](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="SSS-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](#SSS-AddLayerVersionPermission-response-RevisionId)": "string",
+   "[Statement](#SSS-AddLayerVersionPermission-response-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="SSS-AddLayerVersionPermission-response-RevisionId"></a>
+A unique identifier for the current revision of the policy\.  
+Type: String
+
+ ** [Statement](#API_AddLayerVersionPermission_ResponseSyntax) **   <a name="SSS-AddLayerVersionPermission-response-Statement"></a>
+The permission statement\.  
+Type: String
+
+## Errors<a name="API_AddLayerVersionPermission_Errors"></a>
+
+ **InvalidParameterValueException**   
+One of the parameters in the request is invalid\. For example, if you provided an IAM role for AWS Lambda to assume in the `CreateFunction` or the `UpdateFunctionConfiguration` API, that AWS Lambda is unable to assume you will get this exception\.  
+HTTP Status Code: 400
+
+ **PolicyLengthExceededException**   
+Lambda function access policy is limited to 20 KB\.  
+HTTP Status Code: 400
+
+ **PreconditionFailedException**   
+The RevisionId provided does not match the latest RevisionId for the Lambda function or alias\. Call the `GetFunction` or the `GetAlias` API to retrieve the latest RevisionId for your resource\.  
+HTTP Status Code: 412
+
+ **ResourceConflictException**   
+The resource already exists\.  
+HTTP Status Code: 409
+
+ **ResourceNotFoundException**   
+The resource \(for example, a Lambda function or access policy statement\) 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**   
+Request throughput limit exceeded  
+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](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/AddLayerVersionPermission) 
++  [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 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) 
++  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/AddLayerVersionPermission) 
++  [AWS SDK for Ruby V2](https://docs.aws.amazon.com/goto/SdkForRubyV2/lambda-2015-03-31/AddLayerVersionPermission) 

doc_source/API_AddPermission.md

@@ -2,7 +2,7 @@
 
 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\. 
 
-If you are using versioning, the permissions you add are specific to the Lambda function version or alias you specify in the `AddPermission` request via the `Qualifier` parameter\. For more information about versioning, see [AWS Lambda Function Versioning and Aliases](https://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html)\. 
+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)\. 
 
 This operation requires permission for the `lambda:AddPermission` action\.
 
@@ -28,18 +28,18 @@ Content-type: application/json
 The request requires the following URI parameters\.
 
  ** [FunctionName](#API_AddPermission_RequestSyntax) **   <a name="SSS-AddPermission-request-FunctionName"></a>
-Name of the Lambda function whose resource policy you are updating by adding a new permission\.  
- You can specify a function name \(for example, `Thumbnail`\) or you can specify Amazon Resource Name \(ARN\) of the function \(for example, `arn:aws:lambda:us-west-2:account-id:function:ThumbNail`\)\. AWS Lambda also allows you to specify partial ARN \(for example, `account-id:Thumbnail`\)\. Note that the length constraint applies only to the ARN\. If you specify only the function name, it is limited to 64 characters in length\.   
+The name 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:lambda:)?([a-z]{2}-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?` 
+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-_]+))?` 
 
  ** [Qualifier](#API_AddPermission_RequestSyntax) **   <a name="SSS-AddPermission-request-Qualifier"></a>
-You can use this optional query parameter to describe a qualified ARN using a function version or an alias name\. The permission will then apply to the specific qualified ARN\. For example, if you specify function version 2 as the qualifier, then permission applies only when request is made using qualified function ARN:  
- `arn:aws:lambda:aws-region:acct-id:function:function-name:2`   
-If you specify an alias name, for example `PROD`, then the permission is valid only for requests made using the alias ARN:  
- `arn:aws:lambda:aws-region:acct-id:function:function-name:PROD`   
-If the qualifier is not specified, the permission is valid only when requests is made using unqualified function ARN\.  
- `arn:aws:lambda:aws-region:acct-id:function:function-name`   
+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: `(|[a-zA-Z0-9$_-]+)` 
 
@@ -61,13 +61,13 @@ 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\. It can be Amazon S3 service Principal \(`s3.amazonaws.com`\) if you want Amazon S3 to invoke the function, an AWS account ID if you are granting cross\-account permission, or any valid AWS service principal such as `sns.amazonaws.com`\. For example, you might want to allow a custom application in another AWS account to push events to AWS Lambda by invoking your function\.   
+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\.  
 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](https://docs.aws.amazon.com/lambda/latest/dg/API_GetFunction.html) or [GetAlias](https://docs.aws.amazon.com/lambda/latest/dg/API_GetAlias.html) operations\.  
+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)   
 Type: String  
 Required: No
 
@@ -78,10 +78,10 @@ Pattern: `\d{12}`
 Required: No
 
  ** [SourceArn](#API_AddPermission_RequestSyntax) **   <a name="SSS-AddPermission-request-SourceArn"></a>
-This is optional; however, when granting permission to invoke your function, you should specify this field with the Amazon Resource Name \(ARN\) as its value\. This ensures that only events generated from the specified source can invoke the function\.  
-If you add a permission without providing the source ARN, any AWS account that creates a mapping to your function ARN can send events to invoke your Lambda function\.
+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\.
 Type: String  
-Pattern: `arn:aws:([a-zA-Z0-9\-])+:([a-z]{2}-[a-z]+-\d{1})?:(\d{12})?:(.*)`   
+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>
@@ -139,7 +139,7 @@ The AWS Lambda service encountered an internal error\.
 HTTP Status Code: 500
 
  **TooManyRequestsException**   
-   
+Request throughput limit exceeded  
 HTTP Status Code: 429
 
 ## See Also<a name="API_AddPermission_SeeAlso"></a>

doc_source/API_AliasConfiguration.md

@@ -7,7 +7,7 @@ Provides configuration information about a Lambda function version alias\.
  **AliasArn**   <a name="SSS-Type-AliasConfiguration-AliasArn"></a>
 Lambda function ARN that is qualified using the alias name as the suffix\. For example, if you create an alias called `BETA` that points to a helloworld function version, the ARN is `arn:aws:lambda:aws-regions:acct-id:function:helloworld:BETA`\.  
 Type: String  
-Pattern: `arn:aws:lambda:[a-z]{2}-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?`   
+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
 
  **Description**   <a name="SSS-Type-AliasConfiguration-Description"></a>
@@ -36,7 +36,7 @@ Type: String
 Required: No
 
  **RoutingConfig**   <a name="SSS-Type-AliasConfiguration-RoutingConfig"></a>
-Specifies an additional function versions the alias points to, allowing you to dictate what percentage of traffic will invoke each version\. For more information, see [Traffic Shifting Using Aliases](lambda-traffic-shifting-using-aliases.md)\.  
+Specifies an additional function versions the alias points to, allowing you to dictate what percentage of traffic will invoke each version\.  
 Type: [AliasRoutingConfiguration](API_AliasRoutingConfiguration.md) object  
 Required: No
 

doc_source/API_AliasRoutingConfiguration.md

@@ -1,11 +1,11 @@
 # AliasRoutingConfiguration<a name="API_AliasRoutingConfiguration"></a>
 
-The parent object that implements what percentage of traffic will invoke each function version\. For more information, see [Traffic Shifting Using Aliases](lambda-traffic-shifting-using-aliases.md)\.
+The alias's [traffic shifting](https://docs.aws.amazon.com/lambda/latest/dg/lambda-traffic-shifting-using-aliases.html) configuration\.
 
 ## Contents<a name="API_AliasRoutingConfiguration_Contents"></a>
 
  **AdditionalVersionWeights**   <a name="SSS-Type-AliasRoutingConfiguration-AdditionalVersionWeights"></a>
-Set this value to dictate what percentage of traffic will invoke the updated function version\. If set to an empty string, 100 percent of traffic will invoke `function-version`\. For more information, see [Traffic Shifting Using Aliases](lambda-traffic-shifting-using-aliases.md)\.  
+The name of the second alias, and the percentage of traffic that is routed to it\.  
 Type: String to double map  
 Key Length Constraints: Minimum length of 1\. Maximum length of 1024\.  
 Key Pattern: `[0-9]+`   

doc_source/API_Concurrency.md

@@ -3,7 +3,7 @@
 ## Contents<a name="API_Concurrency_Contents"></a>
 
  **ReservedConcurrentExecutions**   <a name="SSS-Type-Concurrency-ReservedConcurrentExecutions"></a>
-The number of concurrent executions reserved for this function\. For more information, see [Managing Concurrency](concurrent-executions.md)\.  
+The number of concurrent executions reserved for this function\. For more information, see [Managing Concurrency](https://docs.aws.amazon.com/lambda/latest/dg/concurrent-executions.html)\.  
 Type: Integer  
 Valid Range: Minimum value of 0\.  
 Required: No