aws-sdk-ecs 1.97.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: '0794594ba7b0c2273ba4bd389f8c3d05943632247317918cf8d8cde40d4fb4c0'
4
- data.tar.gz: 7035a87cacfd0e4f6a3855b630f57cb97ff5e213d74e2cffd5d1a3fd26ec63b3
3
+ metadata.gz: b281c3b06771b917ba901037424e0fd0729911f7fb4a379059854c0ace42794c
4
+ data.tar.gz: ca27528e3d0d988c2d25082036867137404e2aa08701127b529b9b135f775b99
5
5
  SHA512:
6
- metadata.gz: 291868aa85fad401246451737f4ca1a1d1dcbe879f0390e9b1ad5b5fba99aac4d63bf340e1faf4f65af09cbe436585a4d3b2420d25d4348c76aeffb2d18e30b9
7
- data.tar.gz: 77020b769232aacc7a4f551d002b4a32ccac8d4aa15b524914e7368f033666d395a2a1af2ece2d3d5cde03960d29adc4e41d08e7c20357ff5874c3c8c8c392ca
6
+ metadata.gz: 4e6f1dde1e63dc7968ade75e69a178fde91bf571aa66cdc18d7b1b48ed42647585440c4bf408aa5d85e63bd6a7f04dff9f1163af0dfeaddb8b4c3f61bf1bc391
7
+ data.tar.gz: e27a8623fc0de329ec6f72128162a25ca9a1deea292df9f9b3932f957d322f1e6206db46d5895c6731c2f81d4066e7082933a7a336c5b3739f6132d7a268422b
data/CHANGELOG.md CHANGED
@@ -1,6 +1,21 @@
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
+
9
+ 1.99.0 (2022-03-22)
10
+ ------------------
11
+
12
+ * Feature - Documentation only update to address tickets
13
+
14
+ 1.98.0 (2022-03-15)
15
+ ------------------
16
+
17
+ * Feature - Documentation only update to address tickets
18
+
4
19
  1.97.0 (2022-03-07)
5
20
  ------------------
6
21
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.97.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
  #
@@ -526,7 +526,7 @@ module Aws::ECS
526
526
  # PutAccountSetting or PutAccountSettingDefault.
527
527
  #
528
528
  # @option params [Types::ClusterConfiguration] :configuration
529
- # The execute command configuration for the cluster.
529
+ # The `execute` command configuration for the cluster.
530
530
  #
531
531
  # @option params [Array<String>] :capacity_providers
532
532
  # The short name of one or more capacity providers to associate with the
@@ -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
  #
@@ -1109,12 +1109,10 @@ module Aws::ECS
1109
1109
  # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html
1110
1110
  #
1111
1111
  # @option params [String] :propagate_tags
1112
- # Specifies whether to propagate the tags from the task definition or
1113
- # the service to the tasks in the service. If no value is specified, the
1114
- # tags aren't propagated. Tags can only be propagated to the tasks
1115
- # within the service during service creation. To add tags to a task
1116
- # after service creation or task creation, use the TagResource API
1117
- # action.
1112
+ # Specifies whether to propagate the tags from the task definition to
1113
+ # the task. If no value is specified, the tags aren't propagated. Tags
1114
+ # can only be propagated to the task during task creation. To add tags
1115
+ # to a task after task creation, use the TagResource API action.
1118
1116
  #
1119
1117
  # @option params [Boolean] :enable_execute_command
1120
1118
  # Determines whether the execute command functionality is enabled for
@@ -1457,7 +1455,7 @@ module Aws::ECS
1457
1455
 
1458
1456
  # Create a task set in the specified cluster and service. This is used
1459
1457
  # when a service uses the `EXTERNAL` deployment controller type. For
1460
- # more information, see [Amazon ECS Deployment Types][1] in the *Amazon
1458
+ # more information, see [Amazon ECS deployment types][1] in the *Amazon
1461
1459
  # Elastic Container Service Developer Guide*.
1462
1460
  #
1463
1461
  #
@@ -1492,7 +1490,7 @@ module Aws::ECS
1492
1490
  #
1493
1491
  # @option params [Array<Types::ServiceRegistry>] :service_registries
1494
1492
  # The details of the service discovery registries to assign to this task
1495
- # set. For more information, see [Service Discovery][1].
1493
+ # set. For more information, see [Service discovery][1].
1496
1494
  #
1497
1495
  #
1498
1496
  #
@@ -1500,7 +1498,7 @@ module Aws::ECS
1500
1498
  #
1501
1499
  # @option params [String] :launch_type
1502
1500
  # The launch type that new tasks in the task set uses. For more
1503
- # information, see [Amazon ECS Launch Types][1] in the *Amazon Elastic
1501
+ # information, see [Amazon ECS launch types][1] in the *Amazon Elastic
1504
1502
  # Container Service Developer Guide*.
1505
1503
  #
1506
1504
  # If a `launchType` is specified, the `capacityProviderStrategy`
@@ -2180,7 +2178,7 @@ module Aws::ECS
2180
2178
 
2181
2179
  # Deletes a specified task set within a service. This is used when a
