aws-sdk-ecs 1.116.0 → 1.131.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.
@@ -28,6 +28,7 @@ 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
30
  require 'aws-sdk-core/plugins/checksum_algorithm.rb'
31
+ require 'aws-sdk-core/plugins/request_compression.rb'
31
32
  require 'aws-sdk-core/plugins/defaults_mode.rb'
32
33
  require 'aws-sdk-core/plugins/recursion_detection.rb'
33
34
  require 'aws-sdk-core/plugins/sign.rb'
@@ -77,6 +78,7 @@ module Aws::ECS
77
78
  add_plugin(Aws::Plugins::TransferEncoding)
78
79
  add_plugin(Aws::Plugins::HttpChecksum)
79
80
  add_plugin(Aws::Plugins::ChecksumAlgorithm)
81
+ add_plugin(Aws::Plugins::RequestCompression)
80
82
  add_plugin(Aws::Plugins::DefaultsMode)
81
83
  add_plugin(Aws::Plugins::RecursionDetection)
82
84
  add_plugin(Aws::Plugins::Sign)
@@ -190,6 +192,10 @@ module Aws::ECS
190
192
  # Set to true to disable SDK automatically adding host prefix
191
193
  # to default service endpoint when available.
192
194
  #
195
+ # @option options [Boolean] :disable_request_compression (false)
196
+ # When set to 'true' the request body will not be compressed
197
+ # for supported operations.
198
+ #
193
199
  # @option options [String] :endpoint
194
200
  # The client endpoint is normally constructed from the `:region`
195
201
  # option. You should only configure an `:endpoint` when connecting
@@ -210,6 +216,10 @@ module Aws::ECS
210
216
  # @option options [Boolean] :endpoint_discovery (false)
211
217
  # When set to `true`, endpoint discovery will be enabled for operations when available.
212
218
  #
219
+ # @option options [Boolean] :ignore_configured_endpoint_urls
220
+ # Setting to true disables use of endpoint URLs provided via environment
221
+ # variables and the shared configuration file.
222
+ #
213
223
  # @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
214
224
  # The log formatter.
215
225
  #
@@ -230,6 +240,11 @@ module Aws::ECS
230
240
  # Used when loading credentials from the shared credentials file
231
241
  # at HOME/.aws/credentials. When not specified, 'default' is used.
232
242
  #
243
+ # @option options [Integer] :request_min_compression_size_bytes (10240)
244
+ # The minimum size in bytes that triggers compression for request
245
+ # bodies. The value must be non-negative integer value between 0
246
+ # and 10485780 bytes inclusive.
247
+ #
233
248
  # @option options [Proc] :retry_backoff
234
249
  # A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay.
235
250
  # This option is only used in the `legacy` retry mode.
@@ -275,6 +290,11 @@ module Aws::ECS
275
290
  # in the future.
276
291
  #
277
292
  #
293
+ # @option options [String] :sdk_ua_app_id
294
+ # A unique and opaque application ID that is appended to the
295
+ # User-Agent header as app/<sdk_ua_app_id>. It should have a
296
+ # maximum length of 50.
297
+ #
278
298
  # @option options [String] :secret_access_key
279
299
  #
280
300
  # @option options [String] :session_token
@@ -946,7 +966,7 @@ module Aws::ECS
946
966
  #
947
967
  # @option params [Integer] :desired_count
948
968
  # The number of instantiations of the specified task definition to place
949
- # and keep running on your cluster.
969
+ # and keep running in your service.
950
970
  #
951
971
  # This is required if `schedulingStrategy` is `REPLICA` or isn't
952
972
  # specified. If `schedulingStrategy` is `DAEMON` then this isn't
@@ -1159,6 +1179,9 @@ module Aws::ECS
1159
1179
  # resources][1] in the *Amazon Elastic Container Service Developer
1160
1180
  # Guide*.
1161
1181
  #
1182
+ # When you use Amazon ECS managed tags, you need to set the
1183
+ # `propagateTags` request parameter.
1184
+ #
1162
1185
  #
1163
1186
  #
1164
1187
  # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html
@@ -1169,6 +1192,8 @@ module Aws::ECS
1169
1192
  # can only be propagated to the task during task creation. To add tags
1170
1193
  # to a task after task creation, use the [TagResource][1] API action.
1171
1194
  #
1195
+ # The default is `NONE`.
1196
+ #
1172
1197
  #
1173
1198
  #
1174
1199
  # [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_TagResource.html
@@ -1249,10 +1274,10 @@ module Aws::ECS
1249
1274
  # ],
1250
1275
  # pending_count: 0,
1251
1276
  # running_count: 0,
1252
- # service_arn: "arn:aws:ecs:us-east-1:012345678910:service/ecs-simple-service",
1277
+ # service_arn: "arn:aws:ecs:us-east-1:012345678910:service/default/ecs-simple-service",
1253
1278
  # service_name: "ecs-simple-service",
1254
1279
  # status: "ACTIVE",
1255
- # task_definition: "arn:aws:ecs:us-east-1:012345678910:task-definition/hello_world:6",
1280
+ # task_definition: "arn:aws:ecs:us-east-1:012345678910:task-definition/default/hello_world:6",
1256
1281
  # },
1257
1282
  # }
1258
1283
  #
@@ -1310,10 +1335,10 @@ module Aws::ECS
1310
1335
  # pending_count: 0,
1311
1336
  # role_arn: "arn:aws:iam::012345678910:role/ecsServiceRole",
1312
1337
  # running_count: 0,
1313
- # service_arn: "arn:aws:ecs:us-east-1:012345678910:service/ecs-simple-service-elb",
1338
+ # service_arn: "arn:aws:ecs:us-east-1:012345678910:service/default/ecs-simple-service-elb",
1314
1339
  # service_name: "ecs-simple-service-elb",
