aws-sdk-ecs 1.187.0 → 1.196.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.
@@ -477,19 +477,6 @@ module Aws::ECS
477
477
  # have permissions to use the action or resource. Or, it might be
478
478
  # specifying an identifier that isn't valid.
479
479
  #
480
- # The following list includes additional causes for the error:
481
- #
482
- # * The `RunTask` could not be processed because you use managed scaling
483
- # and there is a capacity error because the quota of tasks in the
484
- # `PROVISIONING` per cluster has been reached. For information about
485
- # the service quotas, see [Amazon ECS service quotas][1].
486
- #
487
- # ^
488
- #
489
- #
490
- #
491
- # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-quotas.html
492
- #
493
480
  # @!attribute [rw] message
494
481
  # Message that describes the cause of the exception.
495
482
  # @return [String]
@@ -523,7 +510,8 @@ module Aws::ECS
523
510
  # @return [String]
524
511
  #
525
512
  # @!attribute [rw] configuration
526
- # The execute command configuration for the cluster.
513
+ # The execute command and managed storage configuration for the
514
+ # cluster.
527
515
  # @return [Types::ClusterConfiguration]
528
516
  #
529
517
  # @!attribute [rw] status
@@ -983,7 +971,7 @@ module Aws::ECS
983
971
  # @return [Integer]
984
972
  #
985
973
  # @!attribute [rw] reason
986
- # A short (255 max characters) human-readable string to provide
974
+ # A short (1024 max characters) human-readable string to provide
987
975
  # additional details about a running or stopped container.
988
976
  # @return [String]
989
977
  #
@@ -1065,11 +1053,18 @@ module Aws::ECS
1065
1053
  # The image used to start a container. This string is passed directly
1066
1054
  # to the Docker daemon. By default, images in the Docker Hub registry
1067
1055
  # are available. Other repositories are specified with either `
1068
- # repository-url/image:tag ` or ` repository-url/image@digest `. Up to
1069
- # 255 letters (uppercase and lowercase), numbers, hyphens,
1070
- # underscores, colons, periods, forward slashes, and number signs are
1071
- # allowed. This parameter maps to `Image` in the docker container
1072
- # create command and the `IMAGE` parameter of docker run.
1056
+ # repository-url/image:tag ` or ` repository-url/image@digest `. For
1057
+ # images using tags (repository-url/image:tag), up to 255 characters
1058
+ # total are allowed, including letters (uppercase and lowercase),
1059
+ # numbers, hyphens, underscores, colons, periods, forward slashes, and
1060
+ # number signs (#). For images using digests
1061
+ # (repository-url/image@digest), the 255 character limit applies only
1062
+ # to the repository URL and image name (everything before the @ sign).
1063
+ # The only supported hash function is sha256, and the hash value after
1064
+ # sha256: must be exactly 64 characters (only letters A-F, a-f, and
1065
+ # numbers 0-9 are allowed). This parameter maps to `Image` in the
1066
+ # docker container create command and the `IMAGE` parameter of docker
1067
+ # run.
1073
1068
  #
1074
1069
  # * When a new task starts, the Amazon ECS container agent pulls the
1075
1070
  # latest version of the specified image and tag for the container to
@@ -3286,12 +3281,15 @@ module Aws::ECS
3286
3281
  # @return [String]
3287
3282
  #
3288
3283
  # @!attribute [rw] principal_arn
3289
- # The Amazon Resource Name (ARN) of the principal. It can be an user,
3284
+ # The Amazon Resource Name (ARN) of the principal. It can be a user,
3290
3285
  # role, or the root user. If you specify the root user, it disables
3291
3286
  # the account setting for all users, roles, and the root user of the
3292
3287
  # account unless a user or role explicitly overrides these settings.
3293
3288
  # If this field is omitted, the setting is changed only for the
3294
3289
  # authenticated user.
3290
+ #
3291
+ # In order to use this parameter, you must be the root user, or the
3292
+ # principal.
3295
3293
  # @return [String]
3296
3294
  #
3297
3295
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DeleteAccountSettingRequest AWS API Documentation
@@ -5391,6 +5389,45 @@ module Aws::ECS
5391
5389
  # are part of a service, if the task reports as unhealthy then the task
5392
5390
  # will be stopped and the service scheduler will replace it.
5393
5391
  #