2182
2180
  # service uses the `EXTERNAL` deployment controller type. For more
2183
- # information, see [Amazon ECS Deployment Types][1] in the *Amazon
2181
+ # information, see [Amazon ECS deployment types][1] in the *Amazon
2184
2182
  # Elastic Container Service Developer Guide*.
2185
2183
  #
2186
2184
  #
@@ -2297,11 +2295,12 @@ module Aws::ECS
2297
2295
  #
2298
2296
  # @option params [required, String] :container_instance
2299
2297
  # The container instance ID or full ARN of the container instance to
2300
- # deregister. The ARN contains the `arn:aws:ecs` namespace, followed by
2301
- # the Region of the container instance, the Amazon Web Services account
2302
- # ID of the container instance owner, the `container-instance`
2303
- # namespace, and then the container instance ID. For example,
2304
- # `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
2305
2304
  #
2306
2305
  # @option params [Boolean] :force
2307
2306
  # Forces the container instance to be deregistered. If you have tasks
@@ -3607,6 +3606,9 @@ module Aws::ECS
3607
3606
 
3608
3607
  # Describes a specified task or tasks.
3609
3608
  #
3609
+ # Currently, stopped tasks appear in the returned results for at least
3610
+ # one hour.
3611
+ #
3610
3612
  # @option params [String] :cluster
3611
3613
  # The short name or full Amazon Resource Name (ARN) of the cluster that
3612
3614
  # hosts the task or tasks to describe. If you do not specify a cluster,
@@ -3818,12 +3820,13 @@ module Aws::ECS
3818
3820
  # Returns an endpoint for the Amazon ECS agent to poll for updates.
3819
3821
  #
3820
3822
  # @option params [String] :container_instance
3821
- # The container instance ID or full ARN of the container instance. The
3822
- # ARN contains the `arn:aws:ecs` namespace, followed by the Region of
3823
- # the container instance, the Amazon Web Services account ID of the
3824
- # container instance owner, the `container-instance` namespace, and then
3825
- # the container instance ID. For example,
3826
- # `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
3827
3830
  #
3828
3831
  # @option params [String] :cluster
3829
3832
  # The short name or full Amazon Resource Name (ARN) of the cluster that
@@ -3857,6 +3860,12 @@ module Aws::ECS
3857
3860
 
3858
3861
  # Runs a command remotely on a container within a task.
3859
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
+ #
3860
3869
  # @option params [String] :cluster
3861
3870
  # The Amazon Resource Name (ARN) or short name of the cluster the task
3862
3871
  # is running in. If you do not specify a cluster, the default cluster is
@@ -6284,6 +6293,9 @@ module Aws::ECS
6284
6293
  # containers in this task. If `true`, this enables execute command
6285
6294
  # functionality on all containers in the task.
6286
6295
  #
6296
+ # If `true`, then the task definition must have a task role, or you must
6297
+ # provide one as an override.
6298
+ #
6287
6299
  # @option params [String] :group
6288
6300
  # The name of the task group to associate with the task. The default
6289
6301
  # value is the family name of the task definition (for example,
@@ -6427,13 +6439,33 @@ module Aws::ECS
6427
6439
  # task definition to run. If a `revision` isn't specified, the latest
6428
6440
  # `ACTIVE` revision is used.
6429
6441
  #
6442
+ # When you create an IAM policy for run-task, you can set the resource
6443
+ # to be the latest task definition revision, or a specific revision.
6444
+ #
6430
6445
  # The full ARN value must match the value that you specified as the
6431
- # `Resource` of the IAM principal's permissions policy. For example, if
6432
- # the `Resource` is
6433
- # arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName:*,
6434
- # the `taskDefinition` ARN value must be
6446
+ # `Resource` of the IAM principal's permissions policy.
6447
+ #
6448
+ # When you specify the policy resource as the latest task definition
6449
+ # version (by setting the `Resource` in the policy to
6450
+ # `arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName`),
6451
+ # then set this value to
6435
6452
  # `arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName`.
6436
6453
  #
6454
+ # When you specify the policy resource as a specific task definition
6455
+ # version (by setting the `Resource` in the policy to
6456
+ # `arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName:1`
6457
+ # or
6458
+ # `arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName:*`),
6459
+ # then set this value to
6460
+ # `arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName:1`.
6461
+ #
6462
+ # For more information, see [Policy Resources for Amazon ECS][1] in the
6463
+ # Amazon Elastic Container Service developer Guide.
6464
+ #
6465
+ #
6466
+ #
6467
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/security_iam_service-with-iam.html#security_iam_service-with-iam-id-based-policies-resources
6468
+ #
6437
6469
  # @return [Types::RunTaskResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
6438
6470
  #
6439
6471
  # * {Types::RunTaskResponse#tasks #tasks} => Array&lt;Types::Task&gt;
@@ -7857,7 +7889,7 @@ module Aws::ECS
7857
7889
  # services that do not use a load balancer are considered healthy if
7858
7890
  # they're in the `RUNNING` state. Tasks for services that use a load