1315
1340
  # status: "ACTIVE",
1316
- # task_definition: "arn:aws:ecs:us-east-1:012345678910:task-definition/console-sample-app-static:6",
1341
+ # task_definition: "arn:aws:ecs:us-east-1:012345678910:task-definition/default/console-sample-app-static:6",
1317
1342
  # },
1318
1343
  # }
1319
1344
  #
@@ -1610,7 +1635,8 @@ module Aws::ECS
1610
1635
  # value.
1611
1636
  #
1612
1637
  # @option params [required, String] :task_definition
1613
- # The task definition for the tasks in the task set to use.
1638
+ # The task definition for the tasks in the task set to use. If a
1639
+ # revision isn't specified, the latest `ACTIVE` revision is used.
1614
1640
  #
1615
1641
  # @option params [Types::NetworkConfiguration] :network_configuration
1616
1642
  # An object representing the network configuration for a task set.
@@ -1887,13 +1913,13 @@ module Aws::ECS
1887
1913
  # @example Request syntax with placeholder values
1888
1914
  #
1889
1915
  # resp = client.delete_account_setting({
1890
- # name: "serviceLongArnFormat", # required, accepts serviceLongArnFormat, taskLongArnFormat, containerInstanceLongArnFormat, awsvpcTrunking, containerInsights, fargateFIPSMode, tagResourceAuthorization
1916
+ # name: "serviceLongArnFormat", # required, accepts serviceLongArnFormat, taskLongArnFormat, containerInstanceLongArnFormat, awsvpcTrunking, containerInsights, fargateFIPSMode, tagResourceAuthorization, fargateTaskRetirementWaitPeriod
1891
1917
  # principal_arn: "String",
1892
1918
  # })
1893
1919
  #
1894
1920
  # @example Response structure
1895
1921
  #
1896
- # resp.setting.name #=> String, one of "serviceLongArnFormat", "taskLongArnFormat", "containerInstanceLongArnFormat", "awsvpcTrunking", "containerInsights", "fargateFIPSMode", "tagResourceAuthorization"
1922
+ # resp.setting.name #=> String, one of "serviceLongArnFormat", "taskLongArnFormat", "containerInstanceLongArnFormat", "awsvpcTrunking", "containerInsights", "fargateFIPSMode", "tagResourceAuthorization", "fargateTaskRetirementWaitPeriod"
1897
1923
  # resp.setting.value #=> String
1898
1924
  # resp.setting.principal_arn #=> String
1899
1925
  #
@@ -2351,6 +2377,14 @@ module Aws::ECS
2351
2377
  # A task definition revision will stay in `DELETE_IN_PROGRESS` status
2352
2378
  # until all the associated tasks and services have been terminated.
2353
2379
  #
2380
+ # When you delete all `INACTIVE` task definition revisions, the task
2381
+ # definition name is not displayed in the console and not returned in
2382
+ # the API. If a task definition revisions are in the
2383
+ # `DELETE_IN_PROGRESS` state, the task definition name is displayed in
2384
+ # the console and returned in the API. The task definition name is
2385
+ # retained by Amazon ECS and the revision is incremented the next time
2386
+ # you create a task definition with that name.
2387
+ #
2354
2388
  #
2355
2389
  #
2356
2390
  # [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_DeregisterTaskDefinition.html
@@ -2481,6 +2515,8 @@ module Aws::ECS
2481
2515
  # resp.task_definitions[0].container_definitions[0].firelens_configuration.type #=> String, one of "fluentd", "fluentbit"
2482
2516
  # resp.task_definitions[0].container_definitions[0].firelens_configuration.options #=> Hash
2483
2517
  # resp.task_definitions[0].container_definitions[0].firelens_configuration.options["String"] #=> String
2518
+ # resp.task_definitions[0].container_definitions[0].credential_specs #=> Array
2519
+ # resp.task_definitions[0].container_definitions[0].credential_specs[0] #=> String
2484
2520
  # resp.task_definitions[0].family #=> String
2485
2521
  # resp.task_definitions[0].task_role_arn #=> String
2486
2522
  # resp.task_definitions[0].execution_role_arn #=> String
@@ -2934,6 +2970,8 @@ module Aws::ECS
2934
2970
  # resp.task_definition.container_definitions[0].firelens_configuration.type #=> String, one of "fluentd", "fluentbit"
2935
2971
  # resp.task_definition.container_definitions[0].firelens_configuration.options #=> Hash
2936
2972
  # resp.task_definition.container_definitions[0].firelens_configuration.options["String"] #=> String
2973
+ # resp.task_definition.container_definitions[0].credential_specs #=> Array
2974
+ # resp.task_definition.container_definitions[0].credential_specs[0] #=> String
2937
2975
  # resp.task_definition.family #=> String
2938
2976
  # resp.task_definition.task_role_arn #=> String
2939
2977
  # resp.task_definition.execution_role_arn #=> String
@@ -3248,7 +3286,7 @@ module Aws::ECS
3248
3286
  # container_instances: [
3249
3287
  # {
3250
3288
  # agent_connected: true,
3251
- # container_instance_arn: "arn:aws:ecs:us-east-1:012345678910:container-instance/f2756532-8f13-4d53-87c9-aed50dc94cd7",
3289
+ # container_instance_arn: "arn:aws:ecs:us-east-1:012345678910:container-instance/default/f2756532-8f13-4d53-87c9-aed50dc94cd7",
3252
3290
  # ec2_instance_id: "i-807f3249",
3253
3291
  # pending_tasks_count: 0,
3254
3292
  # registered_resources: [
@@ -3464,10 +3502,10 @@ module Aws::ECS
3464
3502
  # ],
