aws-sdk-ecs 1.99.0 → 1.100.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: e16d5368ec5a0127b3f337f2e935d9ce1a7e327926777a8d45faff0fe8f33e9e
4
- data.tar.gz: 66aec1d4a433701f7fc74995ad523a8b1afe54507844b495e5aa4c7f3312406b
3
+ metadata.gz: b281c3b06771b917ba901037424e0fd0729911f7fb4a379059854c0ace42794c
4
+ data.tar.gz: ca27528e3d0d988c2d25082036867137404e2aa08701127b529b9b135f775b99
5
5
  SHA512:
6
- metadata.gz: 37790820c3e93c9ea722ea4c16fca49bba8c556021429edc4d83763c2abf5c697793fd24bfb4cd71700177f0535687851af3347daa2828343372b2c83fff08f7
7
- data.tar.gz: cdada09a968a4763ad6f1b7703d454e1b7c79dd9403dc9129a923c1213bd8470e227080ab48ad5cb493440b5fed9c82c87b5b8eea6904ff52d92021de810e1bb
6
+ metadata.gz: 4e6f1dde1e63dc7968ade75e69a178fde91bf571aa66cdc18d7b1b48ed42647585440c4bf408aa5d85e63bd6a7f04dff9f1163af0dfeaddb8b4c3f61bf1bc391
7
+ data.tar.gz: e27a8623fc0de329ec6f72128162a25ca9a1deea292df9f9b3932f957d322f1e6206db46d5895c6731c2f81d4066e7082933a7a336c5b3739f6132d7a268422b
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.100.0 (2022-06-21)
5
+ ------------------
6
+
7
+ * Feature - Amazon ECS UpdateService now supports the following parameters: PlacementStrategies, PlacementConstraints and CapacityProviderStrategy.
8
+
4
9
  1.99.0 (2022-03-22)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.99.0
1
+ 1.100.0
@@ -473,7 +473,7 @@ module Aws::ECS
473
473
  # that it can manage required resources in other Amazon Web Services
474
474
  # services on your behalf. However, if the IAM user that makes the call
475
475
  # doesn't have permissions to create the service-linked role, it isn't
476
- # created. For more information, see [Using Service-Linked Roles for
476
+ # created. For more information, see [Using service-linked roles for
477
477
  # Amazon ECS][1] in the *Amazon Elastic Container Service Developer
478
478
  # Guide*.
479
479
  #
@@ -683,8 +683,8 @@ module Aws::ECS
683
683
  # In addition to maintaining the desired count of tasks in your service,
684
684
  # you can optionally run your service behind one or more load balancers.
685
685
  # The load balancers distribute traffic across the tasks that are
686
- # associated with the service. For more information, see [Service Load
687
- # Balancing][1] in the *Amazon Elastic Container Service Developer
686
+ # associated with the service. For more information, see [Service load
687
+ # balancing][1] in the *Amazon Elastic Container Service Developer
688
688
  # Guide*.
689
689
  #
690
690
  # Tasks for services that don't use a load balancer are considered
@@ -698,8 +698,8 @@ module Aws::ECS
698
698
  # your desired number of tasks across your cluster. By default, the
699
699
  # service scheduler spreads tasks across Availability Zones. You can
700
700
  # use task placement strategies and constraints to customize task
701
- # placement decisions. For more information, see [Service Scheduler
702
- # Concepts][2] in the *Amazon Elastic Container Service Developer
701
+ # placement decisions. For more information, see [Service scheduler
702
+ # concepts][2] in the *Amazon Elastic Container Service Developer
703
703
  # Guide*.
704
704
  #
705
705
  # * `DAEMON` - The daemon scheduling strategy deploys exactly one task
@@ -709,8 +709,8 @@ module Aws::ECS
709
709
  # tasks. It also stops tasks that don't meet the placement
710
710
  # constraints. When using this strategy, you don't need to specify a
711
711
  # desired number of tasks, a task placement strategy, or use Service
712
- # Auto Scaling policies. For more information, see [Service Scheduler
713
- # Concepts][2] in the *Amazon Elastic Container Service Developer
712
+ # Auto Scaling policies. For more information, see [Service scheduler
713
+ # concepts][2] in the *Amazon Elastic Container Service Developer
714
714
  # Guide*.
715
715
  #
716
716
  # You can optionally specify a deployment configuration for your
@@ -766,7 +766,7 @@ module Aws::ECS
766
766
  # controller, you can specify only parameters that aren't controlled at
767
767
  # the task set level. The only required parameter is the service name.
768
768
  # You control your services using the CreateTaskSet operation. For more
769
- # information, see [Amazon ECS Deployment Types][3] in the *Amazon
769
+ # information, see [Amazon ECS deployment types][3] in the *Amazon
770
770
  # Elastic Container Service Developer Guide*.
771
771
  #
772
772
  # When the service scheduler launches new tasks, it determines task
@@ -820,7 +820,7 @@ module Aws::ECS
820
820
  #
821
821
  # @option params [Array<Types::LoadBalancer>] :load_balancers
822
822
  # A load balancer object representing the load balancers to use with
823
- # your service. For more information, see [Service Load Balancing][1] in
823
+ # your service. For more information, see [Service load balancing][1] in
824
824
  # the *Amazon Elastic Container Service Developer Guide*.
825
825
  #
826
826
  # If the service uses the rolling update (`ECS`) deployment controller
@@ -1100,8 +1100,8 @@ module Aws::ECS
1100
1100
  #
1101
1101
  # @option params [Boolean] :enable_ecs_managed_tags
1102
1102
  # Specifies whether to turn on Amazon ECS managed tags for the tasks