7859
7891
  # balancer are considered healthy if they're in the `RUNNING` state
7860
- # and are reported as healthy by the load balancer..
7892
+ # and are reported as healthy by the load balancer.
7861
7893
  #
7862
7894
  # * The `maximumPercent` parameter represents an upper limit on the
7863
7895
  # number of running tasks during task replacement. You can use this to
@@ -7977,29 +8009,23 @@ module Aws::ECS
7977
8009
  req.send_request(options)
7978
8010
  end
7979
8011
 
7980
- # Updating the task placement strategies and constraints on an Amazon
7981
- # ECS service remains in preview and is a Beta Service as defined by and
7982
- # subject to the Beta Service Participation Service Terms located at
7983
- # [https://aws.amazon.com/service-terms][1] ("Beta Terms"). These Beta
7984
- # Terms apply to your participation in this preview.
7985
- #
7986
8012
  # Modifies the parameters of a service.
7987
8013
  #
7988
8014
  # For services using the rolling update (`ECS`) you can update the
7989
- # desired count, the deployment configuration, the network
7990
- # configuration, load balancers, service registries, enable ECS managed
7991
- # tags option, propagate tags option, task placement constraints and
7992
- # strategies, and the task definition. When you update any of these
7993
- # parameters, Amazon ECS starts new tasks with the new configuration.
8015
+ # desired count, deployment configuration, network configuration, load
8016
+ # balancers, service registries, enable ECS managed tags option,
8017
+ # propagate tags option, task placement constraints and strategies, and
8018
+ # task definition. When you update any of these parameters, Amazon ECS
8019
+ # starts new tasks with the new configuration.
7994
8020
  #
7995
8021
  # For services using the blue/green (`CODE_DEPLOY`) deployment
7996
- # controller, only the desired count, deployment configuration, task
7997
- # placement constraints and strategies, enable ECS managed tags option,
7998
- # and propagate tags can be updated using this API. If the network
7999
- # configuration, platform version, task definition, or load balancer
8000
- # need to be updated, create a new CodeDeploy deployment. For more
8001
- # information, see [CreateDeployment][2] in the *CodeDeploy API
8002
- # Reference*.
8022
+ # controller, only the desired count, deployment configuration, health
8023
+ # check grace period, task placement constraints and strategies, enable
8024
+ # ECS managed tags option, and propagate tags can be updated using this
8025
+ # API. If the network configuration, platform version, task definition,
8026
+ # or load balancer need to be updated, create a new CodeDeploy
8027
+ # deployment. For more information, see [CreateDeployment][1] in the
8028
+ # *CodeDeploy API Reference*.
8003
8029
  #
8004
8030
  # For services using an external deployment controller, you can update
8005
8031
  # only the desired count, task placement constraints and strategies,
@@ -8097,9 +8123,9 @@ module Aws::ECS
8097
8123
  # <note markdown="1"> You must have a service-linked role when you update any of the
8098
8124
  # following service properties. If you specified a custom IAM role when
8099
8125
  # you created the service, Amazon ECS automatically replaces the
8100
- # [roleARN][3] associated with the service with the ARN of your
8126
+ # [roleARN][2] associated with the service with the ARN of your
8101
8127
  # service-linked role. For more information, see [Service-linked
8102
- # roles][4] in the *Amazon Elastic Container Service Developer Guide*.
8128
+ # roles][3] in the *Amazon Elastic Container Service Developer Guide*.
8103
8129
  #
8104
8130
  # * `loadBalancers,`
8105
8131
  #
@@ -8109,10 +8135,9 @@ module Aws::ECS
8109
8135
  #
8110
8136
  #
8111
8137
  #
8112
- # [1]: https://aws.amazon.com/service-terms
8113
- # [2]: https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_CreateDeployment.html
8114
- # [3]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_Service.html#ECS-Type-Service-roleArn
8115
- # [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
8116
8141
  #
8117
8142
  # @option params [String] :cluster
8118
8143
  # The short name or full Amazon Resource Name (ARN) of the cluster that
@@ -8254,8 +8279,32 @@ module Aws::ECS
8254
8279
  # configuration, and then stops the old tasks when the new tasks are
8255
8280
  # running.
8256
8281
  #
8282
+ # For services that use rolling updates, you can add, update, or remove
8283
+ # Elastic Load Balancing target groups. You can update from a single
8284
+ # target group to multiple target groups and from multiple target groups
8285
+ # to a single target group.
8286
+ #
8287
+ # For services that use blue/green deployments, you can update Elastic
8288
+ # Load Balancing target groups by using ` CreateDeployment ` through
8289
+ # CodeDeploy. Note that multiple target groups are not supported for
8290
+ # blue/green deployments. For more information see [Register multiple
8291
+ # target groups with a service][1] in the *Amazon Elastic Container
8292
+ # Service Developer Guide*.
8293
+ #
8294
+ # For services that use the external deployment controller, you can add,
8295
+ # update, or remove load balancers by using [CreateTaskSet][2]. Note
8296
+ # that multiple target groups are not supported for external
8297
+ # deployments. For more information see [Register multiple target groups
8298
+ # with a service][1] in the *Amazon Elastic Container Service Developer
8299
+ # Guide*.
8300
+ #
8257
8301
  # You can remove existing `loadBalancers` by passing an empty list.
