aws-sdk-ecs 1.78.0 → 1.82.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: faf66a3300e6e2511e9e1476c901ad9fedefc0086bd4dc9274408b6599f21ff6
4
- data.tar.gz: 30e2775986c5300956396fd6989c37f8de3f72e032b60017921458f2601eef95
3
+ metadata.gz: 95f271bcc7ff6ca18af7d2470637ff5b443f46e9f0126172c0f9e12d2d0c04c6
4
+ data.tar.gz: 57f590e9973658d9a998ac21eb07ae2f710286faaaece961a96d508505e7467b
5
5
  SHA512:
6
- metadata.gz: 6741505bae9c51cf802c7bcafb6aca825614aceedc443b3ace002ee49be249e5182d891e5c70081a0b2ec7a2b4324886350f10a24a1eed02fc64b3dc9dfe3fe4
7
- data.tar.gz: d04f63c23729f68b8f4012728f2dbc83b6eecb72dc1bf5e1eadd3371e528246046c04e98a7eddb794164f175588b1148e8b837d82b81738dc4a7c6d76de23a42
6
+ metadata.gz: 9297e27c0a75f9308f43a4ead15aa822016270fb9c003fb65c425ab031918bd16c912d8be488e18d69ce1864c7a9d99dce33dbbbd2cfb97475c368f626bf86ad
7
+ data.tar.gz: 3e0ea8dc7d39e157260266dc0e299c24f94f3e2af1b11d1296105c7260a9a55e44d758d7286b369077ec04c134750d3b373784e129791da8e1b2ab32cb8bbe9a
data/CHANGELOG.md CHANGED
@@ -1,6 +1,26 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.82.0 (2021-07-28)
5
+ ------------------
6
+
7
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
8
+
9
+ 1.81.0 (2021-07-15)
10
+ ------------------
11
+
12
+ * Feature - Documentation updates for support of awsvpc mode on Windows.
13
+
14
+ 1.80.0 (2021-06-02)
15
+ ------------------
16
+
17
+ * Feature - Documentation updates for Amazon ECS.
18
+
19
+ 1.79.0 (2021-05-26)
20
+ ------------------
21
+
22
+ * Feature - The release adds support for registering External instances to your Amazon ECS clusters.
23
+
4
24
  1.78.0 (2021-05-10)
5
25
  ------------------
6
26
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.78.0
1
+ 1.82.0
data/lib/aws-sdk-ecs.rb CHANGED
@@ -49,6 +49,6 @@ require_relative 'aws-sdk-ecs/customizations'
49
49
  # @!group service
50
50
  module Aws::ECS
51
51
 
52
- GEM_VERSION = '1.78.0'
52
+ GEM_VERSION = '1.82.0'
53
53
 
54
54
  end
@@ -342,9 +342,9 @@ module Aws::ECS
342
342
  # strategies to facilitate cluster auto scaling.
343
343
  #
344
344
  # Only capacity providers using an Auto Scaling group can be created.
345
- # Amazon ECS tasks on AWS Fargate use the `FARGATE` and `FARGATE_SPOT`
345
+ # Amazon ECS tasks on Fargate use the `FARGATE` and `FARGATE_SPOT`
346
346
  # capacity providers which are already created and available to all
347
- # accounts in Regions supported by AWS Fargate.
347
+ # accounts in Regions supported by Fargate.
348
348
  #
349
349
  # @option params [required, String] :name
350
350
  # The name of the capacity provider. Up to 255 characters are allowed,
@@ -380,10 +380,10 @@ module Aws::ECS
380
380
  # * Tag keys and values are case-sensitive.
381
381
  #
382
382
  # * Do not use `aws:`, `AWS:`, or any upper or lowercase combination of
383
- # such as a prefix for either keys or values as it is reserved for AWS
384
- # use. You cannot edit or delete tag keys or values with this prefix.
385
- # Tags with this prefix do not count against your tags per resource
386
- # limit.
383
+ # such as a prefix for either keys or values as it is reserved for
384
+ # Amazon Web Services use. You cannot edit or delete tag keys or
385
+ # values with this prefix. Tags with this prefix do not count against
386
+ # your tags per resource limit.
387
387
  #
388
388
  # @return [Types::CreateCapacityProviderResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
389
389
  #
@@ -446,11 +446,12 @@ module Aws::ECS
446
446
  #
447
447
  # <note markdown="1"> When you call the CreateCluster API operation, Amazon ECS attempts to
448
448
  # create the Amazon ECS service-linked role for your account so that
449
- # required resources in other AWS services can be managed on your
450
- # behalf. However, if the IAM user that makes the call does not have
451
- # permissions to create the service-linked role, it is not created. For
452
- # more information, see [Using Service-Linked Roles for Amazon ECS][1]
453
- # in the *Amazon Elastic Container Service Developer Guide*.
449
+ # required resources in other Amazon Web Services services can be
450
+ # managed on your behalf. However, if the IAM user that makes the call
451
+ # does not have permissions to create the service-linked role, it is not
452
+ # created. For more information, see [Using Service-Linked Roles for
453
+ # Amazon ECS][1] in the *Amazon Elastic Container Service Developer
454
+ # Guide*.
454
455
  #
455
456
  # </note>
456
457
  #
@@ -489,10 +490,10 @@ module Aws::ECS
489
490
  # * Tag keys and values are case-sensitive.
490
491
  #
491
492
  # * Do not use `aws:`, `AWS:`, or any upper or lowercase combination of
492
- # such as a prefix for either keys or values as it is reserved for AWS
493
- # use. You cannot edit or delete tag keys or values with this prefix.
494
- # Tags with this prefix do not count against your tags per resource
495
- # limit.
493
+ # such as a prefix for either keys or values as it is reserved for
494
+ # Amazon Web Services use. You cannot edit or delete tag keys or
495
+ # values with this prefix. Tags with this prefix do not count against
496
+ # your tags per resource limit.
496
497
  #
497
498
  # @option params [Array<Types::ClusterSetting>] :settings
498
499
  # The setting to use when creating a cluster. This parameter is used to
@@ -515,10 +516,10 @@ module Aws::ECS
515
516
  # with another cluster. New Auto Scaling group capacity providers can be
516
517
  # created with the CreateCapacityProvider API operation.
517
518
  #
518
- # To use a AWS Fargate capacity provider, specify either the `FARGATE`
519
- # or `FARGATE_SPOT` capacity providers. The AWS Fargate capacity
520
- # providers are available to all accounts and only need to be associated
521
- # with a cluster to be used.
519
+ # To use a Fargate capacity provider, specify either the `FARGATE` or
520
+ # `FARGATE_SPOT` capacity providers. The Fargate capacity providers are
521
+ # available to all accounts and only need to be associated with a
522
+ # cluster to be used.
522
523
  #
523
524
  # The PutClusterCapacityProviders API operation is used to update the
524
525
  # list of available capacity providers for a cluster after the cluster
@@ -806,15 +807,15 @@ module Aws::ECS
806
807
  #
807
808
  # If the service is using the `CODE_DEPLOY` deployment controller, the
808
809
  # service is required to use either an Application Load Balancer or
809
- # Network Load Balancer. When creating an AWS CodeDeploy deployment
810
- # group, you specify two target groups (referred to as a
811
- # `targetGroupPair`). During a deployment, AWS CodeDeploy determines
812
- # which task set in your service has the status `PRIMARY` and associates
813
- # one target group with it, and then associates the other target group
814
- # with the replacement task set. The load balancer can also have up to
815
- # two listeners: a required listener for production traffic and an
816
- # optional listener that allows you perform validation tests with Lambda
817
- # functions before routing production traffic to it.
810
+ # Network Load Balancer. When creating an CodeDeploy deployment group,
811
+ # you specify two target groups (referred to as a `targetGroupPair`).
812
+ # During a deployment, CodeDeploy determines which task set in your
813
+ # service has the status `PRIMARY` and associates one target group with
814
+ # it, and then associates the other target group with the replacement
815
+ # task set. The load balancer can also have up to two listeners: a
816
+ # required listener for production traffic and an optional listener that
817
+ # allows you perform validation tests with Lambda functions before
818
+ # routing production traffic to it.
818
819
  #
