aws-sdk-ecs 1.86.0 → 1.90.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -10,7 +10,7 @@
10
10
  module Aws::ECS
11
11
  module Types
12
12
 
13
- # You do not have authorization to perform the requested action.
13
+ # You don't have authorization to perform the requested action.
14
14
  #
15
15
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/AccessDeniedException AWS API Documentation
16
16
  #
@@ -76,9 +76,9 @@ module Aws::ECS
76
76
  include Aws::Structure
77
77
  end
78
78
 
79
- # An attribute is a name-value pair associated with an Amazon ECS
80
- # object. Attributes enable you to extend the Amazon ECS data model by
81
- # adding custom metadata to your resources. For more information, see
79
+ # An attribute is a name-value pair that's associated with an Amazon
80
+ # ECS object. Attributes enable you to extend the Amazon ECS data model
81
+ # by adding custom metadata to your resources. For more information, see
82
82
  # [Attributes][1] in the *Amazon Elastic Container Service Developer
83
83
  # Guide*.
84
84
  #
@@ -98,23 +98,23 @@ module Aws::ECS
98
98
  #
99
99
  # @!attribute [rw] name
100
100
  # The name of the attribute. The `name` must contain between 1 and 128
101
- # characters and name may contain letters (uppercase and lowercase),
102
- # numbers, hyphens, underscores, forward slashes, back slashes, or
103
- # periods.
101
+ # characters. The name may contain letters (uppercase and lowercase),
102
+ # numbers, hyphens (-), underscores (\_), forward slashes (/), back
103
+ # slashes (\\), or periods (.).
104
104
  # @return [String]
105
105
  #
106
106
  # @!attribute [rw] value
107
107
  # The value of the attribute. The `value` must contain between 1 and
108
- # 128 characters and may contain letters (uppercase and lowercase),
109
- # numbers, hyphens, underscores, periods, at signs (@), forward
110
- # slashes, back slashes, colons, or spaces. The value cannot contain
111
- # any leading or trailing whitespace.
108
+ # 128 characters. It can contain letters (uppercase and lowercase),
109
+ # numbers, hyphens (-), underscores (\_), periods (.), at signs (@),
110
+ # forward slashes (/), back slashes (\\), colons (:), or spaces. The
111
+ # value can't can't start or end with a space.
112
112
  # @return [String]
113
113
  #
114
114
  # @!attribute [rw] target_type
115
- # The type of the target with which to attach the attribute. This
116
- # parameter is required if you use the short form ID for a resource
117
- # instead of the full ARN.
115
+ # The type of the target to attach the attribute with. This parameter
116
+ # is required if you use the short form ID for a resource instead of
117
+ # the full ARN.
118
118
  # @return [String]
119
119
  #
120
120
  # @!attribute [rw] target_id
@@ -133,8 +133,8 @@ module Aws::ECS
133
133
  include Aws::Structure
134
134
  end
135
135
 
136
- # You can apply up to 10 custom attributes per resource. You can view
137
- # the attributes of a resource with ListAttributes. You can remove
136
+ # You can apply up to 10 custom attributes for each resource. You can
137
+ # view the attributes of a resource with ListAttributes. You can remove
138
138
  # existing attributes on a resource with DeleteAttributes.
139
139
  #
140
140
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/AttributeLimitExceededException AWS API Documentation
@@ -174,7 +174,7 @@ module Aws::ECS
174
174
  # Scaling group has managed termination protection.
175
175
  #
176
176
  # When using managed termination protection, managed scaling must also
177
- # be used otherwise managed termination protection will not work.
177
+ # be used otherwise managed termination protection doesn't work.
178
178
  #
179
179
  # When managed termination protection is enabled, Amazon ECS prevents
180
180
  # the Amazon EC2 instances in an Auto Scaling group that contain tasks
@@ -185,7 +185,7 @@ module Aws::ECS
185
185
  # Guide*.
186
186
  #
187
187
  # When managed termination protection is disabled, your Amazon EC2
188
- # instances are not protected from termination when the Auto Scaling
188
+ # instances aren't protected from termination when the Auto Scaling
189
189
  # group scales in.
190
190
  #
191
191
  #
@@ -230,18 +230,17 @@ module Aws::ECS
230
230
  # Scaling group has managed termination protection.
231
231
  #
232
232
  # When using managed termination protection, managed scaling must also
233
- # be used otherwise managed termination protection will not work.
233
+ # be used otherwise managed termination protection doesn't work.
234
234
  #
235
235
  # When managed termination protection is enabled, Amazon ECS prevents
236
236
  # the Amazon EC2 instances in an Auto Scaling group that contain tasks
237
237
  # from being terminated during a scale-in action. The Auto Scaling
238
238
  # group and each instance in the Auto Scaling group must have instance
239
- # protection from scale-in actions enabled as well. For more
240
- # information, see [Instance Protection][1] in the *Auto Scaling User
241
- # Guide*.
239
+ # protection from scale-in actions enabled. For more information, see
240
+ # [Instance Protection][1] in the *Auto Scaling User Guide*.
242
241
  #
243
242
  # When managed termination protection is disabled, your Amazon EC2
244
- # instances are not protected from termination when the Auto Scaling
243
+ # instances aren't protected from termination when the Auto Scaling
245
244
  # group scales in.
246
245
  #
247
246
  #
@@ -270,7 +269,7 @@ module Aws::ECS
270
269
  # }
271
270
  #
272
271
  # @!attribute [rw] subnets
273
- # The IDs of the subnets associated with the task or service. There is
272
+ # The IDs of the subnets associated with the task or service. There's
274
273
  # a limit of 16 subnets that can be specified per
275
274
  # `AwsVpcConfiguration`.
276
275
  #
@@ -281,8 +280,8 @@ module Aws::ECS
281
280
  #
282
281
  # @!attribute [rw] security_groups
283
282
  # The IDs of the security groups associated with the task or service.
284
- # If you do not specify a security group, the default security group
285
- # for the VPC is used. There is a limit of 5 security groups that can
283
+ # If you don't specify a security group, the default security group
284
+ # for the VPC is used. There's a limit of 5 security groups that can
286
285
  # be specified per `AwsVpcConfiguration`.
287
286
  #
288
287
  # <note markdown="1"> All specified security groups must be from the same VPC.
@@ -305,8 +304,8 @@ module Aws::ECS
305
304
  include Aws::Structure
306
305
  end
307
306
 
308
- # Your Amazon Web Services account has been blocked. For more
309
- # information, contact [ Amazon Web Services Support][1].
307
+ # Your Amazon Web Services account was blocked. For more information,
308
+ # contact [ Amazon Web Services Support][1].
310
309
  #
311
310
  #
312
311
  #
@@ -316,7 +315,7 @@ module Aws::ECS
316
315
  #
317
316
  class BlockedException < Aws::EmptyStructure; end
318
317
 
319
- # The details of a capacity provider.
318
+ # The details for a capacity provider.
320
319
  #
321
320
  # @!attribute [rw] capacity_provider_arn
322
321
  # The Amazon Resource Name (ARN) that identifies the capacity
@@ -330,7 +329,7 @@ module Aws::ECS
330
329
  # @!attribute [rw] status
331
330
  # The current status of the capacity provider. Only capacity providers
332
331
  # in an `ACTIVE` state can be used in a cluster. When a capacity
333
- # provider is successfully deleted, it will have an `INACTIVE` status.
332
+ # provider is successfully deleted, it has an `INACTIVE` status.
334
333
  # @return [String]
335
334
  #
336
335
  # @!attribute [rw] auto_scaling_group_provider
@@ -339,7 +338,7 @@ module Aws::ECS
339
338
  #
340
339
  # @!attribute [rw] update_status
341
340
  # The update status of the capacity provider. The following are the
342
- # possible states that will be returned.
341
+ # possible states that is returned.
343
342
  #
344
343
  # DELETE\_IN\_PROGRESS
345
344
  #
@@ -347,13 +346,13 @@ module Aws::ECS
347
346
  #
348
347
  # DELETE\_COMPLETE
349
348
  #
350
- # : The capacity provider has been successfully deleted and will have
351
- # an `INACTIVE` status.
349
+ # : The capacity provider was successfully deleted and has an
350
+ # `INACTIVE` status.
352
351
  #
353
352
  # DELETE\_FAILED
354
353
  #
355
- # : The capacity provider was unable to be deleted. The update status
356
- # reason will provide further details about why the delete failed.
354
+ # : The capacity provider can't be deleted. The update status reason
355
+ # provides further details about why the delete failed.
357
356
  # @return [String]
358
357
  #
359
358
  # @!attribute [rw] update_status_reason
@@ -364,7 +363,7 @@ module Aws::ECS
364
363
  # @!attribute [rw] tags
365
364
  # The metadata that you apply to the capacity provider to help you
366
365
  # categorize and organize it. Each tag consists of a key and an
367
- # optional value, both of which you define.
366
+ # optional value. You define both.
368
367
  #
369
368
  # The following basic restrictions apply to tags:
370
369
  #
@@ -452,17 +451,17 @@ module Aws::ECS
452
451
  # When multiple capacity providers are specified within a capacity
453
452
  # provider strategy, at least one of the capacity providers must have
454
453
  # a weight value greater than zero and any capacity providers with a
455
- # weight of `0` will not be used to place tasks. If you specify
456
- # multiple capacity providers in a strategy that all have a weight of
457
- # `0`, any `RunTask` or `CreateService` actions using the capacity
458
- # provider strategy will fail.
454
+ # weight of `0` can't be used to place tasks. If you specify multiple
455
+ # capacity providers in a strategy that all have a weight of `0`, any
456
+ # `RunTask` or `CreateService` actions using the capacity provider
457
+ # strategy will fail.
459
458
  #
460
459
  # An example scenario for using weights is defining a strategy that
461
460
  # contains two capacity providers and both have a weight of `1`, then
462
461
  # when the `base` is satisfied, the tasks will be split evenly across
463
462
  # the two capacity providers. Using that same logic, if you specify a
464
463
  # weight of `1` for *capacityProviderA* and a weight of `4` for
465
- # *capacityProviderB*, then for every one task that is run using
464
+ # *capacityProviderB*, then for every one task that's run using
466
465
  # *capacityProviderA*, four tasks would use *capacityProviderB*.
467
466
  # @return [Integer]
468
467
  #
@@ -483,10 +482,10 @@ module Aws::ECS
483
482
  include Aws::Structure
484
483
  end
485
484
 
486
- # These errors are usually caused by a client action, such as using an
487
- # action or resource on behalf of a user that doesn't have permissions
488
- # to use the action or resource, or specifying an identifier that is not
489
- # valid.
485
+ # These errors are usually caused by a client action. This client action
486
+ # might be using an action or resource on behalf of a user that doesn't
487
+ # have permissions to use the action or resource,. Or, it might be
488
+ # specifying an identifier that isn't valid.
490
489
  #
491
490
  # @!attribute [rw] message
492
491
  # @return [String]
@@ -499,10 +498,10 @@ module Aws::ECS
499
498
  include Aws::Structure
500
499
  end
501
500
 
502
- # A regional grouping of one or more container instances on which you
503
- # can run task requests. Each account receives a default cluster the
504
- # first time you use the Amazon ECS service, but you may also create
505
- # other clusters. Clusters may contain more than one instance type
501
+ # A regional grouping of one or more container instances where you can
502
+ # run task requests. Each account receives a default cluster the first
503
+ # time you use the Amazon ECS service, but you may also create other
504
+ # clusters. Clusters may contain more than one instance type
506
505
  # simultaneously.
507
506
  #
508
507
  # @!attribute [rw] cluster_arn
@@ -523,7 +522,7 @@ module Aws::ECS
523
522
  #
524
523
  # @!attribute [rw] status
525
524
  # The status of the cluster. The following are the possible states
526
- # that will be returned.
525
+ # that are returned.
527
526
  #
528
527
  # ACTIVE
529
528
  #
@@ -532,25 +531,26 @@ module Aws::ECS
532
531
  #
533
532
  # PROVISIONING
534
533
  #
535
- # : The cluster has capacity providers associated with it and the
536
- # resources needed for the capacity provider are being created.
534
+ # : The cluster has capacity providers that are associated with it and
535
+ # the resources needed for the capacity provider are being created.
537
536
  #
538
537
  # DEPROVISIONING
539
538
  #
540
- # : The cluster has capacity providers associated with it and the
541
- # resources needed for the capacity provider are being deleted.
539
+ # : The cluster has capacity providers that are associated with it and
540
+ # the resources needed for the capacity provider are being deleted.
542
541
  #
543
542
  # FAILED
544
543
  #
545
- # : The cluster has capacity providers associated with it and the
546
- # resources needed for the capacity provider have failed to create.
544
+ # : The cluster has capacity providers that are associated with it and
545
+ # the resources needed for the capacity provider have failed to
546
+ # create.
547
547
  #
548
548
  # INACTIVE
549
549
  #
550
550
  # : The cluster has been deleted. Clusters with an `INACTIVE` status
551
551
  # may remain discoverable in your account for a period of time.
552
- # However, this behavior is subject to change in the future, so you
553
- # should not rely on `INACTIVE` clusters persisting.
552
+ # However, this behavior is subject to change in the future. We
553
+ # don't recommend that you rely on `INACTIVE` clusters persisting.
554
554
  # @return [String]
555
555
  #
556
556
  # @!attribute [rw] registered_container_instances_count
@@ -573,7 +573,7 @@ module Aws::ECS
573
573
  #
574
574
  # @!attribute [rw] statistics
575
575
  # Additional information about your clusters that are separated by
576
- # launch type, including:
576
+ # launch type. They include the following:
577
577
  #
578
578
  # * runningEC2TasksCount
579
579
  #
@@ -594,8 +594,8 @@ module Aws::ECS
594
594
  #
595
595
  # @!attribute [rw] tags
596
596
  # The metadata that you apply to the cluster to help you categorize
597
- # and organize them. Each tag consists of a key and an optional value,
598
- # both of which you define.
597
+ # and organize them. Each tag consists of a key and an optional value.
598
+ # You define both.
599
599
  #
600
600
  # The following basic restrictions apply to tags:
601
601
  #
@@ -641,13 +641,13 @@ module Aws::ECS
641
641
  #
642
642
  # @!attribute [rw] attachments
643
643
  # The resources attached to a cluster. When using a capacity provider
644
- # with a cluster, the Auto Scaling plan that is created will be
645
- # returned as a cluster attachment.
644
+ # with a cluster, the Auto Scaling plan that's created is returned as
645
+ # a cluster attachment.
646
646
  # @return [Array<Types::Attachment>]
647
647
  #
648
648
  # @!attribute [rw] attachments_status
649
649
  # The status of the capacity providers associated with the cluster.
650
- # The following are the states that will be returned:
650
+ # The following are the states that are returned.
651
651
  #
652
652
  # UPDATE\_IN\_PROGRESS
653
653
  #
@@ -717,7 +717,7 @@ module Aws::ECS
717
717
  include Aws::Structure
718
718
  end
719
719
 
720
- # You cannot delete a cluster that has registered container instances.
720
+ # You can't delete a cluster that has registered container instances.
721
721
  # First, deregister the container instances before you can delete the
722
722
  # cluster. For more information, see DeregisterContainerInstance.
723
723
  #
@@ -725,22 +725,22 @@ module Aws::ECS
725
725
  #
726
726
  class ClusterContainsContainerInstancesException < Aws::EmptyStructure; end
727
727
 
728
- # You cannot delete a cluster that contains services. First, update the
729
- # service to reduce its desired task count to 0 and then delete the
728
+ # You can't delete a cluster that contains services. First, update the
729
+ # service to reduce its desired task count to 0, and then delete the
730
730
  # service. For more information, see UpdateService and DeleteService.
731
731
  #
732
732
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/ClusterContainsServicesException AWS API Documentation
733
733
  #
734
734
  class ClusterContainsServicesException < Aws::EmptyStructure; end
735
735
 
736
- # You cannot delete a cluster that has active tasks.
736
+ # You can't delete a cluster that has active tasks.
737
737
  #
738
738
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/ClusterContainsTasksException AWS API Documentation
739
739
  #
740
740
  class ClusterContainsTasksException < Aws::EmptyStructure; end
741
741
 
742
- # The specified cluster could not be found. You can view your available
743
- # clusters with ListClusters. Amazon ECS clusters are Region-specific.
742
+ # The specified cluster wasn't found. You can view your available
743
+ # clusters with ListClusters. Amazon ECS clusters are Region specific.
744
744
  #
745
745
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/ClusterNotFoundException AWS API Documentation
746
746
  #
@@ -781,7 +781,7 @@ module Aws::ECS
781
781
  include Aws::Structure
782
782
  end
783
783
 
784
- # A Docker container that is part of a task.
784
+ # A Docker container that's part of a task.
785
785
  #
786
786
  # @!attribute [rw] container_arn
787
787
  # The Amazon Resource Name (ARN) of the container.
@@ -834,7 +834,7 @@ module Aws::ECS
834
834
  # @return [Array<Types::NetworkInterface>]
835
835
  #
836
836
  # @!attribute [rw] health_status
837
- # The health status of the container. If health checks are not
837
+ # The health status of the container. If health checks aren't
838
838
  # configured for this container in its task definition, then it
839
839
  # reports the health status as `UNKNOWN`.
840
840
  # @return [String]
@@ -845,8 +845,8 @@ module Aws::ECS
845
845
  # @return [Array<Types::ManagedAgent>]
846
846
  #
847
847
  # @!attribute [rw] cpu
848
- # The number of CPU units set for the container. The value will be `0`
849
- # if no value was specified in the container definition when the task
848
+ # The number of CPU units set for the container. The value is `0` if
849
+ # no value was specified in the container definition when the task
850
850
  # definition was registered.
851
851
  # @return [String]
852
852
  #
@@ -1042,7 +1042,7 @@ module Aws::ECS
1042
1042
  # }
1043
1043
  #
1044
1044
  # @!attribute [rw] name
1045
- # The name of a container. If you are linking multiple containers
1045
+ # The name of a container. If you're linking multiple containers
1046
1046
  # together in a task definition, the `name` of one container can be
1047
1047
  # entered in the `links` of another container to connect the
1048
1048
  # containers. Up to 255 letters (uppercase and lowercase), numbers,
@@ -1059,8 +1059,8 @@ module Aws::ECS
1059
1059
  #
1060
1060
  # @!attribute [rw] image
1061
1061
  # The image used to start a container. This string is passed directly
1062
- # to the Docker daemon. Images in the Docker Hub registry are
1063
- # available by default. Other repositories are specified with either `
1062
+ # to the Docker daemon. By default, images in the Docker Hub registry
1063
+ # are available. Other repositories are specified with either `
1064
1064
  # repository-url/image:tag ` or ` repository-url/image@digest `. Up to
1065
1065
  # 255 letters (uppercase and lowercase), numbers, hyphens,
1066
1066
  # underscores, colons, periods, forward slashes, and number signs are
@@ -1070,7 +1070,7 @@ module Aws::ECS
1070
1070
  #
1071
1071
  # * When a new task starts, the Amazon ECS container agent pulls the
1072
1072
  # latest version of the specified image and tag for the container to
1073
- # use. However, subsequent updates to a repository image are not
1073
+ # use. However, subsequent updates to a repository image aren't
1074
1074
  # propagated to already running tasks.
1075
1075
  #
1076
1076
  # * Images in Amazon ECR repositories can be specified by either using
@@ -1121,21 +1121,21 @@ module Aws::ECS
1121
1121
  # on the container instance with the same ratio as their allocated
1122
1122
  # amount. For example, if you run a single-container task on a
1123
1123
  # single-core instance type with 512 CPU units specified for that
1124
- # container, and that is the only task running on the container
1124
+ # container, and that's the only task running on the container
1125
1125
  # instance, that container could use the full 1,024 CPU unit share at
1126
1126
  # any given time. However, if you launched another copy of the same
1127
- # task on that container instance, each task would be guaranteed a
1128
- # minimum of 512 CPU units when needed, and each container could float
1129
- # to higher CPU usage if the other container was not using it, but if
1130
- # both tasks were 100% active all of the time, they would be limited
1131
- # to 512 CPU units.
1127
+ # task on that container instance, each task is guaranteed a minimum
1128
+ # of 512 CPU units when needed. Moreover, each container could float
1129
+ # to higher CPU usage if the other container was not using it. If both
1130
+ # tasks were 100% active all of the time, they would be limited to 512
1131
+ # CPU units.
1132
1132
  #
1133
1133
  # On Linux container instances, the Docker daemon on the container
1134
1134
  # instance uses the CPU value to calculate the relative CPU share
1135
1135
  # ratios for running containers. For more information, see [CPU share
1136
1136
  # constraint][5] in the Docker documentation. The minimum valid CPU
1137
1137
  # share value that the Linux kernel allows is 2. However, the CPU
1138
- # parameter is not required, and you can use CPU values below 2 in
1138
+ # parameter isn't required, and you can use CPU values below 2 in
1139
1139
  # your container definitions. For CPU values below 2 (including null),
1140
1140
  # the behavior varies based on your Amazon ECS container agent
1141
1141
  # version:
@@ -1150,7 +1150,7 @@ module Aws::ECS
1150
1150
  #
1151
1151
  # On Windows container instances, the CPU limit is enforced as an
1152
1152
  # absolute limit, or a quota. Windows containers only have access to
1153
- # the specified amount of CPU that is described in the task
1153
+ # the specified amount of CPU that's described in the task
1154
1154
  # definition. A null or zero CPU value is passed to Docker as `0`,
1155
1155
  # which Windows interprets as 1% of one CPU.
1156
1156
  #
@@ -1179,12 +1179,12 @@ module Aws::ECS
1179
1179
  # a container-level `memory` and `memoryReservation` value, `memory`
1180
1180
  # must be greater than `memoryReservation`. If you specify
1181
1181
  # `memoryReservation`, then that value is subtracted from the
1182
- # available memory resources for the container instance on which the
1182
+ # available memory resources for the container instance where the
1183
1183
  # container is placed. Otherwise, the value of `memory` is used.
1184
1184
  #
1185
1185
  # The Docker daemon reserves a minimum of 4 MiB of memory for a
1186
- # container, so you should not specify fewer than 4 MiB of memory for
1187
- # your containers.
1186
+ # container. Therefore, we recommend that you specify fewer than 4 MiB
1187
+ # of memory for your containers.
1188
1188
  #
1189
1189
  #
1190
1190
  #
@@ -1209,7 +1209,7 @@ module Aws::ECS
1209
1209
  # in a container definition. If you specify both, `memory` must be
1210
1210
  # greater than `memoryReservation`. If you specify
1211
1211
  # `memoryReservation`, then that value is subtracted from the
1212
- # available memory resources for the container instance on which the
1212
+ # available memory resources for the container instance where the
1213
1213
  # container is placed. Otherwise, the value of `memory` is used.
1214
1214
  #
1215
1215
  # For example, if your container normally uses 128 MiB of memory, but
@@ -1221,8 +1221,8 @@ module Aws::ECS
1221
1221
  # memory resources when needed.
1222
1222
  #
1223
1223
  # The Docker daemon reserves a minimum of 4 MiB of memory for a
1224
- # container, so you should not specify fewer than 4 MiB of memory for
1225
- # your containers.
1224
+ # container. Therefore, we recommend that you specify fewer than 4 MiB
1225
+ # of memory for your containers.
1226
1226
  #
1227
1227
  #
1228
1228
  #
@@ -1265,13 +1265,13 @@ module Aws::ECS
1265
1265
  # containers to access ports on the host container instance to send or
1266
1266
  # receive traffic.
1267
1267
  #
1268
- # For task definitions that use the `awsvpc` network mode, you should
1269
- # only specify the `containerPort`. The `hostPort` can be left blank
1270
- # or it must be the same value as the `containerPort`.
1268
+ # For task definitions that use the `awsvpc` network mode, only
1269
+ # specify the `containerPort`. The `hostPort` can be left blank or it
1270
+ # must be the same value as the `containerPort`.
1271
1271
  #
1272
1272
  # Port mappings on Windows use the `NetNAT` gateway address rather
1273
- # than `localhost`. There is no loopback for port mappings on Windows,
1274
- # so you cannot access a container's mapped port from the host
1273
+ # than `localhost`. There's no loopback for port mappings on Windows,
1274
+ # so you can't access a container's mapped port from the host
1275
1275
  # itself.
1276
1276
  #
1277
1277
  # This parameter maps to `PortBindings` in the [Create a container][1]
@@ -1301,16 +1301,16 @@ module Aws::ECS
1301
1301
  # If the `essential` parameter of a container is marked as `true`, and
1302
1302
  # that container fails or stops for any reason, all other containers
1303
1303
  # that are part of the task are stopped. If the `essential` parameter
1304
- # of a container is marked as `false`, then its failure does not
1305
- # affect the rest of the containers in a task. If this parameter is
1306
- # omitted, a container is assumed to be essential.
1304
+ # of a container is marked as `false`, its failure doesn't affect the
1305
+ # rest of the containers in a task. If this parameter is omitted, a
1306
+ # container is assumed to be essential.
1307
1307
  #
1308
1308
  # All tasks must have at least one essential container. If you have an
1309
- # application that is composed of multiple containers, you should
1310
- # group containers that are used for a common purpose into components,
1311
- # and separate the different components into multiple task
1312
- # definitions. For more information, see [Application Architecture][1]
1313
- # in the *Amazon Elastic Container Service Developer Guide*.
1309
+ # application that's composed of multiple containers, group
1310
+ # containers that are used for a common purpose into components, and
1311
+ # separate the different components into multiple task definitions.
1312
+ # For more information, see [Application Architecture][1] in the
1313
+ # *Amazon Elastic Container Service Developer Guide*.
1314
1314
  #
1315
1315
  #
1316
1316
  #
@@ -1318,12 +1318,12 @@ module Aws::ECS
1318
1318
  # @return [Boolean]
1319
1319
  #
1320
1320
  # @!attribute [rw] entry_point
1321
- # Early versions of the Amazon ECS container agent do not properly
1321
+ # Early versions of the Amazon ECS container agent don't properly
1322
1322
  # handle `entryPoint` parameters. If you have problems using
1323
1323
  # `entryPoint`, update your container agent or enter your commands and
1324
1324
  # arguments as `command` array items instead.
1325
1325
  #
1326
- # The entry point that is passed to the container. This parameter maps
1326
+ # The entry point that's passed to the container. This parameter maps
1327
1327
  # to `Entrypoint` in the [Create a container][1] section of the
1328
1328
  # [Docker Remote API][2] and the `--entrypoint` option to [docker
1329
1329
  # run][3]. For more information, see
@@ -1338,13 +1338,13 @@ module Aws::ECS
1338
1338
  # @return [Array<String>]
1339
1339
  #
1340
1340
  # @!attribute [rw] command
1341
- # The command that is passed to the container. This parameter maps to
1341
+ # The command that's passed to the container. This parameter maps to
1342
1342
  # `Cmd` in the [Create a container][1] section of the [Docker Remote
1343
1343
  # API][2] and the `COMMAND` parameter to [docker run][3]. For more
1344
1344
  # information, see
1345
1345
  # [https://docs.docker.com/engine/reference/builder/#cmd][4]. If there
1346
- # are multiple arguments, each argument should be a separated string
1347
- # in the array.
1346
+ # are multiple arguments, each argument is a separated string in the
1347
+ # array.
1348
1348
  #
1349
1349
  #
1350
1350
  #
@@ -1359,7 +1359,7 @@ module Aws::ECS
1359
1359
  # maps to `Env` in the [Create a container][1] section of the [Docker
1360
1360
  # Remote API][2] and the `--env` option to [docker run][3].
1361
1361
  #
1362
- # We do not recommend using plaintext environment variables for
1362
+ # We don't recommend that you use plaintext environment variables for
1363
1363
  # sensitive information, such as credential data.
1364
1364
  #
1365
1365
  #
@@ -1375,20 +1375,20 @@ module Aws::ECS
1375
1375
  # run][1].
1376
1376
  #
1377
1377
  # You can specify up to ten environment files. The file must have a
1378
- # `.env` file extension. Each line in an environment file should
1379
- # contain an environment variable in `VARIABLE=VALUE` format. Lines
1380
- # beginning with `#` are treated as comments and are ignored. For more
1381
- # information on the environment variable file syntax, see [Declare
1378
+ # `.env` file extension. Each line in an environment file contains an
1379
+ # environment variable in `VARIABLE=VALUE` format. Lines beginning
1380
+ # with `#` are treated as comments and are ignored. For more
1381
+ # information about the environment variable file syntax, see [Declare
1382
1382
  # default environment variables in file][2].
1383
1383
  #
1384
1384
  # If there are environment variables specified using the `environment`
1385
1385
  # parameter in a container definition, they take precedence over the
1386
1386
  # variables contained within an environment file. If multiple
1387
- # environment files are specified that contain the same variable, they
1388
- # are processed from the top down. It is recommended to use unique
1389
- # variable names. For more information, see [Specifying Environment
1390
- # Variables][3] in the *Amazon Elastic Container Service Developer
1391
- # Guide*.
1387
+ # environment files are specified that contain the same variable,
1388
+ # they're processed from the top down. We recommend that you use
1389
+ # unique variable names. For more information, see [Specifying
1390
+ # Environment Variables][3] in the *Amazon Elastic Container Service
1391
+ # Developer Guide*.
1392
1392
  #
1393
1393
  #
1394
1394
  #
@@ -1405,8 +1405,8 @@ module Aws::ECS
1405
1405
  # [docker run][3].
1406
1406
  #
1407
1407
  # Windows containers can mount whole directories on the same drive as
1408
- # `$env:ProgramData`. Windows containers cannot mount directories on a
1409
- # different drive, and mount point cannot be across drives.
1408
+ # `$env:ProgramData`. Windows containers can't mount directories on a
1409
+ # different drive, and mount point can't be across drives.
1410
1410
  #
1411
1411
  #
1412
1412
  #
@@ -1459,7 +1459,7 @@ module Aws::ECS
1459
1459
  # version. For information about checking your agent version and
1460
1460
  # updating to the latest version, see [Updating the Amazon ECS
1461
1461
  # Container Agent][1] in the *Amazon Elastic Container Service
1462
- # Developer Guide*. If you are using an Amazon ECS-optimized Linux
1462
+ # Developer Guide*. If you're using an Amazon ECS-optimized Linux
1463
1463
  # AMI, your instance needs at least version 1.26.0-1 of the `ecs-init`
1464
1464
  # package. If your container instances are launched from version
1465
1465
  # `20190301` or later, then they contain the required versions of the
@@ -1468,7 +1468,11 @@ module Aws::ECS
1468
1468
  # Developer Guide*.
1469
1469
  #
1470
1470
  # For tasks using the Fargate launch type, the task or service
1471
- # requires platform version `1.3.0` or later.
1471
+ # requires the following platforms:
1472
+ #
1473
+ # * Linux platform version `1.3.0` or later.
1474
+ #
1475
+ # * Windows platform version `1.0.0` or later.
1472
1476
  #
1473
1477
  #
1474
1478
  #
@@ -1481,19 +1485,23 @@ module Aws::ECS
1481
1485
  # dependencies for a container. For example, you specify two
1482
1486
  # containers in a task definition with containerA having a dependency
1483
1487
  # on containerB reaching a `COMPLETE`, `SUCCESS`, or `HEALTHY` status.