3465
3503
  # pending_count: 0,
3466
3504
  # running_count: 0,
3467
- # service_arn: "arn:aws:ecs:us-east-1:012345678910:service/ecs-simple-service",
3505
+ # service_arn: "arn:aws:ecs:us-east-1:012345678910:service/default/ecs-simple-service",
3468
3506
  # service_name: "ecs-simple-service",
3469
3507
  # status: "ACTIVE",
3470
- # task_definition: "arn:aws:ecs:us-east-1:012345678910:task-definition/hello_world:6",
3508
+ # task_definition: "arn:aws:ecs:us-east-1:012345678910:task-definition/default/hello_world:6",
3471
3509
  # },
3472
3510
  # ],
3473
3511
  # }
@@ -3850,6 +3888,8 @@ module Aws::ECS
3850
3888
  # resp.task_definition.container_definitions[0].firelens_configuration.type #=> String, one of "fluentd", "fluentbit"
3851
3889
  # resp.task_definition.container_definitions[0].firelens_configuration.options #=> Hash
3852
3890
  # resp.task_definition.container_definitions[0].firelens_configuration.options["String"] #=> String
3891
+ # resp.task_definition.container_definitions[0].credential_specs #=> Array
3892
+ # resp.task_definition.container_definitions[0].credential_specs[0] #=> String
3853
3893
  # resp.task_definition.family #=> String
3854
3894
  # resp.task_definition.task_role_arn #=> String
3855
3895
  # resp.task_definition.execution_role_arn #=> String
@@ -4022,6 +4062,11 @@ module Aws::ECS
4022
4062
  # Currently, stopped tasks appear in the returned results for at least
4023
4063
  # one hour.
4024
4064
  #
4065
+ # If you have tasks with tags, and then delete the cluster, the tagged
4066
+ # tasks are returned in the response. If you create a new cluster with
4067
+ # the same name as the deleted cluster, the tagged tasks are not
4068
+ # included in the response.
4069
+ #
4025
4070
  # @option params [String] :cluster
4026
4071
  # The short name or full Amazon Resource Name (ARN) of the cluster that
4027
4072
  # hosts the task or tasks to describe. If you do not specify a cluster,
@@ -4060,7 +4105,7 @@ module Aws::ECS
4060
4105
  # tasks: [
4061
4106
  # {
4062
4107
  # cluster_arn: "arn:aws:ecs:<region>:<aws_account_id>:cluster/default",
4063
- # container_instance_arn: "arn:aws:ecs:<region>:<aws_account_id>:container-instance/18f9eda5-27d7-4c19-b133-45adc516e8fb",
4108
+ # container_instance_arn: "arn:aws:ecs:<region>:<aws_account_id>:container-instance/default/18f9eda5-27d7-4c19-b133-45adc516e8fb",
4064
4109
  # containers: [
4065
4110
  # {
4066
4111
  # name: "ecs-demo",
@@ -4073,7 +4118,7 @@ module Aws::ECS
4073
4118
  # host_port: 80,
4074
4119
  # },
4075
4120
  # ],
4076
- # task_arn: "arn:aws:ecs:<region>:<aws_account_id>:task/c5cba4eb-5dad-405e-96db-71ef8eefe6a8",
4121
+ # task_arn: "arn:aws:ecs:<region>:<aws_account_id>:task/default/c5cba4eb-5dad-405e-96db-71ef8eefe6a8",
4077
4122
  # },
4078
4123
  # ],
4079
4124
  # desired_status: "RUNNING",
@@ -4086,7 +4131,7 @@ module Aws::ECS
4086
4131
  # ],
4087
4132
  # },
4088
4133
  # started_by: "ecs-svc/9223370608528463088",
4089
- # task_arn: "arn:aws:ecs:<region>:<aws_account_id>:task/c5cba4eb-5dad-405e-96db-71ef8eefe6a8",
4134
+ # task_arn: "arn:aws:ecs:<region>:<aws_account_id>:task/default/c5cba4eb-5dad-405e-96db-71ef8eefe6a8",
4090
4135
  # task_definition_arn: "arn:aws:ecs:<region>:<aws_account_id>:task-definition/amazon-ecs-sample:1",
4091
4136
  # },
4092
4137
  # ],
@@ -4383,7 +4428,7 @@ module Aws::ECS
4383
4428
  # {
4384
4429
  # expiration_date: Time.parse("2022-11-02T06:56:32.553Z"),
4385
4430
  # protection_enabled: true,
4386
- # task_arn: "arn:aws:ecs:us-west-2:012345678910:task/b8b1cf532d0e46ba8d44a40d1de16772",
4431
+ # task_arn: "arn:aws:ecs:us-west-2:012345678910:task/default/b8b1cf532d0e46ba8d44a40d1de16772",
4387
4432
  # },
4388
4433
  # ],
4389
4434
  # }
@@ -4534,7 +4579,7 @@ module Aws::ECS
4534
4579
  # @example Request syntax with placeholder values
4535
4580
  #
4536
4581
  # resp = client.list_account_settings({
4537
- # name: "serviceLongArnFormat", # accepts serviceLongArnFormat, taskLongArnFormat, containerInstanceLongArnFormat, awsvpcTrunking, containerInsights, fargateFIPSMode, tagResourceAuthorization
4582
+ # name: "serviceLongArnFormat", # accepts serviceLongArnFormat, taskLongArnFormat, containerInstanceLongArnFormat, awsvpcTrunking, containerInsights, fargateFIPSMode, tagResourceAuthorization, fargateTaskRetirementWaitPeriod
4538
4583
  # value: "String",
4539
4584
  # principal_arn: "String",
4540
4585
  # effective_settings: false,
@@ -4545,7 +4590,7 @@ module Aws::ECS
4545
4590
  # @example Response structure