5392
+ # When a container health check fails for a task that is part of a
5393
+ # service, the following process occurs:
5394
+ #
5395
+ # 1. The task is marked as `UNHEALTHY`.
5396
+ #
5397
+ # 2. The unhealthy task will be stopped, and during the stopping
5398
+ # process, it will go through the following states:
5399
+ #
5400
+ # * `DEACTIVATING` - In this state, Amazon ECS performs additional
5401
+ # steps before stopping the task. For example, for tasks that are
5402
+ # part of services configured to use Elastic Load Balancing target
5403
+ # groups, target groups will be deregistered in this state.
5404
+ #
5405
+ # * `STOPPING` - The task is in the process of being stopped.
5406
+ #
5407
+ # * `DEPROVISIONING` - Resources associated with the task are being
5408
+ # cleaned up.
5409
+ #
5410
+ # * `STOPPED` - The task has been completely stopped.
5411
+ # 3. After the old task stops, a new task will be launched to ensure
5412
+ # service operation, and the new task will go through the following
5413
+ # lifecycle:
5414
+ #
5415
+ # * `PROVISIONING` - Resources required for the task are being
5416
+ # provisioned.
5417
+ #
5418
+ # * `PENDING` - The task is waiting to be placed on a container
5419
+ # instance.
5420
+ #
5421
+ # * `ACTIVATING` - In this state, Amazon ECS pulls container images,
5422
+ # creates containers, configures task networking, registers load
5423
+ # balancer target groups, and configures service discovery status.
5424
+ #
5425
+ # * `RUNNING` - The task is running and performing its work.
5426
+ #
5427
+ # For more detailed information about task lifecycle states, see [Task
5428
+ # lifecycle][1] in the *Amazon Elastic Container Service Developer
5429
+ # Guide*.
5430
+ #
5394
5431
  # The following are notes about container health check support:
5395
5432
  #
5396
5433
  # * If the Amazon ECS container agent becomes disconnected from the
@@ -5405,25 +5442,26 @@ module Aws::ECS
5405
5442
  #
5406
5443
  # * Container health checks require version `1.17.0` or greater of the
5407
5444
  # Amazon ECS container agent. For more information, see [Updating the
5408
- # Amazon ECS container agent][1].
5445
+ # Amazon ECS container agent][2].
5409
5446
  #
5410
5447
  # * Container health checks are supported for Fargate tasks if you're
5411
5448
  # using platform version `1.1.0` or greater. For more information, see
5412
- # [Fargate platform versions][2].
5449
+ # [Fargate platform versions][3].
5413
5450
  #
5414
5451
  # * Container health checks aren't supported for tasks that are part of
5415
5452
  # a service that's configured to use a Classic Load Balancer.
5416
5453
  #
5417
5454
  # For an example of how to specify a task definition with multiple
5418
5455
  # containers where container dependency is specified, see [Container
5419
- # dependency][3] in the *Amazon Elastic Container Service Developer
5456
+ # dependency][4] in the *Amazon Elastic Container Service Developer
5420
5457
  # Guide*.
5421
5458
  #
5422
5459
  #
5423
5460
  #
5424
- # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-update.html
5425
- # [2]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/platform_versions.html
5426
- # [3]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/example_task_definitions.html#example_task_definition-containerdependency
5461
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-lifecycle-explanation.html
5462
+ # [2]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-update.html
5463
+ # [3]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/platform_versions.html
5464
+ # [4]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/example_task_definitions.html#example_task_definition-containerdependency
5427
5465
  #
5428
5466
  # @!attribute [rw] command
5429
5467
  # A string array representing the command that the container runs to
@@ -5888,6 +5926,9 @@ module Aws::ECS
5888
5926
  # user. If this field is omitted, the account settings are listed only
5889
5927
  # for the authenticated user.
5890
5928
  #
5929
+ # In order to use this parameter, you must be the root user, or the
5930
+ # principal.
5931
+ #
5891
5932
  # <note markdown="1"> Federated users assume the account setting of the root user and
5892
5933
  # can't have explicit account settings set for them.
5893
5934
  #
@@ -7029,9 +7070,21 @@ module Aws::ECS
7029
7070
  # Amazon Web Services Region by using the `defaultLogDriverMode`
7030
7071
  # account setting. If you don't specify the `mode` option or
7031
7072
  # configure the account setting, Amazon ECS will default to the