1484
- # If a `startTimeout` value is specified for containerB and it does
1485
- # not reach the desired status within that time then containerA will
1486
- # give up and not start. This results in the task transitioning to a
1488
+ # If a `startTimeout` value is specified for containerB and it
1489
+ # doesn't reach the desired status within that time then containerA
1490
+ # gives up and not start. This results in the task transitioning to a
1487
1491
  # `STOPPED` state.
1488
1492
  #
1489
1493
  # <note markdown="1"> When the `ECS_CONTAINER_START_TIMEOUT` container agent configuration
1490
- # variable is used, it is enforced indendently from this start timeout
1491
- # value.
1494
+ # variable is used, it's enforced independently from this start
1495
+ # timeout value.
1492
1496
  #
1493
1497
  # </note>
1494
1498
  #
1495
- # For tasks using the Fargate launch type, this parameter requires
1496
- # that the task or service uses platform version 1.3.0 or later.
1499
+ # For tasks using the Fargate launch type, the task or service
1500
+ # requires the following platforms:
1501
+ #
1502
+ # * Linux platform version `1.3.0` or later.
1503
+ #
1504
+ # * Windows platform version `1.0.0` or later.
1497
1505
  #
1498
1506
  # For tasks using the EC2 launch type, your container instances
1499
1507
  # require at least version `1.26.0` of the container agent to enable a
@@ -1501,7 +1509,7 @@ module Aws::ECS
1501
1509
  # latest container agent version. For information about checking your
1502
1510
  # agent version and updating to the latest version, see [Updating the
1503
1511
  # Amazon ECS Container Agent][1] in the *Amazon Elastic Container
1504
- # Service Developer Guide*. If you are using an Amazon ECS-optimized
1512
+ # Service Developer Guide*. If you're using an Amazon ECS-optimized
1505
1513
  # Linux AMI, your instance needs at least version `1.26.0-1` of the
1506
1514
  # `ecs-init` package. If your container instances are launched from
1507
1515
  # version `20190301` or later, then they contain the required versions
@@ -1520,14 +1528,19 @@ module Aws::ECS
1520
1528
  # forcefully killed if it doesn't exit normally on its own.
1521
1529
  #
1522
1530
  # For tasks using the Fargate launch type, the task or service
1523
- # requires platform version 1.3.0 or later. The max stop timeout value
1524
- # is 120 seconds and if the parameter is not specified, the default
1525
- # value of 30 seconds is used.
1526
- #
1527
- # For tasks using the EC2 launch type, if the `stopTimeout` parameter
1528
- # is not specified, the value set for the Amazon ECS container agent
1529
- # configuration variable `ECS_CONTAINER_STOP_TIMEOUT` is used by
1530
- # default. If neither the `stopTimeout` parameter or the
1531
+ # requires the following platforms:
1532
+ #
1533
+ # * Linux platform version `1.3.0` or later.
1534
+ #
1535
+ # * Windows platform version `1.0.0` or later.
1536
+ #
1537
+ # The max stop timeout value is 120 seconds and if the parameter is
1538
+ # not specified, the default value of 30 seconds is used.
1539
+ #
1540
+ # For tasks that use the EC2 launch type, if the `stopTimeout`
1541
+ # parameter isn't specified, the value set for the Amazon ECS
1542
+ # container agent configuration variable `ECS_CONTAINER_STOP_TIMEOUT`
1543
+ # is used. If neither the `stopTimeout` parameter or the
1531
1544
  # `ECS_CONTAINER_STOP_TIMEOUT` agent configuration variable are set,
1532
1545
  # then the default values of 30 seconds for Linux containers and 30
1533
1546
  # seconds on Windows containers are used. Your container instances
@@ -1536,7 +1549,7 @@ module Aws::ECS
1536
1549
  # container agent version. For information about checking your agent
1537
1550
  # version and updating to the latest version, see [Updating the Amazon
1538
1551
  # ECS Container Agent][1] in the *Amazon Elastic Container Service
1539
- # Developer Guide*. If you are using an Amazon ECS-optimized Linux
1552
+ # Developer Guide*. If you're using an Amazon ECS-optimized Linux
1540
1553
  # AMI, your instance needs at least version 1.26.0-1 of the `ecs-init`
1541
1554
  # package. If your container instances are launched from version
1542
1555
  # `20190301` or later, then they contain the required versions of the
@@ -1555,7 +1568,7 @@ module Aws::ECS
1555
1568
  # `Hostname` in the [Create a container][1] section of the [Docker
1556
1569
  # Remote API][2] and the `--hostname` option to [docker run][3].
1557
1570
  #
1558
- # <note markdown="1"> The `hostname` parameter is not supported if you are using the
1571
+ # <note markdown="1"> The `hostname` parameter is not supported if you're using the
1559
1572
  # `awsvpc` network mode.
1560
1573
  #
1561
1574
  # </note>
@@ -1572,9 +1585,9 @@ module Aws::ECS
1572
1585
  # in the [Create a container][1] section of the [Docker Remote API][2]
1573
1586
  # and the `--user` option to [docker run][3].
1574
1587
  #
1575
- # When running tasks using the `host` network mode, you should not run
1576
- # containers using the root user (UID 0). It is considered best
1577
- # practice to use a non-root user.
1588
+ # When running tasks using the `host` network mode, don't run
1589
+ # containers using the root user (UID 0). We recommend using a
1590
+ # non-root user for better security.
1578
1591
  #
1579
1592
  # You can specify the `user` using the following formats. If
1580
1593
  # specifying a UID or GID, you must specify it as a positive integer.
@@ -1603,8 +1616,8 @@ module Aws::ECS
1603
1616
  # @return [String]
1604
1617
  #
1605
1618
  # @!attribute [rw] working_directory
1606
- # The working directory in which to run commands inside the container.
1607
- # This parameter maps to `WorkingDir` in the [Create a container][1]
1619
+ # The working directory to run commands inside the container in. This
1620
+ # parameter maps to `WorkingDir` in the [Create a container][1]
1608
1621
  # section of the [Docker Remote API][2] and the `--workdir` option to
1609
1622
  # [docker run][3].
1610
1623
  #
@@ -1706,7 +1719,7 @@ module Aws::ECS
1706
1719
  # `ExtraHosts` in the [Create a container][1] section of the [Docker
1707
1720
  # Remote API][2] and the `--add-host` option to [docker run][3].
1708
1721
  #
1709
- # <note markdown="1"> This parameter is not supported for Windows containers or tasks that
1722
+ # <note markdown="1"> This parameter isn't supported for Windows containers or tasks that
1710
1723
  # use the `awsvpc` network mode.
1711
1724
  #
1712
1725
  # </note>
@@ -1720,7 +1733,7 @@ module Aws::ECS
1720
1733
  #
1721
1734
  # @!attribute [rw] docker_security_options
1722
1735
  # A list of strings to provide custom labels for SELinux and AppArmor
1723
- # multi-level security systems. This field is not valid for containers
1736
+ # multi-level security systems. This field isn't valid for containers
1724
1737
  # in tasks using the Fargate launch type.
1725
1738
  #
1726
1739
  # With Windows containers, this parameter can be used to reference a
@@ -1758,11 +1771,11 @@ module Aws::ECS
1758
1771
  # @return [Array<String>]
1759
1772
  #
1760
1773
  # @!attribute [rw] interactive
1761
- # When this parameter is `true`, this allows you to deploy
1762
- # containerized applications that require `stdin` or a `tty` to be
1763
- # allocated. This parameter maps to `OpenStdin` in the [Create a
1764
- # container][1] section of the [Docker Remote API][2] and the
1765
- # `--interactive` option to [docker run][3].
1774
+ # When this parameter is `true`, you can deploy containerized
1775
+ # applications that require `stdin` or a `tty` to be allocated. This
1776
+ # parameter maps to `OpenStdin` in the [Create a container][1] section
1777
+ # of the [Docker Remote API][2] and the `--interactive` option to
1778
+ # [docker run][3].
1766
1779
  #
1767
1780
  #
1768
1781
  #
@@ -1802,8 +1815,8 @@ module Aws::ECS
1802
1815
  #
1803
1816
  # @!attribute [rw] ulimits
1804
1817
  # A list of `ulimits` to set in the container. If a ulimit value is
1805
- # specified in a task definition, it will override the default values
1806
- # set by Docker. This parameter maps to `Ulimits` in the [Create a
1818
+ # specified in a task definition, it overrides the default values set
1819
+ # by Docker. This parameter maps to `Ulimits` in the [Create a
1807
1820
  # container][1] section of the [Docker Remote API][2] and the
1808
1821
  # `--ulimit` option to [docker run][3]. Valid naming values are
1809
1822
  # displayed in the Ulimit data type.
@@ -1838,12 +1851,12 @@ module Aws::ECS
1838
1851
  # This parameter maps to `LogConfig` in the [Create a container][1]
1839
1852
  # section of the [Docker Remote API][2] and the `--log-driver` option
1840
1853
  # to [docker run][3]. By default, containers use the same logging
1841
- # driver that the Docker daemon uses. However the container may use a
1854
+ # driver that the Docker daemon uses. However the container can use a
1842
1855
  # different logging driver than the Docker daemon by specifying a log
1843
1856
  # driver with this parameter in the container definition. To use a
1844
1857
  # different logging driver for a container, the log system must be
1845
1858
  # configured properly on the container instance (or on a different log
1846
- # server for remote logging options). For more information on the
1859
+ # server for remote logging options). For more information about the
1847
1860
  # options for different supported log drivers, see [Configure logging
1848
1861
  # drivers][4] in the Docker documentation.
1849
1862
  #
@@ -1898,10 +1911,10 @@ module Aws::ECS
1898
1911
  # of the [Docker Remote API][2] and the `--sysctl` option to [docker
1899
1912
  # run][3].
1900
1913
  #
1901
- # <note markdown="1"> It is not recommended that you specify network-related
1914
+ # <note markdown="1"> We don't recommended that you specify network-related
1902
1915
  # `systemControls` parameters for multiple containers in a single task
1903
1916
  # that also uses either the `awsvpc` or `host` network modes. For
1904
- # tasks that use the `awsvpc` network mode, the container that is
1917
+ # tasks that use the `awsvpc` network mode, the container that's
1905
1918
  # started last determines which `systemControls` parameters take
1906
1919
  # effect. For tasks that use the `host` network mode, it changes the
1907
1920
  # container instance's namespaced kernel parameters as well as the
@@ -1987,7 +2000,7 @@ module Aws::ECS
1987
2000
  # recommend using the latest container agent version. For information
1988
2001
  # about checking your agent version and updating to the latest version,
1989
2002
  # see [Updating the Amazon ECS Container Agent][1] in the *Amazon
1990
- # Elastic Container Service Developer Guide*. If you are using an Amazon
2003
+ # Elastic Container Service Developer Guide*. If you're using an Amazon
1991
2004
  # ECS-optimized Linux AMI, your instance needs at least version 1.26.0-1
1992
2005
  # of the `ecs-init` package. If your container instances are launched
1993
2006
  # from version `20190301` or later, then they contain the required
@@ -1995,8 +2008,12 @@ module Aws::ECS
1995
2008
  # see [Amazon ECS-optimized Linux AMI][2] in the *Amazon Elastic
1996
2009
  # Container Service Developer Guide*.
1997
2010
  #
1998
- # <note markdown="1"> For tasks using the Fargate launch type, this parameter requires that
1999
- # the task or service uses platform version 1.3.0 or later.
2011
+ # <note markdown="1"> For tasks that use the Fargate launch type, the task or service
2012
+ # requires the following platforms:
2013
+ #
2014
+ # * Linux platform version `1.3.0` or later.
2015
+ #
2016
+ # * Windows platform version `1.0.0` or later.
2000
2017
  #
2001
2018
  # </note>
2002
2019
  #
@@ -2028,12 +2045,12 @@ module Aws::ECS
2028
2045
  # * `COMPLETE` - This condition validates that a dependent container
2029
2046
  # runs to completion (exits) before permitting other containers to
2030
2047
  # start. This can be useful for nonessential containers that run a
2031
- # script and then exit. This condition cannot be set on an essential
2048
+ # script and then exit. This condition can't be set on an essential
2032
2049
  # container.
2033
2050
  #
2034
2051
  # * `SUCCESS` - This condition is the same as `COMPLETE`, but it also
2035
2052
  # requires that the container exits with a `zero` status. This
2036
- # condition cannot be set on an essential container.
2053
+ # condition can't be set on an essential container.
2037
2054
  #
2038
2055
  # * `HEALTHY` - This condition validates that the dependent container
2039
2056
  # passes its Docker health check before permitting other containers
@@ -2051,7 +2068,7 @@ module Aws::ECS
2051
2068
  include Aws::Structure
2052
2069
  end
2053
2070
 
2054
- # An EC2 instance that is running the Amazon ECS agent and has been
2071
+ # An EC2 instance that's running the Amazon ECS agent and has been
2055
2072
  # registered with a cluster.
2056
2073
  #
2057
2074
  # @!attribute [rw] container_instance_arn
@@ -2071,13 +2088,14 @@ module Aws::ECS
2071
2088
  # @return [String]
2072
2089
  #
2073
2090
  # @!attribute [rw] capacity_provider_name
2074
- # The capacity provider associated with the container instance.
2091
+ # The capacity provider that's associated with the container
2092
+ # instance.
2075
2093
  # @return [String]
2076
2094
  #
2077
2095
  # @!attribute [rw] version
2078
2096
  # The version counter for the container instance. Every time a
2079
2097
  # container instance experiences a change that triggers a CloudWatch
2080
- # event, the version counter is incremented. If you are replicating
2098
+ # event, the version counter is incremented. If you're replicating
2081
2099
  # your Amazon ECS container instance state with CloudWatch Events, you
2082
2100
  # can compare the version of a container instance reported by the
2083
2101
  # Amazon ECS APIs with the version reported in CloudWatch Events for
@@ -2092,12 +2110,12 @@ module Aws::ECS
2092
2110
  #
2093
2111
  # @!attribute [rw] remaining_resources
2094
2112
  # For CPU and memory resource types, this parameter describes the
2095
- # remaining CPU and memory that has not already been allocated to
2096
- # tasks and is therefore available for new tasks. For port resource
2097
- # types, this parameter describes the ports that were reserved by the
2098
- # Amazon ECS container agent (at instance registration time) and any
2099
- # task containers that have reserved port mappings on the host (with
2100
- # the `host` or `bridge` network mode). Any port that is not specified
2113
+ # remaining CPU and memory that wasn't already allocated to tasks and
2114
+ # is therefore available for new tasks. For port resource types, this
2115
+ # parameter describes the ports that were reserved by the Amazon ECS
2116
+ # container agent (at instance registration time) and any task
2117
+ # containers that have reserved port mappings on the host (with the
2118
+ # `host` or `bridge` network mode). Any port that's not specified
2101
2119
  # here is available for new tasks.
2102
2120
  # @return [Array<Types::Resource>]
2103
2121
  #
@@ -2130,7 +2148,7 @@ module Aws::ECS
2130
2148
  # status.
2131
2149
  #
2132
2150
  # The `ACTIVE` status indicates that the container instance can accept
2133
- # tasks. The `DRAINING` indicates that new tasks are not placed on the
2151
+ # tasks. The `DRAINING` indicates that new tasks aren't placed on the
2134
2152
  # container instance and any service tasks running on the container
2135
2153
  # instance are removed if possible. For more information, see
2136
2154
  # [Container Instance Draining][1] in the *Amazon Elastic Container
@@ -2163,8 +2181,8 @@ module Aws::ECS
2163
2181
  # @return [Integer]
2164
2182
  #
2165
2183
  # @!attribute [rw] agent_update_status
2166
- # The status of the most recent agent update. If an update has never
2167
- # been requested, this value is `NULL`.
2184
+ # The status of the most recent agent update. If an update wasn't
2185
+ # ever requested, this value is `NULL`.
2168
2186
  # @return [String]
2169
2187
  #
2170
2188
  # @!attribute [rw] attributes
@@ -2174,7 +2192,8 @@ module Aws::ECS
2174
2192
  # @return [Array<Types::Attribute>]
2175
2193
  #
2176
2194
  # @!attribute [rw] registered_at
2177
- # The Unix timestamp for when the container instance was registered.
2195
+ # The Unix timestamp for the time when the container instance was
2196
+ # registered.
2178
2197
  # @return [Time]
2179
2198
  #
2180
2199
  # @!attribute [rw] attachments
@@ -2185,7 +2204,7 @@ module Aws::ECS
2185
2204
  # @!attribute [rw] tags
2186
2205
  # The metadata that you apply to the container instance to help you
2187
2206
  # categorize and organize them. Each tag consists of a key and an
2188
- # optional value, both of which you define.
2207
+ # optional value. You define both.
2189
2208
  #
2190
2209
  # The following basic restrictions apply to tags:
2191
2210
  #
@@ -2213,6 +2232,10 @@ module Aws::ECS
2213
2232
  # against your tags per resource limit.
2214
2233
  # @return [Array<Types::Tag>]
2215
2234
  #
2235
+ # @!attribute [rw] health_status
2236
+ # An object representing the health status of the container instance.
2237
+ # @return [Types::ContainerInstanceHealthStatus]
2238
+ #
2216
2239
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/ContainerInstance AWS API Documentation
2217
2240
  #
2218
2241
  class ContainerInstance < Struct.new(
@@ -2232,15 +2255,37 @@ module Aws::ECS
2232
2255
  :attributes,
2233
2256
  :registered_at,
2234
2257
  :attachments,
2235
- :tags)
2258
+ :tags,
2259
+ :health_status)
2260
+ SENSITIVE = []
2261
+ include Aws::Structure
2262
+ end
2263
+
2264
+ # An object representing the health status of the container instance.
2265
+ #
2266
+ # @!attribute [rw] overall_status
2267
+ # The overall health status of the container instance. This is an
2268
+ # aggregate status of all container instance health checks.
2269
+ # @return [String]
2270
+ #
2271
+ # @!attribute [rw] details
2272
+ # An array of objects representing the details of the container
2273
+ # instance health status.
2274
+ # @return [Array<Types::InstanceHealthCheckResult>]
2275
+ #
2276
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/ContainerInstanceHealthStatus AWS API Documentation
2277
+ #
2278
+ class ContainerInstanceHealthStatus < Struct.new(
2279
+ :overall_status,
2280
+ :details)
2236
2281
  SENSITIVE = []
2237
2282
  include Aws::Structure
2238
2283
  end
2239
2284
 
2240
- # The overrides that should be sent to a container. An empty container
2285
+ # The overrides that are sent to a container. An empty container
2241
2286
  # override can be passed in. An example of an empty container override
2242
- # would be `\{"containerOverrides": [ ] \}`. If a non-empty container
2243
- # override is specified, the `name` parameter must be included.
2287
+ # is `\{"containerOverrides": [ ] \}`. If a non-empty container override
2288
+ # is specified, the `name` parameter must be included.
2244
2289
  #
2245
2290
  # @note When making an API call, you may pass ContainerOverride
2246
2291
  # data as a hash:
@@ -2335,7 +2380,7 @@ module Aws::ECS
2335
2380
  include Aws::Structure
2336
2381
  end
2337
2382
 
2338
- # An object representing a change in state for a container.
2383
+ # An object that represents a change in state for a container.
2339
2384
  #
2340
2385
  # @note When making an API call, you may pass ContainerStateChange
2341
2386
  # data as a hash:
@@ -2375,7 +2420,7 @@ module Aws::ECS
2375
2420
  # @return [Integer]
2376
2421
  #
2377
2422
  # @!attribute [rw] network_bindings
2378
- # Any network bindings associated with the container.
2423
+ # Any network bindings that are associated with the container.
2379
2424
  # @return [Array<Types::NetworkBinding>]
2380
2425
  #
2381
2426
  # @!attribute [rw] reason
@@ -2425,10 +2470,10 @@ module Aws::ECS
2425
2470
  # }
2426
2471
  #
2427
2472
  # @!attribute [rw] name
2428
- # The name of the capacity provider. Up to 255 characters are allowed,
2429
- # including letters (upper and lowercase), numbers, underscores, and
2430
- # hyphens. The name cannot be prefixed with "`aws`", "`ecs`", or
2431
- # "`fargate`".
2473
+ # The name of the capacity provider. Up to 255 characters are allowed.
2474
+ # They include letters (both upper and lowercase letters), numbers,
2475
+ # underscores (\_), and hyphens (-). The name can't be prefixed with
2476
+ # "`aws`", "`ecs`", or "`fargate`".
2432
2477
  # @return [String]
2433
2478
  #
2434
2479
  # @!attribute [rw] auto_scaling_group_provider
@@ -2436,9 +2481,9 @@ module Aws::ECS
2436
2481
  # @return [Types::AutoScalingGroupProvider]
2437
2482
  #
2438
2483
  # @!attribute [rw] tags
2439
- # The metadata that you apply to the capacity provider to help you
2440
- # categorize and organize them. Each tag consists of a key and an
2441
- # optional value, both of which you define.
2484
+ # The metadata that you apply to the capacity provider to categorize
2485
+ # and organize them more conveniently. Each tag consists of a key and
2486
+ # an optional value. You define both of them.
2442
2487
  #
2443
2488
  # The following basic restrictions apply to tags:
2444
2489
  #
@@ -2529,16 +2574,16 @@ module Aws::ECS
2529
2574
  # }
2530
2575
  #
2531
2576
  # @!attribute [rw] cluster_name
2532
- # The name of your cluster. If you do not specify a name for your
2533
- # cluster, you create a cluster named `default`. Up to 255 letters
2534
- # (uppercase and lowercase), numbers, underscores, and hyphens are
2535
- # allowed.
2577
+ # The name of your cluster. If you don't specify a name for your
2578
+ # cluster, you create a cluster that's named `default`. Up to 255
2579
+ # letters (uppercase and lowercase), numbers, underscores, and hyphens
2580
+ # are allowed.
2536
2581
  # @return [String]
2537
2582
  #
2538
2583
  # @!attribute [rw] tags
2539
2584
  # The metadata that you apply to the cluster to help you categorize
2540
- # and organize them. Each tag consists of a key and an optional value,
2541
- # both of which you define.
2585
+ # and organize them. Each tag consists of a key and an optional value.
2586
+ # You define both.
2542
2587
  #
2543
2588
  # The following basic restrictions apply to tags:
2544
2589
  #
@@ -2569,8 +2614,8 @@ module Aws::ECS
2569
2614
  # @!attribute [rw] settings
2570
2615
  # The setting to use when creating a cluster. This parameter is used
2571
2616
  # to enable CloudWatch Container Insights for a cluster. If this value
2572
- # is specified, it will override the `containerInsights` value set
2573
- # with PutAccountSetting or PutAccountSettingDefault.
2617
+ # is specified, it overrides the `containerInsights` value set with
2618
+ # PutAccountSetting or PutAccountSettingDefault.
2574
2619
  # @return [Array<Types::ClusterSetting>]
2575
2620
  #
2576
2621
  # @!attribute [rw] configuration
@@ -2585,10 +2630,9 @@ module Aws::ECS
2585
2630
  # calling the CreateService or RunTask actions.
2586
2631
  #
2587
2632
  # If specifying a capacity provider that uses an Auto Scaling group,
2588
- # the capacity provider must already be created and not already
2589
- # associated with another cluster. New Auto Scaling group capacity
2590
- # providers can be created with the CreateCapacityProvider API
2591
- # operation.
2633
+ # the capacity provider must be created but not associated with
2634
+ # another cluster. New Auto Scaling group capacity providers can be
2635
+ # created with the CreateCapacityProvider API operation.
2592
2636
  #
2593
2637
  # To use a Fargate capacity provider, specify either the `FARGATE` or
2594
2638
  # `FARGATE_SPOT` capacity providers. The Fargate capacity providers
@@ -2602,13 +2646,13 @@ module Aws::ECS
2602
2646
  #
2603
2647
  # @!attribute [rw] default_capacity_provider_strategy
2604
2648
  # The capacity provider strategy to set as the default for the
2605
- # cluster. When a default capacity provider strategy is set for a
2606
- # cluster, when calling the RunTask or CreateService APIs with no
2649
+ # cluster. After a default capacity provider strategy is set for a
2650
+ # cluster, when you call the RunTask or CreateService APIs with no
2607
2651
  # capacity provider strategy or launch type specified, the default
2608
2652
  # capacity provider strategy for the cluster is used.
2609
2653
  #
2610
- # If a default capacity provider strategy is not defined for a cluster
2611
- # during creation, it can be defined later with the
2654
+ # If a default capacity provider strategy isn't defined for a cluster
2655
+ # when it was created, it can be defined later with the
2612
2656
  # PutClusterCapacityProviders API operation.
2613
2657
  # @return [Array<Types::CapacityProviderStrategyItem>]
2614
2658
  #
@@ -2716,8 +2760,8 @@ module Aws::ECS
2716
2760
  # }
2717
2761
  #
2718
2762
  # @!attribute [rw] cluster
2719
- # The short name or full Amazon Resource Name (ARN) of the cluster on
2720
- # which to run your service. If you do not specify a cluster, the
2763
+ # The short name or full Amazon Resource Name (ARN) of the cluster
2764
+ # that you run your service on. If you do not specify a cluster, the
2721
2765
  # default cluster is assumed.
2722
2766
  # @return [String]
2723
2767
  #
@@ -2731,11 +2775,11 @@ module Aws::ECS
2731
2775
  #
2732
2776
  # @!attribute [rw] task_definition
2733
2777
  # The `family` and `revision` (`family:revision`) or full ARN of the
2734
- # task definition to run in your service. If a `revision` is not
2778
+ # task definition to run in your service. If a `revision` isn't
2735
2779
  # specified, the latest `ACTIVE` revision is used.
2736
2780
  #
2737
- # A task definition must be specified if the service is using either
2738
- # the `ECS` or `CODE_DEPLOY` deployment controllers.
2781
+ # A task definition must be specified if the service uses either the
2782
+ # `ECS` or `CODE_DEPLOY` deployment controllers.
2739
2783
  # @return [String]
2740
2784
  #
2741
2785
  # @!attribute [rw] load_balancers
@@ -2743,56 +2787,57 @@ module Aws::ECS
2743
2787
  # your service. For more information, see [Service Load Balancing][1]
2744
2788
  # in the *Amazon Elastic Container Service Developer Guide*.
2745
2789
  #
2746
- # If the service is using the rolling update (`ECS`) deployment
2747
- # controller and using either an Application Load Balancer or Network
2748
- # Load Balancer, you must specify one or more target group ARNs to
2749
- # attach to the service. The service-linked role is required for
2750
- # services that make use of multiple target groups. For more
2751
- # information, see [Using service-linked roles for Amazon ECS][2] in
2752
- # the *Amazon Elastic Container Service Developer Guide*.
2790
+ # If the service uses the rolling update (`ECS`) deployment controller
2791
+ # and using either an Application Load Balancer or Network Load
2792
+ # Balancer, you must specify one or more target group ARNs to attach
2793
+ # to the service. The service-linked role is required for services
2794
+ # that use multiple target groups. For more information, see [Using
2795
+ # service-linked roles for Amazon ECS][2] in the *Amazon Elastic
2796
+ # Container Service Developer Guide*.
2753
2797
  #
2754
- # If the service is using the `CODE_DEPLOY` deployment controller, the
2798
+ # If the service uses the `CODE_DEPLOY` deployment controller, the
2755
2799
  # service is required to use either an Application Load Balancer or
2756
2800
  # Network Load Balancer. When creating an CodeDeploy deployment group,
2757
2801
  # you specify two target groups (referred to as a `targetGroupPair`).
2758
2802
  # During a deployment, CodeDeploy determines which task set in your
2759
- # service has the status `PRIMARY` and associates one target group
2760
- # with it, and then associates the other target group with the
2803
+ # service has the status `PRIMARY`, and it associates one target group
2804
+ # with it. Then, it also associates the other target group with the
2761
2805
  # replacement task set. The load balancer can also have up to two
2762
2806
  # listeners: a required listener for production traffic and an
2763
- # optional listener that allows you perform validation tests with
2807
+ # optional listener that you can use to perform validation tests with
2764
2808
  # Lambda functions before routing production traffic to it.
2765
2809
  #
2766
2810
  # After you create a service using the `ECS` deployment controller,
2767
2811
  # the load balancer name or target group ARN, container name, and
2768
- # container port specified in the service definition are immutable. If
2769
- # you are using the `CODE_DEPLOY` deployment controller, these values
2770
- # can be changed when updating the service.
2812
+ # container port that's specified in the service definition are
2813
+ # immutable. If you use the `CODE_DEPLOY` deployment controller, these
2814
+ # values can be changed when updating the service.
2771
2815
  #
2772
2816
  # For Application Load Balancers and Network Load Balancers, this
2773
2817
  # object must contain the load balancer target group ARN, the
2774
- # container name (as it appears in a container definition), and the
2775
- # container port to access from the load balancer. The load balancer
2776
- # name parameter must be omitted. When a task from this service is
2777
- # placed on a container instance, the container instance and port
2778
- # combination is registered as a target in the target group specified
2779
- # here.
2818
+ # container name, and the container port to access from the load
2819
+ # balancer. The container name must be as it appears in a container
2820
+ # definition. The load balancer name parameter must be omitted. When a
2821
+ # task from this service is placed on a container instance, the
2822
+ # container instance and port combination is registered as a target in
2823
+ # the target group that's specified here.
2780
2824
  #
2781
2825
  # For Classic Load Balancers, this object must contain the load
2782
- # balancer name, the container name (as it appears in a container
2783
- # definition), and the container port to access from the load
2784
- # balancer. The target group ARN parameter must be omitted. When a
2785
- # task from this service is placed on a container instance, the
2786
- # container instance is registered with the load balancer specified
2787
- # here.
2826
+ # balancer name, the container name , and the container port to access
2827
+ # from the load balancer. The container name must be as it appears in
2828
+ # a container definition. The target group ARN parameter must be
2829
+ # omitted. When a task from this service is placed on a container
2830
+ # instance, the container instance is registered with the load
2831
+ # balancer that's specified here.
2788
2832
  #
2789
2833
  # Services with tasks that use the `awsvpc` network mode (for example,
2790
2834
  # those with the Fargate launch type) only support Application Load
2791
- # Balancers and Network Load Balancers. Classic Load Balancers are not
2835
+ # Balancers and Network Load Balancers. Classic Load Balancers aren't
2792
2836
  # supported. Also, when you create any target groups for these
2793
- # services, you must choose `ip` as the target type, not `instance`,
2794
- # because tasks that use the `awsvpc` network mode are associated with
2795
- # an elastic network interface, not an Amazon EC2 instance.
2837
+ # services, you must choose `ip` as the target type, not `instance`.
2838
+ # This is because tasks that use the `awsvpc` network mode are
2839
+ # associated with an elastic network interface, not an Amazon EC2
2840
+ # instance.
2796
2841
  #
2797
2842
  #
2798
2843
  #
@@ -2805,7 +2850,7 @@ module Aws::ECS
2805
2850
  # service. For more information, see [Service discovery][1].
2806
2851
  #
2807
2852
  # <note markdown="1"> Each service may be associated with one service registry. Multiple
2808
- # service registries per service isn't supported.
2853
+ # service registries for each service isn't supported.
2809
2854
  #
2810
2855
  # </note>
2811
2856
  #
@@ -2818,18 +2863,19 @@ module Aws::ECS
2818
2863
  # The number of instantiations of the specified task definition to
