aws-sdk-ecs 1.95.0 → 1.98.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: 8da0a8e5602cca8baead650117df3b274864c833d44d8e8981c1335d4d0a0383
4
- data.tar.gz: e2c81092e792c3b55d9ed93f6d85e13d49320aa8f6b0a1d3452ee0f67cbdf467
3
+ metadata.gz: 49266dbfb72f7957a1825b64b2c26d47ee13b3a3a51d14d0ef4ac6bf4cf5c88e
4
+ data.tar.gz: e714d5a38946aafca5e0cc96165c3150837569865956727f7c3247f24464dd82
5
5
  SHA512:
6
- metadata.gz: 2476cc7a3d218059fce76b2b9dd7b36eeff7e730cfddc997184cbabdb4e5ee759558880e11a8c1fdee4d19fd5234c5cf8790d05462e16db8ebd70c7977c9990f
7
- data.tar.gz: 3a8fb805909d2c1c1f70a62bd14fcde928c0a17a0b5f8c6e6a4664a856d3ac39e7659ee01e43ec5cc9516153a48e33c34b831985733b9982a144a2bbee989c8c
6
+ metadata.gz: aae3ed5a949c62f52f95922719cc9915ca043d791ee74a373d40e2602140a00e28aa4ede58ac2fb95cbe8a8501a4c785130535a97ad1c5d71f6437cfcc660804
7
+ data.tar.gz: 84060c32132051d81b6473e14823ccb425ecb5b8c09428839d6e4720ea1bbcd58746aebb47fb46f3736ee8b12a365e8c5c698d05310f108fb055bf1b281082a3
data/CHANGELOG.md CHANGED
@@ -1,6 +1,21 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.98.0 (2022-03-15)
5
+ ------------------
6
+
7
+ * Feature - Documentation only update to address tickets
8
+
9
+ 1.97.0 (2022-03-07)
10
+ ------------------
11
+
12
+ * Feature - Amazon ECS UpdateService API now supports additional parameters: loadBalancers, propagateTags, enableECSManagedTags, and serviceRegistries
13
+
14
+ 1.96.0 (2022-02-24)
15
+ ------------------
16
+
17
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
18
+
4
19
  1.95.0 (2022-02-03)
5
20
  ------------------
6
21
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.95.0
1
+ 1.98.0
@@ -27,6 +27,7 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
27
27
  require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
28
28
  require 'aws-sdk-core/plugins/transfer_encoding.rb'
29
29
  require 'aws-sdk-core/plugins/http_checksum.rb'
30
+ require 'aws-sdk-core/plugins/checksum_algorithm.rb'
30
31
  require 'aws-sdk-core/plugins/defaults_mode.rb'
31
32
  require 'aws-sdk-core/plugins/recursion_detection.rb'
32
33
  require 'aws-sdk-core/plugins/signature_v4.rb'
@@ -75,6 +76,7 @@ module Aws::ECS
75
76
  add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
76
77
  add_plugin(Aws::Plugins::TransferEncoding)
77
78
  add_plugin(Aws::Plugins::HttpChecksum)
79
+ add_plugin(Aws::Plugins::ChecksumAlgorithm)
78
80
  add_plugin(Aws::Plugins::DefaultsMode)
79
81
  add_plugin(Aws::Plugins::RecursionDetection)
80
82
  add_plugin(Aws::Plugins::SignatureV4)
@@ -519,12 +521,12 @@ module Aws::ECS
519
521
  #
520
522
  # @option params [Array<Types::ClusterSetting>] :settings
521
523
  # The setting to use when creating a cluster. This parameter is used to
522
- # enable CloudWatch Container Insights for a cluster. If this value is
524
+ # turn on CloudWatch Container Insights for a cluster. If this value is
523
525
  # specified, it overrides the `containerInsights` value set with
524
526
  # PutAccountSetting or PutAccountSettingDefault.
525
527
  #
526
528
  # @option params [Types::ClusterConfiguration] :configuration
527
- # The execute command configuration for the cluster.
529
+ # The `execute` command configuration for the cluster.
528
530
  #
529
531
  # @option params [Array<String>] :capacity_providers
530
532
  # The short name of one or more capacity providers to associate with the
@@ -688,8 +690,7 @@ module Aws::ECS
688
690
  # Tasks for services that don't use a load balancer are considered
689
691
  # healthy if they're in the `RUNNING` state. Tasks for services that
690
692
  # use a load balancer are considered healthy if they're in the
691
- # `RUNNING` state and the container instance that they're hosted on is
692
- # reported as healthy by the load balancer.
693
+ # `RUNNING` state and are reported as healthy by the load balancer.
693
694
  #
694
695
  # There are two service scheduler strategies available:
695
696
  #
@@ -842,11 +843,8 @@ module Aws::ECS
842
843
  # listener that you can use to perform validation tests with Lambda
843
844
  # functions before routing production traffic to it.
844
845
  #
845
- # After you create a service using the `ECS` deployment controller, the
846
- # load balancer name or target group ARN, container name, and container
847
- # port that's specified in the service definition are immutable. If you
848
- # use the `CODE_DEPLOY` deployment controller, these values can be
849
- # changed when updating the service.
846
+ # If you use the `CODE_DEPLOY` deployment controller, these values can
847
+ # be changed when updating the service.
850
848
  #
851
849
  # For Application Load Balancers and Network Load Balancers, this object
852
850
  # must contain the load balancer target group ARN, the container name,
@@ -1018,6 +1016,10 @@ module Aws::ECS
1018
1016
  # defined and you don't specify a health check grace period value, the
1019
1017
  # default value of `0` is used.
1020
1018
  #
1019
+ # If you do not use an Elastic Load Balancing, we recomend that you use
1020
+ # the `startPeriod` in the task definition healtch check parameters. For
1021
+ # more information, see [Health check][1].
1022
+ #
1021
1023
  # If your service's tasks take a while to start and respond to Elastic
1022
1024
  # Load Balancing health checks, you can specify a health check grace
1023
1025
  # period of up to 2,147,483,647 seconds (about 69 years). During that
@@ -1025,6 +1027,10 @@ module Aws::ECS
1025
1027
  # This grace period can prevent the service scheduler from marking tasks
1026
1028
  # as unhealthy and stopping them before they have time to come up.
1027
1029
  #
1030
+ #
1031
+ #
1032
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_HealthCheck.html
1033
+ #
1028
1034
  # @option params [String] :scheduling_strategy
1029
1035
  # The scheduling strategy to use for the service. For more information,
1030
1036
  # see [Services][1].
@@ -1093,7 +1099,7 @@ module Aws::ECS
1093
1099
  # your tags per resource limit.
1094
1100
  #
1095
1101
  # @option params [Boolean] :enable_ecs_managed_tags
1096
- # Specifies whether to enable Amazon ECS managed tags for the tasks
1102
+ # Specifies whether to turn on Amazon ECS managed tags for the tasks
1097
1103
  # within the service. For more information, see [Tagging Your Amazon ECS
1098
1104
  # Resources][1] in the *Amazon Elastic Container Service Developer
1099
1105
  # Guide*.
@@ -1103,12 +1109,10 @@ module Aws::ECS
1103
1109
  # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html
1104
1110
  #
1105
1111
  # @option params [String] :propagate_tags
1106
- # Specifies whether to propagate the tags from the task definition or
1107
- # the service to the tasks in the service. If no value is specified, the
1108
- # tags aren't propagated. Tags can only be propagated to the tasks
1109
- # within the service during service creation. To add tags to a task
1110
- # after service creation or task creation, use the TagResource API
1111
- # 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.
1112
1116
  #