1103
- # within the service. For more information, see [Tagging Your Amazon ECS
1104
- # Resources][1] in the *Amazon Elastic Container Service Developer
1103
+ # within the service. For more information, see [Tagging your Amazon ECS
1104
+ # resources][1] in the *Amazon Elastic Container Service Developer
1105
1105
  # Guide*.
1106
1106
  #
1107
1107
  #
@@ -1455,7 +1455,7 @@ module Aws::ECS
1455
1455
 
1456
1456
  # Create a task set in the specified cluster and service. This is used
1457
1457
  # when a service uses the `EXTERNAL` deployment controller type. For
1458
- # more information, see [Amazon ECS Deployment Types][1] in the *Amazon
1458
+ # more information, see [Amazon ECS deployment types][1] in the *Amazon
1459
1459
  # Elastic Container Service Developer Guide*.
1460
1460
  #
1461
1461
  #
@@ -1490,7 +1490,7 @@ module Aws::ECS
1490
1490
  #
1491
1491
  # @option params [Array<Types::ServiceRegistry>] :service_registries
1492
1492
  # The details of the service discovery registries to assign to this task
1493
- # set. For more information, see [Service Discovery][1].
1493
+ # set. For more information, see [Service discovery][1].
1494
1494
  #
1495
1495
  #
1496
1496
  #
@@ -1498,7 +1498,7 @@ module Aws::ECS
1498
1498
  #
1499
1499
  # @option params [String] :launch_type
1500
1500
  # The launch type that new tasks in the task set uses. For more
1501
- # information, see [Amazon ECS Launch Types][1] in the *Amazon Elastic
1501
+ # information, see [Amazon ECS launch types][1] in the *Amazon Elastic
1502
1502
  # Container Service Developer Guide*.
1503
1503
  #
1504
1504
  # If a `launchType` is specified, the `capacityProviderStrategy`
@@ -2178,7 +2178,7 @@ module Aws::ECS
2178
2178
 
2179
2179
  # Deletes a specified task set within a service. This is used when a
2180
2180
  # service uses the `EXTERNAL` deployment controller type. For more
2181
- # information, see [Amazon ECS Deployment Types][1] in the *Amazon
2181
+ # information, see [Amazon ECS deployment types][1] in the *Amazon
2182
2182
  # Elastic Container Service Developer Guide*.
2183
2183
  #
2184
2184
  #
@@ -2295,11 +2295,12 @@ module Aws::ECS
2295
2295
  #
2296
2296
  # @option params [required, String] :container_instance
2297
2297
  # The container instance ID or full ARN of the container instance to
2298
- # deregister. The ARN contains the `arn:aws:ecs` namespace, followed by
2299
- # the Region of the container instance, the Amazon Web Services account
2300
- # ID of the container instance owner, the `container-instance`
2301
- # namespace, and then the container instance ID. For example,
2302
- # `arn:aws:ecs:region:aws_account_id:container-instance/container_instance_ID`.
2298
+ # deregister. For more information about the ARN format, see [Amazon
2299
+ # Resource Name (ARN)][1] in the *Amazon ECS Developer Guide*.
2300
+ #
2301
+ #
2302
+ #
2303
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-account-settings.html#ecs-resource-ids
2303
2304
  #
2304
2305
  # @option params [Boolean] :force
2305
2306
  # Forces the container instance to be deregistered. If you have tasks
@@ -3605,6 +3606,9 @@ module Aws::ECS
3605
3606
 
3606
3607
  # Describes a specified task or tasks.
3607
3608
  #
3609
+ # Currently, stopped tasks appear in the returned results for at least
3610
+ # one hour.
3611
+ #
3608
3612
  # @option params [String] :cluster
3609
3613
  # The short name or full Amazon Resource Name (ARN) of the cluster that
3610
3614
  # hosts the task or tasks to describe. If you do not specify a cluster,
@@ -3816,12 +3820,13 @@ module Aws::ECS
3816
3820
  # Returns an endpoint for the Amazon ECS agent to poll for updates.
3817
3821
  #
3818
3822
  # @option params [String] :container_instance
3819
- # The container instance ID or full ARN of the container instance. The
3820
- # ARN contains the `arn:aws:ecs` namespace, followed by the Region of
3821
- # the container instance, the Amazon Web Services account ID of the
3822
- # container instance owner, the `container-instance` namespace, and then
3823
- # the container instance ID. For example,
3824
- # `arn:aws:ecs:region:aws_account_id:container-instance/container_instance_ID`.
3823
+ # The container instance ID or full ARN of the container instance. For
3824
+ # more information about the ARN format, see [Amazon Resource Name
3825
+ # (ARN)][1] in the *Amazon ECS Developer Guide*.
3826
+ #
3827
+ #
3828
+ #
3829
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-account-settings.html#ecs-resource-ids
3825
3830
  #
3826
3831
  # @option params [String] :cluster
3827
3832
  # The short name or full Amazon Resource Name (ARN) of the cluster that
@@ -3855,6 +3860,12 @@ module Aws::ECS
3855
3860
 
3856
3861
  # Runs a command remotely on a container within a task.
3857
3862
  #
3863
+ # If you use a condition key in your IAM policy to refine the conditions
3864
+ # for the policy statement, for example limit the actions to a specific
3865
+ # cluster, you recevie an `AccessDeniedException` when there is a
3866
+ # mismatch between the condition key value and the corresponding
3867
+ # parameter value.
3868
+ #
3858
3869
  # @option params [String] :cluster
3859
3870
  # The Amazon Resource Name (ARN) or short name of the cluster the task
