aws-sdk-codedeploy 1.26.0 → 1.31.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
- SHA1:
3
- metadata.gz: 7f634c47785b0a0ea425a3c6e2a9ee1b1d65445b
4
- data.tar.gz: a341409823aa4a9437f9c0077292b5ac4fd28971
2
+ SHA256:
3
+ metadata.gz: 4052f0cbed72e3b8cd50aac31c4fdf0ecce0b12fefaca553ca50d444b37ccdf6
4
+ data.tar.gz: b77b18488aa62ba2df1608fb163253f9e9eb0094bf6e5024a89faa734da9b163
5
5
  SHA512:
6
- metadata.gz: 803eb2fec213e3e8c46e6f0062f2f80ec54673aa9b19ac48c486630c1ef58cc961f7bd035a6b60c8b71ea3c8de83a11d88fa6f8f089d28c3b3f1e6163aeef96d
7
- data.tar.gz: 0e9b0e09b978ddb03a33845519b23bb796d3319a779afb05b7e39424700c9b6141a48b74efbc9bdbde2d212757c2045e9aed27b3ddadf07664acc5abc12f1442
6
+ metadata.gz: e470d1ebdf744a2a4c675cba1e345447359bf17205c0ea9e47e3d2fab6f9789cdc54fc80eaa3d578d742a6cd346350db45e41fe82c123a37450f7eba34d6ef82
7
+ data.tar.gz: 0ddc247a7fc4c4250156d7f1eafcbad188753ae7b2575638239758af95a49067174878d796bf85807c806796dfc8f0d6e93fca1fc46db460805a26f1fae1f217
@@ -25,17 +25,20 @@ require_relative 'aws-sdk-codedeploy/customizations'
25
25
  # methods each accept a hash of request parameters and return a response
26
26
  # structure.
27
27
  #
28
+ # code_deploy = Aws::CodeDeploy::Client.new
29
+ # resp = code_deploy.add_tags_to_on_premises_instances(params)
30
+ #
28
31
  # See {Client} for more information.
29
32
  #
30
33
  # # Errors
31
34
  #
32
- # Errors returned from AWS CodeDeploy all
33
- # extend {Errors::ServiceError}.
35
+ # Errors returned from AWS CodeDeploy are defined in the
36
+ # {Errors} module and all extend {Errors::ServiceError}.
34
37
  #
35
38
  # begin
36
39
  # # do stuff
37
40
  # rescue Aws::CodeDeploy::Errors::ServiceError
38
- # # rescues all service API errors
41
+ # # rescues all AWS CodeDeploy API errors
39
42
  # end
40
43
  #
41
44
  # See {Errors} for more information.
@@ -43,6 +46,6 @@ require_relative 'aws-sdk-codedeploy/customizations'
43
46
  # @service
44
47
  module Aws::CodeDeploy
45
48
 
46
- GEM_VERSION = '1.26.0'
49
+ GEM_VERSION = '1.31.0'
47
50
 
48
51
  end
@@ -30,6 +30,18 @@ require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
30
30
  Aws::Plugins::GlobalConfiguration.add_identifier(:codedeploy)
31
31
 
32
32
  module Aws::CodeDeploy
33
+ # An API client for CodeDeploy. To construct a client, you need to configure a `:region` and `:credentials`.
34
+ #
35
+ # client = Aws::CodeDeploy::Client.new(
36
+ # region: region_name,
37
+ # credentials: credentials,
38
+ # # ...
39
+ # )
40
+ #
41
+ # For details on configuring region and credentials see
42
+ # the [developer guide](/sdk-for-ruby/v3/developer-guide/setup-config.html).
43
+ #
44
+ # See {#initialize} for a full list of supported configuration options.
33
45
  class Client < Seahorse::Client::Base
34
46
 
35
47
  include Aws::ClientStubs
@@ -93,7 +105,7 @@ module Aws::CodeDeploy
93
105
  # @option options [required, String] :region
94
106
  # The AWS region to connect to. The configured `:region` is
95
107
  # used to determine the service `:endpoint`. When not passed,
96
- # a default `:region` is search for in the following locations:
108
+ # a default `:region` is searched for in the following locations:
97
109
  #
98
110
  # * `Aws.config[:region]`
99
111
  # * `ENV['AWS_REGION']`
@@ -108,6 +120,12 @@ module Aws::CodeDeploy
108
120
  # When set to `true`, a thread polling for endpoints will be running in
109
121
  # the background every 60 secs (default). Defaults to `false`.
110
122
  #
123
+ # @option options [Boolean] :adaptive_retry_wait_to_fill (true)
124
+ # Used only in `adaptive` retry mode. When true, the request will sleep
125
+ # until there is sufficent client side capacity to retry the request.
126
+ # When false, the request will raise a `RetryCapacityNotAvailableError` and will
127
+ # not retry instead of sleeping.
128
+ #
111
129
  # @option options [Boolean] :client_side_monitoring (false)
112
130
  # When `true`, client-side metrics will be collected for all API requests from
113
131
  # this client.
@@ -132,6 +150,10 @@ module Aws::CodeDeploy
132
150
  # When `true`, an attempt is made to coerce request parameters into
133
151
  # the required types.
134
152
  #
153
+ # @option options [Boolean] :correct_clock_skew (true)
154
+ # Used only in `standard` and adaptive retry modes. Specifies whether to apply
155
+ # a clock skew correction and retry requests with skewed client clocks.
156
+ #
135
157
  # @option options [Boolean] :disable_host_prefix_injection (false)
136
158
  # Set to true to disable SDK automatically adding host prefix
137
159
  # to default service endpoint when available.
@@ -139,7 +161,7 @@ module Aws::CodeDeploy
139
161
  # @option options [String] :endpoint
140
162
  # The client endpoint is normally constructed from the `:region`
141
163
  # option. You should only configure an `:endpoint` when connecting
142
- # to test endpoints. This should be avalid HTTP(S) URI.
164
+ # to test endpoints. This should be a valid HTTP(S) URI.
143
165
  #
144
166
  # @option options [Integer] :endpoint_cache_max_entries (1000)
145
167
  # Used for the maximum size limit of the LRU cache storing endpoints data
@@ -154,7 +176,7 @@ module Aws::CodeDeploy
154
176
  # requests fetching endpoints information. Defaults to 60 sec.
155
177
  #
156
178
  # @option options [Boolean] :endpoint_discovery (false)
157
- # When set to `true`, endpoint discovery will be enabled for operations when available. Defaults to `false`.
179
+ # When set to `true`, endpoint discovery will be enabled for operations when available.
158
180
  #
159
181
  # @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
160
182
  # The log formatter.
@@ -166,15 +188,29 @@ module Aws::CodeDeploy
166
188
  # The Logger instance to send log messages to. If this option
167
189
  # is not set, logging will be disabled.
168
190
  #
191
+ # @option options [Integer] :max_attempts (3)
192
+ # An integer representing the maximum number attempts that will be made for
193
+ # a single request, including the initial attempt. For example,
194
+ # setting this value to 5 will result in a request being retried up to
195
+ # 4 times. Used in `standard` and `adaptive` retry modes.
196
+ #
169
197
  # @option options [String] :profile ("default")
170
198
  # Used when loading credentials from the shared credentials file
171
199
  # at HOME/.aws/credentials. When not specified, 'default' is used.
172
200
  #
201
+ # @option options [Proc] :retry_backoff
202
+ # A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay.
203
+ # This option is only used in the `legacy` retry mode.
204
+ #
173
205
  # @option options [Float] :retry_base_delay (0.3)
