aws-sdk-ecs 1.201.0 → 1.204.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG.md +15 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-ecs/client.rb +76 -22
- data/lib/aws-sdk-ecs/customizations.rb +0 -8
- data/lib/aws-sdk-ecs/types.rb +136 -43
- data/lib/aws-sdk-ecs.rb +1 -1
- metadata +3 -3
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 5a74bf734d34a33e2fef2a312d74d47a75b537546edb624e72ddf145b58479ff
|
4
|
+
data.tar.gz: 627cac1713d3e612e82c56da82b0a6ed278bfc750ffd9198b471448ea3473003
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: beeff90b83243b65c589661fa16bafdd04b8610848578afa2489919d145dd57e96aaa7d4a382f847ebe5da98160b1e87134f09890aab7d20d08507ecc379f706
|
7
|
+
data.tar.gz: 32adae7935082adf2e1b70839c6f4616679df8276dc820db2dea534e984035f182d44db66fcb47b3051c1fea03b53e19c22d71788306aa68205462f294fd90b6
|
data/CHANGELOG.md
CHANGED
@@ -1,6 +1,21 @@
|
|
1
1
|
Unreleased Changes
|
2
2
|
------------------
|
3
3
|
|
4
|
+
1.204.0 (2025-09-05)
|
5
|
+
------------------
|
6
|
+
|
7
|
+
* Feature - This is a documentation only release that adds additional information for Amazon ECS Availability Zone rebalancing.
|
8
|
+
|
9
|
+
1.203.0 (2025-08-26)
|
10
|
+
------------------
|
11
|
+
|
12
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
13
|
+
|
14
|
+
1.202.0 (2025-08-21)
|
15
|
+
------------------
|
16
|
+
|
17
|
+
* Feature - This is a documentation only release that adds additional information for the update-service request parameters.
|
18
|
+
|
4
19
|
1.201.0 (2025-08-04)
|
5
20
|
------------------
|
6
21
|
|
data/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
1.
|
1
|
+
1.204.0
|
data/lib/aws-sdk-ecs/client.rb
CHANGED
@@ -1093,6 +1093,19 @@ module Aws::ECS
|
|
1093
1093
|
# Availability Zones][1] in the <i> <i>Amazon Elastic Container Service
|
1094
1094
|
# Developer Guide</i> </i>.
|
1095
1095
|
#
|
1096
|
+
# The default behavior of `AvailabilityZoneRebalancing` differs between
|
1097
|
+
# create and update requests:
|
1098
|
+
#
|
1099
|
+
# * For create service requests, when when no value is specified for
|
1100
|
+
# `AvailabilityZoneRebalancing`, Amazon ECS defaults the value to to
|
1101
|
+
# `ENABLED`.
|
1102
|
+
#
|
1103
|
+
# * For update service requests, when no value is specified for
|
1104
|
+
# `AvailabilityZoneRebalancing`, Amazon ECS defaults to the existing
|
1105
|
+
# service’s `AvailabilityZoneRebalancing` value. If the service never
|
1106
|
+
# had an `AvailabilityZoneRebalancing` value set, Amazon ECS treats
|
1107
|
+
# this as `DISABLED`.
|
1108
|
+
#
|
1096
1109
|
#
|
1097
1110
|
#
|
1098
1111
|
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-rebalancing.html
|
@@ -1102,13 +1115,13 @@ module Aws::ECS
|
|
1102
1115
|
# your service. For more information, see [Service load balancing][1] in
|
1103
1116
|
# the *Amazon Elastic Container Service Developer Guide*.
|
1104
1117
|
#
|
1105
|
-
# If the service uses the
|
1106
|
-
#
|
1107
|
-
#
|
1108
|
-
#
|
1109
|
-
#
|
1110
|
-
#
|
1111
|
-
#
|
1118
|
+
# If the service uses the `ECS` deployment controller and using either
|
1119
|
+
# an Application Load Balancer or Network Load Balancer, you must
|
1120
|
+
# specify one or more target group ARNs to attach to the service. The
|
1121
|
+
# service-linked role is required for services that use multiple target
|
1122
|
+
# groups. For more information, see [Using service-linked roles for
|
1123
|
+
# Amazon ECS][2] in the *Amazon Elastic Container Service Developer
|
1124
|
+
# Guide*.
|
1112
1125
|
#
|
1113
1126
|
# If the service uses the `CODE_DEPLOY` deployment controller, the
|
1114
1127
|
# service is required to use either an Application Load Balancer or
|
@@ -1288,20 +1301,13 @@ module Aws::ECS
|
|
1288
1301
|
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-networking.html
|
1289
1302
|
#
|
1290
1303
|
# @option params [Integer] :health_check_grace_period_seconds
|
1291
|
-
# The period of time, in seconds, that the Amazon ECS service
|
1292
|
-
# ignores unhealthy Elastic Load Balancing, VPC Lattice, and
|
1293
|
-
# health checks after a task has first started. If you
|
1294
|
-
# health check grace period value, the default value of
|
1295
|
-
# you
|
1304
|
+
# The period of time, in seconds, that the Amazon Amazon ECS service
|
1305
|
+
# scheduler ignores unhealthy Elastic Load Balancing, VPC Lattice, and
|
1306
|
+
# container health checks after a task has first started. If you do not
|
1307
|
+
# specify a health check grace period value, the default value of 0 is
|
1308
|
+
# used. If you do not use any of the health checks, then
|
1296
1309
|
# `healthCheckGracePeriodSeconds` is unused.
|
1297
1310
|
#
|
1298
|
-
# If your service's tasks take a while to start and respond to health
|
1299
|
-
# checks, you can specify a health check grace period of up to
|
1300
|
-
# 2,147,483,647 seconds (about 69 years). During that time, the Amazon
|
1301
|
-
# ECS service scheduler ignores health check status. This grace period
|
1302
|
-
# can prevent the service scheduler from marking tasks as unhealthy and
|
1303
|
-
# stopping them before they have time to come up.
|
1304
|
-
#
|
1305
1311
|
# @option params [String] :scheduling_strategy
|
1306
1312
|
# The scheduling strategy to use for the service. For more information,
|
1307
1313
|
# see [Services][1].
|
@@ -5280,8 +5286,7 @@ module Aws::ECS
|
|
5280
5286
|
# @option params [String] :cluster
|
5281
5287
|
# The short name or full Amazon Resource Name (ARN) of the cluster that
|
5282
5288
|
# hosts the task or tasks to describe. If you do not specify a cluster,
|
5283
|
-
# the default cluster is assumed.
|
5284
|
-
# `default` cluster is used.
|
5289
|
+
# the default cluster is assumed.
|
5285
5290
|
#
|
5286
5291
|
# @option params [required, Array<String>] :tasks
|
5287
5292
|
# A list of up to 100 task IDs or full ARN entries.
|
@@ -11638,6 +11643,8 @@ module Aws::ECS
|
|
11638
11643
|
# The number of instantiations of the task to place and keep running in
|
11639
11644
|
# your service.
|
11640
11645
|
#
|
11646
|
+
# This parameter doesn't trigger a new service deployment.
|
11647
|
+
#
|
11641
11648
|
# @option params [String] :task_definition
|
11642
11649
|
# The `family` and `revision` (`family:revision`) or full ARN of the
|
11643
11650
|
# task definition to run in your service. If a `revision` is not
|
@@ -11646,6 +11653,8 @@ module Aws::ECS
|
|
11646
11653
|
# the new version of the task definition and then stops an old task
|
11647
11654
|
# after the new version is running.
|
11648
11655
|
#
|
11656
|
+
# This parameter triggers a new service deployment.
|
11657
|
+
#
|
11649
11658
|
# @option params [Array<Types::CapacityProviderStrategyItem>] :capacity_provider_strategy
|
11650
11659
|
# The details of a capacity provider strategy. You can set a capacity
|
11651
11660
|
# provider when you create a cluster, run a task, or update a service.
|
@@ -11680,6 +11689,8 @@ module Aws::ECS
|
|
11680
11689
|
# For information about Amazon Web Services CDK considerations, see
|
11681
11690
|
# [Amazon Web Services CDK considerations][1].
|
11682
11691
|
#
|
11692
|
+
# This parameter doesn't trigger a new service deployment.
|
11693
|
+
#
|
11683
11694
|
#
|
11684
11695
|
#
|
11685
11696
|
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/update-service-parameters.html
|
@@ -11688,6 +11699,8 @@ module Aws::ECS
|
|
11688
11699
|
# Optional deployment parameters that control how many tasks run during
|
11689
11700
|
# the deployment and the ordering of stopping and starting tasks.
|
11690
11701
|
#
|
11702
|
+
# This parameter doesn't trigger a new service deployment.
|
11703
|
+
#
|
11691
11704
|
# @option params [String] :availability_zone_rebalancing
|
11692
11705
|
# Indicates whether to use Availability Zone rebalancing for the
|
11693
11706
|
# service.
|
@@ -11696,6 +11709,21 @@ module Aws::ECS
|
|
11696
11709
|
# Availability Zones][1] in the <i> <i>Amazon Elastic Container Service
|
11697
11710
|
# Developer Guide</i> </i>.
|
11698
11711
|
#
|
11712
|
+
# The default behavior of `AvailabilityZoneRebalancing` differs between
|
11713
|
+
# create and update requests:
|
11714
|
+
#
|
11715
|
+
# * For create service requests, when when no value is specified for
|
11716
|
+
# `AvailabilityZoneRebalancing`, Amazon ECS defaults the value to to
|
11717
|
+
# `ENABLED`.
|
11718
|
+
#
|
11719
|
+
# * For update service requests, when no value is specified for
|
11720
|
+
# `AvailabilityZoneRebalancing`, Amazon ECS defaults to the existing
|
11721
|
+
# service’s `AvailabilityZoneRebalancing` value. If the service never
|
11722
|
+
# had an `AvailabilityZoneRebalancing` value set, Amazon ECS treats
|
11723
|
+
# this as `DISABLED`.
|
11724
|
+
#
|
11725
|
+
# This parameter doesn't trigger a new service deployment.
|
11726
|
+
#
|
11699
11727
|
#
|
11700
11728
|
#
|
11701
11729
|
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-rebalancing.html
|
@@ -11703,6 +11731,8 @@ module Aws::ECS
|
|
11703
11731
|
# @option params [Types::NetworkConfiguration] :network_configuration
|
11704
11732
|
# An object representing the network configuration for the service.
|
11705
11733
|
#
|
11734
|
+
# This parameter triggers a new service deployment.
|
11735
|
+
#
|
11706
11736
|
# @option params [Array<Types::PlacementConstraint>] :placement_constraints
|
11707
11737
|
# An array of task placement constraint objects to update the service to
|
11708
11738
|
# use. If no value is specified, the existing placement constraints for
|
@@ -11714,6 +11744,8 @@ module Aws::ECS
|
|
11714
11744
|
# includes constraints in the task definition and those specified at
|
11715
11745
|
# runtime.
|
11716
11746
|
#
|
11747
|
+
# This parameter doesn't trigger a new service deployment.
|
11748
|
+
#
|
11717
11749
|
# @option params [Array<Types::PlacementStrategy>] :placement_strategy
|
11718
11750
|
# The task placement strategy objects to update the service to use. If
|
11719
11751
|
# no value is specified, the existing placement strategy for the service
|
@@ -11723,6 +11755,8 @@ module Aws::ECS
|
|
11723
11755
|
#
|
11724
11756
|
# You can specify a maximum of five strategy rules for each service.
|
11725
11757
|
#
|
11758
|
+
# This parameter doesn't trigger a new service deployment.
|
11759
|
+
#
|
11726
11760
|
# @option params [String] :platform_version
|
11727
11761
|
# The platform version that your tasks in the service run on. A platform
|
11728
11762
|
# version is only specified for tasks using the Fargate launch type. If
|
@@ -11730,6 +11764,8 @@ module Aws::ECS
|
|
11730
11764
|
# used. For more information, see [Fargate Platform Versions][1] in the
|
11731
11765
|
# *Amazon Elastic Container Service Developer Guide*.
|
11732
11766
|
#
|
11767
|
+
# This parameter triggers a new service deployment.
|
11768
|
+
#
|
11733
11769
|
#
|
11734
11770
|
#
|
11735
11771
|
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/platform_versions.html
|
@@ -11757,6 +11793,8 @@ module Aws::ECS
|
|
11757
11793
|
# can prevent the service scheduler from marking tasks as unhealthy and
|
11758
11794
|
# stopping them before they have time to come up.
|
11759
11795
|
#
|
11796
|
+
# This parameter doesn't trigger a new service deployment.
|
11797
|
+
#
|
11760
11798
|
# @option params [Types::DeploymentController] :deployment_controller
|
11761
11799
|
# The deployment controller to use for the service.
|
11762
11800
|
#
|
@@ -11767,6 +11805,8 @@ module Aws::ECS
|
|
11767
11805
|
# If you do not want to override the value that was set when the service
|
11768
11806
|
# was created, you can set this to `null` when performing this action.
|
11769
11807
|
#
|
11808
|
+
# This parameter doesn't trigger a new service deployment.
|
11809
|
+
#
|
11770
11810
|
# @option params [Boolean] :enable_ecs_managed_tags
|
11771
11811
|
# Determines whether to turn on Amazon ECS managed tags for the tasks in
|
11772
11812
|
# the service. For more information, see [Tagging Your Amazon ECS
|
@@ -11777,6 +11817,8 @@ module Aws::ECS
|
|
11777
11817
|
# update the tags on all tasks, set `forceNewDeployment` to `true`, so
|
11778
11818
|
# that Amazon ECS starts new tasks with the updated tags.
|
11779
11819
|
#
|
11820
|
+
# This parameter doesn't trigger a new service deployment.
|
11821
|
+
#
|
11780
11822
|
#
|
11781
11823
|
#
|
11782
11824
|
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html
|
@@ -11817,6 +11859,8 @@ module Aws::ECS
|
|
11817
11859
|
#
|
11818
11860
|
# You can remove existing `loadBalancers` by passing an empty list.
|
11819
11861
|
#
|
11862
|
+
# This parameter triggers a new service deployment.
|
11863
|
+
#
|
11820
11864
|
#
|
11821
11865
|
#
|
11822
11866
|
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/register-multiple-targetgroups.html
|
@@ -11831,6 +11875,8 @@ module Aws::ECS
|
|
11831
11875
|
# update the tags on all tasks, set `forceNewDeployment` to `true`, so
|
11832
11876
|
# that Amazon ECS starts new tasks with the updated tags.
|
11833
11877
|
#
|
11878
|
+
# This parameter doesn't trigger a new service deployment.
|
11879
|
+
#
|
11834
11880
|
# @option params [Array<Types::ServiceRegistry>] :service_registries
|
11835
11881
|
# <note markdown="1"> You must have a service-linked role when you update this property.
|
11836
11882
|
#
|
@@ -11849,6 +11895,8 @@ module Aws::ECS
|
|
11849
11895
|
#
|
11850
11896
|
# You can remove existing `serviceRegistries` by passing an empty list.
|
11851
11897
|
#
|
11898
|
+
# This parameter triggers a new service deployment.
|
11899
|
+
#
|
11852
11900
|
#
|
11853
11901
|
#
|
11854
11902
|
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html#ECS-CreateService-request-role
|
@@ -11867,6 +11915,8 @@ module Aws::ECS
|
|
11867
11915
|
# Service Connect. For more information, see [Service Connect][1] in the
|
11868
11916
|
# *Amazon Elastic Container Service Developer Guide*.
|
11869
11917
|
#
|
11918
|
+
# This parameter triggers a new service deployment.
|
11919
|
+
#
|
11870
11920
|
#
|
11871
11921
|
#
|
11872
11922
|
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html
|
@@ -11879,6 +11929,8 @@ module Aws::ECS
|
|
11879
11929
|
# null, no new deployment is triggered. Otherwise, if this configuration
|
11880
11930
|
# differs from the existing one, it triggers a new deployment.
|
11881
11931
|
#
|
11932
|
+
# This parameter triggers a new service deployment.
|
11933
|
+
#
|
11882
11934
|
#
|
11883
11935
|
#
|
11884
11936
|
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ServiceManagedEBSVolumeConfiguration.html
|
@@ -11887,6 +11939,8 @@ module Aws::ECS
|
|
11887
11939
|
# An object representing the VPC Lattice configuration for the service
|
11888
11940
|
# being updated.
|
11889
11941
|
#
|
11942
|
+
# This parameter triggers a new service deployment.
|
11943
|
+
#
|
11890
11944
|
# @return [Types::UpdateServiceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
11891
11945
|
#
|
11892
11946
|
# * {Types::UpdateServiceResponse#service #service} => Types::Service
|
@@ -12779,7 +12833,7 @@ module Aws::ECS
|
|
12779
12833
|
tracer: tracer
|
12780
12834
|
)
|
12781
12835
|
context[:gem_name] = 'aws-sdk-ecs'
|
12782
|
-
context[:gem_version] = '1.
|
12836
|
+
context[:gem_version] = '1.204.0'
|
12783
12837
|
Seahorse::Client::Request.new(handlers, context)
|
12784
12838
|
end
|
12785
12839
|
|
data/lib/aws-sdk-ecs/types.rb
CHANGED
@@ -334,7 +334,7 @@ module Aws::ECS
|
|
334
334
|
end
|
335
335
|
|
336
336
|
# Your Amazon Web Services account was blocked. For more information,
|
337
|
-
# contact [ Amazon Web
|
337
|
+
# contact [ Amazon Web Services Support][1].
|
338
338
|
#
|
339
339
|
#
|
340
340
|
#
|
@@ -492,20 +492,52 @@ module Aws::ECS
|
|
492
492
|
# `RunTask` or `CreateService` actions using the capacity provider
|
493
493
|
# strategy will fail.
|
494
494
|
#
|
495
|
-
#
|
496
|
-
#
|
497
|
-
#
|
498
|
-
#
|
499
|
-
#
|
500
|
-
#
|
501
|
-
# *
|
495
|
+
# Weight value characteristics:
|
496
|
+
#
|
497
|
+
# * Weight is considered after the base value is satisfied
|
498
|
+
#
|
499
|
+
# * Default value is `0` if not specified
|
500
|
+
#
|
501
|
+
# * Valid range: 0 to 1,000
|
502
|
+
#
|
503
|
+
# * At least one capacity provider must have a weight greater than
|
504
|
+
# zero
|
505
|
+
#
|
506
|
+
# * Capacity providers with weight of `0` cannot place tasks
|
507
|
+
#
|
508
|
+
# Task distribution logic:
|
509
|
+
#
|
510
|
+
# 1. Base satisfaction: The minimum number of tasks specified by the
|
511
|
+
# base value are placed on that capacity provider
|
512
|
+
#
|
513
|
+
# 2. Weight distribution: After base requirements are met, additional
|
514
|
+
# tasks are distributed according to weight ratios
|
515
|
+
#
|
516
|
+
# Examples:
|
517
|
+
#
|
518
|
+
# Equal Distribution: Two capacity providers both with weight `1` will
|
519
|
+
# split tasks evenly after base requirements are met.
|
520
|
+
#
|
521
|
+
# Weighted Distribution: If capacityProviderA has weight `1` and
|
522
|
+
# capacityProviderB has weight `4`, then for every 1 task on A, 4
|
523
|
+
# tasks will run on B.
|
502
524
|
# @return [Integer]
|
503
525
|
#
|
504
526
|
# @!attribute [rw] base
|
505
527
|
# The *base* value designates how many tasks, at a minimum, to run on
|
506
|
-
# the specified capacity provider. Only one capacity
|
507
|
-
# capacity provider strategy can have a *base* defined.
|
508
|
-
# specified, the default value of `0` is used.
|
528
|
+
# the specified capacity provider for each service. Only one capacity
|
529
|
+
# provider in a capacity provider strategy can have a *base* defined.
|
530
|
+
# If no value is specified, the default value of `0` is used.
|
531
|
+
#
|
532
|
+
# Base value characteristics:
|
533
|
+
#
|
534
|
+
# * Only one capacity provider in a strategy can have a base defined
|
535
|
+
#
|
536
|
+
# * Default value is `0` if not specified
|
537
|
+
#
|
538
|
+
# * Valid range: 0 to 100,000
|
539
|
+
#
|
540
|
+
# * Base requirements are satisfied first before weight distribution
|
509
541
|
# @return [Integer]
|
510
542
|
#
|
511
543
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/CapacityProviderStrategyItem AWS API Documentation
|
@@ -608,7 +640,7 @@ module Aws::ECS
|
|
608
640
|
#
|
609
641
|
# @!attribute [rw] active_services_count
|
610
642
|
# The number of services that are running on the cluster in an
|
611
|
-
# `ACTIVE` state. You can view these services with [
|
643
|
+
# `ACTIVE` state. You can view these services with [ListServices][1].
|
612
644
|
#
|
613
645
|
#
|
614
646
|
#
|
@@ -934,7 +966,7 @@ module Aws::ECS
|
|
934
966
|
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/cloudwatch-container-insights.html
|
935
967
|
#
|
936
968
|
# @!attribute [rw] name
|
937
|
-
# The name of the cluster setting. The value is `containerInsights
|
969
|
+
# The name of the cluster setting. The value is `containerInsights`.
|
938
970
|
# @return [String]
|
939
971
|
#
|
940
972
|
# @!attribute [rw] value
|
@@ -2693,6 +2725,19 @@ module Aws::ECS
|
|
2693
2725
|
# Availability Zones][1] in the <i> <i>Amazon Elastic Container
|
2694
2726
|
# Service Developer Guide</i> </i>.
|
2695
2727
|
#
|
2728
|
+
# The default behavior of `AvailabilityZoneRebalancing` differs
|
2729
|
+
# between create and update requests:
|
2730
|
+
#
|
2731
|
+
# * For create service requests, when when no value is specified for
|
2732
|
+
# `AvailabilityZoneRebalancing`, Amazon ECS defaults the value to to
|
2733
|
+
# `ENABLED`.
|
2734
|
+
#
|
2735
|
+
# * For update service requests, when no value is specified for
|
2736
|
+
# `AvailabilityZoneRebalancing`, Amazon ECS defaults to the existing
|
2737
|
+
# service’s `AvailabilityZoneRebalancing` value. If the service
|
2738
|
+
# never had an `AvailabilityZoneRebalancing` value set, Amazon ECS
|
2739
|
+
# treats this as `DISABLED`.
|
2740
|
+
#
|
2696
2741
|
#
|
2697
2742
|
#
|
2698
2743
|
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-rebalancing.html
|
@@ -2703,13 +2748,13 @@ module Aws::ECS
|
|
2703
2748
|
# your service. For more information, see [Service load balancing][1]
|
2704
2749
|
# in the *Amazon Elastic Container Service Developer Guide*.
|
2705
2750
|
#
|
2706
|
-
# If the service uses the
|
2707
|
-
#
|
2708
|
-
#
|
2709
|
-
#
|
2710
|
-
#
|
2711
|
-
#
|
2712
|
-
#
|
2751
|
+
# If the service uses the `ECS` deployment controller and using either
|
2752
|
+
# an Application Load Balancer or Network Load Balancer, you must
|
2753
|
+
# specify one or more target group ARNs to attach to the service. The
|
2754
|
+
# service-linked role is required for services that use multiple
|
2755
|
+
# target groups. For more information, see [Using service-linked roles
|
2756
|
+
# for Amazon ECS][2] in the *Amazon Elastic Container Service
|
2757
|
+
# Developer Guide*.
|
2713
2758
|
#
|
2714
2759
|
# If the service uses the `CODE_DEPLOY` deployment controller, the
|
2715
2760
|
# service is required to use either an Application Load Balancer or
|
@@ -2905,19 +2950,12 @@ module Aws::ECS
|
|
2905
2950
|
# @return [Types::NetworkConfiguration]
|
2906
2951
|
#
|
2907
2952
|
# @!attribute [rw] health_check_grace_period_seconds
|
2908
|
-
# The period of time, in seconds, that the Amazon ECS service
|
2953
|
+
# The period of time, in seconds, that the Amazon Amazon ECS service
|
2909
2954
|
# scheduler ignores unhealthy Elastic Load Balancing, VPC Lattice, and
|
2910
|
-
# container health checks after a task has first started. If you
|
2911
|
-
#
|
2912
|
-
#
|
2955
|
+
# container health checks after a task has first started. If you do
|
2956
|
+
# not specify a health check grace period value, the default value of
|
2957
|
+
# 0 is used. If you do not use any of the health checks, then
|
2913
2958
|
# `healthCheckGracePeriodSeconds` is unused.
|
2914
|
-
#
|
2915
|
-
# If your service's tasks take a while to start and respond to health
|
2916
|
-
# checks, you can specify a health check grace period of up to
|
2917
|
-
# 2,147,483,647 seconds (about 69 years). During that time, the Amazon
|
2918
|
-
# ECS service scheduler ignores health check status. This grace period
|
2919
|
-
# can prevent the service scheduler from marking tasks as unhealthy
|
2920
|
-
# and stopping them before they have time to come up.
|
2921
2959
|
# @return [Integer]
|
2922
2960
|
#
|
2923
2961
|
# @!attribute [rw] scheduling_strategy
|
@@ -3938,7 +3976,7 @@ module Aws::ECS
|
|
3938
3976
|
# stops the unhealthy tasks one-by-one — using the
|
3939
3977
|
# `minimumHealthyPercent` as a constraint — to clear up capacity to
|
3940
3978
|
# launch replacement tasks. For more information about how the
|
3941
|
-
# scheduler replaces unhealthy tasks, see [Amazon ECS services][1]
|
3979
|
+
# scheduler replaces unhealthy tasks, see [Amazon ECS services][1].
|
3942
3980
|
#
|
3943
3981
|
# For services that *do not* use a load balancer, the following should
|
3944
3982
|
# be noted:
|
@@ -4775,8 +4813,7 @@ module Aws::ECS
|
|
4775
4813
|
# @!attribute [rw] cluster
|
4776
4814
|
# The short name or full Amazon Resource Name (ARN) of the cluster
|
4777
4815
|
# that hosts the task or tasks to describe. If you do not specify a
|
4778
|
-
# cluster, the default cluster is assumed.
|
4779
|
-
# value, the `default` cluster is used.
|
4816
|
+
# cluster, the default cluster is assumed.
|
4780
4817
|
# @return [String]
|
4781
4818
|
#
|
4782
4819
|
# @!attribute [rw] tasks
|
@@ -7327,7 +7364,7 @@ module Aws::ECS
|
|
7327
7364
|
#
|
7328
7365
|
# : Required: No
|
7329
7366
|
#
|
7330
|
-
# Default value: `
|
7367
|
+
# Default value: `10m`
|
7331
7368
|
#
|
7332
7369
|
# When `non-blocking` mode is used, the `max-buffer-size` log option
|
7333
7370
|
# controls the size of the buffer that's used for intermediate
|
@@ -7502,12 +7539,6 @@ module Aws::ECS
|
|
7502
7539
|
# When additional capacity is required, Amazon ECS will scale up the
|
7503
7540
|
# minimum scaling step size even if the actual demand is less than the
|
7504
7541
|
# minimum scaling step size.
|
7505
|
-
#
|
7506
|
-
# If you use a capacity provider with an Auto Scaling group configured
|
7507
|
-
# with more than one Amazon EC2 instance type or Availability Zone,
|
7508
|
-
# Amazon ECS will scale up by the exact minimum scaling step size
|
7509
|
-
# value and will ignore both the maximum scaling step size as well as
|
7510
|
-
# the capacity demand.
|
7511
7542
|
# @return [Integer]
|
7512
7543
|
#
|
7513
7544
|
# @!attribute [rw] maximum_scaling_step_size
|
@@ -9908,8 +9939,8 @@ module Aws::ECS
|
|
9908
9939
|
#
|
9909
9940
|
# @!attribute [rw] health_check_grace_period_seconds
|
9910
9941
|
# The period of time, in seconds, that the Amazon ECS service
|
9911
|
-
# scheduler ignores unhealthy Elastic Load Balancing
|
9912
|
-
# checks after a task has first started.
|
9942
|
+
# scheduler ignores unhealthy Elastic Load Balancing, VPC Lattice, and
|
9943
|
+
# container health checks after a task has first started.
|
9913
9944
|
# @return [Integer]
|
9914
9945
|
#
|
9915
9946
|
# @!attribute [rw] scheduling_strategy
|
@@ -10010,6 +10041,19 @@ module Aws::ECS
|
|
10010
10041
|
# Availability Zones][1] in the <i> <i>Amazon Elastic Container
|
10011
10042
|
# Service Developer Guide</i> </i>.
|
10012
10043
|
#
|
10044
|
+
# The default behavior of `AvailabilityZoneRebalancing` differs
|
10045
|
+
# between create and update requests:
|
10046
|
+
#
|
10047
|
+
# * For create service requests, when when no value is specified for
|
10048
|
+
# `AvailabilityZoneRebalancing`, Amazon ECS defaults the value to to
|
10049
|
+
# `ENABLED`.
|
10050
|
+
#
|
10051
|
+
# * For update service requests, when no value is specified for
|
10052
|
+
# `AvailabilityZoneRebalancing`, Amazon ECS defaults to the existing
|
10053
|
+
# service’s `AvailabilityZoneRebalancing` value. If the service
|
10054
|
+
# never had an `AvailabilityZoneRebalancing` value set, Amazon ECS
|
10055
|
+
# treats this as `DISABLED`.
|
10056
|
+
#
|
10013
10057
|
#
|
10014
10058
|
#
|
10015
10059
|
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-rebalancing.html
|
@@ -13847,6 +13891,8 @@ module Aws::ECS
|
|
13847
13891
|
# @!attribute [rw] desired_count
|
13848
13892
|
# The number of instantiations of the task to place and keep running
|
13849
13893
|
# in your service.
|
13894
|
+
#
|
13895
|
+
# This parameter doesn't trigger a new service deployment.
|
13850
13896
|
# @return [Integer]
|
13851
13897
|
#
|
13852
13898
|
# @!attribute [rw] task_definition
|
@@ -13856,6 +13902,8 @@ module Aws::ECS
|
|
13856
13902
|
# task definition with `UpdateService`, Amazon ECS spawns a task with
|
13857
13903
|
# the new version of the task definition and then stops an old task
|
13858
13904
|
# after the new version is running.
|
13905
|
+
#
|
13906
|
+
# This parameter triggers a new service deployment.
|
13859
13907
|
# @return [String]
|
13860
13908
|
#
|
13861
13909
|
# @!attribute [rw] capacity_provider_strategy
|
@@ -13892,6 +13940,8 @@ module Aws::ECS
|
|
13892
13940
|
# For information about Amazon Web Services CDK considerations, see
|
13893
13941
|
# [Amazon Web Services CDK considerations][1].
|
13894
13942
|
#
|
13943
|
+
# This parameter doesn't trigger a new service deployment.
|
13944
|
+
#
|
13895
13945
|
#
|
13896
13946
|
#
|
13897
13947
|
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/update-service-parameters.html
|
@@ -13901,6 +13951,8 @@ module Aws::ECS
|
|
13901
13951
|
# Optional deployment parameters that control how many tasks run
|
13902
13952
|
# during the deployment and the ordering of stopping and starting
|
13903
13953
|
# tasks.
|
13954
|
+
#
|
13955
|
+
# This parameter doesn't trigger a new service deployment.
|
13904
13956
|
# @return [Types::DeploymentConfiguration]
|
13905
13957
|
#
|
13906
13958
|
# @!attribute [rw] availability_zone_rebalancing
|
@@ -13911,6 +13963,21 @@ module Aws::ECS
|
|
13911
13963
|
# Availability Zones][1] in the <i> <i>Amazon Elastic Container
|
13912
13964
|
# Service Developer Guide</i> </i>.
|
13913
13965
|
#
|
13966
|
+
# The default behavior of `AvailabilityZoneRebalancing` differs
|
13967
|
+
# between create and update requests:
|
13968
|
+
#
|
13969
|
+
# * For create service requests, when when no value is specified for
|
13970
|
+
# `AvailabilityZoneRebalancing`, Amazon ECS defaults the value to to
|
13971
|
+
# `ENABLED`.
|
13972
|
+
#
|
13973
|
+
# * For update service requests, when no value is specified for
|
13974
|
+
# `AvailabilityZoneRebalancing`, Amazon ECS defaults to the existing
|
13975
|
+
# service’s `AvailabilityZoneRebalancing` value. If the service
|
13976
|
+
# never had an `AvailabilityZoneRebalancing` value set, Amazon ECS
|
13977
|
+
# treats this as `DISABLED`.
|
13978
|
+
#
|
13979
|
+
# This parameter doesn't trigger a new service deployment.
|
13980
|
+
#
|
13914
13981
|
#
|
13915
13982
|
#
|
13916
13983
|
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-rebalancing.html
|
@@ -13918,6 +13985,8 @@ module Aws::ECS
|
|
13918
13985
|
#
|
13919
13986
|
# @!attribute [rw] network_configuration
|
13920
13987
|
# An object representing the network configuration for the service.
|
13988
|
+
#
|
13989
|
+
# This parameter triggers a new service deployment.
|
13921
13990
|
# @return [Types::NetworkConfiguration]
|
13922
13991
|
#
|
13923
13992
|
# @!attribute [rw] placement_constraints
|
@@ -13931,6 +14000,8 @@ module Aws::ECS
|
|
13931
14000
|
# You can specify a maximum of 10 constraints for each task. This
|
13932
14001
|
# limit includes constraints in the task definition and those
|
13933
14002
|
# specified at runtime.
|
14003
|
+
#
|
14004
|
+
# This parameter doesn't trigger a new service deployment.
|
13934
14005
|
# @return [Array<Types::PlacementConstraint>]
|
13935
14006
|
#
|
13936
14007
|
# @!attribute [rw] placement_strategy
|
@@ -13941,6 +14012,8 @@ module Aws::ECS
|
|
13941
14012
|
# remove an existing placement strategy, specify an empty object.
|
13942
14013
|
#
|
13943
14014
|
# You can specify a maximum of five strategy rules for each service.
|
14015
|
+
#
|
14016
|
+
# This parameter doesn't trigger a new service deployment.
|
13944
14017
|
# @return [Array<Types::PlacementStrategy>]
|
13945
14018
|
#
|
13946
14019
|
# @!attribute [rw] platform_version
|
@@ -13951,6 +14024,8 @@ module Aws::ECS
|
|
13951
14024
|
# Platform Versions][1] in the *Amazon Elastic Container Service
|
13952
14025
|
# Developer Guide*.
|
13953
14026
|
#
|
14027
|
+
# This parameter triggers a new service deployment.
|
14028
|
+
#
|
13954
14029
|
#
|
13955
14030
|
#
|
13956
14031
|
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/platform_versions.html
|
@@ -13979,6 +14054,8 @@ module Aws::ECS
|
|
13979
14054
|
# ECS service scheduler ignores health check status. This grace period
|
13980
14055
|
# can prevent the service scheduler from marking tasks as unhealthy
|
13981
14056
|
# and stopping them before they have time to come up.
|
14057
|
+
#
|
14058
|
+
# This parameter doesn't trigger a new service deployment.
|
13982
14059
|
# @return [Integer]
|
13983
14060
|
#
|
13984
14061
|
# @!attribute [rw] deployment_controller
|
@@ -13992,6 +14069,8 @@ module Aws::ECS
|
|
13992
14069
|
# If you do not want to override the value that was set when the
|
13993
14070
|
# service was created, you can set this to `null` when performing this
|
13994
14071
|
# action.
|
14072
|
+
#
|
14073
|
+
# This parameter doesn't trigger a new service deployment.
|
13995
14074
|
# @return [Boolean]
|
13996
14075
|
#
|
13997
14076
|
# @!attribute [rw] enable_ecs_managed_tags
|
@@ -14004,6 +14083,8 @@ module Aws::ECS
|
|
14004
14083
|
# update the tags on all tasks, set `forceNewDeployment` to `true`, so
|
14005
14084
|
# that Amazon ECS starts new tasks with the updated tags.
|
14006
14085
|
#
|
14086
|
+
# This parameter doesn't trigger a new service deployment.
|
14087
|
+
#
|
14007
14088
|
#
|
14008
14089
|
#
|
14009
14090
|
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html
|
@@ -14045,6 +14126,8 @@ module Aws::ECS
|
|
14045
14126
|
#
|
14046
14127
|
# You can remove existing `loadBalancers` by passing an empty list.
|
14047
14128
|
#
|
14129
|
+
# This parameter triggers a new service deployment.
|
14130
|
+
#
|
14048
14131
|
#
|
14049
14132
|
#
|
14050
14133
|
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/register-multiple-targetgroups.html
|
@@ -14059,6 +14142,8 @@ module Aws::ECS
|
|
14059
14142
|
# Only tasks launched after the update will reflect the update. To
|
14060
14143
|
# update the tags on all tasks, set `forceNewDeployment` to `true`, so
|
14061
14144
|
# that Amazon ECS starts new tasks with the updated tags.
|
14145
|
+
#
|
14146
|
+
# This parameter doesn't trigger a new service deployment.
|
14062
14147
|
# @return [String]
|
14063
14148
|
#
|
14064
14149
|
# @!attribute [rw] service_registries
|
@@ -14080,6 +14165,8 @@ module Aws::ECS
|
|
14080
14165
|
# You can remove existing `serviceRegistries` by passing an empty
|
14081
14166
|
# list.
|
14082
14167
|
#
|
14168
|
+
# This parameter triggers a new service deployment.
|
14169
|
+
#
|
14083
14170
|
#
|
14084
14171
|
#
|
14085
14172
|
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html#ECS-CreateService-request-role
|
@@ -14100,6 +14187,8 @@ module Aws::ECS
|
|
14100
14187
|
# Connect][1] in the *Amazon Elastic Container Service Developer
|
14101
14188
|
# Guide*.
|
14102
14189
|
#
|
14190
|
+
# This parameter triggers a new service deployment.
|
14191
|
+
#
|
14103
14192
|
#
|
14104
14193
|
#
|
14105
14194
|
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html
|
@@ -14114,6 +14203,8 @@ module Aws::ECS
|
|
14114
14203
|
# configuration differs from the existing one, it triggers a new
|
14115
14204
|
# deployment.
|
14116
14205
|
#
|
14206
|
+
# This parameter triggers a new service deployment.
|
14207
|
+
#
|
14117
14208
|
#
|
14118
14209
|
#
|
14119
14210
|
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ServiceManagedEBSVolumeConfiguration.html
|
@@ -14122,6 +14213,8 @@ module Aws::ECS
|
|
14122
14213
|
# @!attribute [rw] vpc_lattice_configurations
|
14123
14214
|
# An object representing the VPC Lattice configuration for the service
|
14124
14215
|
# being updated.
|
14216
|
+
#
|
14217
|
+
# This parameter triggers a new service deployment.
|
14125
14218
|
# @return [Array<Types::VpcLatticeConfiguration>]
|
14126
14219
|
#
|
14127
14220
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/UpdateServiceRequest AWS API Documentation
|
data/lib/aws-sdk-ecs.rb
CHANGED
metadata
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: aws-sdk-ecs
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 1.
|
4
|
+
version: 1.204.0
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Amazon Web Services
|
@@ -18,7 +18,7 @@ dependencies:
|
|
18
18
|
version: '3'
|
19
19
|
- - ">="
|
20
20
|
- !ruby/object:Gem::Version
|
21
|
-
version: 3.
|
21
|
+
version: 3.231.0
|
22
22
|
type: :runtime
|
23
23
|
prerelease: false
|
24
24
|
version_requirements: !ruby/object:Gem::Requirement
|
@@ -28,7 +28,7 @@ dependencies:
|
|
28
28
|
version: '3'
|
29
29
|
- - ">="
|
30
30
|
- !ruby/object:Gem::Version
|
31
|
-
version: 3.
|
31
|
+
version: 3.231.0
|
32
32
|
- !ruby/object:Gem::Dependency
|
33
33
|
name: aws-sigv4
|
34
34
|
requirement: !ruby/object:Gem::Requirement
|