8258
8302
  #
8303
+ #
8304
+ #
8305
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/register-multiple-targetgroups.html
8306
+ # [2]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateTaskSet.html
8307
+ #
8259
8308
  # @option params [String] :propagate_tags
8260
8309
  # Determines whether to propagate the tags from the task definition or
8261
8310
  # the service to the task. If no value is specified, the tags aren't
@@ -8708,7 +8757,7 @@ module Aws::ECS
8708
8757
  params: params,
8709
8758
  config: config)
8710
8759
  context[:gem_name] = 'aws-sdk-ecs'
8711
- context[:gem_version] = '1.97.0'
8760
+ context[:gem_version] = '1.100.0'
8712
8761
  Seahorse::Client::Request.new(handlers, context)
8713
8762
  end
8714
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
@@ -2624,7 +2625,7 @@ module Aws::ECS
2624
2625
  # @return [Array<Types::ClusterSetting>]
2625
2626
  #
2626
2627
  # @!attribute [rw] configuration
2627
- # The execute command configuration for the cluster.
2628
+ # The `execute` command configuration for the cluster.
2628
2629
  # @return [Types::ClusterConfiguration]
2629
2630
  #
2630
2631
  # @!attribute [rw] capacity_providers
@@ -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
  #
@@ -3101,12 +3102,10 @@ module Aws::ECS
3101
3102
  # @return [Boolean]
3102
3103
  #
3103
3104
  # @!attribute [rw] propagate_tags
3104
- # Specifies whether to propagate the tags from the task definition or
3105
- # the service to the tasks in the service. If no value is specified,
3106
- # the tags aren't propagated. Tags can only be propagated to the
3107
- # tasks within the service during service creation. To add tags to a
3108
- # task after service creation or task creation, use the TagResource
3109
- # API action.
3105
+ # Specifies whether to propagate the tags from the task definition to
3106
+ # the task. If no value is specified, the tags aren't propagated.
3107
+ # Tags can only be propagated to the task during task creation. To add
3108
+ # tags to a task after task creation, use the TagResource API action.
3110
3109
  # @return [String]
3111
3110
  #
3112
3111
  # @!attribute [rw] enable_execute_command
@@ -3256,7 +3255,7 @@ module Aws::ECS
3256
3255
  #
3257
3256
  # @!attribute [rw] service_registries
3258
3257
  # The details of the service discovery registries to assign to this
3259
- # task set. For more information, see [Service Discovery][1].
3258
+ # task set. For more information, see [Service discovery][1].
3260
3259
  #
3261
3260
  #
3262
3261
  #
@@ -3265,7 +3264,7 @@ module Aws::ECS
3265
3264
  #
3266
3265
  # @!attribute [rw] launch_type
3267
3266
  # The launch type that new tasks in the task set uses. For more
3268
- # information, see [Amazon ECS Launch Types][1] in the *Amazon Elastic
3267
+ # information, see [Amazon ECS launch types][1] in the *Amazon Elastic
3269
3268
  # Container Service Developer Guide*.
3270
3269
  #
3271
3270
  # If a `launchType` is specified, the `capacityProviderStrategy`
@@ -3882,54 +3881,83 @@ module Aws::ECS
3882
3881
  #
3883
3882
  # @!attribute [rw] maximum_percent
3884
3883
  # If a service is using the rolling update (`ECS`) deployment type,
3885
- # the **maximum percent** parameter represents an upper limit on the
3886
- # number of tasks in a service that are allowed in the `RUNNING` or
3887
- # `PENDING` state during a deployment, as a percentage of the desired
3888
- # number of tasks (rounded down to the nearest integer), and while any
3889
- # container instances are in the `DRAINING` state if the service
3890
- # contains tasks using the EC2 launch type. This parameter enables you
3891
- # to define the deployment batch size. For example, if your service
3892
- # has a desired number of four tasks and a maximum percent value of
3893
- # 200%, the scheduler may start four new tasks before stopping the
3894
- # four older tasks (provided that the cluster resources required to do
3895
- # this are available). The default value for maximum percent is 200%.
3896
- #
3897
- # If a service is using the blue/green (`CODE_DEPLOY`) or `EXTERNAL`
3898
- # deployment types and tasks that use the EC2 launch type, the
3899
- # **maximum percent** value is set to the default value and is used to
3900
- # define the upper limit on the number of the tasks in the service
3901
- # that remain in the `RUNNING` state while the container instances are
3902
- # in the `DRAINING` state. If the tasks in the service use the Fargate
3903
- # launch type, the maximum percent value is not used, although it is
3904
- # 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.
3905
3904
  # @return [Integer]
3906
3905
  #
3907
3906
  # @!attribute [rw] minimum_healthy_percent
3908
3907
  # If a service is using the rolling update (`ECS`) deployment type,
