Update generated code (#1307)

update generated code

Author: async-aws-bot

CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## NOT RELEASED
 
+### Added
+
+- AWS api-change: This release allows you to override the alarm configurations when creating a deployment.
+
 ## 1.3.0
 
 ### Added

src/CodeDeployClient.php

@@ -4,6 +4,7 @@
 
 use AsyncAws\CodeDeploy\Enum\FileExistsBehavior;
 use AsyncAws\CodeDeploy\Enum\LifecycleEventStatus;
+use AsyncAws\CodeDeploy\Exception\AlarmsLimitExceededException;
 use AsyncAws\CodeDeploy\Exception\ApplicationDoesNotExistException;
 use AsyncAws\CodeDeploy\Exception\ApplicationNameRequiredException;
 use AsyncAws\CodeDeploy\Exception\DeploymentConfigDoesNotExistException;
@@ -13,6 +14,7 @@
 use AsyncAws\CodeDeploy\Exception\DeploymentIdRequiredException;
 use AsyncAws\CodeDeploy\Exception\DeploymentLimitExceededException;
 use AsyncAws\CodeDeploy\Exception\DescriptionTooLongException;
+use AsyncAws\CodeDeploy\Exception\InvalidAlarmConfigException;
 use AsyncAws\CodeDeploy\Exception\InvalidApplicationNameException;
 use AsyncAws\CodeDeploy\Exception\InvalidAutoRollbackConfigException;
 use AsyncAws\CodeDeploy\Exception\InvalidAutoScalingGroupException;
@@ -41,6 +43,7 @@
 use AsyncAws\CodeDeploy\Result\CreateDeploymentOutput;
 use AsyncAws\CodeDeploy\Result\GetDeploymentOutput;
 use AsyncAws\CodeDeploy\Result\PutLifecycleEventHookExecutionStatusOutput;
+use AsyncAws\CodeDeploy\ValueObject\AlarmConfiguration;
 use AsyncAws\CodeDeploy\ValueObject\AutoRollbackConfiguration;
 use AsyncAws\CodeDeploy\ValueObject\RevisionLocation;
 use AsyncAws\CodeDeploy\ValueObject\TargetInstances;
@@ -69,6 +72,7 @@ class CodeDeployClient extends AbstractApi
      *   autoRollbackConfiguration?: AutoRollbackConfiguration|array,
      *   updateOutdatedInstancesOnly?: bool,
      *   fileExistsBehavior?: FileExistsBehavior::*,
+     *   overrideAlarmConfiguration?: AlarmConfiguration|array,
      *   @region?: string,
      * }|CreateDeploymentInput $input
      *
@@ -86,6 +90,8 @@ class CodeDeployClient extends AbstractApi
      * @throws DescriptionTooLongException
      * @throws DeploymentLimitExceededException
      * @throws InvalidTargetInstancesException
+     * @throws InvalidAlarmConfigException
+     * @throws AlarmsLimitExceededException
      * @throws InvalidAutoRollbackConfigException
      * @throws InvalidLoadBalancerInfoException
      * @throws InvalidFileExistsBehaviorException
@@ -115,6 +121,8 @@ public function createDeployment($input): CreateDeploymentOutput
             'DescriptionTooLongException' => DescriptionTooLongException::class,
             'DeploymentLimitExceededException' => DeploymentLimitExceededException::class,
             'InvalidTargetInstancesException' => InvalidTargetInstancesException::class,
+            'InvalidAlarmConfigException' => InvalidAlarmConfigException::class,
+            'AlarmsLimitExceededException' => AlarmsLimitExceededException::class,
             'InvalidAutoRollbackConfigException' => InvalidAutoRollbackConfigException::class,
             'InvalidLoadBalancerInfoException' => InvalidLoadBalancerInfoException::class,
             'InvalidFileExistsBehaviorException' => InvalidFileExistsBehaviorException::class,