174
- # The base delay in seconds used by the default backoff function.
206
+ # The base delay in seconds used by the default backoff function. This option
207
+ # is only used in the `legacy` retry mode.
175
208
  #
176
209
  # @option options [Symbol] :retry_jitter (:none)
177
- # A delay randomiser function used by the default backoff function. Some predefined functions can be referenced by name - :none, :equal, :full, otherwise a Proc that takes and returns a number.
210
+ # A delay randomiser function used by the default backoff function.
211
+ # Some predefined functions can be referenced by name - :none, :equal, :full,
212
+ # otherwise a Proc that takes and returns a number. This option is only used
213
+ # in the `legacy` retry mode.
178
214
  #
179
215
  # @see https://www.awsarchitectureblog.com/2015/03/backoff.html
180
216
  #
@@ -182,11 +218,30 @@ module Aws::CodeDeploy
182
218
  # The maximum number of times to retry failed requests. Only
183
219
  # ~ 500 level server errors and certain ~ 400 level client errors
184
220
  # are retried. Generally, these are throttling errors, data
185
- # checksum errors, networking errors, timeout errors and auth
186
- # errors from expired credentials.
221
+ # checksum errors, networking errors, timeout errors, auth errors,
222
+ # endpoint discovery, and errors from expired credentials.
223
+ # This option is only used in the `legacy` retry mode.
187
224
  #
188
225
  # @option options [Integer] :retry_max_delay (0)
189
- # The maximum number of seconds to delay between retries (0 for no limit) used by the default backoff function.
226
+ # The maximum number of seconds to delay between retries (0 for no limit)
227
+ # used by the default backoff function. This option is only used in the
228
+ # `legacy` retry mode.
229
+ #
230
+ # @option options [String] :retry_mode ("legacy")
231
+ # Specifies which retry algorithm to use. Values are:
232
+ #
233
+ # * `legacy` - The pre-existing retry behavior. This is default value if
234
+ # no retry mode is provided.
235
+ #
236
+ # * `standard` - A standardized set of retry rules across the AWS SDKs.
237
+ # This includes support for retry quotas, which limit the number of
238
+ # unsuccessful retries a client can make.
239
+ #
240
+ # * `adaptive` - An experimental retry mode that includes all the
241
+ # functionality of `standard` mode along with automatic client side
242
+ # throttling. This is a provisional mode that may change behavior
243
+ # in the future.
244
+ #
190
245
  #
191
246
  # @option options [String] :secret_access_key
192
247
  #
@@ -219,16 +274,15 @@ module Aws::CodeDeploy
219
274
  # requests through. Formatted like 'http://proxy.com:123'.
220
275
  #
221
276
  # @option options [Float] :http_open_timeout (15) The number of
222
- # seconds to wait when opening a HTTP session before rasing a
277
+ # seconds to wait when opening a HTTP session before raising a
223
278
  # `Timeout::Error`.
224
279
  #
225
280
  # @option options [Integer] :http_read_timeout (60) The default
226
281
  # number of seconds to wait for response data. This value can
227
- # safely be set
228
- # per-request on the session yeidled by {#session_for}.
282
+ # safely be set per-request on the session.
229
283
  #
230
284
  # @option options [Float] :http_idle_timeout (5) The number of
231
- # seconds a connection is allowed to sit idble before it is
285
+ # seconds a connection is allowed to sit idle before it is
232
286
  # considered stale. Stale connections are closed and removed
233
287
  # from the pool before making a request.
234
288
  #
@@ -237,7 +291,7 @@ module Aws::CodeDeploy
237
291
  # request body. This option has no effect unless the request has
238
292
  # "Expect" header set to "100-continue". Defaults to `nil` which
239
293
  # disables this behaviour. This value can safely be set per
240
- # request on the session yeidled by {#session_for}.
294
+ # request on the session.
241
295
  #
242
296
  # @option options [Boolean] :http_wire_trace (false) When `true`,
243
297
  # HTTP debug output will be sent to the `:logger`.
@@ -380,11 +434,11 @@ module Aws::CodeDeploy
380
434
  end
381
435
 
382
436
  # Gets information about one or more applications. The maximum number of
383
- # applications that can be returned is 25.
437
+ # applications that can be returned is 100.
384
438
  #
385
439
  # @option params [required, Array<String>] :application_names
386
440
  # A list of application names separated by spaces. The maximum number of
387
- # application names you can specify is 25.
441
+ # application names you can specify is 100.
388
442
  #
389
443
  # @return [Types::BatchGetApplicationsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
390
444
  #
@@ -498,11 +552,11 @@ module Aws::CodeDeploy
498
552
  # resp.deployment_groups_info[0].load_balancer_info.target_group_pair_info_list[0].test_traffic_route.listener_arns #=> Array
499
553
  # resp.deployment_groups_info[0].load_balancer_info.target_group_pair_info_list[0].test_traffic_route.listener_arns[0] #=> String
500
554
  # resp.deployment_groups_info[0].last_successful_deployment.deployment_id #=> String
501
- # resp.deployment_groups_info[0].last_successful_deployment.status #=> String, one of "Created", "Queued", "InProgress", "Succeeded", "Failed", "Stopped", "Ready"
555
+ # resp.deployment_groups_info[0].last_successful_deployment.status #=> String, one of "Created", "Queued", "InProgress", "Baking", "Succeeded", "Failed", "Stopped", "Ready"
502
556
  # resp.deployment_groups_info[0].last_successful_deployment.end_time #=> Time
503
557
  # resp.deployment_groups_info[0].last_successful_deployment.create_time #=> Time
504
558
  # resp.deployment_groups_info[0].last_attempted_deployment.deployment_id #=> String
505
- # resp.deployment_groups_info[0].last_attempted_deployment.status #=> String, one of "Created", "Queued", "InProgress", "Succeeded", "Failed", "Stopped", "Ready"
559
+ # resp.deployment_groups_info[0].last_attempted_deployment.status #=> String, one of "Created", "Queued", "InProgress", "Baking", "Succeeded", "Failed", "Stopped", "Ready"
506
560
  # resp.deployment_groups_info[0].last_attempted_deployment.end_time #=> Time
507
561
  # resp.deployment_groups_info[0].last_attempted_deployment.create_time #=> Time
508
562
  # resp.deployment_groups_info[0].ec2_tag_set.ec2_tag_set_list #=> Array
@@ -594,7 +648,7 @@ module Aws::CodeDeploy
594
648
  # targets that can be returned is 25.
595
649
  #
596
650
  # The type of targets returned depends on the deployment's compute
597
- # platform:
651
+ # platform or deployment method:
598
652
  #
599
653
  # * **EC2/On-premises**\: Information about EC2 instance targets.
600
654
  #
@@ -602,6 +656,9 @@ module Aws::CodeDeploy
602
656
  #
603
657
  # * **Amazon ECS**\: Information about Amazon ECS service targets.
604
658
  #
659
+ # * **CloudFormation**\: Information about targets of blue/green
660
+ # deployments initiated by a CloudFormation stack update.
661
+ #
605
662
  # @option params [String] :deployment_id
606
663
  # The unique ID of a deployment.
607
664
  #
@@ -623,6 +680,10 @@ module Aws::CodeDeploy
623
680
  # the format `<clustername>:<servicename>`. Their target type is
624
681
  # `ecsTarget`.
625
682
  #
683
+ # * For deployments that are deployed with AWS CloudFormation, the
684
+ # target IDs are CloudFormation stack IDs. Their target type is
685
+ # `cloudFormationTarget`.
686
+ #
626
687
  # @return [Types::BatchGetDeploymentTargetsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
