aws-sdk-ecs 1.99.0 → 1.100.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +5 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-ecs/client.rb +44 -40
- data/lib/aws-sdk-ecs/types.rb +152 -118
- data/lib/aws-sdk-ecs.rb +1 -1
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: b281c3b06771b917ba901037424e0fd0729911f7fb4a379059854c0ace42794c
|
4
|
+
data.tar.gz: ca27528e3d0d988c2d25082036867137404e2aa08701127b529b9b135f775b99
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 4e6f1dde1e63dc7968ade75e69a178fde91bf571aa66cdc18d7b1b48ed42647585440c4bf408aa5d85e63bd6a7f04dff9f1163af0dfeaddb8b4c3f61bf1bc391
|
7
|
+
data.tar.gz: e27a8623fc0de329ec6f72128162a25ca9a1deea292df9f9b3932f957d322f1e6206db46d5895c6731c2f81d4066e7082933a7a336c5b3739f6132d7a268422b
|
data/CHANGELOG.md
CHANGED
@@ -1,6 +1,11 @@
|
|
1
1
|
Unreleased Changes
|
2
2
|
------------------
|
3
3
|
|
4
|
+
1.100.0 (2022-06-21)
|
5
|
+
------------------
|
6
|
+
|
7
|
+
* Feature - Amazon ECS UpdateService now supports the following parameters: PlacementStrategies, PlacementConstraints and CapacityProviderStrategy.
|
8
|
+
|
4
9
|
1.99.0 (2022-03-22)
|
5
10
|
------------------
|
6
11
|
|
data/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
1.
|
1
|
+
1.100.0
|
data/lib/aws-sdk-ecs/client.rb
CHANGED
@@ -473,7 +473,7 @@ module Aws::ECS
|
|
473
473
|
# that it can manage required resources in other Amazon Web Services
|
474
474
|
# services on your behalf. However, if the IAM user that makes the call
|
475
475
|
# doesn't have permissions to create the service-linked role, it isn't
|
476
|
-
# created. For more information, see [Using
|
476
|
+
# created. For more information, see [Using service-linked roles for
|
477
477
|
# Amazon ECS][1] in the *Amazon Elastic Container Service Developer
|
478
478
|
# Guide*.
|
479
479
|
#
|
@@ -683,8 +683,8 @@ module Aws::ECS
|
|
683
683
|
# In addition to maintaining the desired count of tasks in your service,
|
684
684
|
# you can optionally run your service behind one or more load balancers.
|
685
685
|
# The load balancers distribute traffic across the tasks that are
|
686
|
-
# associated with the service. For more information, see [Service
|
687
|
-
#
|
686
|
+
# associated with the service. For more information, see [Service load
|
687
|
+
# balancing][1] in the *Amazon Elastic Container Service Developer
|
688
688
|
# Guide*.
|
689
689
|
#
|
690
690
|
# Tasks for services that don't use a load balancer are considered
|
@@ -698,8 +698,8 @@ module Aws::ECS
|
|
698
698
|
# your desired number of tasks across your cluster. By default, the
|
699
699
|
# service scheduler spreads tasks across Availability Zones. You can
|
700
700
|
# use task placement strategies and constraints to customize task
|
701
|
-
# placement decisions. For more information, see [Service
|
702
|
-
#
|
701
|
+
# placement decisions. For more information, see [Service scheduler
|
702
|
+
# concepts][2] in the *Amazon Elastic Container Service Developer
|
703
703
|
# Guide*.
|
704
704
|
#
|
705
705
|
# * `DAEMON` - The daemon scheduling strategy deploys exactly one task
|
@@ -709,8 +709,8 @@ module Aws::ECS
|
|
709
709
|
# tasks. It also stops tasks that don't meet the placement
|
710
710
|
# constraints. When using this strategy, you don't need to specify a
|
711
711
|
# desired number of tasks, a task placement strategy, or use Service
|
712
|
-
# Auto Scaling policies. For more information, see [Service
|
713
|
-
#
|
712
|
+
# Auto Scaling policies. For more information, see [Service scheduler
|
713
|
+
# concepts][2] in the *Amazon Elastic Container Service Developer
|
714
714
|
# Guide*.
|
715
715
|
#
|
716
716
|
# You can optionally specify a deployment configuration for your
|
@@ -766,7 +766,7 @@ module Aws::ECS
|
|
766
766
|
# controller, you can specify only parameters that aren't controlled at
|
767
767
|
# the task set level. The only required parameter is the service name.
|
768
768
|
# You control your services using the CreateTaskSet operation. For more
|
769
|
-
# information, see [Amazon ECS
|
769
|
+
# information, see [Amazon ECS deployment types][3] in the *Amazon
|
770
770
|
# Elastic Container Service Developer Guide*.
|
771
771
|
#
|
772
772
|
# When the service scheduler launches new tasks, it determines task
|
@@ -820,7 +820,7 @@ module Aws::ECS
|
|
820
820
|
#
|
821
821
|
# @option params [Array<Types::LoadBalancer>] :load_balancers
|
822
822
|
# A load balancer object representing the load balancers to use with
|
823
|
-
# your service. For more information, see [Service
|
823
|
+
# your service. For more information, see [Service load balancing][1] in
|
824
824
|
# the *Amazon Elastic Container Service Developer Guide*.
|
825
825
|
#
|
826
826
|
# If the service uses the rolling update (`ECS`) deployment controller
|
@@ -1100,8 +1100,8 @@ module Aws::ECS
|
|
1100
1100
|
#
|
1101
1101
|
# @option params [Boolean] :enable_ecs_managed_tags
|
1102
1102
|
# Specifies whether to turn on Amazon ECS managed tags for the tasks
|
1103
|
-
# within the service. For more information, see [Tagging
|
1104
|
-
#
|
1103
|
+
# within the service. For more information, see [Tagging your Amazon ECS
|
1104
|
+
# resources][1] in the *Amazon Elastic Container Service Developer
|
1105
1105
|
# Guide*.
|
1106
1106
|
#
|
1107
1107
|
#
|
@@ -1455,7 +1455,7 @@ module Aws::ECS
|
|
1455
1455
|
|
1456
1456
|
# Create a task set in the specified cluster and service. This is used
|
1457
1457
|
# when a service uses the `EXTERNAL` deployment controller type. For
|
1458
|
-
# more information, see [Amazon ECS
|
1458
|
+
# more information, see [Amazon ECS deployment types][1] in the *Amazon
|
1459
1459
|
# Elastic Container Service Developer Guide*.
|
1460
1460
|
#
|
1461
1461
|
#
|
@@ -1490,7 +1490,7 @@ module Aws::ECS
|
|
1490
1490
|
#
|
1491
1491
|
# @option params [Array<Types::ServiceRegistry>] :service_registries
|
1492
1492
|
# The details of the service discovery registries to assign to this task
|
1493
|
-
# set. For more information, see [Service
|
1493
|
+
# set. For more information, see [Service discovery][1].
|
1494
1494
|
#
|
1495
1495
|
#
|
1496
1496
|
#
|
@@ -1498,7 +1498,7 @@ module Aws::ECS
|
|
1498
1498
|
#
|
1499
1499
|
# @option params [String] :launch_type
|
1500
1500
|
# The launch type that new tasks in the task set uses. For more
|
1501
|
-
# information, see [Amazon ECS
|
1501
|
+
# information, see [Amazon ECS launch types][1] in the *Amazon Elastic
|
1502
1502
|
# Container Service Developer Guide*.
|
1503
1503
|
#
|
1504
1504
|
# If a `launchType` is specified, the `capacityProviderStrategy`
|
@@ -2178,7 +2178,7 @@ module Aws::ECS
|
|
2178
2178
|
|
2179
2179
|
# Deletes a specified task set within a service. This is used when a
|
2180
2180
|
# service uses the `EXTERNAL` deployment controller type. For more
|
2181
|
-
# information, see [Amazon ECS
|
2181
|
+
# information, see [Amazon ECS deployment types][1] in the *Amazon
|
2182
2182
|
# Elastic Container Service Developer Guide*.
|
2183
2183
|
#
|
2184
2184
|
#
|
@@ -2295,11 +2295,12 @@ module Aws::ECS
|
|
2295
2295
|
#
|
2296
2296
|
# @option params [required, String] :container_instance
|
2297
2297
|
# The container instance ID or full ARN of the container instance to
|
2298
|
-
# deregister.
|
2299
|
-
#
|
2300
|
-
#
|
2301
|
-
#
|
2302
|
-
#
|
2298
|
+
# deregister. For more information about the ARN format, see [Amazon
|
2299
|
+
# Resource Name (ARN)][1] in the *Amazon ECS Developer Guide*.
|
2300
|
+
#
|
2301
|
+
#
|
2302
|
+
#
|
2303
|
+
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-account-settings.html#ecs-resource-ids
|
2303
2304
|
#
|
2304
2305
|
# @option params [Boolean] :force
|
2305
2306
|
# Forces the container instance to be deregistered. If you have tasks
|
@@ -3605,6 +3606,9 @@ module Aws::ECS
|
|
3605
3606
|
|
3606
3607
|
# Describes a specified task or tasks.
|
3607
3608
|
#
|
3609
|
+
# Currently, stopped tasks appear in the returned results for at least
|
3610
|
+
# one hour.
|
3611
|
+
#
|
3608
3612
|
# @option params [String] :cluster
|
3609
3613
|
# The short name or full Amazon Resource Name (ARN) of the cluster that
|
3610
3614
|
# hosts the task or tasks to describe. If you do not specify a cluster,
|
@@ -3816,12 +3820,13 @@ module Aws::ECS
|
|
3816
3820
|
# Returns an endpoint for the Amazon ECS agent to poll for updates.
|
3817
3821
|
#
|
3818
3822
|
# @option params [String] :container_instance
|
3819
|
-
# The container instance ID or full ARN of the container instance.
|
3820
|
-
#
|
3821
|
-
#
|
3822
|
-
#
|
3823
|
-
#
|
3824
|
-
#
|
3823
|
+
# The container instance ID or full ARN of the container instance. For
|
3824
|
+
# more information about the ARN format, see [Amazon Resource Name
|
3825
|
+
# (ARN)][1] in the *Amazon ECS Developer Guide*.
|
3826
|
+
#
|
3827
|
+
#
|
3828
|
+
#
|
3829
|
+
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-account-settings.html#ecs-resource-ids
|
3825
3830
|
#
|
3826
3831
|
# @option params [String] :cluster
|
3827
3832
|
# The short name or full Amazon Resource Name (ARN) of the cluster that
|
@@ -3855,6 +3860,12 @@ module Aws::ECS
|
|
3855
3860
|
|
3856
3861
|
# Runs a command remotely on a container within a task.
|
3857
3862
|
#
|
3863
|
+
# If you use a condition key in your IAM policy to refine the conditions
|
3864
|
+
# for the policy statement, for example limit the actions to a specific
|
3865
|
+
# cluster, you recevie an `AccessDeniedException` when there is a
|
3866
|
+
# mismatch between the condition key value and the corresponding
|
3867
|
+
# parameter value.
|
3868
|
+
#
|
3858
3869
|
# @option params [String] :cluster
|
3859
3870
|
# The Amazon Resource Name (ARN) or short name of the cluster the task
|
3860
3871
|
# is running in. If you do not specify a cluster, the default cluster is
|
@@ -7998,12 +8009,6 @@ module Aws::ECS
|
|
7998
8009
|
req.send_request(options)
|
7999
8010
|
end
|
8000
8011
|
|
8001
|
-
# Updating the task placement strategies and constraints on an Amazon
|
8002
|
-
# ECS service remains in preview and is a Beta Service as defined by and
|
8003
|
-
# subject to the Beta Service Participation Service Terms located at
|
8004
|
-
# [https://aws.amazon.com/service-terms][1] ("Beta Terms"). These Beta
|
8005
|
-
# Terms apply to your participation in this preview.
|
8006
|
-
#
|
8007
8012
|
# Modifies the parameters of a service.
|
8008
8013
|
#
|
8009
8014
|
# For services using the rolling update (`ECS`) you can update the
|
@@ -8019,7 +8024,7 @@ module Aws::ECS
|
|
8019
8024
|
# ECS managed tags option, and propagate tags can be updated using this
|
8020
8025
|
# API. If the network configuration, platform version, task definition,
|
8021
8026
|
# or load balancer need to be updated, create a new CodeDeploy
|
8022
|
-
# deployment. For more information, see [CreateDeployment][
|
8027
|
+
# deployment. For more information, see [CreateDeployment][1] in the
|
8023
8028
|
# *CodeDeploy API Reference*.
|
8024
8029
|
#
|
8025
8030
|
# For services using an external deployment controller, you can update
|
@@ -8118,9 +8123,9 @@ module Aws::ECS
|
|
8118
8123
|
# <note markdown="1"> You must have a service-linked role when you update any of the
|
8119
8124
|
# following service properties. If you specified a custom IAM role when
|
8120
8125
|
# you created the service, Amazon ECS automatically replaces the
|
8121
|
-
# [roleARN][
|
8126
|
+
# [roleARN][2] associated with the service with the ARN of your
|
8122
8127
|
# service-linked role. For more information, see [Service-linked
|
8123
|
-
# roles][
|
8128
|
+
# roles][3] in the *Amazon Elastic Container Service Developer Guide*.
|
8124
8129
|
#
|
8125
8130
|
# * `loadBalancers,`
|
8126
8131
|
#
|
@@ -8130,10 +8135,9 @@ module Aws::ECS
|
|
8130
8135
|
#
|
8131
8136
|
#
|
8132
8137
|
#
|
8133
|
-
# [1]: https://aws.amazon.com/
|
8134
|
-
# [2]: https://docs.aws.amazon.com/
|
8135
|
-
# [3]: https://docs.aws.amazon.com/AmazonECS/latest/
|
8136
|
-
# [4]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using-service-linked-roles.html
|
8138
|
+
# [1]: https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_CreateDeployment.html
|
8139
|
+
# [2]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_Service.html#ECS-Type-Service-roleArn
|
8140
|
+
# [3]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using-service-linked-roles.html
|
8137
8141
|
#
|
8138
8142
|
# @option params [String] :cluster
|
8139
8143
|
# The short name or full Amazon Resource Name (ARN) of the cluster that
|
@@ -8753,7 +8757,7 @@ module Aws::ECS
|
|
8753
8757
|
params: params,
|
8754
8758
|
config: config)
|
8755
8759
|
context[:gem_name] = 'aws-sdk-ecs'
|
8756
|
-
context[:gem_version] = '1.
|
8760
|
+
context[:gem_version] = '1.100.0'
|
8757
8761
|
Seahorse::Client::Request.new(handlers, context)
|
8758
8762
|
end
|
8759
8763
|
|
data/lib/aws-sdk-ecs/types.rb
CHANGED
@@ -506,11 +506,13 @@ module Aws::ECS
|
|
506
506
|
# simultaneously.
|
507
507
|
#
|
508
508
|
# @!attribute [rw] cluster_arn
|
509
|
-
# The Amazon Resource Name (ARN) that identifies the cluster.
|
510
|
-
#
|
511
|
-
#
|
512
|
-
#
|
513
|
-
#
|
509
|
+
# The Amazon Resource Name (ARN) that identifies the cluster. For more
|
510
|
+
# information about the ARN format, see [Amazon Resource Name
|
511
|
+
# (ARN)][1] in the *Amazon ECS Developer Guide*.
|
512
|
+
#
|
513
|
+
#
|
514
|
+
#
|
515
|
+
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-account-settings.html#ecs-resource-ids
|
514
516
|
# @return [String]
|
515
517
|
#
|
516
518
|
# @!attribute [rw] cluster_name
|
@@ -642,8 +644,8 @@ module Aws::ECS
|
|
642
644
|
#
|
643
645
|
# @!attribute [rw] attachments
|
644
646
|
# The resources attached to a cluster. When using a capacity provider
|
645
|
-
# with a cluster, the
|
646
|
-
#
|
647
|
+
# with a cluster, the capacity provider and associated resources are
|
648
|
+
# returned as cluster attachments.
|
647
649
|
# @return [Array<Types::Attachment>]
|
648
650
|
#
|
649
651
|
# @!attribute [rw] attachments_status
|
@@ -653,8 +655,6 @@ module Aws::ECS
|
|
653
655
|
# UPDATE\_IN\_PROGRESS
|
654
656
|
#
|
655
657
|
# : The available capacity providers for the cluster are updating.
|
656
|
-
# This occurs when the Auto Scaling plan is provisioning or
|
657
|
-
# deprovisioning.
|
658
658
|
#
|
659
659
|
# UPDATE\_COMPLETE
|
660
660
|
#
|
@@ -1184,12 +1184,12 @@ module Aws::ECS
|
|
1184
1184
|
# container is placed. Otherwise, the value of `memory` is used.
|
1185
1185
|
#
|
1186
1186
|
# The Docker 20.10.0 or later daemon reserves a minimum of 6 MiB of
|
1187
|
-
# memory for a container,
|
1188
|
-
#
|
1187
|
+
# memory for a container. So, don't specify less than 6 MiB of memory
|
1188
|
+
# for your containers.
|
1189
1189
|
#
|
1190
1190
|
# The Docker 19.03.13-ce or earlier daemon reserves a minimum of 4 MiB
|
1191
|
-
# of memory for a container,
|
1192
|
-
#
|
1191
|
+
# of memory for a container. So, don't specify less than 4 MiB of
|
1192
|
+
# memory for your containers.
|
1193
1193
|
#
|
1194
1194
|
#
|
1195
1195
|
#
|
@@ -2073,16 +2073,17 @@ module Aws::ECS
|
|
2073
2073
|
include Aws::Structure
|
2074
2074
|
end
|
2075
2075
|
|
2076
|
-
# An EC2 instance that's running the Amazon ECS
|
2077
|
-
# registered with a cluster.
|
2076
|
+
# An Amazon EC2 or External instance that's running the Amazon ECS
|
2077
|
+
# agent and has been registered with a cluster.
|
2078
2078
|
#
|
2079
2079
|
# @!attribute [rw] container_instance_arn
|
2080
|
-
# The Amazon Resource Name (ARN) of the container instance.
|
2081
|
-
#
|
2082
|
-
#
|
2083
|
-
#
|
2084
|
-
#
|
2085
|
-
#
|
2080
|
+
# The Amazon Resource Name (ARN) of the container instance. For more
|
2081
|
+
# information about the ARN format, see [Amazon Resource Name
|
2082
|
+
# (ARN)][1] in the *Amazon ECS Developer Guide*.
|
2083
|
+
#
|
2084
|
+
#
|
2085
|
+
#
|
2086
|
+
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-account-settings.html#ecs-resource-ids
|
2086
2087
|
# @return [String]
|
2087
2088
|
#
|
2088
2089
|
# @!attribute [rw] ec2_instance_id
|
@@ -2156,7 +2157,7 @@ module Aws::ECS
|
|
2156
2157
|
# tasks. The `DRAINING` indicates that new tasks aren't placed on the
|
2157
2158
|
# container instance and any service tasks running on the container
|
2158
2159
|
# instance are removed if possible. For more information, see
|
2159
|
-
# [Container
|
2160
|
+
# [Container instance draining][1] in the *Amazon Elastic Container
|
2160
2161
|
# Service Developer Guide*.
|
2161
2162
|
#
|
2162
2163
|
#
|
@@ -2170,9 +2171,9 @@ module Aws::ECS
|
|
2170
2171
|
#
|
2171
2172
|
# @!attribute [rw] agent_connected
|
2172
2173
|
# This parameter returns `true` if the agent is connected to Amazon
|
2173
|
-
# ECS.
|
2174
|
-
#
|
2175
|
-
#
|
2174
|
+
# ECS. An instance with an agent that may be unhealthy or stopped
|
2175
|
+
# return `false`. Only instances connected to an agent can accept task
|
2176
|
+
# placement requests.
|
2176
2177
|
# @return [Boolean]
|
2177
2178
|
#
|
2178
2179
|
# @!attribute [rw] running_tasks_count
|
@@ -2202,8 +2203,8 @@ module Aws::ECS
|
|
2202
2203
|
# @return [Time]
|
2203
2204
|
#
|
2204
2205
|
# @!attribute [rw] attachments
|
2205
|
-
# The resources attached to a container instance, such as elastic
|
2206
|
-
# network
|
2206
|
+
# The resources attached to a container instance, such as an elastic
|
2207
|
+
# network interface.
|
2207
2208
|
# @return [Array<Types::Attachment>]
|
2208
2209
|
#
|
2209
2210
|
# @!attribute [rw] tags
|
@@ -2789,7 +2790,7 @@ module Aws::ECS
|
|
2789
2790
|
#
|
2790
2791
|
# @!attribute [rw] load_balancers
|
2791
2792
|
# A load balancer object representing the load balancers to use with
|
2792
|
-
# your service. For more information, see [Service
|
2793
|
+
# your service. For more information, see [Service load balancing][1]
|
2793
2794
|
# in the *Amazon Elastic Container Service Developer Guide*.
|
2794
2795
|
#
|
2795
2796
|
# If the service uses the rolling update (`ECS`) deployment controller
|
@@ -3091,8 +3092,8 @@ module Aws::ECS
|
|
3091
3092
|
#
|
3092
3093
|
# @!attribute [rw] enable_ecs_managed_tags
|
3093
3094
|
# Specifies whether to turn on Amazon ECS managed tags for the tasks
|
3094
|
-
# within the service. For more information, see [Tagging
|
3095
|
-
# ECS
|
3095
|
+
# within the service. For more information, see [Tagging your Amazon
|
3096
|
+
# ECS resources][1] in the *Amazon Elastic Container Service Developer
|
3096
3097
|
# Guide*.
|
3097
3098
|
#
|
3098
3099
|
#
|
@@ -3254,7 +3255,7 @@ module Aws::ECS
|
|
3254
3255
|
#
|
3255
3256
|
# @!attribute [rw] service_registries
|
3256
3257
|
# The details of the service discovery registries to assign to this
|
3257
|
-
# task set. For more information, see [Service
|
3258
|
+
# task set. For more information, see [Service discovery][1].
|
3258
3259
|
#
|
3259
3260
|
#
|
3260
3261
|
#
|
@@ -3263,7 +3264,7 @@ module Aws::ECS
|
|
3263
3264
|
#
|
3264
3265
|
# @!attribute [rw] launch_type
|
3265
3266
|
# The launch type that new tasks in the task set uses. For more
|
3266
|
-
# information, see [Amazon ECS
|
3267
|
+
# information, see [Amazon ECS launch types][1] in the *Amazon Elastic
|
3267
3268
|
# Container Service Developer Guide*.
|
3268
3269
|
#
|
3269
3270
|
# If a `launchType` is specified, the `capacityProviderStrategy`
|
@@ -3880,54 +3881,83 @@ module Aws::ECS
|
|
3880
3881
|
#
|
3881
3882
|
# @!attribute [rw] maximum_percent
|
3882
3883
|
# If a service is using the rolling update (`ECS`) deployment type,
|
3883
|
-
# the
|
3884
|
-
# number of
|
3885
|
-
# `PENDING` state during a deployment, as a percentage of the
|
3886
|
-
#
|
3887
|
-
#
|
3888
|
-
#
|
3889
|
-
#
|
3890
|
-
#
|
3891
|
-
#
|
3892
|
-
#
|
3893
|
-
#
|
3894
|
-
#
|
3895
|
-
# If a service is using the blue/green (`CODE_DEPLOY`) or
|
3896
|
-
# deployment types and tasks that use the EC2 launch type,
|
3897
|
-
# **maximum percent** value is set to the default value and is
|
3898
|
-
# define the upper limit on the number of the tasks in the
|
3899
|
-
# that remain in the `RUNNING` state while the container
|
3900
|
-
# in the `DRAINING` state. If the tasks in the service
|
3901
|
-
# launch type, the maximum percent value is not used,
|
3902
|
-
# returned when describing your service.
|
3884
|
+
# the `maximumPercent` parameter represents an upper limit on the
|
3885
|
+
# number of your service's tasks that are allowed in the `RUNNING` or
|
3886
|
+
# `PENDING` state during a deployment, as a percentage of the
|
3887
|
+
# `desiredCount` (rounded down to the nearest integer). This parameter
|
3888
|
+
# enables you to define the deployment batch size. For example, if
|
3889
|
+
# your service is using the `REPLICA` service scheduler and has a
|
3890
|
+
# `desiredCount` of four tasks and a `maximumPercent` value of 200%,
|
3891
|
+
# the scheduler may start four new tasks before stopping the four
|
3892
|
+
# older tasks (provided that the cluster resources required to do this
|
3893
|
+
# are available). The default `maximumPercent` value for a service
|
3894
|
+
# using the `REPLICA` service scheduler is 200%.
|
3895
|
+
#
|
3896
|
+
# If a service is using either the blue/green (`CODE_DEPLOY`) or
|
3897
|
+
# `EXTERNAL` deployment types and tasks that use the EC2 launch type,
|
3898
|
+
# the **maximum percent** value is set to the default value and is
|
3899
|
+
# used to define the upper limit on the number of the tasks in the
|
3900
|
+
# service that remain in the `RUNNING` state while the container
|
3901
|
+
# instances are in the `DRAINING` state. If the tasks in the service
|
3902
|
+
# use the Fargate launch type, the maximum percent value is not used,
|
3903
|
+
# although it is returned when describing your service.
|
3903
3904
|
# @return [Integer]
|
3904
3905
|
#
|
3905
3906
|
# @!attribute [rw] minimum_healthy_percent
|
3906
3907
|
# If a service is using the rolling update (`ECS`) deployment type,
|
3907
|
-
# the
|
3908
|
-
#
|
3909
|
-
# during a deployment, as a percentage of the
|
3910
|
-
#
|
3911
|
-
# instances are in the `DRAINING` state if the service contains tasks
|
3912
|
-
# using the EC2 launch type. This parameter enables you to deploy
|
3908
|
+
# the `minimumHealthyPercent` represents a lower limit on the number
|
3909
|
+
# of your service's tasks that must remain in the `RUNNING` state
|
3910
|
+
# during a deployment, as a percentage of the `desiredCount` (rounded
|
3911
|
+
# up to the nearest integer). This parameter enables you to deploy
|
3913
3912
|
# without using additional cluster capacity. For example, if your
|
3914
|
-
# service has a
|
3915
|
-
#
|
3916
|
-
# cluster capacity before starting two new
|
3917
|
-
#
|
3918
|
-
#
|
3919
|
-
#
|
3920
|
-
#
|
3921
|
-
#
|
3922
|
-
#
|
3923
|
-
#
|
3924
|
-
#
|
3925
|
-
#
|
3926
|
-
#
|
3927
|
-
#
|
3928
|
-
#
|
3929
|
-
#
|
3930
|
-
#
|
3913
|
+
# service has a `desiredCount` of four tasks and a
|
3914
|
+
# `minimumHealthyPercent` of 50%, the service scheduler may stop two
|
3915
|
+
# existing tasks to free up cluster capacity before starting two new
|
3916
|
+
# tasks.
|
3917
|
+
#
|
3918
|
+
# For services that *do not* use a load balancer, the following should
|
3919
|
+
# be noted:
|
3920
|
+
#
|
3921
|
+
# * A service is considered healthy if all essential containers within
|
3922
|
+
# the tasks in the service pass their health checks.
|
3923
|
+
#
|
3924
|
+
# * If a task has no essential containers with a health check defined,
|
3925
|
+
# the service scheduler will wait for 40 seconds after a task
|
3926
|
+
# reaches a `RUNNING` state before the task is counted towards the
|
3927
|
+
# minimum healthy percent total.
|
3928
|
+
#
|
3929
|
+
# * If a task has one or more essential containers with a health check
|
3930
|
+
# defined, the service scheduler will wait for the task to reach a
|
3931
|
+
# healthy status before counting it towards the minimum healthy
|
3932
|
+
# percent total. A task is considered healthy when all essential
|
3933
|
+
# containers within the task have passed their health checks. The
|
3934
|
+
# amount of time the service scheduler can wait for is determined by
|
3935
|
+
# the container health check settings.
|
3936
|
+
#
|
3937
|
+
# For services are that *do* use a load balancer, the following should
|
3938
|
+
# be noted:
|
3939
|
+
#
|
3940
|
+
# * If a task has no essential containers with a health check defined,
|
3941
|
+
# the service scheduler will wait for the load balancer target group
|
3942
|
+
# health check to return a healthy status before counting the task
|
3943
|
+
# towards the minimum healthy percent total.
|
3944
|
+
#
|
3945
|
+
# * If a task has an essential container with a health check defined,
|
3946
|
+
# the service scheduler will wait for both the task to reach a
|
3947
|
+
# healthy status and the load balancer target group health check to
|
3948
|
+
# return a healthy status before counting the task towards the
|
3949
|
+
# minimum healthy percent total.
|
3950
|
+
#
|
3951
|
+
# If a service is using either the blue/green (`CODE_DEPLOY`) or
|
3952
|
+
# `EXTERNAL` deployment types and is running tasks that use the EC2
|
3953
|
+
# launch type, the **minimum healthy percent** value is set to the
|
3954
|
+
# default value and is used to define the lower limit on the number of
|
3955
|
+
# the tasks in the service that remain in the `RUNNING` state while
|
3956
|
+
# the container instances are in the `DRAINING` state. If a service is
|
3957
|
+
# using either the blue/green (`CODE_DEPLOY`) or `EXTERNAL` deployment
|
3958
|
+
# types and is running tasks that use the Fargate launch type, the
|
3959
|
+
# minimum healthy percent value is not used, although it is returned
|
3960
|
+
# when describing your service.
|
3931
3961
|
# @return [Integer]
|
3932
3962
|
#
|
3933
3963
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DeploymentConfiguration AWS API Documentation
|
@@ -3941,7 +3971,7 @@ module Aws::ECS
|
|
3941
3971
|
end
|
3942
3972
|
|
3943
3973
|
# The deployment controller to use for the service. For more
|
3944
|
-
# information, see [Amazon ECS
|
3974
|
+
# information, see [Amazon ECS deployment types][1] in the *Amazon
|
3945
3975
|
# Elastic Container Service Developer Guide*.
|
3946
3976
|
#
|
3947
3977
|
#
|
@@ -4008,11 +4038,12 @@ module Aws::ECS
|
|
4008
4038
|
#
|
4009
4039
|
# @!attribute [rw] container_instance
|
4010
4040
|
# The container instance ID or full ARN of the container instance to
|
4011
|
-
# deregister.
|
4012
|
-
#
|
4013
|
-
#
|
4014
|
-
#
|
4015
|
-
#
|
4041
|
+
# deregister. For more information about the ARN format, see [Amazon
|
4042
|
+
# Resource Name (ARN)][1] in the *Amazon ECS Developer Guide*.
|
4043
|
+
#
|
4044
|
+
#
|
4045
|
+
#
|
4046
|
+
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-account-settings.html#ecs-resource-ids
|
4016
4047
|
# @return [String]
|
4017
4048
|
#
|
4018
4049
|
# @!attribute [rw] force
|
@@ -4578,12 +4609,13 @@ module Aws::ECS
|
|
4578
4609
|
# }
|
4579
4610
|
#
|
4580
4611
|
# @!attribute [rw] container_instance
|
4581
|
-
# The container instance ID or full ARN of the container instance.
|
4582
|
-
#
|
4583
|
-
#
|
4584
|
-
#
|
4585
|
-
#
|
4586
|
-
#
|
4612
|
+
# The container instance ID or full ARN of the container instance. For
|
4613
|
+
# more information about the ARN format, see [Amazon Resource Name
|
4614
|
+
# (ARN)][1] in the *Amazon ECS Developer Guide*.
|
4615
|
+
#
|
4616
|
+
#
|
4617
|
+
#
|
4618
|
+
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-account-settings.html#ecs-resource-ids
|
4587
4619
|
# @return [String]
|
4588
4620
|
#
|
4589
4621
|
# @!attribute [rw] cluster
|
@@ -4729,7 +4761,7 @@ module Aws::ECS
|
|
4729
4761
|
# will enforce the path set on the EFS access point. If an access
|
4730
4762
|
# point is used, transit encryption must be enabled in the
|
4731
4763
|
# `EFSVolumeConfiguration`. For more information, see [Working with
|
4732
|
-
# Amazon EFS
|
4764
|
+
# Amazon EFS access points][1] in the *Amazon Elastic File System User
|
4733
4765
|
# Guide*.
|
4734
4766
|
#
|
4735
4767
|
#
|
@@ -4743,7 +4775,7 @@ module Aws::ECS
|
|
4743
4775
|
# enabled, transit encryption must be enabled in the
|
4744
4776
|
# `EFSVolumeConfiguration`. If this parameter is omitted, the default
|
4745
4777
|
# value of `DISABLED` is used. For more information, see [Using Amazon
|
4746
|
-
# EFS
|
4778
|
+
# EFS access points][1] in the *Amazon Elastic Container Service
|
4747
4779
|
# Developer Guide*.
|
4748
4780
|
#
|
4749
4781
|
#
|
@@ -4762,7 +4794,7 @@ module Aws::ECS
|
|
4762
4794
|
|
4763
4795
|
# This parameter is specified when you're using an Amazon Elastic File
|
4764
4796
|
# System file system for task storage. For more information, see [Amazon
|
4765
|
-
# EFS
|
4797
|
+
# EFS volumes][1] in the *Amazon Elastic Container Service Developer
|
4766
4798
|
# Guide*.
|
4767
4799
|
#
|
4768
4800
|
#
|
@@ -4803,7 +4835,7 @@ module Aws::ECS
|
|
4803
4835
|
# between the Amazon ECS host and the Amazon EFS server. Transit
|
4804
4836
|
# encryption must be enabled if Amazon EFS IAM authorization is used.
|
4805
4837
|
# If this parameter is omitted, the default value of `DISABLED` is
|
4806
|
-
# used. For more information, see [Encrypting
|
4838
|
+
# used. For more information, see [Encrypting data in transit][1] in
|
4807
4839
|
# the *Amazon Elastic File System User Guide*.
|
4808
4840
|
#
|
4809
4841
|
#
|
@@ -4815,8 +4847,8 @@ module Aws::ECS
|
|
4815
4847
|
# The port to use when sending encrypted data between the Amazon ECS
|
4816
4848
|
# host and the Amazon EFS server. If you do not specify a transit
|
4817
4849
|
# encryption port, it will use the port selection strategy that the
|
4818
|
-
# Amazon EFS mount helper uses. For more information, see [EFS
|
4819
|
-
#
|
4850
|
+
# Amazon EFS mount helper uses. For more information, see [EFS mount
|
4851
|
+
# helper][1] in the *Amazon Elastic File System User Guide*.
|
4820
4852
|
#
|
4821
4853
|
#
|
4822
4854
|
#
|
@@ -5133,8 +5165,8 @@ module Aws::ECS
|
|
5133
5165
|
|
5134
5166
|
# The authorization configuration details for Amazon FSx for Windows
|
5135
5167
|
# File Server file system. See
|
5136
|
-
# [FSxWindowsFileServerVolumeConfiguration][1] in the *Amazon
|
5137
|
-
#
|
5168
|
+
# [FSxWindowsFileServerVolumeConfiguration][1] in the *Amazon ECS API
|
5169
|
+
# Reference*.
|
5138
5170
|
#
|
5139
5171
|
# For more information and the input format, see [Amazon FSx for Windows
|
5140
5172
|
# File Server Volumes][2] in the *Amazon Elastic Container Service
|
@@ -5157,7 +5189,7 @@ module Aws::ECS
|
|
5157
5189
|
# The authorization credential option to use. The authorization
|
5158
5190
|
# credential options can be provided using either the Amazon Resource
|
5159
5191
|
# Name (ARN) of an Secrets Manager secret or SSM Parameter Store
|
5160
|
-
# parameter. The
|
5192
|
+
# parameter. The ARN refers to the stored credentials.
|
5161
5193
|
# @return [String]
|
5162
5194
|
#
|
5163
5195
|
# @!attribute [rw] domain
|
@@ -5183,7 +5215,7 @@ module Aws::ECS
|
|
5183
5215
|
# File Server][1] file system for task storage.
|
5184
5216
|
#
|
5185
5217
|
# For more information and the input format, see [Amazon FSx for Windows
|
5186
|
-
# File Server
|
5218
|
+
# File Server volumes][2] in the *Amazon Elastic Container Service
|
5187
5219
|
# Developer Guide*.
|
5188
5220
|
#
|
5189
5221
|
#
|
@@ -5258,7 +5290,7 @@ module Aws::ECS
|
|
5258
5290
|
|
5259
5291
|
# The FireLens configuration for the container. This is used to specify
|
5260
5292
|
# and configure a log router for container logs. For more information,
|
5261
|
-
# see [Custom
|
5293
|
+
# see [Custom log routing][1] in the *Amazon Elastic Container Service
|
5262
5294
|
# Developer Guide*.
|
5263
5295
|
#
|
5264
5296
|
#
|
@@ -5287,8 +5319,8 @@ module Aws::ECS
|
|
5287
5319
|
# cluster, and container instance details to the log event. If
|
5288
5320
|
# specified, the syntax to use is
|
5289
5321
|
# `"options":\{"enable-ecs-log-metadata":"true|false","config-file-type:"s3|file","config-file-value":"arn:aws:s3:::mybucket/fluent.conf|filepath"\}`.
|
5290
|
-
# For more information, see [Creating a
|
5291
|
-
# FireLens
|
5322
|
+
# For more information, see [Creating a task definition that uses a
|
5323
|
+
# FireLens configuration][1] in the *Amazon Elastic Container Service
|
5292
5324
|
# Developer Guide*.
|
5293
5325
|
#
|
5294
5326
|
# <note markdown="1"> Tasks hosted on Fargate only support the `file` configuration file
|
@@ -5361,11 +5393,11 @@ module Aws::ECS
|
|
5361
5393
|
#
|
5362
5394
|
# * Container health checks require version 1.17.0 or greater of the
|
5363
5395
|
# Amazon ECS container agent. For more information, see [Updating the
|
5364
|
-
# Amazon ECS
|
5396
|
+
# Amazon ECS container agent][1].
|
5365
5397
|
#
|
5366
5398
|
# * Container health checks are supported for Fargate tasks if you're
|
5367
|
-
# using platform version 1.1.0 or greater. For more information, see
|
5368
|
-
# [Fargate
|
5399
|
+
# using platform version `1.1.0` or greater. For more information, see
|
5400
|
+
# [Fargate platform versions][2].
|
5369
5401
|
#
|
5370
5402
|
# * Container health checks aren't supported for tasks that are part of
|
5371
5403
|
# a service that's configured to use a Classic Load Balancer.
|
@@ -6692,8 +6724,8 @@ module Aws::ECS
|
|
6692
6724
|
# update the Elastic Load Balancing configuration.
|
6693
6725
|
#
|
6694
6726
|
# A service-linked role is required for services that use multiple
|
6695
|
-
# target groups. For more information, see [
|
6696
|
-
# the *Amazon Elastic Container Service Developer Guide*.
|
6727
|
+
# target groups. For more information, see [Using service-linked
|
6728
|
+
# roles][1] in the *Amazon Elastic Container Service Developer Guide*.
|
6697
6729
|
#
|
6698
6730
|
#
|
6699
6731
|
#
|
@@ -6719,12 +6751,12 @@ module Aws::ECS
|
|
6719
6751
|
#
|
6720
6752
|
# For services using the `ECS` deployment controller, you can specify
|
6721
6753
|
# one or multiple target groups. For more information, see
|
6722
|
-
# [Registering
|
6754
|
+
# [Registering multiple target groups with a service][1] in the
|
6723
6755
|
# *Amazon Elastic Container Service Developer Guide*.
|
6724
6756
|
#
|
6725
6757
|
# For services using the `CODE_DEPLOY` deployment controller, you're
|
6726
6758
|
# required to define two target groups for the load balancer. For more
|
6727
|
-
# information, see [Blue/
|
6759
|
+
# information, see [Blue/green deployment with CodeDeploy][2] in the
|
6728
6760
|
# *Amazon Elastic Container Service Developer Guide*.
|
6729
6761
|
#
|
6730
6762
|
# If your service's task definition uses the `awsvpc` network mode,
|
@@ -6878,7 +6910,7 @@ module Aws::ECS
|
|
6878
6910
|
#
|
6879
6911
|
# @!attribute [rw] secret_options
|
6880
6912
|
# The secrets to pass to the log configuration. For more information,
|
6881
|
-
# see [Specifying
|
6913
|
+
# see [Specifying sensitive data][1] in the *Amazon Elastic Container
|
6882
6914
|
# Service Developer Guide*.
|
6883
6915
|
#
|
6884
6916
|
#
|
@@ -6973,7 +7005,7 @@ module Aws::ECS
|
|
6973
7005
|
# scale-out actions of the Auto Scaling group. Amazon ECS manages a
|
6974
7006
|
# target tracking scaling policy using an Amazon ECS managed CloudWatch
|
6975
7007
|
# metric with the specified `targetCapacity` value as the target value
|
6976
|
-
# for the metric. For more information, see [Using
|
7008
|
+
# for the metric. For more information, see [Using managed scaling][1]
|
6977
7009
|
# in the *Amazon Elastic Container Service Developer Guide*.
|
6978
7010
|
#
|
6979
7011
|
# If managed scaling is disabled, the user must manage the scaling of
|
@@ -7192,7 +7224,7 @@ module Aws::ECS
|
|
7192
7224
|
class NoUpdateAvailableException < Aws::EmptyStructure; end
|
7193
7225
|
|
7194
7226
|
# An object representing a constraint on task placement. For more
|
7195
|
-
# information, see [Task
|
7227
|
+
# information, see [Task placement constraints][1] in the *Amazon
|
7196
7228
|
# Elastic Container Service Developer Guide*.
|
7197
7229
|
#
|
7198
7230
|
# <note markdown="1"> If you're using the Fargate launch type, task placement constraints
|
@@ -7241,7 +7273,7 @@ module Aws::ECS
|
|
7241
7273
|
end
|
7242
7274
|
|
7243
7275
|
# The task placement strategy for a task or service. For more
|
7244
|
-
# information, see [Task
|
7276
|
+
# information, see [Task placement strategies][1] in the *Amazon Elastic
|
7245
7277
|
# Container Service Developer Guide*.
|
7246
7278
|
#
|
7247
7279
|
#
|
@@ -9031,7 +9063,7 @@ module Aws::ECS
|
|
9031
9063
|
#
|
9032
9064
|
# You can run your Linux tasks on an ARM-based platform by setting the
|
9033
9065
|
# value to `ARM64`. This option is avaiable for tasks that run on
|
9034
|
-
#
|
9066
|
+
# Linux Amazon EC2 instance or Linux containers on Fargate.
|
9035
9067
|
# @return [String]
|
9036
9068
|
#
|
9037
9069
|
# @!attribute [rw] operating_system_family
|
@@ -9086,7 +9118,7 @@ module Aws::ECS
|
|
9086
9118
|
# * To reference sensitive information in the log configuration of a
|
9087
9119
|
# container, use the `secretOptions` container definition parameter.
|
9088
9120
|
#
|
9089
|
-
# For more information, see [Specifying
|
9121
|
+
# For more information, see [Specifying sensitive data][1] in the
|
9090
9122
|
# *Amazon Elastic Container Service Developer Guide*.
|
9091
9123
|
#
|
9092
9124
|
#
|
@@ -9154,11 +9186,13 @@ module Aws::ECS
|
|
9154
9186
|
# Details on a service within a cluster
|
9155
9187
|
#
|
9156
9188
|
# @!attribute [rw] service_arn
|
9157
|
-
# The ARN that identifies the service.
|
9158
|
-
#
|
9159
|
-
#
|
9160
|
-
#
|
9161
|
-
#
|
9189
|
+
# The ARN that identifies the service. For more information about the
|
9190
|
+
# ARN format, see [Amazon Resource Name (ARN)][1] in the *Amazon ECS
|
9191
|
+
# Developer Guide*.
|
9192
|
+
#
|
9193
|
+
#
|
9194
|
+
#
|
9195
|
+
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-account-settings.html#ecs-resource-ids
|
9162
9196
|
# @return [String]
|
9163
9197
|
#
|
9164
9198
|
# @!attribute [rw] service_name
|
data/lib/aws-sdk-ecs.rb
CHANGED
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
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.100.0
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Amazon Web Services
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date: 2022-
|
11
|
+
date: 2022-06-21 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: aws-sdk-core
|