1113
1117
  # @option params [Boolean] :enable_execute_command
1114
1118
  # Determines whether the execute command functionality is enabled for
@@ -1310,7 +1314,7 @@ module Aws::ECS
1310
1314
  # },
1311
1315
  # ],
1312
1316
  # enable_ecs_managed_tags: false,
1313
- # propagate_tags: "TASK_DEFINITION", # accepts TASK_DEFINITION, SERVICE
1317
+ # propagate_tags: "TASK_DEFINITION", # accepts TASK_DEFINITION, SERVICE, NONE
1314
1318
  # enable_execute_command: false,
1315
1319
  # })
1316
1320
  #
@@ -1437,7 +1441,7 @@ module Aws::ECS
1437
1441
  # resp.service.tags[0].value #=> String
1438
1442
  # resp.service.created_by #=> String
1439
1443
  # resp.service.enable_ecs_managed_tags #=> Boolean
1440
- # resp.service.propagate_tags #=> String, one of "TASK_DEFINITION", "SERVICE"
1444
+ # resp.service.propagate_tags #=> String, one of "TASK_DEFINITION", "SERVICE", "NONE"
1441
1445
  # resp.service.enable_execute_command #=> Boolean
1442
1446
  #
1443
1447
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/CreateService AWS API Documentation
@@ -2160,7 +2164,7 @@ module Aws::ECS
2160
2164
  # resp.service.tags[0].value #=> String
2161
2165
  # resp.service.created_by #=> String
2162
2166
  # resp.service.enable_ecs_managed_tags #=> Boolean
2163
- # resp.service.propagate_tags #=> String, one of "TASK_DEFINITION", "SERVICE"
2167
+ # resp.service.propagate_tags #=> String, one of "TASK_DEFINITION", "SERVICE", "NONE"
2164
2168
  # resp.service.enable_execute_command #=> Boolean
2165
2169
  #
2166
2170
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DeleteService AWS API Documentation
@@ -3211,7 +3215,7 @@ module Aws::ECS
3211
3215
  # resp.services[0].tags[0].value #=> String
3212
3216
  # resp.services[0].created_by #=> String
3213
3217
  # resp.services[0].enable_ecs_managed_tags #=> Boolean
3214
- # resp.services[0].propagate_tags #=> String, one of "TASK_DEFINITION", "SERVICE"
3218
+ # resp.services[0].propagate_tags #=> String, one of "TASK_DEFINITION", "SERVICE", "NONE"
3215
3219
  # resp.services[0].enable_execute_command #=> Boolean
3216
3220
  # resp.failures #=> Array
3217
3221
  # resp.failures[0].arn #=> String
@@ -4837,8 +4841,8 @@ module Aws::ECS
4837
4841
  # opt-in and opt-out account setting must be set for each Amazon ECS
4838
4842
  # resource separately. The ARN and resource ID format of a resource is
4839
4843
  # defined by the opt-in status of the IAM user or role that created the
4840
- # resource. You must enable this setting to use Amazon ECS features such
4841
- # as resource tagging.
4844
+ # resource. You must turn on this setting to use Amazon ECS features
4845
+ # such as resource tagging.
4842
4846
  #
4843
4847
  # When `awsvpcTrunking` is specified, the elastic network interface
4844
4848
  # (ENI) limit for any new container instances that support the feature
@@ -5692,7 +5696,7 @@ module Aws::ECS
5692
5696
  #
5693
5697
  # For tasks hosted on Amazon EC2 instances, the container instances
5694
5698
  # require at least version `1.26.0` of the container agent and at least
5695
- # version `1.26.0-1` of the `ecs-init` package to enable a proxy
5699
+ # version `1.26.0-1` of the `ecs-init` package to use a proxy
5696
5700
  # configuration. If your container instances are launched from the
5697
5701
  # Amazon ECS-optimized AMI version `20190301` or later, then they
5698
5702
  # contain the required versions of the container agent and `ecs-init`.
@@ -6265,7 +6269,7 @@ module Aws::ECS
6265
6269
  # cluster. You can specify up to 10 tasks for each call.
6266
6270
  #
6267
6271
  # @option params [Boolean] :enable_ecs_managed_tags
6268
- # Specifies whether to enable Amazon ECS managed tags for the task. For
6272
+ # Specifies whether to use Amazon ECS managed tags for the task. For
6269
6273
  # more information, see [Tagging Your Amazon ECS Resources][1] in the
6270
6274
  # *Amazon Elastic Container Service Developer Guide*.
6271
6275
  #
@@ -6274,10 +6278,13 @@ module Aws::ECS
6274
6278
  # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html
6275
6279
  #
6276
6280
  # @option params [Boolean] :enable_execute_command
6277
- # Determines whether to enable the execute command functionality for the
6281
+ # Determines whether to use the execute command functionality for the
6278
6282
  # containers in this task. If `true`, this enables execute command
6279
6283
  # functionality on all containers in the task.
6280
6284
  #
6285
+ # If `true`, then the task definition must have a task role, or you must
6286
+ # provide one as an override.
6287
+ #
6281
6288
  # @option params [String] :group
6282
6289
  # The name of the task group to associate with the task. The default
6283
6290
  # value is the family name of the task definition (for example,
@@ -6421,13 +6428,33 @@ module Aws::ECS
6421
6428
  # task definition to run. If a `revision` isn't specified, the latest
6422
6429
  # `ACTIVE` revision is used.
6423
6430
  #
6431
+ # When you create an IAM policy for run-task, you can set the resource
6432
+ # to be the latest task definition revision, or a specific revision.
6433
+ #
6424
6434
  # The full ARN value must match the value that you specified as the
6425
- # `Resource` of the IAM principal's permissions policy. For example, if
6426
- # the `Resource` is
6427
- # arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName:*,
6428
- # the `taskDefinition` ARN value must be
6435
+ # `Resource` of the IAM principal's permissions policy.
6436
+ #
6437
+ # When you specify the policy resource as the latest task definition
6438
+ # version (by setting the `Resource` in the policy to
6439
+ # `arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName`),
6440
+ # then set this value to
6429
6441
  # `arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName`.
6430
6442
  #
6443
+ # When you specify the policy resource as a specific task definition
6444
+ # version (by setting the `Resource` in the policy to
6445
+ # `arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName:1`
6446
+ # or
6447
+ # `arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName:*`),
6448
+ # then set this value to
6449
+ # `arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName:1`.
6450
+ #
6451
+ # For more information, see [Policy Resources for Amazon ECS][1] in the
6452
+ # Amazon Elastic Container Service developer Guide.
6453
+ #
6454
+ #
6455
+ #
6456
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/security_iam_service-with-iam.html#security_iam_service-with-iam-id-based-policies-resources
6457
+ #
6431
6458
  # @return [Types::RunTaskResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
6432
6459
  #
6433
6460
  # * {Types::RunTaskResponse#tasks #tasks} => Array&lt;Types::Task&gt;
@@ -6549,7 +6576,7 @@ module Aws::ECS
6549
6576
  # },
6550
6577
  # ],
6551
6578
  # platform_version: "String",
6552
- # propagate_tags: "TASK_DEFINITION", # accepts TASK_DEFINITION, SERVICE
6579
+ # propagate_tags: "TASK_DEFINITION", # accepts TASK_DEFINITION, SERVICE, NONE
6553
6580
  # reference_id: "String",
6554
6581
  # started_by: "String",
6555
6582
  # tags: [
@@ -6702,7 +6729,7 @@ module Aws::ECS
6702
6729
  # to 10 container instances.
6703
6730
  #
6704
6731
  # @option params [Boolean] :enable_ecs_managed_tags