627
688
  #
628
689
  # * {Types::BatchGetDeploymentTargetsOutput#deployment_targets #deployment_targets} => Array&lt;Types::DeploymentTarget&gt;
@@ -637,7 +698,7 @@ module Aws::CodeDeploy
637
698
  # @example Response structure
638
699
  #
639
700
  # resp.deployment_targets #=> Array
640
- # resp.deployment_targets[0].deployment_target_type #=> String, one of "InstanceTarget", "LambdaTarget", "ECSTarget"
701
+ # resp.deployment_targets[0].deployment_target_type #=> String, one of "InstanceTarget", "LambdaTarget", "ECSTarget", "CloudFormationTarget"
641
702
  # resp.deployment_targets[0].instance_target.deployment_id #=> String
642
703
  # resp.deployment_targets[0].instance_target.target_id #=> String
643
704
  # resp.deployment_targets[0].instance_target.target_arn #=> String
@@ -695,6 +756,21 @@ module Aws::CodeDeploy
695
756
  # resp.deployment_targets[0].ecs_target.task_sets_info[0].traffic_weight #=> Float
696
757
  # resp.deployment_targets[0].ecs_target.task_sets_info[0].target_group.name #=> String
697
758
  # resp.deployment_targets[0].ecs_target.task_sets_info[0].task_set_label #=> String, one of "Blue", "Green"
759
+ # resp.deployment_targets[0].cloud_formation_target.deployment_id #=> String
760
+ # resp.deployment_targets[0].cloud_formation_target.target_id #=> String
761
+ # resp.deployment_targets[0].cloud_formation_target.last_updated_at #=> Time
762
+ # resp.deployment_targets[0].cloud_formation_target.lifecycle_events #=> Array
763
+ # resp.deployment_targets[0].cloud_formation_target.lifecycle_events[0].lifecycle_event_name #=> String
764
+ # resp.deployment_targets[0].cloud_formation_target.lifecycle_events[0].diagnostics.error_code #=> String, one of "Success", "ScriptMissing", "ScriptNotExecutable", "ScriptTimedOut", "ScriptFailed", "UnknownError"
765
+ # resp.deployment_targets[0].cloud_formation_target.lifecycle_events[0].diagnostics.script_name #=> String
766
+ # resp.deployment_targets[0].cloud_formation_target.lifecycle_events[0].diagnostics.message #=> String
767
+ # resp.deployment_targets[0].cloud_formation_target.lifecycle_events[0].diagnostics.log_tail #=> String
768
+ # resp.deployment_targets[0].cloud_formation_target.lifecycle_events[0].start_time #=> Time
769
+ # resp.deployment_targets[0].cloud_formation_target.lifecycle_events[0].end_time #=> Time
770
+ # resp.deployment_targets[0].cloud_formation_target.lifecycle_events[0].status #=> String, one of "Pending", "InProgress", "Succeeded", "Failed", "Skipped", "Unknown"
771
+ # resp.deployment_targets[0].cloud_formation_target.status #=> String, one of "Pending", "InProgress", "Succeeded", "Failed", "Skipped", "Unknown", "Ready"
772
+ # resp.deployment_targets[0].cloud_formation_target.resource_type #=> String
773
+ # resp.deployment_targets[0].cloud_formation_target.target_version_weight #=> Float
698
774
  #
699
775
  # @see http://docs.aws.amazon.com/goto/WebAPI/codedeploy-2014-10-06/BatchGetDeploymentTargets AWS API Documentation
700
776
  #
@@ -753,8 +829,8 @@ module Aws::CodeDeploy
753
829
  # resp.deployments_info[0].revision.string.sha256 #=> String
754
830
  # resp.deployments_info[0].revision.app_spec_content.content #=> String
755
831
  # resp.deployments_info[0].revision.app_spec_content.sha256 #=> String
756
- # resp.deployments_info[0].status #=> String, one of "Created", "Queued", "InProgress", "Succeeded", "Failed", "Stopped", "Ready"
757
- # resp.deployments_info[0].error_information.code #=> String, one of "AGENT_ISSUE", "ALARM_ACTIVE", "APPLICATION_MISSING", "AUTOSCALING_VALIDATION_ERROR", "AUTO_SCALING_CONFIGURATION", "AUTO_SCALING_IAM_ROLE_PERMISSIONS", "CODEDEPLOY_RESOURCE_CANNOT_BE_FOUND", "CUSTOMER_APPLICATION_UNHEALTHY", "DEPLOYMENT_GROUP_MISSING", "ECS_UPDATE_ERROR", "ELASTIC_LOAD_BALANCING_INVALID", "ELB_INVALID_INSTANCE", "HEALTH_CONSTRAINTS", "HEALTH_CONSTRAINTS_INVALID", "HOOK_EXECUTION_FAILURE", "IAM_ROLE_MISSING", "IAM_ROLE_PERMISSIONS", "INTERNAL_ERROR", "INVALID_ECS_SERVICE", "INVALID_LAMBDA_CONFIGURATION", "INVALID_LAMBDA_FUNCTION", "INVALID_REVISION", "MANUAL_STOP", "MISSING_BLUE_GREEN_DEPLOYMENT_CONFIGURATION", "MISSING_ELB_INFORMATION", "MISSING_GITHUB_TOKEN", "NO_EC2_SUBSCRIPTION", "NO_INSTANCES", "OVER_MAX_INSTANCES", "RESOURCE_LIMIT_EXCEEDED", "REVISION_MISSING", "THROTTLED", "TIMEOUT"
832
+ # resp.deployments_info[0].status #=> String, one of "Created", "Queued", "InProgress", "Baking", "Succeeded", "Failed", "Stopped", "Ready"
833
+ # resp.deployments_info[0].error_information.code #=> String, one of "AGENT_ISSUE", "ALARM_ACTIVE", "APPLICATION_MISSING", "AUTOSCALING_VALIDATION_ERROR", "AUTO_SCALING_CONFIGURATION", "AUTO_SCALING_IAM_ROLE_PERMISSIONS", "CODEDEPLOY_RESOURCE_CANNOT_BE_FOUND", "CUSTOMER_APPLICATION_UNHEALTHY", "DEPLOYMENT_GROUP_MISSING", "ECS_UPDATE_ERROR", "ELASTIC_LOAD_BALANCING_INVALID", "ELB_INVALID_INSTANCE", "HEALTH_CONSTRAINTS", "HEALTH_CONSTRAINTS_INVALID", "HOOK_EXECUTION_FAILURE", "IAM_ROLE_MISSING", "IAM_ROLE_PERMISSIONS", "INTERNAL_ERROR", "INVALID_ECS_SERVICE", "INVALID_LAMBDA_CONFIGURATION", "INVALID_LAMBDA_FUNCTION", "INVALID_REVISION", "MANUAL_STOP", "MISSING_BLUE_GREEN_DEPLOYMENT_CONFIGURATION", "MISSING_ELB_INFORMATION", "MISSING_GITHUB_TOKEN", "NO_EC2_SUBSCRIPTION", "NO_INSTANCES", "OVER_MAX_INSTANCES", "RESOURCE_LIMIT_EXCEEDED", "REVISION_MISSING", "THROTTLED", "TIMEOUT", "CLOUDFORMATION_STACK_FAILURE"
758
834
  # resp.deployments_info[0].error_information.message #=> String
759
835
  # resp.deployments_info[0].create_time #=> Time
760
836
  # resp.deployments_info[0].start_time #=> Time