2819
2864
  # place and keep running on your cluster.
2820
2865
  #
2821
- # This is required if `schedulingStrategy` is `REPLICA` or is not
2822
- # specified. If `schedulingStrategy` is `DAEMON` then this is not
2866
+ # This is required if `schedulingStrategy` is `REPLICA` or isn't
2867
+ # specified. If `schedulingStrategy` is `DAEMON` then this isn't
2823
2868
  # required.
2824
2869
  # @return [Integer]
2825
2870
  #
2826
2871
  # @!attribute [rw] client_token
2827
- # Unique, case-sensitive identifier that you provide to ensure the
2828
- # idempotency of the request. Up to 32 ASCII characters are allowed.
2872
+ # An identifier that you provide to ensure the idempotency of the
2873
+ # request. It must be unique and is case sensitive. Up to 32 ASCII
2874
+ # characters are allowed.
2829
2875
  # @return [String]
2830
2876
  #
2831
2877
  # @!attribute [rw] launch_type
2832
- # The infrastructure on which to run your service. For more
2878
+ # The infrastructure that you run your service on. For more
2833
2879
  # information, see [Amazon ECS launch types][1] in the *Amazon Elastic
2834
2880
  # Container Service Developer Guide*.
2835
2881
  #
@@ -2845,8 +2891,8 @@ module Aws::ECS
2845
2891
  # The `EC2` launch type runs your tasks on Amazon EC2 instances
2846
2892
  # registered to your cluster.
2847
2893
  #
2848
- # The `EXTERNAL` launch type runs your tasks on your on-premise server
2849
- # or virtual machine (VM) capacity registered to your cluster.
2894
+ # The `EXTERNAL` launch type runs your tasks on your on-premises
2895
+ # server or virtual machine (VM) capacity registered to your cluster.
2850
2896
  #
2851
2897
  # A service can use either a launch type or a capacity provider
2852
2898
  # strategy. If a `launchType` is specified, the
@@ -2874,9 +2920,8 @@ module Aws::ECS
2874
2920
  # The platform version that your tasks in the service are running on.
2875
2921
  # A platform version is specified only for tasks using the Fargate
2876
2922
  # launch type. If one isn't specified, the `LATEST` platform version
2877
- # is used by default. For more information, see [Fargate platform
2878
- # versions][1] in the *Amazon Elastic Container Service Developer
2879
- # Guide*.
2923
+ # is used. For more information, see [Fargate platform versions][1] in
2924
+ # the *Amazon Elastic Container Service Developer Guide*.
2880
2925
  #
2881
2926
  #
2882
2927
  #
@@ -2887,20 +2932,20 @@ module Aws::ECS
2887
2932
  # The name or full Amazon Resource Name (ARN) of the IAM role that
2888
2933
  # allows Amazon ECS to make calls to your load balancer on your
2889
2934
  # behalf. This parameter is only permitted if you are using a load
2890
- # balancer with your service and your task definition does not use the
2935
+ # balancer with your service and your task definition doesn't use the
2891
2936
  # `awsvpc` network mode. If you specify the `role` parameter, you must
2892
2937
  # also specify a load balancer object with the `loadBalancers`
2893
2938
  # parameter.
2894
2939
  #
2895
2940
  # If your account has already created the Amazon ECS service-linked
2896
- # role, that role is used by default for your service unless you
2897
- # specify a role here. The service-linked role is required if your
2898
- # task definition uses the `awsvpc` network mode or if the service is
2899
- # configured to use service discovery, an external deployment
2900
- # controller, multiple target groups, or Elastic Inference
2901
- # accelerators in which case you should not specify a role here. For
2902
- # more information, see [Using service-linked roles for Amazon ECS][1]
2903
- # in the *Amazon Elastic Container Service Developer Guide*.
2941
+ # role, that role is used for your service unless you specify a role
2942
+ # here. The service-linked role is required if your task definition
2943
+ # uses the `awsvpc` network mode or if the service is configured to
2944
+ # use service discovery, an external deployment controller, multiple
2945
+ # target groups, or Elastic Inference accelerators in which case you
2946
+ # don't specify a role here. For more information, see [Using
2947
+ # service-linked roles for Amazon ECS][1] in the *Amazon Elastic
2948
+ # Container Service Developer Guide*.
2904
2949
  #
2905
2950
  # If your specified role has a path other than `/`, then you must
2906
2951
  # either specify the full role ARN (this is recommended) or prefix the
@@ -2923,20 +2968,20 @@ module Aws::ECS
2923
2968
  #
2924
2969
  # @!attribute [rw] placement_constraints
2925
2970
  # An array of placement constraint objects to use for tasks in your
2926
- # service. You can specify a maximum of 10 constraints per task (this
2927
- # limit includes constraints in the task definition and those
2928
- # specified at runtime).
2971
+ # service. You can specify a maximum of 10 constraints for each task.
2972
+ # This limit includes constraints in the task definition and those
2973
+ # specified at runtime.
2929
2974
  # @return [Array<Types::PlacementConstraint>]
2930
2975
  #
2931
2976
  # @!attribute [rw] placement_strategy
2932
2977
  # The placement strategy objects to use for tasks in your service. You
2933
- # can specify a maximum of 5 strategy rules per service.
2978
+ # can specify a maximum of 5 strategy rules for each service.
2934
2979
  # @return [Array<Types::PlacementStrategy>]
2935
2980
  #
2936
2981
  # @!attribute [rw] network_configuration
2937
2982
  # The network configuration for the service. This parameter is
2938
2983
  # required for task definitions that use the `awsvpc` network mode to
2939
- # receive their own elastic network interface, and it is not supported
2984
+ # receive their own elastic network interface, and it isn't supported
2940
2985
  # for other network modes. For more information, see [Task
2941
2986
  # networking][1] in the *Amazon Elastic Container Service Developer
2942
2987
  # Guide*.
@@ -2948,18 +2993,19 @@ module Aws::ECS
2948
2993
  #
2949
2994
  # @!attribute [rw] health_check_grace_period_seconds
2950
2995
  # The period of time, in seconds, that the Amazon ECS service
2951
- # scheduler should ignore unhealthy Elastic Load Balancing target
2952
- # health checks after a task has first started. This is only used when
2953
- # your service is configured to use a load balancer. If your service
2954
- # has a load balancer defined and you don't specify a health check
2955
- # grace period value, the default value of `0` is used.
2996
+ # scheduler ignores unhealthy Elastic Load Balancing target health
2997
+ # checks after a task has first started. This is only used when your
2998
+ # service is configured to use a load balancer. If your service has a
2999
+ # load balancer defined and you don't specify a health check grace
3000
+ # period value, the default value of `0` is used.
2956
3001
  #
2957
3002
  # If your service's tasks take a while to start and respond to
2958
3003
  # Elastic Load Balancing health checks, you can specify a health check
2959
- # grace period of up to 2,147,483,647 seconds. During that time, the
2960
- # Amazon ECS service scheduler ignores health check status. This grace
2961
- # period can prevent the service scheduler from marking tasks as
2962
- # unhealthy and stopping them before they have time to come up.
3004
+ # grace period of up to 2,147,483,647 seconds (about 69 years). During
3005
+ # that time, the Amazon ECS service scheduler ignores health check
3006
+ # status. This grace period can prevent the service scheduler from
3007
+ # marking tasks as unhealthy and stopping them before they have time
3008
+ # to come up.
2963
3009
  # @return [Integer]
2964
3010
  #
2965
3011
  # @!attribute [rw] scheduling_strategy
@@ -2973,14 +3019,14 @@ module Aws::ECS
2973
3019
  # service scheduler spreads tasks across Availability Zones. You can
2974
3020
  # use task placement strategies and constraints to customize task
2975
3021
  # placement decisions. This scheduler strategy is required if the
2976
- # service is using the `CODE_DEPLOY` or `EXTERNAL` deployment
2977
- # controller types.
3022
+ # service uses the `CODE_DEPLOY` or `EXTERNAL` deployment controller
3023
+ # types.
2978
3024
  #
2979
3025
  # * `DAEMON`-The daemon scheduling strategy deploys exactly one task
2980
3026
  # on each active container instance that meets all of the task
2981
3027
  # placement constraints that you specify in your cluster. The
2982
3028
  # service scheduler also evaluates the task placement constraints
2983
- # for running tasks and will stop tasks that do not meet the
3029
+ # for running tasks and will stop tasks that don't meet the
2984
3030
  # placement constraints. When you're using this strategy, you
2985
3031
  # don't need to specify a desired number of tasks, a task placement
2986
3032
  # strategy, or use Service Auto Scaling policies.
@@ -3047,16 +3093,16 @@ module Aws::ECS
3047
3093
  # @!attribute [rw] propagate_tags
3048
3094
  # Specifies whether to propagate the tags from the task definition or
3049
3095
  # the service to the tasks in the service. If no value is specified,
3050
- # the tags are not propagated. Tags can only be propagated to the
3096
+ # the tags aren't propagated. Tags can only be propagated to the
3051
3097
  # tasks within the service during service creation. To add tags to a
3052
3098
  # task after service creation or task creation, use the TagResource
3053
3099
  # API action.
3054
3100
  # @return [String]
3055
3101
  #
3056
3102
  # @!attribute [rw] enable_execute_command
3057
- # Whether or not the execute command functionality is enabled for the
3058
- # service. If `true`, this enables execute command functionality on
3059
- # all containers in the service tasks.
3103
+ # Determines whether the execute command functionality is enabled for
3104
+ # the service. If `true`, this enables execute command functionality
3105
+ # on all containers in the service tasks.
3060
3106
  # @return [Boolean]
3061
3107
  #
3062
3108
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/CreateServiceRequest AWS API Documentation
@@ -3092,14 +3138,14 @@ module Aws::ECS
3092
3138
  # The full description of your service following the create call.
3093
3139
  #
3094
3140
  # A service will return either a `capacityProviderStrategy` or
3095
- # `launchType` parameter, but not both, depending on which one was
3096
- # specified during creation.
3141
+ # `launchType` parameter, but not both, depending where one was
3142
+ # specified when it was created.
3097
3143
  #
3098
3144
  # If a service is using the `ECS` deployment controller, the
3099
3145
  # `deploymentController` and `taskSets` parameters will not be
3100
3146
  # returned.
3101
3147
  #
3102
- # If the service is using the `CODE_DEPLOY` deployment controller, the
3148
+ # if the service uses the `CODE_DEPLOY` deployment controller, the
3103
3149
  # `deploymentController`, `taskSets` and `deployments` parameters will
3104
3150
  # be returned, however the `deployments` parameter will be an empty
3105
3151
  # list.
@@ -3208,7 +3254,7 @@ module Aws::ECS
3208
3254
  # @return [Array<Types::ServiceRegistry>]
3209
3255
  #
3210
3256
  # @!attribute [rw] launch_type
3211
- # The launch type that new tasks in the task set will use. For more
3257
+ # The launch type that new tasks in the task set uses. For more
3212
3258
  # information, see [Amazon ECS Launch Types][1] in the *Amazon Elastic
3213
3259
  # Container Service Developer Guide*.
3214
3260
  #
@@ -3251,10 +3297,9 @@ module Aws::ECS
3251
3297
  # @return [Array<Types::CapacityProviderStrategyItem>]
3252
3298
  #
3253
3299
  # @!attribute [rw] platform_version
3254
- # The platform version that the tasks in the task set should use. A
3255
- # platform version is specified only for tasks using the Fargate
3256
- # launch type. If one isn't specified, the `LATEST` platform version
3257
- # is used by default.
3300
+ # The platform version that the tasks in the task set uses. A platform
3301
+ # version is specified only for tasks using the Fargate launch type.
3302
+ # If one isn't specified, the `LATEST` platform version is used.
3258
3303
  # @return [String]
3259
3304
  #
3260
3305
  # @!attribute [rw] scale
@@ -3263,15 +3308,15 @@ module Aws::ECS
3263
3308
  # @return [Types::Scale]
3264
3309
  #
3265
3310
  # @!attribute [rw] client_token
3266
- # Unique, case-sensitive identifier that you provide to ensure the
3267
- # idempotency of the request. Up to 32 ASCII characters are allowed.
3311
+ # The identifier that you provide to ensure the idempotency of the
3312
+ # request. It's case sensitive and must be unique. It can be up to 32
3313
+ # ASCII characters are allowed.
3268
3314
  # @return [String]
3269
3315
  #
3270
3316
  # @!attribute [rw] tags
3271
3317
  # The metadata that you apply to the task set to help you categorize
3272
- # and organize them. Each tag consists of a key and an optional value,
3273
- # both of which you define. When a service is deleted, the tags are
3274
- # deleted as well.
3318
+ # and organize them. Each tag consists of a key and an optional value.
3319
+ # You define both. When a service is deleted, the tags are deleted.
3275
3320
  #
3276
3321
  # The following basic restrictions apply to tags:
3277
3322
  #
@@ -3343,7 +3388,7 @@ module Aws::ECS
3343
3388
  # }
3344
3389
  #
3345
3390
  # @!attribute [rw] name
3346
- # The resource name for which to disable the account setting. If
3391
+ # The resource name to disable the account setting for. If
3347
3392
  # `serviceLongArnFormat` is specified, the ARN for your Amazon ECS
3348
3393
  # services is affected. If `taskLongArnFormat` is specified, the ARN
3349
3394
  # and resource ID for your Amazon ECS tasks is affected. If
@@ -3354,12 +3399,12 @@ module Aws::ECS
3354
3399
  # @return [String]
3355
3400
  #
3356
3401
  # @!attribute [rw] principal_arn
3357
- # The ARN of the principal, which can be an IAM user, IAM role, or the
3358
- # root user. If you specify the root user, it disables the account
3359
- # setting for all IAM users, IAM roles, and the root user of the
3360
- # account unless an IAM user or role explicitly overrides these
3361
- # settings. If this field is omitted, the setting is changed only for
3362
- # the authenticated user.
3402
+ # The Amazon Resource Name (ARN) of the principal. It can be an IAM
3403
+ # user, IAM role, or the root user. If you specify the root user, it
3404
+ # disables the account setting for all IAM users, IAM roles, and the
3405
+ # root user of the account unless an IAM user or role explicitly
3406
+ # overrides these settings. If this field is omitted, the setting is
3407
+ # changed only for the authenticated user.
3363
3408
  # @return [String]
3364
3409
  #
3365
3410
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DeleteAccountSettingRequest AWS API Documentation
@@ -3406,8 +3451,8 @@ module Aws::ECS
3406
3451
  #
3407
3452
  # @!attribute [rw] attributes
3408
3453
  # The attributes to delete from your resource. You can specify up to
3409
- # 10 attributes per request. For custom attributes, specify the
3410
- # attribute name and target ID, but do not specify the value. If you
3454
+ # 10 attributes for each request. For custom attributes, specify the
3455
+ # attribute name and target ID, but don't specify the value. If you
3411
3456
  # specify the target ID using the short form, you must also specify
3412
3457
  # the target type.
3413
3458
  # @return [Array<Types::Attribute>]
@@ -3518,9 +3563,9 @@ module Aws::ECS
3518
3563
  # @return [String]
3519
3564
  #
3520
3565
  # @!attribute [rw] force
3521
- # If `true`, allows you to delete a service even if it has not been
3522
- # scaled down to zero tasks. It is only necessary to use this if the
3523
- # service is using the `REPLICA` scheduling strategy.
3566
+ # If `true`, allows you to delete a service even if it wasn't scaled
3567
+ # down to zero tasks. It's only necessary to use this if the service
3568
+ # uses the `REPLICA` scheduling strategy.
3524
3569
  # @return [Boolean]
3525
3570
  #
3526
3571
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DeleteServiceRequest AWS API Documentation
@@ -3557,7 +3602,7 @@ module Aws::ECS
3557
3602
  #
3558
3603
  # @!attribute [rw] cluster
3559
3604
  # The short name or full Amazon Resource Name (ARN) of the cluster
3560
- # that hosts the service that the task set exists in to delete.
3605
+ # that hosts the service that the task set found in to delete.
3561
3606
  # @return [String]
3562
3607
  #
3563
3608
  # @!attribute [rw] service
@@ -3571,8 +3616,8 @@ module Aws::ECS
3571
3616
  # @return [String]
3572
3617
  #
3573
3618
  # @!attribute [rw] force
3574
- # If `true`, this allows you to delete a task set even if it hasn't
3575
- # been scaled down to zero.
3619
+ # If `true`, you can delete a task set even if it hasn't been scaled
3620
+ # down to zero.
3576
3621
  # @return [Boolean]
3577
3622
  #
3578
3623
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DeleteTaskSetRequest AWS API Documentation
@@ -3606,7 +3651,7 @@ module Aws::ECS
3606
3651
  # @return [String]
3607
3652
  #
3608
3653
  # @!attribute [rw] status
3609
- # The status of the deployment. The following describes each state:
3654
+ # The status of the deployment. The following describes each state.
3610
3655
  #
3611
3656
  # PRIMARY
3612
3657
  #
@@ -3656,11 +3701,13 @@ module Aws::ECS
3656
3701
  # @return [Integer]
3657
3702
  #
3658
3703
  # @!attribute [rw] created_at
3659
- # The Unix timestamp for when the service deployment was created.
3704
+ # The Unix timestamp for the time when the service deployment was
3705
+ # created.
3660
3706
  # @return [Time]
3661
3707
  #
3662
3708
  # @!attribute [rw] updated_at
3663
- # The Unix timestamp for when the service deployment was last updated.
3709
+ # The Unix timestamp for the time when the service deployment was last
3710
+ # updated.
3664
3711
  # @return [Time]
3665
3712
  #
3666
3713
  # @!attribute [rw] capacity_provider_strategy
@@ -3678,18 +3725,26 @@ module Aws::ECS
3678
3725
  # @return [String]
3679
3726
  #
3680
3727
  # @!attribute [rw] platform_version
3681
- # The platform version on which your tasks in the service are running.
3682
- # A platform version is only specified for tasks using the Fargate
3683
- # launch type. If one is not specified, the `LATEST` platform version
3684
- # is used by default. For more information, see [Fargate Platform
3685
- # Versions][1] in the *Amazon Elastic Container Service Developer
3686
- # Guide*.
3728
+ # The platform version that your tasks in the service run on. A
3729
+ # platform version is only specified for tasks using the Fargate
3730
+ # launch type. If one isn't specified, the `LATEST` platform version
3731
+ # is used. For more information, see [Fargate Platform Versions][1] in
3732
+ # the *Amazon Elastic Container Service Developer Guide*.
3687
3733
  #
3688
3734
  #
3689
3735
  #
3690
3736
  # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/platform_versions.html
3691
3737
  # @return [String]
3692
3738
  #
3739
+ # @!attribute [rw] platform_family
3740
+ # The operating system that your tasks in the service, or tasks are
3741
+ # running on. A platform family is specified only for tasks using the
3742
+ # Fargate launch type.
3743
+ #
3744
+ # All tasks that run as part of this service must use the same
3745
+ # `platformFamily` value as the service, for example, ` LINUX.`.
3746
+ # @return [String]
3747
+ #
3693
3748
  # @!attribute [rw] network_configuration
3694
3749
  # The VPC subnet and security group configuration for tasks that
3695
3750
  # receive their own elastic network interface by using the `awsvpc`
@@ -3698,18 +3753,18 @@ module Aws::ECS
3698
3753
  #
3699
3754
  # @!attribute [rw] rollout_state
3700
3755
  # <note markdown="1"> The `rolloutState` of a service is only returned for services that
3701
- # use the rolling update (`ECS`) deployment type that are not behind a
3756
+ # use the rolling update (`ECS`) deployment type that aren't behind a
3702
3757
  # Classic Load Balancer.
3703
3758
  #
3704
3759
  # </note>
3705
3760
  #
3706
3761
  # The rollout state of the deployment. When a service deployment is
3707
3762
  # started, it begins in an `IN_PROGRESS` state. When the service
3708
- # reaches a steady state, the deployment will transition to a
3709
- # `COMPLETED` state. If the service fails to reach a steady state and
3710
- # circuit breaker is enabled, the deployment will transition to a
3711
- # `FAILED` state. A deployment in `FAILED` state will launch no new
3712
- # tasks. For more information, see DeploymentCircuitBreaker.
3763
+ # reaches a steady state, the deployment transitions to a `COMPLETED`
3764
+ # state. If the service fails to reach a steady state and circuit
3765
+ # breaker is enabled, the deployment transitions to a `FAILED` state.
3766
+ # A deployment in `FAILED` state doesn't launch any new tasks. For
3767
+ # more information, see DeploymentCircuitBreaker.
3713
3768
  # @return [String]
3714
3769
  #
3715
3770
  # @!attribute [rw] rollout_state_reason
@@ -3731,6 +3786,7 @@ module Aws::ECS
3731
3786
  :capacity_provider_strategy,
3732
3787
  :launch_type,
3733
3788
  :platform_version,
3789
+ :platform_family,
3734
3790
  :network_configuration,
3735
3791
  :rollout_state,
3736
3792
  :rollout_state_reason)
@@ -3739,7 +3795,7 @@ module Aws::ECS
3739
3795
  end
3740
3796
 
3741
3797
  # <note markdown="1"> The deployment circuit breaker can only be used for services using the
3742
- # rolling update (`ECS`) deployment type that are not behind a Classic
3798
+ # rolling update (`ECS`) deployment type that aren't behind a Classic
3743
3799
  # Load Balancer.
3744
3800
  #
3745
3801
  # </note>
@@ -3765,15 +3821,15 @@ module Aws::ECS
3765
3821
  # }
3766
3822
  #
3767
3823
  # @!attribute [rw] enable
3768
- # Whether to enable the deployment circuit breaker logic for the
3769
- # service.
3824
+ # Determines whether to enable the deployment circuit breaker logic
3825
+ # for the service.
3770
3826
  # @return [Boolean]
3771
3827
  #
3772
3828
  # @!attribute [rw] rollback
3773
- # Whether to enable Amazon ECS to roll back the service if a service
3774
- # deployment fails. If rollback is enabled, when a service deployment
3775
- # fails, the service is rolled back to the last deployment that
3776
- # completed successfully.
3829
+ # Determines whether to enable Amazon ECS to roll back the service if
3830
+ # a service deployment fails. If rollback is enabled, when a service
3831
+ # deployment fails, the service is rolled back to the last deployment
3832
+ # that completed successfully.
3777
3833
  # @return [Boolean]
3778
3834
  #
3779
3835
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DeploymentCircuitBreaker AWS API Documentation
@@ -3850,10 +3906,10 @@ module Aws::ECS
3850
3906
  # service has a desired number of four tasks and a minimum healthy
3851
3907
  # percent of 50%, the scheduler may stop two existing tasks to free up
3852
3908
  # cluster capacity before starting two new tasks. Tasks for services
3853
- # that *do not* use a load balancer are considered healthy if they are
3909
+ # that *do not* use a load balancer are considered healthy if they're
3854
3910
  # in the `RUNNING` state; tasks for services that *do* use a load
3855
- # balancer are considered healthy if they are in the `RUNNING` state
3856
- # and they are reported as healthy by the load balancer. The default
3911
+ # balancer are considered healthy if they're in the `RUNNING` state
3912
+ # and they're reported as healthy by the load balancer. The default
3857
3913
  # value for minimum healthy percent is 100%.
3858
3914
  #
3859
3915
  # If a service is using the blue/green (`CODE_DEPLOY`) or `EXTERNAL`
@@ -3952,13 +4008,13 @@ module Aws::ECS
3952
4008
  # @return [String]
3953
4009
  #
3954
4010
  # @!attribute [rw] force
3955
- # Forces the deregistration of the container instance. If you have
3956
- # tasks running on the container instance when you deregister it with
3957
- # the `force` option, these tasks remain running until you terminate
3958
- # the instance or the tasks stop through some other means, but they
3959
- # are orphaned (no longer monitored or accounted for by Amazon ECS).
3960
- # If an orphaned task on your container instance is part of an Amazon
3961
- # ECS service, then the service scheduler starts another copy of that
4011
+ # Forces the container instance to be deregistered. If you have tasks
4012
+ # running on the container instance when you deregister it with the
4013
+ # `force` option, these tasks remain running until you terminate the
4014
+ # instance or the tasks stop through some other means, but they're
4015
+ # orphaned (no longer monitored or accounted for by Amazon ECS). If an
4016
+ # orphaned task on your container instance is part of an Amazon ECS
4017
+ # service, then the service scheduler starts another copy of that
3962
4018
  # task, on a different container instance if possible.
3963
4019
  #
3964
4020
  # Any containers in orphaned service tasks that are registered with a
@@ -4041,7 +4097,7 @@ module Aws::ECS
4041
4097
  # @!attribute [rw] include
4042
4098
  # Specifies whether or not you want to see the resource tags for the
4043
4099
  # capacity provider. If `TAGS` is specified, the tags are included in
4044
- # the response. If this field is omitted, tags are not included in the
4100
+ # the response. If this field is omitted, tags aren't included in the
4045
4101
  # response.
4046
4102
  # @return [Array<String>]
4047
4103
  #
@@ -4123,9 +4179,9 @@ module Aws::ECS
4123
4179
  # @return [Array<String>]
4124
4180
  #
4125
4181
  # @!attribute [rw] include
4126
- # Whether to include additional information about the clusters in the
4127
- # response. If this field is omitted, this information isn't
4128
- # included.
4182
+ # Determines whether to include additional information about the
4183
+ # clusters in the response. If this field is omitted, this information
4184
+ # isn't included.
4129
4185
  #
4130
4186
  # If `ATTACHMENTS` is specified, the attachments for the container
4131
4187
  # instances or tasks within the cluster are included.
@@ -4175,7 +4231,7 @@ module Aws::ECS
4175
4231
  # {
4176
4232
  # cluster: "String",
4177
4233
  # container_instances: ["String"], # required
4178
- # include: ["TAGS"], # accepts TAGS
4234
+ # include: ["TAGS"], # accepts TAGS, CONTAINER_INSTANCE_HEALTH
4179
4235
  # }
4180
4236
  #
4181
4237
  # @!attribute [rw] cluster
@@ -4195,8 +4251,10 @@ module Aws::ECS
4195
4251
  # @!attribute [rw] include
4196
4252
  # Specifies whether you want to see the resource tags for the
4197
4253
  # container instance. If `TAGS` is specified, the tags are included in
4198
- # the response. If this field is omitted, tags are not included in the
4199
- # response.
4254
+ # the response. If `CONTAINER_INSTANCE_HEALTH` is specified, the
4255
+ # container instance health is included in the response. If this field
4256
+ # is omitted, tags and container instance health status aren't
4257
+ # included in the response.
4200
4258
  # @return [Array<String>]
4201
4259
  #
4202
4260
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DescribeContainerInstancesRequest AWS API Documentation
@@ -4249,9 +4307,10 @@ module Aws::ECS
4249
4307
  # @return [Array<String>]
4250
4308
  #
4251
4309
  # @!attribute [rw] include
4252
- # Specifies whether you want to see the resource tags for the service.
4253
- # If `TAGS` is specified, the tags are included in the response. If
4254
- # this field is omitted, tags are not included in the response.
4310
+ # Determines whether you want to see the resource tags for the
4311
+ # service. If `TAGS` is specified, the tags are included in the
4312
+ # response. If this field is omitted, tags aren't included in the
4313
+ # response.
4255
4314
  # @return [Array<String>]
4256
4315
  #
4257
4316
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DescribeServicesRequest AWS API Documentation
@@ -4297,9 +4356,9 @@ module Aws::ECS
4297
4356
  # @return [String]
4298
4357
  #
4299
4358
  # @!attribute [rw] include
4300
- # Specifies whether to see the resource tags for the task definition.
4359
+ # Determines whether to see the resource tags for the task definition.
4301
4360
  # If `TAGS` is specified, the tags are included in the response. If
4302
- # this field is omitted, tags are not included in the response.
4361
+ # this field is omitted, tags aren't included in the response.
4303
4362
  # @return [Array<String>]
4304
4363
  #
4305
4364
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DescribeTaskDefinitionRequest AWS API Documentation
@@ -4316,9 +4375,9 @@ module Aws::ECS
4316
4375
  # @return [Types::TaskDefinition]
4317
4376
  #
4318
4377
  # @!attribute [rw] tags
4319
- # The metadata that is applied to the task definition to help you
4378
+ # The metadata that's applied to the task definition to help you
4320
4379
  # categorize and organize them. Each tag consists of a key and an
4321
- # optional value, both of which you define.
4380
+ # optional value. You define both.
4322
4381
  #
4323
4382
  # The following basic restrictions apply to tags:
4324
4383
  #
@@ -4382,7 +4441,7 @@ module Aws::ECS
4382
4441
  # @!attribute [rw] include
4383
4442
  # Specifies whether to see the resource tags for the task set. If
4384
4443
  # `TAGS` is specified, the tags are included in the response. If this
4385
- # field is omitted, tags are not included in the response.
4444
+ # field is omitted, tags aren't included in the response.
4386
4445
  # @return [Array<String>]
4387
4446
  #
4388
4447
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DescribeTaskSetsRequest AWS API Documentation
@@ -4437,7 +4496,7 @@ module Aws::ECS
4437
4496
  # @!attribute [rw] include
4438
4497
  # Specifies whether you want to see the resource tags for the task. If
4439
4498
  # `TAGS` is specified, the tags are included in the response. If this
4440
- # field is omitted, tags are not included in the response.
4499
+ # field is omitted, tags aren't included in the response.
4441
4500
  # @return [Array<String>]
4442
4501
  #
4443
4502
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DescribeTasksRequest AWS API Documentation
@@ -4520,8 +4579,8 @@ module Aws::ECS
4520
4579
  # @return [String]
4521
4580
  #
4522
4581
  # @!attribute [rw] cluster
4523
- # The short name or full Amazon Resource Name (ARN) of the cluster to
4524
- # which the container instance belongs.
4582
+ # The short name or full Amazon Resource Name (ARN) of the cluster
4583
+ # that the container instance belongs to.
4525
4584
  # @return [String]
4526
4585
  #
4527
4586
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DiscoverPollEndpointRequest AWS API Documentation
@@ -4550,8 +4609,8 @@ module Aws::ECS
4550
4609
  include Aws::Structure
4551
4610
  end
4552
4611
 
4553
- # This parameter is specified when you are using Docker volumes. Docker
4554
- # volumes are only supported when you are using the EC2 launch type.
4612
+ # This parameter is specified when you're using Docker volumes. Docker
4613
+ # volumes are only supported when you're using the EC2 launch type.
4555
4614
  # Windows containers only support the use of the `local` driver. To use
4556
4615
  # bind mounts, specify a `host` instead.
4557
4616
  #
@@ -4579,7 +4638,7 @@ module Aws::ECS
4579
4638
  # @return [String]
4580
4639
  #
4581
4640
  # @!attribute [rw] autoprovision
4582
- # If this value is `true`, the Docker volume is created if it does not
4641
+ # If this value is `true`, the Docker volume is created if it doesn't
4583
4642
  # already exist.
4584
4643
  #
4585
4644
  # <note markdown="1"> This field is only used if the `scope` is `shared`.
@@ -4671,12 +4730,13 @@ module Aws::ECS
4671
4730
  # @return [String]
4672
4731
  #
4673
4732
  # @!attribute [rw] iam