4546
4591
  #
4547
4592
  # resp.settings #=> Array
4548
- # resp.settings[0].name #=> String, one of "serviceLongArnFormat", "taskLongArnFormat", "containerInstanceLongArnFormat", "awsvpcTrunking", "containerInsights", "fargateFIPSMode", "tagResourceAuthorization"
4593
+ # resp.settings[0].name #=> String, one of "serviceLongArnFormat", "taskLongArnFormat", "containerInstanceLongArnFormat", "awsvpcTrunking", "containerInsights", "fargateFIPSMode", "tagResourceAuthorization", "fargateTaskRetirementWaitPeriod"
4549
4594
  # resp.settings[0].value #=> String
4550
4595
  # resp.settings[0].principal_arn #=> String
4551
4596
  # resp.next_token #=> String
@@ -4784,8 +4829,8 @@ module Aws::ECS
4784
4829
  # resp.to_h outputs the following:
4785
4830
  # {
4786
4831
  # container_instance_arns: [
4787
- # "arn:aws:ecs:us-east-1:<aws_account_id>:container-instance/f6bbb147-5370-4ace-8c73-c7181ded911f",
4788
- # "arn:aws:ecs:us-east-1:<aws_account_id>:container-instance/ffe3d344-77e2-476c-a4d0-bf560ad50acb",
4832
+ # "arn:aws:ecs:us-east-1:<aws_account_id>:container-instance/default/f6bbb147-5370-4ace-8c73-c7181ded911f",
4833
+ # "arn:aws:ecs:us-east-1:<aws_account_id>:container-instance/default/ffe3d344-77e2-476c-a4d0-bf560ad50acb",
4789
4834
  # ],
4790
4835
  # }
4791
4836
  #
@@ -4869,7 +4914,7 @@ module Aws::ECS
4869
4914
  # resp.to_h outputs the following:
4870
4915
  # {
4871
4916
  # service_arns: [
4872
- # "arn:aws:ecs:us-east-1:012345678910:service/my-http-service",
4917
+ # "arn:aws:ecs:us-east-1:012345678910:service/default/my-http-service",
4873
4918
  # ],
4874
4919
  # }
4875
4920
  #
@@ -5264,8 +5309,6 @@ module Aws::ECS
5264
5309
  # started the task, or by the desired status of the task.
5265
5310
  #
5266
5311
  # Recently stopped tasks might appear in the returned results.
5267
- # Currently, stopped tasks appear in the returned results for at least
5268
- # one hour.
5269
5312
  #
5270
5313
  # @option params [String] :cluster
5271
5314
  # The short name or full Amazon Resource Name (ARN) of the cluster to
@@ -5355,8 +5398,8 @@ module Aws::ECS
5355
5398
  # resp.to_h outputs the following:
5356
5399
  # {
5357
5400
  # task_arns: [
5358
- # "arn:aws:ecs:us-east-1:012345678910:task/0cc43cdb-3bee-4407-9c26-c0e6ea5bee84",
5359
- # "arn:aws:ecs:us-east-1:012345678910:task/6b809ef6-c67e-4467-921f-ee261c15a0a1",
5401
+ # "arn:aws:ecs:us-east-1:012345678910:task/default/0cc43cdb-3bee-4407-9c26-c0e6ea5bee84",
5402
+ # "arn:aws:ecs:us-east-1:012345678910:task/default/6b809ef6-c67e-4467-921f-ee261c15a0a1",
5360
5403
  # ],
5361
5404
  # }
5362
5405
  #
@@ -5373,7 +5416,7 @@ module Aws::ECS
5373
5416
  # resp.to_h outputs the following:
5374
5417
  # {
5375
5418
  # task_arns: [
5376
- # "arn:aws:ecs:us-east-1:012345678910:task/0cc43cdb-3bee-4407-9c26-c0e6ea5bee84",
5419
+ # "arn:aws:ecs:us-east-1:012345678910:task/default/0cc43cdb-3bee-4407-9c26-c0e6ea5bee84",
5377
5420
  # ],
5378
5421
  # }
5379
5422
  #
@@ -5414,25 +5457,24 @@ module Aws::ECS
5414
5457
  # account settings. For more information, see [Account Settings][1] in
5415
5458
  # the *Amazon Elastic Container Service Developer Guide*.
5416
5459
  #
5417
- # When `serviceLongArnFormat`, `taskLongArnFormat`, or
5418
- # `containerInstanceLongArnFormat` are specified, the Amazon Resource
5419
- # Name (ARN) and resource ID format of the resource type for a specified
5420
- # user, role, or the root user for an account is affected. The opt-in
5421
- # and opt-out account setting must be set for each Amazon ECS resource
5422
- # separately. The ARN and resource ID format of a resource is defined by
5423
- # the opt-in status of the user or role that created the resource. You
5424
- # must turn on this setting to use Amazon ECS features such as resource
5425
- # tagging.
5426
- #
5427
- # When `awsvpcTrunking` is specified, the elastic network interface
5428
- # (ENI) limit for any new container instances that support the feature
5429
- # is changed. If `awsvpcTrunking` is turned on, any new container
5430
- # instances that support the feature are launched have the increased ENI
5431
- # limits available to them. For more information, see [Elastic Network
5460
+ # When you specify `serviceLongArnFormat`, `taskLongArnFormat`, or
5461
+ # `containerInstanceLongArnFormat`, the Amazon Resource Name (ARN) and
5462
+ # resource ID format of the resource type for a specified user, role, or
5463
+ # the root user for an account is affected. The opt-in and opt-out
5464
+ # account setting must be set for each Amazon ECS resource separately.
5465
+ # The ARN and resource ID format of a resource is defined by the opt-in
5466
+ # status of the user or role that created the resource. You must turn on
5467
+ # this setting to use Amazon ECS features such as resource tagging.
5468
+ #
5469
+ # When you specify `awsvpcTrunking`, the elastic network interface (ENI)
5470
+ # limit for any new container instances that support the feature is
5471
+ # changed. If `awsvpcTrunking` is turned on, any new container instances
5472
+ # that support the feature are launched have the increased ENI limits
5473
+ # available to them. For more information, see [Elastic Network
5432
5474
  # Interface Trunking][2] in the *Amazon Elastic Container Service