@@ -766,7 +842,7 @@ module Aws::CodeDeploy
766
842
  # resp.deployments_info[0].deployment_overview.skipped #=> Integer
767
843
  # resp.deployments_info[0].deployment_overview.ready #=> Integer
768
844
  # resp.deployments_info[0].description #=> String
769
- # resp.deployments_info[0].creator #=> String, one of "user", "autoscaling", "codeDeployRollback"
845
+ # resp.deployments_info[0].creator #=> String, one of "user", "autoscaling", "codeDeployRollback", "CodeDeploy", "CloudFormation", "CloudFormationRollback"
770
846
  # resp.deployments_info[0].ignore_application_stop_failures #=> Boolean
771
847
  # resp.deployments_info[0].auto_rollback_configuration.enabled #=> Boolean
772
848
  # resp.deployments_info[0].auto_rollback_configuration.events #=> Array
@@ -810,6 +886,7 @@ module Aws::CodeDeploy
810
886
  # resp.deployments_info[0].deployment_status_messages #=> Array
811
887
  # resp.deployments_info[0].deployment_status_messages[0] #=> String
812
888
  # resp.deployments_info[0].compute_platform #=> String, one of "Server", "Lambda", "ECS"
889
+ # resp.deployments_info[0].external_id #=> String
813
890
  #
814
891
  # @see http://docs.aws.amazon.com/goto/WebAPI/codedeploy-2014-10-06/BatchGetDeployments AWS API Documentation
815
892
  #
@@ -871,10 +948,10 @@ module Aws::CodeDeploy
871
948
  # rerouting traffic to the replacement environment.
872
949
  #
873
950
  # @option params [String] :deployment_wait_type
874
- # The status of the deployment's waiting period. READY\_WAIT indicates
875
- # the deployment is ready to start shifting traffic. TERMINATION\_WAIT
876
- # indicates the traffic is shifted, but the original target is not
877
- # terminated.
951
+ # The status of the deployment's waiting period. `READY_WAIT` indicates
952
+ # that the deployment is ready to start shifting traffic.
953
+ # `TERMINATION_WAIT` indicates that the traffic is shifted, but the
954
+ # original target is not terminated.
878
955
  #
879
956
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
880
957
  #
@@ -958,20 +1035,20 @@ module Aws::CodeDeploy
958
1035
  #
959
1036
  # If not specified, the value configured in the deployment group is used
960
1037
  # as the default. If the deployment group does not have a deployment
961
- # configuration associated with it, CodeDeployDefault.OneAtATime is used
962
- # by default.
1038
+ # configuration associated with it, `CodeDeployDefault`.`OneAtATime` is
1039
+ # used by default.
963
1040
  #
964
1041
  # @option params [String] :description
965
1042
  # A comment about the deployment.
966
1043
  #
967
1044
  # @option params [Boolean] :ignore_application_stop_failures
968
- # If true, then if an ApplicationStop, BeforeBlockTraffic, or
969
- # AfterBlockTraffic deployment lifecycle event to an instance fails,
1045
+ # If true, then if an `ApplicationStop`, `BeforeBlockTraffic`, or
1046
+ # `AfterBlockTraffic` deployment lifecycle event to an instance fails,
970
1047
  # then the deployment continues to the next deployment lifecycle event.
971
- # For example, if ApplicationStop fails, the deployment continues with
972
- # DownloadBundle. If BeforeBlockTraffic fails, the deployment continues
973
- # with BlockTraffic. If AfterBlockTraffic fails, the deployment
974
- # continues with ApplicationStop.
1048
+ # For example, if `ApplicationStop` fails, the deployment continues with
1049
+ # `DownloadBundle`. If `BeforeBlockTraffic` fails, the deployment
1050
+ # continues with `BlockTraffic`. If `AfterBlockTraffic` fails, the
1051
+ # deployment continues with `ApplicationStop`.
975
1052
  #
976
1053
  # If false or not specified, then if a lifecycle event fails during a
977
1054
  # deployment to an instance, that deployment fails. If deployment to
@@ -980,8 +1057,8 @@ module Aws::CodeDeploy
980
1057
  # then a deployment to the next instance is attempted.
981
1058
  #
982
1059
  # During a deployment, the AWS CodeDeploy agent runs the scripts
983
- # specified for ApplicationStop, BeforeBlockTraffic, and
984
- # AfterBlockTraffic in the AppSpec file from the previous successful
1060
+ # specified for `ApplicationStop`, `BeforeBlockTraffic`, and
1061
+ # `AfterBlockTraffic` in the AppSpec file from the previous successful
985
1062
  # deployment. (All other scripts are run from the AppSpec file in the
986
1063
  # current deployment.) If one of these scripts contains an error and
987
1064
  # does not run successfully, the deployment can fail.
@@ -989,8 +1066,8 @@ module Aws::CodeDeploy
989
1066
  # If the cause of the failure is a script from the last successful
990
1067
  # deployment that will never run successfully, create a new deployment
991
1068
  # and use `ignoreApplicationStopFailures` to specify that the
992
- # ApplicationStop, BeforeBlockTraffic, and AfterBlockTraffic failures
993
- # should be ignored.
1069
+ # `ApplicationStop`, `BeforeBlockTraffic`, and `AfterBlockTraffic`
1070
+ # failures should be ignored.
994
1071
  #
995
1072
  # @option params [Types::TargetInstances] :target_instances
996
1073
  # Information about the instances that belong to the replacement
@@ -1009,7 +1086,7 @@ module Aws::CodeDeploy
1009
1086
  # in a deployment target location but weren't part of the previous
1010
1087
  # successful deployment.
1011
1088
  #
1012
- # The fileExistsBehavior parameter takes any of the following values:
1089
+ # The `fileExistsBehavior` parameter takes any of the following values:
1013
1090
  #
1014
1091
  # * DISALLOW: The deployment fails. This is also the default behavior if
1015
1092
  # no option is specified.
@@ -1116,7 +1193,7 @@ module Aws::CodeDeploy
1116
1193
  # healthy instances as a percentage of the total number of instances
1117
1194
  # in the deployment. If you specify FLEET\_PERCENT, at the start of
1118
1195
  # the deployment, AWS CodeDeploy converts the percentage to the
1119
- # equivalent number of instance and rounds up fractional instances.
1196
+ # equivalent number of instances and rounds up fractional instances.
1120
1197
  #
1121
1198
  # The value parameter takes an integer.
1122
1199
  #
@@ -1185,13 +1262,13 @@ module Aws::CodeDeploy
1185
1262
  # deployment configuration that you create by calling the create
1186
1263
  # deployment configuration operation.
1187
1264
  #
1188
- # CodeDeployDefault.OneAtATime is the default deployment configuration.
1189
- # It is used if a configuration isn't specified for the deployment or
1190
- # deployment group.
1265
+ # `CodeDeployDefault.OneAtATime` is the default deployment
1266
+ # configuration. It is used if a configuration isn't specified for the
1267
+ # deployment or deployment group.
1191
1268
  #
1192
1269
  # For more information about the predefined deployment configurations in
1193
- # AWS CodeDeploy, see [Working with Deployment Groups in AWS
1194
- # CodeDeploy][1] in the AWS CodeDeploy User Guide.
1270
+ # AWS CodeDeploy, see [Working with Deployment Configurations in
1271
+ # CodeDeploy][1] in the *AWS CodeDeploy User Guide*.
1195
1272
  #
1196
1273
  #
1197
1274
  #