819
820
  # After you create a service using the `ECS` deployment controller, the
820
821
  # load balancer name or target group ARN, container name, and container
@@ -876,23 +877,33 @@ module Aws::ECS
876
877
  # idempotency of the request. Up to 32 ASCII characters are allowed.
877
878
  #
878
879
  # @option params [String] :launch_type
879
- # The launch type on which to run your service. The accepted values are
880
- # `FARGATE` and `EC2`. For more information, see [Amazon ECS launch
881
- # types][1] in the *Amazon Elastic Container Service Developer Guide*.
880
+ # The infrastructure on which to run your service. For more information,
881
+ # see [Amazon ECS launch types][1] in the *Amazon Elastic Container
882
+ # Service Developer Guide*.
882
883
  #
883
- # When a value of `FARGATE` is specified, your tasks are launched on AWS
884
- # Fargate On-Demand infrastructure. To use Fargate Spot, you must use a
885
- # capacity provider strategy with the `FARGATE_SPOT` capacity provider.
884
+ # The `FARGATE` launch type runs your tasks on Fargate On-Demand
885
+ # infrastructure.
886
886
  #
887
- # When a value of `EC2` is specified, your tasks are launched on Amazon
888
- # EC2 instances registered to your cluster.
887
+ # <note markdown="1"> Fargate Spot infrastructure is available for use but a capacity
888
+ # provider strategy must be used. For more information, see [Fargate
889
+ # capacity providers][2] in the *Amazon ECS User Guide for Fargate*.
889
890
  #
890
- # If a `launchType` is specified, the `capacityProviderStrategy`
891
- # parameter must be omitted.
891
+ # </note>
892
+ #
893
+ # The `EC2` launch type runs your tasks on Amazon EC2 instances
894
+ # registered to your cluster.
895
+ #
896
+ # The `EXTERNAL` launch type runs your tasks on your on-premise server
897
+ # or virtual machine (VM) capacity registered to your cluster.
898
+ #
899
+ # A service can use either a launch type or a capacity provider
900
+ # strategy. If a `launchType` is specified, the
901
+ # `capacityProviderStrategy` parameter must be omitted.
892
902
  #
893
903
  #
894
904
  #
895
905
  # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_types.html
906
+ # [2]: https://docs.aws.amazon.com/AmazonECS/latest/userguide/fargate-capacity-providers.html
896
907
  #
897
908
  # @option params [Array<Types::CapacityProviderStrategyItem>] :capacity_provider_strategy
898
909
  # The capacity provider strategy to use for the service.
@@ -906,9 +917,8 @@ module Aws::ECS
906
917
  # The platform version that your tasks in the service are running on. A
907
918
  # platform version is specified only for tasks using the Fargate launch
908
919
  # type. If one isn't specified, the `LATEST` platform version is used
909
- # by default. For more information, see [AWS Fargate platform
910
- # versions][1] in the *Amazon Elastic Container Service Developer
911
- # Guide*.
920
+ # by default. For more information, see [Fargate platform versions][1]
921
+ # in the *Amazon Elastic Container Service Developer Guide*.
912
922
  #
913
923
  #
914
924
  #
@@ -1046,10 +1056,10 @@ module Aws::ECS
1046
1056
  # * Tag keys and values are case-sensitive.
1047
1057
  #
1048
1058
  # * Do not use `aws:`, `AWS:`, or any upper or lowercase combination of
1049
- # such as a prefix for either keys or values as it is reserved for AWS
1050
- # use. You cannot edit or delete tag keys or values with this prefix.
1051
- # Tags with this prefix do not count against your tags per resource
1052
- # limit.
1059
+ # such as a prefix for either keys or values as it is reserved for
1060
+ # Amazon Web Services use. You cannot edit or delete tag keys or
1061
+ # values with this prefix. Tags with this prefix do not count against
1062
+ # your tags per resource limit.
1053
1063
  #
1054
1064
  # @option params [Boolean] :enable_ecs_managed_tags
1055
1065
  # Specifies whether to enable Amazon ECS managed tags for the tasks
@@ -1219,7 +1229,7 @@ module Aws::ECS
1219
1229
  # ],
1220
1230
  # desired_count: 1,
1221
1231
  # client_token: "String",
1222
- # launch_type: "EC2", # accepts EC2, FARGATE
1232
+ # launch_type: "EC2", # accepts EC2, FARGATE, EXTERNAL
1223
1233
  # capacity_provider_strategy: [
1224
1234
  # {
1225
1235
  # capacity_provider: "String", # required
@@ -1291,7 +1301,7 @@ module Aws::ECS
1291
1301
  # resp.service.desired_count #=> Integer
1292
1302
  # resp.service.running_count #=> Integer
1293
1303
  # resp.service.pending_count #=> Integer
1294
- # resp.service.launch_type #=> String, one of "EC2", "FARGATE"
1304
+ # resp.service.launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
1295
1305
  # resp.service.capacity_provider_strategy #=> Array
1296
1306
  # resp.service.capacity_provider_strategy[0].capacity_provider #=> String
1297
1307
  # resp.service.capacity_provider_strategy[0].weight #=> Integer
@@ -1316,7 +1326,7 @@ module Aws::ECS
1316
1326
  # resp.service.task_sets[0].running_count #=> Integer
1317
1327
  # resp.service.task_sets[0].created_at #=> Time
1318
1328
  # resp.service.task_sets[0].updated_at #=> Time
1319
- # resp.service.task_sets[0].launch_type #=> String, one of "EC2", "FARGATE"
1329
+ # resp.service.task_sets[0].launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
1320
1330
  # resp.service.task_sets[0].capacity_provider_strategy #=> Array
1321
1331
  # resp.service.task_sets[0].capacity_provider_strategy[0].capacity_provider #=> String
1322
1332
  # resp.service.task_sets[0].capacity_provider_strategy[0].weight #=> Integer
@@ -1358,7 +1368,7 @@ module Aws::ECS
1358
1368
  # resp.service.deployments[0].capacity_provider_strategy[0].capacity_provider #=> String
1359
1369
  # resp.service.deployments[0].capacity_provider_strategy[0].weight #=> Integer
1360
1370
  # resp.service.deployments[0].capacity_provider_strategy[0].base #=> Integer
1361
- # resp.service.deployments[0].launch_type #=> String, one of "EC2", "FARGATE"
1371
+ # resp.service.deployments[0].launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
1362
1372
  # resp.service.deployments[0].platform_version #=> String
1363
1373
  # resp.service.deployments[0].network_configuration.awsvpc_configuration.subnets #=> Array
1364
1374
  # resp.service.deployments[0].network_configuration.awsvpc_configuration.subnets[0] #=> String
@@ -1425,7 +1435,7 @@ module Aws::ECS
1425
1435
  # An optional non-unique tag that identifies this task set in external
1426
1436
  # systems. If the task set is associated with a service discovery
1427
1437
  # registry, the tasks in this task set will have the
1428
- # `ECS_TASK_SET_EXTERNAL_ID` AWS Cloud Map attribute set to the provided
1438
+ # `ECS_TASK_SET_EXTERNAL_ID` Cloud Map attribute set to the provided
1429
1439
  # value.
1430
1440
  #
1431
1441
  # @option params [required, String] :task_definition
@@ -1478,10 +1488,10 @@ module Aws::ECS
1478
1488
  # capacity provider must already be created. New capacity providers can