6705
- # Specifies whether to enable Amazon ECS managed tags for the task. For
6732
+ # Specifies whether to use Amazon ECS managed tags for the task. For
6706
6733
  # more information, see [Tagging Your Amazon ECS Resources][1] in the
6707
6734
  # *Amazon Elastic Container Service Developer Guide*.
6708
6735
  #
@@ -6857,7 +6884,7 @@ module Aws::ECS
6857
6884
  # size_in_gi_b: 1, # required
6858
6885
  # },
6859
6886
  # },
6860
- # propagate_tags: "TASK_DEFINITION", # accepts TASK_DEFINITION, SERVICE
6887
+ # propagate_tags: "TASK_DEFINITION", # accepts TASK_DEFINITION, SERVICE, NONE
6861
6888
  # reference_id: "String",
6862
6889
  # started_by: "String",
6863
6890
  # tags: [
@@ -7638,7 +7665,7 @@ module Aws::ECS
7638
7665
  #
7639
7666
  # @option params [required, Array<Types::ClusterSetting>] :settings
7640
7667
  # The setting to use by default for a cluster. This parameter is used to
7641
- # enable CloudWatch Container Insights for a cluster. If this value is
7668
+ # turn on CloudWatch Container Insights for a cluster. If this value is
7642
7669
  # specified, it overrides the `containerInsights` value set with
7643
7670
  # PutAccountSetting or PutAccountSettingDefault.
7644
7671
  #
@@ -7851,8 +7878,7 @@ module Aws::ECS
7851
7878
  # services that do not use a load balancer are considered healthy if
7852
7879
  # they're in the `RUNNING` state. Tasks for services that use a load
7853
7880
  # balancer are considered healthy if they're in the `RUNNING` state
7854
- # and the container instance they're hosted on is reported as healthy
7855
- # by the load balancer.
7881
+ # and are reported as healthy by the load balancer.
7856
7882
  #
7857
7883
  # * The `maximumPercent` parameter represents an upper limit on the
7858
7884
  # number of running tasks during task replacement. You can use this to
@@ -7980,24 +8006,28 @@ module Aws::ECS
7980
8006
  #
7981
8007
  # Modifies the parameters of a service.
7982
8008
  #
7983
- # For services using the rolling update (`ECS`) deployment controller,
7984
- # the desired count, deployment configuration, network configuration,
7985
- # task placement constraints and strategies, or task definition used can
7986
- # be updated.
8009
+ # For services using the rolling update (`ECS`) you can update the
8010
+ # desired count, deployment configuration, network configuration, load
8011
+ # balancers, service registries, enable ECS managed tags option,
8012
+ # propagate tags option, task placement constraints and strategies, and
8013
+ # task definition. When you update any of these parameters, Amazon ECS
8014
+ # starts new tasks with the new configuration.
7987
8015
  #
7988
8016
  # For services using the blue/green (`CODE_DEPLOY`) deployment
7989
- # controller, only the desired count, deployment configuration, task
7990
- # placement constraints and strategies, and health check grace period
7991
- # can be updated using this API. If the network configuration, platform
7992
- # version, or task definition need to be updated, a new CodeDeploy
7993
- # deployment is created. For more information, see [CreateDeployment][2]
7994
- # in the *CodeDeploy API Reference*.
8017
+ # controller, only the desired count, deployment configuration, health
8018
+ # check grace period, task placement constraints and strategies, enable
8019
+ # ECS managed tags option, and propagate tags can be updated using this
8020
+ # API. If the network configuration, platform version, task definition,
8021
+ # or load balancer need to be updated, create a new CodeDeploy
8022
+ # deployment. For more information, see [CreateDeployment][2] in the
8023
+ # *CodeDeploy API Reference*.
7995
8024
  #
7996
8025
  # For services using an external deployment controller, you can update
7997
- # only the desired count, task placement constraints and strategies, and
7998
- # health check grace period using this API. If the launch type, load
8026
+ # only the desired count, task placement constraints and strategies,
8027
+ # health check grace period, enable ECS managed tags option, and
8028
+ # propagate tags option, using this API. If the launch type, load
7999
8029
  # balancer, network configuration, platform version, or task definition
8000
- # need to be updated, create a new task set. For more information, see
8030
+ # need to be updated, create a new task set For more information, see
8001
8031
  # CreateTaskSet.
8002
8032
  #
8003
8033
  # You can add to or subtract from the number of instantiations of a task
@@ -8033,8 +8063,7 @@ module Aws::ECS
8033
8063
  # services that don't use a load balancer are considered healthy if
8034
8064
  # they're in the `RUNNING` state. Tasks for services that use a load
8035
8065
  # balancer are considered healthy if they're in the `RUNNING` state
8036
- # and the container instance they're hosted on is reported as healthy
8037
- # by the load balancer.
8066
+ # and are reported as healthy by the load balancer.
8038
8067
  #
8039
8068
  # * The `maximumPercent` parameter represents an upper limit on the
8040
8069
  # number of running tasks during a deployment. You can use it to
@@ -8086,10 +8115,25 @@ module Aws::ECS
8086
8115
  # Zone (based on the previous steps), favoring container instances
8087
8116
  # with the largest number of running tasks for this service.
8088
8117
  #
8118
+ # <note markdown="1"> You must have a service-linked role when you update any of the
8119
+ # following service properties. If you specified a custom IAM role when
8120
+ # you created the service, Amazon ECS automatically replaces the
8121
+ # [roleARN][3] associated with the service with the ARN of your
8122
+ # service-linked role. For more information, see [Service-linked
8123
+ # roles][4] in the *Amazon Elastic Container Service Developer Guide*.
8124
+ #
8125
+ # * `loadBalancers,`
8126
+ #
8127
+ # * `serviceRegistries`
8128
+ #
8129
+ # </note>
8130
+ #
8089
8131
  #
8090
8132
  #
8091
8133
  # [1]: https://aws.amazon.com/service-terms
8092
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
8093
8137
  #
8094
8138
  # @option params [String] :cluster
8095
8139
  # The short name or full Amazon Resource Name (ARN) of the cluster that
@@ -8206,6 +8250,57 @@ module Aws::ECS
8206
8250
  # If you do not want to override the value that was set when the service
8207
8251
  # was created, you can set this to `null` when performing this action.
8208
8252
  #
8253
+ # @option params [Boolean] :enable_ecs_managed_tags
8254
+ # Determines whether to turn on Amazon ECS managed tags for the tasks in
8255
+ # the service. For more information, see [Tagging Your Amazon ECS
8256
+ # Resources][1] in the *Amazon Elastic Container Service Developer
8257
+ # Guide*.
8258
+ #
8259
+ # Only tasks launched after the update will reflect the update. To
8260
+ # update the tags on all tasks, set `forceNewDeployment` to `true`, so
8261
+ # that Amazon ECS starts new tasks with the updated tags.
8262
+ #
8263
+ #
8264
+ #
8265
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html
8266
+ #
8267
+ # @option params [Array<Types::LoadBalancer>] :load_balancers
8268
+ # A list of Elastic Load Balancing load balancer objects. It contains
8269
+ # the load balancer name, the container name, and the container port to
8270
+ # access from the load balancer. The container name is as it appears in
8271
+ # a container definition.
8272
+ #
8273
+ # When you add, update, or remove a load balancer configuration, Amazon
8274
+ # ECS starts new tasks with the updated Elastic Load Balancing
8275
+ # configuration, and then stops the old tasks when the new tasks are
8276
+ # running.
8277
+ #
8278
+ # You can remove existing `loadBalancers` by passing an empty list.
8279
+ #
8280
+ # @option params [String] :propagate_tags
8281
+ # Determines whether to propagate the tags from the task definition or
8282
+ # the service to the task. If no value is specified, the tags aren't
8283
+ # propagated.
8284
+ #
8285
+ # Only tasks launched after the update will reflect the update. To
8286
+ # update the tags on all tasks, set `forceNewDeployment` to `true`, so
8287
+ # that Amazon ECS starts new tasks with the updated tags.
8288
+ #
8289
+ # @option params [Array<Types::ServiceRegistry>] :service_registries
8290
+ # The details for the service discovery registries to assign to this
8291
+ # service. For more information, see [Service Discovery][1].
8292
+ #
8293
+ # When you add, update, or remove the service registries configuration,
8294
+ # Amazon ECS starts new tasks with the updated service registries
8295
+ # configuration, and then stops the old tasks when the new tasks are
8296
+ # running.
8297
+ #
8298
+ # You can remove existing `serviceRegistries` by passing an empty list.
8299
+ #
8300
+ #
8301
+ #
8302
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-discovery.html
8303
+ #
8209
8304
  # @return [Types::UpdateServiceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