5433
5475
  # Developer Guide*.
5434
5476
  #
5435
- # When `containerInsights` is specified, the default setting indicating
5477
+ # When you specify `containerInsights`, the default setting indicating
5436
5478
  # whether Amazon Web Services CloudWatch Container Insights is turned on
5437
5479
  # for your clusters is changed. If `containerInsights` is turned on, any
5438
5480
  # new clusters that are created will have Container Insights turned on
@@ -5449,29 +5491,39 @@ module Aws::ECS
5449
5491
  # action. For more information, see [Grant permission to tag resources
5450
5492
  # on creation][4] in the *Amazon ECS Developer Guide*.
5451
5493
  #
5494
+ # When Amazon Web Services determines that a security or infrastructure
5495
+ # update is needed for an Amazon ECS task hosted on Fargate, the tasks
5496
+ # need to be stopped and new tasks launched to replace them. Use
5497
+ # `fargateTaskRetirementWaitPeriod` to configure the wait time to retire
5498
+ # a Fargate task. For information about the Fargate tasks maintenance,
5499
+ # see [Amazon Web Services Fargate task maintenance][5] in the *Amazon
5500
+ # ECS Developer Guide*.
5501
+ #
5452
5502
  #
5453
5503
  #
5454
5504
  # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-account-settings.html
5455
5505
  # [2]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/container-instance-eni.html
5456
5506
  # [3]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/cloudwatch-container-insights.html
5457
5507
  # [4]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/supported-iam-actions-tagging.html
5508
+ # [5]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-maintenance.html
5458
5509
  #
5459
5510
  # @option params [required, String] :name
5460
5511
  # The Amazon ECS resource name for which to modify the account setting.
5461
- # If `serviceLongArnFormat` is specified, the ARN for your Amazon ECS
5462
- # services is affected. If `taskLongArnFormat` is specified, the ARN and
5463
- # resource ID for your Amazon ECS tasks is affected. If
5464
- # `containerInstanceLongArnFormat` is specified, the ARN and resource ID
5465
- # for your Amazon ECS container instances is affected. If
5466
- # `awsvpcTrunking` is specified, the elastic network interface (ENI)
5467
- # limit for your Amazon ECS container instances is affected. If
5468
- # `containerInsights` is specified, the default setting for Amazon Web
5469
- # Services CloudWatch Container Insights for your clusters is affected.
5470
- # If `fargateFIPSMode` is specified, Fargate FIPS 140 compliance is
5471
- # affected. If `tagResourceAuthorization` is specified, the opt-in
5472
- # option for tagging resources on creation is affected. For information
5473
- # about the opt-in timeline, see [Tagging authorization timeline][1] in
5474
- # the *Amazon ECS Developer Guide*.
5512
+ # If you specify `serviceLongArnFormat`, the ARN for your Amazon ECS
5513
+ # services is affected. If you specify `taskLongArnFormat`, the ARN and
5514
+ # resource ID for your Amazon ECS tasks is affected. If you specify
5515
+ # `containerInstanceLongArnFormat`, the ARN and resource ID for your
5516
+ # Amazon ECS container instances is affected. If you specify
5517
+ # `awsvpcTrunking`, the elastic network interface (ENI) limit for your
5518
+ # Amazon ECS container instances is affected. If you specify
5519
+ # `containerInsights`, the default setting for Amazon Web Services
5520
+ # CloudWatch Container Insights for your clusters is affected. If you
5521
+ # specify `fargateFIPSMode`, Fargate FIPS 140 compliance is affected. If
5522
+ # you specify `tagResourceAuthorization`, the opt-in option for tagging
5523
+ # resources on creation is affected. For information about the opt-in
5524
+ # timeline, see [Tagging authorization timeline][1] in the *Amazon ECS
5525
+ # Developer Guide*. If you specify `fargateTaskRetirementWaitPeriod`,
5526
+ # the wait time to retire a Fargate task is affected.
5475
5527
  #
5476
5528
  #
5477
5529
  #
@@ -5479,7 +5531,19 @@ module Aws::ECS
5479
5531
  #
5480
5532
  # @option params [required, String] :value
5481
5533
  # The account setting value for the specified principal ARN. Accepted
5482
- # values are `enabled` and `disabled`.
5534
+ # values are `enabled`, `disabled`, `on`, and `off`.
5535
+ #
5536
+ # When you specify `fargateTaskRetirementWaitPeriod` for the `name`, the
5537
+ # following are the valid values:
5538
+ #
5539
+ # * `0` - Amazon Web Services sends the notification, and immediately
5540
+ # retires the affected tasks.
5541
+ #
5542
+ # * `7` - Amazon Web Services sends the notification, and waits 7
5543
+ # calendar days to retire the tasks.
5544
+ #
5545
+ # * `14` - Amazon Web Services sends the notification, and waits 14
5546
+ # calendar days to retire the tasks.
5483
5547
  #
5484
5548
  # @option params [String] :principal_arn
5485
5549
  # The ARN of the principal, which can be a user, role, or the root user.
@@ -5488,7 +5552,10 @@ module Aws::ECS
5488
5552
  # explicitly overrides these settings. If this field is omitted, the