4674
- # Whether or not to use the Amazon ECS task IAM role defined in a task
4675
- # definition when mounting the Amazon EFS file system. If enabled,
4676
- # transit encryption must be enabled in the `EFSVolumeConfiguration`.
4677
- # If this parameter is omitted, the default value of `DISABLED` is
4678
- # used. For more information, see [Using Amazon EFS Access Points][1]
4679
- # in the *Amazon Elastic Container Service Developer Guide*.
4733
+ # Determines whether to use the Amazon ECS task IAM role defined in a
4734
+ # task definition when mounting the Amazon EFS file system. If
4735
+ # enabled, transit encryption must be enabled in the
4736
+ # `EFSVolumeConfiguration`. If this parameter is omitted, the default
4737
+ # value of `DISABLED` is used. For more information, see [Using Amazon
4738
+ # EFS Access Points][1] in the *Amazon Elastic Container Service
4739
+ # Developer Guide*.
4680
4740
  #
4681
4741
  #
4682
4742
  #
@@ -4692,7 +4752,7 @@ module Aws::ECS
4692
4752
  include Aws::Structure
4693
4753
  end
4694
4754
 
4695
- # This parameter is specified when you are using an Amazon Elastic File
4755
+ # This parameter is specified when you're using an Amazon Elastic File
4696
4756
  # System file system for task storage. For more information, see [Amazon
4697
4757
  # EFS Volumes][1] in the *Amazon Elastic Container Service Developer
4698
4758
  # Guide*.
@@ -4731,12 +4791,12 @@ module Aws::ECS
4731
4791
  # @return [String]
4732
4792
  #
4733
4793
  # @!attribute [rw] transit_encryption
4734
- # Whether or not to enable encryption for Amazon EFS data in transit
4735
- # between the Amazon ECS host and the Amazon EFS server. Transit
4736
- # encryption must be enabled if Amazon EFS IAM authorization is used.
4737
- # If this parameter is omitted, the default value of `DISABLED` is
4738
- # used. For more information, see [Encrypting Data in Transit][1] in
4739
- # the *Amazon Elastic File System User Guide*.
4794
+ # Determines whether to enable encryption for Amazon EFS data in
4795
+ # transit between the Amazon ECS host and the Amazon EFS server.
4796
+ # Transit encryption must be enabled if Amazon EFS IAM authorization
4797
+ # is used. If this parameter is omitted, the default value of
4798
+ # `DISABLED` is used. For more information, see [Encrypting Data in
4799
+ # Transit][1] in the *Amazon Elastic File System User Guide*.
4740
4800
  #
4741
4801
  #
4742
4802
  #
@@ -4777,20 +4837,24 @@ module Aws::ECS
4777
4837
  # have a `.env` file extension. Each line in an environment file should
4778
4838
  # contain an environment variable in `VARIABLE=VALUE` format. Lines
4779
4839
  # beginning with `#` are treated as comments and are ignored. For more
4780
- # information on the environment variable file syntax, see [Declare
4840
+ # information about the environment variable file syntax, see [Declare
4781
4841
  # default environment variables in file][1].
4782
4842
  #
4783
4843
  # If there are environment variables specified using the `environment`
4784
4844
  # parameter in a container definition, they take precedence over the
4785
4845
  # variables contained within an environment file. If multiple
4786
- # environment files are specified that contain the same variable, they
4787
- # are processed from the top down. It is recommended to use unique
4846
+ # environment files are specified that contain the same variable,
4847
+ # they're processed from the top down. We recommend that you use unique
4788
4848
  # variable names. For more information, see [Specifying environment
4789
4849
  # variables][2] in the *Amazon Elastic Container Service Developer
4790
4850
  # Guide*.
4791
4851
  #
4792
- # This field is only valid for containers in Fargate tasks that use
4793
- # platform version `1.4.0` or later.
4852
+ # This parameter is only supported for tasks hosted on Fargate using the
4853
+ # following platform versions:
4854
+ #
4855
+ # * Linux platform version `1.4.0` or later.
4856
+ #
4857
+ # * Windows platform version `1.0.0` or later.
4794
4858
  #
4795
4859
  #
4796
4860
  #
@@ -4829,8 +4893,12 @@ module Aws::ECS
4829
4893
  # more information, see [Fargate task storage][1] in the *Amazon ECS
4830
4894
  # User Guide for Fargate*.
4831
4895
  #
4832
- # <note markdown="1"> This parameter is only supported for tasks hosted on Fargate using
4833
- # platform version `1.4.0` or later.
4896
+ # <note markdown="1"> This parameter is only supported for tasks hosted on Fargate using the
4897
+ # following platform versions:
4898
+ #
4899
+ # * Linux platform version `1.4.0` or later.
4900
+ #
4901
+ # * Windows platform version `1.0.0` or later.
4834
4902
  #
4835
4903
  # </note>
4836
4904
  #
@@ -4937,8 +5005,8 @@ module Aws::ECS
4937
5005
  # @return [String]
4938
5006
  #
4939
5007
  # @!attribute [rw] cloud_watch_encryption_enabled
4940
- # Whether or not to enable encryption on the CloudWatch logs. If not
4941
- # specified, encryption will be disabled.
5008
+ # Determines whether to enable encryption on the CloudWatch logs. If
5009
+ # not specified, encryption will be disabled.
4942
5010
  # @return [Boolean]
4943
5011
  #
4944
5012
  # @!attribute [rw] s3_bucket_name
@@ -4950,8 +5018,8 @@ module Aws::ECS
4950
5018
  # @return [String]
4951
5019
  #
4952
5020
  # @!attribute [rw] s3_encryption_enabled
4953
- # Whether or not to enable encryption on the CloudWatch logs. If not
4954
- # specified, encryption will be disabled.
5021
+ # Determines whether to use encryption on the S3 logs. If not
5022
+ # specified, encryption is not used.
4955
5023
  # @return [Boolean]
4956
5024
  #
4957
5025
  # @!attribute [rw] s3_key_prefix
@@ -5031,9 +5099,9 @@ module Aws::ECS
5031
5099
  # @return [String]
5032
5100
  #
5033
5101
  # @!attribute [rw] interactive
5034
- # Whether or not the execute command session is running in interactive
5035
- # mode. Amazon ECS only supports initiating interactive sessions, so
5036
- # you must specify `true` for this value.
5102
+ # Determines whether the execute command session is running in
5103
+ # interactive mode. Amazon ECS only supports initiating interactive
5104
+ # sessions, so you must specify `true` for this value.
5037
5105
  # @return [Boolean]
5038
5106
  #
5039
5107
  # @!attribute [rw] session
@@ -5106,7 +5174,7 @@ module Aws::ECS
5106
5174
  include Aws::Structure
5107
5175
  end
5108
5176
 
5109
- # This parameter is specified when you are using [Amazon FSx for Windows
5177
+ # This parameter is specified when you're using [Amazon FSx for Windows
5110
5178
  # File Server][1] file system for task storage.
5111
5179
  #
5112
5180
  # For more information and the input format, see [Amazon FSx for Windows
@@ -5253,7 +5321,7 @@ module Aws::ECS
5253
5321
  #
5254
5322
  # * `UNHEALTHY`-The container health check has failed.
5255
5323
  #
5256
- # * `UNKNOWN`-The container health check is being evaluated or there is
5324
+ # * `UNKNOWN`-The container health check is being evaluated or there's
5257
5325
  # no container health check defined.
5258
5326
  #
5259
5327
  # The following describes the possible `healthStatus` values for a task.
@@ -5281,12 +5349,12 @@ module Aws::ECS
5281
5349
  # Amazon ECS container agent. For more information, see [Updating the
5282
5350
  # Amazon ECS Container Agent][1].
5283
5351
  #
5284
- # * Container health checks are supported for Fargate tasks if you are
5352
+ # * Container health checks are supported for Fargate tasks if you're
5285
5353
  # using platform version 1.1.0 or greater. For more information, see
5286
5354
  # [Fargate Platform Versions][2].
5287
5355
  #
5288
- # * Container health checks are not supported for tasks that are part of
5289
- # a service that is configured to use a Classic Load Balancer.
5356
+ # * Container health checks aren't supported for tasks that are part of
5357
+ # a service that's configured to use a Classic Load Balancer.
5290
5358
  #
5291
5359
  #
5292
5360
  #
@@ -5311,13 +5379,13 @@ module Aws::ECS
5311
5379
  # command with the container's default shell.
5312
5380
  #
5313
5381
  # When you use the Amazon Web Services Management Console JSON panel,
5314
- # the Command Line Interface, or the APIs, you should enclose the list
5315
- # of commands in brackets, as shown below.
5382
+ # the Command Line Interface, or the APIs, enclose the list of
5383
+ # commands in brackets.
5316
5384
  #
5317
5385
  # `[ "CMD-SHELL", "curl -f http://localhost/ || exit 1" ]`
5318
5386
  #
5319
- # You do not need to include the brackets when you use the Amazon Web
5320
- # Services Management Consoleas shown below.
5387
+ # You don't need to include the brackets when you use the Amazon Web
5388
+ # Services Management Console.
5321
5389
  #
5322
5390
  # ` "CMD-SHELL", "curl -f http://localhost/ || exit 1" `
5323
5391
  #
@@ -5350,10 +5418,10 @@ module Aws::ECS
5350
5418
  # @return [Integer]
5351
5419
  #
5352
5420
  # @!attribute [rw] start_period
5353
- # The optional grace period within which to provide containers time to
5354
- # bootstrap before failed health checks count towards the maximum
5355
- # number of retries. You may specify between 0 and 300 seconds. The
5356
- # `startPeriod` is disabled by default.
5421
+ # The optional grace period to provide containers time to bootstrap
5422
+ # before failed health checks count towards the maximum number of
5423
+ # retries. You can specify between 0 and 300 seconds. By default, the
5424
+ # `startPeriod` is disabled.
5357
5425
  #
5358
5426
  # <note markdown="1"> If a health check succeeds within the `startPeriod`, then the
5359
5427
  # container is considered healthy and any subsequent failures count
@@ -5414,16 +5482,16 @@ module Aws::ECS
5414
5482
  #
5415
5483
  # @!attribute [rw] source_path
5416
5484
  # When the `host` parameter is used, specify a `sourcePath` to declare
5417
- # the path on the host container instance that is presented to the
5485
+ # the path on the host container instance that's presented to the
5418
5486
  # container. If this parameter is empty, then the Docker daemon has
5419
5487
  # assigned a host path for you. If the `host` parameter contains a
5420
5488
  # `sourcePath` file location, then the data volume persists at the
5421
5489
  # specified location on the host container instance until you delete
5422
- # it manually. If the `sourcePath` value does not exist on the host
5490
+ # it manually. If the `sourcePath` value doesn't exist on the host
5423
5491
  # container instance, the Docker daemon creates it. If the location
5424
5492
  # does exist, the contents of the source path folder are exported.
5425
5493
  #
5426
- # If you are using the Fargate launch type, the `sourcePath` parameter
5494
+ # If you're using the Fargate launch type, the `sourcePath` parameter
5427
5495
  # is not supported.
5428
5496
  # @return [String]
5429
5497
  #
@@ -5435,7 +5503,7 @@ module Aws::ECS
5435
5503
  include Aws::Structure
5436
5504
  end
5437
5505
 
5438
- # Details on a Elastic Inference accelerator. For more information, see
5506
+ # Details on an Elastic Inference accelerator. For more information, see
5439
5507
  # [Working with Amazon Elastic Inference on Amazon ECS][1] in the
5440
5508
  # *Amazon Elastic Container Service Developer Guide*.
5441
5509
  #
@@ -5507,7 +5575,39 @@ module Aws::ECS
5507
5575
  include Aws::Structure
5508
5576
  end
5509
5577
 
5510
- # The specified parameter is invalid. Review the available parameters
5578
+ # An object representing the result of a container instance health
5579
+ # status check.
5580
+ #
5581
+ # @!attribute [rw] type
5582
+ # The type of container instance health status that was verified.
5583
+ # @return [String]
5584
+ #
5585
+ # @!attribute [rw] status
5586
+ # The container instance health status.
5587
+ # @return [String]
5588
+ #
5589
+ # @!attribute [rw] last_updated
5590
+ # The Unix timestamp for when the container instance health status was
5591
+ # last updated.
5592
+ # @return [Time]
5593
+ #
5594
+ # @!attribute [rw] last_status_change
5595
+ # The Unix timestamp for when the container instance health status
5596
+ # last changed.
5597
+ # @return [Time]
5598
+ #
5599
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/InstanceHealthCheckResult AWS API Documentation
5600
+ #
5601
+ class InstanceHealthCheckResult < Struct.new(
5602
+ :type,
5603
+ :status,
5604
+ :last_updated,
5605
+ :last_status_change)
5606
+ SENSITIVE = []
5607
+ include Aws::Structure
5608
+ end
5609
+
5610
+ # The specified parameter isn't valid. Review the available parameters
5511
5611
  # for the API request.
5512
5612
  #
5513
5613
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/InvalidParameterException AWS API Documentation
@@ -5516,10 +5616,11 @@ module Aws::ECS
5516
5616
 
5517
5617
  # The Linux capabilities for the container that are added to or dropped
5518
5618
  # from the default configuration provided by Docker. For more
5519
- # information on the default capabilities and the non-default available
5520
- # capabilities, see [Runtime privilege and Linux capabilities][1] in the
5521
- # *Docker run reference*. For more detailed information on these Linux
5522
- # capabilities, see the [capabilities(7)][2] Linux manual page.
5619
+ # information about the default capabilities and the non-default
5620
+ # available capabilities, see [Runtime privilege and Linux
5621
+ # capabilities][1] in the *Docker run reference*. For more detailed
5622
+ # information about these Linux capabilities, see the
5623
+ # [capabilities(7)][2] Linux manual page.
5523
5624
  #
5524
5625
  #
5525
5626
  #
@@ -5623,7 +5724,7 @@ module Aws::ECS
5623
5724
  include Aws::Structure
5624
5725
  end
5625
5726
 
5626
- # The limit for the resource has been exceeded.
5727
+ # The limit for the resource was exceeded.
5627
5728
  #
5628
5729
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/LimitExceededException AWS API Documentation
5629
5730
  #
@@ -5676,8 +5777,8 @@ module Aws::ECS
5676
5777
  # `Devices` in the [Create a container][1] section of the [Docker
5677
5778
  # Remote API][2] and the `--device` option to [docker run][3].
5678
5779
  #
5679
- # <note markdown="1"> If you are using tasks that use the Fargate launch type, the
5680
- # `devices` parameter is not supported.
5780
+ # <note markdown="1"> If you're using tasks that use the Fargate launch type, the
5781
+ # `devices` parameter isn't supported.
5681
5782
  #
5682
5783
  # </note>
5683
5784
  #
@@ -5721,8 +5822,8 @@ module Aws::ECS
5721
5822
  # mount. This parameter maps to the `--tmpfs` option to [docker
5722
5823
  # run][1].
5723
5824
  #
5724
- # <note markdown="1"> If you are using tasks that use the Fargate launch type, the `tmpfs`
5725
- # parameter is not supported.
5825
+ # <note markdown="1"> If you're using tasks that use the Fargate launch type, the `tmpfs`
5826
+ # parameter isn't supported.
5726
5827
  #
5727
5828
  # </note>
5728
5829
  #
@@ -5744,8 +5845,8 @@ module Aws::ECS
5744
5845
  # `maxSwap` value must be set for the `swappiness` parameter to be
5745
5846
  # used.
5746
5847
  #
5747
- # <note markdown="1"> If you are using tasks that use the Fargate launch type, the
5748
- # `maxSwap` parameter is not supported.
5848
+ # <note markdown="1"> If you're using tasks that use the Fargate launch type, the
5849
+ # `maxSwap` parameter isn't supported.
5749
5850
  #
5750
5851
  # </note>
5751
5852
  #
@@ -5765,8 +5866,8 @@ module Aws::ECS
5765
5866
  # parameter maps to the `--memory-swappiness` option to [docker
5766
5867
  # run][1].
5767
5868
  #
5768
- # <note markdown="1"> If you are using tasks that use the Fargate launch type, the
5769
- # `swappiness` parameter is not supported.
5869
+ # <note markdown="1"> If you're using tasks that use the Fargate launch type, the
5870
+ # `swappiness` parameter isn't supported.
5770
5871
  #
5771
5872
  # </note>
5772
5873
  #
@@ -5806,8 +5907,8 @@ module Aws::ECS
5806
5907
  # @return [String]
5807
5908
  #
5808
5909
  # @!attribute [rw] value
5809
- # The value of the account settings with which to filter results. You
5810
- # must also specify an account setting name to use this parameter.
5910
+ # The value of the account settings to filter results with. You must
5911
+ # also specify an account setting name to use this parameter.
5811
5912
  # @return [String]
5812
5913
  #
5813
5914
  # @!attribute [rw] principal_arn
@@ -5822,18 +5923,18 @@ module Aws::ECS
5822
5923
  # @return [String]
5823
5924
  #
5824
5925
  # @!attribute [rw] effective_settings
5825
- # Specifies whether to return the effective settings. If `true`, the
5926
+ # Determines whether to return the effective settings. If `true`, the
5826
5927
  # account settings for the root user or the default setting for the
5827
5928
  # `principalArn` are returned. If `false`, the account settings for
5828
- # the `principalArn` are returned if they are set. Otherwise, no
5929
+ # the `principalArn` are returned if they're set. Otherwise, no
5829
5930
  # account settings are returned.
5830
5931
  # @return [Boolean]
5831
5932
  #
5832
5933
  # @!attribute [rw] next_token
5833
5934
  # The `nextToken` value returned from a `ListAccountSettings` request
5834
5935
  # indicating that more results are available to fulfill the request
5835
- # and further calls will be needed. If `maxResults` was provided, it
5836
- # is possible the number of results to be fewer than `maxResults`.
5936
+ # and further calls will be needed. If `maxResults` was provided,
5937
+ # it's possible the number of results to be fewer than `maxResults`.
5837
5938
  #
5838
5939
  # <note markdown="1"> This token should be treated as an opaque identifier that is only
5839
5940
  # used to retrieve the next items in a list and not for other
@@ -5849,7 +5950,7 @@ module Aws::ECS
5849
5950
  # single page along with a `nextToken` response element. The remaining
5850
5951
  # results of the initial request can be seen by sending another
5851
5952
  # `ListAccountSettings` request with the returned `nextToken` value.
5852
- # This value can be between 1 and 10. If this parameter is not used,
5953
+ # This value can be between 1 and 10. If this parameter isn't used,
5853
5954
  # then `ListAccountSettings` returns up to 10 results and a
5854
5955
  # `nextToken` value if applicable.
5855
5956
  # @return [Integer]
@@ -5907,23 +6008,23 @@ module Aws::ECS
5907
6008
  # @return [String]
5908
6009
  #
5909
6010
  # @!attribute [rw] target_type
5910
- # The type of the target with which to list attributes.
6011
+ # The type of the target to list attributes with.
5911
6012
  # @return [String]
5912
6013
  #
5913
6014
  # @!attribute [rw] attribute_name
5914
- # The name of the attribute with which to filter the results.
6015
+ # The name of the attribute to filter the results with.
5915
6016
  # @return [String]
5916
6017
  #
5917
6018
  # @!attribute [rw] attribute_value
5918
- # The value of the attribute with which to filter results. You must
5919
- # also specify an attribute name to use this parameter.
6019
+ # The value of the attribute to filter results with. You must also
6020
+ # specify an attribute name to use this parameter.
5920
6021
  # @return [String]
5921
6022
  #
5922
6023
  # @!attribute [rw] next_token
5923
6024
  # The `nextToken` value returned from a `ListAttributes` request
5924
6025
  # indicating that more results are available to fulfill the request
5925
- # and further calls will be needed. If `maxResults` was provided, it
5926
- # is possible the number of results to be fewer than `maxResults`.
6026
+ # and further calls are needed. If `maxResults` was provided, it's
6027
+ # possible the number of results to be fewer than `maxResults`.
5927
6028
  #
5928
6029
  # <note markdown="1"> This token should be treated as an opaque identifier that is only
5929
6030
  # used to retrieve the next items in a list and not for other
@@ -5933,13 +6034,13 @@ module Aws::ECS
5933
6034
  # @return [String]
5934
6035
  #
5935
6036
  # @!attribute [rw] max_results
5936
- # The maximum number of cluster results returned by `ListAttributes`
6037
+ # The maximum number of cluster results that `ListAttributes` returned
5937
6038
  # in paginated output. When this parameter is used, `ListAttributes`
5938
6039
  # only returns `maxResults` results in a single page along with a
5939
6040
  # `nextToken` response element. The remaining results of the initial
5940
6041
  # request can be seen by sending another `ListAttributes` request with
5941
6042
  # the returned `nextToken` value. This value can be between 1 and 100.
5942
- # If this parameter is not used, then `ListAttributes` returns up to
6043
+ # If this parameter isn't used, then `ListAttributes` returns up to
5943
6044
  # 100 results and a `nextToken` value if applicable.
5944
6045
  # @return [Integer]
5945
6046
  #
@@ -5988,8 +6089,8 @@ module Aws::ECS
5988
6089
  # @!attribute [rw] next_token
5989
6090
  # The `nextToken` value returned from a `ListClusters` request
5990
6091
  # indicating that more results are available to fulfill the request
5991
- # and further calls will be needed. If `maxResults` was provided, it
5992
- # is possible the number of results to be fewer than `maxResults`.
6092
+ # and further calls are needed. If `maxResults` was provided, it's
6093
+ # possible the number of results to be fewer than `maxResults`.
5993
6094
  #
5994
6095
  # <note markdown="1"> This token should be treated as an opaque identifier that is only
5995
6096
  # used to retrieve the next items in a list and not for other
@@ -5999,13 +6100,13 @@ module Aws::ECS
5999
6100
  # @return [String]
6000
6101
  #
6001
6102
  # @!attribute [rw] max_results
6002
- # The maximum number of cluster results returned by `ListClusters` in
6003
- # paginated output. When this parameter is used, `ListClusters` only
6004
- # returns `maxResults` results in a single page along with a
6103
+ # The maximum number of cluster results that `ListClusters` returned
6104
+ # in paginated output. When this parameter is used, `ListClusters`
6105
+ # only returns `maxResults` results in a single page along with a
6005
6106
  # `nextToken` response element. The remaining results of the initial
6006
6107
  # request can be seen by sending another `ListClusters` request with
6007
6108
  # the returned `nextToken` value. This value can be between 1 and 100.
6008
- # If this parameter is not used, then `ListClusters` returns up to 100
6109
+ # If this parameter isn't used, then `ListClusters` returns up to 100
6009
6110
  # results and a `nextToken` value if applicable.
6010
6111
  # @return [Integer]
6011
6112
  #
@@ -6020,7 +6121,7 @@ module Aws::ECS
6020
6121
 
6021
6122
  # @!attribute [rw] cluster_arns
6022
6123
  # The list of full Amazon Resource Name (ARN) entries for each cluster
6023
- # associated with your account.
6124
+ # that's associated with your account.
6024
6125
  # @return [Array<String>]
6025
6126
  #
6026
6127
  # @!attribute [rw] next_token
@@ -6070,9 +6171,8 @@ module Aws::ECS
6070
6171
  # @!attribute [rw] next_token
6071
6172
  # The `nextToken` value returned from a `ListContainerInstances`
6072
6173
  # request indicating that more results are available to fulfill the
6073
- # request and further calls will be needed. If `maxResults` was
6074
- # provided, it is possible the number of results to be fewer than
6075
- # `maxResults`.
6174
+ # request and further calls are needed. If `maxResults` was provided,
6175
+ # it's possible the number of results to be fewer than `maxResults`.
6076
6176
  #
6077
6177
  # <note markdown="1"> This token should be treated as an opaque identifier that is only
6078
6178
  # used to retrieve the next items in a list and not for other
@@ -6082,22 +6182,22 @@ module Aws::ECS
6082
6182
  # @return [String]
6083
6183
  #
6084
6184
  # @!attribute [rw] max_results
6085
- # The maximum number of container instance results returned by
6086
- # `ListContainerInstances` in paginated output. When this parameter is
6087
- # used, `ListContainerInstances` only returns `maxResults` results in
6088
- # a single page along with a `nextToken` response element. The
6089
- # remaining results of the initial request can be seen by sending
6090
- # another `ListContainerInstances` request with the returned
6091
- # `nextToken` value. This value can be between 1 and 100. If this
6092
- # parameter is not used, then `ListContainerInstances` returns up to
6093
- # 100 results and a `nextToken` value if applicable.
6185
+ # The maximum number of container instance results that
6186
+ # `ListContainerInstances` returned in paginated output. When this
6187
+ # parameter is used, `ListContainerInstances` only returns
6188
+ # `maxResults` results in a single page along with a `nextToken`
6189
+ # response element. The remaining results of the initial request can
6190
+ # be seen by sending another `ListContainerInstances` request with the
6191
+ # returned `nextToken` value. This value can be between 1 and 100. If
6192
+ # this parameter isn't used, then `ListContainerInstances` returns up
6193
+ # to 100 results and a `nextToken` value if applicable.
6094
6194
  # @return [Integer]
6095
6195
  #
6096
6196
  # @!attribute [rw] status
6097
6197
  # Filters the container instances by status. For example, if you
6098
6198
  # specify the `DRAINING` status, the results include only container
6099
6199
  # instances that have been set to `DRAINING` using
6100
- # UpdateContainerInstancesState. If you do not specify this parameter,
6200
+ # UpdateContainerInstancesState. If you don't specify this parameter,
6101
6201
  # the default is to include container instances set to all states
6102
6202
  # other than `INACTIVE`.
6103
6203
  # @return [String]
@@ -6167,13 +6267,13 @@ module Aws::ECS
6167
6267
  # @return [String]
6168
6268
  #
6169
6269
  # @!attribute [rw] max_results
6170
- # The maximum number of service results returned by `ListServices` in
6171
- # paginated output. When this parameter is used, `ListServices` only
6172
- # returns `maxResults` results in a single page along with a
6270
+ # The maximum number of service results that `ListServices` returned
6271
+ # in paginated output. When this parameter is used, `ListServices`
6272
+ # only returns `maxResults` results in a single page along with a
6173
6273
  # `nextToken` response element. The remaining results of the initial
6174
6274
  # request can be seen by sending another `ListServices` request with
6175
6275
  # the returned `nextToken` value. This value can be between 1 and 100.
6176
- # If this parameter is not used, then `ListServices` returns up to 10
6276
+ # If this parameter isn't used, then `ListServices` returns up to 10
6177
6277
  # results and a `nextToken` value if applicable.
6178
6278
  # @return [Integer]
6179
6279
  #
@@ -6199,8 +6299,8 @@ module Aws::ECS
6199
6299
  end
6200
6300
 
6201
6301
  # @!attribute [rw] service_arns
6202
- # The list of full ARN entries for each service associated with the
6203
- # specified cluster.
6302
+ # The list of full ARN entries for each service that's associated
6303
+ # with the specified cluster.
6204
6304
  # @return [Array<String>]
6205
6305
  #
6206
6306
  # @!attribute [rw] next_token
@@ -6227,10 +6327,10 @@ module Aws::ECS
6227
6327
  # }
6228
6328
  #
6229
6329
  # @!attribute [rw] resource_arn
6230
- # The Amazon Resource Name (ARN) that identifies the resource for
6231
- # which to list the tags. Currently, the supported resources are
6232
- # Amazon ECS tasks, services, task definitions, clusters, and
6233
- # container instances.
6330
+ # The Amazon Resource Name (ARN) that identifies the resource to list
6331
+ # the tags for. Currently, the supported resources are Amazon ECS
6332
+ # tasks, services, task definitions, clusters, and container
6333
+ # instances.
6234
6334
  # @return [String]
6235
6335
  #
6236
6336
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/ListTagsForResourceRequest AWS API Documentation
@@ -6264,22 +6364,22 @@ module Aws::ECS
6264
6364
  # }
6265
6365
  #
6266
6366
  # @!attribute [rw] family_prefix
6267
- # The `familyPrefix` is a string that is used to filter the results of
6367
+ # The `familyPrefix` is a string that's used to filter the results of
6268
6368
  # `ListTaskDefinitionFamilies`. If you specify a `familyPrefix`, only
6269
6369
  # task definition family names that begin with the `familyPrefix`
6270
6370
  # string are returned.
6271
6371
  # @return [String]
6272
6372
  #
6273
6373
  # @!attribute [rw] status
6274
- # The task definition family status with which to filter the
6275
- # `ListTaskDefinitionFamilies` results. By default, both `ACTIVE` and
6276
- # `INACTIVE` task definition families are listed. If this parameter is
6277
- # set to `ACTIVE`, only task definition families that have an `ACTIVE`
6278
- # task definition revision are returned. If this parameter is set to
6279
- # `INACTIVE`, only task definition families that do not have any
6280
- # `ACTIVE` task definition revisions are returned. If you paginate the
6281
- # resulting output, be sure to keep the `status` value constant in
6282
- # each subsequent request.
6374
+ # The task definition family status to filter the
6375
+ # `ListTaskDefinitionFamilies` results with. By default, both `ACTIVE`
6376
+ # and `INACTIVE` task definition families are listed. If this
6377
+ # parameter is set to `ACTIVE`, only task definition families that
6378
+ # have an `ACTIVE` task definition revision are returned. If this
6379
+ # parameter is set to `INACTIVE`, only task definition families that
6380
+ # do not have any `ACTIVE` task definition revisions are returned. If
6381
+ # you paginate the resulting output, be sure to keep the `status`
6382
+ # value constant in each subsequent request.
6283
6383
  # @return [String]
6284
6384
  #
6285
6385
  # @!attribute [rw] next_token
@@ -6297,14 +6397,14 @@ module Aws::ECS
6297
6397
  # @return [String]
6298
6398
  #
6299
6399
  # @!attribute [rw] max_results
6300
- # The maximum number of task definition family results returned by
6301
- # `ListTaskDefinitionFamilies` in paginated output. When this
6400
+ # The maximum number of task definition family results that
6401
+ # `ListTaskDefinitionFamilies` returned in paginated output. When this
6302
6402
  # parameter is used, `ListTaskDefinitions` only returns `maxResults`
6303
6403
  # results in a single page along with a `nextToken` response element.
6304
6404
  # The remaining results of the initial request can be seen by sending
6305
6405
  # another `ListTaskDefinitionFamilies` request with the returned
6306
6406
  # `nextToken` value. This value can be between 1 and 100. If this
6307
- # parameter is not used, then `ListTaskDefinitionFamilies` returns up
6407
+ # parameter isn't used, then `ListTaskDefinitionFamilies` returns up
6308
6408
  # to 100 results and a `nextToken` value if applicable.
6309
6409
  # @return [Integer]
6310
6410
  #
@@ -6353,29 +6453,28 @@ module Aws::ECS
6353
6453
  # }
6354
6454
  #
6355
6455
  # @!attribute [rw] family_prefix
6356
- # The full family name with which to filter the `ListTaskDefinitions`
6357
- # results. Specifying a `familyPrefix` limits the listed task
6358
- # definitions to task definition revisions that belong to that family.
6456
+ # The full family name to filter the `ListTaskDefinitions` results
6457
+ # with. Specifying a `familyPrefix` limits the listed task definitions
6458
+ # to task definition revisions that belong to that family.
6359
6459
  # @return [String]
6360
6460
  #
6361
6461
  # @!attribute [rw] status