8210
8305
  #
8211
8306
  # * {Types::UpdateServiceResponse#service #service} => Types::Service
@@ -8282,6 +8377,24 @@ module Aws::ECS
8282
8377
  # force_new_deployment: false,
8283
8378
  # health_check_grace_period_seconds: 1,
8284
8379
  # enable_execute_command: false,
8380
+ # enable_ecs_managed_tags: false,
8381
+ # load_balancers: [
8382
+ # {
8383
+ # target_group_arn: "String",
8384
+ # load_balancer_name: "String",
8385
+ # container_name: "String",
8386
+ # container_port: 1,
8387
+ # },
8388
+ # ],
8389
+ # propagate_tags: "TASK_DEFINITION", # accepts TASK_DEFINITION, SERVICE, NONE
8390
+ # service_registries: [
8391
+ # {
8392
+ # registry_arn: "String",
8393
+ # port: 1,
8394
+ # container_name: "String",
8395
+ # container_port: 1,
8396
+ # },
8397
+ # ],
8285
8398
  # })
8286
8399
  #
8287
8400
  # @example Response structure
@@ -8407,7 +8520,7 @@ module Aws::ECS
8407
8520
  # resp.service.tags[0].value #=> String
8408
8521
  # resp.service.created_by #=> String
8409
8522
  # resp.service.enable_ecs_managed_tags #=> Boolean
8410
- # resp.service.propagate_tags #=> String, one of "TASK_DEFINITION", "SERVICE"
8523
+ # resp.service.propagate_tags #=> String, one of "TASK_DEFINITION", "SERVICE", "NONE"
8411
8524
  # resp.service.enable_execute_command #=> Boolean
8412
8525
  #
8413
8526
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/UpdateService AWS API Documentation
@@ -8616,7 +8729,7 @@ module Aws::ECS
8616
8729
  params: params,
8617
8730
  config: config)
8618
8731
  context[:gem_name] = 'aws-sdk-ecs'
8619
- context[:gem_version] = '1.95.0'
8732
+ context[:gem_version] = '1.98.0'
8620
8733
  Seahorse::Client::Request.new(handlers, context)
8621
8734
  end
8622
8735
 
@@ -1658,6 +1658,10 @@ module Aws::ECS
1658
1658
  UpdateServiceRequest.add_member(:force_new_deployment, Shapes::ShapeRef.new(shape: Boolean, location_name: "forceNewDeployment"))
1659
1659
  UpdateServiceRequest.add_member(:health_check_grace_period_seconds, Shapes::ShapeRef.new(shape: BoxedInteger, location_name: "healthCheckGracePeriodSeconds"))
1660
1660
  UpdateServiceRequest.add_member(:enable_execute_command, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "enableExecuteCommand"))
1661
+ UpdateServiceRequest.add_member(:enable_ecs_managed_tags, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "enableECSManagedTags"))
1662
+ UpdateServiceRequest.add_member(:load_balancers, Shapes::ShapeRef.new(shape: LoadBalancers, location_name: "loadBalancers"))
1663
+ UpdateServiceRequest.add_member(:propagate_tags, Shapes::ShapeRef.new(shape: PropagateTags, location_name: "propagateTags"))
1664
+ UpdateServiceRequest.add_member(:service_registries, Shapes::ShapeRef.new(shape: ServiceRegistries, location_name: "serviceRegistries"))
1661
1665
  UpdateServiceRequest.struct_class = Types::UpdateServiceRequest
1662
1666
 
1663
1667
  UpdateServiceResponse.add_member(:service, Shapes::ShapeRef.new(shape: Service, location_name: "service"))
@@ -77,8 +77,8 @@ module Aws::ECS
77
77
  end
78
78
 
79
79
  # An attribute is a name-value pair that's associated with an Amazon
80
- # ECS object. Attributes enable you to extend the Amazon ECS data model
81
- # by adding custom metadata to your resources. For more information, see
80
+ # ECS object. Use attributes to extend the Amazon ECS data model by
81
+ # adding custom metadata to your resources. For more information, see
82
82
  # [Attributes][1] in the *Amazon Elastic Container Service Developer
83
83
  # Guide*.
84
84
  #
@@ -748,7 +748,7 @@ module Aws::ECS
748
748
  class ClusterNotFoundException < Aws::EmptyStructure; end
749
749
 
750
750
  # The settings to use when creating a cluster. This parameter is used to
751
- # enable CloudWatch Container Insights for a cluster.
751
+ # turn on CloudWatch Container Insights for a cluster.
752
752
  #
753
753
  # @note When making an API call, you may pass ClusterSetting
754
754
  # data as a hash:
@@ -1459,7 +1459,7 @@ module Aws::ECS
1459
1459
  # reversed.
1460
1460
  #
1461
1461
  # For tasks using the EC2 launch type, the container instances require
1462
- # at least version 1.26.0 of the container agent to enable container
1462
+ # at least version 1.26.0 of the container agent to turn on container
1463
1463
  # dependencies. However, we recommend using the latest container agent
1464
1464
  # version. For information about checking your agent version and
1465
1465
  # updating to the latest version, see [Updating the Amazon ECS
@@ -1509,7 +1509,7 @@ module Aws::ECS
1509
1509
  # * Windows platform version `1.0.0` or later.
1510
1510
  #
1511
1511
  # For tasks using the EC2 launch type, your container instances
1512
- # require at least version `1.26.0` of the container agent to enable a
1512
+ # require at least version `1.26.0` of the container agent to use a
1513
1513
  # container start timeout value. However, we recommend using the
1514
1514
  # latest container agent version. For information about checking your
1515
1515
  # agent version and updating to the latest version, see [Updating the
@@ -1549,7 +1549,7 @@ module Aws::ECS
1549
1549
  # `ECS_CONTAINER_STOP_TIMEOUT` agent configuration variable are set,
1550
1550
  # then the default values of 30 seconds for Linux containers and 30
1551
1551
  # seconds on Windows containers are used. Your container instances
1552
- # require at least version 1.26.0 of the container agent to enable a
1552
+ # require at least version 1.26.0 of the container agent to use a
1553
1553
  # container stop timeout value. However, we recommend using the latest
1554
1554
  # container agent version. For information about checking your agent
1555
1555
  # version and updating to the latest version, see [Updating the Amazon
@@ -2001,7 +2001,7 @@ module Aws::ECS
2001
2001
  # defined for container startup, for container shutdown it is reversed.
2002
2002
  #
2003
2003
  # Your Amazon ECS container instances require at least version 1.26.0 of