5489
5553
  # setting is changed only for the authenticated user.
5490
5554
  #
5491
- # <note markdown="1"> Federated users assume the account setting of the root user and can't
5555
+ # <note markdown="1"> You must use the root user when you set the Fargate wait time
5556
+ # (`fargateTaskRetirementWaitPeriod`).
5557
+ #
5558
+ # Federated users assume the account setting of the root user and can't
5492
5559
  # have explicit account settings set for them.
5493
5560
  #
5494
5561
  # </note>
@@ -5542,14 +5609,14 @@ module Aws::ECS
5542
5609
  # @example Request syntax with placeholder values
5543
5610
  #
5544
5611
  # resp = client.put_account_setting({
5545
- # name: "serviceLongArnFormat", # required, accepts serviceLongArnFormat, taskLongArnFormat, containerInstanceLongArnFormat, awsvpcTrunking, containerInsights, fargateFIPSMode, tagResourceAuthorization
5612
+ # name: "serviceLongArnFormat", # required, accepts serviceLongArnFormat, taskLongArnFormat, containerInstanceLongArnFormat, awsvpcTrunking, containerInsights, fargateFIPSMode, tagResourceAuthorization, fargateTaskRetirementWaitPeriod
5546
5613
  # value: "String", # required
5547
5614
  # principal_arn: "String",
5548
5615
  # })
5549
5616
  #
5550
5617
  # @example Response structure
5551
5618
  #
5552
- # resp.setting.name #=> String, one of "serviceLongArnFormat", "taskLongArnFormat", "containerInstanceLongArnFormat", "awsvpcTrunking", "containerInsights", "fargateFIPSMode", "tagResourceAuthorization"
5619
+ # resp.setting.name #=> String, one of "serviceLongArnFormat", "taskLongArnFormat", "containerInstanceLongArnFormat", "awsvpcTrunking", "containerInsights", "fargateFIPSMode", "tagResourceAuthorization", "fargateTaskRetirementWaitPeriod"
5553
5620
  # resp.setting.value #=> String
5554
5621
  # resp.setting.principal_arn #=> String
5555
5622
  #
@@ -5567,19 +5634,21 @@ module Aws::ECS
5567
5634
  # set on a per-Region basis.
5568
5635
  #
5569
5636
  # @option params [required, String] :name
5570
- # The resource name for which to modify the account setting. If
5571
- # `serviceLongArnFormat` is specified, the ARN for your Amazon ECS
5572
- # services is affected. If `taskLongArnFormat` is specified, the ARN and
5573
- # resource ID for your Amazon ECS tasks is affected. If
5574
- # `containerInstanceLongArnFormat` is specified, the ARN and resource ID
5575
- # for your Amazon ECS container instances is affected. If
5576
- # `awsvpcTrunking` is specified, the ENI limit for your Amazon ECS
5577
- # container instances is affected. If `containerInsights` is specified,
5578
- # the default setting for Amazon Web Services CloudWatch Container
5579
- # Insights for your clusters is affected. If `tagResourceAuthorization`
5580
- # is specified, the opt-in option for tagging resources on creation is
5581
- # affected. For information about the opt-in timeline, see [Tagging
5582
- # authorization timeline][1] in the *Amazon ECS Developer Guide*.
5637
+ # The resource name for which to modify the account setting. If you
5638
+ # specify `serviceLongArnFormat`, the ARN for your Amazon ECS services
5639
+ # is affected. If you specify `taskLongArnFormat`, the ARN and resource
5640
+ # ID for your Amazon ECS tasks is affected. If you specify
5641
+ # `containerInstanceLongArnFormat`, the ARN and resource ID for your
5642
+ # Amazon ECS container instances is affected. If you specify
5643
+ # `awsvpcTrunking`, the ENI limit for your Amazon ECS container
5644
+ # instances is affected. If you specify `containerInsights`, the default
5645
+ # setting for Amazon Web Services CloudWatch Container Insights for your
5646
+ # clusters is affected. If you specify `tagResourceAuthorization`, the
5647
+ # opt-in option for tagging resources on creation is affected. For
5648
+ # information about the opt-in timeline, see [Tagging authorization
5649
+ # timeline][1] in the *Amazon ECS Developer Guide*. If you specify
5650
+ # `fargateTaskRetirementWaitPeriod`, the default wait time to retire a
5651
+ # Fargate task due to required maintenance is affected.
5583
5652
  #
5584
5653
  # When you specify `fargateFIPSMode` for the `name` and `enabled` for
5585
5654
  # the `value`, Fargate uses FIPS-140 compliant cryptographic algorithms
@@ -5588,14 +5657,35 @@ module Aws::ECS
5588
5657
  # Processing Standard (FIPS) 140-2 compliance][2] in the *Amazon Elastic
5589
5658
  # Container Service Developer Guide*.
5590
5659
  #
5660
+ # When Amazon Web Services determines that a security or infrastructure
5661
+ # update is needed for an Amazon ECS task hosted on Fargate, the tasks
5662
+ # need to be stopped and new tasks launched to replace them. Use
5663
+ # `fargateTaskRetirementWaitPeriod` to set the wait time to retire a
5664
+ # Fargate task to the default. For information about the Fargate tasks
5665
+ # maintenance, see [Amazon Web Services Fargate task maintenance][3] in
5666
+ # the *Amazon ECS Developer Guide*.
5667
+ #
5591
5668
  #
5592
5669
  #
5593
5670
  # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-account-settings.html#tag-resources
5594
5671
  # [2]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-fips-compliance.html
5672
+ # [3]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-maintenance.html
5595
5673
  #
5596
5674
  # @option params [required, String] :value
5597
5675
  # The account setting value for the specified principal ARN. Accepted