1479
1489
  # be created with the CreateCapacityProvider API operation.
1480
1490
  #
1481
- # To use a AWS Fargate capacity provider, specify either the `FARGATE`
1482
- # or `FARGATE_SPOT` capacity providers. The AWS Fargate capacity
1483
- # providers are available to all accounts and only need to be associated
1484
- # with a cluster to be used.
1491
+ # To use a Fargate capacity provider, specify either the `FARGATE` or
1492
+ # `FARGATE_SPOT` capacity providers. The Fargate capacity providers are
1493
+ # available to all accounts and only need to be associated with a
1494
+ # cluster to be used.
1485
1495
  #
1486
1496
  # The PutClusterCapacityProviders API operation is used to update the
1487
1497
  # list of available capacity providers for a cluster after the cluster
@@ -1527,10 +1537,10 @@ module Aws::ECS
1527
1537
  # * Tag keys and values are case-sensitive.
1528
1538
  #
1529
1539
  # * Do not use `aws:`, `AWS:`, or any upper or lowercase combination of
1530
- # such as a prefix for either keys or values as it is reserved for AWS
1531
- # use. You cannot edit or delete tag keys or values with this prefix.
1532
- # Tags with this prefix do not count against your tags per resource
1533
- # limit.
1540
+ # such as a prefix for either keys or values as it is reserved for
1541
+ # Amazon Web Services use. You cannot edit or delete tag keys or
1542
+ # values with this prefix. Tags with this prefix do not count against
1543
+ # your tags per resource limit.
1534
1544
  #
1535
1545
  # @return [Types::CreateTaskSetResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1536
1546
  #
@@ -1566,7 +1576,7 @@ module Aws::ECS
1566
1576
  # container_port: 1,
1567
1577
  # },
1568
1578
  # ],
1569
- # launch_type: "EC2", # accepts EC2, FARGATE
1579
+ # launch_type: "EC2", # accepts EC2, FARGATE, EXTERNAL
1570
1580
  # capacity_provider_strategy: [
1571
1581
  # {
1572
1582
  # capacity_provider: "String", # required
@@ -1603,7 +1613,7 @@ module Aws::ECS
1603
1613
  # resp.task_set.running_count #=> Integer
1604
1614
  # resp.task_set.created_at #=> Time
1605
1615
  # resp.task_set.updated_at #=> Time
1606
- # resp.task_set.launch_type #=> String, one of "EC2", "FARGATE"
1616
+ # resp.task_set.launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
1607
1617
  # resp.task_set.capacity_provider_strategy #=> Array
1608
1618
  # resp.task_set.capacity_provider_strategy[0].capacity_provider #=> String
1609
1619
  # resp.task_set.capacity_provider_strategy[0].weight #=> Integer
@@ -2010,7 +2020,7 @@ module Aws::ECS
2010
2020
  # resp.service.desired_count #=> Integer
2011
2021
  # resp.service.running_count #=> Integer
2012
2022
  # resp.service.pending_count #=> Integer
2013
- # resp.service.launch_type #=> String, one of "EC2", "FARGATE"
2023
+ # resp.service.launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
2014
2024
  # resp.service.capacity_provider_strategy #=> Array
2015
2025
  # resp.service.capacity_provider_strategy[0].capacity_provider #=> String
2016
2026
  # resp.service.capacity_provider_strategy[0].weight #=> Integer
@@ -2035,7 +2045,7 @@ module Aws::ECS
2035
2045
  # resp.service.task_sets[0].running_count #=> Integer
2036
2046
  # resp.service.task_sets[0].created_at #=> Time
2037
2047
  # resp.service.task_sets[0].updated_at #=> Time
2038
- # resp.service.task_sets[0].launch_type #=> String, one of "EC2", "FARGATE"
2048
+ # resp.service.task_sets[0].launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
2039
2049
  # resp.service.task_sets[0].capacity_provider_strategy #=> Array
2040
2050
  # resp.service.task_sets[0].capacity_provider_strategy[0].capacity_provider #=> String
2041
2051
  # resp.service.task_sets[0].capacity_provider_strategy[0].weight #=> Integer
@@ -2077,7 +2087,7 @@ module Aws::ECS
2077
2087
  # resp.service.deployments[0].capacity_provider_strategy[0].capacity_provider #=> String
2078
2088
  # resp.service.deployments[0].capacity_provider_strategy[0].weight #=> Integer
2079
2089
  # resp.service.deployments[0].capacity_provider_strategy[0].base #=> Integer
2080
- # resp.service.deployments[0].launch_type #=> String, one of "EC2", "FARGATE"
2090
+ # resp.service.deployments[0].launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
2081
2091
  # resp.service.deployments[0].platform_version #=> String
2082
2092
  # resp.service.deployments[0].network_configuration.awsvpc_configuration.subnets #=> Array
2083
2093
  # resp.service.deployments[0].network_configuration.awsvpc_configuration.subnets[0] #=> String
@@ -2176,7 +2186,7 @@ module Aws::ECS
2176
2186
  # resp.task_set.running_count #=> Integer
2177
2187
  # resp.task_set.created_at #=> Time
2178
2188
  # resp.task_set.updated_at #=> Time
2179
- # resp.task_set.launch_type #=> String, one of "EC2", "FARGATE"
2189
+ # resp.task_set.launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
2180
2190
  # resp.task_set.capacity_provider_strategy #=> Array
2181
2191
  # resp.task_set.capacity_provider_strategy[0].capacity_provider #=> String
2182
2192
  # resp.task_set.capacity_provider_strategy[0].weight #=> Integer
@@ -2242,9 +2252,9 @@ module Aws::ECS
2242
2252
  # @option params [required, String] :container_instance
2243
2253
  # The container instance ID or full ARN of the container instance to
2244
2254
  # deregister. The ARN contains the `arn:aws:ecs` namespace, followed by
2245
- # the Region of the container instance, the AWS account ID of the
2246
- # container instance owner, the `container-instance` namespace, and then
2247
- # the container instance ID. For example,
2255
+ # the Region of the container instance, the account ID of the container
2256
+ # instance owner, the `container-instance` namespace, and then the
2257
+ # container instance ID. For example,
2248
2258
  # `arn:aws:ecs:region:aws_account_id:container-instance/container_instance_ID`.
2249
2259
  #
2250
2260
  # @option params [Boolean] :force
@@ -2521,9 +2531,9 @@ module Aws::ECS
2521
2531
  # resp.task_definition.placement_constraints[0].type #=> String, one of "memberOf"
2522
2532
  # resp.task_definition.placement_constraints[0].expression #=> String
2523
2533
  # resp.task_definition.compatibilities #=> Array
2524
- # resp.task_definition.compatibilities[0] #=> String, one of "EC2", "FARGATE"
2534
+ # resp.task_definition.compatibilities[0] #=> String, one of "EC2", "FARGATE", "EXTERNAL"
2525
2535
  # resp.task_definition.requires_compatibilities #=> Array
2526
- # resp.task_definition.requires_compatibilities[0] #=> String, one of "EC2", "FARGATE"
2536
+ # resp.task_definition.requires_compatibilities[0] #=> String, one of "EC2", "FARGATE", "EXTERNAL"
2527
2537
  # resp.task_definition.cpu #=> String
2528
2538
  # resp.task_definition.memory #=> String
2529
2539
  # resp.task_definition.inference_accelerators #=> Array
@@ -2643,33 +2653,16 @@ module Aws::ECS
2643
2653
  # assumed.
2644
2654
  #
2645
2655
  # @option params [Array<String>] :include
2646
- # Whether to include additional information about your clusters in the
2647
- # response. If this field is omitted, the attachments, statistics, and
2648
- # tags are not included.
2656
+ # Whether to include additional information about the clusters in the
2657
+ # response. If this field is omitted, this information isn't included.
2649
2658
  #