2004
- # the container agent to enable container dependencies. However, we
2004
+ # the container agent to use container dependencies. However, we
2005
2005
  # recommend using the latest container agent version. For information
2006
2006
  # about checking your agent version and updating to the latest version,
2007
2007
  # see [Updating the Amazon ECS Container Agent][1] in the *Amazon
@@ -2618,13 +2618,13 @@ module Aws::ECS
2618
2618
  #
2619
2619
  # @!attribute [rw] settings
2620
2620
  # The setting to use when creating a cluster. This parameter is used
2621
- # to enable CloudWatch Container Insights for a cluster. If this value
2622
- # is specified, it overrides the `containerInsights` value set with
2623
- # PutAccountSetting or PutAccountSettingDefault.
2621
+ # to turn on CloudWatch Container Insights for a cluster. If this
2622
+ # value is specified, it overrides the `containerInsights` value set
2623
+ # with PutAccountSetting or PutAccountSettingDefault.
2624
2624
  # @return [Array<Types::ClusterSetting>]
2625
2625
  #
2626
2626
  # @!attribute [rw] configuration
2627
- # The execute command configuration for the cluster.
2627
+ # The `execute` command configuration for the cluster.
2628
2628
  # @return [Types::ClusterConfiguration]
2629
2629
  #
2630
2630
  # @!attribute [rw] capacity_providers
@@ -2760,7 +2760,7 @@ module Aws::ECS
2760
2760
  # },
2761
2761
  # ],
2762
2762
  # enable_ecs_managed_tags: false,
2763
- # propagate_tags: "TASK_DEFINITION", # accepts TASK_DEFINITION, SERVICE
2763
+ # propagate_tags: "TASK_DEFINITION", # accepts TASK_DEFINITION, SERVICE, NONE
2764
2764
  # enable_execute_command: false,
2765
2765
  # }
2766
2766
  #
@@ -2812,11 +2812,8 @@ module Aws::ECS
2812
2812
  # optional listener that you can use to perform validation tests with
2813
2813
  # Lambda functions before routing production traffic to it.
2814
2814
  #
2815
- # After you create a service using the `ECS` deployment controller,
2816
- # the load balancer name or target group ARN, container name, and
2817
- # container port that's specified in the service definition are
2818
- # immutable. If you use the `CODE_DEPLOY` deployment controller, these
2819
- # values can be changed when updating the service.
2815
+ # If you use the `CODE_DEPLOY` deployment controller, these values can
2816
+ # be changed when updating the service.
2820
2817
  #
2821
2818
  # For Application Load Balancers and Network Load Balancers, this
2822
2819
  # object must contain the load balancer target group ARN, the
@@ -3004,6 +3001,10 @@ module Aws::ECS
3004
3001
  # load balancer defined and you don't specify a health check grace
3005
3002
  # period value, the default value of `0` is used.
3006
3003
  #
3004
+ # If you do not use an Elastic Load Balancing, we recomend that you
3005
+ # use the `startPeriod` in the task definition healtch check
3006
+ # parameters. For more information, see [Health check][1].
3007
+ #
3007
3008
  # If your service's tasks take a while to start and respond to
3008
3009
  # Elastic Load Balancing health checks, you can specify a health check
3009
3010
  # grace period of up to 2,147,483,647 seconds (about 69 years). During
@@ -3011,6 +3012,10 @@ module Aws::ECS
3011
3012
  # status. This grace period can prevent the service scheduler from
3012
3013
  # marking tasks as unhealthy and stopping them before they have time
3013
3014
  # to come up.
3015
+ #
3016
+ #
3017
+ #
3018
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_HealthCheck.html
3014
3019
  # @return [Integer]
3015
3020
  #
3016
3021
  # @!attribute [rw] scheduling_strategy
@@ -3085,7 +3090,7 @@ module Aws::ECS
3085
3090
  # @return [Array<Types::Tag>]
3086
3091
  #
3087
3092
  # @!attribute [rw] enable_ecs_managed_tags
3088
- # Specifies whether to enable Amazon ECS managed tags for the tasks
3093
+ # Specifies whether to turn on Amazon ECS managed tags for the tasks
3089
3094
  # within the service. For more information, see [Tagging Your Amazon
3090
3095
  # ECS Resources][1] in the *Amazon Elastic Container Service Developer
3091
3096
  # Guide*.
@@ -3096,12 +3101,10 @@ module Aws::ECS
3096
3101
  # @return [Boolean]
3097
3102
  #
3098
3103
  # @!attribute [rw] propagate_tags
3099
- # Specifies whether to propagate the tags from the task definition or
3100
- # the service to the tasks in the service. If no value is specified,
3101
- # the tags aren't propagated. Tags can only be propagated to the
3102
- # tasks within the service during service creation. To add tags to a
3103
- # task after service creation or task creation, use the TagResource
3104
- # API action.
3104
+ # Specifies whether to propagate the tags from the task definition to
3105
+ # the task. If no value is specified, the tags aren't propagated.
3106
+ # Tags can only be propagated to the task during task creation. To add
3107
+ # tags to a task after task creation, use the TagResource API action.
3105
3108
  # @return [String]
3106
3109
  #
3107
3110
  # @!attribute [rw] enable_execute_command
@@ -3808,9 +3811,9 @@ module Aws::ECS
3808
3811
  # The **deployment circuit breaker** determines whether a service
3809
3812
  # deployment will fail if the service can't reach a steady state. If
3810
3813
  # enabled, a service deployment will transition to a failed state and
3811
- # stop launching new tasks. You can also enable Amazon ECS to roll back
3812
- # your service to the last completed deployment after a failure. For
3813
- # more information, see [Rolling update][1] in the *Amazon Elastic
3814
+ # stop launching new tasks. You can also configure Amazon ECS to roll
3815
+ # back your service to the last completed deployment after a failure.
3816
+ # For more information, see [Rolling update][1] in the *Amazon Elastic
3814
3817
  # Container Service Developer Guide*.
3815
3818
  #
3816
3819
  #
@@ -3826,15 +3829,15 @@ module Aws::ECS
3826
3829
  # }
3827
3830
  #
3828
3831
  # @!attribute [rw] enable
3829
- # Determines whether to enable the deployment circuit breaker logic
3830
- # for the service.
3832
+ # Determines whether to use the deployment circuit breaker logic for
3833
+ # the service.
3831
3834
  # @return [Boolean]
3832
3835
  #
3833
3836
  # @!attribute [rw] rollback
3834
- # Determines whether to enable Amazon ECS to roll back the service if
3835
- # a service deployment fails. If rollback is enabled, when a service
3836
- # deployment fails, the service is rolled back to the last deployment
3837
- # that completed successfully.
3837
+ # Determines whether to configure Amazon ECS to roll back the service
3838
+ # if a service deployment fails. If rollback is enabled, when a
3839
+ # service deployment fails, the service is rolled back to the last
3840
+ # deployment that completed successfully.
3838
3841
  # @return [Boolean]
3839
3842
  #
3840
3843
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DeploymentCircuitBreaker AWS API Documentation
@@ -4796,12 +4799,12 @@ module Aws::ECS
4796
4799
  # @return [String]
4797
4800
  #
4798
4801
  # @!attribute [rw] transit_encryption