3860
3871
  # is running in. If you do not specify a cluster, the default cluster is
@@ -7998,12 +8009,6 @@ module Aws::ECS
7998
8009
  req.send_request(options)
7999
8010
  end
8000
8011
 
8001
- # Updating the task placement strategies and constraints on an Amazon
8002
- # ECS service remains in preview and is a Beta Service as defined by and
8003
- # subject to the Beta Service Participation Service Terms located at
8004
- # [https://aws.amazon.com/service-terms][1] ("Beta Terms"). These Beta
8005
- # Terms apply to your participation in this preview.
8006
- #
8007
8012
  # Modifies the parameters of a service.
8008
8013
  #
8009
8014
  # For services using the rolling update (`ECS`) you can update the
@@ -8019,7 +8024,7 @@ module Aws::ECS
8019
8024
  # ECS managed tags option, and propagate tags can be updated using this
8020
8025
  # API. If the network configuration, platform version, task definition,
8021
8026
  # or load balancer need to be updated, create a new CodeDeploy
8022
- # deployment. For more information, see [CreateDeployment][2] in the
8027
+ # deployment. For more information, see [CreateDeployment][1] in the
8023
8028
  # *CodeDeploy API Reference*.
8024
8029
  #
8025
8030
  # For services using an external deployment controller, you can update
@@ -8118,9 +8123,9 @@ module Aws::ECS
8118
8123
  # <note markdown="1"> You must have a service-linked role when you update any of the
8119
8124
  # following service properties. If you specified a custom IAM role when
8120
8125
  # you created the service, Amazon ECS automatically replaces the
8121
- # [roleARN][3] associated with the service with the ARN of your
8126
+ # [roleARN][2] associated with the service with the ARN of your
8122
8127
  # service-linked role. For more information, see [Service-linked
8123
- # roles][4] in the *Amazon Elastic Container Service Developer Guide*.
8128
+ # roles][3] in the *Amazon Elastic Container Service Developer Guide*.
8124
8129
  #
8125
8130
  # * `loadBalancers,`
8126
8131
  #
@@ -8130,10 +8135,9 @@ module Aws::ECS
8130
8135
  #
8131
8136
  #
8132
8137
  #
8133
- # [1]: https://aws.amazon.com/service-terms
8134
- # [2]: https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_CreateDeployment.html
8135
- # [3]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_Service.html#ECS-Type-Service-roleArn
8136
- # [4]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using-service-linked-roles.html
8138
+ # [1]: https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_CreateDeployment.html
8139
+ # [2]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_Service.html#ECS-Type-Service-roleArn
8140
+ # [3]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using-service-linked-roles.html
8137
8141
  #
8138
8142
  # @option params [String] :cluster
8139
8143
  # The short name or full Amazon Resource Name (ARN) of the cluster that
@@ -8753,7 +8757,7 @@ module Aws::ECS
8753
8757
  params: params,
8754
8758
  config: config)
8755
8759
  context[:gem_name] = 'aws-sdk-ecs'
8756
- context[:gem_version] = '1.99.0'
8760
+ context[:gem_version] = '1.100.0'
8757
8761
  Seahorse::Client::Request.new(handlers, context)
8758
8762
  end
8759
8763
 
@@ -506,11 +506,13 @@ module Aws::ECS
506
506
  # simultaneously.
507
507
  #
508
508
  # @!attribute [rw] cluster_arn
509
- # The Amazon Resource Name (ARN) that identifies the cluster. The ARN
510
- # contains the `arn:aws:ecs` namespace, followed by the Region of the
511
- # cluster, the Amazon Web Services account ID of the cluster owner,
512
- # the `cluster` namespace, and then the cluster name. For example,
513
- # `arn:aws:ecs:region:012345678910:cluster/test`.
509
+ # The Amazon Resource Name (ARN) that identifies the cluster. For more
510
+ # information about the ARN format, see [Amazon Resource Name
511
+ # (ARN)][1] in the *Amazon ECS Developer Guide*.
512
+ #
513
+ #
514
+ #
515
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-account-settings.html#ecs-resource-ids
514
516
  # @return [String]
515
517
  #
516
518
  # @!attribute [rw] cluster_name
@@ -642,8 +644,8 @@ module Aws::ECS
642
644
  #
643
645
  # @!attribute [rw] attachments
644
646
  # The resources attached to a cluster. When using a capacity provider
645
- # with a cluster, the Auto Scaling plan that's created is returned as
646
- # a cluster attachment.
647
+ # with a cluster, the capacity provider and associated resources are
648
+ # returned as cluster attachments.
647
649
  # @return [Array<Types::Attachment>]
648
650
  #
649
651
  # @!attribute [rw] attachments_status
@@ -653,8 +655,6 @@ module Aws::ECS
653
655
  # UPDATE\_IN\_PROGRESS
654
656
  #
655
657
  # : The available capacity providers for the cluster are updating.
656
- # This occurs when the Auto Scaling plan is provisioning or
657
- # deprovisioning.
658
658
  #
659
659
  # UPDATE\_COMPLETE
660
660
  #
@@ -1184,12 +1184,12 @@ module Aws::ECS
1184
1184
  # container is placed. Otherwise, the value of `memory` is used.
1185
1185
  #
1186
1186
  # The Docker 20.10.0 or later daemon reserves a minimum of 6 MiB of
1187
- # memory for a container, so you should not specify fewer than 6 MiB
1188
- # of memory for your containers.
1187
+ # memory for a container. So, don't specify less than 6 MiB of memory
1188
+ # for your containers.
1189
1189
  #