7032
- # `blocking` mode. For more information about the account setting,
7033
- # see [Default log driver mode][4] in the *Amazon Elastic Container
7034
- # Service Developer Guide*.
7073
+ # `non-blocking` mode. For more information about the account
7074
+ # setting, see [Default log driver mode][4] in the *Amazon Elastic
7075
+ # Container Service Developer Guide*.
7076
+ #
7077
+ # <note markdown="1"> On June 25, 2025, Amazon ECS changed the default log driver mode
7078
+ # from `blocking` to `non-blocking` to prioritize task availability
7079
+ # over logging. To continue using the `blocking` mode after this
7080
+ # change, do one of the following:
7081
+ #
7082
+ # * Set the `mode` option in your container definition's
7083
+ # `logConfiguration` as `blocking`.
7084
+ #
7085
+ # * Set the `defaultLogDriverMode` account setting to `blocking`.
7086
+ #
7087
+ # </note>
7035
7088
  #
7036
7089
  # max-buffer-size
7037
7090
  #
@@ -7248,17 +7301,40 @@ module Aws::ECS
7248
7301
  # The managed storage configuration for the cluster.
7249
7302
  #
7250
7303
  # @!attribute [rw] kms_key_id
7251
- # Specify a Key Management Service key ID to encrypt the managed
7252
- # storage.
7304
+ # Specify a Key Management Service key ID to encrypt Amazon ECS
7305
+ # managed storage.
7306
+ #
7307
+ # When you specify a `kmsKeyId`, Amazon ECS uses the key to encrypt
7308
+ # data volumes managed by Amazon ECS that are attached to tasks in the
7309
+ # cluster. The following data volumes are managed by Amazon ECS:
7310
+ # Amazon EBS. For more information about encryption of Amazon EBS
7311
+ # volumes attached to Amazon ECS tasks, see [Encrypt data stored in
7312
+ # Amazon EBS volumes for Amazon ECS][1] in the *Amazon Elastic
7313
+ # Container Service Developer Guide*.
7253
7314
  #
7254
7315
  # The key must be a single Region key.
7316
+ #
7317
+ #
7318
+ #
7319
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ebs-kms-encryption.html
7255
7320
  # @return [String]
7256
7321
  #
7257
7322
  # @!attribute [rw] fargate_ephemeral_storage_kms_key_id
7258
- # Specify the Key Management Service key ID for the Fargate ephemeral
7323
+ # Specify the Key Management Service key ID for Fargate ephemeral
7259
7324
  # storage.
7260
7325
  #
7326
+ # When you specify a `fargateEphemeralStorageKmsKeyId`, Amazon Web
7327
+ # Services Fargate uses the key to encrypt data at rest in ephemeral
7328
+ # storage. For more information about Fargate ephemeral storage
7329
+ # encryption, see [Customer managed keys for Amazon Web Services
7330
+ # Fargate ephemeral storage for Amazon ECS][1] in the *Amazon Elastic
7331
+ # Container Service Developer Guide*.
7332
+ #
7261
7333
  # The key must be a single Region key.
7334
+ #
7335
+ #
7336
+ #
7337
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/fargate-storage-encryption.html
7262
7338
  # @return [String]
7263
7339
  #
7264
7340
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/ManagedStorageConfiguration AWS API Documentation
@@ -8000,6 +8076,18 @@ module Aws::ECS
8000
8076
  # using this account setting will be used as the default. For more
8001
8077
  # information about log delivery modes, see [LogConfiguration][7].
8002
8078
  #
8079
+ # <note markdown="1"> On June 25, 2025, Amazon ECS changed the default log driver mode
8080
+ # from `blocking` to `non-blocking` to prioritize task availability
8081
+ # over logging. To continue using the `blocking` mode after this
8082
+ # change, do one of the following:
8083
+ #
8084
+ # * Set the `mode` option in your container definition's
8085
+ # `logConfiguration` as `blocking`.
8086
+ #
8087
+ # * Set the `defaultLogDriverMode` account setting to `blocking`.
8088
+ #
8089
+ # </note>
8090
+ #
8003
8091
  # * `guardDutyActivate` - The `guardDutyActivate` parameter is
8004
8092
  # read-only in Amazon ECS and indicates whether Amazon ECS Runtime
8005
8093
  # Monitoring is enabled or disabled by your security administrator
@@ -8155,6 +8243,18 @@ module Aws::ECS
8155
8243
  # using this account setting will be used as the default. For more