6362
- # The task definition status with which to filter the
6363
- # `ListTaskDefinitions` results. By default, only `ACTIVE` task
6364
- # definitions are listed. By setting this parameter to `INACTIVE`, you
6365
- # can view task definitions that are `INACTIVE` as long as an active
6366
- # task or service still references them. If you paginate the resulting
6367
- # output, be sure to keep the `status` value constant in each
6368
- # subsequent request.
6462
+ # The task definition status to filter the `ListTaskDefinitions`
6463
+ # results with. By default, only `ACTIVE` task definitions are listed.
6464
+ # By setting this parameter to `INACTIVE`, you can view task
6465
+ # definitions that are `INACTIVE` as long as an active task or service
6466
+ # still references them. If you paginate the resulting output, be sure
6467
+ # to keep the `status` value constant in each subsequent request.
6369
6468
  # @return [String]
6370
6469
  #
6371
6470
  # @!attribute [rw] sort
6372
- # The order in which to sort the results. Valid values are `ASC` and
6373
- # `DESC`. By default (`ASC`), task definitions are listed
6374
- # lexicographically by family name and in ascending numerical order by
6375
- # revision so that the newest task definitions in a family are listed
6376
- # last. Setting this parameter to `DESC` reverses the sort order on
6377
- # family name and revision so that the newest task definitions in a
6378
- # family are listed first.
6471
+ # The order to sort the results in. Valid values are `ASC` and `DESC`.
6472
+ # By default, (`ASC`) task definitions are listed lexicographically by
6473
+ # family name and in ascending numerical order by revision so that the
6474
+ # newest task definitions in a family are listed last. Setting this
6475
+ # parameter to `DESC` reverses the sort order on family name and
6476
+ # revision. This is so that the newest task definitions in a family
6477
+ # are listed first.
6379
6478
  # @return [String]
6380
6479
  #
6381
6480
  # @!attribute [rw] next_token
@@ -6392,14 +6491,14 @@ module Aws::ECS
6392
6491
  # @return [String]
6393
6492
  #
6394
6493
  # @!attribute [rw] max_results
6395
- # The maximum number of task definition results returned by
6396
- # `ListTaskDefinitions` in paginated output. When this parameter is
6397
- # used, `ListTaskDefinitions` only returns `maxResults` results in a
6398
- # single page along with a `nextToken` response element. The remaining
6399
- # results of the initial request can be seen by sending another
6400
- # `ListTaskDefinitions` request with the returned `nextToken` value.
6401
- # This value can be between 1 and 100. If this parameter is not used,
6402
- # then `ListTaskDefinitions` returns up to 100 results and a
6494
+ # The maximum number of task definition results that
6495
+ # `ListTaskDefinitions` returned in paginated output. When this
6496
+ # parameter is used, `ListTaskDefinitions` only returns `maxResults`
6497
+ # results in a single page along with a `nextToken` response element.
6498
+ # The remaining results of the initial request can be seen by sending
6499
+ # another `ListTaskDefinitions` request with the returned `nextToken`
6500
+ # value. This value can be between 1 and 100. If this parameter isn't
6501
+ # used, then `ListTaskDefinitions` returns up to 100 results and a
6403
6502
  # `nextToken` value if applicable.
6404
6503
  # @return [Integer]
6405
6504
  #
@@ -6474,7 +6573,7 @@ module Aws::ECS
6474
6573
  # @!attribute [rw] next_token
6475
6574
  # The `nextToken` value returned from a `ListTasks` request indicating
6476
6575
  # that more results are available to fulfill the request and further
6477
- # calls will be needed. If `maxResults` was provided, it is possible
6576
+ # calls will be needed. If `maxResults` was provided, it's possible
6478
6577
  # the number of results to be fewer than `maxResults`.
6479
6578
  #
6480
6579
  # <note markdown="1"> This token should be treated as an opaque identifier that is only
@@ -6485,20 +6584,20 @@ module Aws::ECS
6485
6584
  # @return [String]
6486
6585
  #
6487
6586
  # @!attribute [rw] max_results
6488
- # The maximum number of task results returned by `ListTasks` in
6587
+ # The maximum number of task results that `ListTasks` returned in
6489
6588
  # paginated output. When this parameter is used, `ListTasks` only
6490
6589
  # returns `maxResults` results in a single page along with a
6491
6590
  # `nextToken` response element. The remaining results of the initial
6492
6591
  # request can be seen by sending another `ListTasks` request with the
6493
6592
  # returned `nextToken` value. This value can be between 1 and 100. If
6494
- # this parameter is not used, then `ListTasks` returns up to 100
6593
+ # this parameter isn't used, then `ListTasks` returns up to 100
6495
6594
  # results and a `nextToken` value if applicable.
6496
6595
  # @return [Integer]
6497
6596
  #
6498
6597
  # @!attribute [rw] started_by
6499
- # The `startedBy` value with which to filter the task results.
6500
- # Specifying a `startedBy` value limits the results to tasks that were
6501
- # started with that value.
6598
+ # The `startedBy` value to filter the task results with. Specifying a
6599
+ # `startedBy` value limits the results to tasks that were started with
6600
+ # that value.
6502
6601
  # @return [String]
6503
6602
  #
6504
6603
  # @!attribute [rw] service_name
@@ -6511,13 +6610,13 @@ module Aws::ECS
6511
6610
  # The task desired status to use when filtering the `ListTasks`
6512
6611
  # results. Specifying a `desiredStatus` of `STOPPED` limits the
6513
6612
  # results to tasks that Amazon ECS has set the desired status to
6514
- # `STOPPED`. This can be useful for debugging tasks that are not
6613
+ # `STOPPED`. This can be useful for debugging tasks that aren't
6515
6614
  # starting properly or have died or finished. The default status
6516
6615
  # filter is `RUNNING`, which shows tasks that Amazon ECS has set the
6517
6616
  # desired status to `RUNNING`.
6518
6617
  #
6519
6618
  # <note markdown="1"> Although you can filter results based on a desired status of
6520
- # `PENDING`, this does not return any results. Amazon ECS never sets
6619
+ # `PENDING`, this doesn't return any results. Amazon ECS never sets
6521
6620
  # the desired status of a task to that value (only a task's
6522
6621
  # `lastStatus` may have a value of `PENDING`).
6523
6622
  #
@@ -6585,25 +6684,25 @@ module Aws::ECS
6585
6684
  # target group or groups associated with a service or task set.
6586
6685
  #
6587
6686
  # A target group ARN is only specified when using an Application Load
6588
- # Balancer or Network Load Balancer. If you are using a Classic Load
6589
- # Balancer the target group ARN should be omitted.
6687
+ # Balancer or Network Load Balancer. If you're using a Classic Load
6688
+ # Balancer, omit the target group ARN.
6590
6689
  #
6591
6690
  # For services using the `ECS` deployment controller, you can specify
6592
6691
  # one or multiple target groups. For more information, see
6593
6692
  # [Registering Multiple Target Groups with a Service][1] in the
6594
6693
  # *Amazon Elastic Container Service Developer Guide*.
6595
6694
  #
6596
- # For services using the `CODE_DEPLOY` deployment controller, you are
6695
+ # For services using the `CODE_DEPLOY` deployment controller, you're
6597
6696
  # required to define two target groups for the load balancer. For more
6598
6697
  # information, see [Blue/Green Deployment with CodeDeploy][2] in the
6599
6698
  # *Amazon Elastic Container Service Developer Guide*.
6600
6699
  #
6601
- # If your service's task definition uses the `awsvpc` network mode
6602
- # (which is required for the Fargate launch type), you must choose
6603
- # `ip` as the target type, not `instance`, when creating your target
6604
- # groups because tasks that use the `awsvpc` network mode are
6605
- # associated with an elastic network interface, not an Amazon EC2
6606
- # instance.
6700
+ # If your service's task definition uses the `awsvpc` network mode,
6701
+ # you must choose `ip` as the target type, not `instance`. Do this
6702
+ # when creating your target groups because tasks that use the `awsvpc`
6703
+ # network mode are associated with an elastic network interface, not
6704
+ # an Amazon EC2 instance. This network mode is required for the
6705
+ # Fargate launch type.
6607
6706
  #
6608
6707
  #
6609
6708
  #
@@ -6629,7 +6728,7 @@ module Aws::ECS
6629
6728
  # The port on the container to associate with the load balancer. This
6630
6729
  # port must correspond to a `containerPort` in the task definition the
6631
6730
  # tasks in the service are using. For tasks that use the EC2 launch
6632
- # type, the container instance they are launched on must allow ingress
6731
+ # type, the container instance they're launched on must allow ingress
6633
6732
  # traffic on the `hostPort` of the port mapping.
6634
6733
  # @return [Integer]
6635
6734
  #
@@ -6649,14 +6748,14 @@ module Aws::ECS
6649
6748
  # Remote API][2] and the `--log-driver` option to [ `docker run` ][3].
6650
6749
  #
6651
6750
  # By default, containers use the same logging driver that the Docker
6652
- # daemon uses; however the container may use a different logging driver
6653
- # than the Docker daemon by specifying a log driver configuration in the
6654
- # container definition. For more information on the options for
6655
- # different supported log drivers, see [Configure logging drivers][4] in
6656
- # the Docker documentation.
6751
+ # daemon uses. However, the container might use a different logging
6752
+ # driver than the Docker daemon by specifying a log driver configuration
6753
+ # in the container definition. For more information about the options
6754
+ # for different supported log drivers, see [Configure logging
6755
+ # drivers][4] in the Docker documentation.
6657
6756
  #
6658
- # The following should be noted when specifying a log configuration for
6659
- # your containers:
6757
+ # Understand the following when specifying a log configuration for your
6758
+ # containers.
6660
6759
  #
6661
6760
  # * Amazon ECS currently supports a subset of the logging drivers
6662
6761
  # available to the Docker daemon (shown in the valid values below).
@@ -6666,19 +6765,19 @@ module Aws::ECS
6666
6765
  # * This parameter requires version 1.18 of the Docker Remote API or
6667
6766
  # greater on your container instance.
6668
6767
  #
6669
- # * For tasks hosted on Amazon EC2 instances, the Amazon ECS container
6670
- # agent must register the available logging drivers with the
6768
+ # * For tasks that are hosted on Amazon EC2 instances, the Amazon ECS
6769
+ # container agent must register the available logging drivers with the
6671
6770
  # `ECS_AVAILABLE_LOGGING_DRIVERS` environment variable before
6672
6771
  # containers placed on that instance can use these log configuration
6673
6772
  # options. For more information, see [Amazon ECS container agent
6674
6773
  # configuration][5] in the *Amazon Elastic Container Service Developer
6675
6774
  # Guide*.
6676
6775
  #
6677
- # * For tasks on Fargate, because you do not have access to the
6776
+ # * For tasks that are on Fargate, because you don't have access to the
6678
6777
  # underlying infrastructure your tasks are hosted on, any additional
6679
- # software needed will have to be installed outside of the task. For
6680
- # example, the Fluentd output aggregators or a remote host running
6681
- # Logstash to send Gelf logs to.
6778
+ # software needed must be installed outside of the task. For example,
6779
+ # the Fluentd output aggregators or a remote host running Logstash to
6780
+ # send Gelf logs to.
6682
6781
  #
6683
6782
  #
6684
6783
  #
@@ -6722,11 +6821,11 @@ module Aws::ECS
6722
6821
  # [Custom log routing][2] in the *Amazon Elastic Container Service
6723
6822
  # Developer Guide*.
6724
6823
  #
6725
- # <note markdown="1"> If you have a custom driver that is not listed, you can fork the
6726
- # Amazon ECS container agent project that is [available on GitHub][3]
6824
+ # <note markdown="1"> If you have a custom driver that isn't listed, you can fork the
6825
+ # Amazon ECS container agent project that's [available on GitHub][3]
6727
6826
  # and customize it to work with that driver. We encourage you to
6728
6827
  # submit pull requests for changes that you would like to have
6729
- # included. However, we do not currently provide support for running
6828
+ # included. However, we don't currently provide support for running
6730
6829
  # modified copies of this software.
6731
6830
  #
6732
6831
  # </note>
@@ -6770,7 +6869,8 @@ module Aws::ECS
6770
6869
  # Details about the managed agent status for the container.
6771
6870
  #
6772
6871
  # @!attribute [rw] last_started_at
6773
- # The Unix timestamp for when the managed agent was last started.
6872
+ # The Unix timestamp for the time when the managed agent was last
6873
+ # started.
6774
6874
  # @return [Time]
6775
6875
  #
6776
6876
  # @!attribute [rw] name
@@ -6810,7 +6910,7 @@ module Aws::ECS
6810
6910
  # }
6811
6911
  #
6812
6912
  # @!attribute [rw] container_name
6813
- # The name of the container associated with the managed agent.
6913
+ # The name of the container that's associated with the managed agent.
6814
6914
  # @return [String]
6815
6915
  #
6816
6916
  # @!attribute [rw] managed_agent_name
@@ -6841,7 +6941,7 @@ module Aws::ECS
6841
6941
  #
6842
6942
  # When managed scaling is enabled, Amazon ECS manages the scale-in and
6843
6943
  # scale-out actions of the Auto Scaling group. Amazon ECS manages a
6844
- # target tracking scaling policy using an Amazon ECS-managed CloudWatch
6944
+ # target tracking scaling policy using an Amazon ECS managed CloudWatch
6845
6945
  # metric with the specified `targetCapacity` value as the target value
6846
6946
  # for the metric. For more information, see [Using Managed Scaling][1]
6847
6947
  # in the *Amazon Elastic Container Service Developer Guide*.
@@ -6865,26 +6965,27 @@ module Aws::ECS
6865
6965
  # }
6866
6966
  #
6867
6967
  # @!attribute [rw] status
6868
- # Whether or not to enable managed scaling for the capacity provider.
6968
+ # Determines whether to enable managed scaling for the capacity
6969
+ # provider.
6869
6970
  # @return [String]
6870
6971
  #
6871
6972
  # @!attribute [rw] target_capacity
6872
6973
  # The target capacity value for the capacity provider. The specified
6873
6974
  # value must be greater than `0` and less than or equal to `100`. A
6874
- # value of `100` will result in the Amazon EC2 instances in your Auto
6875
- # Scaling group being completely utilized.
6975
+ # value of `100` results in the Amazon EC2 instances in your Auto
6976
+ # Scaling group being completely used.
6876
6977
  # @return [Integer]
6877
6978
  #
6878
6979
  # @!attribute [rw] minimum_scaling_step_size
6879
- # The minimum number of container instances that Amazon ECS will scale
6880
- # in or scale out at one time. If this parameter is omitted, the
6881
- # default value of `1` is used.
6980
+ # The minimum number of container instances that Amazon ECS scales in
6981
+ # or scales out at one time. If this parameter is omitted, the default
6982
+ # value of `1` is used.
6882
6983
  # @return [Integer]
6883
6984
  #
6884
6985
  # @!attribute [rw] maximum_scaling_step_size
6885
- # The maximum number of container instances that Amazon ECS will scale
6886
- # in or scale out at one time. If this parameter is omitted, the
6887
- # default value of `10000` is used.
6986
+ # The maximum number of container instances that Amazon ECS scales in
6987
+ # or scales out at one time. If this parameter is omitted, the default
6988
+ # value of `10000` is used.
6888
6989
  # @return [Integer]
6889
6990
  #
6890
6991
  # @!attribute [rw] instance_warmup_period
@@ -6906,17 +7007,17 @@ module Aws::ECS
6906
7007
  include Aws::Structure
6907
7008
  end
6908
7009
 
6909
- # Amazon ECS is unable to determine the current version of the Amazon
6910
- # ECS container agent on the container instance and does not have enough
7010
+ # Amazon ECS can't determine the current version of the Amazon ECS
7011
+ # container agent on the container instance and doesn't have enough
6911
7012
  # information to proceed with an update. This could be because the agent
6912
- # running on the container instance is an older or custom version that
6913
- # does not use our version information.
7013
+ # running on the container instance is a previous or custom version that
7014
+ # doesn't use our version information.
6914
7015
  #
6915
7016
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/MissingVersionException AWS API Documentation
6916
7017
  #
6917
7018
  class MissingVersionException < Aws::EmptyStructure; end
6918
7019
 
6919
- # Details on a volume mount point that is used in a container
7020
+ # Details for a volume mount point that's used in a container
6920
7021
  # definition.
6921
7022
  #
6922
7023
  # @note When making an API call, you may pass MountPoint
@@ -6974,12 +7075,12 @@ module Aws::ECS
6974
7075
  # @return [String]
6975
7076
  #
6976
7077
  # @!attribute [rw] container_port
6977
- # The port number on the container that is used with the network
7078
+ # The port number on the container that's used with the network
6978
7079
  # binding.
6979
7080
  # @return [Integer]
6980
7081
  #
6981
7082
  # @!attribute [rw] host_port
6982
- # The port number on the host that is used with the network binding.
7083
+ # The port number on the host that's used with the network binding.
6983
7084
  # @return [Integer]
6984
7085
  #
6985
7086
  # @!attribute [rw] protocol
@@ -7012,7 +7113,7 @@ module Aws::ECS
7012
7113
  # }
7013
7114
  #
7014
7115
  # @!attribute [rw] awsvpc_configuration
7015
- # The VPC subnets and security groups associated with a task.
7116
+ # The VPC subnets and security groups that are associated with a task.
7016
7117
  #
7017
7118
  # <note markdown="1"> All specified subnets and security groups must be from the same VPC.
7018
7119
  #
@@ -7052,9 +7153,10 @@ module Aws::ECS
7052
7153
  include Aws::Structure
7053
7154
  end
7054
7155
 
7055
- # There is no update available for this Amazon ECS container agent. This
7056
- # could be because the agent is already running the latest version, or
7057
- # it is so old that there is no update path to the current version.
7156
+ # There's no update available for this Amazon ECS container agent. This
7157
+ # might be because the agent is already running the latest version or
7158
+ # because it's so old that there's no update path to the current
7159
+ # version.
7058
7160
  #
7059
7161
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/NoUpdateAvailableException AWS API Documentation
7060
7162
  #
@@ -7064,8 +7166,8 @@ module Aws::ECS
7064
7166
  # information, see [Task Placement Constraints][1] in the *Amazon
7065
7167
  # Elastic Container Service Developer Guide*.
7066
7168
  #
7067
- # <note markdown="1"> If you are using the Fargate launch type, task placement constraints
7068
- # are not supported.
7169
+ # <note markdown="1"> If you're using the Fargate launch type, task placement constraints
7170
+ # aren't supported.
7069
7171
  #
7070
7172
  # </note>
7071
7173
  #
@@ -7131,16 +7233,16 @@ module Aws::ECS
7131
7233
  # placement strategy spreads placement across available candidates
7132
7234
  # evenly based on the `field` parameter. The `binpack` strategy places
7133
7235
  # tasks on available candidates that have the least available amount
7134
- # of the resource that is specified with the `field` parameter. For
7236
+ # of the resource that's specified with the `field` parameter. For
7135
7237
  # example, if you binpack on memory, a task is placed on the instance
7136
- # with the least amount of remaining memory (but still enough to run
7137
- # the task).
7238
+ # with the least amount of remaining memory but still enough to run
7239
+ # the task.
7138
7240
  # @return [String]
7139
7241
  #
7140
7242
  # @!attribute [rw] field
7141
7243
  # The field to apply the placement strategy against. For the `spread`
7142
7244
  # placement strategy, valid values are `instanceId` (or `host`, which
7143
- # has the same effect), or any platform or custom attribute that is
7245
+ # has the same effect), or any platform or custom attribute that's
7144
7246
  # applied to a container instance, such as
7145
7247
  # `attribute:ecs.availability-zone`. For the `binpack` placement
7146
7248
  # strategy, valid values are `cpu` and `memory`. For the `random`
@@ -7168,13 +7270,13 @@ module Aws::ECS
7168
7270
  # }
7169
7271
  #
7170
7272
  # @!attribute [rw] id
7171
- # The ID for the GPU(s) on the container instance. The available GPU
7172
- # IDs can also be obtained on the container instance in the
7273
+ # The ID for the GPUs on the container instance. The available GPU IDs
7274
+ # can also be obtained on the container instance in the
7173
7275
  # `/var/lib/ecs/gpu/nvidia_gpu_info.json` file.
7174
7276
  # @return [String]
7175
7277
  #
7176
7278
  # @!attribute [rw] type
7177
- # The type of device that is available on the container instance. The
7279
+ # The type of device that's available on the container instance. The
7178
7280
  # only supported value is `GPU`.
7179
7281
  # @return [String]
7180
7282
  #
@@ -7187,14 +7289,14 @@ module Aws::ECS
7187
7289
  include Aws::Structure
7188
7290
  end
7189
7291
 
7190
- # The specified platform version does not satisfy the task definition's
7191
- # required capabilities.
7292
+ # The specified platform version doesn't satisfy the required
7293
+ # capabilities of the task definition.
7192
7294
  #
7193
7295
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/PlatformTaskDefinitionIncompatibilityException AWS API Documentation
7194
7296
  #
7195
7297
  class PlatformTaskDefinitionIncompatibilityException < Aws::EmptyStructure; end
7196
7298
 
7197
- # The specified platform version does not exist.
7299
+ # The specified platform version doesn't exist.
7198
7300
  #
7199
7301
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/PlatformUnknownException AWS API Documentation
7200
7302
  #
@@ -7204,13 +7306,12 @@ module Aws::ECS
7204
7306
  # instance to send or receive traffic. Port mappings are specified as
7205
7307
  # part of the container definition.
7206
7308
  #
7207
- # If you are using containers in a task with the `awsvpc` or `host`
7208
- # network mode, exposed ports should be specified using `containerPort`.
7209
- # The `hostPort` can be left blank or it must be the same value as the
7210
- # `containerPort`.
7309
+ # If you use containers in a task with the `awsvpc` or `host` network
7310
+ # mode, specify the exposed ports using `containerPort`. The `hostPort`
7311
+ # can be left blank or it must be the same value as the `containerPort`.
7211
7312
  #
7212
- # <note markdown="1"> You cannot expose the same container port for multiple protocols. An
7213
- # error will be returned if this is attempted
7313
+ # <note markdown="1"> You can't expose the same container port for multiple protocols. If
7314
+ # you attempt this, an error is returned.
7214
7315
  #
7215
7316
  # </note>
7216
7317
  #
@@ -7228,15 +7329,14 @@ module Aws::ECS
7228
7329
  # }
7229
7330
  #
7230
7331
  # @!attribute [rw] container_port
7231
- # The port number on the container that is bound to the user-specified
7332
+ # The port number on the container that's bound to the user-specified
7232
7333
  # or automatically assigned host port.
7233
7334
  #
7234
- # If you are using containers in a task with the `awsvpc` or `host`
7235
- # network mode, exposed ports should be specified using
7236
- # `containerPort`.
7335
+ # If you use containers in a task with the `awsvpc` or `host` network
7336
+ # mode, specify the exposed ports using `containerPort`.
7237
7337
  #
7238
- # If you are using containers in a task with the `bridge` network mode
7239
- # and you specify a container port and not a host port, your container
7338
+ # If you use containers in a task with the `bridge` network mode and
7339
+ # you specify a container port and not a host port, your container
7240
7340
  # automatically receives a host port in the ephemeral port range. For
7241
7341
  # more information, see `hostPort`. Port mappings that are
7242
7342
  # automatically assigned in this way do not count toward the 100
@@ -7247,14 +7347,14 @@ module Aws::ECS
7247
7347
  # The port number on the container instance to reserve for your
7248
7348
  # container.
7249
7349
  #
7250
- # If you are using containers in a task with the `awsvpc` or `host`
7251
- # network mode, the `hostPort` can either be left blank or set to the
7252
- # same value as the `containerPort`.
7350
+ # If you use containers in a task with the `awsvpc` or `host` network
7351
+ # mode, the `hostPort` can either be left blank or set to the same
7352
+ # value as the `containerPort`.
7253
7353
  #
7254
- # If you are using containers in a task with the `bridge` network
7255
- # mode, you can specify a non-reserved host port for your container
7256
- # port mapping, or you can omit the `hostPort` (or set it to `0`)
7257
- # while specifying a `containerPort` and your container automatically
7354
+ # If you use containers in a task with the `bridge` network mode, you
7355
+ # can specify a non-reserved host port for your container port
7356
+ # mapping, or you can omit the `hostPort` (or set it to `0`) while
7357
+ # specifying a `containerPort` and your container automatically
7258
7358
  # receives a port in the ephemeral port range for your container
7259
7359
  # instance operating system and Docker version.
7260
7360
  #
@@ -7275,12 +7375,12 @@ module Aws::ECS
7275
7375
  # The default reserved ports are 22 for SSH, the Docker ports 2375 and
7276
7376
  # 2376, and the Amazon ECS container agent ports 51678-51680. Any host
7277
7377
  # port that was previously specified in a running task is also
7278
- # reserved while the task is running (after a task stops, the host
7279
- # port is released). The current reserved ports are displayed in the
7280
- # `remainingResources` of DescribeContainerInstances output. A
7281
- # container instance can have up to 100 reserved ports at a time,
7282
- # including the default reserved ports. Automatically assigned ports
7283
- # don't count toward the 100 reserved ports limit.
7378
+ # reserved while the task is running. That is, after a task stops, the
7379
+ # host port is released. The current reserved ports are displayed in
7380
+ # the `remainingResources` of DescribeContainerInstances output. A
7381
+ # container instance can have up to 100 reserved ports at a time. This
7382
+ # number includes the default reserved ports. Automatically assigned
7383
+ # ports aren't included in the 100 reserved ports quota.
7284
7384
  # @return [Integer]
7285
7385
  #
7286
7386
  # @!attribute [rw] protocol
@@ -7300,13 +7400,13 @@ module Aws::ECS
7300
7400
 
7301
7401
  # The configuration details for the App Mesh proxy.
7302
7402
  #
7303
- # For tasks using the EC2 launch type, the container instances require
7304
- # at least version 1.26.0 of the container agent and at least version
7305
- # 1.26.0-1 of the `ecs-init` package to enable a proxy configuration. If
7306
- # your container instances are launched from the Amazon ECS-optimized
7307
- # AMI version `20190301` or later, then they contain the required
7308
- # versions of the container agent and `ecs-init`. For more information,
7309
- # see [Amazon ECS-optimized Linux AMI][1]
7403
+ # For tasks that use the EC2 launch type, the container instances
7404
+ # require at least version 1.26.0 of the container agent and at least
7405
+ # version 1.26.0-1 of the `ecs-init` package to enable a proxy
7406
+ # configuration. If your container instances are launched from the
7407
+ # Amazon ECS optimized AMI version `20190301` or later, then they
7408
+ # contain the required versions of the container agent and `ecs-init`.
7409
+ # For more information, see [Amazon ECS-optimized Linux AMI][1]
7310
7410
  #
7311
7411
  #
7312
7412
  #
@@ -7510,8 +7610,8 @@ module Aws::ECS
7510
7610
  #
7511
7611
  # @!attribute [rw] attributes
7512
7612
  # The attributes to apply to your resource. You can specify up to 10
7513
- # custom attributes per resource. You can specify up to 10 attributes
7514
- # in a single call.
7613
+ # custom attributes for each resource. You can specify up to 10
7614
+ # attributes in a single call.
7515
7615
  # @return [Array<Types::Attribute>]
7516
7616
  #
7517
7617
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/PutAttributesRequest AWS API Documentation
@@ -7552,7 +7652,7 @@ module Aws::ECS
7552
7652
  #
7553
7653
  # @!attribute [rw] cluster
7554
7654
  # The short name or full Amazon Resource Name (ARN) of the cluster to
7555
- # modify the capacity provider settings for. If you do not specify a
7655
+ # modify the capacity provider settings for. If you don't specify a
7556
7656
  # cluster, the default cluster is assumed.
7557
7657
  # @return [String]
7558
7658
  #
@@ -7664,9 +7764,9 @@ module Aws::ECS
7664
7764
  # }
7665
7765
  #
7666
7766
  # @!attribute [rw] cluster
7667
- # The short name or full Amazon Resource Name (ARN) of the cluster
7668
- # with which to register your container instance. If you do not
7669
- # specify a cluster, the default cluster is assumed.
7767
+ # The short name or full Amazon Resource Name (ARN) of the cluster to
7768
+ # register your container instance with. If you do not specify a
7769
+ # cluster, the default cluster is assumed.
7670
7770
  # @return [String]
7671
7771
  #
7672
7772
  # @!attribute [rw] instance_identity_document
@@ -7689,7 +7789,7 @@ module Aws::ECS
7689
7789
  #
7690
7790
  # @!attribute [rw] version_info
7691
7791
  # The version information for the Amazon ECS container agent and
7692
- # Docker daemon running on the container instance.
7792
+ # Docker daemon that runs on the container instance.
7693
7793
  # @return [Types::VersionInfo]
7694
7794
  #
7695
7795
  # @!attribute [rw] container_instance_arn
@@ -7709,7 +7809,7 @@ module Aws::ECS
7709
7809
  # @!attribute [rw] tags
7710
7810
  # The metadata that you apply to the container instance to help you
7711
7811
  # categorize and organize them. Each tag consists of a key and an
7712
- # optional value, both of which you define.
7812
+ # optional value. You define both.
7713
7813
  #
7714
7814
  # The following basic restrictions apply to tags:
7715
7815
  #
@@ -7996,12 +8096,16 @@ module Aws::ECS
7996
8096
  # ephemeral_storage: {
7997
8097
  # size_in_gi_b: 1, # required
7998
8098
  # },
8099
+ # runtime_platform: {
8100
+ # cpu_architecture: "X86_64", # accepts X86_64, ARM64
8101
+ # operating_system_family: "WINDOWS_SERVER_2019_FULL", # accepts 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
8102
+ # },
7999
8103
  # }
8000
8104
  #
8001
8105
  # @!attribute [rw] family
8002
- # You must specify a `family` for a task definition, which allows you
8003
- # to track multiple versions of the same task definition. The `family`
8004
- # is used as a name for your task definition. Up to 255 letters
8106
+ # You must specify a `family` for a task definition. You can use it
8107
+ # track multiple versions of the same task definition. The `family` is
8108
+ # used as a name for your task definition. Up to 255 letters
8005
8109
  # (uppercase and lowercase), numbers, underscores, and hyphens are
8006
8110
  # allowed.
8007
8111
  # @return [String]
@@ -8083,28 +8187,27 @@ module Aws::ECS
8083
8187
  #
8084
8188
  # @!attribute [rw] volumes
8085
8189
  # A list of volume definitions in JSON format that containers in your
8086
- # task may use.
8190
+ # task might use.
8087
8191
  # @return [Array<Types::Volume>]
8088
8192
  #
8089
8193
  # @!attribute [rw] placement_constraints
8090
8194
  # An array of placement constraint objects to use for the task. You
8091
- # can specify a maximum of 10 constraints per task (this limit
8195
+ # can specify a maximum of 10 constraints for each task. This limit
8092
8196
  # includes constraints in the task definition and those specified at
8093
- # runtime).
8197
+ # runtime.
8094
8198
  # @return [Array<Types::TaskDefinitionPlacementConstraint>]
8095
8199
  #
8096
8200
  # @!attribute [rw] requires_compatibilities