5598
- # values are `enabled` and `disabled`.
5676
+ # values are `enabled`, `disabled`, `on`, and `off`.
5677
+ #
5678
+ # When you specify `fargateTaskRetirementWaitPeriod` for the `name`, the
5679
+ # following are the valid values:
5680
+ #
5681
+ # * `0` - Amazon Web Services sends the notification, and immediately
5682
+ # retires the affected tasks.
5683
+ #
5684
+ # * `7` - Amazon Web Services sends the notification, and waits 7
5685
+ # calendar days to retire the tasks.
5686
+ #
5687
+ # * `14` - Amazon Web Services sends the notification, and waits 14
5688
+ # calendar days to retire the tasks.
5599
5689
  #
5600
5690
  # @return [Types::PutAccountSettingDefaultResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5601
5691
  #
@@ -5625,13 +5715,13 @@ module Aws::ECS
5625
5715
  # @example Request syntax with placeholder values
5626
5716
  #
5627
5717
  # resp = client.put_account_setting_default({
5628
- # name: "serviceLongArnFormat", # required, accepts serviceLongArnFormat, taskLongArnFormat, containerInstanceLongArnFormat, awsvpcTrunking, containerInsights, fargateFIPSMode, tagResourceAuthorization
5718
+ # name: "serviceLongArnFormat", # required, accepts serviceLongArnFormat, taskLongArnFormat, containerInstanceLongArnFormat, awsvpcTrunking, containerInsights, fargateFIPSMode, tagResourceAuthorization, fargateTaskRetirementWaitPeriod
5629
5719
  # value: "String", # required
5630
5720
  # })
5631
5721
  #
5632
5722
  # @example Response structure
5633
5723
  #
5634
- # resp.setting.name #=> String, one of "serviceLongArnFormat", "taskLongArnFormat", "containerInstanceLongArnFormat", "awsvpcTrunking", "containerInsights", "fargateFIPSMode", "tagResourceAuthorization"
5724
+ # resp.setting.name #=> String, one of "serviceLongArnFormat", "taskLongArnFormat", "containerInstanceLongArnFormat", "awsvpcTrunking", "containerInsights", "fargateFIPSMode", "tagResourceAuthorization", "fargateTaskRetirementWaitPeriod"
5635
5725
  # resp.setting.value #=> String
5636
5726
  # resp.setting.principal_arn #=> String
5637
5727
  #
@@ -6263,20 +6353,33 @@ module Aws::ECS
6263
6353
  #
6264
6354
  # @option params [String] :pid_mode
6265
6355
  # The process namespace to use for the containers in the task. The valid
6266
- # values are `host` or `task`. If `host` is specified, then all
6267
- # containers within the tasks that specified the `host` PID mode on the
6268
- # same container instance share the same process namespace with the host
6269
- # Amazon EC2 instance. If `task` is specified, all containers within the
6270
- # specified task share the same process namespace. If no value is
6271
- # specified, the default is a private namespace. For more information,
6272
- # see [PID settings][1] in the *Docker run reference*.
6273
- #
6274
- # If the `host` PID mode is used, be aware that there is a heightened
6275
- # risk of undesired process namespace expose. For more information, see
6356
+ # values are `host` or `task`. On Fargate for Linux containers, the only
6357
+ # valid value is `task`. For example, monitoring sidecars might need
6358
+ # `pidMode` to access information about other containers running in the
6359
+ # same task.
6360
+ #
6361
+ # If `host` is specified, all containers within the tasks that specified
6362
+ # the `host` PID mode on the same container instance share the same
6363
+ # process namespace with the host Amazon EC2 instance.
6364
+ #
6365
+ # If `task` is specified, all containers within the specified task share
6366
+ # the same process namespace.
6367
+ #
6368
+ # If no value is specified, the default is a private namespace for each
6369
+ # container. For more information, see [PID settings][1] in the *Docker
6370
+ # run reference*.
6371
+ #
6372
+ # If the `host` PID mode is used, there's a heightened risk of
6373
+ # undesired process namespace exposure. For more information, see
6276
6374
  # [Docker security][2].
6277
6375
  #
6278
- # <note markdown="1"> This parameter is not supported for Windows containers or tasks run on
6279
- # Fargate.
6376
+ # <note markdown="1"> This parameter is not supported for Windows containers.
6377
+ #
6378
+ # </note>
6379
+ #
6380
+ # <note markdown="1"> This parameter is only supported for tasks that are hosted on Fargate
6381
+ # if the tasks are using platform version `1.4.0` or later (Linux). This
6382
+ # isn't supported for Windows containers on Fargate.
6280
6383
  #
6281
6384
  # </note>
6282
6385
  #
@@ -6592,6 +6695,7 @@ module Aws::ECS
6592
6695
  # "String" => "String",
6593
6696
  # },
6594
6697
  # },
6698
+ # credential_specs: ["String"],
6595
6699
  # },
6596
6700
  # ],
6597
6701
  # volumes: [
@@ -6780,6 +6884,8 @@ module Aws::ECS
6780
6884
  # resp.task_definition.container_definitions[0].firelens_configuration.type #=> String, one of "fluentd", "fluentbit"
6781
6885
  # resp.task_definition.container_definitions[0].firelens_configuration.options #=> Hash
6782
6886
  # resp.task_definition.container_definitions[0].firelens_configuration.options["String"] #=> String
6887
+ # resp.task_definition.container_definitions[0].credential_specs #=> Array
6888
+ # resp.task_definition.container_definitions[0].credential_specs[0] #=> String
6783
6889
  # resp.task_definition.family #=> String
6784
6890
  # resp.task_definition.task_role_arn #=> String
6785
6891
  # resp.task_definition.execution_role_arn #=> String
@@ -7125,13 +7231,13 @@ module Aws::ECS
7125
7231
  # {