@@ -1205,19 +1282,19 @@ module Aws::CodeDeploy
1205
1282
  # @option params [Array<Types::TagFilter>] :on_premises_instance_tag_filters
1206
1283
  # The on-premises instance tags on which to filter. The deployment group
1207
1284
  # includes on-premises instances with any of the specified tags. Cannot
1208
- # be used in the same call as OnPremisesTagSet.
1285
+ # be used in the same call as `OnPremisesTagSet`.
1209
1286
  #
1210
1287
  # @option params [Array<String>] :auto_scaling_groups
1211
1288
  # A list of associated Amazon EC2 Auto Scaling groups.
1212
1289
  #
1213
1290
  # @option params [required, String] :service_role_arn
1214
- # A service role ARN that allows AWS CodeDeploy to act on the user's
1215
- # behalf when interacting with AWS services.
1291
+ # A service role Amazon Resource Name (ARN) that allows AWS CodeDeploy
1292
+ # to act on the user's behalf when interacting with AWS services.
1216
1293
  #
1217
1294
  # @option params [Array<Types::TriggerConfig>] :trigger_configurations
1218
1295
  # Information about triggers to create when the deployment group is
1219
1296
  # created. For examples, see [Create a Trigger for an AWS CodeDeploy
1220
- # Event][1] in the AWS CodeDeploy User Guide.
1297
+ # Event][1] in the *AWS CodeDeploy User Guide*.
1221
1298
  #
1222
1299
  #
1223
1300
  #
@@ -1246,7 +1323,7 @@ module Aws::CodeDeploy
1246
1323
  # @option params [Types::EC2TagSet] :ec2_tag_set
1247
1324
  # Information about groups of tags applied to EC2 instances. The
1248
1325
  # deployment group includes only EC2 instances identified by all the tag
1249
- # groups. Cannot be used in the same call as ec2TagFilters.
1326
+ # groups. Cannot be used in the same call as `ec2TagFilters`.
1250
1327
  #
1251
1328
  # @option params [Array<Types::ECSService>] :ecs_services
1252
1329
  # The target Amazon ECS services in the deployment group. This applies
@@ -1258,7 +1335,7 @@ module Aws::CodeDeploy
1258
1335
  # Information about groups of tags applied to on-premises instances. The
1259
1336
  # deployment group includes only on-premises instances identified by all
1260
1337
  # of the tag groups. Cannot be used in the same call as
1261
- # onPremisesInstanceTagFilters.
1338
+ # `onPremisesInstanceTagFilters`.
1262
1339
  #
1263
1340
  # @option params [Array<Types::Tag>] :tags
1264
1341
  # The metadata that you apply to CodeDeploy deployment groups to help
@@ -1518,6 +1595,29 @@ module Aws::CodeDeploy
1518
1595
  req.send_request(options)
1519
1596
  end
1520
1597
 
1598
+ # Deletes resources linked to an external ID.
1599
+ #
1600
+ # @option params [String] :external_id
1601
+ # The unique ID of an external resource (for example, a CloudFormation
1602
+ # stack ID) that is linked to one or more CodeDeploy resources.
1603
+ #
1604
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1605
+ #
1606
+ # @example Request syntax with placeholder values
1607
+ #
1608
+ # resp = client.delete_resources_by_external_id({
1609
+ # external_id: "ExternalId",
1610
+ # })
1611
+ #
1612
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codedeploy-2014-10-06/DeleteResourcesByExternalId AWS API Documentation
1613
+ #
1614
+ # @overload delete_resources_by_external_id(params = {})
1615
+ # @param [Hash] params ({})
1616
+ def delete_resources_by_external_id(params = {}, options = {})
1617
+ req = build_request(:delete_resources_by_external_id, params)
1618
+ req.send_request(options)
1619
+ end
1620
+
1521
1621
  # Deregisters an on-premises instance.
1522
1622
  #
1523
1623
  # @option params [required, String] :instance_name
@@ -1701,8 +1801,8 @@ module Aws::CodeDeploy
1701
1801
  # resp.deployment_info.revision.string.sha256 #=> String
1702
1802
  # resp.deployment_info.revision.app_spec_content.content #=> String
1703
1803
  # resp.deployment_info.revision.app_spec_content.sha256 #=> String
1704
- # resp.deployment_info.status #=> String, one of "Created", "Queued", "InProgress", "Succeeded", "Failed", "Stopped", "Ready"
1705
- # resp.deployment_info.error_information.code #=> String, one of "AGENT_ISSUE", "ALARM_ACTIVE", "APPLICATION_MISSING", "AUTOSCALING_VALIDATION_ERROR", "AUTO_SCALING_CONFIGURATION", "AUTO_SCALING_IAM_ROLE_PERMISSIONS", "CODEDEPLOY_RESOURCE_CANNOT_BE_FOUND", "CUSTOMER_APPLICATION_UNHEALTHY", "DEPLOYMENT_GROUP_MISSING", "ECS_UPDATE_ERROR", "ELASTIC_LOAD_BALANCING_INVALID", "ELB_INVALID_INSTANCE", "HEALTH_CONSTRAINTS", "HEALTH_CONSTRAINTS_INVALID", "HOOK_EXECUTION_FAILURE", "IAM_ROLE_MISSING", "IAM_ROLE_PERMISSIONS", "INTERNAL_ERROR", "INVALID_ECS_SERVICE", "INVALID_LAMBDA_CONFIGURATION", "INVALID_LAMBDA_FUNCTION", "INVALID_REVISION", "MANUAL_STOP", "MISSING_BLUE_GREEN_DEPLOYMENT_CONFIGURATION", "MISSING_ELB_INFORMATION", "MISSING_GITHUB_TOKEN", "NO_EC2_SUBSCRIPTION", "NO_INSTANCES", "OVER_MAX_INSTANCES", "RESOURCE_LIMIT_EXCEEDED", "REVISION_MISSING", "THROTTLED", "TIMEOUT"
1804
+ # resp.deployment_info.status #=> String, one of "Created", "Queued", "InProgress", "Baking", "Succeeded", "Failed", "Stopped", "Ready"
1805
+ # resp.deployment_info.error_information.code #=> String, one of "AGENT_ISSUE", "ALARM_ACTIVE", "APPLICATION_MISSING", "AUTOSCALING_VALIDATION_ERROR", "AUTO_SCALING_CONFIGURATION", "AUTO_SCALING_IAM_ROLE_PERMISSIONS", "CODEDEPLOY_RESOURCE_CANNOT_BE_FOUND", "CUSTOMER_APPLICATION_UNHEALTHY", "DEPLOYMENT_GROUP_MISSING", "ECS_UPDATE_ERROR", "ELASTIC_LOAD_BALANCING_INVALID", "ELB_INVALID_INSTANCE", "HEALTH_CONSTRAINTS", "HEALTH_CONSTRAINTS_INVALID", "HOOK_EXECUTION_FAILURE", "IAM_ROLE_MISSING", "IAM_ROLE_PERMISSIONS", "INTERNAL_ERROR", "INVALID_ECS_SERVICE", "INVALID_LAMBDA_CONFIGURATION", "INVALID_LAMBDA_FUNCTION", "INVALID_REVISION", "MANUAL_STOP", "MISSING_BLUE_GREEN_DEPLOYMENT_CONFIGURATION", "MISSING_ELB_INFORMATION", "MISSING_GITHUB_TOKEN", "NO_EC2_SUBSCRIPTION", "NO_INSTANCES", "OVER_MAX_INSTANCES", "RESOURCE_LIMIT_EXCEEDED", "REVISION_MISSING", "THROTTLED", "TIMEOUT", "CLOUDFORMATION_STACK_FAILURE"
1706
1806
  # resp.deployment_info.error_information.message #=> String