2650
2659
  # If `ATTACHMENTS` is specified, the attachments for the container
2651
2660
  # instances or tasks within the cluster are included.
2652
2661
  #
2653
2662
  # If `SETTINGS` is specified, the settings for the cluster are included.
2654
2663
  #
2655
- # If `STATISTICS` is specified, the following additional information,
2656
- # separated by launch type, is included:
2657
- #
2658
- # * runningEC2TasksCount
2659
- #
2660
- # * runningFargateTasksCount
2661
- #
2662
- # * pendingEC2TasksCount
2663
- #
2664
- # * pendingFargateTasksCount
2665
- #
2666
- # * activeEC2ServiceCount
2667
- #
2668
- # * activeFargateServiceCount
2669
- #
2670
- # * drainingEC2ServiceCount
2671
- #
2672
- # * drainingFargateServiceCount
2664
+ # If `STATISTICS` is specified, the task and service count is included,
2665
+ # separated by launch type.
2673
2666
  #
2674
2667
  # If `TAGS` is specified, the metadata tags associated with the cluster
2675
2668
  # are included.
@@ -2764,8 +2757,7 @@ module Aws::ECS
2764
2757
  req.send_request(options)
2765
2758
  end
2766
2759
 
2767
- # Describes Amazon Elastic Container Service container instances.
2768
- # Returns metadata about registered and remaining resources on each
2760
+ # Describes one or more container instances. Returns metadata about each
2769
2761
  # container instance requested.
2770
2762
  #
2771
2763
  # @option params [String] :cluster
@@ -3054,7 +3046,7 @@ module Aws::ECS
3054
3046
  # resp.services[0].desired_count #=> Integer
3055
3047
  # resp.services[0].running_count #=> Integer
3056
3048
  # resp.services[0].pending_count #=> Integer
3057
- # resp.services[0].launch_type #=> String, one of "EC2", "FARGATE"
3049
+ # resp.services[0].launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
3058
3050
  # resp.services[0].capacity_provider_strategy #=> Array
3059
3051
  # resp.services[0].capacity_provider_strategy[0].capacity_provider #=> String
3060
3052
  # resp.services[0].capacity_provider_strategy[0].weight #=> Integer
@@ -3079,7 +3071,7 @@ module Aws::ECS
3079
3071
  # resp.services[0].task_sets[0].running_count #=> Integer
3080
3072
  # resp.services[0].task_sets[0].created_at #=> Time
3081
3073
  # resp.services[0].task_sets[0].updated_at #=> Time
3082
- # resp.services[0].task_sets[0].launch_type #=> String, one of "EC2", "FARGATE"
3074
+ # resp.services[0].task_sets[0].launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
3083
3075
  # resp.services[0].task_sets[0].capacity_provider_strategy #=> Array
3084
3076
  # resp.services[0].task_sets[0].capacity_provider_strategy[0].capacity_provider #=> String
3085
3077
  # resp.services[0].task_sets[0].capacity_provider_strategy[0].weight #=> Integer
@@ -3121,7 +3113,7 @@ module Aws::ECS
3121
3113
  # resp.services[0].deployments[0].capacity_provider_strategy[0].capacity_provider #=> String
3122
3114
  # resp.services[0].deployments[0].capacity_provider_strategy[0].weight #=> Integer
3123
3115
  # resp.services[0].deployments[0].capacity_provider_strategy[0].base #=> Integer
3124
- # resp.services[0].deployments[0].launch_type #=> String, one of "EC2", "FARGATE"
3116
+ # resp.services[0].deployments[0].launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
3125
3117
  # resp.services[0].deployments[0].platform_version #=> String
3126
3118
  # resp.services[0].deployments[0].network_configuration.awsvpc_configuration.subnets #=> Array
3127
3119
  # resp.services[0].deployments[0].network_configuration.awsvpc_configuration.subnets[0] #=> String
@@ -3411,9 +3403,9 @@ module Aws::ECS
3411
3403
  # resp.task_definition.placement_constraints[0].type #=> String, one of "memberOf"
3412
3404
  # resp.task_definition.placement_constraints[0].expression #=> String
3413
3405
  # resp.task_definition.compatibilities #=> Array
3414
- # resp.task_definition.compatibilities[0] #=> String, one of "EC2", "FARGATE"
3406
+ # resp.task_definition.compatibilities[0] #=> String, one of "EC2", "FARGATE", "EXTERNAL"
3415
3407
  # resp.task_definition.requires_compatibilities #=> Array
3416
- # resp.task_definition.requires_compatibilities[0] #=> String, one of "EC2", "FARGATE"
3408
+ # resp.task_definition.requires_compatibilities[0] #=> String, one of "EC2", "FARGATE", "EXTERNAL"
3417
3409
  # resp.task_definition.cpu #=> String
3418
3410
  # resp.task_definition.memory #=> String
3419
3411
  # resp.task_definition.inference_accelerators #=> Array
@@ -3498,7 +3490,7 @@ module Aws::ECS
3498
3490
  # resp.task_sets[0].running_count #=> Integer
3499
3491
  # resp.task_sets[0].created_at #=> Time
3500
3492
  # resp.task_sets[0].updated_at #=> Time
3501
- # resp.task_sets[0].launch_type #=> String, one of "EC2", "FARGATE"
3493
+ # resp.task_sets[0].launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
3502
3494
  # resp.task_sets[0].capacity_provider_strategy #=> Array
3503
3495
  # resp.task_sets[0].capacity_provider_strategy[0].capacity_provider #=> String
3504
3496
  # resp.task_sets[0].capacity_provider_strategy[0].weight #=> Integer
@@ -3682,7 +3674,7 @@ module Aws::ECS
3682
3674
  # resp.tasks[0].inference_accelerators[0].device_name #=> String
3683
3675
  # resp.tasks[0].inference_accelerators[0].device_type #=> String
3684
3676
  # resp.tasks[0].last_status #=> String
3685
- # resp.tasks[0].launch_type #=> String, one of "EC2", "FARGATE"
3677
+ # resp.tasks[0].launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
3686
3678
  # resp.tasks[0].memory #=> String
3687
3679
  # resp.tasks[0].overrides.container_overrides #=> Array
3688
3680
  # resp.tasks[0].overrides.container_overrides[0].name #=> String
@@ -3754,7 +3746,7 @@ module Aws::ECS
3754
3746
  # @option params [String] :container_instance
3755
3747
  # The container instance ID or full ARN of the container instance. The
3756
3748
  # ARN contains the `arn:aws:ecs` namespace, followed by the Region of
3757
- # the container instance, the AWS account ID of the container instance
3749
+ # the container instance, the account ID of the container instance
3758
3750
  # owner, the `container-instance` namespace, and then the container
3759
3751
  # instance ID. For example,
3760
3752
  # `arn:aws:ecs:region:aws_account_id:container-instance/container_instance_ID`.
@@ -4248,12 +4240,13 @@ module Aws::ECS
4248
4240
  req.send_request(options)
4249
4241
  end
4250
4242
 
4251
- # Lists the services that are running in a specified cluster.
4243
+ # Returns a list of services. You can filter the results by cluster,
4244
+ # launch type, and scheduling strategy.
4252
4245
  #
4253
4246
  # @option params [String] :cluster
4254
- # The short name or full Amazon Resource Name (ARN) of the cluster that
4255
- # hosts the services to list. If you do not specify a cluster, the
4256
- # default cluster is assumed.
4247
+ # The short name or full Amazon Resource Name (ARN) of the cluster to
4248
+ # use when filtering the `ListServices` results. If you do not specify a
4249
+ # cluster, the default cluster is assumed.
4257
4250
  #
4258
4251
  # @option params [String] :next_token
4259
4252
  # The `nextToken` value returned from a `ListServices` request