@@ -159,11 +167,11 @@ public function getDeployment($input): GetDeploymentOutput
 
     /**
      * Sets the result of a Lambda validation function. The function validates lifecycle hooks during a deployment that uses
-     * the AWS Lambda or Amazon ECS compute platform. For AWS Lambda deployments, the available lifecycle hooks are
+     * the Lambda or Amazon ECS compute platform. For Lambda deployments, the available lifecycle hooks are
      * `BeforeAllowTraffic` and `AfterAllowTraffic`. For Amazon ECS deployments, the available lifecycle hooks are
      * `BeforeInstall`, `AfterInstall`, `AfterAllowTestTraffic`, `BeforeAllowTraffic`, and `AfterAllowTraffic`. Lambda
-     * validation functions return `Succeeded` or `Failed`. For more information, see AppSpec 'hooks' Section for an AWS
-     * Lambda Deployment  and AppSpec 'hooks' Section for an Amazon ECS Deployment.
+     * validation functions return `Succeeded` or `Failed`. For more information, see AppSpec 'hooks' Section for an Lambda
+     * Deployment  and AppSpec 'hooks' Section for an Amazon ECS Deployment.
      *
      * @see https://docs.aws.amazon.com/codedeploy/latest/userguide/reference-appspec-file-structure-hooks.html#appspec-hooks-lambda
      * @see https://docs.aws.amazon.com/codedeploy/latest/userguide/reference-appspec-file-structure-hooks.html#appspec-hooks-ecs

src/Enum/DeploymentCreator.php

@@ -8,7 +8,8 @@
  * - `user`: A user created the deployment.
  * - `autoscaling`: Amazon EC2 Auto Scaling created the deployment.
  * - `codeDeployRollback`: A rollback process created the deployment.
- * - `CodeDeployAutoUpdate`: An auto-update process created the deployment when it detected outdated EC2 instances.
+ * - `CodeDeployAutoUpdate`: An auto-update process created the deployment when it detected outdated Amazon EC2
+ *   instances.
  */
 final class DeploymentCreator
 {

src/Enum/ErrorCode.php

@@ -3,7 +3,7 @@
 namespace AsyncAws\CodeDeploy\Enum;
 
 /**
- * For more information, see Error Codes for AWS CodeDeploy in the AWS CodeDeploy User Guide.
+ * For more information, see Error Codes for CodeDeploy in the CodeDeploy User Guide.
  * The error code:.
  *
  * - APPLICATION_MISSING: The application was missing. This error code is most likely raised if the application is
@@ -21,7 +21,7 @@
  * - NO_INSTANCES: No instances were specified, or no instances can be found.
  * - OVER_MAX_INSTANCES: The maximum number of instances was exceeded.
  * - THROTTLED: The operation was throttled because the calling account exceeded the throttling limits of one or more
- *   AWS services.
+ *   Amazon Web Services services.
  * - TIMEOUT: The deployment has timed out.
  * - REVISION_MISSING: The revision ID was missing. This error code is most likely raised if the revision is deleted
  *   after the deployment is created, but before it is started.

src/Enum/FileExistsBehavior.php

@@ -3,8 +3,8 @@
 namespace AsyncAws\CodeDeploy\Enum;
 
 /**
- * Information about how AWS CodeDeploy handles files that already exist in a deployment target location but weren't
- * part of the previous successful deployment.
+ * Information about how CodeDeploy handles files that already exist in a deployment target location but weren't part of
+ * the previous successful deployment.
  * The `fileExistsBehavior` parameter takes any of the following values:.
  *
  * - DISALLOW: The deployment fails. This is also the default behavior if no option is specified.

src/Enum/LifecycleEventStatus.php

@@ -3,8 +3,9 @@
 namespace AsyncAws\CodeDeploy\Enum;
 
 /**
- * The result of a Lambda function that validates a deployment lifecycle event. `Succeeded` and `Failed` are the only
- * valid values for `status`.
+ * The result of a Lambda function that validates a deployment lifecycle event. The values listed in **Valid Values**
+ * are valid for lifecycle statuses in general; however, only `Succeeded` and `Failed` can be passed successfully in
+ * your API call.
  */
 final class LifecycleEventStatus
 {

src/Enum/RevisionLocationType.php

@@ -7,9 +7,9 @@
  *
  * - S3: An application revision stored in Amazon S3.
  * - GitHub: An application revision stored in GitHub (EC2/On-premises deployments only).
- * - String: A YAML-formatted or JSON-formatted string (AWS Lambda deployments only).
- * - AppSpecContent: An `AppSpecContent` object that contains the contents of an AppSpec file for an AWS Lambda or
- *   Amazon ECS deployment. The content is formatted as JSON or YAML stored as a RawString.
+ * - String: A YAML-formatted or JSON-formatted string (Lambda deployments only).
+ * - AppSpecContent: An `AppSpecContent` object that contains the contents of an AppSpec file for an Lambda or Amazon
+ *   ECS deployment. The content is formatted as JSON or YAML stored as a RawString.
  */
 final class RevisionLocationType
 {

src/Exception/AlarmsLimitExceededException.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace AsyncAws\CodeDeploy\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * The maximum number of alarms for a deployment group (10) was exceeded.
+ */
+final class AlarmsLimitExceededException extends ClientException
+{
+}

src/Exception/ApplicationDoesNotExistException.php

@@ -5,7 +5,7 @@
 use AsyncAws\Core\Exception\Http\ClientException;
 
 /**
- * The application does not exist with the IAM user or AWS account.
+ * The application does not exist with the IAM user or Amazon Web Services account.
  */
 final class ApplicationDoesNotExistException extends ClientException
 {

src/Exception/DeploymentConfigDoesNotExistException.php

@@ -5,7 +5,7 @@
 use AsyncAws\Core\Exception\Http\ClientException;
 
 /**
- * The deployment configuration does not exist with the IAM user or AWS account.
+ * The deployment configuration does not exist with the IAM user or Amazon Web Services account.
  */
 final class DeploymentConfigDoesNotExistException extends ClientException
 {

src/Exception/DeploymentDoesNotExistException.php

@@ -5,7 +5,7 @@
 use AsyncAws\Core\Exception\Http\ClientException;
 
 /**
- * The deployment with the IAM user or AWS account does not exist.
+ * The deployment with the IAM user or Amazon Web Services account does not exist.
  */
 final class DeploymentDoesNotExistException extends ClientException
 {

src/Exception/DeploymentGroupDoesNotExistException.php

@@ -5,7 +5,7 @@
 use AsyncAws\Core\Exception\Http\ClientException;
 
 /**
- * The named deployment group with the IAM user or AWS account does not exist.
+ * The named deployment group with the IAM user or Amazon Web Services account does not exist.
  */
 final class DeploymentGroupDoesNotExistException extends ClientException
 {

src/Exception/InvalidAlarmConfigException.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace AsyncAws\CodeDeploy\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * The format of the alarm configuration is invalid. Possible causes include:.
+ *
+ * - The alarm list is null.
+ * - The alarm object is null.
+ * - The alarm name is empty or null or exceeds the limit of 255 characters.
+ * - Two alarms with the same name have been specified.
+ * - The alarm configuration is enabled, but the alarm list is empty.
+ */
+final class InvalidAlarmConfigException extends ClientException
+{
+}

src/Exception/InvalidFileExistsBehaviorException.php

@@ -5,7 +5,7 @@
 use AsyncAws\Core\Exception\Http\ClientException;
 
 /**
- * An invalid fileExistsBehavior option was specified to determine how AWS CodeDeploy handles files or directories that
+ * An invalid fileExistsBehavior option was specified to determine how CodeDeploy handles files or directories that
  * already exist in a deployment target location, but weren't part of the previous successful deployment. Valid values
  * include "DISALLOW," "OVERWRITE," and "RETAIN.".
  */

src/Exception/InvalidIgnoreApplicationStopFailuresValueException.php

@@ -5,8 +5,8 @@
 use AsyncAws\Core\Exception\Http\ClientException;
 
 /**
- * The IgnoreApplicationStopFailures value is invalid. For AWS Lambda deployments, `false` is expected. For
- * EC2/On-premises deployments, `true` or `false` is expected.
+ * The IgnoreApplicationStopFailures value is invalid. For Lambda deployments, `false` is expected. For EC2/On-premises
+ * deployments, `true` or `false` is expected.
  */
 final class InvalidIgnoreApplicationStopFailuresValueException extends ClientException
 {

src/Exception/InvalidUpdateOutdatedInstancesOnlyValueException.php

@@ -5,8 +5,8 @@
 use AsyncAws\Core\Exception\Http\ClientException;
 
 /**
- * The UpdateOutdatedInstancesOnly value is invalid. For AWS Lambda deployments, `false` is expected. For
- * EC2/On-premises deployments, `true` or `false` is expected.
+ * The UpdateOutdatedInstancesOnly value is invalid. For Lambda deployments, `false` is expected. For EC2/On-premises
+ * deployments, `true` or `false` is expected.
  */
 final class InvalidUpdateOutdatedInstancesOnlyValueException extends ClientException
 {

src/Exception/RevisionDoesNotExistException.php

@@ -5,7 +5,7 @@
 use AsyncAws\Core\Exception\Http\ClientException;
 
 /**
- * The named revision does not exist with the IAM user or AWS account.
+ * The named revision does not exist with the IAM user or Amazon Web Services account.
  */
 final class RevisionDoesNotExistException extends ClientException
 {

src/Input/CreateDeploymentInput.php

@@ -3,6 +3,8 @@
 namespace AsyncAws\CodeDeploy\Input;
 
 use AsyncAws\CodeDeploy\Enum\FileExistsBehavior;
+use AsyncAws\CodeDeploy\ValueObject\Alarm;
+use AsyncAws\CodeDeploy\ValueObject\AlarmConfiguration;
 use AsyncAws\CodeDeploy\ValueObject\AutoRollbackConfiguration;
 use AsyncAws\CodeDeploy\ValueObject\RevisionLocation;
 use AsyncAws\CodeDeploy\ValueObject\TargetInstances;
@@ -17,7 +19,7 @@
 final class CreateDeploymentInput extends Input
 {
     /**
-     * The name of an AWS CodeDeploy application associated with the IAM user or AWS account.
+     * The name of an CodeDeploy application associated with the IAM user or Amazon Web Services account.
      *
      * @required
      *
@@ -40,7 +42,7 @@ final class CreateDeploymentInput extends Input
     private $revision;
 
     /**
-     * The name of a deployment configuration associated with the IAM user or AWS account.
+     * The name of a deployment configuration associated with the IAM user or Amazon Web Services account.
      *
      * @var string|null
      */
@@ -87,13 +89,25 @@ final class CreateDeploymentInput extends Input
     private $updateOutdatedInstancesOnly;
 
     /**
-     * Information about how AWS CodeDeploy handles files that already exist in a deployment target location but weren't
-     * part of the previous successful deployment.
+     * Information about how CodeDeploy handles files that already exist in a deployment target location but weren't part of
+     * the previous successful deployment.
      *
      * @var FileExistsBehavior::*|null
      */
     private $fileExistsBehavior;
 
+    /**
+     * Allows you to specify information about alarms associated with a deployment. The alarm configuration that you specify
+     * here will override the alarm configuration at the deployment group level. Consider overriding the alarm configuration
+     * if you have set up alarms at the deployment group level that are causing deployment failures. In this case, you would
+     * call `CreateDeployment` to create a new deployment that uses a previous application revision that is known to work,
+     * and set its alarm configuration to turn off alarm polling. Turning off alarm polling ensures that the new deployment
+     * proceeds without being blocked by the alarm that was generated by the previous, failed, deployment.
+     *
+     * @var AlarmConfiguration|null
+     */
+    private $overrideAlarmConfiguration;
+
     /**
      * @param array{
      *   applicationName?: string,
@@ -106,6 +120,7 @@ final class CreateDeploymentInput extends Input
      *   autoRollbackConfiguration?: AutoRollbackConfiguration|array,
      *   updateOutdatedInstancesOnly?: bool,
      *   fileExistsBehavior?: FileExistsBehavior::*,
+     *   overrideAlarmConfiguration?: AlarmConfiguration|array,
      *   @region?: string,
      * } $input
      */
@@ -121,6 +136,7 @@ public function __construct(array $input = [])
         $this->autoRollbackConfiguration = isset($input['autoRollbackConfiguration']) ? AutoRollbackConfiguration::create($input['autoRollbackConfiguration']) : null;
         $this->updateOutdatedInstancesOnly = $input['updateOutdatedInstancesOnly'] ?? null;
         $this->fileExistsBehavior = $input['fileExistsBehavior'] ?? null;
+        $this->overrideAlarmConfiguration = isset($input['overrideAlarmConfiguration']) ? AlarmConfiguration::create($input['overrideAlarmConfiguration']) : null;
         parent::__construct($input);
     }
 
@@ -167,6 +183,11 @@ public function getIgnoreApplicationStopFailures(): ?bool
         return $this->ignoreApplicationStopFailures;
     }
 
+    public function getOverrideAlarmConfiguration(): ?AlarmConfiguration
+    {
+        return $this->overrideAlarmConfiguration;
+    }
+
     public function getRevision(): ?RevisionLocation
     {
         return $this->revision;
@@ -259,6 +280,13 @@ public function setIgnoreApplicationStopFailures(?bool $value): self
         return $this;
     }
 
+    public function setOverrideAlarmConfiguration(?AlarmConfiguration $value): self
+    {
+        $this->overrideAlarmConfiguration = $value;
+
+        return $this;
+    }
+
     public function setRevision(?RevisionLocation $value): self
     {
         $this->revision = $value;
@@ -317,6 +345,9 @@ private function requestBody(): array
             }
             $payload['fileExistsBehavior'] = $v;
         }
+        if (null !== $v = $this->overrideAlarmConfiguration) {
+            $payload['overrideAlarmConfiguration'] = $v->requestBody();
+        }
 
         return $payload;
     }

src/Input/GetDeploymentInput.php

@@ -13,7 +13,7 @@
 final class GetDeploymentInput extends Input
 {
     /**
-     * The unique ID of a deployment associated with the IAM user or AWS account.
+     * The unique ID of a deployment associated with the IAM user or Amazon Web Services account.
      *
      * @required
      *

src/Input/PutLifecycleEventHookExecutionStatusInput.php

@@ -26,8 +26,9 @@ final class PutLifecycleEventHookExecutionStatusInput extends Input
     private $lifecycleEventHookExecutionId;
 
     /**
-     * The result of a Lambda function that validates a deployment lifecycle event. `Succeeded` and `Failed` are the only
-     * valid values for `status`.
+     * The result of a Lambda function that validates a deployment lifecycle event. The values listed in **Valid Values**
+     * are valid for lifecycle statuses in general; however, only `Succeeded` and `Failed` can be passed successfully in
+     * your API call.
      *
      * @var LifecycleEventStatus::*|null
      */