3909
- # the **minimum healthy percent** represents a lower limit on the
3910
- # number of tasks in a service that must remain in the `RUNNING` state
3911
- # during a deployment, as a percentage of the desired number of tasks
3912
- # (rounded up to the nearest integer), and while any container
3913
- # instances are in the `DRAINING` state if the service contains tasks
3914
- # 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
3915
3912
  # without using additional cluster capacity. For example, if your
3916
- # service has a desired number of four tasks and a minimum healthy
3917
- # percent of 50%, the scheduler may stop two existing tasks to free up
3918
- # cluster capacity before starting two new tasks. Tasks for services
3919
- # that *do not* use a load balancer are considered healthy if they're
3920
- # in the `RUNNING` state; tasks for services that *do* use a load
3921
- # balancer are considered healthy if they're in the `RUNNING` state
3922
- # and they're reported as healthy by the load balancer. The default
3923
- # value for minimum healthy percent is 100%.
3924
- #
3925
- # If a service is using the blue/green (`CODE_DEPLOY`) or `EXTERNAL`
3926
- # deployment types and tasks that use the EC2 launch type, the
3927
- # **minimum healthy percent** value is set to the default value and is
3928
- # used to define the lower limit on the number of the tasks in the
3929
- # service that remain in the `RUNNING` state while the container
3930
- # instances are in the `DRAINING` state. If the tasks in the service
3931
- # use the Fargate launch type, the minimum healthy percent value is
3932
- # 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.
3933
3961
  # @return [Integer]
3934
3962
  #
3935
3963
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DeploymentConfiguration AWS API Documentation
@@ -3943,7 +3971,7 @@ module Aws::ECS
3943
3971
  end
3944
3972
 
3945
3973
  # The deployment controller to use for the service. For more
3946
- # information, see [Amazon ECS Deployment Types][1] in the *Amazon
3974
+ # information, see [Amazon ECS deployment types][1] in the *Amazon
3947
3975
  # Elastic Container Service Developer Guide*.
3948
3976
  #
3949
3977
  #
@@ -4010,11 +4038,12 @@ module Aws::ECS
4010
4038
  #
4011
4039
  # @!attribute [rw] container_instance
4012
4040
  # The container instance ID or full ARN of the container instance to
4013
- # deregister. The ARN contains the `arn:aws:ecs` namespace, followed
4014
- # by the Region of the container instance, the Amazon Web Services
4015
- # account ID of the container instance owner, the `container-instance`
4016
- # namespace, and then the container instance ID. For example,
4017
- # `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
4018
4047
  # @return [String]
4019
4048
  #
4020
4049
  # @!attribute [rw] force
@@ -4580,12 +4609,13 @@ module Aws::ECS
4580
4609
  # }
4581
4610
  #
4582
4611
  # @!attribute [rw] container_instance
4583
- # The container instance ID or full ARN of the container instance. The
4584
- # ARN contains the `arn:aws:ecs` namespace, followed by the Region of
4585
- # the container instance, the Amazon Web Services account ID of the
4586
- # container instance owner, the `container-instance` namespace, and
4587
- # then the container instance ID. For example,
4588
- # `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
4589
4619
  # @return [String]
4590
4620
  #
4591
4621
  # @!attribute [rw] cluster
@@ -4731,7 +4761,7 @@ module Aws::ECS
4731
4761
  # will enforce the path set on the EFS access point. If an access
4732
4762
  # point is used, transit encryption must be enabled in the
4733
4763
  # `EFSVolumeConfiguration`. For more information, see [Working with
4734
- # 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
4735
4765
  # Guide*.
4736
4766
  #
4737
4767
  #
@@ -4745,7 +4775,7 @@ module Aws::ECS
4745
4775
  # enabled, transit encryption must be enabled in the
4746
4776
  # `EFSVolumeConfiguration`. If this parameter is omitted, the default
4747
4777
  # value of `DISABLED` is used. For more information, see [Using Amazon
4748
- # EFS Access Points][1] in the *Amazon Elastic Container Service
4778
+ # EFS access points][1] in the *Amazon Elastic Container Service
4749
4779
  # Developer Guide*.
4750
4780
  #
4751
4781
  #
@@ -4764,7 +4794,7 @@ module Aws::ECS
4764
4794
 
4765
4795
  # This parameter is specified when you're using an Amazon Elastic File
4766
4796
  # System file system for task storage. For more information, see [Amazon
4767
- # EFS Volumes][1] in the *Amazon Elastic Container Service Developer
4797
+ # EFS volumes][1] in the *Amazon Elastic Container Service Developer
4768
4798
  # Guide*.
4769
4799
  #
4770
4800
  #
@@ -4805,7 +4835,7 @@ module Aws::ECS
4805
4835
  # between the Amazon ECS host and the Amazon EFS server. Transit
4806
4836
  # encryption must be enabled if Amazon EFS IAM authorization is used.
4807
4837
  # If this parameter is omitted, the default value of `DISABLED` is
4808
- # used. For more information, see [Encrypting Data in Transit][1] in
4838
+ # used. For more information, see [Encrypting data in transit][1] in
4809
4839
  # the *Amazon Elastic File System User Guide*.
4810
4840
  #
4811
4841
  #