8156
8244
  # information about log delivery modes, see [LogConfiguration][7].
8157
8245
  #
8246
+ # <note markdown="1"> On June 25, 2025, Amazon ECS changed the default log driver mode
8247
+ # from `blocking` to `non-blocking` to prioritize task availability
8248
+ # over logging. To continue using the `blocking` mode after this
8249
+ # change, do one of the following:
8250
+ #
8251
+ # * Set the `mode` option in your container definition's
8252
+ # `logConfiguration` as `blocking`.
8253
+ #
8254
+ # * Set the `defaultLogDriverMode` account setting to `blocking`.
8255
+ #
8256
+ # </note>
8257
+ #
8158
8258
  # * `guardDutyActivate` - The `guardDutyActivate` parameter is
8159
8259
  # read-only in Amazon ECS and indicates whether Amazon ECS Runtime
8160
8260
  # Monitoring is enabled or disabled by your security administrator
@@ -8198,6 +8298,9 @@ module Aws::ECS
8198
8298
  # or role explicitly overrides these settings. If this field is
8199
8299
  # omitted, the setting is changed only for the authenticated user.
8200
8300
  #
8301
+ # In order to use this parameter, you must be the root user, or the
8302
+ # principal.
8303
+ #
8201
8304
  # <note markdown="1"> You must use the root user when you set the Fargate wait time
8202
8305
  # (`fargateTaskRetirementWaitPeriod`).
8203
8306
  #
@@ -10339,10 +10442,12 @@ module Aws::ECS
10339
10442
  # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ebs-volumes.html#ebs-volumes-configuration
10340
10443
  #
10341
10444
  # @!attribute [rw] encrypted
10342
- # Indicates whether the volume should be encrypted. If no value is
10343
- # specified, encryption is turned on by default. This parameter maps
10344
- # 1:1 with the `Encrypted` parameter of the [CreateVolume API][1] in
10345
- # the *Amazon EC2 API Reference*.
10445
+ # Indicates whether the volume should be encrypted. If you turn on
10446
+ # Region-level Amazon EBS encryption by default but set this value as
10447
+ # `false`, the setting is overridden and the volume is encrypted with
10448
+ # the KMS key specified for Amazon EBS encryption by default. This
10449
+ # parameter maps 1:1 with the `Encrypted` parameter of the
10450
+ # [CreateVolume API][1] in the *Amazon EC2 API Reference*.
10346
10451
  #
10347
10452
  #
10348
10453
  #
@@ -10351,12 +10456,14 @@ module Aws::ECS
10351
10456
  #
10352
10457
  # @!attribute [rw] kms_key_id
10353
10458
  # The Amazon Resource Name (ARN) identifier of the Amazon Web Services
10354
- # Key Management Service key to use for Amazon EBS encryption. When
10355
- # encryption is turned on and no Amazon Web Services Key Management
10356
- # Service key is specified, the default Amazon Web Services managed
10357
- # key for Amazon EBS volumes is used. This parameter maps 1:1 with the
10358
- # `KmsKeyId` parameter of the [CreateVolume API][1] in the *Amazon EC2
10359
- # API Reference*.
10459
+ # Key Management Service key to use for Amazon EBS encryption. When a
10460
+ # key is specified using this parameter, it overrides Amazon EBS
10461
+ # default encryption or any KMS key that you specified for
10462
+ # cluster-level managed storage encryption. This parameter maps 1:1
10463
+ # with the `KmsKeyId` parameter of the [CreateVolume API][1] in the
10464
+ # *Amazon EC2 API Reference*. For more information about encrypting
10465
+ # Amazon EBS volumes attached to tasks, see [Encrypt data stored in
10466
+ # Amazon EBS volumes attached to Amazon ECS tasks][2].
10360
10467
  #
10361
10468
  # Amazon Web Services authenticates the Amazon Web Services Key
10362
10469
  # Management Service key asynchronously. Therefore, if you specify an
@@ -10366,6 +10473,7 @@ module Aws::ECS
10366
10473
  #
10367
10474
  #
10368
10475
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateVolume.html
10476
+ # [2]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ebs-kms-encryption.html
10369
10477
  # @return [String]
10370
10478
  #
10371
10479
  # @!attribute [rw] volume_type
@@ -10421,16 +10529,29 @@ module Aws::ECS
10421
10529
  # @return [Integer]
10422
10530
  #