1707
1807
  # resp.deployment_info.create_time #=> Time
1708
1808
  # resp.deployment_info.start_time #=> Time
@@ -1714,7 +1814,7 @@ module Aws::CodeDeploy
1714
1814
  # resp.deployment_info.deployment_overview.skipped #=> Integer
1715
1815
  # resp.deployment_info.deployment_overview.ready #=> Integer
1716
1816
  # resp.deployment_info.description #=> String
1717
- # resp.deployment_info.creator #=> String, one of "user", "autoscaling", "codeDeployRollback"
1817
+ # resp.deployment_info.creator #=> String, one of "user", "autoscaling", "codeDeployRollback", "CodeDeploy", "CloudFormation", "CloudFormationRollback"
1718
1818
  # resp.deployment_info.ignore_application_stop_failures #=> Boolean
1719
1819
  # resp.deployment_info.auto_rollback_configuration.enabled #=> Boolean
1720
1820
  # resp.deployment_info.auto_rollback_configuration.events #=> Array
@@ -1758,6 +1858,12 @@ module Aws::CodeDeploy
1758
1858
  # resp.deployment_info.deployment_status_messages #=> Array
1759
1859
  # resp.deployment_info.deployment_status_messages[0] #=> String
1760
1860
  # resp.deployment_info.compute_platform #=> String, one of "Server", "Lambda", "ECS"
1861
+ # resp.deployment_info.external_id #=> String
1862
+ #
1863
+ #
1864
+ # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
1865
+ #
1866
+ # * deployment_successful
1761
1867
  #
1762
1868
  # @see http://docs.aws.amazon.com/goto/WebAPI/codedeploy-2014-10-06/GetDeployment AWS API Documentation
1763
1869
  #
@@ -1888,11 +1994,11 @@ module Aws::CodeDeploy
1888
1994
  # resp.deployment_group_info.load_balancer_info.target_group_pair_info_list[0].test_traffic_route.listener_arns #=> Array
1889
1995
  # resp.deployment_group_info.load_balancer_info.target_group_pair_info_list[0].test_traffic_route.listener_arns[0] #=> String
1890
1996
  # resp.deployment_group_info.last_successful_deployment.deployment_id #=> String
1891
- # resp.deployment_group_info.last_successful_deployment.status #=> String, one of "Created", "Queued", "InProgress", "Succeeded", "Failed", "Stopped", "Ready"
1997
+ # resp.deployment_group_info.last_successful_deployment.status #=> String, one of "Created", "Queued", "InProgress", "Baking", "Succeeded", "Failed", "Stopped", "Ready"
1892
1998
  # resp.deployment_group_info.last_successful_deployment.end_time #=> Time
1893
1999
  # resp.deployment_group_info.last_successful_deployment.create_time #=> Time
1894
2000
  # resp.deployment_group_info.last_attempted_deployment.deployment_id #=> String
1895
- # resp.deployment_group_info.last_attempted_deployment.status #=> String, one of "Created", "Queued", "InProgress", "Succeeded", "Failed", "Stopped", "Ready"
2001
+ # resp.deployment_group_info.last_attempted_deployment.status #=> String, one of "Created", "Queued", "InProgress", "Baking", "Succeeded", "Failed", "Stopped", "Ready"
1896
2002
  # resp.deployment_group_info.last_attempted_deployment.end_time #=> Time
1897
2003
  # resp.deployment_group_info.last_attempted_deployment.create_time #=> Time
1898
2004
  # resp.deployment_group_info.ec2_tag_set.ec2_tag_set_list #=> Array
@@ -1985,7 +2091,7 @@ module Aws::CodeDeploy
1985
2091
  #
1986
2092
  # @example Response structure
1987
2093
  #
1988
- # resp.deployment_target.deployment_target_type #=> String, one of "InstanceTarget", "LambdaTarget", "ECSTarget"
2094
+ # resp.deployment_target.deployment_target_type #=> String, one of "InstanceTarget", "LambdaTarget", "ECSTarget", "CloudFormationTarget"
1989
2095
  # resp.deployment_target.instance_target.deployment_id #=> String
1990
2096
  # resp.deployment_target.instance_target.target_id #=> String
1991
2097
  # resp.deployment_target.instance_target.target_arn #=> String
@@ -2043,6 +2149,21 @@ module Aws::CodeDeploy
2043
2149
  # resp.deployment_target.ecs_target.task_sets_info[0].traffic_weight #=> Float
2044
2150
  # resp.deployment_target.ecs_target.task_sets_info[0].target_group.name #=> String
2045
2151
  # resp.deployment_target.ecs_target.task_sets_info[0].task_set_label #=> String, one of "Blue", "Green"
2152
+ # resp.deployment_target.cloud_formation_target.deployment_id #=> String
2153
+ # resp.deployment_target.cloud_formation_target.target_id #=> String
2154
+ # resp.deployment_target.cloud_formation_target.last_updated_at #=> Time
2155
+ # resp.deployment_target.cloud_formation_target.lifecycle_events #=> Array
2156
+ # resp.deployment_target.cloud_formation_target.lifecycle_events[0].lifecycle_event_name #=> String
2157
+ # resp.deployment_target.cloud_formation_target.lifecycle_events[0].diagnostics.error_code #=> String, one of "Success", "ScriptMissing", "ScriptNotExecutable", "ScriptTimedOut", "ScriptFailed", "UnknownError"
2158
+ # resp.deployment_target.cloud_formation_target.lifecycle_events[0].diagnostics.script_name #=> String
2159
+ # resp.deployment_target.cloud_formation_target.lifecycle_events[0].diagnostics.message #=> String
2160
+ # resp.deployment_target.cloud_formation_target.lifecycle_events[0].diagnostics.log_tail #=> String
2161
+ # resp.deployment_target.cloud_formation_target.lifecycle_events[0].start_time #=> Time
2162
+ # resp.deployment_target.cloud_formation_target.lifecycle_events[0].end_time #=> Time
2163
+ # resp.deployment_target.cloud_formation_target.lifecycle_events[0].status #=> String, one of "Pending", "InProgress", "Succeeded", "Failed", "Skipped", "Unknown"
2164
+ # resp.deployment_target.cloud_formation_target.status #=> String, one of "Pending", "InProgress", "Succeeded", "Failed", "Skipped", "Unknown", "Ready"
2165
+ # resp.deployment_target.cloud_formation_target.resource_type #=> String
2166
+ # resp.deployment_target.cloud_formation_target.target_version_weight #=> Float
2046
2167
  #
2047
2168
  # @see http://docs.aws.amazon.com/goto/WebAPI/codedeploy-2014-10-06/GetDeploymentTarget AWS API Documentation
2048
2169
  #
@@ -2098,13 +2219,13 @@ module Aws::CodeDeploy
2098
2219
  # @option params [String] :sort_by
2099
2220
  # The column name to use to sort the list results:
2100
2221
  #
2101
- # * registerTime: Sort by the time the revisions were registered with
2222
+ # * `registerTime`\: Sort by the time the revisions were registered with
2102
2223
  # AWS CodeDeploy.
2103
2224
  #
2104
- # * firstUsedTime: Sort by the time the revisions were first used in a
2105
- # deployment.
2225
+ # * `firstUsedTime`\: Sort by the time the revisions were first used in
2226
+ # a deployment.
2106
2227
  #
