feat(client-lambda): This release adds SnapStart related exceptions to InvokeWithResponseStream API. IAM access related documentation is also added for this API.

Author: awstools

clients/client-lambda/src/Lambda.ts

@@ -1699,6 +1699,9 @@ export class Lambda extends LambdaClient {
   /**
    * @public
    * <p>Configure your Lambda functions to stream response payloads back to clients. For more information, see <a href="https://docs.aws.amazon.com/lambda/latest/dg/configuration-response-streaming.html">Configuring a Lambda function to stream responses</a>.</p>
+   *          <p>This operation requires permission for the <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/list_awslambda.html">lambda:InvokeFunction</a> action. For details on how to set up
+   *       permissions for cross-account invocations, see <a href="https://docs.aws.amazon.com/lambda/latest/dg/access-control-resource-based.html#permissions-resource-xaccountinvoke">Granting function
+   *         access to other accounts</a>.</p>
    */
   public invokeWithResponseStream(
     args: InvokeWithResponseStreamCommandInput,

clients/client-lambda/src/commands/InvokeWithResponseStreamCommand.ts

@@ -39,6 +39,9 @@ export interface InvokeWithResponseStreamCommandOutput extends InvokeWithRespons
 /**
  * @public
  * <p>Configure your Lambda functions to stream response payloads back to clients. For more information, see <a href="https://docs.aws.amazon.com/lambda/latest/dg/configuration-response-streaming.html">Configuring a Lambda function to stream responses</a>.</p>
+ *          <p>This operation requires permission for the <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/list_awslambda.html">lambda:InvokeFunction</a> action. For details on how to set up
+ *       permissions for cross-account invocations, see <a href="https://docs.aws.amazon.com/lambda/latest/dg/access-control-resource-based.html#permissions-resource-xaccountinvoke">Granting function
+ *         access to other accounts</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -143,6 +146,16 @@ export interface InvokeWithResponseStreamCommandOutput extends InvokeWithRespons
  * @throws {@link ServiceException} (server fault)
  *  <p>The Lambda service encountered an internal error.</p>
  *
+ * @throws {@link SnapStartException} (client fault)
+ *  <p>The <code>afterRestore()</code>
+ *             <a href="https://docs.aws.amazon.com/lambda/latest/dg/snapstart-runtime-hooks.html">runtime hook</a> encountered an error. For more information, check the Amazon CloudWatch logs.</p>
+ *
+ * @throws {@link SnapStartNotReadyException} (client fault)
+ *  <p>Lambda is initializing your function. You can invoke the function when the <a href="https://docs.aws.amazon.com/lambda/latest/dg/functions-states.html">function state</a> becomes <code>Active</code>.</p>
+ *
+ * @throws {@link SnapStartTimeoutException} (client fault)
+ *  <p>Lambda couldn't restore the snapshot within the timeout limit.</p>
+ *
  * @throws {@link SubnetIPAddressLimitReachedException} (server fault)
  *  <p>Lambda couldn't set up VPC access for the Lambda function because one or more
  *       configured subnets has no available IP addresses.</p>

clients/client-lambda/src/models/models_0.ts

@@ -1243,7 +1243,10 @@ export interface EventSourceMappingConfiguration {
 
   /**
    * <p>(Kinesis and DynamoDB Streams only) Discard records older than the specified age. The default value is -1,
-   * which sets the maximum age to infinite. When the value is set to infinite, Lambda never discards old records.  </p>
+   * which sets the maximum age to infinite. When the value is set to infinite, Lambda never discards old records.</p>
+   *          <note>
+   *             <p>The minimum value that can be set is 60 seconds.</p>
+   *          </note>
    */
   MaximumRecordAgeInSeconds?: number;
 
@@ -2060,7 +2063,8 @@ export interface FunctionConfiguration {
   FunctionArn?: string;
 
   /**
-   * <p>The runtime environment for the Lambda function.</p>
+   * <p>The identifier of the function's <a href="https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html">runtime</a>. Runtime is required if the deployment package is a .zip file archive.</p>
+   *          <p>The following list includes deprecated runtimes. For more information, see <a href="https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy">Runtime deprecation policy</a>.</p>
    */
   Runtime?: Runtime | string;
 
@@ -4962,14 +4966,14 @@ export interface FunctionUrlConfig {
    *             <li>
    *                <p>
    *                   <code>BUFFERED</code> – This is the default option. Lambda invokes your function
-   *           using the <code>Invoke</code> API operation. Invocation results are available when the
-   *           payload is complete. The maximum payload size is 6 MB.</p>
+   *         using the <code>Invoke</code> API operation. Invocation results are available when the
+   *         payload is complete. The maximum payload size is 6 MB.</p>
    *             </li>
    *             <li>
    *                <p>
    *                   <code>RESPONSE_STREAM</code> – Your function streams payload results as they become available.
-   *             Lambda invokes your function using the <code>InvokeWithResponseStream</code>
-   *           API operation. The maximum response payload size is 20 MB, however, you can <a href="https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html">request a quota increase</a>.</p>
+   *         Lambda invokes your function using the <code>InvokeWithResponseStream</code>
+   *         API operation. The maximum response payload size is 20 MB, however, you can <a href="https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html">request a quota increase</a>.</p>
    *             </li>
    *          </ul>
    */

clients/client-lambda/src/protocols/Aws_restJson1.ts

@@ -5547,6 +5547,15 @@ const de_InvokeWithResponseStreamCommandError = async (
     case "ServiceException":
     case "com.amazonaws.lambda#ServiceException":
       throw await de_ServiceExceptionRes(parsedOutput, context);
+    case "SnapStartException":
+    case "com.amazonaws.lambda#SnapStartException":
+      throw await de_SnapStartExceptionRes(parsedOutput, context);
+    case "SnapStartNotReadyException":
+    case "com.amazonaws.lambda#SnapStartNotReadyException":
+      throw await de_SnapStartNotReadyExceptionRes(parsedOutput, context);
+    case "SnapStartTimeoutException":
+    case "com.amazonaws.lambda#SnapStartTimeoutException":
+      throw await de_SnapStartTimeoutExceptionRes(parsedOutput, context);
     case "SubnetIPAddressLimitReachedException":
     case "com.amazonaws.lambda#SubnetIPAddressLimitReachedException":
       throw await de_SubnetIPAddressLimitReachedExceptionRes(parsedOutput, context);