4799
- # Determines whether to enable encryption for Amazon EFS data in
4800
- # transit between the Amazon ECS host and the Amazon EFS server.
4801
- # Transit encryption must be enabled if Amazon EFS IAM authorization
4802
- # is used. If this parameter is omitted, the default value of
4803
- # `DISABLED` is used. For more information, see [Encrypting Data in
4804
- # Transit][1] in the *Amazon Elastic File System User Guide*.
4802
+ # Determines whether to use encryption for Amazon EFS data in transit
4803
+ # between the Amazon ECS host and the Amazon EFS server. Transit
4804
+ # encryption must be enabled if Amazon EFS IAM authorization is used.
4805
+ # If this parameter is omitted, the default value of `DISABLED` is
4806
+ # used. For more information, see [Encrypting Data in Transit][1] in
4807
+ # the *Amazon Elastic File System User Guide*.
4805
4808
  #
4806
4809
  #
4807
4810
  #
@@ -4898,12 +4901,9 @@ module Aws::ECS
4898
4901
  # more information, see [Fargate task storage][1] in the *Amazon ECS
4899
4902
  # User Guide for Fargate*.
4900
4903
  #
4901
- # <note markdown="1"> This parameter is only supported for tasks hosted on Fargate using the
4902
- # following platform versions:
4903
- #
4904
- # * Linux platform version `1.4.0` or later.
4905
- #
4906
- # * Windows platform version `1.0.0` or later.
4904
+ # <note markdown="1"> This parameter is only supported for tasks hosted on Fargate using
4905
+ # Linux platform version `1.4.0` or later. This parameter is not
4906
+ # supported for Windows containers on Fargate.
4907
4907
  #
4908
4908
  # </note>
4909
4909
  #
@@ -5010,8 +5010,8 @@ module Aws::ECS
5010
5010
  # @return [String]
5011
5011
  #
5012
5012
  # @!attribute [rw] cloud_watch_encryption_enabled
5013
- # Determines whether to enable encryption on the CloudWatch logs. If
5014
- # not specified, encryption will be disabled.
5013
+ # Determines whether to use encryption on the CloudWatch logs. If not
5014
+ # specified, encryption will be disabled.
5015
5015
  # @return [Boolean]
5016
5016
  #
5017
5017
  # @!attribute [rw] s3_bucket_name
@@ -5315,6 +5315,15 @@ module Aws::ECS
5315
5315
  # Docker health checks that exist in the container image (such as those
5316
5316
  # specified in a parent image or from the image's Dockerfile).
5317
5317
  #
5318
+ # <note markdown="1"> The Amazon ECS container agent only monitors and reports on the health
5319
+ # checks specified in the task definition. Amazon ECS does not monitor
5320
+ # Docker health checks that are embedded in a container image and not
5321
+ # specified in the container definition. Health check parameters that
5322
+ # are specified in a container definition override any Docker health
5323
+ # checks that exist in the container image.
5324
+ #
5325
+ # </note>
5326
+ #
5318
5327
  # You can view the health status of both individual containers and a
5319
5328
  # task with the DescribeTasks API operation or when viewing the task
5320
5329
  # details in the console.
@@ -6674,6 +6683,22 @@ module Aws::ECS
6674
6683
  # balancers with services and task sets, see the CreateService and
6675
6684
  # CreateTaskSet actions.
6676
6685
  #
6686
+ # When you add, update, or remove a load blaancer configuration, Amazon
6687
+ # ECS starts a new deployment with the updated Elastic Load Balancing
6688
+ # configuration. This causes tasks to register to and deregister from
6689
+ # load balancers.
6690
+ #
6691
+ # We recommend that you verify this on a test environment before you
6692
+ # update the Elastic Load Balancing configuration.
6693
+ #
6694
+ # 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*.
6697
+ #
6698
+ #
6699
+ #
6700
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using-service-linked-roles.html
6701
+ #
6677
6702
  # @note When making an API call, you may pass LoadBalancer
6678
6703
  # data as a hash:
6679
6704
  #
@@ -6970,8 +6995,7 @@ module Aws::ECS
6970
6995
  # }
6971
6996
  #
6972
6997
  # @!attribute [rw] status
6973
- # Determines whether to enable managed scaling for the capacity
6974
- # provider.
6998
+ # Determines whether to use managed scaling for the capacity provider.
6975
6999
  # @return [String]
6976
7000
  #
6977
7001
  # @!attribute [rw] target_capacity
@@ -7407,7 +7431,7 @@ module Aws::ECS
7407
7431
  #
7408
7432
  # For tasks that use the EC2 launch type, the container instances
7409
7433
  # require at least version 1.26.0 of the container agent and at least
7410
- # version 1.26.0-1 of the `ecs-init` package to enable a proxy
7434
+ # version 1.26.0-1 of the `ecs-init` package to use a proxy
7411
7435
  # configuration. If your container instances are launched from the
7412
7436
  # Amazon ECS optimized AMI version `20190301` or later, then they
7413
7437
  # contain the required versions of the container agent and `ecs-init`.
@@ -8391,7 +8415,7 @@ module Aws::ECS
8391
8415
  #
8392
8416
  # For tasks hosted on Amazon EC2 instances, the container instances
8393
8417
  # require at least version `1.26.0` of the container agent and at
8394
- # least version `1.26.0-1` of the `ecs-init` package to enable a proxy
8418
+ # least version `1.26.0-1` of the `ecs-init` package to use a proxy
8395
8419
  # configuration. If your container instances are launched from the
8396
8420
  # Amazon ECS-optimized AMI version `20190301` or later, then they
8397
8421
  # contain the required versions of the container agent and `ecs-init`.
@@ -8703,7 +8727,7 @@ module Aws::ECS
8703
8727
  # },
8704
8728
  # ],
8705
8729
  # platform_version: "String",
8706
- # propagate_tags: "TASK_DEFINITION", # accepts TASK_DEFINITION, SERVICE
8730
+ # propagate_tags: "TASK_DEFINITION", # accepts TASK_DEFINITION, SERVICE, NONE
8707
8731
  # reference_id: "String",
8708
8732
  # started_by: "String",
8709
8733
  # tags: [
@@ -8742,9 +8766,9 @@ module Aws::ECS
8742
8766
  # @return [Integer]
8743
8767
  #
8744
8768
  # @!attribute [rw] enable_ecs_managed_tags
8745
- # Specifies whether to enable Amazon ECS managed tags for the task.
8746
- # For more information, see [Tagging Your Amazon ECS Resources][1] in
8747
- # the *Amazon Elastic Container Service Developer Guide*.
8769
+ # Specifies whether to use Amazon ECS managed tags for the task. For
8770
+ # more information, see [Tagging Your Amazon ECS Resources][1] in the
8771
+ # *Amazon Elastic Container Service Developer Guide*.
8748
8772
  #
8749
8773
  #
8750
8774
  #
@@ -8752,9 +8776,12 @@ module Aws::ECS
8752
8776
  # @return [Boolean]
8753
8777
  #
8754
8778
  # @!attribute [rw] enable_execute_command
8755
- # Determines whether to enable the execute command functionality for
8756
- # the containers in this task. If `true`, this enables execute command
8779
+ # Determines whether to use the execute command functionality for the
8780
+ # containers in this task. If `true`, this enables execute command
8757
8781
  # functionality on all containers in the task.
8782
+ #
8783
+ # If `true`, then the task definition must have a task role, or you
8784
+ # must provide one as an override.
8758
8785
  # @return [Boolean]
8759
8786
  #
8760
8787
  # @!attribute [rw] group
@@ -8911,12 +8938,32 @@ module Aws::ECS
8911
8938
  # task definition to run. If a `revision` isn't specified, the latest
8912
8939
  # `ACTIVE` revision is used.
8913
8940
  #
8941
+ # When you create an IAM policy for run-task, you can set the resource
8942
+ # to be the latest task definition revision, or a specific revision.
8943
+ #
8914
8944
  # The full ARN value must match the value that you specified as the