7126
7232
  # tasks: [
7127
7233
  # {
7128
- # container_instance_arn: "arn:aws:ecs:us-east-1:<aws_account_id>:container-instance/ffe3d344-77e2-476c-a4d0-bf560ad50acb",
7234
+ # container_instance_arn: "arn:aws:ecs:us-east-1:<aws_account_id>:container-instance/default/ffe3d344-77e2-476c-a4d0-bf560ad50acb",
7129
7235
  # containers: [
7130
7236
  # {
7131
7237
  # name: "sleep",
7132
- # container_arn: "arn:aws:ecs:us-east-1:<aws_account_id>:container/58591c8e-be29-4ddf-95aa-ee459d4c59fd",
7238
+ # container_arn: "arn:aws:ecs:us-east-1:<aws_account_id>:container/default/58591c8e-be29-4ddf-95aa-ee459d4c59fd",
7133
7239
  # last_status: "PENDING",
7134
- # task_arn: "arn:aws:ecs:us-east-1:<aws_account_id>:task/a9f21ea7-c9f5-44b1-b8e6-b31f50ed33c0",
7240
+ # task_arn: "arn:aws:ecs:us-east-1:<aws_account_id>:task/default/a9f21ea7-c9f5-44b1-b8e6-b31f50ed33c0",
7135
7241
  # },
7136
7242
  # ],
7137
7243
  # desired_status: "RUNNING",
@@ -7143,7 +7249,7 @@ module Aws::ECS
7143
7249
  # },
7144
7250
  # ],
7145
7251
  # },
7146
- # task_arn: "arn:aws:ecs:us-east-1:<aws_account_id>:task/a9f21ea7-c9f5-44b1-b8e6-b31f50ed33c0",
7252
+ # task_arn: "arn:aws:ecs:us-east-1:<aws_account_id>:task/default/a9f21ea7-c9f5-44b1-b8e6-b31f50ed33c0",
7147
7253
  # task_definition_arn: "arn:aws:ecs:us-east-1:<aws_account_id>:task-definition/sleep360:1",
7148
7254
  # },
7149
7255
  # ],
@@ -8823,23 +8929,21 @@ module Aws::ECS
8823
8929
  # with the largest number of running tasks for this service.
8824
8930
  #
8825
8931
  # <note markdown="1"> You must have a service-linked role when you update any of the
8826
- # following service properties. If you specified a custom role when you
8827
- # created the service, Amazon ECS automatically replaces the
8828
- # [roleARN][2] associated with the service with the ARN of your
8829
- # service-linked role. For more information, see [Service-linked
8830
- # roles][3] in the *Amazon Elastic Container Service Developer Guide*.
8932
+ # following service properties:
8831
8933
  #
8832
- # * `loadBalancers,`
8934
+ # * `loadBalancers`,
8833
8935
  #
8834
8936
  # * `serviceRegistries`
8835
8937
  #
8938
+ # For more information about the role see the `CreateService` request
8939
+ # parameter [ `role` ][2].
8940
+ #
8836
8941
  # </note>
8837
8942
  #
8838
8943
  #
8839
8944
  #
8840
8945
  # [1]: https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_CreateDeployment.html
8841
- # [2]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_Service.html#ECS-Type-Service-roleArn
8842
- # [3]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using-service-linked-roles.html
8946
+ # [2]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html#ECS-CreateService-request-role
8843
8947
  #
8844
8948
  # @option params [String] :cluster
8845
8949
  # The short name or full Amazon Resource Name (ARN) of the cluster that
@@ -9512,7 +9616,7 @@ module Aws::ECS
9512
9616
  # {
9513
9617
  # expiration_date: Time.parse("2022-11-02T06:56:32.553Z"),
9514
9618
  # protection_enabled: true,
9515
- # task_arn: "arn:aws:ecs:us-west-2:012345678910:task/b8b1cf532d0e46ba8d44a40d1de16772",
9619
+ # task_arn: "arn:aws:ecs:us-west-2:012345678910:task/default/b8b1cf532d0e46ba8d44a40d1de16772",
9516
9620
  # },
9517
9621
  # ],
9518
9622
  # }
@@ -9538,7 +9642,7 @@ module Aws::ECS
9538
9642
  # {
9539
9643
  # expiration_date: Time.parse("2022-11-02T06:56:32.553Z"),
9540
9644
  # protection_enabled: true,
9541
- # task_arn: "arn:aws:ecs:us-west-2:012345678910:task/b8b1cf532d0e46ba8d44a40d1de16772",
9645
+ # task_arn: "arn:aws:ecs:us-west-2:012345678910:task/default/b8b1cf532d0e46ba8d44a40d1de16772",
9542
9646
  # },
9543
9647
  # ],
9544
9648
  # }
@@ -9562,7 +9666,7 @@ module Aws::ECS
9562
9666
  # protected_tasks: [
9563
9667
  # {
9564
9668
  # protection_enabled: false,
9565
- # task_arn: "arn:aws:ecs:us-west-2:012345678910:task/b8b1cf532d0e46ba8d44a40d1de16772",
9669
+ # task_arn: "arn:aws:ecs:us-west-2:012345678910:task/default/b8b1cf532d0e46ba8d44a40d1de16772",
9566
9670
  # },
9567
9671
  # ],
9568
9672
  # }
@@ -9704,7 +9808,7 @@ module Aws::ECS
9704
9808
  params: params,
9705
9809
  config: config)
9706
9810
  context[:gem_name] = 'aws-sdk-ecs'
9707
- context[:gem_version] = '1.116.0'
9811
+ context[:gem_version] = '1.131.0'
9708
9812
  Seahorse::Client::Request.new(handlers, context)
9709
9813
  end
9710
9814