@@ -4817,8 +4847,8 @@ module Aws::ECS
4817
4847
  # The port to use when sending encrypted data between the Amazon ECS
4818
4848
  # host and the Amazon EFS server. If you do not specify a transit
4819
4849
  # encryption port, it will use the port selection strategy that the
4820
- # Amazon EFS mount helper uses. For more information, see [EFS Mount
4821
- # 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*.
4822
4852
  #
4823
4853
  #
4824
4854
  #
@@ -5135,8 +5165,8 @@ module Aws::ECS
5135
5165
 
5136
5166
  # The authorization configuration details for Amazon FSx for Windows
5137
5167
  # File Server file system. See
5138
- # [FSxWindowsFileServerVolumeConfiguration][1] in the *Amazon Elastic
5139
- # Container Service API Reference*.
5168
+ # [FSxWindowsFileServerVolumeConfiguration][1] in the *Amazon ECS API
5169
+ # Reference*.
5140
5170
  #
5141
5171
  # For more information and the input format, see [Amazon FSx for Windows
5142
5172
  # File Server Volumes][2] in the *Amazon Elastic Container Service
@@ -5159,7 +5189,7 @@ module Aws::ECS
5159
5189
  # The authorization credential option to use. The authorization
5160
5190
  # credential options can be provided using either the Amazon Resource
5161
5191
  # Name (ARN) of an Secrets Manager secret or SSM Parameter Store
5162
- # parameter. The ARNs refer to the stored credentials.
5192
+ # parameter. The ARN refers to the stored credentials.
5163
5193
  # @return [String]
5164
5194
  #
5165
5195
  # @!attribute [rw] domain
@@ -5185,7 +5215,7 @@ module Aws::ECS
5185
5215
  # File Server][1] file system for task storage.
5186
5216
  #
5187
5217
  # For more information and the input format, see [Amazon FSx for Windows
5188
- # File Server Volumes][2] in the *Amazon Elastic Container Service
5218
+ # File Server volumes][2] in the *Amazon Elastic Container Service
5189
5219
  # Developer Guide*.
5190
5220
  #
5191
5221
  #
@@ -5260,7 +5290,7 @@ module Aws::ECS
5260
5290
 
5261
5291
  # The FireLens configuration for the container. This is used to specify
5262
5292
  # and configure a log router for container logs. For more information,
5263
- # see [Custom Log Routing][1] in the *Amazon Elastic Container Service
5293
+ # see [Custom log routing][1] in the *Amazon Elastic Container Service
5264
5294
  # Developer Guide*.
5265
5295
  #
5266
5296
  #
@@ -5289,8 +5319,8 @@ module Aws::ECS
5289
5319
  # cluster, and container instance details to the log event. If
5290
5320
  # specified, the syntax to use is
5291
5321
  # `"options":\{"enable-ecs-log-metadata":"true|false","config-file-type:"s3|file","config-file-value":"arn:aws:s3:::mybucket/fluent.conf|filepath"\}`.
5292
- # For more information, see [Creating a Task Definition that Uses a
5293
- # 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
5294
5324
  # Developer Guide*.
5295
5325
  #
5296
5326
  # <note markdown="1"> Tasks hosted on Fargate only support the `file` configuration file
@@ -5317,6 +5347,15 @@ module Aws::ECS
5317
5347
  # Docker health checks that exist in the container image (such as those
5318
5348
  # specified in a parent image or from the image's Dockerfile).
5319
5349
  #
5350
+ # <note markdown="1"> The Amazon ECS container agent only monitors and reports on the health
5351
+ # checks specified in the task definition. Amazon ECS does not monitor
5352
+ # Docker health checks that are embedded in a container image and not
5353
+ # specified in the container definition. Health check parameters that
5354
+ # are specified in a container definition override any Docker health
5355
+ # checks that exist in the container image.
5356
+ #
5357
+ # </note>
5358
+ #
5320
5359
  # You can view the health status of both individual containers and a
5321
5360
  # task with the DescribeTasks API operation or when viewing the task
5322
5361
  # details in the console.
@@ -5354,11 +5393,11 @@ module Aws::ECS
5354
5393
  #
5355
5394
  # * Container health checks require version 1.17.0 or greater of the
5356
5395
  # Amazon ECS container agent. For more information, see [Updating the
5357
- # Amazon ECS Container Agent][1].
5396
+ # Amazon ECS container agent][1].
5358
5397
  #
5359
5398
  # * Container health checks are supported for Fargate tasks if you're
5360
- # using platform version 1.1.0 or greater. For more information, see
5361
- # [Fargate Platform Versions][2].
5399
+ # using platform version `1.1.0` or greater. For more information, see
5400
+ # [Fargate platform versions][2].
5362
5401
  #
5363
5402
  # * Container health checks aren't supported for tasks that are part of
5364
5403
  # a service that's configured to use a Classic Load Balancer.
@@ -6676,7 +6715,7 @@ module Aws::ECS
6676
6715
  # balancers with services and task sets, see the CreateService and
6677
6716
  # CreateTaskSet actions.
6678
6717
  #
