aws-sdk-ecs 1.116.0 → 1.131.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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