8097
- # The task launch type that Amazon ECS should validate the task
8098
- # definition against. A client exception is returned if the task
8099
- # definition doesn't validate against the compatibilities specified.
8100
- # If no value is specified, the parameter is omitted from the
8101
- # response.
8201
+ # The task launch type that Amazon ECS validates the task definition
8202
+ # against. A client exception is returned if the task definition
8203
+ # doesn't validate against the compatibilities specified. If no value
8204
+ # is specified, the parameter is omitted from the response.
8102
8205
  # @return [Array<String>]
8103
8206
  #
8104
8207
  # @!attribute [rw] cpu
8105
8208
  # The number of CPU units used by the task. It can be expressed as an
8106
- # integer using CPU units, for example `1024`, or as a string using
8107
- # vCPUs, for example `1 vCPU` or `1 vcpu`, in a task definition.
8209
+ # integer using CPU units (for example, `1024`) or as a string using
8210
+ # vCPUs (for example, `1 vCPU` or `1 vcpu`) in a task definition.
8108
8211
  # String values are converted to an integer indicating the CPU units
8109
8212
  # when the task definition is registered.
8110
8213
  #
@@ -8114,14 +8217,17 @@ module Aws::ECS
8114
8217
  #
8115
8218
  # </note>
8116
8219
  #
8117
- # If you are using the EC2 launch type, this field is optional.
8220
+ # If you're using the EC2 launch type, this field is optional.
8118
8221
  # Supported values are between `128` CPU units (`0.125` vCPUs) and
8119
8222
  # `10240` CPU units (`10` vCPUs).
8120
8223
  #
8121
- # If you are using the Fargate launch type, this field is required and
8224
+ # If you're using the Fargate launch type, this field is required and
8122
8225
  # you must use one of the following values, which determines your
8123
8226
  # range of supported values for the `memory` parameter:
8124
8227
  #
8228
+ # The CPU units cannot be less than 1 vCPU when you use Windows
8229
+ # containers on Fargate.
8230
+ #
8125
8231
  # * 256 (.25 vCPU) - Available `memory` values: 512 (0.5 GB), 1024 (1
8126
8232
  # GB), 2048 (2 GB)
8127
8233
  #
@@ -8141,9 +8247,9 @@ module Aws::ECS
8141
8247
  #
8142
8248
  # @!attribute [rw] memory
8143
8249
  # The amount of memory (in MiB) used by the task. It can be expressed
8144
- # as an integer using MiB, for example `1024`, or as a string using
8145
- # GB, for example `1GB` or `1 GB`, in a task definition. String values
8146
- # are converted to an integer indicating the MiB when the task
8250
+ # as an integer using MiB (for example ,`1024`) or as a string using
8251
+ # GB (for example, `1GB` or `1 GB`) in a task definition. String
8252
+ # values are converted to an integer indicating the MiB when the task
8147
8253
  # definition is registered.
8148
8254
  #
8149
8255
  # <note markdown="1"> Task-level CPU and memory parameters are ignored for Windows
@@ -8155,8 +8261,11 @@ module Aws::ECS
8155
8261
  # If using the EC2 launch type, this field is optional.
8156
8262
  #
8157
8263
  # If using the Fargate launch type, this field is required and you
8158
- # must use one of the following values, which determines your range of
8159
- # supported values for the `cpu` parameter:
8264
+ # must use one of the following values. This determines your range of
8265
+ # supported values for the `cpu` parameter.
8266
+ #
8267
+ # The CPU units cannot be less than 1 vCPU when you use Windows
8268
+ # containers on Fargate.
8160
8269
  #
8161
8270
  # * 512 (0.5 GB), 1024 (1 GB), 2048 (2 GB) - Available `cpu` values:
8162
8271
  # 256 (.25 vCPU)
@@ -8177,7 +8286,7 @@ module Aws::ECS
8177
8286
  # @!attribute [rw] tags
8178
8287
  # The metadata that you apply to the task definition to help you
8179
8288
  # categorize and organize them. Each tag consists of a key and an
8180
- # optional value, both of which you define.
8289
+ # optional value. You define both of them.
8181
8290
  #
8182
8291
  # The following basic restrictions apply to tags:
8183
8292
  #
@@ -8302,7 +8411,11 @@ module Aws::ECS
8302
8411
  # ECS User Guide for Fargate*.
8303
8412
  #
8304
8413
  # <note markdown="1"> This parameter is only supported for tasks hosted on Fargate using
8305
- # platform version `1.4.0` or later.
8414
+ # the following platform versions:
8415
+ #
8416
+ # * Linux platform version `1.4.0` or later.
8417
+ #
8418
+ # * Windows platform version `1.0.0` or later.
8306
8419
  #
8307
8420
  # </note>
8308
8421
  #
@@ -8311,6 +8424,14 @@ module Aws::ECS
8311
8424
  # [1]: https://docs.aws.amazon.com/AmazonECS/latest/userguide/using_data_volumes.html
8312
8425
  # @return [Types::EphemeralStorage]
8313
8426
  #
8427
+ # @!attribute [rw] runtime_platform
8428
+ # The operating system that your tasks definitions run on. A platform
8429
+ # family is specified only for tasks using the Fargate launch type.
8430
+ #
8431
+ # When you specify a task definition in a service, this value must
8432
+ # match the `runtimePlatform` value of the service.
8433
+ # @return [Types::RuntimePlatform]
8434
+ #
8314
8435
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/RegisterTaskDefinitionRequest AWS API Documentation
8315
8436
  #
8316
8437
  class RegisterTaskDefinitionRequest < Struct.new(
@@ -8329,7 +8450,8 @@ module Aws::ECS
8329
8450
  :ipc_mode,
8330
8451
  :proxy_configuration,
8331
8452
  :inference_accelerators,
8332
- :ephemeral_storage)
8453
+ :ephemeral_storage,
8454
+ :runtime_platform)
8333
8455
  SENSITIVE = []
8334
8456
  include Aws::Structure
8335
8457
  end
@@ -8364,11 +8486,11 @@ module Aws::ECS
8364
8486
  # The Amazon Resource Name (ARN) of the secret containing the private
8365
8487
  # repository credentials.
8366
8488
  #
8367
- # <note markdown="1"> When you are using the Amazon ECS API, CLI, or Amazon Web Services
8368
- # SDK, if the secret exists in the same Region as the task that you
8369
- # are launching then you can use either the full ARN or the name of
8370
- # the secret. When you are using the Amazon Web Services Management
8371
- # Console, you must specify the full ARN of the secret.
8489
+ # <note markdown="1"> When you use the Amazon ECS API, CLI, or Amazon Web Services SDK, if
8490
+ # the secret exists in the same Region as the task that you're
8491
+ # launching then you can use either the full ARN or the name of the
8492
+ # secret. When you use the Amazon Web Services Management Console, you
8493
+ # must specify the full ARN of the secret.
8372
8494
  #
8373
8495
  # </note>
8374
8496
  # @return [String]
@@ -8401,8 +8523,8 @@ module Aws::ECS
8401
8523
  # @return [String]
8402
8524
  #
8403
8525
  # @!attribute [rw] type
8404
- # The type of the resource, such as `INTEGER`, `DOUBLE`, `LONG`, or
8405
- # `STRINGSET`.
8526
+ # The type of the resource. Valid values: `INTEGER`, `DOUBLE`, `LONG`,
8527
+ # or `STRINGSET`.
8406
8528
  # @return [String]
8407
8529
  #
8408
8530
  # @!attribute [rw] double_value
@@ -8438,13 +8560,13 @@ module Aws::ECS
8438
8560
  include Aws::Structure
8439
8561
  end
8440
8562
 
8441
- # The specified resource is in-use and cannot be removed.
8563
+ # The specified resource is in-use and can't be removed.
8442
8564
  #
8443
8565
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/ResourceInUseException AWS API Documentation
8444
8566
  #
8445
8567
  class ResourceInUseException < Aws::EmptyStructure; end
8446
8568
 
8447
- # The specified resource could not be found.
8569
+ # The specified resource wasn't found.
8448
8570
  #
8449
8571
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/ResourceNotFoundException AWS API Documentation
8450
8572
  #
@@ -8473,13 +8595,13 @@ module Aws::ECS
8473
8595
  # The value for the specified resource type.
8474
8596
  #
8475
8597
  # If the `GPU` type is used, the value is the number of physical
8476
- # `GPUs` the Amazon ECS container agent will reserve for the
8477
- # container. The number of GPUs reserved for all containers in a task
8478
- # should not exceed the number of available GPUs on the container
8479
- # instance the task is launched on.
8598
+ # `GPUs` the Amazon ECS container agent reserves for the container.
8599
+ # The number of GPUs that's reserved for all containers in a task
8600
+ # can't exceed the number of available GPUs on the container instance
8601
+ # that the task is launched on.
8480
8602
  #
8481
- # If the `InferenceAccelerator` type is used, the `value` should match
8482
- # the `deviceName` for an InferenceAccelerator specified in a task
8603
+ # If the `InferenceAccelerator` type is used, the `value` matches the
8604
+ # `deviceName` for an InferenceAccelerator specified in a task
8483
8605
  # definition.
8484
8606
  # @return [String]
8485
8607
  #
@@ -8604,14 +8726,14 @@ module Aws::ECS
8604
8726
  # @return [Array<Types::CapacityProviderStrategyItem>]
8605
8727
  #
8606
8728
  # @!attribute [rw] cluster
8607
- # The short name or full Amazon Resource Name (ARN) of the cluster on
8608
- # which to run your task. If you do not specify a cluster, the default
8729
+ # The short name or full Amazon Resource Name (ARN) of the cluster to
8730
+ # run your task on. If you do not specify a cluster, the default
8609
8731
  # cluster is assumed.
8610
8732
  # @return [String]
8611
8733
  #
8612
8734
  # @!attribute [rw] count
8613
8735
  # The number of instantiations of the specified task to place on your
8614
- # cluster. You can specify up to 10 tasks per call.
8736
+ # cluster. You can specify up to 10 tasks for each call.
8615
8737
  # @return [Integer]
8616
8738
  #
8617
8739
  # @!attribute [rw] enable_ecs_managed_tags
@@ -8625,8 +8747,8 @@ module Aws::ECS
8625
8747
  # @return [Boolean]
8626
8748
  #
8627
8749
  # @!attribute [rw] enable_execute_command
8628
- # Whether or not to enable the execute command functionality for the
8629
- # containers in this task. If `true`, this enables execute command
8750
+ # Determines whether to enable the execute command functionality for
8751
+ # the containers in this task. If `true`, this enables execute command
8630
8752
  # functionality on all containers in the task.
8631
8753
  # @return [Boolean]
8632
8754
  #
@@ -8637,7 +8759,7 @@ module Aws::ECS
8637
8759
  # @return [String]
8638
8760
  #
8639
8761
  # @!attribute [rw] launch_type
8640
- # The infrastructure on which to run your standalone task. For more
8762
+ # The infrastructure to run your standalone task on. For more
8641
8763
  # information, see [Amazon ECS launch types][1] in the *Amazon Elastic
8642
8764
  # Container Service Developer Guide*.
8643
8765
  #
@@ -8653,8 +8775,8 @@ module Aws::ECS
8653
8775
  # The `EC2` launch type runs your tasks on Amazon EC2 instances
8654
8776
  # registered to your cluster.
8655
8777
  #
8656
- # The `EXTERNAL` launch type runs your tasks on your on-premise server
8657
- # or virtual machine (VM) capacity registered to your cluster.
8778
+ # The `EXTERNAL` launch type runs your tasks on your on-premises
8779
+ # server or virtual machine (VM) capacity registered to your cluster.
8658
8780
  #
8659
8781
  # A task can use either a launch type or a capacity provider strategy.
8660
8782
  # If a `launchType` is specified, the `capacityProviderStrategy`
@@ -8672,7 +8794,7 @@ module Aws::ECS
8672
8794
  # @!attribute [rw] network_configuration
8673
8795
  # The network configuration for the task. This parameter is required
8674
8796
  # for task definitions that use the `awsvpc` network mode to receive
8675
- # their own elastic network interface, and it is not supported for
8797
+ # their own elastic network interface, and it isn't supported for
8676
8798
  # other network modes. For more information, see [Task networking][1]
8677
8799
  # in the *Amazon Elastic Container Service Developer Guide*.
8678
8800
  #
@@ -8685,7 +8807,7 @@ module Aws::ECS
8685
8807
  # A list of container overrides in JSON format that specify the name
8686
8808
  # of a container in the specified task definition and the overrides it
8687
8809
  # should receive. You can override the default command for a container
8688
- # (that is specified in the task definition or Docker image) with a
8810
+ # (that's specified in the task definition or Docker image) with a
8689
8811
  # `command` override. You can also override existing environment
8690
8812
  # variables (that are specified in the task definition or Docker
8691
8813
  # image) on a container or add new environment variables to it with an
@@ -8697,20 +8819,20 @@ module Aws::ECS
8697
8819
  #
8698
8820
  # @!attribute [rw] placement_constraints
8699
8821
  # An array of placement constraint objects to use for the task. You
8700
- # can specify up to 10 constraints per task (including constraints in
8701
- # the task definition and those specified at runtime).
8822
+ # can specify up to 10 constraints for each task (including
8823
+ # constraints in the task definition and those specified at runtime).
8702
8824
  # @return [Array<Types::PlacementConstraint>]
8703
8825
  #
8704
8826
  # @!attribute [rw] placement_strategy
8705
8827
  # The placement strategy objects to use for the task. You can specify
8706
- # a maximum of 5 strategy rules per task.
8828
+ # a maximum of 5 strategy rules for each task.
8707
8829
  # @return [Array<Types::PlacementStrategy>]
8708
8830
  #
8709
8831
  # @!attribute [rw] platform_version
8710
- # The platform version the task should use. A platform version is only
8711
- # specified for tasks hosted on Fargate. If one is not specified, the
8712
- # `LATEST` platform version is used by default. For more information,
8713
- # see [Fargate platform versions][1] in the *Amazon Elastic Container
8832
+ # The platform version the task uses. A platform version is only
8833
+ # specified for tasks hosted on Fargate. If one isn't specified, the
8834
+ # `LATEST` platform version is used. For more information, see
8835
+ # [Fargate platform versions][1] in the *Amazon Elastic Container
8714
8836
  # Service Developer Guide*.
8715
8837
  #
8716
8838
  #
@@ -8720,7 +8842,7 @@ module Aws::ECS
8720
8842
  #
8721
8843
  # @!attribute [rw] propagate_tags
8722
8844
  # Specifies whether to propagate the tags from the task definition to
8723
- # the task. If no value is specified, the tags are not propagated.
8845
+ # the task. If no value is specified, the tags aren't propagated.
8724
8846
  # Tags can only be propagated to the task during task creation. To add
8725
8847
  # tags to a task after task creation, use the TagResource API action.
8726
8848
  #
@@ -8742,7 +8864,7 @@ module Aws::ECS
8742
8864
  # `startedBy` parameter. You can then identify which tasks belong to
8743
8865
  # that job by filtering the results of a ListTasks call with the
8744
8866
  # `startedBy` value. Up to 36 letters (uppercase and lowercase),
8745
- # numbers, hyphens, and underscores are allowed.
8867
+ # numbers, hyphens (-), and underscores (\_) are allowed.
8746
8868
  #
8747
8869
  # If a task is started by an Amazon ECS service, then the `startedBy`
8748
8870
  # parameter contains the deployment ID of the service that starts it.
@@ -8781,10 +8903,10 @@ module Aws::ECS
8781
8903
  #
8782
8904
  # @!attribute [rw] task_definition
8783
8905
  # The `family` and `revision` (`family:revision`) or full ARN of the
8784
- # task definition to run. If a `revision` is not specified, the latest
8906
+ # task definition to run. If a `revision` isn't specified, the latest
8785
8907
  # `ACTIVE` revision is used.
8786
8908
  #
8787
- # The full ARN value must match the value that you specified ias the
8909
+ # The full ARN value must match the value that you specified as the
8788
8910
  # `Resource` of the IAM principal's permissions policy. For example,
8789
8911
  # if the `Resource` is
8790
8912
  # arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName:*,
@@ -8834,6 +8956,33 @@ module Aws::ECS
8834
8956
  include Aws::Structure
8835
8957
  end
8836
8958
 
8959
+ # Information about the platform for the Amazon ECS service or task.
8960
+ #
8961
+ # @note When making an API call, you may pass RuntimePlatform
8962
+ # data as a hash:
8963
+ #
8964
+ # {
8965
+ # cpu_architecture: "X86_64", # accepts X86_64, ARM64
8966
+ # operating_system_family: "WINDOWS_SERVER_2019_FULL", # accepts 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
8967
+ # }
8968
+ #
8969
+ # @!attribute [rw] cpu_architecture
8970
+ # The CPU architecture.
8971
+ # @return [String]
8972
+ #
8973
+ # @!attribute [rw] operating_system_family
8974
+ # The operating system.
8975
+ # @return [String]
8976
+ #
8977
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/RuntimePlatform AWS API Documentation
8978
+ #
8979
+ class RuntimePlatform < Struct.new(
8980
+ :cpu_architecture,
8981
+ :operating_system_family)
8982
+ SENSITIVE = []
8983
+ include Aws::Structure
8984
+ end
8985
+
8837
8986
  # A floating-point percentage of the desired number of tasks to place
8838
8987
  # and keep running in the task set.
8839
8988
  #
@@ -8898,7 +9047,7 @@ module Aws::ECS
8898
9047
  # the parameter in the SSM Parameter Store.
8899
9048
  #
8900
9049
  # <note markdown="1"> If the SSM Parameter Store parameter exists in the same Region as
8901
- # the task you are launching, then you can use either the full ARN or
9050
+ # the task you're launching, then you can use either the full ARN or
8902
9051
  # name of the parameter. If the parameter exists in a different
8903
9052
  # Region, then the full ARN must be specified.
8904
9053
  #
@@ -8940,9 +9089,9 @@ module Aws::ECS
8940
9089
  # @!attribute [rw] service_name
8941
9090
  # The name of your service. Up to 255 letters (uppercase and
8942
9091
  # lowercase), numbers, underscores, and hyphens are allowed. Service
8943
- # names must be unique within a cluster, but you can have similarly
8944
- # named services in multiple clusters within a Region or across
8945
- # multiple Regions.
9092
+ # names must be unique within a cluster. However, you can have
9093
+ # similarly named services in multiple clusters within a Region or
9094
+ # across multiple Regions.
8946
9095
  # @return [String]
8947
9096
  #
8948
9097
  # @!attribute [rw] cluster_arn
@@ -8951,14 +9100,14 @@ module Aws::ECS
8951
9100
  # @return [String]
8952
9101
  #
8953
9102
  # @!attribute [rw] load_balancers
8954
- # A list of Elastic Load Balancing load balancer objects, containing
8955
- # the load balancer name, the container name (as it appears in a
8956
- # container definition), and the container port to access from the
8957
- # load balancer.
9103
+ # A list of Elastic Load Balancing load balancer objects. It contains
9104
+ # the load balancer name, the container name, and the container port
9105
+ # to access from the load balancer. The container name is as it
9106
+ # appears in a container definition.
8958
9107
  # @return [Array<Types::LoadBalancer>]
8959
9108
  #
8960
9109
  # @!attribute [rw] service_registries
8961
- # The details of the service discovery registries to assign to this
9110
+ # The details for the service discovery registries to assign to this
8962
9111
  # service. For more information, see [Service Discovery][1].
8963
9112
  #
8964
9113
  #
@@ -8993,16 +9142,16 @@ module Aws::ECS
8993
9142
  # @return [String]
8994
9143
  #
8995
9144
  # @!attribute [rw] capacity_provider_strategy
8996
- # The capacity provider strategy the service is using. When using the
9145
+ # The capacity provider strategy the service uses. When using the
8997
9146
  # DescribeServices API, this field is omitted if the service was
8998
9147
  # created using a launch type.
8999
9148
  # @return [Array<Types::CapacityProviderStrategyItem>]
9000
9149
  #
9001
9150
  # @!attribute [rw] platform_version
9002
- # The platform version on which to run your service. A platform
9003
- # version is only specified for tasks hosted on Fargate. If one is not
9004
- # specified, the `LATEST` platform version is used by default. For
9005
- # more information, see [Fargate Platform Versions][1] in the *Amazon
9151
+ # The platform version to run your service on. A platform version is
9152
+ # only specified for tasks that are hosted on Fargate. If one isn't
9153
+ # specified, the `LATEST` platform version is used. For more
9154
+ # information, see [Fargate Platform Versions][1] in the *Amazon
9006
9155
  # Elastic Container Service Developer Guide*.
9007
9156
  #
9008
9157
  #
@@ -9010,6 +9159,15 @@ module Aws::ECS
9010
9159
  # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/platform_versions.html
9011
9160
  # @return [String]
9012
9161
  #
9162
+ # @!attribute [rw] platform_family
9163
+ # The operating system that your tasks in the service run on. A
9164
+ # platform family is specified only for tasks using the Fargate launch
9165
+ # type.
9166
+ #
9167
+ # All tasks that run as part of this service must use the same
9168
+ # `platformFamily` value as the service (for example, `LINUX`).
9169
+ # @return [String]
9170
+ #
9013
9171
  # @!attribute [rw] task_definition
9014
9172
  # The task definition to use for tasks in the service. This value is
9015
9173
  # specified when the service is created with CreateService, and it can
@@ -9034,9 +9192,9 @@ module Aws::ECS
9034
9192
  # @return [Array<Types::Deployment>]
9035
9193
  #
9036
9194
  # @!attribute [rw] role_arn
9037
- # The ARN of the IAM role associated with the service that allows the
9038
- # Amazon ECS container agent to register container instances with an
9039
- # Elastic Load Balancing load balancer.
9195
+ # The ARN of the IAM role that's associated with the service. It
9196
+ # allows the Amazon ECS container agent to register container
9197
+ # instances with an Elastic Load Balancing load balancer.
9040
9198
  # @return [String]
9041
9199
  #
9042
9200
  # @!attribute [rw] events
@@ -9045,7 +9203,7 @@ module Aws::ECS
9045
9203
  # @return [Array<Types::ServiceEvent>]
9046
9204
  #
9047
9205
  # @!attribute [rw] created_at
9048
- # The Unix timestamp for when the service was created.
9206
+ # The Unix timestamp for the time when the service was created.
9049
9207
  # @return [Time]
9050
9208
  #
9051
9209
  # @!attribute [rw] placement_constraints
@@ -9073,7 +9231,7 @@ module Aws::ECS
9073
9231
  # The scheduling strategy to use for the service. For more
9074
9232
  # information, see [Services][1].
9075
9233
  #
9076
- # There are two service scheduler strategies available:
9234
+ # There are two service scheduler strategies available.
9077
9235
  #
9078
9236
  # * `REPLICA`-The replica scheduling strategy places and maintains the
9079
9237
  # desired number of tasks across your cluster. By default, the
@@ -9082,13 +9240,13 @@ module Aws::ECS
9082
9240
  # placement decisions.
9083
9241
  #
9084
9242
  # * `DAEMON`-The daemon scheduling strategy deploys exactly one task
9085
- # on each active container instance that meets all of the task
9243
+ # on each active container instance. This taskmeets all of the task
9086
9244
  # placement constraints that you specify in your cluster. The
9087
9245
  # service scheduler also evaluates the task placement constraints
9088
- # for running tasks and will stop tasks that do not meet the
9089
- # placement constraints.
9246
+ # for running tasks. It stop tasks that don't meet the placement
9247
+ # constraints.
9090
9248
  #
9091
- # <note markdown="1"> Fargate tasks do not support the `DAEMON` scheduling strategy.
9249
+ # <note markdown="1"> Fargate tasks don't support the `DAEMON` scheduling strategy.
9092
9250
  #
9093
9251
  # </note>
9094
9252
  #
@@ -9099,14 +9257,14 @@ module Aws::ECS
9099
9257
  #
9100
9258
  # @!attribute [rw] deployment_controller
9101
9259
  # The deployment controller type the service is using. When using the
9102
- # DescribeServices API, this field is omitted if the service is using
9103
- # the `ECS` deployment controller type.
9260
+ # DescribeServices API, this field is omitted if the service uses the
9261
+ # `ECS` deployment controller type.
9104
9262
  # @return [Types::DeploymentController]
9105
9263
  #
9106
9264
  # @!attribute [rw] tags
9107
9265
  # The metadata that you apply to the service to help you categorize
9108
- # and organize them. Each tag consists of a key and an optional value,
9109
- # both of which you define.
9266
+ # and organize them. Each tag consists of a key and an optional value.
9267
+ # You define bot the key and value.
9110
9268
  #
9111
9269
  # The following basic restrictions apply to tags:
9112
9270
  #
@@ -9139,8 +9297,8 @@ module Aws::ECS
9139
9297
  # @return [String]
9140
9298
  #
9141
9299
  # @!attribute [rw] enable_ecs_managed_tags
9142
- # Specifies whether to enable Amazon ECS managed tags for the tasks in
9143
- # the service. For more information, see [Tagging Your Amazon ECS
9300
+ # Determines whether to enable Amazon ECS managed tags for the tasks
9301
+ # in the service. For more information, see [Tagging Your Amazon ECS
9144
9302
  # Resources][1] in the *Amazon Elastic Container Service Developer
9145
9303
  # Guide*.
9146
9304
  #
@@ -9150,15 +9308,15 @@ module Aws::ECS
9150
9308
  # @return [Boolean]
9151
9309
  #
9152
9310
  # @!attribute [rw] propagate_tags
9153
- # Specifies whether to propagate the tags from the task definition or
9154
- # the service to the task. If no value is specified, the tags are not
9311
+ # Determines whether to propagate the tags from the task definition or
9312
+ # the service to the task. If no value is specified, the tags aren't
9155
9313
  # propagated.
9156
9314
  # @return [String]
9157
9315
  #
9158
9316
  # @!attribute [rw] enable_execute_command
9159
- # Whether or not the execute command functionality is enabled for the
9160
- # service. If `true`, the execute command functionality is enabled for
9161
- # all containers in tasks as part of the service.
9317
+ # Determines whether the execute command functionality is enabled for
9318
+ # the service. If `true`, the execute command functionality is enabled
9319
+ # for all containers in tasks as part of the service.
9162
9320
  # @return [Boolean]
9163
9321
  #
9164
9322
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/Service AWS API Documentation
@@ -9176,6 +9334,7 @@ module Aws::ECS
9176
9334
  :launch_type,
9177
9335
  :capacity_provider_strategy,
9178
9336
  :platform_version,
9337
+ :platform_family,
9179
9338
  :task_definition,
9180
9339
  :deployment_configuration,
9181
9340
  :task_sets,
@@ -9198,14 +9357,14 @@ module Aws::ECS
9198
9357
  include Aws::Structure
9199
9358
  end
9200
9359
 
9201
- # Details on an event associated with a service.
9360
+ # The details for an event that's associated with a service.
9202
9361
  #
9203
9362
  # @!attribute [rw] id
9204
- # The ID string of the event.
9363
+ # The ID string for the event.
9205
9364
  # @return [String]
9206
9365
  #
9207
9366
  # @!attribute [rw] created_at
9208
- # The Unix timestamp for when the event was triggered.
9367
+ # The Unix timestamp for the time when the event was triggered.
9209
9368
  # @return [Time]
9210
9369
  #
9211
9370
  # @!attribute [rw] message
@@ -9222,23 +9381,23 @@ module Aws::ECS
9222
9381
  include Aws::Structure
9223
9382
  end
9224
9383
 
9225
- # The specified service is not active. You can't update a service that
9226
- # is inactive. If you have previously deleted a service, you can
9384
+ # The specified service isn't active. You can't update a service
9385
+ # that's inactive. If you have previously deleted a service, you can
9227
9386
  # re-create it with CreateService.
9228
9387
  #
9229
9388
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/ServiceNotActiveException AWS API Documentation
9230
9389
  #
9231
9390
  class ServiceNotActiveException < Aws::EmptyStructure; end
9232
9391
 
9233
- # The specified service could not be found. You can view your available
9234
- # services with ListServices. Amazon ECS services are cluster-specific
9235
- # and Region-specific.
9392
+ # The specified service wasn't found. You can view your available
9393
+ # services with ListServices. Amazon ECS services are cluster specific
9394
+ # and Region specific.
9236
9395
  #
9237
9396
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/ServiceNotFoundException AWS API Documentation
9238
9397
  #
9239
9398
  class ServiceNotFoundException < Aws::EmptyStructure; end
9240
9399
 
9241
- # Details of the service registry.
9400
+ # The details for the service registry.
9242
9401
  #
9243
9402
  # @note When making an API call, you may pass ServiceRegistry
9244
9403
  # data as a hash:
@@ -9262,31 +9421,32 @@ module Aws::ECS
9262
9421
  #
9263
9422
  # @!attribute [rw] port
9264
9423
  # The port value used if your service discovery service specified an
9265
- # SRV record. This field may be used if both the `awsvpc` network mode
9266
- # and SRV records are used.
9424
+ # SRV record. This field might be used if both the `awsvpc` network
9425
+ # mode and SRV records are used.
9267
9426
  # @return [Integer]
9268
9427
  #
9269
9428
  # @!attribute [rw] container_name
9270
- # The container name value, already specified in the task definition,
9271
- # to be used for your service discovery service. If the task
9429
+ # The container name value to be used for your service discovery
9430
+ # service. It's already specified in the task definition. If the task
9272
9431
  # definition that your service task specifies uses the `bridge` or
9273
9432
  # `host` network mode, you must specify a `containerName` and
9274
9433
  # `containerPort` combination from the task definition. If the task
9275
9434
  # definition that your service task specifies uses the `awsvpc`
9276
9435
  # network mode and a type SRV DNS record is used, you must specify
9277
9436
  # either a `containerName` and `containerPort` combination or a `port`
9278
- # value, but not both.
9437
+ # value. However, you can't specify both.
9279
9438
  # @return [String]
9280
9439
  #
9281
9440
  # @!attribute [rw] container_port
9282
- # The port value, already specified in the task definition, to be used
9283
- # for your service discovery service. If the task definition your
9284
- # service task specifies uses the `bridge` or `host` network mode, you
9285
- # must specify a `containerName` and `containerPort` combination from
9286
- # the task definition. If the task definition your service task
9287
- # specifies uses the `awsvpc` network mode and a type SRV DNS record
9288
- # is used, you must specify either a `containerName` and
9289
- # `containerPort` combination or a `port` value, but not both.
9441
+ # The port value to be used for your service discovery service. It's
9442
+ # already specified in the task definition. If the task definition
9443
+ # your service task specifies uses the `bridge` or `host` network
9444
+ # mode, you must specify a `containerName` and `containerPort`
9445
+ # combination from the task definition. If the task definition your
9446
+ # service task specifies uses the `awsvpc` network mode and a type SRV
9447
+ # DNS record is used, you must specify either a `containerName` and
9448
+ # `containerPort` combination or a `port` value. However, you can't
9449
+ # specify both.
9290
9450
  # @return [Integer]
9291
9451
  #
9292
9452
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/ServiceRegistry AWS API Documentation
@@ -9300,7 +9460,7 @@ module Aws::ECS
9300
9460
  include Aws::Structure
9301
9461
  end
9302
9462
 
9303
- # The details of the execute command session.
9463
+ # The details for the execute command session.
9304
9464
  #
9305
9465
  # @!attribute [rw] session_id
9306
9466
  # The ID of the execute command session.
@@ -9314,7 +9474,7 @@ module Aws::ECS
9314
9474
  #