1190
1190
  # The Docker 19.03.13-ce or earlier daemon reserves a minimum of 4 MiB
1191
- # of memory for a container, so you should not specify fewer than 4
1192
- # MiB of memory for your containers.
1191
+ # of memory for a container. So, don't specify less than 4 MiB of
1192
+ # memory for your containers.
1193
1193
  #
1194
1194
  #
1195
1195
  #
@@ -2073,16 +2073,17 @@ module Aws::ECS
2073
2073
  include Aws::Structure
2074
2074
  end
2075
2075
 
2076
- # An EC2 instance that's running the Amazon ECS agent and has been
2077
- # registered with a cluster.
2076
+ # An Amazon EC2 or External instance that's running the Amazon ECS
2077
+ # agent and has been registered with a cluster.
2078
2078
  #
2079
2079
  # @!attribute [rw] container_instance_arn
2080
- # The Amazon Resource Name (ARN) of the container instance. The ARN
2081
- # contains the `arn:aws:ecs` namespace, followed by the Region of the
2082
- # container instance, the Amazon Web Services account ID of the
2083
- # container instance owner, the `container-instance` namespace, and
2084
- # then the container instance ID. For example,
2085
- # `arn:aws:ecs:region:aws_account_id:container-instance/container_instance_ID`.
2080
+ # The Amazon Resource Name (ARN) of the container instance. For more
2081
+ # information about the ARN format, see [Amazon Resource Name
2082
+ # (ARN)][1] in the *Amazon ECS Developer Guide*.
2083
+ #
2084
+ #
2085
+ #
2086
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-account-settings.html#ecs-resource-ids
2086
2087
  # @return [String]
2087
2088
  #
2088
2089
  # @!attribute [rw] ec2_instance_id
@@ -2156,7 +2157,7 @@ module Aws::ECS
2156
2157
  # tasks. The `DRAINING` indicates that new tasks aren't placed on the
2157
2158
  # container instance and any service tasks running on the container
2158
2159
  # instance are removed if possible. For more information, see
2159
- # [Container Instance Draining][1] in the *Amazon Elastic Container
2160
+ # [Container instance draining][1] in the *Amazon Elastic Container
2160
2161
  # Service Developer Guide*.
2161
2162
  #
2162
2163
  #
@@ -2170,9 +2171,9 @@ module Aws::ECS
2170
2171
  #
2171
2172
  # @!attribute [rw] agent_connected
2172
2173
  # This parameter returns `true` if the agent is connected to Amazon
2173
- # ECS. Registered instances with an agent that may be unhealthy or
2174
- # stopped return `false`. Only instances connected to an agent can
2175
- # accept placement requests.
2174
+ # ECS. An instance with an agent that may be unhealthy or stopped
2175
+ # return `false`. Only instances connected to an agent can accept task
2176
+ # placement requests.
2176
2177
  # @return [Boolean]
2177
2178
  #
2178
2179
  # @!attribute [rw] running_tasks_count
@@ -2202,8 +2203,8 @@ module Aws::ECS
2202
2203
  # @return [Time]
2203
2204
  #
2204
2205
  # @!attribute [rw] attachments
2205
- # The resources attached to a container instance, such as elastic
2206
- # network interfaces.
2206
+ # The resources attached to a container instance, such as an elastic
2207
+ # network interface.
2207
2208
  # @return [Array<Types::Attachment>]
2208
2209
  #
2209
2210
  # @!attribute [rw] tags
@@ -2789,7 +2790,7 @@ module Aws::ECS
2789
2790
  #
2790
2791
  # @!attribute [rw] load_balancers
2791
2792
  # A load balancer object representing the load balancers to use with
2792
- # your service. For more information, see [Service Load Balancing][1]
2793
+ # your service. For more information, see [Service load balancing][1]
2793
2794
  # in the *Amazon Elastic Container Service Developer Guide*.
2794
2795
  #
2795
2796
  # If the service uses the rolling update (`ECS`) deployment controller
@@ -3091,8 +3092,8 @@ module Aws::ECS
3091
3092
  #
3092
3093
  # @!attribute [rw] enable_ecs_managed_tags
3093
3094
  # Specifies whether to turn on Amazon ECS managed tags for the tasks
3094
- # within the service. For more information, see [Tagging Your Amazon
3095
- # ECS Resources][1] in the *Amazon Elastic Container Service Developer
3095
+ # within the service. For more information, see [Tagging your Amazon
3096
+ # ECS resources][1] in the *Amazon Elastic Container Service Developer
3096
3097
  # Guide*.
3097
3098
  #
3098
3099
  #
@@ -3254,7 +3255,7 @@ module Aws::ECS
3254
3255
  #
3255
3256
  # @!attribute [rw] service_registries
3256
3257
  # The details of the service discovery registries to assign to this
3257
- # task set. For more information, see [Service Discovery][1].
3258
+ # task set. For more information, see [Service discovery][1].
3258
3259
  #
3259
3260
  #
3260
3261
  #
@@ -3263,7 +3264,7 @@ module Aws::ECS
3263
3264
  #
3264
3265
  # @!attribute [rw] launch_type
3265
3266
  # The launch type that new tasks in the task set uses. For more
3266
- # information, see [Amazon ECS Launch Types][1] in the *Amazon Elastic
3267
+ # information, see [Amazon ECS launch types][1] in the *Amazon Elastic
3267
3268
  # Container Service Developer Guide*.
3268
3269
  #
3269
3270
  # If a `launchType` is specified, the `capacityProviderStrategy`
@@ -3880,54 +3881,83 @@ module Aws::ECS
3880
3881
  #