6679
- # When you add, update, or remove a load blaancer configuration, Amazon
6718
+ # When you add, update, or remove a load balancer configuration, Amazon
6680
6719
  # ECS starts a new deployment with the updated Elastic Load Balancing
6681
6720
  # configuration. This causes tasks to register to and deregister from
6682
6721
  # load balancers.
@@ -6685,8 +6724,8 @@ module Aws::ECS
6685
6724
  # update the Elastic Load Balancing configuration.
6686
6725
  #
6687
6726
  # A service-linked role is required for services that use multiple
6688
- # target groups. For more information, see [Service-linked roles][1] in
6689
- # 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*.
6690
6729
  #
6691
6730
  #
6692
6731
  #
@@ -6712,12 +6751,12 @@ module Aws::ECS
6712
6751
  #
6713
6752
  # For services using the `ECS` deployment controller, you can specify
6714
6753
  # one or multiple target groups. For more information, see
6715
- # [Registering Multiple Target Groups with a Service][1] in the
6754
+ # [Registering multiple target groups with a service][1] in the
6716
6755
  # *Amazon Elastic Container Service Developer Guide*.
6717
6756
  #
6718
6757
  # For services using the `CODE_DEPLOY` deployment controller, you're
6719
6758
  # required to define two target groups for the load balancer. For more
6720
- # information, see [Blue/Green Deployment with CodeDeploy][2] in the
6759
+ # information, see [Blue/green deployment with CodeDeploy][2] in the
6721
6760
  # *Amazon Elastic Container Service Developer Guide*.
6722
6761
  #
6723
6762
  # If your service's task definition uses the `awsvpc` network mode,
@@ -6871,7 +6910,7 @@ module Aws::ECS
6871
6910
  #
6872
6911
  # @!attribute [rw] secret_options
6873
6912
  # The secrets to pass to the log configuration. For more information,
6874
- # see [Specifying Sensitive Data][1] in the *Amazon Elastic Container
6913
+ # see [Specifying sensitive data][1] in the *Amazon Elastic Container
6875
6914
  # Service Developer Guide*.
6876
6915
  #
6877
6916
  #
@@ -6966,7 +7005,7 @@ module Aws::ECS
6966
7005
  # scale-out actions of the Auto Scaling group. Amazon ECS manages a
6967
7006
  # target tracking scaling policy using an Amazon ECS managed CloudWatch
6968
7007
  # metric with the specified `targetCapacity` value as the target value
6969
- # for the metric. For more information, see [Using Managed Scaling][1]
7008
+ # for the metric. For more information, see [Using managed scaling][1]
6970
7009
  # in the *Amazon Elastic Container Service Developer Guide*.
6971
7010
  #
6972
7011
  # If managed scaling is disabled, the user must manage the scaling of
@@ -7185,7 +7224,7 @@ module Aws::ECS
7185
7224
  class NoUpdateAvailableException < Aws::EmptyStructure; end
7186
7225
 
7187
7226
  # An object representing a constraint on task placement. For more
7188
- # information, see [Task Placement Constraints][1] in the *Amazon
7227
+ # information, see [Task placement constraints][1] in the *Amazon
7189
7228
  # Elastic Container Service Developer Guide*.
7190
7229
  #
7191
7230
  # <note markdown="1"> If you're using the Fargate launch type, task placement constraints
@@ -7234,7 +7273,7 @@ module Aws::ECS
7234
7273
  end
7235
7274
 
7236
7275
  # The task placement strategy for a task or service. For more
7237
- # information, see [Task Placement Strategies][1] in the *Amazon Elastic
7276
+ # information, see [Task placement strategies][1] in the *Amazon Elastic
7238
7277
  # Container Service Developer Guide*.
7239
7278
  #
7240
7279
  #
@@ -8772,6 +8811,9 @@ module Aws::ECS
8772
8811
  # Determines whether to use the execute command functionality for the
8773
8812
  # containers in this task. If `true`, this enables execute command
8774
8813
  # functionality on all containers in the task.
8814
+ #
8815
+ # If `true`, then the task definition must have a task role, or you
8816
+ # must provide one as an override.
8775
8817
  # @return [Boolean]
8776
8818
  #
8777
8819
  # @!attribute [rw] group
@@ -8928,12 +8970,32 @@ module Aws::ECS
8928
8970
  # task definition to run. If a `revision` isn't specified, the latest
8929
8971
  # `ACTIVE` revision is used.
8930
8972
  #
8973
+ # When you create an IAM policy for run-task, you can set the resource
8974
+ # to be the latest task definition revision, or a specific revision.
8975
+ #
8931
8976
  # The full ARN value must match the value that you specified as the
8932
- # `Resource` of the IAM principal's permissions policy. For example,
8933
- # if the `Resource` is
8934
- # arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName:*,
8935
- # the `taskDefinition` ARN value must be
8977
+ # `Resource` of the IAM principal's permissions policy.
8978
+ #
8979
+ # When you specify the policy resource as the latest task definition
8980
+ # version (by setting the `Resource` in the policy to
8981
+ # `arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName`),
8982
+ # then set this value to
8936
8983
  # `arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName`.