9315
9475
  # @!attribute [rw] token_value
9316
9476
  # An encrypted token value containing session and caller information.
9317
- # Used to authenticate the connection to the container.
9477
+ # It's used to authenticate the connection to the container.
9318
9478
  # @return [String]
9319
9479
  #
9320
9480
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/Session AWS API Documentation
@@ -9334,12 +9494,12 @@ module Aws::ECS
9334
9494
  # @return [String]
9335
9495
  #
9336
9496
  # @!attribute [rw] value
9337
- # Whether the account setting is enabled or disabled for the specified
9338
- # resource.
9497
+ # Determines whether the account setting is enabled or disabled for
9498
+ # the specified resource.
9339
9499
  # @return [String]
9340
9500
  #
9341
9501
  # @!attribute [rw] principal_arn
9342
- # The ARN of the principal, which can be an IAM user, IAM role, or the
9502
+ # The ARN of the principal. It can be an IAM user, IAM role, or the
9343
9503
  # root user. If this field is omitted, the authenticated user is
9344
9504
  # assumed.
9345
9505
  # @return [String]
@@ -9425,15 +9585,15 @@ module Aws::ECS
9425
9585
  # }
9426
9586
  #
9427
9587
  # @!attribute [rw] cluster
9428
- # The short name or full Amazon Resource Name (ARN) of the cluster on
9429
- # which to start your task. If you do not specify a cluster, the
9588
+ # The short name or full Amazon Resource Name (ARN) of the cluster
9589
+ # where to start your task. If you do not specify a cluster, the
9430
9590
  # default cluster is assumed.
9431
9591
  # @return [String]
9432
9592
  #
9433
9593
  # @!attribute [rw] container_instances
9434
9594
  # The container instance IDs or full ARN entries for the container
9435
- # instances on which you would like to place your task. You can
9436
- # specify up to 10 container instances.
9595
+ # instances where you would like to place your task. You can specify
9596
+ # up to 10 container instances.
9437
9597
  # @return [Array<String>]
9438
9598
  #
9439
9599
  # @!attribute [rw] enable_ecs_managed_tags
@@ -9467,8 +9627,8 @@ module Aws::ECS
9467
9627
  # @!attribute [rw] overrides
9468
9628
  # A list of container overrides in JSON format that specify the name
9469
9629
  # of a container in the specified task definition and the overrides it
9470
- # should receive. You can override the default command for a container
9471
- # (that is specified in the task definition or Docker image) with a
9630
+ # receives. You can override the default command for a container
9631
+ # (that's specified in the task definition or Docker image) with a
9472
9632
  # `command` override. You can also override existing environment
9473
9633
  # variables (that are specified in the task definition or Docker
9474
9634
  # image) on a container or add new environment variables to it with an
@@ -9482,7 +9642,7 @@ module Aws::ECS
9482
9642
  #
9483
9643
  # @!attribute [rw] propagate_tags
9484
9644
  # Specifies whether to propagate the tags from the task definition or
9485
- # the service to the task. If no value is specified, the tags are not
9645
+ # the service to the task. If no value is specified, the tags aren't
9486
9646
  # propagated.
9487
9647
  # @return [String]
9488
9648
  #
@@ -9497,9 +9657,9 @@ module Aws::ECS
9497
9657
  # `startedBy` parameter. You can then identify which tasks belong to
9498
9658
  # that job by filtering the results of a ListTasks call with the
9499
9659
  # `startedBy` value. Up to 36 letters (uppercase and lowercase),
9500
- # numbers, hyphens, and underscores are allowed.
9660
+ # numbers, hyphens (-), and underscores (\_) are allowed.
9501
9661
  #
9502
- # If a task is started by an Amazon ECS service, then the `startedBy`
9662
+ # If a task is started by an Amazon ECS service, the `startedBy`
9503
9663
  # parameter contains the deployment ID of the service that starts it.
9504
9664
  # @return [String]
9505
9665
  #
@@ -9536,7 +9696,7 @@ module Aws::ECS
9536
9696
  #
9537
9697
  # @!attribute [rw] task_definition
9538
9698
  # The `family` and `revision` (`family:revision`) or full ARN of the
9539
- # task definition to start. If a `revision` is not specified, the
9699
+ # task definition to start. If a `revision` isn't specified, the
9540
9700
  # latest `ACTIVE` revision is used.
9541
9701
  # @return [String]
9542
9702
  #
@@ -9598,7 +9758,7 @@ module Aws::ECS
9598
9758
  #
9599
9759
  # @!attribute [rw] reason
9600
9760
  # An optional message specified when a task is stopped. For example,
9601
- # if you are using a custom scheduler, you can use this parameter to
9761
+ # if you're using a custom scheduler, you can use this parameter to
9602
9762
  # specify the reason for stopping the task here, and the message
9603
9763
  # appears in subsequent DescribeTasks API operations on this task. Up
9604
9764
  # to 255 characters are allowed in this message.
@@ -9712,7 +9872,7 @@ module Aws::ECS
9712
9872
  # @return [String]
9713
9873
  #
9714
9874
  # @!attribute [rw] exit_code
9715
- # The exit code returned for the state change request.
9875
+ # The exit code that's returned for the state change request.
9716
9876
  # @return [Integer]
9717
9877
  #
9718
9878
  # @!attribute [rw] reason
@@ -9813,7 +9973,7 @@ module Aws::ECS
9813
9973
  # @return [String]
9814
9974
  #
9815
9975
  # @!attribute [rw] containers
9816
- # Any containers associated with the state change request.
9976
+ # Any containers that's associated with the state change request.
9817
9977
  # @return [Array<Types::ContainerStateChange>]
9818
9978
  #
9819
9979
  # @!attribute [rw] attachments
@@ -9821,19 +9981,21 @@ module Aws::ECS
9821
9981
  # @return [Array<Types::AttachmentStateChange>]
9822
9982
  #
9823
9983
  # @!attribute [rw] managed_agents
9824
- # The details for the managed agent associated with the task.
9984
+ # The details for the managed agent that's associated with the task.
9825
9985
  # @return [Array<Types::ManagedAgentStateChange>]
9826
9986
  #
9827
9987
  # @!attribute [rw] pull_started_at
9828
- # The Unix timestamp for when the container image pull began.
9988
+ # The Unix timestamp for the time when the container image pull
9989
+ # started.
9829
9990
  # @return [Time]
9830
9991
  #
9831
9992
  # @!attribute [rw] pull_stopped_at
9832
- # The Unix timestamp for when the container image pull completed.
9993
+ # The Unix timestamp for the time when the container image pull
9994
+ # completed.
9833
9995
  # @return [Time]
9834
9996
  #
9835
9997
  # @!attribute [rw] execution_stopped_at
9836
- # The Unix timestamp for when the task execution stopped.
9998
+ # The Unix timestamp for the time when the task execution stopped.
9837
9999
  # @return [Time]
9838
10000
  #
9839
10001
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/SubmitTaskStateChangeRequest AWS API Documentation
@@ -9870,21 +10032,21 @@ module Aws::ECS
9870
10032
  # the [Docker Remote API][2] and the `--sysctl` option to [docker
9871
10033
  # run][3].
9872
10034
  #
9873
- # It is not recommended that you specify network-related
9874
- # `systemControls` parameters for multiple containers in a single task
9875
- # that also uses either the `awsvpc` or `host` network mode for the
9876
- # following reasons:
10035
+ # We don't recommend that you specify network-related `systemControls`
10036
+ # parameters for multiple containers in a single task. This task also
10037
+ # uses either the `awsvpc` or `host` network mode. It does it for the
10038
+ # following reasons.
9877
10039
  #
9878
10040
  # * For tasks that use the `awsvpc` network mode, if you set
9879
10041
  # `systemControls` for any container, it applies to all containers in
9880
10042
  # the task. If you set different `systemControls` for multiple
9881
- # containers in a single task, the container that is started last
10043
+ # containers in a single task, the container that's started last
9882
10044
  # determines which `systemControls` take effect.
9883
10045
  #
9884
10046
  # * For tasks that use the `host` network mode, the `systemControls`
9885
- # parameter applies to the container instance's kernel parameter as
9886
- # well as that of all containers of any tasks running on that
9887
- # container instance.
10047
+ # parameter applies to the container instance's kernel parameter and
10048
+ # that of all containers of any tasks running on that container
10049
+ # instance.
9888
10050
  #
9889
10051
  #
9890
10052
  #
@@ -9901,11 +10063,11 @@ module Aws::ECS
9901
10063
  # }
9902
10064
  #
9903
10065
  # @!attribute [rw] namespace
9904
- # The namespaced kernel parameter for which to set a `value`.
10066
+ # The namespaced kernel parameter to set a `value` for.
9905
10067
  # @return [String]
9906
10068
  #
9907
10069
  # @!attribute [rw] value
9908
- # The value for the namespaced kernel parameter specified in
10070
+ # The value for the namespaced kernel parameter that's specified in
9909
10071
  # `namespace`.
9910
10072
  # @return [String]
9911
10073
  #
@@ -9919,8 +10081,8 @@ module Aws::ECS
9919
10081
  end
9920
10082
 
9921
10083
  # The metadata that you apply to a resource to help you categorize and
9922
- # organize them. Each tag consists of a key and an optional value, both
9923
- # of which you define.
10084
+ # organize them. Each tag consists of a key and an optional value. You
10085
+ # define them.
9924
10086
  #
9925
10087
  # The following basic restrictions apply to tags:
9926
10088
  #
@@ -9989,7 +10151,7 @@ module Aws::ECS
9989
10151
  # }
9990
10152
  #
9991
10153
  # @!attribute [rw] resource_arn
9992
- # The Amazon Resource Name (ARN) of the resource to which to add tags.
10154
+ # The Amazon Resource Name (ARN) of the resource to add tags to.
9993
10155
  # Currently, the supported resources are Amazon ECS capacity
9994
10156
  # providers, tasks, services, task definitions, clusters, and
9995
10157
  # container instances.
@@ -10038,14 +10200,14 @@ module Aws::ECS
10038
10200
  #
10039
10201
  class TagResourceResponse < Aws::EmptyStructure; end
10040
10202
 
10041
- # The target container is not properly configured with the execute
10203
+ # The target container isn't properly configured with the execute
10042
10204
  # command agent or the container is no longer active or running.
10043
10205
  #
10044
10206
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/TargetNotConnectedException AWS API Documentation
10045
10207
  #
10046
10208
  class TargetNotConnectedException < Aws::EmptyStructure; end
10047
10209
 
10048
- # The specified target could not be found. You can view your available
10210
+ # The specified target wasn't found. You can view your available
10049
10211
  # container instances with ListContainerInstances. Amazon ECS container
10050
10212
  # instances are cluster-specific and Region-specific.
10051
10213
  #
@@ -10056,8 +10218,8 @@ module Aws::ECS
10056
10218
  # Details on a task in a cluster.
10057
10219
  #
10058
10220
  # @!attribute [rw] attachments
10059
- # The Elastic Network Adapter associated with the task if the task
10060
- # uses the `awsvpc` network mode.
10221
+ # The Elastic Network Adapter that's associated with the task if the
10222
+ # task uses the `awsvpc` network mode.
10061
10223
  # @return [Array<Types::Attachment>]
10062
10224
  #
10063
10225
  # @!attribute [rw] attributes
@@ -10065,11 +10227,11 @@ module Aws::ECS
10065
10227
  # @return [Array<Types::Attribute>]
10066
10228
  #
10067
10229
  # @!attribute [rw] availability_zone
10068
- # The availability zone of the task.
10230
+ # The Availability Zone for the task.
10069
10231
  # @return [String]
10070
10232
  #
10071
10233
  # @!attribute [rw] capacity_provider_name
10072
- # The capacity provider associated with the task.
10234
+ # The capacity provider that's associated with the task.
10073
10235
  # @return [String]
10074
10236
  #
10075
10237
  # @!attribute [rw] cluster_arn
@@ -10081,8 +10243,8 @@ module Aws::ECS
10081
10243
  # @return [String]
10082
10244
  #
10083
10245
  # @!attribute [rw] connectivity_at
10084
- # The Unix timestamp for when the task last went into `CONNECTED`
10085
- # status.
10246
+ # The Unix timestamp for the time when the task last went into
10247
+ # `CONNECTED` status.
10086
10248
  # @return [Time]
10087
10249
  #
10088
10250
  # @!attribute [rw] container_instance_arn
@@ -10090,24 +10252,27 @@ module Aws::ECS
10090
10252
  # @return [String]
10091
10253
  #
10092
10254
  # @!attribute [rw] containers
10093
- # The containers associated with the task.
10255
+ # The containers that's associated with the task.
10094
10256
  # @return [Array<Types::Container>]
10095
10257
  #
10096
10258
  # @!attribute [rw] cpu
10097
10259
  # The number of CPU units used by the task as expressed in a task
10098
- # definition. It can be expressed as an integer using CPU units, for
10099
- # example `1024`. It can also be expressed as a string using vCPUs,
10100
- # for example `1 vCPU` or `1 vcpu`. String values are converted to an
10101
- # integer indicating the CPU units when the task definition is
10260
+ # definition. It can be expressed as an integer using CPU units (for
10261
+ # example, `1024`). It can also be expressed as a string using vCPUs
10262
+ # (for example, `1 vCPU` or `1 vcpu`). String values are converted to
10263
+ # an integer that indicates the CPU units when the task definition is
10102
10264
  # registered.
10103
10265
  #
10104
- # If you are using the EC2 launch type, this field is optional.
10105
- # Supported values are between `128` CPU units (`0.125` vCPUs) and
10106
- # `10240` CPU units (`10` vCPUs).
10266
+ # If you use the EC2 launch type, this field is optional. Supported
10267
+ # values are between `128` CPU units (`0.125` vCPUs) and `10240` CPU
10268
+ # units (`10` vCPUs).
10107
10269
  #
10108
- # If you are using the Fargate launch type, this field is required and
10109
- # you must use one of the following values, which determines your
10110
- # range of supported values for the `memory` parameter:
10270
+ # If you use the Fargate launch type, this field is required. You must
10271
+ # use one of the following values. These values determine the range of
10272
+ # supported values for the `memory` parameter:
10273
+ #
10274
+ # The CPU units cannot be less than 1 vCPU when you use Windows
10275
+ # containers on Fargate.
10111
10276
  #
10112
10277
  # * 256 (.25 vCPU) - Available `memory` values: 512 (0.5 GB), 1024 (1
10113
10278
  # GB), 2048 (2 GB)
@@ -10127,8 +10292,9 @@ module Aws::ECS
10127
10292
  # @return [String]
10128
10293
  #
10129
10294
  # @!attribute [rw] created_at
10130
- # The Unix timestamp for when the task was created (the task entered
10131
- # the `PENDING` state).
10295
+ # The Unix timestamp for the time when the task was created. More
10296
+ # specifically, it's for the time when the task entered the `PENDING`
10297
+ # state.
10132
10298
  # @return [Time]
10133
10299
  #
10134
10300
  # @!attribute [rw] desired_status
@@ -10141,43 +10307,44 @@ module Aws::ECS
10141
10307
  # @return [String]
10142
10308
  #
10143
10309
  # @!attribute [rw] enable_execute_command
10144
- # Whether or not execute command functionality is enabled for this
10145
- # task. If `true`, this enables execute command functionality on all
10310
+ # Determines whether execute command functionality is enabled for this
10311
+ # task. If `true`, execute command functionality is enabled on all the
10146
10312
  # containers in the task.
10147
10313
  # @return [Boolean]
10148
10314
  #
10149
10315
  # @!attribute [rw] execution_stopped_at
10150
- # The Unix timestamp for when the task execution stopped.
10316
+ # The Unix timestamp for the time when the task execution stopped.
10151
10317
  # @return [Time]
10152
10318
  #
10153
10319
  # @!attribute [rw] group
10154
- # The name of the task group associated with the task.
10320
+ # The name of the task group that's associated with the task.
10155
10321
  # @return [String]
10156
10322
  #
10157
10323
  # @!attribute [rw] health_status
10158
- # The health status for the task, which is determined by the health of
10324
+ # The health status for the task. It's determined by the health of
10159
10325
  # the essential containers in the task. If all essential containers in
10160
- # the task are reporting as `HEALTHY`, then the task status also
10161
- # reports as `HEALTHY`. If any essential containers in the task are
10162
- # reporting as `UNHEALTHY` or `UNKNOWN`, then the task status also
10163
- # reports as `UNHEALTHY` or `UNKNOWN`, accordingly.
10164
- #
10165
- # <note markdown="1"> The Amazon ECS container agent does not monitor or report on Docker
10166
- # health checks that are embedded in a container image (such as those
10167
- # specified in a parent image or from the image's Dockerfile) and not
10168
- # specified in the container definition. Health check parameters that
10169
- # are specified in a container definition override any Docker health
10170
- # checks that exist in the container image.
10326
+ # the task are reporting as `HEALTHY`, the task status also reports as
10327
+ # `HEALTHY`. If any essential containers in the task are reporting as
10328
+ # `UNHEALTHY` or `UNKNOWN`, the task status also reports as
10329
+ # `UNHEALTHY` or `UNKNOWN`.
10330
+ #
10331
+ # <note markdown="1"> The Amazon ECS container agent doesn't monitor or report on Docker
10332
+ # health checks that are embedded in a container image and not
10333
+ # specified in the container definition. For example, this includes
10334
+ # those specified in a parent image or from the image's Dockerfile.
10335
+ # Health check parameters that are specified in a container definition
10336
+ # override any Docker health checks that are found in the container
10337
+ # image.
10171
10338
  #
10172
10339
  # </note>
10173
10340
  # @return [String]
10174
10341
  #
10175
10342
  # @!attribute [rw] inference_accelerators
10176
- # The Elastic Inference accelerator associated with the task.
10343
+ # The Elastic Inference accelerator that's associated with the task.
10177
10344
  # @return [Array<Types::InferenceAccelerator>]
10178
10345
  #
10179
10346
  # @!attribute [rw] last_status
10180
- # The last known status of the task. For more information, see [Task
10347
+ # The last known status for the task. For more information, see [Task
10181
10348
  # Lifecycle][1].
10182
10349
  #
10183
10350
  #
@@ -10186,9 +10353,9 @@ module Aws::ECS
10186
10353
  # @return [String]
10187
10354
  #
10188
10355
  # @!attribute [rw] launch_type
10189
- # The infrastructure on which your task is running. For more
10190
- # information, see [Amazon ECS launch types][1] in the *Amazon Elastic
10191
- # Container Service Developer Guide*.
10356
+ # The infrastructure where your task runs on. For more information,
10357
+ # see [Amazon ECS launch types][1] in the *Amazon Elastic Container
10358
+ # Service Developer Guide*.
10192
10359
  #
10193
10360
  #
10194
10361
  #
@@ -10196,17 +10363,17 @@ module Aws::ECS
10196
10363
  # @return [String]
10197
10364
  #
10198
10365
  # @!attribute [rw] memory
10199
- # The amount of memory (in MiB) used by the task as expressed in a
10200
- # task definition. It can be expressed as an integer using MiB, for
10201
- # example `1024`. It can also be expressed as a string using GB, for
10202
- # example `1GB` or `1 GB`. String values are converted to an integer
10203
- # indicating the MiB when the task definition is registered.
10366
+ # The amount of memory (in MiB) that the task uses as expressed in a
10367
+ # task definition. It can be expressed as an integer using MiB (for
10368
+ # example, `1024`). If it's expressed as a string using GB (for
10369
+ # example, `1GB` or `1 GB`), it's converted to an integer indicating
10370
+ # the MiB when the task definition is registered.
10204
10371
  #
10205
- # If you are using the EC2 launch type, this field is optional.
10372
+ # If you use the EC2 launch type, this field is optional.
10206
10373
  #
10207
- # If you are using the Fargate launch type, this field is required and
10208
- # you must use one of the following values, which determines your
10209
- # range of supported values for the `cpu` parameter:
10374
+ # If you use the Fargate launch type, this field is required. You must
10375
+ # use one of the following values. The value that you choose
10376
+ # determines the range of supported values for the `cpu` parameter.
10210
10377
  #
10211
10378
  # * 512 (0.5 GB), 1024 (1 GB), 2048 (2 GB) - Available `cpu` values:
10212
10379
  # 256 (.25 vCPU)
@@ -10229,44 +10396,55 @@ module Aws::ECS
10229
10396
  # @return [Types::TaskOverride]
10230
10397
  #
10231
10398
  # @!attribute [rw] platform_version
10232
- # The platform version on which your task is running. A platform
10233
- # version is only specified for tasks using the Fargate launch type.
10234
- # If one is not specified, the `LATEST` platform version is used by
10235
- # default. For more information, see [Fargate Platform Versions][1] in
10236
- # the *Amazon Elastic Container Service Developer Guide*.
10399
+ # The platform version where your task runs on. A platform version is
10400
+ # only specified for tasks that use the Fargate launch type. If you
10401
+ # didn't specify one, the `LATEST` platform version is used. For more
10402
+ # information, see [Fargate Platform Versions][1] in the *Amazon
10403
+ # Elastic Container Service Developer Guide*.
10237
10404
  #
10238
10405
  #
10239
10406
  #
10240
10407
  # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/platform_versions.html
10241
10408
  # @return [String]
10242
10409
  #
10410
+ # @!attribute [rw] platform_family
10411
+ # The operating system that your tasks are running on. A platform
10412
+ # family is specified only for tasks that use the Fargate launch type.
10413
+ #
10414
+ # All tasks that run as part of this service must use the same
10415
+ # `platformFamily` value as the service (for example, `LINUX.`).
10416
+ # @return [String]
10417
+ #
10243
10418
  # @!attribute [rw] pull_started_at
10244
- # The Unix timestamp for when the container image pull began.
10419
+ # The Unix timestamp for the time when the container image pull began.
10245
10420
  # @return [Time]
10246
10421
  #
10247
10422
  # @!attribute [rw] pull_stopped_at
10248
- # The Unix timestamp for when the container image pull completed.
10423
+ # The Unix timestamp for the time when the container image pull
10424
+ # completed.
10249
10425
  # @return [Time]
10250
10426
  #
10251
10427
  # @!attribute [rw] started_at
10252
- # The Unix timestamp for when the task started (the task transitioned
10253
- # from the `PENDING` state to the `RUNNING` state).
10428
+ # The Unix timestamp for the time when the task started. More
10429
+ # specifically, it's for the time when the task transitioned from the
10430
+ # `PENDING` state to the `RUNNING` state.
10254
10431
  # @return [Time]
10255
10432
  #
10256
10433
  # @!attribute [rw] started_by
10257
- # The tag specified when a task is started. If the task is started by
10258
- # an Amazon ECS service, then the `startedBy` parameter contains the
10259
- # deployment ID of the service that starts it.
10434
+ # The tag specified when a task is started. If an Amazon ECS service
10435
+ # started the task, the `startedBy` parameter contains the deployment
10436
+ # ID of that service.
10260
10437
  # @return [String]
10261
10438
  #
10262
10439
  # @!attribute [rw] stop_code
10263
10440
  # The stop code indicating why a task was stopped. The `stoppedReason`
10264
- # may contain additional details.
10441
+ # might contain additional details.
10265
10442
  # @return [String]
10266
10443
  #
10267
10444
  # @!attribute [rw] stopped_at
10268
- # The Unix timestamp for when the task was stopped (the task
10269
- # transitioned from the `RUNNING` state to the `STOPPED` state).
10445
+ # The Unix timestamp for the time when the task was stopped. More
10446
+ # specifically, it's for the time when the task transitioned from the
10447
+ # `RUNNING` state to the `STOPPED` state.
10270
10448
  # @return [Time]
10271
10449
  #
10272
10450
  # @!attribute [rw] stopped_reason
@@ -10274,14 +10452,15 @@ module Aws::ECS
10274
10452
  # @return [String]
10275
10453
  #
10276
10454
  # @!attribute [rw] stopping_at
10277
- # The Unix timestamp for when the task stops (transitions from the
10278
- # `RUNNING` state to `STOPPED`).
10455
+ # The Unix timestamp for the time when the task stops. More
10456
+ # specifically, it's for the time when the task transitions from the
10457
+ # `RUNNING` state to `STOPPED`.
10279
10458
  # @return [Time]
10280
10459
  #
10281
10460
  # @!attribute [rw] tags
10282
10461
  # The metadata that you apply to the task to help you categorize and
10283
- # organize them. Each tag consists of a key and an optional value,
10284
- # both of which you define.
10462
+ # organize the task. Each tag consists of a key and an optional value.
10463
+ # You define both the key and value.
10285
10464
  #
10286
10465
  # The following basic restrictions apply to tags:
10287
10466
  #
@@ -10319,8 +10498,8 @@ module Aws::ECS
10319
10498
  #
10320
10499
  # @!attribute [rw] version
10321
10500
  # The version counter for the task. Every time a task experiences a
10322
- # change that triggers a CloudWatch event, the version counter is
10323
- # incremented. If you are replicating your Amazon ECS task state with
10501
+ # change that starts a CloudWatch event, the version counter is
10502
+ # incremented. If you replicate your Amazon ECS task state with
10324
10503
  # CloudWatch Events, you can compare the version of a task reported by
10325
10504
  # the Amazon ECS API actions with the version reported in CloudWatch
10326
10505
  # Events for the task (inside the `detail` object) to verify that the
@@ -10356,6 +10535,7 @@ module Aws::ECS
10356
10535
  :memory,
10357
10536
  :overrides,
10358
10537
  :platform_version,
10538
+ :platform_family,
10359
10539
  :pull_started_at,
10360
10540
  :pull_stopped_at,
10361
10541
  :started_at,
@@ -10397,8 +10577,8 @@ module Aws::ECS
10397
10577
  #
10398
10578
  # @!attribute [rw] family
10399
10579
  # The name of a family that this task definition is registered to. Up
10400
- # to 255 letters (uppercase and lowercase), numbers, hyphens, and
10401
- # underscores are allowed.
10580
+ # to 255 characters are allowed. Letters (both uppercase and lowercase
10581
+ # letters), numbers, hyphens (-), and underscores (\_) are allowed.
10402
10582
  #
10403
10583
  # A family groups multiple versions of a task definition. Amazon ECS
10404
10584
  # gives the first task definition that you registered to a family a
@@ -10415,10 +10595,9 @@ module Aws::ECS
10415
10595
  #
10416
10596
  # IAM roles for tasks on Windows require that the `-EnableTaskIAMRole`
10417
10597
  # option is set when you launch the Amazon ECS-optimized Windows AMI.
10418
- # Your containers must also run some configuration code in order to
10419
- # take advantage of the feature. For more information, see [Windows
10420
- # IAM roles for tasks][2] in the *Amazon Elastic Container Service
10421
- # Developer Guide*.
10598
+ # Your containers must also run some configuration code to use the
10599
+ # feature. For more information, see [Windows IAM roles for tasks][2]
10600
+ # in the *Amazon Elastic Container Service Developer Guide*.
10422
10601
  #
10423
10602
  #
10424
10603
  #
@@ -10489,8 +10668,8 @@ module Aws::ECS
10489
10668
  # version number of a task definition in a family. When you register a
10490
10669
  # task definition for the first time, the revision is `1`. Each time
10491
10670
  # that you register a new revision of a task definition in the same
10492
- # family, the revision value always increases by one, even if you have
10493
- # deregistered previous revisions in this family.
10671
+ # family, the revision value always increases by one. This is even if
10672
+ # you deregistered previous revisions in this family.
10494
10673
  # @return [Integer]
10495
10674
  #
10496
10675
  # @!attribute [rw] volumes
@@ -10498,7 +10677,7 @@ module Aws::ECS
10498
10677
  # information, see [Using data volumes in tasks][1] in the *Amazon
10499
10678
  # Elastic Container Service Developer Guide*.
10500
10679
  #
10501
- # <note markdown="1"> The `host` and `sourcePath` parameters are not supported for tasks
10680
+ # <note markdown="1"> The `host` and `sourcePath` parameters aren't supported for tasks
10502
10681
  # run on Fargate.
10503
10682
  #
10504
10683
  # </note>
@@ -10516,13 +10695,13 @@ module Aws::ECS
10516
10695
  # The container instance attributes required by your task. When an
10517
10696
  # Amazon EC2 instance is registered to your cluster, the Amazon ECS
10518
10697
  # container agent assigns some standard attributes to the instance.
10519
- # You can apply custom attributes, specified as key-value pairs using
10520
- # the Amazon ECS console or the PutAttributes API. These attributes
10521
- # are used when considering task placement for tasks hosted on Amazon
10522
- # EC2 instances. For more information, see [Attributes][1] in the
10523
- # *Amazon Elastic Container Service Developer Guide*.
10698
+ # You can apply custom attributes. These are specified as key-value
10699
+ # pairs using the Amazon ECS console or the PutAttributes API. These
10700
+ # attributes are used when determining task placement for tasks hosted
10701
+ # on Amazon EC2 instances. For more information, see [Attributes][1]
10702
+ # in the *Amazon Elastic Container Service Developer Guide*.
10524
10703
  #
10525
- # <note markdown="1"> This parameter is not supported for tasks run on Fargate.
10704
+ # <note markdown="1"> This parameter isn't supported for tasks run on Fargate.
10526
10705
  #
10527
10706
  # </note>
10528
10707
  #
@@ -10534,7 +10713,7 @@ module Aws::ECS
10534
10713
  # @!attribute [rw] placement_constraints
10535
10714
  # An array of placement constraint objects to use for tasks.
10536
10715
  #
10537
- # <note markdown="1"> This parameter is not supported for tasks run on Fargate.
10716
+ # <note markdown="1"> This parameter isn't supported for tasks run on Fargate.
10538
10717
  #
10539
10718
  # </note>
10540
10719
  # @return [Array<Types::TaskDefinitionPlacementConstraint>]
@@ -10550,6 +10729,15 @@ module Aws::ECS
10550
10729
  # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_types.html
10551
10730
  # @return [Array<String>]
10552
10731
  #
10732
+ # @!attribute [rw] runtime_platform
10733
+ # The operating system that your task definitions are running on. A
10734
+ # platform family is specified only for tasks using the Fargate launch
10735
+ # type.
10736
+ #
10737
+ # When you specify a task in a service, this value must match the
10738
+ # `runtimePlatform` value of the service.
10739
+ # @return [Types::RuntimePlatform]
10740
+ #
10553
10741
  # @!attribute [rw] requires_compatibilities
10554
10742
  # The task launch types the task definition was validated against. To
10555
10743
  # determine which task launch types the task definition is validated
@@ -10557,11 +10745,14 @@ module Aws::ECS
10557
10745
  # @return [Array<String>]
10558
10746
  #
10559
10747
  # @!attribute [rw] cpu
10560
- # The number of `cpu` units used by the task. If you are using the EC2
10561
- # launch type, this field is optional and any value can be used. If
10562
- # you are using the Fargate launch type, this field is required and
10563
- # you must use one of the following values, which determines your
10564
- # range of valid values for the `memory` parameter:
10748
+ # The number of `cpu` units used by the task. If you use the EC2
10749
+ # launch type, this field is optional. Any value can be used. If you
10750
+ # use the Fargate launch type, this field is required. You must use
10751
+ # one of the following values. The value that you choose determines
10752
+ # your range of valid values for the `memory` parameter.
10753
+ #
10754
+ # The CPU units cannot be less than 1 vCPU when you use Windows
10755
+ # containers on Fargate.
10565
10756
  #