3881
3882
  # @!attribute [rw] maximum_percent
3882
3883
  # If a service is using the rolling update (`ECS`) deployment type,
3883
- # the **maximum percent** parameter represents an upper limit on the
3884
- # number of tasks in a service that are allowed in the `RUNNING` or
3885
- # `PENDING` state during a deployment, as a percentage of the desired
3886
- # number of tasks (rounded down to the nearest integer), and while any
3887
- # container instances are in the `DRAINING` state if the service
3888
- # contains tasks using the EC2 launch type. This parameter enables you
3889
- # to define the deployment batch size. For example, if your service
3890
- # has a desired number of four tasks and a maximum percent value of
3891
- # 200%, the scheduler may start four new tasks before stopping the
3892
- # four older tasks (provided that the cluster resources required to do
3893
- # this are available). The default value for maximum percent is 200%.
3894
- #
3895
- # If a service is using the blue/green (`CODE_DEPLOY`) or `EXTERNAL`
3896
- # deployment types and tasks that use the EC2 launch type, the
3897
- # **maximum percent** value is set to the default value and is used to
3898
- # define the upper limit on the number of the tasks in the service
3899
- # that remain in the `RUNNING` state while the container instances are
3900
- # in the `DRAINING` state. If the tasks in the service use the Fargate
3901
- # launch type, the maximum percent value is not used, although it is
3902
- # returned when describing your service.
3884
+ # the `maximumPercent` parameter represents an upper limit on the
3885
+ # number of your service's tasks that are allowed in the `RUNNING` or
3886
+ # `PENDING` state during a deployment, as a percentage of the
3887
+ # `desiredCount` (rounded down to the nearest integer). This parameter
3888
+ # enables you to define the deployment batch size. For example, if
3889
+ # your service is using the `REPLICA` service scheduler and has a
3890
+ # `desiredCount` of four tasks and a `maximumPercent` value of 200%,
3891
+ # the scheduler may start four new tasks before stopping the four
3892
+ # older tasks (provided that the cluster resources required to do this
3893
+ # are available). The default `maximumPercent` value for a service
3894
+ # using the `REPLICA` service scheduler is 200%.
3895
+ #
3896
+ # If a service is using either the blue/green (`CODE_DEPLOY`) or
3897
+ # `EXTERNAL` deployment types and tasks that use the EC2 launch type,
3898
+ # the **maximum percent** value is set to the default value and is
3899
+ # used to define the upper limit on the number of the tasks in the
3900
+ # service that remain in the `RUNNING` state while the container
3901
+ # instances are in the `DRAINING` state. If the tasks in the service
3902
+ # use the Fargate launch type, the maximum percent value is not used,
3903
+ # although it is returned when describing your service.
3903
3904
  # @return [Integer]
3904
3905
  #
3905
3906
  # @!attribute [rw] minimum_healthy_percent
3906
3907
  # If a service is using the rolling update (`ECS`) deployment type,
3907
- # the **minimum healthy percent** represents a lower limit on the
3908
- # number of tasks in a service that must remain in the `RUNNING` state
3909
- # during a deployment, as a percentage of the desired number of tasks
3910
- # (rounded up to the nearest integer), and while any container
3911
- # instances are in the `DRAINING` state if the service contains tasks
3912
- # using the EC2 launch type. This parameter enables you to deploy
3908
+ # the `minimumHealthyPercent` represents a lower limit on the number
3909
+ # of your service's tasks that must remain in the `RUNNING` state
3910
+ # during a deployment, as a percentage of the `desiredCount` (rounded
3911
+ # up to the nearest integer). This parameter enables you to deploy
3913
3912
  # without using additional cluster capacity. For example, if your
3914
- # service has a desired number of four tasks and a minimum healthy
3915
- # percent of 50%, the scheduler may stop two existing tasks to free up
3916
- # cluster capacity before starting two new tasks. Tasks for services
3917
- # that *do not* use a load balancer are considered healthy if they're
3918
- # in the `RUNNING` state; tasks for services that *do* use a load
3919
- # balancer are considered healthy if they're in the `RUNNING` state
3920
- # and they're reported as healthy by the load balancer. The default
3921
- # value for minimum healthy percent is 100%.
3922
- #
3923
- # If a service is using the blue/green (`CODE_DEPLOY`) or `EXTERNAL`
3924
- # deployment types and tasks that use the EC2 launch type, the
3925
- # **minimum healthy percent** value is set to the default value and is
3926
- # used to define the lower limit on the number of the tasks in the
3927
- # service that remain in the `RUNNING` state while the container
3928
- # instances are in the `DRAINING` state. If the tasks in the service
3929
- # use the Fargate launch type, the minimum healthy percent value is
3930
- # not used, although it is returned when describing your service.
3913
+ # service has a `desiredCount` of four tasks and a
3914
+ # `minimumHealthyPercent` of 50%, the service scheduler may stop two
3915
+ # existing tasks to free up cluster capacity before starting two new
3916
+ # tasks.
3917
+ #
3918
+ # For services that *do not* use a load balancer, the following should
3919
+ # be noted:
3920
+ #
3921
+ # * A service is considered healthy if all essential containers within
3922
+ # the tasks in the service pass their health checks.
3923
+ #
3924
+ # * If a task has no essential containers with a health check defined,
3925
+ # the service scheduler will wait for 40 seconds after a task
3926
+ # reaches a `RUNNING` state before the task is counted towards the
3927
+ # minimum healthy percent total.
3928
+ #
3929
+ # * If a task has one or more essential containers with a health check
3930
+ # defined, the service scheduler will wait for the task to reach a
3931
+ # healthy status before counting it towards the minimum healthy
3932
+ # percent total. A task is considered healthy when all essential
3933
+ # containers within the task have passed their health checks. The
3934
+ # amount of time the service scheduler can wait for is determined by
3935
+ # the container health check settings.
3936
+ #
3937
+ # For services are that *do* use a load balancer, the following should
3938
+ # be noted:
3939
+ #
3940
+ # * If a task has no essential containers with a health check defined,
3941
+ # the service scheduler will wait for the load balancer target group
3942
+ # health check to return a healthy status before counting the task
3943
+ # towards the minimum healthy percent total.
3944
+ #
3945
+ # * If a task has an essential container with a health check defined,
3946
+ # the service scheduler will wait for both the task to reach a
3947
+ # healthy status and the load balancer target group health check to
3948
+ # return a healthy status before counting the task towards the
3949
+ # minimum healthy percent total.
3950
+ #
3951
+ # If a service is using either the blue/green (`CODE_DEPLOY`) or
3952
+ # `EXTERNAL` deployment types and is running tasks that use the EC2
3953
+ # launch type, the **minimum healthy percent** value is set to the
3954
+ # default value and is used to define the lower limit on the number of
3955
+ # the tasks in the service that remain in the `RUNNING` state while
3956
+ # the container instances are in the `DRAINING` state. If a service is
3957
+ # using either the blue/green (`CODE_DEPLOY`) or `EXTERNAL` deployment
3958
+ # types and is running tasks that use the Fargate launch type, the
3959
+ # minimum healthy percent value is not used, although it is returned
3960
+ # when describing your service.
3931
3961
  # @return [Integer]