8984
+ #
8985
+ # When you specify the policy resource as a specific task definition
8986
+ # version (by setting the `Resource` in the policy to
8987
+ # `arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName:1`
8988
+ # or
8989
+ # `arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName:*`),
8990
+ # then set this value to
8991
+ # `arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName:1`.
8992
+ #
8993
+ # For more information, see [Policy Resources for Amazon ECS][1] in
8994
+ # the Amazon Elastic Container Service developer Guide.
8995
+ #
8996
+ #
8997
+ #
8998
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/security_iam_service-with-iam.html#security_iam_service-with-iam-id-based-policies-resources
8937
8999
  # @return [String]
8938
9000
  #
8939
9001
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/RunTaskRequest AWS API Documentation
@@ -9001,7 +9063,7 @@ module Aws::ECS
9001
9063
  #
9002
9064
  # You can run your Linux tasks on an ARM-based platform by setting the
9003
9065
  # value to `ARM64`. This option is avaiable for tasks that run on
9004
- # Linuc Amazon EC2 instance or Linux containers on Fargate.
9066
+ # Linux Amazon EC2 instance or Linux containers on Fargate.
9005
9067
  # @return [String]
9006
9068
  #
9007
9069
  # @!attribute [rw] operating_system_family
@@ -9056,7 +9118,7 @@ module Aws::ECS
9056
9118
  # * To reference sensitive information in the log configuration of a
9057
9119
  # container, use the `secretOptions` container definition parameter.
9058
9120
  #
9059
- # For more information, see [Specifying Sensitive Data][1] in the
9121
+ # For more information, see [Specifying sensitive data][1] in the
9060
9122
  # *Amazon Elastic Container Service Developer Guide*.
9061
9123
  #
9062
9124
  #
@@ -9124,11 +9186,13 @@ module Aws::ECS
9124
9186
  # Details on a service within a cluster
9125
9187
  #
9126
9188
  # @!attribute [rw] service_arn
9127
- # The ARN that identifies the service. The ARN contains the
9128
- # `arn:aws:ecs` namespace, followed by the Region of the service, the
9129
- # Amazon Web Services account ID of the service owner, the `service`
9130
- # namespace, and then the service name. For example,
9131
- # `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
9132
9196
  # @return [String]
9133
9197
  #
9134
9198
  # @!attribute [rw] service_name
@@ -10252,8 +10316,23 @@ module Aws::ECS
10252
10316
  #
10253
10317
  class TagResourceResponse < Aws::EmptyStructure; end
10254
10318
 
10255
- # The target container isn't properly configured with the execute
10256
- # command agent or the container is no longer active or running.
10319
+ # The execute command cannot run. This error can be caused by any of the
10320
+ # following configuration issues:
10321
+ #
10322
+ # * Incorrect IAM permissions
10323
+ #
10324
+ # * The SSM agent is not installed or is not running
10325
+ #
10326
+ # * There is an interface Amazon VPC endpoint for Amazon ECS, but there
10327
+ # is not one for for Systems Manager Session Manager
10328
+ #
10329
+ # For information about how to troubleshoot the issues, see
10330
+ # [Troubleshooting issues with ECS Exec][1] in the *Amazon Elastic
10331
+ # Container Service Developer Guide*.
10332
+ #
10333
+ #
10334
+ #
10335
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-exec.html
10257
10336
  #
10258
10337
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/TargetNotConnectedException AWS API Documentation
10259
10338
  #
@@ -12062,7 +12141,31 @@ module Aws::ECS
12062
12141
  # configuration, and then stops the old tasks when the new tasks are
12063
12142
  # running.
12064
12143
  #
12144
+ # For services that use rolling updates, you can add, update, or
12145
+ # remove Elastic Load Balancing target groups. You can update from a
12146
+ # single target group to multiple target groups and from multiple
12147
+ # target groups to a single target group.
12148
+ #
12149
+ # For services that use blue/green deployments, you can update Elastic
12150
+ # Load Balancing target groups by using ` CreateDeployment ` through
12151
+ # CodeDeploy. Note that multiple target groups are not supported for
12152
+ # blue/green deployments. For more information see [Register multiple
12153
+ # target groups with a service][1] in the *Amazon Elastic Container
12154
+ # Service Developer Guide*.
12155
+ #
12156
+ # For services that use the external deployment controller, you can
12157
+ # add, update, or remove load balancers by using [CreateTaskSet][2].
12158
+ # Note that multiple target groups are not supported for external
12159
+ # deployments. For more information see [Register multiple target
12160
+ # groups with a service][1] in the *Amazon Elastic Container Service
12161
+ # Developer Guide*.
12162
+ #
12065
12163
  # You can remove existing `loadBalancers` by passing an empty list.
12164
+ #
12165
+ #
12166
+ #
12167
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/register-multiple-targetgroups.html
12168
+ # [2]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateTaskSet.html
12066
12169
  # @return [Array<Types::LoadBalancer>]
12067
12170
  #
12068
12171
  # @!attribute [rw] propagate_tags
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.97.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.97.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-07 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