10423
10531
  # @!attribute [rw] snapshot_id
10424
- # The snapshot that Amazon ECS uses to create the volume. You must
10425
- # specify either a snapshot ID or a volume size. This parameter maps
10426
- # 1:1 with the `SnapshotId` parameter of the [CreateVolume API][1] in
10427
- # the *Amazon EC2 API Reference*.
10532
+ # The snapshot that Amazon ECS uses to create volumes for attachment
10533
+ # to tasks maintained by the service. You must specify either
10534
+ # `snapshotId` or `sizeInGiB` in your volume configuration. This
10535
+ # parameter maps 1:1 with the `SnapshotId` parameter of the
10536
+ # [CreateVolume API][1] in the *Amazon EC2 API Reference*.
10428
10537
  #
10429
10538
  #
10430
10539
  #
10431
10540
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateVolume.html
10432
10541
  # @return [String]
10433
10542
  #
10543
+ # @!attribute [rw] volume_initialization_rate
10544
+ # The rate, in MiB/s, at which data is fetched from a snapshot of an
10545
+ # existing EBS volume to create new volumes for attachment to the
10546
+ # tasks maintained by the service. This property can be specified only
10547
+ # if you specify a `snapshotId`. For more information, see [Initialize
10548
+ # Amazon EBS volumes][1] in the *Amazon EBS User Guide*.
10549
+ #
10550
+ #
10551
+ #
10552
+ # [1]: https://docs.aws.amazon.com/ebs/latest/userguide/initalize-volume.html
10553
+ # @return [Integer]
10554
+ #
10434
10555
  # @!attribute [rw] iops
10435
10556
  # The number of I/O operations per second (IOPS). For `gp3`, `io1`,
10436
10557
  # and `io2` volumes, this represents the number of IOPS that are
@@ -10499,7 +10620,7 @@ module Aws::ECS
10499
10620
  # The filesystem type for the volume. For volumes created from a
10500
10621
  # snapshot, you must specify the same filesystem type that the volume
10501
10622
  # was using when the snapshot was created. If there is a filesystem
10502
- # type mismatch, the task will fail to start.
10623
+ # type mismatch, the tasks will fail to start.
10503
10624
  #
10504
10625
  # The available Linux filesystem types are
 `ext3`, `ext4`, and `xfs`.
10505
10626
  # If no value is specified, the `xfs` filesystem type is used by
@@ -10516,6 +10637,7 @@ module Aws::ECS
10516
10637
  :volume_type,
10517
10638
  :size_in_gi_b,
10518
10639
  :snapshot_id,
10640
+ :volume_initialization_rate,
10519
10641
  :iops,
10520
10642
  :throughput,
10521
10643
  :tag_specifications,
@@ -11038,7 +11160,7 @@ module Aws::ECS
11038
11160
  # @!attribute [rw] stop_type
11039
11161
  # How you want Amazon ECS to stop the service.
11040
11162
  #
11041
- # The ROLLBACK and ABORT stopType aren't supported.
11163
+ # The valid values are `ROLLBACK`.
11042
11164
  # @return [String]
11043
11165
  #
11044
11166
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/StopServiceDeploymentRequest AWS API Documentation
@@ -11324,7 +11446,9 @@ module Aws::ECS
11324
11446
  # "kernel.shmmni" | "kernel.shm_rmid_forced"`, and `Sysctls` that
11325
11447
  # start with `"fs.mqueue.*"`
11326
11448
  #
11327
- # Valid network namespace values: `Sysctls` that start with `"net.*"`
11449
+ # Valid network namespace values: `Sysctls` that start with `"net.*"`.
11450
+ # Only namespaced `Sysctls` that exist within the container starting
11451
+ # with "net.* are accepted.
11328
11452
  #
11329
11453
  # All of these values are supported by Fargate.
11330
11454
  # @return [String]
@@ -12298,10 +12422,12 @@ module Aws::ECS
12298
12422
  # Amazon EBS volume, with one volume created for each task.
12299
12423
  #
12300
12424
  # @!attribute [rw] encrypted