3932
3962
  #
3933
3963
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DeploymentConfiguration AWS API Documentation
@@ -3941,7 +3971,7 @@ module Aws::ECS
3941
3971
  end
3942
3972
 
3943
3973
  # The deployment controller to use for the service. For more
3944
- # information, see [Amazon ECS Deployment Types][1] in the *Amazon
3974
+ # information, see [Amazon ECS deployment types][1] in the *Amazon
3945
3975
  # Elastic Container Service Developer Guide*.
3946
3976
  #
3947
3977
  #
@@ -4008,11 +4038,12 @@ module Aws::ECS
4008
4038
  #
4009
4039
  # @!attribute [rw] container_instance
4010
4040
  # The container instance ID or full ARN of the container instance to
4011
- # deregister. The ARN contains the `arn:aws:ecs` namespace, followed
4012
- # by the Region of the container instance, the Amazon Web Services
4013
- # account ID of the container instance owner, the `container-instance`
4014
- # namespace, and then the container instance ID. For example,
4015
- # `arn:aws:ecs:region:aws_account_id:container-instance/container_instance_ID`.
4041
+ # deregister. For more information about the ARN format, see [Amazon
4042
+ # Resource Name (ARN)][1] in the *Amazon ECS Developer Guide*.
4043
+ #
4044
+ #
4045
+ #
4046
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-account-settings.html#ecs-resource-ids
4016
4047
  # @return [String]
4017
4048
  #
4018
4049
  # @!attribute [rw] force
@@ -4578,12 +4609,13 @@ module Aws::ECS
4578
4609
  # }
4579
4610
  #
4580
4611
  # @!attribute [rw] container_instance
4581
- # The container instance ID or full ARN of the container instance. The
4582
- # ARN contains the `arn:aws:ecs` namespace, followed by the Region of
4583
- # the container instance, the Amazon Web Services account ID of the
4584
- # container instance owner, the `container-instance` namespace, and
4585
- # then the container instance ID. For example,
4586
- # `arn:aws:ecs:region:aws_account_id:container-instance/container_instance_ID`.
4612
+ # The container instance ID or full ARN of the container instance. For
4613
+ # more information about the ARN format, see [Amazon Resource Name
4614
+ # (ARN)][1] in the *Amazon ECS Developer Guide*.
4615
+ #
4616
+ #
4617
+ #
4618
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-account-settings.html#ecs-resource-ids
4587
4619
  # @return [String]
4588
4620
  #
4589
4621
  # @!attribute [rw] cluster
@@ -4729,7 +4761,7 @@ module Aws::ECS
4729
4761
  # will enforce the path set on the EFS access point. If an access
4730
4762
  # point is used, transit encryption must be enabled in the
4731
4763
  # `EFSVolumeConfiguration`. For more information, see [Working with
4732
- # Amazon EFS Access Points][1] in the *Amazon Elastic File System User
4764
+ # Amazon EFS access points][1] in the *Amazon Elastic File System User
4733
4765
  # Guide*.
4734
4766
  #
4735
4767
  #
@@ -4743,7 +4775,7 @@ module Aws::ECS
4743
4775
  # enabled, transit encryption must be enabled in the
4744
4776
  # `EFSVolumeConfiguration`. If this parameter is omitted, the default
4745
4777
  # value of `DISABLED` is used. For more information, see [Using Amazon
4746
- # EFS Access Points][1] in the *Amazon Elastic Container Service
4778
+ # EFS access points][1] in the *Amazon Elastic Container Service
4747
4779
  # Developer Guide*.
4748
4780
  #
4749
4781
  #
@@ -4762,7 +4794,7 @@ module Aws::ECS
4762
4794
 
4763
4795
  # This parameter is specified when you're using an Amazon Elastic File
4764
4796
  # System file system for task storage. For more information, see [Amazon
4765
- # EFS Volumes][1] in the *Amazon Elastic Container Service Developer
4797
+ # EFS volumes][1] in the *Amazon Elastic Container Service Developer
4766
4798
  # Guide*.