8915
- # `Resource` of the IAM principal's permissions policy. For example,
8916
- # if the `Resource` is
8917
- # arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName:*,
8918
- # the `taskDefinition` ARN value must be
8945
+ # `Resource` of the IAM principal's permissions policy.
8946
+ #
8947
+ # When you specify the policy resource as the latest task definition
8948
+ # version (by setting the `Resource` in the policy to
8949
+ # `arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName`),
8950
+ # then set this value to
8919
8951
  # `arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName`.
8952
+ #
8953
+ # When you specify the policy resource as a specific task definition
8954
+ # version (by setting the `Resource` in the policy to
8955
+ # `arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName:1`
8956
+ # or
8957
+ # `arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName:*`),
8958
+ # then set this value to
8959
+ # `arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName:1`.
8960
+ #
8961
+ # For more information, see [Policy Resources for Amazon ECS][1] in
8962
+ # the Amazon Elastic Container Service developer Guide.
8963
+ #
8964
+ #
8965
+ #
8966
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/security_iam_service-with-iam.html#security_iam_service-with-iam-id-based-policies-resources
8920
8967
  # @return [String]
8921
8968
  #
8922
8969
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/RunTaskRequest AWS API Documentation
@@ -9063,12 +9110,23 @@ module Aws::ECS
9063
9110
  # either the full ARN of the Secrets Manager secret or the full ARN of
9064
9111
  # the parameter in the SSM Parameter Store.
9065
9112
  #
9113
+ # For information about the require Identity and Access Management
9114
+ # permissions, see [Required IAM permissions for Amazon ECS
9115
+ # secrets][1] (for Secrets Manager) or [Required IAM permissions for
9116
+ # Amazon ECS secrets][2] (for Systems Manager Parameter store) in the
9117
+ # *Amazon Elastic Container Service Developer Guide*.
9118
+ #
9066
9119
  # <note markdown="1"> If the SSM Parameter Store parameter exists in the same Region as
9067
9120
  # the task you're launching, then you can use either the full ARN or
9068
9121
  # name of the parameter. If the parameter exists in a different
9069
9122
  # Region, then the full ARN must be specified.
9070
9123
  #
9071
9124
  # </note>
9125
+ #
9126
+ #
9127
+ #
9128
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/specifying-sensitive-data-secrets.html#secrets-iam
9129
+ # [2]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/specifying-sensitive-data-parameters.html
9072
9130
  # @return [String]
9073
9131
  #
9074
9132
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/Secret AWS API Documentation
@@ -9257,7 +9315,7 @@ module Aws::ECS
9257
9315
  # placement decisions.
9258
9316
  #
9259
9317
  # * `DAEMON`-The daemon scheduling strategy deploys exactly one task
9260
- # on each active container instance. This taskmeets all of the task
9318
+ # on each active container instance. This task meets all of the task
9261
9319
  # placement constraints that you specify in your cluster. The
9262
9320
  # service scheduler also evaluates the task placement constraints
9263
9321
  # for running tasks. It stop tasks that don't meet the placement
@@ -9314,8 +9372,8 @@ module Aws::ECS
9314
9372
  # @return [String]
9315
9373
  #
9316
9374
  # @!attribute [rw] enable_ecs_managed_tags
9317
- # Determines whether to enable Amazon ECS managed tags for the tasks
9318
- # in the service. For more information, see [Tagging Your Amazon ECS
9375
+ # Determines whether to use Amazon ECS managed tags for the tasks in
9376
+ # the service. For more information, see [Tagging Your Amazon ECS
9319
9377
  # Resources][1] in the *Amazon Elastic Container Service Developer
9320
9378
  # Guide*.
9321
9379
  #
@@ -9416,6 +9474,13 @@ module Aws::ECS
9416
9474
 
9417
9475
  # The details for the service registry.
9418
9476
  #
9477
+ # Each service may be associated with one service registry. Multiple
9478
+ # service registries for each service are not supported.
9479
+ #
9480
+ # When you add, update, or remove the service registries configuration,
9481
+ # Amazon ECS starts a new deployment. New tasks are registered and
9482
+ # deregistered to the updated service registry configuration.
9483
+ #
9419
9484
  # @note When making an API call, you may pass ServiceRegistry
9420
9485
  # data as a hash:
9421
9486
  #
@@ -9484,7 +9549,7 @@ module Aws::ECS
9484
9549
  # @return [String]
9485
9550
  #
9486
9551
  # @!attribute [rw] stream_url
9487
- # A URL back to managed agent on the container that the SSM Session
9552
+ # A URL to the managed agent on the container that the SSM Session
9488
9553
  # Manager client uses to send commands and receive output from the
9489
9554
  # container.
9490
9555
  # @return [String]
@@ -9589,7 +9654,7 @@ module Aws::ECS
9589
9654
  # size_in_gi_b: 1, # required
9590
9655
  # },
9591
9656
  # },
9592
- # propagate_tags: "TASK_DEFINITION", # accepts TASK_DEFINITION, SERVICE
9657
+ # propagate_tags: "TASK_DEFINITION", # accepts TASK_DEFINITION, SERVICE, NONE
9593
9658
  # reference_id: "String",
9594
9659
  # started_by: "String",
9595
9660
  # tags: [
@@ -9614,9 +9679,9 @@ module Aws::ECS
9614
9679
  # @return [Array<String>]
9615
9680
  #
9616
9681
  # @!attribute [rw] enable_ecs_managed_tags
9617
- # Specifies whether to enable Amazon ECS managed tags for the task.
9618
- # For more information, see [Tagging Your Amazon ECS Resources][1] in
9619
- # the *Amazon Elastic Container Service Developer Guide*.
9682
+ # Specifies whether to use Amazon ECS managed tags for the task. For
9683
+ # more information, see [Tagging Your Amazon ECS Resources][1] in the
9684
+ # *Amazon Elastic Container Service Developer Guide*.
9620
9685
  #
9621
9686
  #
9622
9687
  #
@@ -10217,8 +10282,23 @@ module Aws::ECS
10217
10282
  #
10218
10283
  class TagResourceResponse < Aws::EmptyStructure; end
10219
10284
 
10220
- # The target container isn't properly configured with the execute
10221
- # command agent or the container is no longer active or running.
10285
+ # The execute command cannot run. This error can be caused by any of the
10286
+ # following configuration issues:
10287
+ #
10288
+ # * Incorrect IAM permissions
10289
+ #
10290
+ # * The SSM agent is not installed or is not running
10291
+ #
10292
+ # * There is an interface Amazon VPC endpoint for Amazon ECS, but there
10293
+ # is not one for for Systems Manager Session Manager
10294
+ #
10295
+ # For information about how to troubleshoot the issues, see
10296
+ # [Troubleshooting issues with ECS Exec][1] in the *Amazon Elastic
10297
+ # Container Service Developer Guide*.
10298
+ #
10299
+ #
10300
+ #
10301
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-exec.html
10222
10302
  #
10223
10303
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/TargetNotConnectedException AWS API Documentation
10224
10304
  #
@@ -10456,6 +10536,20 @@ module Aws::ECS
10456
10536
  # @!attribute [rw] stop_code
10457
10537
  # The stop code indicating why a task was stopped. The `stoppedReason`
10458
10538
  # might contain additional details.
10539
+ #
10540
+ # The following are valid values:
10541
+ #
10542
+ # * `TaskFailedToStart`
10543
+ #
10544
+ # * `EssentialContainerExited`
10545
+ #
10546
+ # * `UserInitiated`
10547
+ #
10548
+ # * `TerminationNotice`
10549
+ #
10550
+ # * `ServiceSchedulerInitiated`
10551
+ #
10552
+ # * `SpotInterruption`
10459
10553
  # @return [String]