@@ -4278,10 +4271,11 @@ module Aws::ECS
4278
4271
  # and a `nextToken` value if applicable.
4279
4272
  #
4280
4273
  # @option params [String] :launch_type
4281
- # The launch type for the services to list.
4274
+ # The launch type to use when filtering the `ListServices` results.
4282
4275
  #
4283
4276
  # @option params [String] :scheduling_strategy
4284
- # The scheduling strategy for services to list.
4277
+ # The scheduling strategy to use when filtering the `ListServices`
4278
+ # results.
4285
4279
  #
4286
4280
  # @return [Types::ListServicesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4287
4281
  #
@@ -4311,7 +4305,7 @@ module Aws::ECS
4311
4305
  # cluster: "String",
4312
4306
  # next_token: "String",
4313
4307
  # max_results: 1,
4314
- # launch_type: "EC2", # accepts EC2, FARGATE
4308
+ # launch_type: "EC2", # accepts EC2, FARGATE, EXTERNAL
4315
4309
  # scheduling_strategy: "REPLICA", # accepts REPLICA, DAEMON
4316
4310
  # })
4317
4311
  #
@@ -4616,30 +4610,29 @@ module Aws::ECS
4616
4610
  req.send_request(options)
4617
4611
  end
4618
4612
 
4619
- # Returns a list of tasks for a specified cluster. You can filter the
4620
- # results by family name, by a particular container instance, or by the
4621
- # desired status of the task with the `family`, `containerInstance`, and
4622
- # `desiredStatus` parameters.
4613
+ # Returns a list of tasks. You can filter the results by cluster, task
4614
+ # definition family, container instance, launch type, what IAM principal
4615
+ # started the task, or by the desired status of the task.
4623
4616
  #
4624
4617
  # Recently stopped tasks might appear in the returned results.
4625
4618
  # Currently, stopped tasks appear in the returned results for at least
4626
4619
  # one hour.
4627
4620
  #
4628
4621
  # @option params [String] :cluster
4629
- # The short name or full Amazon Resource Name (ARN) of the cluster that
4630
- # hosts the tasks to list. If you do not specify a cluster, the default
4631
- # cluster is assumed.
4622
+ # The short name or full Amazon Resource Name (ARN) of the cluster to
4623
+ # use when filtering the `ListTasks` results. If you do not specify a
4624
+ # cluster, the default cluster is assumed.
4632
4625
  #
4633
4626
  # @option params [String] :container_instance
4634
- # The container instance ID or full ARN of the container instance with
4635
- # which to filter the `ListTasks` results. Specifying a
4627
+ # The container instance ID or full ARN of the container instance to use
4628
+ # when filtering the `ListTasks` results. Specifying a
4636
4629
  # `containerInstance` limits the results to tasks that belong to that
4637
4630
  # container instance.
4638
4631
  #
4639
4632
  # @option params [String] :family
4640
- # The name of the family with which to filter the `ListTasks` results.
4641
- # Specifying a `family` limits the results to tasks that belong to that
4642
- # family.
4633
+ # The name of the task definition family to use when filtering the
4634
+ # `ListTasks` results. Specifying a `family` limits the results to tasks
4635
+ # that belong to that family.
4643
4636
  #
4644
4637
  # @option params [String] :next_token
4645
4638
  # The `nextToken` value returned from a `ListTasks` request indicating
@@ -4669,12 +4662,12 @@ module Aws::ECS
4669
4662
  # started with that value.
4670
4663
  #
4671
4664
  # @option params [String] :service_name
4672
- # The name of the service with which to filter the `ListTasks` results.
4665
+ # The name of the service to use when filtering the `ListTasks` results.
4673
4666
  # Specifying a `serviceName` limits the results to tasks that belong to
4674
4667
  # that service.
4675
4668
  #
4676
4669
  # @option params [String] :desired_status
4677
- # The task desired status with which to filter the `ListTasks` results.
4670
+ # The task desired status to use when filtering the `ListTasks` results.
4678
4671
  # Specifying a `desiredStatus` of `STOPPED` limits the results to tasks
4679
4672
  # that Amazon ECS has set the desired status to `STOPPED`. This can be
4680
4673
  # useful for debugging tasks that are not starting properly or have died
@@ -4689,7 +4682,7 @@ module Aws::ECS
4689
4682
  # </note>
4690
4683
  #
4691
4684
  # @option params [String] :launch_type
4692
- # The launch type for services to list.
4685
+ # The launch type to use when filtering the `ListTasks` results.
4693
4686
  #
4694
4687
  # @return [Types::ListTasksResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4695
4688
  #
@@ -4743,7 +4736,7 @@ module Aws::ECS
4743
4736
  # started_by: "String",
4744
4737
  # service_name: "String",
4745
4738
  # desired_status: "RUNNING", # accepts RUNNING, PENDING, STOPPED
4746
- # launch_type: "EC2", # accepts EC2, FARGATE
4739
+ # launch_type: "EC2", # accepts EC2, FARGATE, EXTERNAL
4747
4740
  # })
4748
4741
  #
4749
4742
  # @example Response structure
@@ -5054,10 +5047,10 @@ module Aws::ECS
5054
5047
  # capacity provider must already be created. New capacity providers can
5055
5048
  # be created with the CreateCapacityProvider API operation.
5056
5049
  #
5057
- # To use a AWS Fargate capacity provider, specify either the `FARGATE`
5058
- # or `FARGATE_SPOT` capacity providers. The AWS Fargate capacity
5059
- # providers are available to all accounts and only need to be associated
5060
- # with a cluster to be used.
5050
+ # To use a Fargate capacity provider, specify either the `FARGATE` or
5051
+ # `FARGATE_SPOT` capacity providers. The Fargate capacity providers are
5052
+ # available to all accounts and only need to be associated with a
5053
+ # cluster to be used.
5061
5054
  #
5062
5055
  # @option params [required, Array<Types::CapacityProviderStrategyItem>] :default_capacity_provider_strategy
5063
5056
  # The capacity provider strategy to use by default for the cluster.
@@ -5077,10 +5070,10 @@ module Aws::ECS
5077
5070
  # capacity provider must already be created. New capacity providers can
5078
5071
  # be created with the CreateCapacityProvider API operation.
5079
5072
  #
5080
- # To use a AWS Fargate capacity provider, specify either the `FARGATE`
5081
- # or `FARGATE_SPOT` capacity providers. The AWS Fargate capacity
5082
- # providers are available to all accounts and only need to be associated
5083
- # with a cluster to be used.
5073
+ # To use a Fargate capacity provider, specify either the `FARGATE` or
5074
+ # `FARGATE_SPOT` capacity providers. The Fargate capacity providers are
5075
+ # available to all accounts and only need to be associated with a
5076
+ # cluster to be used.
5084
5077
  #
5085
5078
  # @return [Types::PutClusterCapacityProvidersResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5086
5079
  #
@@ -5217,10 +5210,10 @@ module Aws::ECS
5217
5210
  # * Tag keys and values are case-sensitive.
5218
5211
  #
5219
5212
  # * Do not use `aws:`, `AWS:`, or any upper or lowercase combination of
5220
- # such as a prefix for either keys or values as it is reserved for AWS
5221
- # use. You cannot edit or delete tag keys or values with this prefix.
5222
- # Tags with this prefix do not count against your tags per resource
5223
- # limit.
5213
+ # such as a prefix for either keys or values as it is reserved for
5214
+ # Amazon Web Services use. You cannot edit or delete tag keys or
5215
+ # values with this prefix. Tags with this prefix do not count against
5216
+ # your tags per resource limit.
5224
5217
  #
5225
5218
  # @return [Types::RegisterContainerInstanceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5226
5219
  #
@@ -5336,10 +5329,11 @@ module Aws::ECS
5336
5329
  #