10566
10757
  # * 256 (.25 vCPU) - Available `memory` values: 512 (0.5 GB), 1024 (1
10567
10758
  # GB), 2048 (2 GB)
@@ -10583,16 +10774,16 @@ module Aws::ECS
10583
10774
  # @!attribute [rw] memory
10584
10775
  # The amount (in MiB) of memory used by the task.
10585
10776
  #
10586
- # If your tasks will be run on Amazon EC2 instances, you must specify
10587
- # either a task-level memory value or a container-level memory value.
10588
- # This field is optional and any value can be used. If a task-level
10589
- # memory value is specified then the container-level memory value is
10590
- # optional. For more information regarding container-level memory and
10591
- # memory reservation, see [ContainerDefinition][1].
10777
+ # If your tasks runs on Amazon EC2 instances, you must specify either
10778
+ # a task-level memory value or a container-level memory value. This
10779
+ # field is optional and any value can be used. If a task-level memory
10780
+ # value is specified, the container-level memory value is optional.
10781
+ # For more information regarding container-level memory and memory
10782
+ # reservation, see [ContainerDefinition][1].
10592
10783
  #
10593
- # If your tasks will be run on Fargate, this field is required and you
10594
- # must use one of the following values, which determines your range of
10595
- # valid values for the `cpu` parameter:
10784
+ # If your tasks runs on Fargate, this field is required. You must use
10785
+ # one of the following values. The value you choose determines your
10786
+ # range of valid values for the `cpu` parameter.
10596
10787
  #
10597
10788
  # * 512 (0.5 GB), 1024 (1 GB), 2048 (2 GB) - Available `cpu` values:
10598
10789
  # 256 (.25 vCPU)
@@ -10615,7 +10806,7 @@ module Aws::ECS
10615
10806
  # @return [String]
10616
10807
  #
10617
10808
  # @!attribute [rw] inference_accelerators
10618
- # The Elastic Inference accelerator associated with the task.
10809
+ # The Elastic Inference accelerator that's associated with the task.
10619
10810
  # @return [Array<Types::InferenceAccelerator>]
10620
10811
  #
10621
10812
  # @!attribute [rw] pid_mode
@@ -10691,9 +10882,9 @@ module Aws::ECS
10691
10882
  # Your Amazon ECS container instances require at least version 1.26.0
10692
10883
  # of the container agent and at least version 1.26.0-1 of the
10693
10884
  # `ecs-init` package to enable a proxy configuration. If your
10694
- # container instances are launched from the Amazon ECS-optimized AMI
10695
- # version `20190301` or later, then they contain the required versions
10696
- # of the container agent and `ecs-init`. For more information, see
10885
+ # container instances are launched from the Amazon ECS optimized AMI
10886
+ # version `20190301` or later, they contain the required versions of
10887
+ # the container agent and `ecs-init`. For more information, see
10697
10888
  # [Amazon ECS-optimized Linux AMI][1] in the *Amazon Elastic Container
10698
10889
  # Service Developer Guide*.
10699
10890
  #
@@ -10703,11 +10894,13 @@ module Aws::ECS
10703
10894
  # @return [Types::ProxyConfiguration]
10704
10895
  #
10705
10896
  # @!attribute [rw] registered_at
10706
- # The Unix timestamp for when the task definition was registered.
10897
+ # The Unix timestamp for the time when the task definition was
10898
+ # registered.
10707
10899
  # @return [Time]
10708
10900
  #
10709
10901
  # @!attribute [rw] deregistered_at
10710
- # The Unix timestamp for when the task definition was deregistered.
10902
+ # The Unix timestamp for the time when the task definition was
10903
+ # deregistered.
10711
10904
  # @return [Time]
10712
10905
  #
10713
10906
  # @!attribute [rw] registered_by
@@ -10734,6 +10927,7 @@ module Aws::ECS
10734
10927
  :requires_attributes,
10735
10928
  :placement_constraints,
10736
10929
  :compatibilities,
10930
+ :runtime_platform,
10737
10931
  :requires_compatibilities,
10738
10932
  :cpu,
10739
10933
  :memory,
@@ -10753,7 +10947,7 @@ module Aws::ECS
10753
10947
  # definition. For more information, see [Task placement constraints][1]
10754
10948
  # in the *Amazon Elastic Container Service Developer Guide*.
10755
10949
  #
10756
- # <note markdown="1"> Task placement constraints are not supported for tasks run on Fargate.
10950
+ # <note markdown="1"> Task placement constraints aren't supported for tasks run on Fargate.
10757
10951
  #
10758
10952
  # </note>
10759
10953
  #
@@ -10793,7 +10987,7 @@ module Aws::ECS
10793
10987
  include Aws::Structure
10794
10988
  end
10795
10989
 
10796
- # The overrides associated with a task.
10990
+ # The overrides that are associated with a task.
10797
10991
  #
10798
10992
  # @note When making an API call, you may pass TaskOverride
10799
10993
  # data as a hash:
@@ -10842,7 +11036,7 @@ module Aws::ECS
10842
11036
  # }
10843
11037
  #
10844
11038
  # @!attribute [rw] container_overrides
10845
- # One or more container overrides sent to a task.
11039
+ # One or more container overrides that are sent to a task.
10846
11040
  # @return [Array<Types::ContainerOverride>]
10847
11041
  #
10848
11042
  # @!attribute [rw] cpu
@@ -10883,8 +11077,12 @@ module Aws::ECS
10883
11077
  # @!attribute [rw] ephemeral_storage
10884
11078
  # The ephemeral storage setting override for the task.
10885
11079
  #
10886
- # <note markdown="1"> This parameter is only supported for tasks hosted on Fargate using
10887
- # platform version `1.4.0` or later.
11080
+ # <note markdown="1"> This parameter is only supported for tasks hosted on Fargate that
11081
+ # use the following platform versions:
11082
+ #
11083
+ # * Linux platform version `1.4.0` or later.
11084
+ #
11085
+ # * Windows platform version `1.0.0` or later.
10888
11086
  #
10889
11087
  # </note>
10890
11088
  # @return [Types::EphemeralStorage]
@@ -10927,17 +11125,17 @@ module Aws::ECS
10927
11125
  # @return [String]
10928
11126
  #
10929
11127
  # @!attribute [rw] started_by
10930
- # The tag specified when a task set is started. If the task set is
10931
- # created by an CodeDeploy deployment, the `startedBy` parameter is
10932
- # `CODE_DEPLOY`. For a task set created for an external deployment,
10933
- # the startedBy field isn't used.
11128
+ # The tag specified when a task set is started. If an CodeDeploy
11129
+ # deployment created the task set, the `startedBy` parameter is
11130
+ # `CODE_DEPLOY`. If an external deployment created the task set, the
11131
+ # startedBy field isn't used.
10934
11132
  # @return [String]
10935
11133
  #
10936
11134
  # @!attribute [rw] external_id
10937
11135
  # The external ID associated with the task set.
10938
11136
  #
10939
- # If a task set is created by an CodeDeploy deployment, the
10940
- # `externalId` parameter contains the CodeDeploy deployment ID.
11137
+ # If an CodeDeploy deployment created a task set, the `externalId`
11138
+ # parameter contains the CodeDeploy deployment ID.
10941
11139
  #
10942
11140
  # If a task set is created for an external deployment and is
10943
11141
  # associated with a service discovery registry, the `externalId`
@@ -10946,7 +11144,7 @@ module Aws::ECS
10946
11144
  # @return [String]
10947
11145
  #
10948
11146
  # @!attribute [rw] status
10949
- # The status of the task set. The following describes each state:
11147
+ # The status of the task set. The following describes each state.
10950
11148
  #
10951
11149
  # PRIMARY
10952
11150
  #
@@ -10954,17 +11152,17 @@ module Aws::ECS
10954
11152
  #
10955
11153
  # ACTIVE
10956
11154
  #
10957
- # : The task set is not serving production traffic.
11155
+ # : The task set isn't serving production traffic.
10958
11156
  #
10959
11157
  # DRAINING
10960
11158
  #
10961
- # : The tasks in the task set are being stopped and their
11159
+ # : The tasks in the task set are being stopped, and their
10962
11160
  # corresponding targets are being deregistered from their target
10963
11161
  # group.
10964
11162
  # @return [String]
10965
11163
  #
10966
11164
  # @!attribute [rw] task_definition
10967
- # The task definition the task set is using.
11165
+ # The task definition that the task set is using.
10968
11166
  # @return [String]
10969
11167
  #
10970
11168
  # @!attribute [rw] computed_desired_count
@@ -10978,7 +11176,7 @@ module Aws::ECS
10978
11176
  # The number of tasks in the task set that are in the `PENDING` status
10979
11177
  # during a deployment. A task in the `PENDING` state is preparing to
10980
11178
  # enter the `RUNNING` state. A task set enters the `PENDING` status
10981
- # when it launches for the first time or when it is restarted after
11179
+ # when it launches for the first time or when it's restarted after
10982
11180
  # being in the `STOPPED` state.
10983
11181
  # @return [Integer]
10984
11182
  #
@@ -10989,11 +11187,11 @@ module Aws::ECS
10989
11187
  # @return [Integer]
10990
11188
  #
10991
11189
  # @!attribute [rw] created_at
10992
- # The Unix timestamp for when the task set was created.
11190
+ # The Unix timestamp for the time when the task set was created.
10993
11191
  # @return [Time]
10994
11192
  #
10995
11193
  # @!attribute [rw] updated_at
10996
- # The Unix timestamp for when the task set was last updated.
11194
+ # The Unix timestamp for the time when the task set was last updated.
10997
11195
  # @return [Time]
10998
11196
  #
10999
11197
  # @!attribute [rw] launch_type
@@ -11007,11 +11205,12 @@ module Aws::ECS
11007
11205
  # @return [String]
11008
11206
  #
11009
11207
  # @!attribute [rw] capacity_provider_strategy
11010
- # The capacity provider strategy associated with the task set.
11208
+ # The capacity provider strategy that are associated with the task
11209
+ # set.
11011
11210
  # @return [Array<Types::CapacityProviderStrategyItem>]
11012
11211
  #
11013
11212
  # @!attribute [rw] platform_version
11014
- # The Fargate platform version on which the tasks in the task set are
11213
+ # The Fargate platform version where the tasks in the task set are
11015
11214
  # running. A platform version is only specified for tasks run on
11016
11215
  # Fargate. For more information, see [Fargate platform versions][1] in
11017
11216
  # the *Amazon Elastic Container Service Developer Guide*.
@@ -11021,16 +11220,24 @@ module Aws::ECS
11021
11220
  # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/platform_versions.html
11022
11221
  # @return [String]
11023
11222
  #
11223
+ # @!attribute [rw] platform_family
11224
+ # The operating system that your tasks in the set are running on. A
11225
+ # platform family is specified only for tasks that use the Fargate
11226
+ # launch type.
11227
+ #
11228
+ # All tasks in the set must have the same value.
11229
+ # @return [String]
11230
+ #
11024
11231
  # @!attribute [rw] network_configuration
11025
11232
  # The network configuration for the task set.
11026
11233
  # @return [Types::NetworkConfiguration]
11027
11234
  #
11028
11235
  # @!attribute [rw] load_balancers
11029
- # Details on a load balancer that is used with a task set.
11236
+ # Details on a load balancer that are used with a task set.
11030
11237
  # @return [Array<Types::LoadBalancer>]
11031
11238
  #
11032
11239
  # @!attribute [rw] service_registries
11033
- # The details of the service discovery registries to assign to this
11240
+ # The details for the service discovery registries to assign to this
11034
11241
  # task set. For more information, see [Service discovery][1].
11035
11242
  #
11036
11243
  #
@@ -11039,38 +11246,38 @@ module Aws::ECS
11039
11246
  # @return [Array<Types::ServiceRegistry>]
11040
11247
  #
11041
11248
  # @!attribute [rw] scale
11042
- # A floating-point percentage of the desired number of tasks to place
11249
+ # A floating-point percentage of your desired number of tasks to place
11043
11250
  # and keep running in the task set.
11044
11251
  # @return [Types::Scale]
11045
11252
  #
11046
11253
  # @!attribute [rw] stability_status
11047
- # The stability status, which indicates whether the task set has
11254
+ # The stability status. This indicates whether the task set has
11048
11255
  # reached a steady state. If the following conditions are met, the
11049
- # task set will be in `STEADY_STATE`\:
11256
+ # task set sre in `STEADY_STATE`\:
11050
11257
  #
11051
11258
  # * The task `runningCount` is equal to the `computedDesiredCount`.
11052
11259
  #
11053
11260
  # * The `pendingCount` is `0`.
11054
11261
  #
11055
- # * There are no tasks running on container instances in the
11262
+ # * There are no tasks that are running on container instances in the
11056
11263
  # `DRAINING` status.
11057
11264
  #
11058
11265
  # * All tasks are reporting a healthy status from the load balancers,
11059
11266
  # service discovery, and container health checks.
11060
11267
  #
11061
- # If any of those conditions are not met, the stability status returns
11268
+ # If any of those conditions aren't met, the stability status returns
11062
11269
  # `STABILIZING`.
11063
11270
  # @return [String]
11064
11271
  #
11065
11272
  # @!attribute [rw] stability_status_at
11066
- # The Unix timestamp for when the task set stability status was
11067
- # retrieved.
11273
+ # The Unix timestamp for the time when the task set stability status
11274
+ # was retrieved.
11068
11275
  # @return [Time]
11069
11276
  #
11070
11277
  # @!attribute [rw] tags
11071
11278
  # The metadata that you apply to the task set to help you categorize
11072
- # and organize them. Each tag consists of a key and an optional value,
11073
- # both of which you define.
11279
+ # and organize them. Each tag consists of a key and an optional value.
11280
+ # You define both.
11074
11281
  #
11075
11282
  # The following basic restrictions apply to tags:
11076
11283
  #
@@ -11117,6 +11324,7 @@ module Aws::ECS
11117
11324
  :launch_type,
11118
11325
  :capacity_provider_strategy,
11119
11326
  :platform_version,
11327
+ :platform_family,
11120
11328
  :network_configuration,
11121
11329
  :load_balancers,
11122
11330
  :service_registries,
@@ -11128,9 +11336,9 @@ module Aws::ECS
11128
11336
  include Aws::Structure
11129
11337
  end
11130
11338
 
11131
- # The specified task set could not be found. You can view your available
11132
- # task sets with DescribeTaskSets. Task sets are specific to each
11133
- # cluster, service and Region.
11339
+ # The specified task set wasn't found. You can view your available task
11340
+ # sets with DescribeTaskSets. Task sets are specific to each cluster,
11341
+ # service and Region.
11134
11342
  #
11135
11343
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/TaskSetNotFoundException AWS API Documentation
11136
11344
  #
@@ -11217,7 +11425,7 @@ module Aws::ECS
11217
11425
  include Aws::Structure
11218
11426
  end
11219
11427
 
11220
- # The specified task is not supported in this Region.
11428
+ # The specified task isn't supported in this Region.
11221
11429
  #
11222
11430
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/UnsupportedFeatureException AWS API Documentation
11223
11431
  #
@@ -11232,8 +11440,8 @@ module Aws::ECS
11232
11440
  # }
11233
11441
  #
11234
11442
  # @!attribute [rw] resource_arn
11235
- # The Amazon Resource Name (ARN) of the resource from which to delete
11236
- # tags. Currently, the supported resources are Amazon ECS capacity
11443
+ # The Amazon Resource Name (ARN) of the resource to delete tags from.
11444
+ # Currently, the supported resources are Amazon ECS capacity
11237
11445
  # providers, tasks, services, task definitions, clusters, and
11238
11446
  # container instances.
11239
11447
  # @return [String]
@@ -11277,8 +11485,8 @@ module Aws::ECS
11277
11485
  # @return [String]
11278
11486
  #
11279
11487
  # @!attribute [rw] auto_scaling_group_provider
11280
- # An object representing the parameters to update for the Auto Scaling
11281
- # group capacity provider.
11488
+ # An object that represent the parameters to update for the Auto
11489
+ # Scaling group capacity provider.
11282
11490
  # @return [Types::AutoScalingGroupProviderUpdate]
11283
11491
  #
11284
11492
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/UpdateCapacityProviderRequest AWS API Documentation
@@ -11382,8 +11590,8 @@ module Aws::ECS
11382
11590
  # @!attribute [rw] settings
11383
11591
  # The setting to use by default for a cluster. This parameter is used
11384
11592
  # to enable CloudWatch Container Insights for a cluster. If this value
11385
- # is specified, it will override the `containerInsights` value set
11386
- # with PutAccountSetting or PutAccountSettingDefault.
11593
+ # is specified, it overrides the `containerInsights` value set with
11594
+ # PutAccountSetting or PutAccountSettingDefault.
11387
11595
  # @return [Array<Types::ClusterSetting>]
11388
11596
  #
11389
11597
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/UpdateClusterSettingsRequest AWS API Documentation
@@ -11423,7 +11631,7 @@ module Aws::ECS
11423
11631
  #
11424
11632
  # @!attribute [rw] container_instance
11425
11633
  # The container instance ID or full ARN entries for the container
11426
- # instance on which you would like to update the Amazon ECS container
11634
+ # instance where you would like to update the Amazon ECS container
11427
11635
  # agent.
11428
11636
  # @return [String]
11429
11637
  #
@@ -11437,7 +11645,7 @@ module Aws::ECS
11437
11645
  end
11438
11646
 
11439
11647
  # @!attribute [rw] container_instance
11440
- # The container instance for which the container agent was updated.
11648
+ # The container instance that the container agent was updated for.
11441
11649
  # @return [Types::ContainerInstance]
11442
11650
  #
11443
11651
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/UpdateContainerAgentResponse AWS API Documentation
@@ -11468,13 +11676,13 @@ module Aws::ECS
11468
11676
  # @return [Array<String>]
11469
11677
  #
11470
11678
  # @!attribute [rw] status
11471
- # The container instance state with which to update the container
11472
- # instance. The only valid values for this action are `ACTIVE` and
11473
- # `DRAINING`. A container instance can only be updated to `DRAINING`
11474
- # status once it has reached an `ACTIVE` state. If a container
11475
- # instance is in `REGISTERING`, `DEREGISTERING`, or
11476
- # `REGISTRATION_FAILED` state you can describe the container instance
11477
- # but will be unable to update the container instance state.
11679
+ # The container instance state to update the container instance with.
11680
+ # The only valid values for this action are `ACTIVE` and `DRAINING`. A
11681
+ # container instance can only be updated to `DRAINING` status once it
11682
+ # has reached an `ACTIVE` state. If a container instance is in
11683
+ # `REGISTERING`, `DEREGISTERING`, or `REGISTRATION_FAILED` state you
11684
+ # can describe the container instance but can't update the container
11685
+ # instance state.
11478
11686
  # @return [String]
11479
11687
  #
11480
11688
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/UpdateContainerInstancesStateRequest AWS API Documentation
@@ -11504,10 +11712,10 @@ module Aws::ECS
11504
11712
  include Aws::Structure
11505
11713
  end
11506
11714
 
11507
- # There is already a current Amazon ECS container agent update in
11508
- # progress on the specified container instance. If the container agent
11509
- # becomes disconnected while it is in a transitional stage, such as
11510
- # `PENDING` or `STAGING`, the update process can get stuck in that
11715
+ # There's already a current Amazon ECS container agent update in
11716
+ # progress on the container instance that's specified. If the container
11717
+ # agent becomes disconnected while it's in a transitional stage, such
11718
+ # as `PENDING` or `STAGING`, the update process can get stuck in that
11511
11719
  # state. However, when the agent reconnects, it resumes where it stopped
11512
11720
  # previously.
11513
11721
  #
@@ -11611,8 +11819,8 @@ module Aws::ECS
11611
11819
  #
11612
11820
  # @!attribute [rw] cluster
11613
11821
  # The short name or full Amazon Resource Name (ARN) of the cluster
11614
- # that your service is running on. If you do not specify a cluster,
11615
- # the default cluster is assumed.
11822
+ # that your service runs on. If you do not specify a cluster, the
11823
+ # default cluster is assumed.
11616
11824
  # @return [String]
11617
11825
  #
11618
11826
  # @!attribute [rw] service
@@ -11636,12 +11844,13 @@ module Aws::ECS
11636
11844
  # @!attribute [rw] capacity_provider_strategy
11637
11845
  # The capacity provider strategy to update the service to use.
11638
11846
  #
11639
- # If the service is using the default capacity provider strategy for
11640
- # the cluster, the service can be updated to use one or more capacity
11847
+ # if the service uses the default capacity provider strategy for the
11848
+ # cluster, the service can be updated to use one or more capacity
11641
11849
  # providers as opposed to the default capacity provider strategy.
11642
- # However, when a service is using a capacity provider strategy that
11643
- # is not the default capacity provider strategy, the service cannot be
11644
- # updated to use the cluster's default capacity provider strategy.
11850
+ # However, when a service is using a capacity provider strategy
11851
+ # that's not the default capacity provider strategy, the service
11852
+ # can't be updated to use the cluster's default capacity provider
11853
+ # strategy.
11645
11854
  #
11646
11855
  # A capacity provider strategy consists of one or more capacity
11647
11856
  # providers along with the `base` and `weight` to assign to them. A
@@ -11683,9 +11892,9 @@ module Aws::ECS
11683
11892
  # service. To remove all existing placement constraints, specify an
11684
11893
  # empty array.
11685
11894
  #
11686
- # You can specify a maximum of 10 constraints per task (this limit
11687
- # includes constraints in the task definition and those specified at
11688
- # runtime).
11895
+ # You can specify a maximum of 10 constraints for each task. This
11896
+ # limit includes constraints in the task definition and those
11897
+ # specified at runtime.
11689
11898
  # @return [Array<Types::PlacementConstraint>]
11690
11899
  #
11691
11900
  # @!attribute [rw] placement_strategy
@@ -11695,16 +11904,16 @@ module Aws::ECS
11695
11904
  # override the existing placement strategy defined for the service. To
11696
11905
  # remove an existing placement strategy, specify an empty object.
11697
11906
  #
11698
- # You can specify a maximum of five strategy rules per service.
11907
+ # You can specify a maximum of five strategy rules for each service.
11699
11908
  # @return [Array<Types::PlacementStrategy>]
11700
11909
  #
11701
11910
  # @!attribute [rw] platform_version
11702
- # The platform version on which your tasks in the service are running.
11703
- # A platform version is only specified for tasks using the Fargate
11911
+ # The platform version that your tasks in the service run on. A
11912
+ # platform version is only specified for tasks using the Fargate
11704
11913
  # launch type. If a platform version is not specified, the `LATEST`
11705
- # platform version is used by default. For more information, see
11706
- # [Fargate Platform Versions][1] in the *Amazon Elastic Container
11707
- # Service Developer Guide*.
11914
+ # platform version is used. For more information, see [Fargate
11915
+ # Platform Versions][1] in the *Amazon Elastic Container Service
11916
+ # Developer Guide*.
11708
11917
  #
11709
11918
  #
11710
11919
  #
@@ -11712,26 +11921,26 @@ module Aws::ECS
11712
11921
  # @return [String]
11713
11922
  #
11714
11923
  # @!attribute [rw] force_new_deployment
11715
- # Whether to force a new deployment of the service. Deployments are
11716
- # not forced by default. You can use this option to trigger a new
11717
- # deployment with no service definition changes. For example, you can
11718
- # update a service's tasks to use a newer Docker image with the same
11719
- # image/tag combination (`my_image:latest`) or to roll Fargate tasks
11720
- # onto a newer platform version.
11924
+ # Determines whether to force a new deployment of the service. By
11925
+ # default, deployments aren't forced. You can use this option to
11926
+ # start a new deployment with no service definition changes. For
11927
+ # example, you can update a service's tasks to use a newer Docker
11928
+ # image with the same image/tag combination (`my_image:latest`) or to
11929
+ # roll Fargate tasks onto a newer platform version.
11721
11930
  # @return [Boolean]
11722
11931
  #
11723
11932
  # @!attribute [rw] health_check_grace_period_seconds
11724
11933
  # The period of time, in seconds, that the Amazon ECS service
11725
- # scheduler should ignore unhealthy Elastic Load Balancing target
11726
- # health checks after a task has first started. This is only valid if
11727
- # your service is configured to use a load balancer. If your
11728
- # service's tasks take a while to start and respond to Elastic Load
11729
- # Balancing health checks, you can specify a health check grace period
11730
- # of up to 2,147,483,647 seconds. During that time, the Amazon ECS
11731
- # service scheduler ignores the Elastic Load Balancing health check
11732
- # status. This grace period can prevent the ECS service scheduler from
11733
- # marking tasks as unhealthy and stopping them before they have time
11734
- # to come up.
11934
+ # scheduler ignores unhealthy Elastic Load Balancing target health
11935
+ # checks after a task has first started. This is only valid if your
11936
+ # service is configured to use a load balancer. If your service's
11937
+ # tasks take a while to start and respond to Elastic Load Balancing
11938
+ # health checks, you can specify a health check grace period of up to
11939
+ # 2,147,483,647 seconds. During that time, the Amazon ECS service
11940
+ # scheduler ignores the Elastic Load Balancing health check status.
11941
+ # This grace period can prevent the ECS service scheduler from marking
11942
+ # tasks as unhealthy and stopping them before they have time to come
11943
+ # up.
11735
11944
  # @return [Integer]
11736
11945
  #
11737
11946
  # @!attribute [rw] enable_execute_command
@@ -11790,12 +11999,12 @@ module Aws::ECS
11790
11999
  #
11791
12000
  # @!attribute [rw] cluster
11792
12001
  # The short name or full Amazon Resource Name (ARN) of the cluster
11793
- # that hosts the service that the task set exists in.
12002
+ # that hosts the service that the task set is found in.
11794
12003
  # @return [String]
11795
12004
  #
11796
12005
  # @!attribute [rw] service
11797
12006
  # The short name or full Amazon Resource Name (ARN) of the service
11798
- # that the task set exists in.
12007
+ # that the task set is found in.
11799
12008
  # @return [String]
11800
12009
  #
11801
12010
  # @!attribute [rw] task_set
@@ -11857,7 +12066,7 @@ module Aws::ECS
11857
12066
  # @return [String]
11858
12067
  #
11859
12068
  # @!attribute [rw] docker_version
11860
- # The Docker version running on the container instance.
12069
+ # The Docker version that's running on the container instance.
11861
12070
  # @return [String]
11862
12071
  #
11863
12072
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/VersionInfo AWS API Documentation
@@ -11870,14 +12079,14 @@ module Aws::ECS
11870
12079
  include Aws::Structure
11871
12080
  end
11872
12081
 
11873
- # A data volume used in a task definition. For tasks that use the Amazon
11874
- # Elastic File System (Amazon EFS), specify an `efsVolumeConfiguration`.
11875
- # For Windows tasks that use Amazon FSx for Windows File Server file
11876
- # system, specify a `fsxWindowsFileServerVolumeConfiguration`. For tasks
11877
- # that use a Docker volume, specify a `DockerVolumeConfiguration`. For
11878
- # tasks that use a bind mount host volume, specify a `host` and optional
11879
- # `sourcePath`. For more information, see [Using Data Volumes in
11880
- # Tasks][1].
12082
+ # A data volume that's used in a task definition. For tasks that use
12083
+ # the Amazon Elastic File System (Amazon EFS), specify an
12084
+ # `efsVolumeConfiguration`. For Windows tasks that use Amazon FSx for
12085
+ # Windows File Server file system, specify a
12086
+ # `fsxWindowsFileServerVolumeConfiguration`. For tasks that use a Docker
12087
+ # volume, specify a `DockerVolumeConfiguration`. For tasks that use a
12088
+ # bind mount host volume, specify a `host` and optional `sourcePath`.
12089
+ # For more information, see [Using Data Volumes in Tasks][1].
11881
12090
  #
11882
12091
  #
11883
12092
  #
@@ -11930,40 +12139,40 @@ module Aws::ECS
11930
12139
  # @return [String]
11931
12140
  #
11932
12141
  # @!attribute [rw] host
11933
- # This parameter is specified when you are using bind mount host
11934
- # volumes. The contents of the `host` parameter determine whether your
11935
- # bind mount host volume persists on the host container instance and
11936
- # where it is stored. If the `host` parameter is empty, then the
11937
- # Docker daemon assigns a host path for your data volume. However, the
11938
- # data is not guaranteed to persist after the containers associated
11939
- # with it stop running.
12142
+ # This parameter is specified when you use bind mount host volumes.
12143
+ # The contents of the `host` parameter determine whether your bind
12144
+ # mount host volume persists on the host container instance and where
12145
+ # it's stored. If the `host` parameter is empty, then the Docker
12146
+ # daemon assigns a host path for your data volume. However, the data
12147
+ # isn't guaranteed to persist after the containers that are
12148
+ # associated with it stop running.
11940
12149
  #
11941
12150
  # Windows containers can mount whole directories on the same drive as
11942
- # `$env:ProgramData`. Windows containers cannot mount directories on a
11943
- # different drive, and mount point cannot be across drives. For
12151
+ # `$env:ProgramData`. Windows containers can't mount directories on a
12152
+ # different drive, and mount point can't be across drives. For
11944
12153
  # example, you can mount `C:\my\path:C:\my\path` and `D:\:D:`, but
11945
12154
  # not `D:\my\path:C:\my\path` or `D:\:C:\my\path`.
11946
12155
  # @return [Types::HostVolumeProperties]
11947
12156
  #
11948
12157
  # @!attribute [rw] docker_volume_configuration
11949
- # This parameter is specified when you are using Docker volumes.
12158
+ # This parameter is specified when you use Docker volumes.
11950
12159
  #
11951
12160
  # Windows containers only support the use of the `local` driver. To
11952
12161
  # use bind mounts, specify the `host` parameter instead.
11953
12162
  #
11954
- # <note markdown="1"> Docker volumes are not supported by tasks run on Fargate.
12163
+ # <note markdown="1"> Docker volumes aren't supported by tasks run on Fargate.
11955
12164
  #
11956
12165
  # </note>
11957
12166
  # @return [Types::DockerVolumeConfiguration]
11958
12167
  #
11959
12168
  # @!attribute [rw] efs_volume_configuration
11960
- # This parameter is specified when you are using an Amazon Elastic
11961
- # File System file system for task storage.
12169
+ # This parameter is specified when you use an Amazon Elastic File
12170
+ # System file system for task storage.
11962
12171
  # @return [Types::EFSVolumeConfiguration]
11963
12172
  #
11964
12173
  # @!attribute [rw] fsx_windows_file_server_volume_configuration
11965
- # This parameter is specified when you are using Amazon FSx for
11966
- # Windows File Server file system for task storage.
12174
+ # This parameter is specified when you use Amazon FSx for Windows File
12175
+ # Server file system for task storage.
11967
12176
  # @return [Types::FSxWindowsFileServerVolumeConfiguration]
11968
12177
  #
11969
12178
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/Volume AWS API Documentation
@@ -11990,8 +12199,8 @@ module Aws::ECS
11990
12199
  # }
11991
12200
  #
11992
12201
  # @!attribute [rw] source_container
11993
- # The name of another container within the same task definition from
11994
- # which to mount volumes.
12202
+ # The name of another container within the same task definition to
12203
+ # mount volumes from.
11995
12204
  # @return [String]
11996
12205
  #
11997
12206
  # @!attribute [rw] read_only