4767
4799
  #
4768
4800
  #
@@ -4803,7 +4835,7 @@ module Aws::ECS
4803
4835
  # between the Amazon ECS host and the Amazon EFS server. Transit
4804
4836
  # encryption must be enabled if Amazon EFS IAM authorization is used.
4805
4837
  # If this parameter is omitted, the default value of `DISABLED` is
4806
- # used. For more information, see [Encrypting Data in Transit][1] in
4838
+ # used. For more information, see [Encrypting data in transit][1] in
4807
4839
  # the *Amazon Elastic File System User Guide*.
4808
4840
  #
4809
4841
  #
@@ -4815,8 +4847,8 @@ module Aws::ECS
4815
4847
  # The port to use when sending encrypted data between the Amazon ECS
4816
4848
  # host and the Amazon EFS server. If you do not specify a transit
4817
4849
  # encryption port, it will use the port selection strategy that the
4818
- # Amazon EFS mount helper uses. For more information, see [EFS Mount
4819
- # Helper][1] in the *Amazon Elastic File System User Guide*.
4850
+ # Amazon EFS mount helper uses. For more information, see [EFS mount
4851
+ # helper][1] in the *Amazon Elastic File System User Guide*.
4820
4852
  #
4821
4853
  #
4822
4854
  #
@@ -5133,8 +5165,8 @@ module Aws::ECS
5133
5165
 
5134
5166
  # The authorization configuration details for Amazon FSx for Windows
5135
5167
  # File Server file system. See
5136
- # [FSxWindowsFileServerVolumeConfiguration][1] in the *Amazon Elastic
5137
- # Container Service API Reference*.
5168
+ # [FSxWindowsFileServerVolumeConfiguration][1] in the *Amazon ECS API
5169
+ # Reference*.
5138
5170
  #
5139
5171
  # For more information and the input format, see [Amazon FSx for Windows
5140
5172
  # File Server Volumes][2] in the *Amazon Elastic Container Service
@@ -5157,7 +5189,7 @@ module Aws::ECS
5157
5189
  # The authorization credential option to use. The authorization
5158
5190
  # credential options can be provided using either the Amazon Resource
5159
5191
  # Name (ARN) of an Secrets Manager secret or SSM Parameter Store
5160
- # parameter. The ARNs refer to the stored credentials.
5192
+ # parameter. The ARN refers to the stored credentials.
5161
5193
  # @return [String]
5162
5194
  #
5163
5195
  # @!attribute [rw] domain
@@ -5183,7 +5215,7 @@ module Aws::ECS
5183
5215
  # File Server][1] file system for task storage.
5184
5216
  #
5185
5217
  # For more information and the input format, see [Amazon FSx for Windows
5186
- # File Server Volumes][2] in the *Amazon Elastic Container Service
5218
+ # File Server volumes][2] in the *Amazon Elastic Container Service
5187
5219
  # Developer Guide*.
5188
5220
  #
5189
5221
  #
@@ -5258,7 +5290,7 @@ module Aws::ECS
5258
5290
 
5259
5291
  # The FireLens configuration for the container. This is used to specify
5260
5292
  # and configure a log router for container logs. For more information,
5261
- # see [Custom Log Routing][1] in the *Amazon Elastic Container Service
5293
+ # see [Custom log routing][1] in the *Amazon Elastic Container Service
5262
5294
  # Developer Guide*.
5263
5295
  #
5264
5296
  #
@@ -5287,8 +5319,8 @@ module Aws::ECS
5287
5319
  # cluster, and container instance details to the log event. If
5288
5320
  # specified, the syntax to use is
5289
5321
  # `"options":\{"enable-ecs-log-metadata":"true|false","config-file-type:"s3|file","config-file-value":"arn:aws:s3:::mybucket/fluent.conf|filepath"\}`.
5290
- # For more information, see [Creating a Task Definition that Uses a
5291
- # FireLens Configuration][1] in the *Amazon Elastic Container Service
5322
+ # For more information, see [Creating a task definition that uses a
5323
+ # FireLens configuration][1] in the *Amazon Elastic Container Service
5292
5324
  # Developer Guide*.
5293
5325
  #
5294
5326
  # <note markdown="1"> Tasks hosted on Fargate only support the `file` configuration file
@@ -5361,11 +5393,11 @@ module Aws::ECS
5361
5393
  #
5362
5394
  # * Container health checks require version 1.17.0 or greater of the
5363
5395
  # Amazon ECS container agent. For more information, see [Updating the
5364
- # Amazon ECS Container Agent][1].
5396
+ # Amazon ECS container agent][1].
5365
5397
  #
5366
5398
  # * Container health checks are supported for Fargate tasks if you're
5367
- # using platform version 1.1.0 or greater. For more information, see
5368
- # [Fargate Platform Versions][2].
5399
+ # using platform version `1.1.0` or greater. For more information, see
5400
+ # [Fargate platform versions][2].
5369
5401
  #
5370
5402
  # * Container health checks aren't supported for tasks that are part of
5371
5403
  # a service that's configured to use a Classic Load Balancer.
@@ -6692,8 +6724,8 @@ module Aws::ECS
6692
6724
  # update the Elastic Load Balancing configuration.
6693
6725
  #
6694
6726
  # A service-linked role is required for services that use multiple
6695
- # target groups. For more information, see [Service-linked roles][1] in
6696
- # the *Amazon Elastic Container Service Developer Guide*.
6727
+ # target groups. For more information, see [Using service-linked
6728
+ # roles][1] in the *Amazon Elastic Container Service Developer Guide*.
6697
6729
  #
