aws-sdk-ecs 1.99.0 → 1.100.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
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