tutorial fixes and cleanup

Author: mwunderl

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\.
 
@@ -39,12 +39,7 @@ 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-_]+))?` 
 
  ** [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$_-]+)` 
 
@@ -66,7 +61,7 @@ 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
@@ -83,8 +78,8 @@ 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-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)`   
 Required: No
@@ -144,6 +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_CreateAlias.md

@@ -141,6 +141,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_CreateAlias_SeeAlso"></a>

doc_source/API_CreateEventSourceMapping.md

@@ -158,6 +158,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_CreateEventSourceMapping_SeeAlso"></a>

doc_source/API_CreateFunction.md

@@ -137,7 +137,7 @@ Valid Range: Minimum value of 1\.
 Required: No
 
  ** [TracingConfig](#API_CreateFunction_RequestSyntax) **   <a name="SSS-CreateFunction-request-TracingConfig"></a>
-The parent object that contains your function's tracing settings\.  
+Set `Mode` to `Active` to sample and trace a subset of incoming requests with AWS X\-Ray\.  
 Type: [TracingConfig](API_TracingConfig.md) object  
 Required: No
 
@@ -310,6 +310,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_CreateFunction_SeeAlso"></a>

doc_source/API_DeleteAlias.md

@@ -55,6 +55,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_DeleteAlias_SeeAlso"></a>

doc_source/API_DeleteEventSourceMapping.md

@@ -99,6 +99,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_DeleteEventSourceMapping_SeeAlso"></a>

doc_source/API_DeleteFunction.md

@@ -1,10 +1,6 @@
 # DeleteFunction<a name="API_DeleteFunction"></a>
 
-Deletes the specified Lambda function code and configuration\.
-
-If you are using the versioning feature and you don't specify a function version in your `DeleteFunction` request, AWS Lambda will delete the function, including all its versions, and any aliases pointing to the function versions\. To delete a specific function version, you must provide the function version via the `Qualifier` parameter\. For information about function versioning, see [AWS Lambda Function Versioning and Aliases](https://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html)\. 
-
-When you delete a function the associated resource policy is also deleted\. You will need to delete the event source mappings explicitly\.
+Deletes a Lambda function\. To delete a specific function version, use the `Qualifier` parameter\. Otherwise, all versions and aliases are deleted\. Event source mappings are not deleted\.
 
 This operation requires permission for the `lambda:DeleteFunction` action\.
 
@@ -30,9 +26,7 @@ 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-_]+))?` 
 
  ** [Qualifier](#API_DeleteFunction_RequestSyntax) **   <a name="SSS-DeleteFunction-request-Qualifier"></a>
-Using this optional parameter you can specify a function version \(but not the `$LATEST` version\) to direct AWS Lambda to delete a specific function version\. If the function version has one or more aliases pointing to it, you will get an error because you cannot have aliases pointing to it\. You can delete any function version but not the `$LATEST`, that is, you cannot specify `$LATEST` as the value of this parameter\. The `$LATEST` version can be deleted only when you want to delete all the function versions and aliases\.  
-You can only specify a function version, not an alias name, using this parameter\. You cannot delete a function version using its alias\.  
-If you don't specify this parameter, AWS Lambda will delete the function, including all of its versions and aliases\.  
+Specify a version to delete\. You cannot delete a version that is referenced by an alias\.  
 Length Constraints: Minimum length of 1\. Maximum length of 128\.  
 Pattern: `(|[a-zA-Z0-9$_-]+)` 
 
@@ -69,6 +63,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_DeleteFunction_SeeAlso"></a>

doc_source/API_DeleteFunctionConcurrency.md

@@ -52,6 +52,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_DeleteFunctionConcurrency_SeeAlso"></a>

doc_source/API_Environment.md

@@ -1,11 +1,11 @@
 # Environment<a name="API_Environment"></a>
 
-The parent object that contains your environment's configuration settings\.
+A function's environment variable settings\.
 
 ## Contents<a name="API_Environment_Contents"></a>
 
  **Variables**   <a name="SSS-Type-Environment-Variables"></a>
-The key\-value pairs that represent your environment's configuration settings\.  
+Environment variable key\-value pairs\.  
 Type: String to string map  
 Key Pattern: `[a-zA-Z]([a-zA-Z0-9_])+`   
 Required: No

doc_source/API_EnvironmentError.md

@@ -1,16 +1,16 @@
 # EnvironmentError<a name="API_EnvironmentError"></a>
 
-The parent object that contains error information associated with your configuration settings\.
+Error messages for environment variables that could not be applied\.
 
 ## Contents<a name="API_EnvironmentError_Contents"></a>
 
  **ErrorCode**   <a name="SSS-Type-EnvironmentError-ErrorCode"></a>
-The error code returned by the environment error object\.  
+The error code\.  
 Type: String  
 Required: No
 
  **Message**   <a name="SSS-Type-EnvironmentError-Message"></a>
-The message returned by the environment error object\.  
+The error message\.  
 Type: String  
 Required: No
 

doc_source/API_EnvironmentResponse.md

@@ -1,15 +1,16 @@
 # EnvironmentResponse<a name="API_EnvironmentResponse"></a>
 
-The parent object returned that contains your environment's configuration settings or any error information associated with your configuration settings\.
+The results of a configuration update that applied environment variables\.
 
 ## Contents<a name="API_EnvironmentResponse_Contents"></a>
 
  **Error**   <a name="SSS-Type-EnvironmentResponse-Error"></a>
+Error messages for environment variables that could not be applied\.  
 Type: [EnvironmentError](API_EnvironmentError.md) object  
 Required: No
 
  **Variables**   <a name="SSS-Type-EnvironmentResponse-Variables"></a>
-The key\-value pairs returned that represent your environment's configuration settings or error information\.  
+Environment variable key\-value pairs\.  
 Type: String to string map  
 Key Pattern: `[a-zA-Z]([a-zA-Z0-9_])+`   
 Required: No

doc_source/API_GetAccountSettings.md

@@ -1,8 +1,6 @@
 # GetAccountSettings<a name="API_GetAccountSettings"></a>
 
-Returns a customer's account settings\.
-
-You can use this operation to retrieve Lambda limits information, such as code size and concurrency limits\. For more information about limits, see [AWS Lambda Limits](https://docs.aws.amazon.com/lambda/latest/dg/limits.html)\. You can also retrieve resource usage statistics, such as code storage usage and function count\.
+Retrieves details about your account's [limits](https://docs.aws.amazon.com/lambda/latest/dg/limits.html) and usage in a region\.
 
 ## Request Syntax<a name="API_GetAccountSettings_RequestSyntax"></a>
 
@@ -46,9 +44,11 @@ If the action is successful, the service sends back an HTTP 200 response\.
 The following data is returned in JSON format by the service\.
 
  ** [AccountLimit](#API_GetAccountSettings_ResponseSyntax) **   <a name="SSS-GetAccountSettings-response-AccountLimit"></a>
+Limits related to concurrency and code storage\.  
 Type: [AccountLimit](API_AccountLimit.md) object
 
  ** [AccountUsage](#API_GetAccountSettings_ResponseSyntax) **   <a name="SSS-GetAccountSettings-response-AccountUsage"></a>
+The number of functions and amount of storage in use\.  
 Type: [AccountUsage](API_AccountUsage.md) object
 
 ## Errors<a name="API_GetAccountSettings_Errors"></a>
@@ -58,6 +58,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_GetAccountSettings_SeeAlso"></a>

doc_source/API_GetAlias.md

@@ -105,6 +105,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_GetAlias_SeeAlso"></a>

doc_source/API_GetEventSourceMapping.md

@@ -95,6 +95,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_GetEventSourceMapping_SeeAlso"></a>

doc_source/API_GetFunction.md

@@ -2,7 +2,7 @@
 
 Returns the configuration information of the Lambda function and a presigned URL link to the \.zip file you uploaded with [CreateFunction](API_CreateFunction.md) so you can download the \.zip file\. Note that the URL is valid for up to 10 minutes\. The configuration information is the same information you provided as parameters when uploading the function\.
 
-Using the optional `Qualifier` parameter, you can specify a specific function version for which you want this information\. If you don't specify this parameter, the API uses unqualified function ARN which return information about the `$LATEST` version of the Lambda function\. For more information, see [AWS Lambda Function Versioning and Aliases](https://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html)\.
+Use the `Qualifier` parameter to retrieve a published version of the function\. Otherwise, returns the unpublished version \(`$LATEST`\)\. For more information, 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:GetFunction` action\.
 
@@ -28,7 +28,7 @@ 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-_]+))?` 
 
  ** [Qualifier](#API_GetFunction_RequestSyntax) **   <a name="SSS-GetFunction-request-Qualifier"></a>
-Use this optional parameter to specify a function version or an alias name\. If you specify function version, the API uses qualified function ARN for the request and returns information about the specific Lambda function version\. If you specify an alias name, the API uses the alias ARN and returns information about the function version to which the alias points\. If you don't provide this parameter, the API uses unqualified function ARN and returns information about the `$LATEST` version of the Lambda function\.   
+Specify a version or alias to get details about a published version of the function\.  
 Length Constraints: Minimum length of 1\. Maximum length of 128\.  
 Pattern: `(|[a-zA-Z0-9$_-]+)` 
 
@@ -100,13 +100,15 @@ If the action is successful, the service sends back an HTTP 200 response\.
 The following data is returned in JSON format by the service\.
 
  ** [Code](#API_GetFunction_ResponseSyntax) **   <a name="SSS-GetFunction-response-Code"></a>
+The function's code\.  
 Type: [FunctionCodeLocation](API_FunctionCodeLocation.md) object
 
  ** [Concurrency](#API_GetFunction_ResponseSyntax) **   <a name="SSS-GetFunction-response-Concurrency"></a>
 The concurrent execution limit set for this function\. For more information, see [Managing Concurrency](https://docs.aws.amazon.com/lambda/latest/dg/concurrent-executions.html)\.  
 Type: [Concurrency](API_Concurrency.md) object
 
  ** [Configuration](#API_GetFunction_ResponseSyntax) **   <a name="SSS-GetFunction-response-Configuration"></a>
+The function's configuration\.  
 Type: [FunctionConfiguration](API_FunctionConfiguration.md) object
 
  ** [Tags](#API_GetFunction_ResponseSyntax) **   <a name="SSS-GetFunction-response-Tags"></a>
@@ -128,6 +130,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_GetFunction_SeeAlso"></a>

doc_source/API_GetFunctionConfiguration.md

@@ -28,8 +28,7 @@ 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-_]+))?` 
 
  ** [Qualifier](#API_GetFunctionConfiguration_RequestSyntax) **   <a name="SSS-GetFunctionConfiguration-request-Qualifier"></a>
-Using this optional parameter you can specify a function version or an alias name\. If you specify function version, the API uses qualified function ARN and returns information about the specific function version\. If you specify an alias name, the API uses the alias ARN and returns information about the function version to which the alias points\.  
-If you don't specify this parameter, the API uses unqualified function ARN, and returns information about the `$LATEST` function version\.  
+Specify a version or alias to get details about a published version of the function\.  
 Length Constraints: Minimum length of 1\. Maximum length of 128\.  
 Pattern: `(|[a-zA-Z0-9$_-]+)` 
 
@@ -193,6 +192,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_GetFunctionConfiguration_SeeAlso"></a>

doc_source/API_GetPolicy.md

@@ -75,6 +75,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_GetPolicy_SeeAlso"></a>

doc_source/API_Invoke.md

@@ -55,8 +55,7 @@ You can set this optional parameter to `Tail` in the request only if you specify
 Valid Values:` None | Tail` 
 
  ** [Qualifier](#API_Invoke_RequestSyntax) **   <a name="SSS-Invoke-request-Qualifier"></a>
-You can use this optional parameter to specify a Lambda function version or alias name\. If you specify a function version, the API uses the qualified function ARN to invoke a specific Lambda function\. If you specify an alias name, the API uses the alias ARN to invoke the Lambda function version to which the alias points\.  
-If you don't provide this parameter, then the API uses unqualified function ARN which results in invocation of the `$LATEST` version\.  
+Specify a version or alias to invoke a published version of the function\.  
 Length Constraints: Minimum length of 1\. Maximum length of 128\.  
 Pattern: `(|[a-zA-Z0-9$_-]+)` 
 
@@ -107,6 +106,7 @@ In the event of a function error this field contains a message describing the er
 ## Errors<a name="API_Invoke_Errors"></a>
 
  **EC2AccessDeniedException**   
+Need additional permissions to configure VPC settings\.  
 HTTP Status Code: 502
 
  **EC2ThrottledException**   
@@ -142,7 +142,7 @@ The Subnet ID provided in the Lambda function VPC configuration is invalid\.
 HTTP Status Code: 502
 
  **InvalidZipFileException**   
-AWS Lambda could not unzip the function zip file\.  
+AWS Lambda could not unzip the deployment package\.  
 HTTP Status Code: 502
 
  **KMSAccessDeniedException**   
@@ -178,6 +178,7 @@ AWS Lambda was not able to set up VPC access for the Lambda function because one
 HTTP Status Code: 502
 
  **TooManyRequestsException**   
+Request throughput limit exceeded  
 HTTP Status Code: 429
 
  **UnsupportedMediaTypeException**