6698
6730
  #
6699
6731
  #
@@ -6719,12 +6751,12 @@ module Aws::ECS
6719
6751
  #
6720
6752
  # For services using the `ECS` deployment controller, you can specify
6721
6753
  # one or multiple target groups. For more information, see
6722
- # [Registering Multiple Target Groups with a Service][1] in the
6754
+ # [Registering multiple target groups with a service][1] in the
6723
6755
  # *Amazon Elastic Container Service Developer Guide*.
6724
6756
  #
6725
6757
  # For services using the `CODE_DEPLOY` deployment controller, you're
6726
6758
  # required to define two target groups for the load balancer. For more
6727
- # information, see [Blue/Green Deployment with CodeDeploy][2] in the
6759
+ # information, see [Blue/green deployment with CodeDeploy][2] in the
6728
6760
  # *Amazon Elastic Container Service Developer Guide*.
6729
6761
  #
6730
6762
  # If your service's task definition uses the `awsvpc` network mode,
@@ -6878,7 +6910,7 @@ module Aws::ECS
6878
6910
  #
6879
6911
  # @!attribute [rw] secret_options
6880
6912
  # The secrets to pass to the log configuration. For more information,
6881
- # see [Specifying Sensitive Data][1] in the *Amazon Elastic Container
6913
+ # see [Specifying sensitive data][1] in the *Amazon Elastic Container
6882
6914
  # Service Developer Guide*.
6883
6915
  #
6884
6916
  #
@@ -6973,7 +7005,7 @@ module Aws::ECS
6973
7005
  # scale-out actions of the Auto Scaling group. Amazon ECS manages a
6974
7006
  # target tracking scaling policy using an Amazon ECS managed CloudWatch
6975
7007
  # metric with the specified `targetCapacity` value as the target value
6976
- # for the metric. For more information, see [Using Managed Scaling][1]
7008
+ # for the metric. For more information, see [Using managed scaling][1]
6977
7009
  # in the *Amazon Elastic Container Service Developer Guide*.
6978
7010
  #
6979
7011
  # If managed scaling is disabled, the user must manage the scaling of
@@ -7192,7 +7224,7 @@ module Aws::ECS
7192
7224
  class NoUpdateAvailableException < Aws::EmptyStructure; end
7193
7225
 
7194
7226
  # An object representing a constraint on task placement. For more
7195
- # information, see [Task Placement Constraints][1] in the *Amazon
7227
+ # information, see [Task placement constraints][1] in the *Amazon
7196
7228
  # Elastic Container Service Developer Guide*.
7197
7229
  #
7198
7230
  # <note markdown="1"> If you're using the Fargate launch type, task placement constraints
@@ -7241,7 +7273,7 @@ module Aws::ECS
7241
7273
  end
7242
7274
 
7243
7275
  # The task placement strategy for a task or service. For more
7244
- # information, see [Task Placement Strategies][1] in the *Amazon Elastic
7276
+ # information, see [Task placement strategies][1] in the *Amazon Elastic
7245
7277
  # Container Service Developer Guide*.
7246
7278
  #
7247
7279
  #
@@ -9031,7 +9063,7 @@ module Aws::ECS
9031
9063
  #
9032
9064
  # You can run your Linux tasks on an ARM-based platform by setting the
9033
9065
  # value to `ARM64`. This option is avaiable for tasks that run on
9034
- # Linuc Amazon EC2 instance or Linux containers on Fargate.
9066
+ # Linux Amazon EC2 instance or Linux containers on Fargate.
9035
9067
  # @return [String]
9036
9068
  #
9037
9069
  # @!attribute [rw] operating_system_family
@@ -9086,7 +9118,7 @@ module Aws::ECS
9086
9118
  # * To reference sensitive information in the log configuration of a
9087
9119
  # container, use the `secretOptions` container definition parameter.
9088
9120
  #
9089
- # For more information, see [Specifying Sensitive Data][1] in the
9121
+ # For more information, see [Specifying sensitive data][1] in the
9090
9122
  # *Amazon Elastic Container Service Developer Guide*.
9091
9123
  #
9092
9124
  #
@@ -9154,11 +9186,13 @@ module Aws::ECS
9154
9186
  # Details on a service within a cluster
9155
9187
  #
9156
9188
  # @!attribute [rw] service_arn
9157
- # The ARN that identifies the service. The ARN contains the
9158
- # `arn:aws:ecs` namespace, followed by the Region of the service, the
9159
- # Amazon Web Services account ID of the service owner, the `service`
9160
- # namespace, and then the service name. For example,
9161
- # `arn:aws:ecs:region:012345678910:service/my-service`.
9189
+ # The ARN that identifies the service. For more information about the
9190
+ # ARN format, see [Amazon Resource Name (ARN)][1] in the *Amazon ECS
9191
+ # Developer Guide*.
9192
+ #
9193
+ #
9194
+ #
9195
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-account-settings.html#ecs-resource-ids
9162
9196
  # @return [String]
9163
9197
  #
9164
9198
  # @!attribute [rw] service_name
data/lib/aws-sdk-ecs.rb CHANGED
@@ -49,6 +49,6 @@ require_relative 'aws-sdk-ecs/customizations'
49
49
  # @!group service
50
50
  module Aws::ECS
51
51
 
52
- GEM_VERSION = '1.99.0'
52
+ GEM_VERSION = '1.100.0'
53
53
 
54
54
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-ecs
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.99.0
4
+ version: 1.100.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2022-03-22 00:00:00.000000000 Z
11
+ date: 2022-06-21 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core