10460
10554
  #
10461
10555
  # @!attribute [rw] stopped_at
@@ -10898,12 +10992,12 @@ module Aws::ECS
10898
10992
  #
10899
10993
  # Your Amazon ECS container instances require at least version 1.26.0
10900
10994
  # of the container agent and at least version 1.26.0-1 of the
10901
- # `ecs-init` package to enable a proxy configuration. If your
10902
- # container instances are launched from the Amazon ECS optimized AMI
10903
- # version `20190301` or later, they contain the required versions of
10904
- # the container agent and `ecs-init`. For more information, see
10905
- # [Amazon ECS-optimized Linux AMI][1] in the *Amazon Elastic Container
10906
- # Service Developer Guide*.
10995
+ # `ecs-init` package to use a proxy configuration. If your container
10996
+ # instances are launched from the Amazon ECS optimized AMI version
10997
+ # `20190301` or later, they contain the required versions of the
10998
+ # container agent and `ecs-init`. For more information, see [Amazon
10999
+ # ECS-optimized Linux AMI][1] in the *Amazon Elastic Container Service
11000
+ # Developer Guide*.
10907
11001
  #
10908
11002
  #
10909
11003
  #
@@ -11606,9 +11700,9 @@ module Aws::ECS
11606
11700
  #
11607
11701
  # @!attribute [rw] settings
11608
11702
  # The setting to use by default for a cluster. This parameter is used
11609
- # to enable CloudWatch Container Insights for a cluster. If this value
11610
- # is specified, it overrides the `containerInsights` value set with
11611
- # PutAccountSetting or PutAccountSettingDefault.
11703
+ # to turn on CloudWatch Container Insights for a cluster. If this
11704
+ # value is specified, it overrides the `containerInsights` value set
11705
+ # with PutAccountSetting or PutAccountSettingDefault.
11612
11706
  # @return [Array<Types::ClusterSetting>]
11613
11707
  #
11614
11708
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/UpdateClusterSettingsRequest AWS API Documentation
@@ -11775,7 +11869,7 @@ module Aws::ECS
11775
11869
  end
11776
11870
 
11777
11871
  # @!attribute [rw] task_set
11778
- # Details about the task set.
11872
+ # etails about the task set.
11779
11873
  # @return [Types::TaskSet]
11780
11874
  #
11781
11875
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/UpdateServicePrimaryTaskSetResponse AWS API Documentation
@@ -11832,6 +11926,24 @@ module Aws::ECS
11832
11926
  # force_new_deployment: false,
11833
11927
  # health_check_grace_period_seconds: 1,
11834
11928
  # enable_execute_command: false,
11929
+ # enable_ecs_managed_tags: false,
11930
+ # load_balancers: [
11931
+ # {
11932
+ # target_group_arn: "String",
11933
+ # load_balancer_name: "String",
11934
+ # container_name: "String",
11935
+ # container_port: 1,
11936
+ # },
11937
+ # ],
11938
+ # propagate_tags: "TASK_DEFINITION", # accepts TASK_DEFINITION, SERVICE, NONE
11939
+ # service_registries: [
11940
+ # {
11941
+ # registry_arn: "String",
11942
+ # port: 1,
11943
+ # container_name: "String",
11944
+ # container_port: 1,
11945
+ # },
11946
+ # ],
11835
11947
  # }
11836
11948
  #
11837
11949
  # @!attribute [rw] cluster
@@ -11969,6 +12081,62 @@ module Aws::ECS
11969
12081
  # action.
11970
12082
  # @return [Boolean]
11971
12083
  #
12084
+ # @!attribute [rw] enable_ecs_managed_tags
12085
+ # Determines whether to turn on Amazon ECS managed tags for the tasks
12086
+ # in the service. For more information, see [Tagging Your Amazon ECS
12087
+ # Resources][1] in the *Amazon Elastic Container Service Developer
12088
+ # Guide*.
12089
+ #
12090
+ # Only tasks launched after the update will reflect the update. To
12091
+ # update the tags on all tasks, set `forceNewDeployment` to `true`, so
12092
+ # that Amazon ECS starts new tasks with the updated tags.
12093
+ #
12094
+ #
12095
+ #
12096
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html
12097
+ # @return [Boolean]
12098
+ #
12099
+ # @!attribute [rw] load_balancers
12100
+ # A list of Elastic Load Balancing load balancer objects. It contains
12101
+ # the load balancer name, the container name, and the container port
12102
+ # to access from the load balancer. The container name is as it
12103
+ # appears in a container definition.
12104
+ #
12105
+ # When you add, update, or remove a load balancer configuration,
12106
+ # Amazon ECS starts new tasks with the updated Elastic Load Balancing
12107
+ # configuration, and then stops the old tasks when the new tasks are
12108
+ # running.
12109
+ #
12110
+ # You can remove existing `loadBalancers` by passing an empty list.
12111
+ # @return [Array<Types::LoadBalancer>]
12112
+ #
12113
+ # @!attribute [rw] propagate_tags
12114
+ # Determines whether to propagate the tags from the task definition or
12115
+ # the service to the task. If no value is specified, the tags aren't
12116
+ # propagated.
12117
+ #
12118
+ # Only tasks launched after the update will reflect the update. To
12119
+ # update the tags on all tasks, set `forceNewDeployment` to `true`, so
12120
+ # that Amazon ECS starts new tasks with the updated tags.
12121
+ # @return [String]
12122
+ #
12123
+ # @!attribute [rw] service_registries
12124
+ # The details for the service discovery registries to assign to this
12125
+ # service. For more information, see [Service Discovery][1].
12126
+ #
12127
+ # When you add, update, or remove the service registries
12128
+ # configuration, Amazon ECS starts new tasks with the updated service
12129
+ # registries configuration, and then stops the old tasks when the new
12130
+ # tasks are running.
12131
+ #
12132
+ # You can remove existing `serviceRegistries` by passing an empty
12133
+ # list.
12134
+ #
12135
+ #
12136
+ #
12137
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-discovery.html
12138
+ # @return [Array<Types::ServiceRegistry>]
12139
+ #
11972
12140
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/UpdateServiceRequest AWS API Documentation
11973
12141
  #
11974
12142
  class UpdateServiceRequest < Struct.new(
@@ -11984,7 +12152,11 @@ module Aws::ECS
11984
12152
  :platform_version,
11985
12153
  :force_new_deployment,
11986
12154
  :health_check_grace_period_seconds,
11987
- :enable_execute_command)
12155
+ :enable_execute_command,
12156
+ :enable_ecs_managed_tags,
12157
+ :load_balancers,
12158
+ :propagate_tags,
12159
+ :service_registries)
11988
12160
  SENSITIVE = []
11989
12161
  include Aws::Structure
11990
12162
  end
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.95.0'
52
+ GEM_VERSION = '1.98.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.95.0
4
+ version: 1.98.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-02-03 00:00:00.000000000 Z
11
+ date: 2022-03-15 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
19
19
  version: '3'
20
20
  - - ">="
21
21
  - !ruby/object:Gem::Version
22
- version: 3.126.0
22
+ version: 3.127.0
23
23
  type: :runtime
24
24
  prerelease: false
25
25
  version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
29
29
  version: '3'
30
30
  - - ">="
31
31
  - !ruby/object:Gem::Version
32
- version: 3.126.0
32
+ version: 3.127.0
33
33
  - !ruby/object:Gem::Dependency
34
34
  name: aws-sigv4
35
35
  requirement: !ruby/object:Gem::Requirement