12301
- # Indicates whether the volume should be encrypted. If no value is
12302
- # specified, encryption is turned on by default. This parameter maps
12303
- # 1:1 with the `Encrypted` parameter of the [CreateVolume API][1] in
12304
- # the *Amazon EC2 API Reference*.
12425
+ # Indicates whether the volume should be encrypted. If you turn on
12426
+ # Region-level Amazon EBS encryption by default but set this value as
12427
+ # `false`, the setting is overridden and the volume is encrypted with
12428
+ # the KMS key specified for Amazon EBS encryption by default. This
12429
+ # parameter maps 1:1 with the `Encrypted` parameter of the
12430
+ # [CreateVolume API][1] in the *Amazon EC2 API Reference*.
12305
12431
  #
12306
12432
  #
12307
12433
  #
@@ -12310,12 +12436,14 @@ module Aws::ECS
12310
12436
  #
12311
12437
  # @!attribute [rw] kms_key_id
12312
12438
  # The Amazon Resource Name (ARN) identifier of the Amazon Web Services
12313
- # Key Management Service key to use for Amazon EBS encryption. When
12314
- # encryption is turned on and no Amazon Web Services Key Management
12315
- # Service key is specified, the default Amazon Web Services managed
12316
- # key for Amazon EBS volumes is used. This parameter maps 1:1 with the
12317
- # `KmsKeyId` parameter of the [CreateVolume API][1] in the *Amazon EC2
12318
- # API Reference*.
12439
+ # Key Management Service key to use for Amazon EBS encryption. When a
12440
+ # key is specified using this parameter, it overrides Amazon EBS
12441
+ # default encryption or any KMS key that you specified for
12442
+ # cluster-level managed storage encryption. This parameter maps 1:1
12443
+ # with the `KmsKeyId` parameter of the [CreateVolume API][1] in the
12444
+ # *Amazon EC2 API Reference*. For more information about encrypting
12445
+ # Amazon EBS volumes attached to a task, see [Encrypt data stored in
12446
+ # Amazon EBS volumes attached to Amazon ECS tasks][2].
12319
12447
  #
12320
12448
  # Amazon Web Services authenticates the Amazon Web Services Key
12321
12449
  # Management Service key asynchronously. Therefore, if you specify an
@@ -12325,6 +12453,7 @@ module Aws::ECS
12325
12453
  #
12326
12454
  #
12327
12455
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateVolume.html
12456
+ # [2]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ebs-kms-encryption.html
12328
12457
  # @return [String]
12329
12458
  #
12330
12459
  # @!attribute [rw] volume_type
@@ -12390,6 +12519,18 @@ module Aws::ECS
12390
12519
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateVolume.html
12391
12520
  # @return [String]
12392
12521
  #
12522
+ # @!attribute [rw] volume_initialization_rate
12523
+ # The rate, in MiB/s, at which data is fetched from a snapshot of an
12524
+ # existing Amazon EBS volume to create a new volume for attachment to
12525
+ # the task. This property can be specified only if you specify a
12526
+ # `snapshotId`. For more information, see [Initialize Amazon EBS
12527
+ # volumes][1] in the *Amazon EBS User Guide*.
12528
+ #
12529
+ #
12530
+ #
12531
+ # [1]: https://docs.aws.amazon.com/ebs/latest/userguide/initalize-volume.html
12532
+ # @return [Integer]
12533
+ #
12393
12534
  # @!attribute [rw] iops
12394
12535
  # The number of I/O operations per second (IOPS). For `gp3`, `io1`,
12395
12536
  # and `io2` volumes, this represents the number of IOPS that are
@@ -12478,6 +12619,7 @@ module Aws::ECS
12478
12619
  :volume_type,
12479
12620
  :size_in_gi_b,
12480
12621
  :snapshot_id,
12622
+ :volume_initialization_rate,
12481
12623
  :iops,
12482
12624
  :throughput,
12483
12625
  :tag_specifications,
@@ -13257,6 +13399,8 @@ module Aws::ECS
13257
13399
  # The short name or full Amazon Resource Name (ARN) of the cluster
13258
13400
  # that your service runs on. If you do not specify a cluster, the
13259
13401
  # default cluster is assumed.
13402
+ #
13403
+ # You can't change the cluster name.
13260
13404
  # @return [String]
13261
13405
  #
13262
13406
  # @!attribute [rw] service
@@ -13278,44 +13422,42 @@ module Aws::ECS
13278
13422
  # @return [String]
13279
13423
  #
13280
13424
  # @!attribute [rw] capacity_provider_strategy
13281
- # The capacity provider strategy to update the service to use.
13425
+ # The details of a capacity provider strategy. You can set a capacity
13426
+ # provider when you create a cluster, run a task, or update a service.
13282
13427
  #