2107
- # * lastUsedTime: Sort by the time the revisions were last used in a
2228
+ # * `lastUsedTime`\: Sort by the time the revisions were last used in a
2108
2229
  # deployment.
2109
2230
  #
2110
2231
  # If not specified or set to null, the results are returned in an
@@ -2113,9 +2234,9 @@ module Aws::CodeDeploy
2113
2234
  # @option params [String] :sort_order
2114
2235
  # The order in which to sort the list results:
2115
2236
  #
2116
- # * ascending: ascending order.
2237
+ # * `ascending`\: ascending order.
2117
2238
  #
2118
- # * descending: descending order.
2239
+ # * `descending`\: descending order.
2119
2240
  #
2120
2241
  # If not specified, the results are sorted in ascending order.
2121
2242
  #
@@ -2132,15 +2253,15 @@ module Aws::CodeDeploy
2132
2253
  #
2133
2254
  # @option params [String] :deployed
2134
2255
  # Whether to list revisions based on whether the revision is the target
2135
- # revision of an deployment group:
2256
+ # revision of a deployment group:
2136
2257
  #
2137
- # * include: List revisions that are target revisions of a deployment
2258
+ # * `include`\: List revisions that are target revisions of a deployment
2138
2259
  # group.
2139
2260
  #
2140
- # * exclude: Do not list revisions that are target revisions of a
2261
+ # * `exclude`\: Do not list revisions that are target revisions of a
2141
2262
  # deployment group.
2142
2263
  #
2143
- # * ignore: List all revisions.
2264
+ # * `ignore`\: List all revisions.
2144
2265
  #
2145
2266
  # @option params [String] :next_token
2146
2267
  # An identifier returned from the previous `ListApplicationRevisions`
@@ -2152,6 +2273,8 @@ module Aws::CodeDeploy
2152
2273
  # * {Types::ListApplicationRevisionsOutput#revisions #revisions} => Array&lt;Types::RevisionLocation&gt;
2153
2274
  # * {Types::ListApplicationRevisionsOutput#next_token #next_token} => String
2154
2275
  #
2276
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2277
+ #
2155
2278
  # @example Request syntax with placeholder values
2156
2279
  #
2157
2280
  # resp = client.list_application_revisions({
@@ -2201,6 +2324,8 @@ module Aws::CodeDeploy
2201
2324
  # * {Types::ListApplicationsOutput#applications #applications} => Array&lt;String&gt;
2202
2325
  # * {Types::ListApplicationsOutput#next_token #next_token} => String
2203
2326
  #
2327
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2328
+ #
2204
2329
  # @example Request syntax with placeholder values
2205
2330
  #
2206
2331
  # resp = client.list_applications({
@@ -2234,6 +2359,8 @@ module Aws::CodeDeploy
2234
2359
  # * {Types::ListDeploymentConfigsOutput#deployment_configs_list #deployment_configs_list} => Array&lt;String&gt;
2235
2360
  # * {Types::ListDeploymentConfigsOutput#next_token #next_token} => String
2236
2361
  #
2362
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2363
+ #
2237
2364
  # @example Request syntax with placeholder values
2238
2365
  #
2239
2366
  # resp = client.list_deployment_configs({
@@ -2273,6 +2400,8 @@ module Aws::CodeDeploy
2273
2400
  # * {Types::ListDeploymentGroupsOutput#deployment_groups #deployment_groups} => Array&lt;String&gt;
2274
2401
  # * {Types::ListDeploymentGroupsOutput#next_token #next_token} => String
2275
2402
  #
2403
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2404
+ #
2276
2405
  # @example Request syntax with placeholder values
2277
2406
  #
2278
2407
  # resp = client.list_deployment_groups({
@@ -2296,8 +2425,8 @@ module Aws::CodeDeploy
2296
2425
  req.send_request(options)
2297
2426
  end
2298
2427
 
2299
- # <note markdown="1"> The newer BatchGetDeploymentTargets should be used instead because it
2300
- # works with all compute types. `ListDeploymentInstances` throws an
2428
+ # <note markdown="1"> The newer `BatchGetDeploymentTargets` should be used instead because
2429
+ # it works with all compute types. `ListDeploymentInstances` throws an
2301
2430
  # exception if it is used with a compute platform other than
2302
2431
  # EC2/On-premises or AWS Lambda.
2303
2432
  #
@@ -2317,18 +2446,18 @@ module Aws::CodeDeploy
2317
2446
  # @option params [Array<String>] :instance_status_filter
2318
2447
  # A subset of instances to list by status:
2319
2448
  #
2320
- # * Pending: Include those instances with pending deployments.
2449
+ # * `Pending`\: Include those instances with pending deployments.
2321
2450
  #
2322
- # * InProgress: Include those instances where deployments are still in
2323
- # progress.
2451
+ # * `InProgress`\: Include those instances where deployments are still
2452
+ # in progress.
2324
2453
  #
2325
- # * Succeeded: Include those instances with successful deployments.
2454
+ # * `Succeeded`\: Include those instances with successful deployments.
2326
2455
  #
2327
- # * Failed: Include those instances with failed deployments.
2456
+ # * `Failed`\: Include those instances with failed deployments.
2328
2457
  #
2329
- # * Skipped: Include those instances with skipped deployments.
2458
+ # * `Skipped`\: Include those instances with skipped deployments.
2330
2459
  #
2331
- # * Unknown: Include those instances with deployments in an unknown
2460
+ # * `Unknown`\: Include those instances with deployments in an unknown
2332
2461
  # state.
2333
2462
  #
2334
2463
  # @option params [Array<String>] :instance_type_filter
@@ -2342,6 +2471,8 @@ module Aws::CodeDeploy
2342
2471
  # * {Types::ListDeploymentInstancesOutput#instances_list #instances_list} => Array&lt;String&gt;
2343
2472
  # * {Types::ListDeploymentInstancesOutput#next_token #next_token} => String
2344
2473
  #
2474
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2475
+ #
2345
2476
  # @example Request syntax with placeholder values
2346
2477
  #
2347
2478
  # resp = client.list_deployment_instances({
@@ -2438,20 +2569,25 @@ module Aws::CodeDeploy
2438
2569
  #
2439
2570
  # </note>
2440
2571
  #
2572
+ # @option params [String] :external_id
2573
+ # The unique ID of an external resource for returning deployments linked
2574
+ # to the external resource.
2575
+ #
2441
2576
  # @option params [Array<String>] :include_only_statuses
2442
2577
  # A subset of deployments to list by status:
2443
2578
  #
2444
- # * Created: Include created deployments in the resulting list.
2579
+ # * `Created`\: Include created deployments in the resulting list.
2445
2580
  #
2446
- # * Queued: Include queued deployments in the resulting list.
2581
+ # * `Queued`\: Include queued deployments in the resulting list.
2447
2582
  #
2448
- # * In Progress: Include in-progress deployments in the resulting list.
2583
+ # * `In Progress`\: Include in-progress deployments in the resulting
2584
+ # list.
2449
2585
  #
2450
- # * Succeeded: Include successful deployments in the resulting list.
2586
+ # * `Succeeded`\: Include successful deployments in the resulting list.
2451
2587
  #
2452
- # * Failed: Include failed deployments in the resulting list.
2588
+ # * `Failed`\: Include failed deployments in the resulting list.
2453
2589
  #
2454
- # * Stopped: Include stopped deployments in the resulting list.
2590
+ # * `Stopped`\: Include stopped deployments in the resulting list.
2455
2591
  #
2456
2592
  # @option params [Types::TimeRange] :create_time_range