5337
5330
  # You can specify an IAM role for your task with the `taskRoleArn`
5338
5331
  # parameter. When you specify an IAM role for a task, its containers can
5339
- # then use the latest versions of the AWS CLI or SDKs to make API
5340
- # requests to the AWS services that are specified in the IAM policy
5341
- # associated with the role. For more information, see [IAM Roles for
5342
- # Tasks][2] in the *Amazon Elastic Container Service Developer Guide*.
5332
+ # then use the latest versions of the CLI or SDKs to make API requests
5333
+ # to the Amazon Web Services services that are specified in the IAM
5334
+ # policy associated with the role. For more information, see [IAM Roles
5335
+ # for Tasks][2] in the *Amazon Elastic Container Service Developer
5336
+ # Guide*.
5343
5337
  #
5344
5338
  # You can specify a Docker networking mode for the containers in your
5345
5339
  # task definition with the `networkMode` parameter. The available
@@ -5377,11 +5371,11 @@ module Aws::ECS
5377
5371
  #
5378
5372
  # @option params [String] :execution_role_arn
5379
5373
  # The Amazon Resource Name (ARN) of the task execution role that grants
5380
- # the Amazon ECS container agent permission to make AWS API calls on
5381
- # your behalf. The task execution IAM role is required depending on the
5382
- # requirements of your task. For more information, see [Amazon ECS task
5383
- # execution IAM role][1] in the *Amazon Elastic Container Service
5384
- # Developer Guide*.
5374
+ # the Amazon ECS container agent permission to make Amazon Web Services
5375
+ # API calls on your behalf. The task execution IAM role is required
5376
+ # depending on the requirements of your task. For more information, see
5377
+ # [Amazon ECS task execution IAM role][1] in the *Amazon Elastic
5378
+ # Container Service Developer Guide*.
5385
5379
  #
5386
5380
  #
5387
5381
  #
@@ -5393,13 +5387,15 @@ module Aws::ECS
5393
5387
  # mode is specified, the default is `bridge`.
5394
5388
  #
5395
5389
  # For Amazon ECS tasks on Fargate, the `awsvpc` network mode is
5396
- # required. For Amazon ECS tasks on Amazon EC2 instances, any network
5397
- # mode can be used. If the network mode is set to `none`, you cannot
5398
- # specify port mappings in your container definitions, and the tasks
5399
- # containers do not have external connectivity. The `host` and `awsvpc`
5400
- # network modes offer the highest networking performance for containers
5401
- # because they use the EC2 network stack instead of the virtualized
5402
- # network stack provided by the `bridge` mode.
5390
+ # required. For Amazon ECS tasks on Amazon EC2 Linux instances, any
5391
+ # network mode can be used. For Amazon ECS tasks on Amazon EC2 Windows
5392
+ # instances, `<default>` or `awsvpc` can be used. If the network mode is
5393
+ # set to `none`, you cannot specify port mappings in your container
5394
+ # definitions, and the tasks containers do not have external
5395
+ # connectivity. The `host` and `awsvpc` network modes offer the highest
5396
+ # networking performance for containers because they use the EC2 network
5397
+ # stack instead of the virtualized network stack provided by the
5398
+ # `bridge` mode.
5403
5399
  #
5404
5400
  # With the `host` and `awsvpc` network modes, exposed container ports
5405
5401
  # are mapped directly to the corresponding host port (for the `host`
@@ -5417,22 +5413,10 @@ module Aws::ECS
5417
5413
  # more information, see [Task Networking][1] in the *Amazon Elastic
5418
5414
  # Container Service Developer Guide*.
5419
5415
  #
5420
- # <note markdown="1"> Currently, only Amazon ECS-optimized AMIs, other Amazon Linux variants
5421
- # with the `ecs-init` package, or AWS Fargate infrastructure support the
5422
- # `awsvpc` network mode.
5423
- #
5424
- # </note>
5425
- #
5426
5416
  # If the network mode is `host`, you cannot run multiple instantiations
5427
5417
  # of the same task on a single container instance when port mappings are
5428
5418
  # used.
5429
5419
  #
5430
- # Docker for Windows uses different network modes than Docker for Linux.
5431
- # When you register a task definition with Windows containers, you must
5432
- # not specify a network mode. If you use the console to register a task
5433
- # definition with Windows containers, you must choose the `<default>`
5434
- # network mode object.
5435
- #
5436
5420
  # For more information, see [Network settings][2] in the *Docker run
5437
5421
  # reference*.
5438
5422
  #
@@ -5555,10 +5539,10 @@ module Aws::ECS
5555
5539
  # * Tag keys and values are case-sensitive.
5556
5540
  #
5557
5541
  # * Do not use `aws:`, `AWS:`, or any upper or lowercase combination of
5558
- # such as a prefix for either keys or values as it is reserved for AWS
5559
- # use. You cannot edit or delete tag keys or values with this prefix.
5560
- # Tags with this prefix do not count against your tags per resource
5561
- # limit.
5542
+ # such as a prefix for either keys or values as it is reserved for
5543
+ # Amazon Web Services use. You cannot edit or delete tag keys or
5544
+ # values with this prefix. Tags with this prefix do not count against
5545
+ # your tags per resource limit.
5562
5546
  #
5563
5547
  # @option params [String] :pid_mode
5564
5548
  # The process namespace to use for the containers in the task. The valid
@@ -5575,7 +5559,7 @@ module Aws::ECS
5575
5559
  # [Docker security][2].
5576
5560
  #
5577
5561
  # <note markdown="1"> This parameter is not supported for Windows containers or tasks run on
5578
- # AWS Fargate.
5562
+ # Fargate.
5579
5563
  #
5580
5564
  # </note>
5581
5565
  #
@@ -5614,7 +5598,7 @@ module Aws::ECS
5614
5598
  # `systemControls` will apply to all containers within a task.
5615
5599
  #
5616
5600
  # <note markdown="1"> This parameter is not supported for Windows containers or tasks run on
5617
- # AWS Fargate.
5601
+ # Fargate.
5618
5602
  #
5619
5603
  # </note>
5620
5604
  #
@@ -5647,11 +5631,11 @@ module Aws::ECS
5647
5631
  # @option params [Types::EphemeralStorage] :ephemeral_storage
5648
5632
  # The amount of ephemeral storage to allocate for the task. This
5649
5633
  # parameter is used to expand the total amount of ephemeral storage
5650
- # available, beyond the default amount, for tasks hosted on AWS Fargate.
5651
- # For more information, see [Fargate task storage][1] in the *Amazon ECS
5652
- # User Guide for AWS Fargate*.
5634
+ # available, beyond the default amount, for tasks hosted on Fargate. For
5635
+ # more information, see [Fargate task storage][1] in the *Amazon ECS
5636
+ # User Guide for Fargate*.
5653
5637
  #
5654
- # <note markdown="1"> This parameter is only supported for tasks hosted on AWS Fargate using
5638
+ # <note markdown="1"> This parameter is only supported for tasks hosted on Fargate using
5655
5639
  # platform version `1.4.0` or later.
5656
5640
  #
5657
5641
  # </note>
@@ -5922,7 +5906,7 @@ module Aws::ECS
5922
5906
  # expression: "String",
5923
5907
  # },
5924
5908
  # ],
5925
- # requires_compatibilities: ["EC2"], # accepts EC2, FARGATE
5909
+ # requires_compatibilities: ["EC2"], # accepts EC2, FARGATE, EXTERNAL
5926
5910
  # cpu: "String",
5927
5911
  # memory: "String",
5928
5912
  # tags: [
@@ -6093,9 +6077,9 @@ module Aws::ECS
6093
6077
  # resp.task_definition.placement_constraints[0].type #=> String, one of "memberOf"
6094
6078
  # resp.task_definition.placement_constraints[0].expression #=> String