13283
- # if the service uses the default capacity provider strategy for the
13284
- # cluster, the service can be updated to use one or more capacity
13285
- # providers as opposed to the default capacity provider strategy.
13286
- # However, when a service is using a capacity provider strategy
13287
- # that's not the default capacity provider strategy, the service
13288
- # can't be updated to use the cluster's default capacity provider
13289
- # strategy.
13428
+ # When you use Fargate, the capacity providers are `FARGATE` or
13429
+ # `FARGATE_SPOT`.
13290
13430
  #
13291
- # A capacity provider strategy consists of one or more capacity
13292
- # providers along with the `base` and `weight` to assign to them. A
13293
- # capacity provider must be associated with the cluster to be used in
13294
- # a capacity provider strategy. The [PutClusterCapacityProviders][1]
13295
- # API is used to associate a capacity provider with a cluster. Only
13296
- # capacity providers with an `ACTIVE` or `UPDATING` status can be
13297
- # used.
13431
+ # When you use Amazon EC2, the capacity providers are Auto Scaling
13432
+ # groups.
13298
13433
  #
13299
- # If specifying a capacity provider that uses an Auto Scaling group,
13300
- # the capacity provider must already be created. New capacity
13301
- # providers can be created with the [CreateClusterCapacityProvider][2]
13302
- # API operation.
13434
+ # You can change capacity providers for rolling deployments and
13435
+ # blue/green deployments.
13303
13436
  #
13304
- # To use a Fargate capacity provider, specify either the `FARGATE` or
13305
- # `FARGATE_SPOT` capacity providers. The Fargate capacity providers
13306
- # are available to all accounts and only need to be associated with a
13307
- # cluster to be used.
13437
+ # The following list provides the valid transitions:
13308
13438
  #
13309
- # The [PutClusterCapacityProviders][1]API operation is used to update
13310
- # the list of available capacity providers for a cluster after the
13311
- # cluster is created.
13439
+ # * Update the Fargate launch type to an Auto Scaling group capacity
13440
+ # provider.
13312
13441
  #
13442
+ # * Update the Amazon EC2 launch type to a Fargate capacity provider.
13313
13443
  #
13444
+ # * Update the Fargate capacity provider to an Auto Scaling group
13445
+ # capacity provider.
13314
13446
  #
13447
+ # * Update the Amazon EC2 capacity provider to a Fargate capacity
13448
+ # provider.
13315
13449
  #
13450
+ # * Update the Auto Scaling group or Fargate capacity provider back to
13451
+ # the launch type.
13316
13452
  #
13317
- # [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PutClusterCapacityProviders.html
13318
- # [2]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateClusterCapacityProvider.html
13453
+ # Pass an empty list in the `capacityProviderStrategy` parameter.
13454
+ #
13455
+ # For information about Amazon Web Services CDK considerations, see
13456
+ # [Amazon Web Services CDK considerations][1].
13457
+ #
13458
+ #
13459
+ #
13460
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/update-service-parameters.html
13319
13461
  # @return [Array<Types::CapacityProviderStrategyItem>]
13320
13462
  #
13321
13463
  # @!attribute [rw] deployment_configuration
@@ -13427,6 +13569,10 @@ module Aws::ECS
13427
13569
  # @return [Boolean]
13428
13570
  #
13429
13571
  # @!attribute [rw] load_balancers
13572
+ # <note markdown="1"> You must have a service-linked role when you update this property
13573
+ #
13574
+ # </note>
13575
+ #
13430
13576
  # A list of Elastic Load Balancing load balancer objects. It contains
13431
13577
  # the load balancer name, the container name, and the container port
13432
13578
  # to access from the load balancer. The container name is as it
@@ -13475,8 +13621,15 @@ module Aws::ECS
13475
13621
  # @return [String]
13476
13622
  #
13477
13623
  # @!attribute [rw] service_registries
13624
+ # <note markdown="1"> You must have a service-linked role when you update this property.
13625
+ #
13626
+ # For more information about the role see the `CreateService` request
13627
+ # parameter [ `role` ][1].
13628
+ #
13629
+ # </note>
13630
+ #
13478
13631
  # The details for the service discovery registries to assign to this
13479
- # service. For more information, see [Service Discovery][1].
13632
+ # service. For more information, see [Service Discovery][2].
13480
13633
  #