2457
2593
  # A time range (start and end) for returning a subset of the list of
@@ -2466,12 +2602,15 @@ module Aws::CodeDeploy
2466
2602
  # * {Types::ListDeploymentsOutput#deployments #deployments} => Array&lt;String&gt;
2467
2603
  # * {Types::ListDeploymentsOutput#next_token #next_token} => String
2468
2604
  #
2605
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2606
+ #
2469
2607
  # @example Request syntax with placeholder values
2470
2608
  #
2471
2609
  # resp = client.list_deployments({
2472
2610
  # application_name: "ApplicationName",
2473
2611
  # deployment_group_name: "DeploymentGroupName",
2474
- # include_only_statuses: ["Created"], # accepts Created, Queued, InProgress, Succeeded, Failed, Stopped, Ready
2612
+ # external_id: "ExternalId",
2613
+ # include_only_statuses: ["Created"], # accepts Created, Queued, InProgress, Baking, Succeeded, Failed, Stopped, Ready
2475
2614
  # create_time_range: {
2476
2615
  # start: Time.now,
2477
2616
  # end: Time.now,
@@ -2497,7 +2636,7 @@ module Aws::CodeDeploy
2497
2636
  # Lists the names of stored connections to GitHub accounts.
2498
2637
  #
2499
2638
  # @option params [String] :next_token
2500
- # An identifier returned from the previous ListGitHubAccountTokenNames
2639
+ # An identifier returned from the previous `ListGitHubAccountTokenNames`
2501
2640
  # call. It can be used to return the next set of names in the list.
2502
2641
  #
2503
2642
  # @return [Types::ListGitHubAccountTokenNamesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -2536,10 +2675,10 @@ module Aws::CodeDeploy
2536
2675
  # @option params [String] :registration_status
2537
2676
  # The registration status of the on-premises instances:
2538
2677
  #
2539
- # * Deregistered: Include deregistered on-premises instances in the
2678
+ # * `Deregistered`\: Include deregistered on-premises instances in the
2540
2679
  # resulting list.
2541
2680
  #
2542
- # * Registered: Include registered on-premises instances in the
2681
+ # * `Registered`\: Include registered on-premises instances in the
2543
2682
  # resulting list.
2544
2683
  #
2545
2684
  # @option params [Array<Types::TagFilter>] :tag_filters
@@ -2585,8 +2724,9 @@ module Aws::CodeDeploy
2585
2724
  req.send_request(options)
2586
2725
  end
2587
2726
 
2588
- # Returns a list of tags for the resource identified by a specified ARN.
2589
- # Tags are used to organize and categorize your CodeDeploy resources.
2727
+ # Returns a list of tags for the resource identified by a specified
2728
+ # Amazon Resource Name (ARN). Tags are used to organize and categorize
2729
+ # your CodeDeploy resources.
2590
2730
  #
2591
2731
  # @option params [required, String] :resource_arn
2592
2732
  # The ARN of a CodeDeploy resource. `ListTagsForResource` returns all
@@ -2626,8 +2766,21 @@ module Aws::CodeDeploy
2626
2766
  end
2627
2767
 
2628
2768
  # Sets the result of a Lambda validation function. The function
2629
- # validates one or both lifecycle events (`BeforeAllowTraffic` and
2630
- # `AfterAllowTraffic`) and returns `Succeeded` or `Failed`.
2769
+ # validates lifecycle hooks during a deployment that uses the AWS Lambda
2770
+ # or Amazon ECS compute platform. For AWS Lambda deployments, the
2771
+ # available lifecycle hooks are `BeforeAllowTraffic` and
2772
+ # `AfterAllowTraffic`. For Amazon ECS deployments, the available
2773
+ # lifecycle hooks are `BeforeInstall`, `AfterInstall`,
2774
+ # `AfterAllowTestTraffic`, `BeforeAllowTraffic`, and
2775
+ # `AfterAllowTraffic`. Lambda validation functions return `Succeeded` or
2776
+ # `Failed`. For more information, see [AppSpec 'hooks' Section for an
2777
+ # AWS Lambda Deployment ][1] and [AppSpec 'hooks' Section for an
2778
+ # Amazon ECS Deployment][2].
2779
+ #
2780
+ #
2781
+ #
2782
+ # [1]: https://docs.aws.amazon.com/codedeploy/latest/userguide/reference-appspec-file-structure-hooks.html#appspec-hooks-lambda
2783
+ # [2]: https://docs.aws.amazon.com/codedeploy/latest/userguide/reference-appspec-file-structure-hooks.html#appspec-hooks-ecs
2631
2784
  #
2632
2785
  # @option params [String] :deployment_id
2633
2786
  # The unique ID of a deployment. Pass this ID to a Lambda function that
@@ -2884,11 +3037,11 @@ module Aws::CodeDeploy
2884
3037
 
2885
3038
  # Disassociates a resource from a list of tags. The resource is
2886
3039
  # identified by the `ResourceArn` input parameter. The tags are
2887
- # identfied by the list of keys in the `TagKeys` input parameter.
3040
+ # identified by the list of keys in the `TagKeys` input parameter.
2888
3041
  #
2889
3042
  # @option params [required, String] :resource_arn
2890
- # The ARN that specifies from which resource to disassociate the tags
2891
- # with the keys in the `TagKeys` input paramter.
3043
+ # The Amazon Resource Name (ARN) that specifies from which resource to
3044
+ # disassociate the tags with the keys in the `TagKeys` input parameter.
2892
3045
  #
2893
3046
  # @option params [required, Array<String>] :tag_keys
2894
3047
  # A list of keys of `Tag` objects. The `Tag` objects identified by the
@@ -2976,8 +3129,8 @@ module Aws::CodeDeploy
2976
3129
  #
2977
3130
  # @option params [Array<Types::TriggerConfig>] :trigger_configurations
2978
3131
  # Information about triggers to change when the deployment group is
2979
- # updated. For examples, see [Modify Triggers in an AWS CodeDeploy
2980
- # Deployment Group][1] in the AWS CodeDeploy User Guide.
3132
+ # updated. For examples, see [Edit a Trigger in a CodeDeploy Deployment
3133
+ # Group][1] in the *AWS CodeDeploy User Guide*.
2981
3134
  #
2982
3135
  #
2983
3136
  #
@@ -3168,7 +3321,7 @@ module Aws::CodeDeploy
3168
3321
  params: params,
3169
3322
  config: config)
3170
3323
  context[:gem_name] = 'aws-sdk-codedeploy'
3171
- context[:gem_version] = '1.26.0'
3324
+ context[:gem_version] = '1.31.0'
3172
3325
  Seahorse::Client::Request.new(handlers, context)
3173
3326
  end
3174
3327
 
@@ -3234,9 +3387,9 @@ module Aws::CodeDeploy
3234
3387
  # The following table lists the valid waiter names, the operations they call,
3235
3388
  # and the default `:delay` and `:max_attempts` values.
3236
3389
  #
3237
- # | waiter_name | params | :delay | :max_attempts |
3238
- # | --------------------- | ----------------- | -------- | ------------- |
3239
- # | deployment_successful | {#get_deployment} | 15 | 120 |
3390
+ # | waiter_name | params | :delay | :max_attempts |
3391
+ # | --------------------- | ----------------------- | -------- | ------------- |
3392
+ # | deployment_successful | {Client#get_deployment} | 15 | 120 |
3240
3393
  #
3241
3394
  # @raise [Errors::FailureStateError] Raised when the waiter terminates
3242
3395
  # because the waiter has entered a state that it will not transition