6095
6079
  # resp.task_definition.compatibilities #=> Array
6096
- # resp.task_definition.compatibilities[0] #=> String, one of "EC2", "FARGATE"
6080
+ # resp.task_definition.compatibilities[0] #=> String, one of "EC2", "FARGATE", "EXTERNAL"
6097
6081
  # resp.task_definition.requires_compatibilities #=> Array
6098
- # resp.task_definition.requires_compatibilities[0] #=> String, one of "EC2", "FARGATE"
6082
+ # resp.task_definition.requires_compatibilities[0] #=> String, one of "EC2", "FARGATE", "EXTERNAL"
6099
6083
  # resp.task_definition.cpu #=> String
6100
6084
  # resp.task_definition.memory #=> String
6101
6085
  # resp.task_definition.inference_accelerators #=> Array
@@ -6169,6 +6153,9 @@ module Aws::ECS
6169
6153
  # `launchType` is specified, the `defaultCapacityProviderStrategy` for
6170
6154
  # the cluster is used.
6171
6155
  #
6156
+ # When you use cluster auto scaling, you must specify
6157
+ # `capacityProviderStrategy` and not `launchType`.
6158
+ #
6172
6159
  # @option params [String] :cluster
6173
6160
  # The short name or full Amazon Resource Name (ARN) of the cluster on
6174
6161
  # which to run your task. If you do not specify a cluster, the default
@@ -6198,23 +6185,36 @@ module Aws::ECS
6198
6185
  # family:my-family-name).
6199
6186
  #
6200
6187
  # @option params [String] :launch_type
6201
- # The launch type on which to run your task. The accepted values are
6202
- # `FARGATE` and `EC2`. For more information, see [Amazon ECS Launch
6203
- # Types][1] in the *Amazon Elastic Container Service Developer Guide*.
6188
+ # The infrastructure on which to run your standalone task. For more
6189
+ # information, see [Amazon ECS launch types][1] in the *Amazon Elastic
6190
+ # Container Service Developer Guide*.
6191
+ #
6192
+ # The `FARGATE` launch type runs your tasks on Fargate On-Demand
6193
+ # infrastructure.
6204
6194
  #
6205
- # When a value of `FARGATE` is specified, your tasks are launched on AWS
6206
- # Fargate On-Demand infrastructure. To use Fargate Spot, you must use a
6207
- # capacity provider strategy with the `FARGATE_SPOT` capacity provider.
6195
+ # <note markdown="1"> Fargate Spot infrastructure is available for use but a capacity
6196
+ # provider strategy must be used. For more information, see [Fargate
6197
+ # capacity providers][2] in the *Amazon ECS User Guide for Fargate*.
6208
6198
  #
6209
- # When a value of `EC2` is specified, your tasks are launched on Amazon
6210
- # EC2 instances registered to your cluster.
6199
+ # </note>
6200
+ #
6201
+ # The `EC2` launch type runs your tasks on Amazon EC2 instances
6202
+ # registered to your cluster.
6203
+ #
6204
+ # The `EXTERNAL` launch type runs your tasks on your on-premise server
6205
+ # or virtual machine (VM) capacity registered to your cluster.
6211
6206
  #
6207
+ # A task can use either a launch type or a capacity provider strategy.
6212
6208
  # If a `launchType` is specified, the `capacityProviderStrategy`
6213
6209
  # parameter must be omitted.
6214
6210
  #
6211
+ # When you use cluster auto scaling, you must specify
6212
+ # `capacityProviderStrategy` and not `launchType`.
6213
+ #
6215
6214
  #
6216
6215
  #
6217
6216
  # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_types.html
6217
+ # [2]: https://docs.aws.amazon.com/AmazonECS/latest/userguide/fargate-capacity-providers.html
6218
6218
  #
6219
6219
  # @option params [Types::NetworkConfiguration] :network_configuration
6220
6220
  # The network configuration for the task. This parameter is required for
@@ -6255,8 +6255,8 @@ module Aws::ECS
6255
6255
  # The platform version the task should run. A platform version is only
6256
6256
  # specified for tasks using the Fargate launch type. If one is not
6257
6257
  # specified, the `LATEST` platform version is used by default. For more
6258
- # information, see [AWS Fargate Platform Versions][1] in the *Amazon
6259
- # Elastic Container Service Developer Guide*.
6258
+ # information, see [Fargate Platform Versions][1] in the *Amazon Elastic
6259
+ # Container Service Developer Guide*.
6260
6260
  #
6261
6261
  #
6262
6262
  #
@@ -6313,10 +6313,10 @@ module Aws::ECS
6313
6313
  # * Tag keys and values are case-sensitive.
6314
6314
  #
6315
6315
  # * Do not use `aws:`, `AWS:`, or any upper or lowercase combination of
6316
- # such as a prefix for either keys or values as it is reserved for AWS
6317
- # use. You cannot edit or delete tag keys or values with this prefix.
6318
- # Tags with this prefix do not count against your tags per resource
6319
- # limit.
6316
+ # such as a prefix for either keys or values as it is reserved for
6317
+ # Amazon Web Services use. You cannot edit or delete tag keys or
6318
+ # values with this prefix. Tags with this prefix do not count against
6319
+ # your tags per resource limit.
6320
6320
  #
6321
6321
  # @option params [required, String] :task_definition
6322
6322
  # The `family` and `revision` (`family:revision`) or full ARN of the
@@ -6381,7 +6381,7 @@ module Aws::ECS
6381
6381
  # enable_ecs_managed_tags: false,
6382
6382
  # enable_execute_command: false,
6383
6383
  # group: "String",
6384
- # launch_type: "EC2", # accepts EC2, FARGATE
6384
+ # launch_type: "EC2", # accepts EC2, FARGATE, EXTERNAL
6385
6385
  # network_configuration: {
6386
6386
  # awsvpc_configuration: {
6387
6387
  # subnets: ["String"], # required
@@ -6518,7 +6518,7 @@ module Aws::ECS
6518
6518
  # resp.tasks[0].inference_accelerators[0].device_name #=> String
6519
6519
  # resp.tasks[0].inference_accelerators[0].device_type #=> String
6520
6520
  # resp.tasks[0].last_status #=> String
6521
- # resp.tasks[0].launch_type #=> String, one of "EC2", "FARGATE"
6521
+ # resp.tasks[0].launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
6522
6522
  # resp.tasks[0].memory #=> String
6523
6523
  # resp.tasks[0].overrides.container_overrides #=> Array
6524
6524
  # resp.tasks[0].overrides.container_overrides[0].name #=> String
@@ -6679,10 +6679,10 @@ module Aws::ECS
6679
6679
  # * Tag keys and values are case-sensitive.
6680
6680
  #
6681
6681
  # * Do not use `aws:`, `AWS:`, or any upper or lowercase combination of
6682
- # such as a prefix for either keys or values as it is reserved for AWS
6683
- # use. You cannot edit or delete tag keys or values with this prefix.
6684
- # Tags with this prefix do not count against your tags per resource
6685
- # limit.
6682
+ # such as a prefix for either keys or values as it is reserved for
6683
+ # Amazon Web Services use. You cannot edit or delete tag keys or
6684
+ # values with this prefix. Tags with this prefix do not count against
6685
+ # your tags per resource limit.
6686
6686
  #
6687
6687
  # @option params [required, String] :task_definition
6688
6688
  # The `family` and `revision` (`family:revision`) or full ARN of the
@@ -6825,7 +6825,7 @@ module Aws::ECS
6825
6825
  # resp.tasks[0].inference_accelerators[0].device_name #=> String
6826
6826
  # resp.tasks[0].inference_accelerators[0].device_type #=> String
6827
6827
  # resp.tasks[0].last_status #=> String
