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.
- checksums.yaml +4 -4
- data/CHANGELOG.md +45 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-ecs/client.rb +136 -82
- data/lib/aws-sdk-ecs/client_api.rb +3 -1
- data/lib/aws-sdk-ecs/types.rb +245 -91
- data/lib/aws-sdk-ecs.rb +1 -1
- data/sig/client.rbs +5 -1
- data/sig/types.rbs +3 -1
- metadata +6 -9
data/lib/aws-sdk-ecs/types.rb
CHANGED
@@ -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
|
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 (
|
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 `.
|
1069
|
-
#
|
1070
|
-
#
|
1071
|
-
#
|
1072
|
-
#
|
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
|
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][
|
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][
|
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][
|
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/
|
5425
|
-
# [2]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/
|
5426
|
-
# [3]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/
|
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
|
7033
|
-
# see [Default log driver mode][4] in the *Amazon Elastic
|
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
|
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
|
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
|
10343
|
-
#
|
10344
|
-
#
|
10345
|
-
# the
|
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
|
-
#
|
10356
|
-
#
|
10357
|
-
#
|
10358
|
-
# `KmsKeyId` parameter of the [CreateVolume API][1] in the
|
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
|
10425
|
-
#
|
10426
|
-
#
|
10427
|
-
# the
|
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
|
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
|
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
|
12302
|
-
#
|
12303
|
-
#
|
12304
|
-
# the
|
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
|
-
#
|
12315
|
-
#
|
12316
|
-
#
|
12317
|
-
# `KmsKeyId` parameter of the [CreateVolume API][1] in the
|
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
|
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
|
-
#
|
13284
|
-
#
|
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
|
-
#
|
13292
|
-
#
|
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
|
-
#
|
13300
|
-
#
|
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
|
-
#
|
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
|
-
#
|
13310
|
-
#
|
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
|
-
#
|
13318
|
-
#
|
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][
|
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/
|
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
|
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
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[
|