13481
13634
  # When you add, update, or remove the service registries
13482
13635
  # configuration, Amazon ECS starts new tasks with the updated service
@@ -13488,7 +13641,8 @@ module Aws::ECS
13488
13641
  #
13489
13642
  #
13490
13643
  #
13491
- # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-discovery.html
13644
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html#ECS-CreateService-request-role
13645
+ # [2]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-discovery.html
13492
13646
  # @return [Array<Types::ServiceRegistry>]
13493
13647
  #
13494
13648
  # @!attribute [rw] service_connect_configuration
@@ -13688,7 +13842,7 @@ module Aws::ECS
13688
13842
  #
13689
13843
  #
13690
13844
  #
13691
- # [1]: https://github.com/aws/amazon-ecs-agent/commits/master
13845
+ # [1]: https://github.com/aws/amazon-ecs-agent
13692
13846
  # @return [String]
13693
13847
  #
13694
13848
  # @!attribute [rw] docker_version
data/lib/aws-sdk-ecs.rb CHANGED
@@ -55,7 +55,7 @@ module Aws::ECS
55
55
  autoload :EndpointProvider, 'aws-sdk-ecs/endpoint_provider'
56
56
  autoload :Endpoints, 'aws-sdk-ecs/endpoints'
57
57
 
58
- GEM_VERSION = '1.187.0'
58
+ GEM_VERSION = '1.196.0'
59
59
 
60
60
  end
61
61
 
data/sig/client.rbs CHANGED
@@ -287,6 +287,7 @@ module Aws
287
287
  volume_type: ::String?,
288
288
  size_in_gi_b: ::Integer?,
289
289
  snapshot_id: ::String?,
290
+ volume_initialization_rate: ::Integer?,
290
291
  iops: ::Integer?,
291
292
  throughput: ::Integer?,
292
293
  tag_specifications: Array[
@@ -1145,7 +1146,7 @@ module Aws
1145
1146
  },
1146
1147
  ?runtime_platform: {
1147
1148
  cpu_architecture: ("X86_64" | "ARM64")?,
1148
- operating_system_family: ("WINDOWS_SERVER_2019_FULL" | "WINDOWS_SERVER_2019_CORE" | "WINDOWS_SERVER_2016_FULL" | "WINDOWS_SERVER_2004_CORE" | "WINDOWS_SERVER_2022_CORE" | "WINDOWS_SERVER_2022_FULL" | "WINDOWS_SERVER_20H2_CORE" | "LINUX")?
1149
+ operating_system_family: ("WINDOWS_SERVER_2019_FULL" | "WINDOWS_SERVER_2019_CORE" | "WINDOWS_SERVER_2016_FULL" | "WINDOWS_SERVER_2004_CORE" | "WINDOWS_SERVER_2022_CORE" | "WINDOWS_SERVER_2022_FULL" | "WINDOWS_SERVER_2025_CORE" | "WINDOWS_SERVER_2025_FULL" | "WINDOWS_SERVER_20H2_CORE" | "LINUX")?
1149
1150
  },
1150
1151
  ?enable_fault_injection: bool
1151
1152
  ) -> _RegisterTaskDefinitionResponseSuccess
@@ -1253,6 +1254,7 @@ module Aws
1253
1254
  volume_type: ::String?,
1254
1255
  size_in_gi_b: ::Integer?,
1255
1256
  snapshot_id: ::String?,
1257
+ volume_initialization_rate: ::Integer?,
1256
1258
  iops: ::Integer?,
1257
1259
  throughput: ::Integer?,
1258
1260
  tag_specifications: Array[
@@ -1358,6 +1360,7 @@ module Aws
1358
1360
  volume_type: ::String?,
1359
1361
  size_in_gi_b: ::Integer?,
1360
1362
  snapshot_id: ::String?,
1363
+ volume_initialization_rate: ::Integer?,
1361
1364
  iops: ::Integer?,
1362
1365
  throughput: ::Integer?,
1363
1366
  tag_specifications: Array[
@@ -1739,6 +1742,7 @@ module Aws
1739
1742
  volume_type: ::String?,
1740
1743
  size_in_gi_b: ::Integer?,
1741
1744
  snapshot_id: ::String?,
1745
+ volume_initialization_rate: ::Integer?,
1742
1746
  iops: ::Integer?,
1743
1747
  throughput: ::Integer?,
1744
1748
  tag_specifications: Array[