6828
- # resp.tasks[0].launch_type #=> String, one of "EC2", "FARGATE"
6828
+ # resp.tasks[0].launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
6829
6829
  # resp.tasks[0].memory #=> String
6830
6830
  # resp.tasks[0].overrides.container_overrides #=> Array
6831
6831
  # resp.tasks[0].overrides.container_overrides[0].name #=> String
@@ -6990,7 +6990,7 @@ module Aws::ECS
6990
6990
  # resp.task.inference_accelerators[0].device_name #=> String
6991
6991
  # resp.task.inference_accelerators[0].device_type #=> String
6992
6992
  # resp.task.last_status #=> String
6993
- # resp.task.launch_type #=> String, one of "EC2", "FARGATE"
6993
+ # resp.task.launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
6994
6994
  # resp.task.memory #=> String
6995
6995
  # resp.task.overrides.container_overrides #=> Array
6996
6996
  # resp.task.overrides.container_overrides[0].name #=> String
@@ -7286,10 +7286,10 @@ module Aws::ECS
7286
7286
  # * Tag keys and values are case-sensitive.
7287
7287
  #
7288
7288
  # * Do not use `aws:`, `AWS:`, or any upper or lowercase combination of
7289
- # such as a prefix for either keys or values as it is reserved for AWS
7290
- # use. You cannot edit or delete tag keys or values with this prefix.
7291
- # Tags with this prefix do not count against your tags per resource
7292
- # limit.
7289
+ # such as a prefix for either keys or values as it is reserved for
7290
+ # Amazon Web Services use. You cannot edit or delete tag keys or
7291
+ # values with this prefix. Tags with this prefix do not count against
7292
+ # your tags per resource limit.
7293
7293
  #
7294
7294
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
7295
7295
  #
@@ -7868,9 +7868,9 @@ module Aws::ECS
7868
7868
  # controller, only the desired count, deployment configuration, task
7869
7869
  # placement constraints and strategies, and health check grace period
7870
7870
  # can be updated using this API. If the network configuration, platform
7871
- # version, or task definition need to be updated, a new AWS CodeDeploy
7871
+ # version, or task definition need to be updated, a new CodeDeploy
7872
7872
  # deployment should be created. For more information, see
7873
- # [CreateDeployment][2] in the *AWS CodeDeploy API Reference*.
7873
+ # [CreateDeployment][2] in the *CodeDeploy API Reference*.
7874
7874
  #
7875
7875
  # For services using an external deployment controller, you can update
7876
7876
  # only the desired count, task placement constraints and strategies, and
@@ -8011,10 +8011,10 @@ module Aws::ECS
8011
8011
  # capacity provider must already be created. New capacity providers can
8012
8012
  # be created with the CreateCapacityProvider API operation.
8013
8013
  #
8014
- # To use a AWS Fargate capacity provider, specify either the `FARGATE`
8015
- # or `FARGATE_SPOT` capacity providers. The AWS Fargate capacity
8016
- # providers are available to all accounts and only need to be associated
8017
- # with a cluster to be used.
8014
+ # To use a Fargate capacity provider, specify either the `FARGATE` or
8015
+ # `FARGATE_SPOT` capacity providers. The Fargate capacity providers are
8016
+ # available to all accounts and only need to be associated with a
8017
+ # cluster to be used.
8018
8018
  #
8019
8019
  # The PutClusterCapacityProviders API operation is used to update the
8020
8020
  # list of available capacity providers for a cluster after the cluster
@@ -8051,7 +8051,7 @@ module Aws::ECS
8051
8051
  # The platform version on which your tasks in the service are running. A
8052
8052
  # platform version is only specified for tasks using the Fargate launch
8053
8053
  # type. If a platform version is not specified, the `LATEST` platform
8054
- # version is used by default. For more information, see [AWS Fargate
8054
+ # version is used by default. For more information, see [Fargate
8055
8055
  # Platform Versions][1] in the *Amazon Elastic Container Service
8056
8056
  # Developer Guide*.
8057
8057
  #
@@ -8183,7 +8183,7 @@ module Aws::ECS
8183
8183
  # resp.service.desired_count #=> Integer
8184
8184
  # resp.service.running_count #=> Integer
8185
8185
  # resp.service.pending_count #=> Integer
8186
- # resp.service.launch_type #=> String, one of "EC2", "FARGATE"
8186
+ # resp.service.launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
8187
8187
  # resp.service.capacity_provider_strategy #=> Array
8188
8188
  # resp.service.capacity_provider_strategy[0].capacity_provider #=> String
8189
8189
  # resp.service.capacity_provider_strategy[0].weight #=> Integer
@@ -8208,7 +8208,7 @@ module Aws::ECS
8208
8208
  # resp.service.task_sets[0].running_count #=> Integer
8209
8209
  # resp.service.task_sets[0].created_at #=> Time
8210
8210
  # resp.service.task_sets[0].updated_at #=> Time
8211
- # resp.service.task_sets[0].launch_type #=> String, one of "EC2", "FARGATE"
8211
+ # resp.service.task_sets[0].launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
8212
8212
  # resp.service.task_sets[0].capacity_provider_strategy #=> Array
8213
8213
  # resp.service.task_sets[0].capacity_provider_strategy[0].capacity_provider #=> String
8214
8214
  # resp.service.task_sets[0].capacity_provider_strategy[0].weight #=> Integer
@@ -8250,7 +8250,7 @@ module Aws::ECS
8250
8250
  # resp.service.deployments[0].capacity_provider_strategy[0].capacity_provider #=> String
8251
8251
  # resp.service.deployments[0].capacity_provider_strategy[0].weight #=> Integer
8252
8252
  # resp.service.deployments[0].capacity_provider_strategy[0].base #=> Integer
8253
- # resp.service.deployments[0].launch_type #=> String, one of "EC2", "FARGATE"
8253
+ # resp.service.deployments[0].launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
8254
8254
  # resp.service.deployments[0].platform_version #=> String
8255
8255
  # resp.service.deployments[0].network_configuration.awsvpc_configuration.subnets #=> Array
8256
8256
  # resp.service.deployments[0].network_configuration.awsvpc_configuration.subnets[0] #=> String
@@ -8346,7 +8346,7 @@ module Aws::ECS
8346
8346
  # resp.task_set.running_count #=> Integer
8347
8347
  # resp.task_set.created_at #=> Time
8348
8348
  # resp.task_set.updated_at #=> Time
8349
- # resp.task_set.launch_type #=> String, one of "EC2", "FARGATE"
8349
+ # resp.task_set.launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
8350
8350
  # resp.task_set.capacity_provider_strategy #=> Array
8351
8351
  # resp.task_set.capacity_provider_strategy[0].capacity_provider #=> String
8352
8352
  # resp.task_set.capacity_provider_strategy[0].weight #=> Integer
@@ -8440,7 +8440,7 @@ module Aws::ECS
8440
8440
  # resp.task_set.running_count #=> Integer
8441
8441
  # resp.task_set.created_at #=> Time
8442
8442
  # resp.task_set.updated_at #=> Time
8443
- # resp.task_set.launch_type #=> String, one of "EC2", "FARGATE"
8443
+ # resp.task_set.launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
8444
8444
  # resp.task_set.capacity_provider_strategy #=> Array
8445
8445
  # resp.task_set.capacity_provider_strategy[0].capacity_provider #=> String
8446
8446
  # resp.task_set.capacity_provider_strategy[0].weight #=> Integer
@@ -8491,7 +8491,7 @@ module Aws::ECS
8491
8491
  params: params,
8492
8492
  config: config)
8493
8493
  context[:gem_name] = 'aws-sdk-ecs'
8494
- context[:gem_version] = '1.78.0'
8494
+ context[:gem_version] = '1.82.0'
8495
8495
  Seahorse::Client::Request.new(handlers, context)
8496
8496
  end
8497
8497