aws-sdk-ecs 1.74.0 → 1.79.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 +480 -0
- data/LICENSE.txt +202 -0
- data/VERSION +1 -0
- data/lib/aws-sdk-ecs.rb +2 -2
- data/lib/aws-sdk-ecs/client.rb +473 -171
- data/lib/aws-sdk-ecs/client_api.rb +122 -1
- data/lib/aws-sdk-ecs/customizations.rb +1 -1
- data/lib/aws-sdk-ecs/errors.rb +12 -1
- data/lib/aws-sdk-ecs/resource.rb +1 -1
- data/lib/aws-sdk-ecs/types.rb +890 -287
- data/lib/aws-sdk-ecs/waiters.rb +1 -1
- metadata +9 -7
data/LICENSE.txt
ADDED
|
@@ -0,0 +1,202 @@
|
|
|
1
|
+
|
|
2
|
+
Apache License
|
|
3
|
+
Version 2.0, January 2004
|
|
4
|
+
http://www.apache.org/licenses/
|
|
5
|
+
|
|
6
|
+
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
|
|
7
|
+
|
|
8
|
+
1. Definitions.
|
|
9
|
+
|
|
10
|
+
"License" shall mean the terms and conditions for use, reproduction,
|
|
11
|
+
and distribution as defined by Sections 1 through 9 of this document.
|
|
12
|
+
|
|
13
|
+
"Licensor" shall mean the copyright owner or entity authorized by
|
|
14
|
+
the copyright owner that is granting the License.
|
|
15
|
+
|
|
16
|
+
"Legal Entity" shall mean the union of the acting entity and all
|
|
17
|
+
other entities that control, are controlled by, or are under common
|
|
18
|
+
control with that entity. For the purposes of this definition,
|
|
19
|
+
"control" means (i) the power, direct or indirect, to cause the
|
|
20
|
+
direction or management of such entity, whether by contract or
|
|
21
|
+
otherwise, or (ii) ownership of fifty percent (50%) or more of the
|
|
22
|
+
outstanding shares, or (iii) beneficial ownership of such entity.
|
|
23
|
+
|
|
24
|
+
"You" (or "Your") shall mean an individual or Legal Entity
|
|
25
|
+
exercising permissions granted by this License.
|
|
26
|
+
|
|
27
|
+
"Source" form shall mean the preferred form for making modifications,
|
|
28
|
+
including but not limited to software source code, documentation
|
|
29
|
+
source, and configuration files.
|
|
30
|
+
|
|
31
|
+
"Object" form shall mean any form resulting from mechanical
|
|
32
|
+
transformation or translation of a Source form, including but
|
|
33
|
+
not limited to compiled object code, generated documentation,
|
|
34
|
+
and conversions to other media types.
|
|
35
|
+
|
|
36
|
+
"Work" shall mean the work of authorship, whether in Source or
|
|
37
|
+
Object form, made available under the License, as indicated by a
|
|
38
|
+
copyright notice that is included in or attached to the work
|
|
39
|
+
(an example is provided in the Appendix below).
|
|
40
|
+
|
|
41
|
+
"Derivative Works" shall mean any work, whether in Source or Object
|
|
42
|
+
form, that is based on (or derived from) the Work and for which the
|
|
43
|
+
editorial revisions, annotations, elaborations, or other modifications
|
|
44
|
+
represent, as a whole, an original work of authorship. For the purposes
|
|
45
|
+
of this License, Derivative Works shall not include works that remain
|
|
46
|
+
separable from, or merely link (or bind by name) to the interfaces of,
|
|
47
|
+
the Work and Derivative Works thereof.
|
|
48
|
+
|
|
49
|
+
"Contribution" shall mean any work of authorship, including
|
|
50
|
+
the original version of the Work and any modifications or additions
|
|
51
|
+
to that Work or Derivative Works thereof, that is intentionally
|
|
52
|
+
submitted to Licensor for inclusion in the Work by the copyright owner
|
|
53
|
+
or by an individual or Legal Entity authorized to submit on behalf of
|
|
54
|
+
the copyright owner. For the purposes of this definition, "submitted"
|
|
55
|
+
means any form of electronic, verbal, or written communication sent
|
|
56
|
+
to the Licensor or its representatives, including but not limited to
|
|
57
|
+
communication on electronic mailing lists, source code control systems,
|
|
58
|
+
and issue tracking systems that are managed by, or on behalf of, the
|
|
59
|
+
Licensor for the purpose of discussing and improving the Work, but
|
|
60
|
+
excluding communication that is conspicuously marked or otherwise
|
|
61
|
+
designated in writing by the copyright owner as "Not a Contribution."
|
|
62
|
+
|
|
63
|
+
"Contributor" shall mean Licensor and any individual or Legal Entity
|
|
64
|
+
on behalf of whom a Contribution has been received by Licensor and
|
|
65
|
+
subsequently incorporated within the Work.
|
|
66
|
+
|
|
67
|
+
2. Grant of Copyright License. Subject to the terms and conditions of
|
|
68
|
+
this License, each Contributor hereby grants to You a perpetual,
|
|
69
|
+
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
|
70
|
+
copyright license to reproduce, prepare Derivative Works of,
|
|
71
|
+
publicly display, publicly perform, sublicense, and distribute the
|
|
72
|
+
Work and such Derivative Works in Source or Object form.
|
|
73
|
+
|
|
74
|
+
3. Grant of Patent License. Subject to the terms and conditions of
|
|
75
|
+
this License, each Contributor hereby grants to You a perpetual,
|
|
76
|
+
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
|
77
|
+
(except as stated in this section) patent license to make, have made,
|
|
78
|
+
use, offer to sell, sell, import, and otherwise transfer the Work,
|
|
79
|
+
where such license applies only to those patent claims licensable
|
|
80
|
+
by such Contributor that are necessarily infringed by their
|
|
81
|
+
Contribution(s) alone or by combination of their Contribution(s)
|
|
82
|
+
with the Work to which such Contribution(s) was submitted. If You
|
|
83
|
+
institute patent litigation against any entity (including a
|
|
84
|
+
cross-claim or counterclaim in a lawsuit) alleging that the Work
|
|
85
|
+
or a Contribution incorporated within the Work constitutes direct
|
|
86
|
+
or contributory patent infringement, then any patent licenses
|
|
87
|
+
granted to You under this License for that Work shall terminate
|
|
88
|
+
as of the date such litigation is filed.
|
|
89
|
+
|
|
90
|
+
4. Redistribution. You may reproduce and distribute copies of the
|
|
91
|
+
Work or Derivative Works thereof in any medium, with or without
|
|
92
|
+
modifications, and in Source or Object form, provided that You
|
|
93
|
+
meet the following conditions:
|
|
94
|
+
|
|
95
|
+
(a) You must give any other recipients of the Work or
|
|
96
|
+
Derivative Works a copy of this License; and
|
|
97
|
+
|
|
98
|
+
(b) You must cause any modified files to carry prominent notices
|
|
99
|
+
stating that You changed the files; and
|
|
100
|
+
|
|
101
|
+
(c) You must retain, in the Source form of any Derivative Works
|
|
102
|
+
that You distribute, all copyright, patent, trademark, and
|
|
103
|
+
attribution notices from the Source form of the Work,
|
|
104
|
+
excluding those notices that do not pertain to any part of
|
|
105
|
+
the Derivative Works; and
|
|
106
|
+
|
|
107
|
+
(d) If the Work includes a "NOTICE" text file as part of its
|
|
108
|
+
distribution, then any Derivative Works that You distribute must
|
|
109
|
+
include a readable copy of the attribution notices contained
|
|
110
|
+
within such NOTICE file, excluding those notices that do not
|
|
111
|
+
pertain to any part of the Derivative Works, in at least one
|
|
112
|
+
of the following places: within a NOTICE text file distributed
|
|
113
|
+
as part of the Derivative Works; within the Source form or
|
|
114
|
+
documentation, if provided along with the Derivative Works; or,
|
|
115
|
+
within a display generated by the Derivative Works, if and
|
|
116
|
+
wherever such third-party notices normally appear. The contents
|
|
117
|
+
of the NOTICE file are for informational purposes only and
|
|
118
|
+
do not modify the License. You may add Your own attribution
|
|
119
|
+
notices within Derivative Works that You distribute, alongside
|
|
120
|
+
or as an addendum to the NOTICE text from the Work, provided
|
|
121
|
+
that such additional attribution notices cannot be construed
|
|
122
|
+
as modifying the License.
|
|
123
|
+
|
|
124
|
+
You may add Your own copyright statement to Your modifications and
|
|
125
|
+
may provide additional or different license terms and conditions
|
|
126
|
+
for use, reproduction, or distribution of Your modifications, or
|
|
127
|
+
for any such Derivative Works as a whole, provided Your use,
|
|
128
|
+
reproduction, and distribution of the Work otherwise complies with
|
|
129
|
+
the conditions stated in this License.
|
|
130
|
+
|
|
131
|
+
5. Submission of Contributions. Unless You explicitly state otherwise,
|
|
132
|
+
any Contribution intentionally submitted for inclusion in the Work
|
|
133
|
+
by You to the Licensor shall be under the terms and conditions of
|
|
134
|
+
this License, without any additional terms or conditions.
|
|
135
|
+
Notwithstanding the above, nothing herein shall supersede or modify
|
|
136
|
+
the terms of any separate license agreement you may have executed
|
|
137
|
+
with Licensor regarding such Contributions.
|
|
138
|
+
|
|
139
|
+
6. Trademarks. This License does not grant permission to use the trade
|
|
140
|
+
names, trademarks, service marks, or product names of the Licensor,
|
|
141
|
+
except as required for reasonable and customary use in describing the
|
|
142
|
+
origin of the Work and reproducing the content of the NOTICE file.
|
|
143
|
+
|
|
144
|
+
7. Disclaimer of Warranty. Unless required by applicable law or
|
|
145
|
+
agreed to in writing, Licensor provides the Work (and each
|
|
146
|
+
Contributor provides its Contributions) on an "AS IS" BASIS,
|
|
147
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
|
148
|
+
implied, including, without limitation, any warranties or conditions
|
|
149
|
+
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
|
|
150
|
+
PARTICULAR PURPOSE. You are solely responsible for determining the
|
|
151
|
+
appropriateness of using or redistributing the Work and assume any
|
|
152
|
+
risks associated with Your exercise of permissions under this License.
|
|
153
|
+
|
|
154
|
+
8. Limitation of Liability. In no event and under no legal theory,
|
|
155
|
+
whether in tort (including negligence), contract, or otherwise,
|
|
156
|
+
unless required by applicable law (such as deliberate and grossly
|
|
157
|
+
negligent acts) or agreed to in writing, shall any Contributor be
|
|
158
|
+
liable to You for damages, including any direct, indirect, special,
|
|
159
|
+
incidental, or consequential damages of any character arising as a
|
|
160
|
+
result of this License or out of the use or inability to use the
|
|
161
|
+
Work (including but not limited to damages for loss of goodwill,
|
|
162
|
+
work stoppage, computer failure or malfunction, or any and all
|
|
163
|
+
other commercial damages or losses), even if such Contributor
|
|
164
|
+
has been advised of the possibility of such damages.
|
|
165
|
+
|
|
166
|
+
9. Accepting Warranty or Additional Liability. While redistributing
|
|
167
|
+
the Work or Derivative Works thereof, You may choose to offer,
|
|
168
|
+
and charge a fee for, acceptance of support, warranty, indemnity,
|
|
169
|
+
or other liability obligations and/or rights consistent with this
|
|
170
|
+
License. However, in accepting such obligations, You may act only
|
|
171
|
+
on Your own behalf and on Your sole responsibility, not on behalf
|
|
172
|
+
of any other Contributor, and only if You agree to indemnify,
|
|
173
|
+
defend, and hold each Contributor harmless for any liability
|
|
174
|
+
incurred by, or claims asserted against, such Contributor by reason
|
|
175
|
+
of your accepting any such warranty or additional liability.
|
|
176
|
+
|
|
177
|
+
END OF TERMS AND CONDITIONS
|
|
178
|
+
|
|
179
|
+
APPENDIX: How to apply the Apache License to your work.
|
|
180
|
+
|
|
181
|
+
To apply the Apache License to your work, attach the following
|
|
182
|
+
boilerplate notice, with the fields enclosed by brackets "[]"
|
|
183
|
+
replaced with your own identifying information. (Don't include
|
|
184
|
+
the brackets!) The text should be enclosed in the appropriate
|
|
185
|
+
comment syntax for the file format. We also recommend that a
|
|
186
|
+
file or class name and description of purpose be included on the
|
|
187
|
+
same "printed page" as the copyright notice for easier
|
|
188
|
+
identification within third-party archives.
|
|
189
|
+
|
|
190
|
+
Copyright [yyyy] [name of copyright owner]
|
|
191
|
+
|
|
192
|
+
Licensed under the Apache License, Version 2.0 (the "License");
|
|
193
|
+
you may not use this file except in compliance with the License.
|
|
194
|
+
You may obtain a copy of the License at
|
|
195
|
+
|
|
196
|
+
http://www.apache.org/licenses/LICENSE-2.0
|
|
197
|
+
|
|
198
|
+
Unless required by applicable law or agreed to in writing, software
|
|
199
|
+
distributed under the License is distributed on an "AS IS" BASIS,
|
|
200
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
201
|
+
See the License for the specific language governing permissions and
|
|
202
|
+
limitations under the License.
|
data/VERSION
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
1.79.0
|
data/lib/aws-sdk-ecs.rb
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
# WARNING ABOUT GENERATED CODE
|
|
4
4
|
#
|
|
5
5
|
# This file is generated. See the contributing guide for more information:
|
|
6
|
-
# https://github.com/aws/aws-sdk-ruby/blob/
|
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
|
7
7
|
#
|
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
|
9
9
|
|
|
@@ -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.
|
|
52
|
+
GEM_VERSION = '1.79.0'
|
|
53
53
|
|
|
54
54
|
end
|
data/lib/aws-sdk-ecs/client.rb
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
# WARNING ABOUT GENERATED CODE
|
|
4
4
|
#
|
|
5
5
|
# This file is generated. See the contributing guide for more information:
|
|
6
|
-
# https://github.com/aws/aws-sdk-ruby/blob/
|
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
|
7
7
|
#
|
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
|
9
9
|
|
|
@@ -461,7 +461,8 @@ module Aws::ECS
|
|
|
461
461
|
# @option params [String] :cluster_name
|
|
462
462
|
# The name of your cluster. If you do not specify a name for your
|
|
463
463
|
# cluster, you create a cluster named `default`. Up to 255 letters
|
|
464
|
-
# (uppercase and lowercase), numbers, and hyphens are
|
|
464
|
+
# (uppercase and lowercase), numbers, underscores, and hyphens are
|
|
465
|
+
# allowed.
|
|
465
466
|
#
|
|
466
467
|
# @option params [Array<Types::Tag>] :tags
|
|
467
468
|
# The metadata that you apply to the cluster to help you categorize and
|
|
@@ -499,14 +500,20 @@ module Aws::ECS
|
|
|
499
500
|
# specified, it will override the `containerInsights` value set with
|
|
500
501
|
# PutAccountSetting or PutAccountSettingDefault.
|
|
501
502
|
#
|
|
503
|
+
# @option params [Types::ClusterConfiguration] :configuration
|
|
504
|
+
# The execute command configuration for the cluster.
|
|
505
|
+
#
|
|
502
506
|
# @option params [Array<String>] :capacity_providers
|
|
503
507
|
# The short name of one or more capacity providers to associate with the
|
|
504
|
-
# cluster.
|
|
508
|
+
# cluster. A capacity provider must be associated with a cluster before
|
|
509
|
+
# it can be included as part of the default capacity provider strategy
|
|
510
|
+
# of the cluster or used in a capacity provider strategy when calling
|
|
511
|
+
# the CreateService or RunTask actions.
|
|
505
512
|
#
|
|
506
513
|
# If specifying a capacity provider that uses an Auto Scaling group, the
|
|
507
514
|
# capacity provider must already be created and not already associated
|
|
508
|
-
# with another cluster. New capacity providers can be
|
|
509
|
-
# CreateCapacityProvider API operation.
|
|
515
|
+
# with another cluster. New Auto Scaling group capacity providers can be
|
|
516
|
+
# created with the CreateCapacityProvider API operation.
|
|
510
517
|
#
|
|
511
518
|
# To use a AWS Fargate capacity provider, specify either the `FARGATE`
|
|
512
519
|
# or `FARGATE_SPOT` capacity providers. The AWS Fargate capacity
|
|
@@ -518,27 +525,11 @@ module Aws::ECS
|
|
|
518
525
|
# is created.
|
|
519
526
|
#
|
|
520
527
|
# @option params [Array<Types::CapacityProviderStrategyItem>] :default_capacity_provider_strategy
|
|
521
|
-
# The capacity provider strategy to
|
|
522
|
-
#
|
|
523
|
-
#
|
|
524
|
-
#
|
|
525
|
-
#
|
|
526
|
-
#
|
|
527
|
-
# A capacity provider strategy consists of one or more capacity
|
|
528
|
-
# providers along with the `base` and `weight` to assign to them. A
|
|
529
|
-
# capacity provider must be associated with the cluster to be used in a
|
|
530
|
-
# capacity provider strategy. The PutClusterCapacityProviders API is
|
|
531
|
-
# used to associate a capacity provider with a cluster. Only capacity
|
|
532
|
-
# providers with an `ACTIVE` or `UPDATING` status can be used.
|
|
533
|
-
#
|
|
534
|
-
# If specifying a capacity provider that uses an Auto Scaling group, the
|
|
535
|
-
# capacity provider must already be created. New capacity providers can
|
|
536
|
-
# be created with the CreateCapacityProvider API operation.
|
|
537
|
-
#
|
|
538
|
-
# To use a AWS Fargate capacity provider, specify either the `FARGATE`
|
|
539
|
-
# or `FARGATE_SPOT` capacity providers. The AWS Fargate capacity
|
|
540
|
-
# providers are available to all accounts and only need to be associated
|
|
541
|
-
# with a cluster to be used.
|
|
528
|
+
# The capacity provider strategy to set as the default for the cluster.
|
|
529
|
+
# When a default capacity provider strategy is set for a cluster, when
|
|
530
|
+
# calling the RunTask or CreateService APIs wtih no capacity provider
|
|
531
|
+
# strategy or launch type specified, the default capacity provider
|
|
532
|
+
# strategy for the cluster is used.
|
|
542
533
|
#
|
|
543
534
|
# If a default capacity provider strategy is not defined for a cluster
|
|
544
535
|
# during creation, it can be defined later with the
|
|
@@ -586,6 +577,19 @@ module Aws::ECS
|
|
|
586
577
|
# value: "String",
|
|
587
578
|
# },
|
|
588
579
|
# ],
|
|
580
|
+
# configuration: {
|
|
581
|
+
# execute_command_configuration: {
|
|
582
|
+
# kms_key_id: "String",
|
|
583
|
+
# logging: "NONE", # accepts NONE, DEFAULT, OVERRIDE
|
|
584
|
+
# log_configuration: {
|
|
585
|
+
# cloud_watch_log_group_name: "String",
|
|
586
|
+
# cloud_watch_encryption_enabled: false,
|
|
587
|
+
# s3_bucket_name: "String",
|
|
588
|
+
# s3_encryption_enabled: false,
|
|
589
|
+
# s3_key_prefix: "String",
|
|
590
|
+
# },
|
|
591
|
+
# },
|
|
592
|
+
# },
|
|
589
593
|
# capacity_providers: ["String"],
|
|
590
594
|
# default_capacity_provider_strategy: [
|
|
591
595
|
# {
|
|
@@ -600,6 +604,13 @@ module Aws::ECS
|
|
|
600
604
|
#
|
|
601
605
|
# resp.cluster.cluster_arn #=> String
|
|
602
606
|
# resp.cluster.cluster_name #=> String
|
|
607
|
+
# resp.cluster.configuration.execute_command_configuration.kms_key_id #=> String
|
|
608
|
+
# resp.cluster.configuration.execute_command_configuration.logging #=> String, one of "NONE", "DEFAULT", "OVERRIDE"
|
|
609
|
+
# resp.cluster.configuration.execute_command_configuration.log_configuration.cloud_watch_log_group_name #=> String
|
|
610
|
+
# resp.cluster.configuration.execute_command_configuration.log_configuration.cloud_watch_encryption_enabled #=> Boolean
|
|
611
|
+
# resp.cluster.configuration.execute_command_configuration.log_configuration.s3_bucket_name #=> String
|
|
612
|
+
# resp.cluster.configuration.execute_command_configuration.log_configuration.s3_encryption_enabled #=> Boolean
|
|
613
|
+
# resp.cluster.configuration.execute_command_configuration.log_configuration.s3_key_prefix #=> String
|
|
603
614
|
# resp.cluster.status #=> String
|
|
604
615
|
# resp.cluster.registered_container_instances_count #=> Integer
|
|
605
616
|
# resp.cluster.running_tasks_count #=> Integer
|
|
@@ -768,9 +779,9 @@ module Aws::ECS
|
|
|
768
779
|
#
|
|
769
780
|
# @option params [required, String] :service_name
|
|
770
781
|
# The name of your service. Up to 255 letters (uppercase and lowercase),
|
|
771
|
-
# numbers, and hyphens are allowed. Service names must be
|
|
772
|
-
# a cluster, but you can have similarly named services in
|
|
773
|
-
# clusters within a Region or across multiple Regions.
|
|
782
|
+
# numbers, underscores, and hyphens are allowed. Service names must be
|
|
783
|
+
# unique within a cluster, but you can have similarly named services in
|
|
784
|
+
# multiple clusters within a Region or across multiple Regions.
|
|
774
785
|
#
|
|
775
786
|
# @option params [String] :task_definition
|
|
776
787
|
# The `family` and `revision` (`family:revision`) or full ARN of the
|
|
@@ -790,7 +801,7 @@ module Aws::ECS
|
|
|
790
801
|
# Load Balancer, you must specify one or more target group ARNs to
|
|
791
802
|
# attach to the service. The service-linked role is required for
|
|
792
803
|
# services that make use of multiple target groups. For more
|
|
793
|
-
# information, see [Using
|
|
804
|
+
# information, see [Using service-linked roles for Amazon ECS][2] in the
|
|
794
805
|
# *Amazon Elastic Container Service Developer Guide*.
|
|
795
806
|
#
|
|
796
807
|
# If the service is using the `CODE_DEPLOY` deployment controller, the
|
|
@@ -840,19 +851,17 @@ module Aws::ECS
|
|
|
840
851
|
# [2]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using-service-linked-roles.html
|
|
841
852
|
#
|
|
842
853
|
# @option params [Array<Types::ServiceRegistry>] :service_registries
|
|
843
|
-
# The details of the service discovery
|
|
844
|
-
# service. For more information, see [Service
|
|
854
|
+
# The details of the service discovery registry to associate with this
|
|
855
|
+
# service. For more information, see [Service discovery][1].
|
|
845
856
|
#
|
|
846
|
-
# <note markdown="1">
|
|
847
|
-
#
|
|
848
|
-
# Fargate Platform Versions][2].
|
|
857
|
+
# <note markdown="1"> Each service may be associated with one service registry. Multiple
|
|
858
|
+
# service registries per service isn't supported.
|
|
849
859
|
#
|
|
850
860
|
# </note>
|
|
851
861
|
#
|
|
852
862
|
#
|
|
853
863
|
#
|
|
854
864
|
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-discovery.html
|
|
855
|
-
# [2]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/platform_versions.html
|
|
856
865
|
#
|
|
857
866
|
# @option params [Integer] :desired_count
|
|
858
867
|
# The number of instantiations of the specified task definition to place
|
|
@@ -867,51 +876,48 @@ module Aws::ECS
|
|
|
867
876
|
# idempotency of the request. Up to 32 ASCII characters are allowed.
|
|
868
877
|
#
|
|
869
878
|
# @option params [String] :launch_type
|
|
870
|
-
# The
|
|
871
|
-
# see [Amazon ECS
|
|
879
|
+
# The infrastructure on which to run your service. For more information,
|
|
880
|
+
# see [Amazon ECS launch types][1] in the *Amazon Elastic Container
|
|
872
881
|
# Service Developer Guide*.
|
|
873
882
|
#
|
|
874
|
-
#
|
|
875
|
-
#
|
|
883
|
+
# The `FARGATE` launch type runs your tasks on AWS Fargate On-Demand
|
|
884
|
+
# infrastructure.
|
|
885
|
+
#
|
|
886
|
+
# <note markdown="1"> Fargate Spot infrastructure is available for use but a capacity
|
|
887
|
+
# provider strategy must be used. For more information, see [AWS Fargate
|
|
888
|
+
# capacity providers][2] in the *Amazon ECS User Guide for AWS Fargate*.
|
|
889
|
+
#
|
|
890
|
+
# </note>
|
|
891
|
+
#
|
|
892
|
+
# The `EC2` launch type runs your tasks on Amazon EC2 instances
|
|
893
|
+
# registered to your cluster.
|
|
894
|
+
#
|
|
895
|
+
# The `EXTERNAL` launch type runs your tasks on your on-premise server
|
|
896
|
+
# or virtual machine (VM) capacity registered to your cluster.
|
|
897
|
+
#
|
|
898
|
+
# A service can use either a launch type or a capacity provider
|
|
899
|
+
# strategy. If a `launchType` is specified, the
|
|
900
|
+
# `capacityProviderStrategy` parameter must be omitted.
|
|
876
901
|
#
|
|
877
902
|
#
|
|
878
903
|
#
|
|
879
904
|
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_types.html
|
|
905
|
+
# [2]: https://docs.aws.amazon.com/AmazonECS/latest/userguide/fargate-capacity-providers.html
|
|
880
906
|
#
|
|
881
907
|
# @option params [Array<Types::CapacityProviderStrategyItem>] :capacity_provider_strategy
|
|
882
908
|
# The capacity provider strategy to use for the service.
|
|
883
909
|
#
|
|
884
|
-
# A capacity provider strategy consists of one or more capacity
|
|
885
|
-
# providers along with the `base` and `weight` to assign to them. A
|
|
886
|
-
# capacity provider must be associated with the cluster to be used in a
|
|
887
|
-
# capacity provider strategy. The PutClusterCapacityProviders API is
|
|
888
|
-
# used to associate a capacity provider with a cluster. Only capacity
|
|
889
|
-
# providers with an `ACTIVE` or `UPDATING` status can be used.
|
|
890
|
-
#
|
|
891
910
|
# If a `capacityProviderStrategy` is specified, the `launchType`
|
|
892
911
|
# parameter must be omitted. If no `capacityProviderStrategy` or
|
|
893
912
|
# `launchType` is specified, the `defaultCapacityProviderStrategy` for
|
|
894
913
|
# the cluster is used.
|
|
895
914
|
#
|
|
896
|
-
# If specifying a capacity provider that uses an Auto Scaling group, the
|
|
897
|
-
# capacity provider must already be created. New capacity providers can
|
|
898
|
-
# be created with the CreateCapacityProvider API operation.
|
|
899
|
-
#
|
|
900
|
-
# To use a AWS Fargate capacity provider, specify either the `FARGATE`
|
|
901
|
-
# or `FARGATE_SPOT` capacity providers. The AWS Fargate capacity
|
|
902
|
-
# providers are available to all accounts and only need to be associated
|
|
903
|
-
# with a cluster to be used.
|
|
904
|
-
#
|
|
905
|
-
# The PutClusterCapacityProviders API operation is used to update the
|
|
906
|
-
# list of available capacity providers for a cluster after the cluster
|
|
907
|
-
# is created.
|
|
908
|
-
#
|
|
909
915
|
# @option params [String] :platform_version
|
|
910
916
|
# The platform version that your tasks in the service are running on. A
|
|
911
917
|
# platform version is specified only for tasks using the Fargate launch
|
|
912
918
|
# type. If one isn't specified, the `LATEST` platform version is used
|
|
913
|
-
# by default. For more information, see [AWS Fargate
|
|
914
|
-
#
|
|
919
|
+
# by default. For more information, see [AWS Fargate platform
|
|
920
|
+
# versions][1] in the *Amazon Elastic Container Service Developer
|
|
915
921
|
# Guide*.
|
|
916
922
|
#
|
|
917
923
|
#
|
|
@@ -933,14 +939,14 @@ module Aws::ECS
|
|
|
933
939
|
# configured to use service discovery, an external deployment
|
|
934
940
|
# controller, multiple target groups, or Elastic Inference accelerators
|
|
935
941
|
# in which case you should not specify a role here. For more
|
|
936
|
-
# information, see [Using
|
|
942
|
+
# information, see [Using service-linked roles for Amazon ECS][1] in the
|
|
937
943
|
# *Amazon Elastic Container Service Developer Guide*.
|
|
938
944
|
#
|
|
939
945
|
# If your specified role has a path other than `/`, then you must either
|
|
940
946
|
# specify the full role ARN (this is recommended) or prefix the role
|
|
941
947
|
# name with the path. For example, if a role with the name `bar` has a
|
|
942
948
|
# path of `/foo/` then you would specify `/foo/bar` as the role name.
|
|
943
|
-
# For more information, see [Friendly
|
|
949
|
+
# For more information, see [Friendly names and paths][2] in the *IAM
|
|
944
950
|
# User Guide*.
|
|
945
951
|
#
|
|
946
952
|
#
|
|
@@ -966,7 +972,7 @@ module Aws::ECS
|
|
|
966
972
|
# The network configuration for the service. This parameter is required
|
|
967
973
|
# for task definitions that use the `awsvpc` network mode to receive
|
|
968
974
|
# their own elastic network interface, and it is not supported for other
|
|
969
|
-
# network modes. For more information, see [Task
|
|
975
|
+
# network modes. For more information, see [Task networking][1] in the
|
|
970
976
|
# *Amazon Elastic Container Service Developer Guide*.
|
|
971
977
|
#
|
|
972
978
|
#
|
|
@@ -1021,7 +1027,8 @@ module Aws::ECS
|
|
|
1021
1027
|
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs_services.html
|
|
1022
1028
|
#
|
|
1023
1029
|
# @option params [Types::DeploymentController] :deployment_controller
|
|
1024
|
-
# The deployment controller to use for the service.
|
|
1030
|
+
# The deployment controller to use for the service. If no deployment
|
|
1031
|
+
# controller is specified, the default value of `ECS` is used.
|
|
1025
1032
|
#
|
|
1026
1033
|
# @option params [Array<Types::Tag>] :tags
|
|
1027
1034
|
# The metadata that you apply to the service to help you categorize and
|
|
@@ -1071,6 +1078,11 @@ module Aws::ECS
|
|
|
1071
1078
|
# within the service during service creation. To add tags to a task
|
|
1072
1079
|
# after service creation, use the TagResource API action.
|
|
1073
1080
|
#
|
|
1081
|
+
# @option params [Boolean] :enable_execute_command
|
|
1082
|
+
# Whether or not the execute command functionality is enabled for the
|
|
1083
|
+
# service. If `true`, this enables execute command functionality on all
|
|
1084
|
+
# containers in the service tasks.
|
|
1085
|
+
#
|
|
1074
1086
|
# @return [Types::CreateServiceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
1075
1087
|
#
|
|
1076
1088
|
# * {Types::CreateServiceResponse#service #service} => Types::Service
|
|
@@ -1217,7 +1229,7 @@ module Aws::ECS
|
|
|
1217
1229
|
# ],
|
|
1218
1230
|
# desired_count: 1,
|
|
1219
1231
|
# client_token: "String",
|
|
1220
|
-
# launch_type: "EC2", # accepts EC2, FARGATE
|
|
1232
|
+
# launch_type: "EC2", # accepts EC2, FARGATE, EXTERNAL
|
|
1221
1233
|
# capacity_provider_strategy: [
|
|
1222
1234
|
# {
|
|
1223
1235
|
# capacity_provider: "String", # required
|
|
@@ -1267,6 +1279,7 @@ module Aws::ECS
|
|
|
1267
1279
|
# ],
|
|
1268
1280
|
# enable_ecs_managed_tags: false,
|
|
1269
1281
|
# propagate_tags: "TASK_DEFINITION", # accepts TASK_DEFINITION, SERVICE
|
|
1282
|
+
# enable_execute_command: false,
|
|
1270
1283
|
# })
|
|
1271
1284
|
#
|
|
1272
1285
|
# @example Response structure
|
|
@@ -1288,7 +1301,7 @@ module Aws::ECS
|
|
|
1288
1301
|
# resp.service.desired_count #=> Integer
|
|
1289
1302
|
# resp.service.running_count #=> Integer
|
|
1290
1303
|
# resp.service.pending_count #=> Integer
|
|
1291
|
-
# resp.service.launch_type #=> String, one of "EC2", "FARGATE"
|
|
1304
|
+
# resp.service.launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
|
|
1292
1305
|
# resp.service.capacity_provider_strategy #=> Array
|
|
1293
1306
|
# resp.service.capacity_provider_strategy[0].capacity_provider #=> String
|
|
1294
1307
|
# resp.service.capacity_provider_strategy[0].weight #=> Integer
|
|
@@ -1313,7 +1326,7 @@ module Aws::ECS
|
|
|
1313
1326
|
# resp.service.task_sets[0].running_count #=> Integer
|
|
1314
1327
|
# resp.service.task_sets[0].created_at #=> Time
|
|
1315
1328
|
# resp.service.task_sets[0].updated_at #=> Time
|
|
1316
|
-
# 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"
|
|
1317
1330
|
# resp.service.task_sets[0].capacity_provider_strategy #=> Array
|
|
1318
1331
|
# resp.service.task_sets[0].capacity_provider_strategy[0].capacity_provider #=> String
|
|
1319
1332
|
# resp.service.task_sets[0].capacity_provider_strategy[0].weight #=> Integer
|
|
@@ -1355,7 +1368,7 @@ module Aws::ECS
|
|
|
1355
1368
|
# resp.service.deployments[0].capacity_provider_strategy[0].capacity_provider #=> String
|
|
1356
1369
|
# resp.service.deployments[0].capacity_provider_strategy[0].weight #=> Integer
|
|
1357
1370
|
# resp.service.deployments[0].capacity_provider_strategy[0].base #=> Integer
|
|
1358
|
-
# resp.service.deployments[0].launch_type #=> String, one of "EC2", "FARGATE"
|
|
1371
|
+
# resp.service.deployments[0].launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
|
|
1359
1372
|
# resp.service.deployments[0].platform_version #=> String
|
|
1360
1373
|
# resp.service.deployments[0].network_configuration.awsvpc_configuration.subnets #=> Array
|
|
1361
1374
|
# resp.service.deployments[0].network_configuration.awsvpc_configuration.subnets[0] #=> String
|
|
@@ -1390,6 +1403,7 @@ module Aws::ECS
|
|
|
1390
1403
|
# resp.service.created_by #=> String
|
|
1391
1404
|
# resp.service.enable_ecs_managed_tags #=> Boolean
|
|
1392
1405
|
# resp.service.propagate_tags #=> String, one of "TASK_DEFINITION", "SERVICE"
|
|
1406
|
+
# resp.service.enable_execute_command #=> Boolean
|
|
1393
1407
|
#
|
|
1394
1408
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/CreateService AWS API Documentation
|
|
1395
1409
|
#
|
|
@@ -1428,8 +1442,7 @@ module Aws::ECS
|
|
|
1428
1442
|
# The task definition for the tasks in the task set to use.
|
|
1429
1443
|
#
|
|
1430
1444
|
# @option params [Types::NetworkConfiguration] :network_configuration
|
|
1431
|
-
# An object representing the network configuration for a task
|
|
1432
|
-
# service.
|
|
1445
|
+
# An object representing the network configuration for a task set.
|
|
1433
1446
|
#
|
|
1434
1447
|
# @option params [Array<Types::LoadBalancer>] :load_balancers
|
|
1435
1448
|
# A load balancer object representing the load balancer to use with the
|
|
@@ -1563,7 +1576,7 @@ module Aws::ECS
|
|
|
1563
1576
|
# container_port: 1,
|
|
1564
1577
|
# },
|
|
1565
1578
|
# ],
|
|
1566
|
-
# launch_type: "EC2", # accepts EC2, FARGATE
|
|
1579
|
+
# launch_type: "EC2", # accepts EC2, FARGATE, EXTERNAL
|
|
1567
1580
|
# capacity_provider_strategy: [
|
|
1568
1581
|
# {
|
|
1569
1582
|
# capacity_provider: "String", # required
|
|
@@ -1600,7 +1613,7 @@ module Aws::ECS
|
|
|
1600
1613
|
# resp.task_set.running_count #=> Integer
|
|
1601
1614
|
# resp.task_set.created_at #=> Time
|
|
1602
1615
|
# resp.task_set.updated_at #=> Time
|
|
1603
|
-
# resp.task_set.launch_type #=> String, one of "EC2", "FARGATE"
|
|
1616
|
+
# resp.task_set.launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
|
|
1604
1617
|
# resp.task_set.capacity_provider_strategy #=> Array
|
|
1605
1618
|
# resp.task_set.capacity_provider_strategy[0].capacity_provider #=> String
|
|
1606
1619
|
# resp.task_set.capacity_provider_strategy[0].weight #=> Integer
|
|
@@ -1881,6 +1894,13 @@ module Aws::ECS
|
|
|
1881
1894
|
#
|
|
1882
1895
|
# resp.cluster.cluster_arn #=> String
|
|
1883
1896
|
# resp.cluster.cluster_name #=> String
|
|
1897
|
+
# resp.cluster.configuration.execute_command_configuration.kms_key_id #=> String
|
|
1898
|
+
# resp.cluster.configuration.execute_command_configuration.logging #=> String, one of "NONE", "DEFAULT", "OVERRIDE"
|
|
1899
|
+
# resp.cluster.configuration.execute_command_configuration.log_configuration.cloud_watch_log_group_name #=> String
|
|
1900
|
+
# resp.cluster.configuration.execute_command_configuration.log_configuration.cloud_watch_encryption_enabled #=> Boolean
|
|
1901
|
+
# resp.cluster.configuration.execute_command_configuration.log_configuration.s3_bucket_name #=> String
|
|
1902
|
+
# resp.cluster.configuration.execute_command_configuration.log_configuration.s3_encryption_enabled #=> Boolean
|
|
1903
|
+
# resp.cluster.configuration.execute_command_configuration.log_configuration.s3_key_prefix #=> String
|
|
1884
1904
|
# resp.cluster.status #=> String
|
|
1885
1905
|
# resp.cluster.registered_container_instances_count #=> Integer
|
|
1886
1906
|
# resp.cluster.running_tasks_count #=> Integer
|
|
@@ -2000,7 +2020,7 @@ module Aws::ECS
|
|
|
2000
2020
|
# resp.service.desired_count #=> Integer
|
|
2001
2021
|
# resp.service.running_count #=> Integer
|
|
2002
2022
|
# resp.service.pending_count #=> Integer
|
|
2003
|
-
# resp.service.launch_type #=> String, one of "EC2", "FARGATE"
|
|
2023
|
+
# resp.service.launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
|
|
2004
2024
|
# resp.service.capacity_provider_strategy #=> Array
|
|
2005
2025
|
# resp.service.capacity_provider_strategy[0].capacity_provider #=> String
|
|
2006
2026
|
# resp.service.capacity_provider_strategy[0].weight #=> Integer
|
|
@@ -2025,7 +2045,7 @@ module Aws::ECS
|
|
|
2025
2045
|
# resp.service.task_sets[0].running_count #=> Integer
|
|
2026
2046
|
# resp.service.task_sets[0].created_at #=> Time
|
|
2027
2047
|
# resp.service.task_sets[0].updated_at #=> Time
|
|
2028
|
-
# 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"
|
|
2029
2049
|
# resp.service.task_sets[0].capacity_provider_strategy #=> Array
|
|
2030
2050
|
# resp.service.task_sets[0].capacity_provider_strategy[0].capacity_provider #=> String
|
|
2031
2051
|
# resp.service.task_sets[0].capacity_provider_strategy[0].weight #=> Integer
|
|
@@ -2067,7 +2087,7 @@ module Aws::ECS
|
|
|
2067
2087
|
# resp.service.deployments[0].capacity_provider_strategy[0].capacity_provider #=> String
|
|
2068
2088
|
# resp.service.deployments[0].capacity_provider_strategy[0].weight #=> Integer
|
|
2069
2089
|
# resp.service.deployments[0].capacity_provider_strategy[0].base #=> Integer
|
|
2070
|
-
# resp.service.deployments[0].launch_type #=> String, one of "EC2", "FARGATE"
|
|
2090
|
+
# resp.service.deployments[0].launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
|
|
2071
2091
|
# resp.service.deployments[0].platform_version #=> String
|
|
2072
2092
|
# resp.service.deployments[0].network_configuration.awsvpc_configuration.subnets #=> Array
|
|
2073
2093
|
# resp.service.deployments[0].network_configuration.awsvpc_configuration.subnets[0] #=> String
|
|
@@ -2102,6 +2122,7 @@ module Aws::ECS
|
|
|
2102
2122
|
# resp.service.created_by #=> String
|
|
2103
2123
|
# resp.service.enable_ecs_managed_tags #=> Boolean
|
|
2104
2124
|
# resp.service.propagate_tags #=> String, one of "TASK_DEFINITION", "SERVICE"
|
|
2125
|
+
# resp.service.enable_execute_command #=> Boolean
|
|
2105
2126
|
#
|
|
2106
2127
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DeleteService AWS API Documentation
|
|
2107
2128
|
#
|
|
@@ -2165,7 +2186,7 @@ module Aws::ECS
|
|
|
2165
2186
|
# resp.task_set.running_count #=> Integer
|
|
2166
2187
|
# resp.task_set.created_at #=> Time
|
|
2167
2188
|
# resp.task_set.updated_at #=> Time
|
|
2168
|
-
# resp.task_set.launch_type #=> String, one of "EC2", "FARGATE"
|
|
2189
|
+
# resp.task_set.launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
|
|
2169
2190
|
# resp.task_set.capacity_provider_strategy #=> Array
|
|
2170
2191
|
# resp.task_set.capacity_provider_strategy[0].capacity_provider #=> String
|
|
2171
2192
|
# resp.task_set.capacity_provider_strategy[0].weight #=> Integer
|
|
@@ -2510,9 +2531,9 @@ module Aws::ECS
|
|
|
2510
2531
|
# resp.task_definition.placement_constraints[0].type #=> String, one of "memberOf"
|
|
2511
2532
|
# resp.task_definition.placement_constraints[0].expression #=> String
|
|
2512
2533
|
# resp.task_definition.compatibilities #=> Array
|
|
2513
|
-
# resp.task_definition.compatibilities[0] #=> String, one of "EC2", "FARGATE"
|
|
2534
|
+
# resp.task_definition.compatibilities[0] #=> String, one of "EC2", "FARGATE", "EXTERNAL"
|
|
2514
2535
|
# resp.task_definition.requires_compatibilities #=> Array
|
|
2515
|
-
# resp.task_definition.requires_compatibilities[0] #=> String, one of "EC2", "FARGATE"
|
|
2536
|
+
# resp.task_definition.requires_compatibilities[0] #=> String, one of "EC2", "FARGATE", "EXTERNAL"
|
|
2516
2537
|
# resp.task_definition.cpu #=> String
|
|
2517
2538
|
# resp.task_definition.memory #=> String
|
|
2518
2539
|
# resp.task_definition.inference_accelerators #=> Array
|
|
@@ -2528,6 +2549,7 @@ module Aws::ECS
|
|
|
2528
2549
|
# resp.task_definition.registered_at #=> Time
|
|
2529
2550
|
# resp.task_definition.deregistered_at #=> Time
|
|
2530
2551
|
# resp.task_definition.registered_by #=> String
|
|
2552
|
+
# resp.task_definition.ephemeral_storage.size_in_gi_b #=> Integer
|
|
2531
2553
|
#
|
|
2532
2554
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DeregisterTaskDefinition AWS API Documentation
|
|
2533
2555
|
#
|
|
@@ -2695,7 +2717,7 @@ module Aws::ECS
|
|
|
2695
2717
|
#
|
|
2696
2718
|
# resp = client.describe_clusters({
|
|
2697
2719
|
# clusters: ["String"],
|
|
2698
|
-
# include: ["ATTACHMENTS"], # accepts ATTACHMENTS, SETTINGS, STATISTICS, TAGS
|
|
2720
|
+
# include: ["ATTACHMENTS"], # accepts ATTACHMENTS, CONFIGURATIONS, SETTINGS, STATISTICS, TAGS
|
|
2699
2721
|
# })
|
|
2700
2722
|
#
|
|
2701
2723
|
# @example Response structure
|
|
@@ -2703,6 +2725,13 @@ module Aws::ECS
|
|
|
2703
2725
|
# resp.clusters #=> Array
|
|
2704
2726
|
# resp.clusters[0].cluster_arn #=> String
|
|
2705
2727
|
# resp.clusters[0].cluster_name #=> String
|
|
2728
|
+
# resp.clusters[0].configuration.execute_command_configuration.kms_key_id #=> String
|
|
2729
|
+
# resp.clusters[0].configuration.execute_command_configuration.logging #=> String, one of "NONE", "DEFAULT", "OVERRIDE"
|
|
2730
|
+
# resp.clusters[0].configuration.execute_command_configuration.log_configuration.cloud_watch_log_group_name #=> String
|
|
2731
|
+
# resp.clusters[0].configuration.execute_command_configuration.log_configuration.cloud_watch_encryption_enabled #=> Boolean
|
|
2732
|
+
# resp.clusters[0].configuration.execute_command_configuration.log_configuration.s3_bucket_name #=> String
|
|
2733
|
+
# resp.clusters[0].configuration.execute_command_configuration.log_configuration.s3_encryption_enabled #=> Boolean
|
|
2734
|
+
# resp.clusters[0].configuration.execute_command_configuration.log_configuration.s3_key_prefix #=> String
|
|
2706
2735
|
# resp.clusters[0].status #=> String
|
|
2707
2736
|
# resp.clusters[0].registered_container_instances_count #=> Integer
|
|
2708
2737
|
# resp.clusters[0].running_tasks_count #=> Integer
|
|
@@ -3035,7 +3064,7 @@ module Aws::ECS
|
|
|
3035
3064
|
# resp.services[0].desired_count #=> Integer
|
|
3036
3065
|
# resp.services[0].running_count #=> Integer
|
|
3037
3066
|
# resp.services[0].pending_count #=> Integer
|
|
3038
|
-
# resp.services[0].launch_type #=> String, one of "EC2", "FARGATE"
|
|
3067
|
+
# resp.services[0].launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
|
|
3039
3068
|
# resp.services[0].capacity_provider_strategy #=> Array
|
|
3040
3069
|
# resp.services[0].capacity_provider_strategy[0].capacity_provider #=> String
|
|
3041
3070
|
# resp.services[0].capacity_provider_strategy[0].weight #=> Integer
|
|
@@ -3060,7 +3089,7 @@ module Aws::ECS
|
|
|
3060
3089
|
# resp.services[0].task_sets[0].running_count #=> Integer
|
|
3061
3090
|
# resp.services[0].task_sets[0].created_at #=> Time
|
|
3062
3091
|
# resp.services[0].task_sets[0].updated_at #=> Time
|
|
3063
|
-
# resp.services[0].task_sets[0].launch_type #=> String, one of "EC2", "FARGATE"
|
|
3092
|
+
# resp.services[0].task_sets[0].launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
|
|
3064
3093
|
# resp.services[0].task_sets[0].capacity_provider_strategy #=> Array
|
|
3065
3094
|
# resp.services[0].task_sets[0].capacity_provider_strategy[0].capacity_provider #=> String
|
|
3066
3095
|
# resp.services[0].task_sets[0].capacity_provider_strategy[0].weight #=> Integer
|
|
@@ -3102,7 +3131,7 @@ module Aws::ECS
|
|
|
3102
3131
|
# resp.services[0].deployments[0].capacity_provider_strategy[0].capacity_provider #=> String
|
|
3103
3132
|
# resp.services[0].deployments[0].capacity_provider_strategy[0].weight #=> Integer
|
|
3104
3133
|
# resp.services[0].deployments[0].capacity_provider_strategy[0].base #=> Integer
|
|
3105
|
-
# resp.services[0].deployments[0].launch_type #=> String, one of "EC2", "FARGATE"
|
|
3134
|
+
# resp.services[0].deployments[0].launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
|
|
3106
3135
|
# resp.services[0].deployments[0].platform_version #=> String
|
|
3107
3136
|
# resp.services[0].deployments[0].network_configuration.awsvpc_configuration.subnets #=> Array
|
|
3108
3137
|
# resp.services[0].deployments[0].network_configuration.awsvpc_configuration.subnets[0] #=> String
|
|
@@ -3137,6 +3166,7 @@ module Aws::ECS
|
|
|
3137
3166
|
# resp.services[0].created_by #=> String
|
|
3138
3167
|
# resp.services[0].enable_ecs_managed_tags #=> Boolean
|
|
3139
3168
|
# resp.services[0].propagate_tags #=> String, one of "TASK_DEFINITION", "SERVICE"
|
|
3169
|
+
# resp.services[0].enable_execute_command #=> Boolean
|
|
3140
3170
|
# resp.failures #=> Array
|
|
3141
3171
|
# resp.failures[0].arn #=> String
|
|
3142
3172
|
# resp.failures[0].reason #=> String
|
|
@@ -3391,9 +3421,9 @@ module Aws::ECS
|
|
|
3391
3421
|
# resp.task_definition.placement_constraints[0].type #=> String, one of "memberOf"
|
|
3392
3422
|
# resp.task_definition.placement_constraints[0].expression #=> String
|
|
3393
3423
|
# resp.task_definition.compatibilities #=> Array
|
|
3394
|
-
# resp.task_definition.compatibilities[0] #=> String, one of "EC2", "FARGATE"
|
|
3424
|
+
# resp.task_definition.compatibilities[0] #=> String, one of "EC2", "FARGATE", "EXTERNAL"
|
|
3395
3425
|
# resp.task_definition.requires_compatibilities #=> Array
|
|
3396
|
-
# resp.task_definition.requires_compatibilities[0] #=> String, one of "EC2", "FARGATE"
|
|
3426
|
+
# resp.task_definition.requires_compatibilities[0] #=> String, one of "EC2", "FARGATE", "EXTERNAL"
|
|
3397
3427
|
# resp.task_definition.cpu #=> String
|
|
3398
3428
|
# resp.task_definition.memory #=> String
|
|
3399
3429
|
# resp.task_definition.inference_accelerators #=> Array
|
|
@@ -3409,6 +3439,7 @@ module Aws::ECS
|
|
|
3409
3439
|
# resp.task_definition.registered_at #=> Time
|
|
3410
3440
|
# resp.task_definition.deregistered_at #=> Time
|
|
3411
3441
|
# resp.task_definition.registered_by #=> String
|
|
3442
|
+
# resp.task_definition.ephemeral_storage.size_in_gi_b #=> Integer
|
|
3412
3443
|
# resp.tags #=> Array
|
|
3413
3444
|
# resp.tags[0].key #=> String
|
|
3414
3445
|
# resp.tags[0].value #=> String
|
|
@@ -3477,7 +3508,7 @@ module Aws::ECS
|
|
|
3477
3508
|
# resp.task_sets[0].running_count #=> Integer
|
|
3478
3509
|
# resp.task_sets[0].created_at #=> Time
|
|
3479
3510
|
# resp.task_sets[0].updated_at #=> Time
|
|
3480
|
-
# resp.task_sets[0].launch_type #=> String, one of "EC2", "FARGATE"
|
|
3511
|
+
# resp.task_sets[0].launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
|
|
3481
3512
|
# resp.task_sets[0].capacity_provider_strategy #=> Array
|
|
3482
3513
|
# resp.task_sets[0].capacity_provider_strategy[0].capacity_provider #=> String
|
|
3483
3514
|
# resp.task_sets[0].capacity_provider_strategy[0].weight #=> Integer
|
|
@@ -3640,6 +3671,11 @@ module Aws::ECS
|
|
|
3640
3671
|
# resp.tasks[0].containers[0].network_interfaces[0].private_ipv_4_address #=> String
|
|
3641
3672
|
# resp.tasks[0].containers[0].network_interfaces[0].ipv6_address #=> String
|
|
3642
3673
|
# resp.tasks[0].containers[0].health_status #=> String, one of "HEALTHY", "UNHEALTHY", "UNKNOWN"
|
|
3674
|
+
# resp.tasks[0].containers[0].managed_agents #=> Array
|
|
3675
|
+
# resp.tasks[0].containers[0].managed_agents[0].last_started_at #=> Time
|
|
3676
|
+
# resp.tasks[0].containers[0].managed_agents[0].name #=> String, one of "ExecuteCommandAgent"
|
|
3677
|
+
# resp.tasks[0].containers[0].managed_agents[0].reason #=> String
|
|
3678
|
+
# resp.tasks[0].containers[0].managed_agents[0].last_status #=> String
|
|
3643
3679
|
# resp.tasks[0].containers[0].cpu #=> String
|
|
3644
3680
|
# resp.tasks[0].containers[0].memory #=> String
|
|
3645
3681
|
# resp.tasks[0].containers[0].memory_reservation #=> String
|
|
@@ -3648,6 +3684,7 @@ module Aws::ECS
|
|
|
3648
3684
|
# resp.tasks[0].cpu #=> String
|
|
3649
3685
|
# resp.tasks[0].created_at #=> Time
|
|
3650
3686
|
# resp.tasks[0].desired_status #=> String
|
|
3687
|
+
# resp.tasks[0].enable_execute_command #=> Boolean
|
|
3651
3688
|
# resp.tasks[0].execution_stopped_at #=> Time
|
|
3652
3689
|
# resp.tasks[0].group #=> String
|
|
3653
3690
|
# resp.tasks[0].health_status #=> String, one of "HEALTHY", "UNHEALTHY", "UNKNOWN"
|
|
@@ -3655,7 +3692,7 @@ module Aws::ECS
|
|
|
3655
3692
|
# resp.tasks[0].inference_accelerators[0].device_name #=> String
|
|
3656
3693
|
# resp.tasks[0].inference_accelerators[0].device_type #=> String
|
|
3657
3694
|
# resp.tasks[0].last_status #=> String
|
|
3658
|
-
# resp.tasks[0].launch_type #=> String, one of "EC2", "FARGATE"
|
|
3695
|
+
# resp.tasks[0].launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
|
|
3659
3696
|
# resp.tasks[0].memory #=> String
|
|
3660
3697
|
# resp.tasks[0].overrides.container_overrides #=> Array
|
|
3661
3698
|
# resp.tasks[0].overrides.container_overrides[0].name #=> String
|
|
@@ -3680,6 +3717,7 @@ module Aws::ECS
|
|
|
3680
3717
|
# resp.tasks[0].overrides.execution_role_arn #=> String
|
|
3681
3718
|
# resp.tasks[0].overrides.memory #=> String
|
|
3682
3719
|
# resp.tasks[0].overrides.task_role_arn #=> String
|
|
3720
|
+
# resp.tasks[0].overrides.ephemeral_storage.size_in_gi_b #=> Integer
|
|
3683
3721
|
# resp.tasks[0].platform_version #=> String
|
|
3684
3722
|
# resp.tasks[0].pull_started_at #=> Time
|
|
3685
3723
|
# resp.tasks[0].pull_stopped_at #=> Time
|
|
@@ -3695,6 +3733,7 @@ module Aws::ECS
|
|
|
3695
3733
|
# resp.tasks[0].task_arn #=> String
|
|
3696
3734
|
# resp.tasks[0].task_definition_arn #=> String
|
|
3697
3735
|
# resp.tasks[0].version #=> Integer
|
|
3736
|
+
# resp.tasks[0].ephemeral_storage.size_in_gi_b #=> Integer
|
|
3698
3737
|
# resp.failures #=> Array
|
|
3699
3738
|
# resp.failures[0].arn #=> String
|
|
3700
3739
|
# resp.failures[0].reason #=> String
|
|
@@ -3760,6 +3799,66 @@ module Aws::ECS
|
|
|
3760
3799
|
req.send_request(options)
|
|
3761
3800
|
end
|
|
3762
3801
|
|
|
3802
|
+
# Runs a command remotely on a container within a task.
|
|
3803
|
+
#
|
|
3804
|
+
# @option params [String] :cluster
|
|
3805
|
+
# The Amazon Resource Name (ARN) or short name of the cluster the task
|
|
3806
|
+
# is running in. If you do not specify a cluster, the default cluster is
|
|
3807
|
+
# assumed.
|
|
3808
|
+
#
|
|
3809
|
+
# @option params [String] :container
|
|
3810
|
+
# The name of the container to execute the command on. A container name
|
|
3811
|
+
# only needs to be specified for tasks containing multiple containers.
|
|
3812
|
+
#
|
|
3813
|
+
# @option params [required, String] :command
|
|
3814
|
+
# The command to run on the container.
|
|
3815
|
+
#
|
|
3816
|
+
# @option params [required, Boolean] :interactive
|
|
3817
|
+
# Use this flag to run your command in interactive mode.
|
|
3818
|
+
#
|
|
3819
|
+
# @option params [required, String] :task
|
|
3820
|
+
# The Amazon Resource Name (ARN) or ID of the task the container is part
|
|
3821
|
+
# of.
|
|
3822
|
+
#
|
|
3823
|
+
# @return [Types::ExecuteCommandResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
3824
|
+
#
|
|
3825
|
+
# * {Types::ExecuteCommandResponse#cluster_arn #cluster_arn} => String
|
|
3826
|
+
# * {Types::ExecuteCommandResponse#container_arn #container_arn} => String
|
|
3827
|
+
# * {Types::ExecuteCommandResponse#container_name #container_name} => String
|
|
3828
|
+
# * {Types::ExecuteCommandResponse#interactive #interactive} => Boolean
|
|
3829
|
+
# * {Types::ExecuteCommandResponse#session #session} => Types::Session
|
|
3830
|
+
# * {Types::ExecuteCommandResponse#task_arn #task_arn} => String
|
|
3831
|
+
#
|
|
3832
|
+
# @example Request syntax with placeholder values
|
|
3833
|
+
#
|
|
3834
|
+
# resp = client.execute_command({
|
|
3835
|
+
# cluster: "String",
|
|
3836
|
+
# container: "String",
|
|
3837
|
+
# command: "String", # required
|
|
3838
|
+
# interactive: false, # required
|
|
3839
|
+
# task: "String", # required
|
|
3840
|
+
# })
|
|
3841
|
+
#
|
|
3842
|
+
# @example Response structure
|
|
3843
|
+
#
|
|
3844
|
+
# resp.cluster_arn #=> String
|
|
3845
|
+
# resp.container_arn #=> String
|
|
3846
|
+
# resp.container_name #=> String
|
|
3847
|
+
# resp.interactive #=> Boolean
|
|
3848
|
+
# resp.session.session_id #=> String
|
|
3849
|
+
# resp.session.stream_url #=> String
|
|
3850
|
+
# resp.session.token_value #=> String
|
|
3851
|
+
# resp.task_arn #=> String
|
|
3852
|
+
#
|
|
3853
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/ExecuteCommand AWS API Documentation
|
|
3854
|
+
#
|
|
3855
|
+
# @overload execute_command(params = {})
|
|
3856
|
+
# @param [Hash] params ({})
|
|
3857
|
+
def execute_command(params = {}, options = {})
|
|
3858
|
+
req = build_request(:execute_command, params)
|
|
3859
|
+
req.send_request(options)
|
|
3860
|
+
end
|
|
3861
|
+
|
|
3763
3862
|
# Lists the account settings for a specified principal.
|
|
3764
3863
|
#
|
|
3765
3864
|
# @option params [String] :name
|
|
@@ -3774,6 +3873,11 @@ module Aws::ECS
|
|
|
3774
3873
|
# root user. If this field is omitted, the account settings are listed
|
|
3775
3874
|
# only for the authenticated user.
|
|
3776
3875
|
#
|
|
3876
|
+
# <note markdown="1"> Federated users assume the account setting of the root user and can't
|
|
3877
|
+
# have explicit account settings set for them.
|
|
3878
|
+
#
|
|
3879
|
+
# </note>
|
|
3880
|
+
#
|
|
3777
3881
|
# @option params [Boolean] :effective_settings
|
|
3778
3882
|
# Specifies whether to return the effective settings. If `true`, the
|
|
3779
3883
|
# account settings for the root user or the default setting for the
|
|
@@ -4154,12 +4258,13 @@ module Aws::ECS
|
|
|
4154
4258
|
req.send_request(options)
|
|
4155
4259
|
end
|
|
4156
4260
|
|
|
4157
|
-
#
|
|
4261
|
+
# Returns a list of services. You can filter the results by cluster,
|
|
4262
|
+
# launch type, and scheduling strategy.
|
|
4158
4263
|
#
|
|
4159
4264
|
# @option params [String] :cluster
|
|
4160
|
-
# The short name or full Amazon Resource Name (ARN) of the cluster
|
|
4161
|
-
#
|
|
4162
|
-
# default cluster is assumed.
|
|
4265
|
+
# The short name or full Amazon Resource Name (ARN) of the cluster to
|
|
4266
|
+
# use when filtering the `ListServices` results. If you do not specify a
|
|
4267
|
+
# cluster, the default cluster is assumed.
|
|
4163
4268
|
#
|
|
4164
4269
|
# @option params [String] :next_token
|
|
4165
4270
|
# The `nextToken` value returned from a `ListServices` request
|
|
@@ -4184,10 +4289,11 @@ module Aws::ECS
|
|
|
4184
4289
|
# and a `nextToken` value if applicable.
|
|
4185
4290
|
#
|
|
4186
4291
|
# @option params [String] :launch_type
|
|
4187
|
-
# The launch type
|
|
4292
|
+
# The launch type to use when filtering the `ListServices` results.
|
|
4188
4293
|
#
|
|
4189
4294
|
# @option params [String] :scheduling_strategy
|
|
4190
|
-
# The scheduling strategy
|
|
4295
|
+
# The scheduling strategy to use when filtering the `ListServices`
|
|
4296
|
+
# results.
|
|
4191
4297
|
#
|
|
4192
4298
|
# @return [Types::ListServicesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
4193
4299
|
#
|
|
@@ -4217,7 +4323,7 @@ module Aws::ECS
|
|
|
4217
4323
|
# cluster: "String",
|
|
4218
4324
|
# next_token: "String",
|
|
4219
4325
|
# max_results: 1,
|
|
4220
|
-
# launch_type: "EC2", # accepts EC2, FARGATE
|
|
4326
|
+
# launch_type: "EC2", # accepts EC2, FARGATE, EXTERNAL
|
|
4221
4327
|
# scheduling_strategy: "REPLICA", # accepts REPLICA, DAEMON
|
|
4222
4328
|
# })
|
|
4223
4329
|
#
|
|
@@ -4522,30 +4628,29 @@ module Aws::ECS
|
|
|
4522
4628
|
req.send_request(options)
|
|
4523
4629
|
end
|
|
4524
4630
|
|
|
4525
|
-
# Returns a list of tasks
|
|
4526
|
-
#
|
|
4527
|
-
#
|
|
4528
|
-
# `desiredStatus` parameters.
|
|
4631
|
+
# Returns a list of tasks. You can filter the results by cluster, task
|
|
4632
|
+
# definition family, container instance, launch type, what IAM principal
|
|
4633
|
+
# started the task, or by the desired status of the task.
|
|
4529
4634
|
#
|
|
4530
4635
|
# Recently stopped tasks might appear in the returned results.
|
|
4531
4636
|
# Currently, stopped tasks appear in the returned results for at least
|
|
4532
4637
|
# one hour.
|
|
4533
4638
|
#
|
|
4534
4639
|
# @option params [String] :cluster
|
|
4535
|
-
# The short name or full Amazon Resource Name (ARN) of the cluster
|
|
4536
|
-
#
|
|
4537
|
-
# cluster is assumed.
|
|
4640
|
+
# The short name or full Amazon Resource Name (ARN) of the cluster to
|
|
4641
|
+
# use when filtering the `ListTasks` results. If you do not specify a
|
|
4642
|
+
# cluster, the default cluster is assumed.
|
|
4538
4643
|
#
|
|
4539
4644
|
# @option params [String] :container_instance
|
|
4540
|
-
# The container instance ID or full ARN of the container instance
|
|
4541
|
-
#
|
|
4645
|
+
# The container instance ID or full ARN of the container instance to use
|
|
4646
|
+
# when filtering the `ListTasks` results. Specifying a
|
|
4542
4647
|
# `containerInstance` limits the results to tasks that belong to that
|
|
4543
4648
|
# container instance.
|
|
4544
4649
|
#
|
|
4545
4650
|
# @option params [String] :family
|
|
4546
|
-
# The name of the
|
|
4547
|
-
# Specifying a `family` limits the results to tasks
|
|
4548
|
-
# family.
|
|
4651
|
+
# The name of the task definition family to use when filtering the
|
|
4652
|
+
# `ListTasks` results. Specifying a `family` limits the results to tasks
|
|
4653
|
+
# that belong to that family.
|
|
4549
4654
|
#
|
|
4550
4655
|
# @option params [String] :next_token
|
|
4551
4656
|
# The `nextToken` value returned from a `ListTasks` request indicating
|
|
@@ -4575,12 +4680,12 @@ module Aws::ECS
|
|
|
4575
4680
|
# started with that value.
|
|
4576
4681
|
#
|
|
4577
4682
|
# @option params [String] :service_name
|
|
4578
|
-
# The name of the service
|
|
4683
|
+
# The name of the service to use when filtering the `ListTasks` results.
|
|
4579
4684
|
# Specifying a `serviceName` limits the results to tasks that belong to
|
|
4580
4685
|
# that service.
|
|
4581
4686
|
#
|
|
4582
4687
|
# @option params [String] :desired_status
|
|
4583
|
-
# The task desired status
|
|
4688
|
+
# The task desired status to use when filtering the `ListTasks` results.
|
|
4584
4689
|
# Specifying a `desiredStatus` of `STOPPED` limits the results to tasks
|
|
4585
4690
|
# that Amazon ECS has set the desired status to `STOPPED`. This can be
|
|
4586
4691
|
# useful for debugging tasks that are not starting properly or have died
|
|
@@ -4595,7 +4700,7 @@ module Aws::ECS
|
|
|
4595
4700
|
# </note>
|
|
4596
4701
|
#
|
|
4597
4702
|
# @option params [String] :launch_type
|
|
4598
|
-
# The launch type
|
|
4703
|
+
# The launch type to use when filtering the `ListTasks` results.
|
|
4599
4704
|
#
|
|
4600
4705
|
# @return [Types::ListTasksResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
4601
4706
|
#
|
|
@@ -4649,7 +4754,7 @@ module Aws::ECS
|
|
|
4649
4754
|
# started_by: "String",
|
|
4650
4755
|
# service_name: "String",
|
|
4651
4756
|
# desired_status: "RUNNING", # accepts RUNNING, PENDING, STOPPED
|
|
4652
|
-
# launch_type: "EC2", # accepts EC2, FARGATE
|
|
4757
|
+
# launch_type: "EC2", # accepts EC2, FARGATE, EXTERNAL
|
|
4653
4758
|
# })
|
|
4654
4759
|
#
|
|
4655
4760
|
# @example Response structure
|
|
@@ -4732,6 +4837,11 @@ module Aws::ECS
|
|
|
4732
4837
|
# this field is omitted, the setting is changed only for the
|
|
4733
4838
|
# authenticated user.
|
|
4734
4839
|
#
|
|
4840
|
+
# <note markdown="1"> Federated users assume the account setting of the root user and can't
|
|
4841
|
+
# have explicit account settings set for them.
|
|
4842
|
+
#
|
|
4843
|
+
# </note>
|
|
4844
|
+
#
|
|
4735
4845
|
# @return [Types::PutAccountSettingResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
4736
4846
|
#
|
|
4737
4847
|
# * {Types::PutAccountSettingResponse#setting #setting} => Types::Setting
|
|
@@ -5005,6 +5115,13 @@ module Aws::ECS
|
|
|
5005
5115
|
#
|
|
5006
5116
|
# resp.cluster.cluster_arn #=> String
|
|
5007
5117
|
# resp.cluster.cluster_name #=> String
|
|
5118
|
+
# resp.cluster.configuration.execute_command_configuration.kms_key_id #=> String
|
|
5119
|
+
# resp.cluster.configuration.execute_command_configuration.logging #=> String, one of "NONE", "DEFAULT", "OVERRIDE"
|
|
5120
|
+
# resp.cluster.configuration.execute_command_configuration.log_configuration.cloud_watch_log_group_name #=> String
|
|
5121
|
+
# resp.cluster.configuration.execute_command_configuration.log_configuration.cloud_watch_encryption_enabled #=> Boolean
|
|
5122
|
+
# resp.cluster.configuration.execute_command_configuration.log_configuration.s3_bucket_name #=> String
|
|
5123
|
+
# resp.cluster.configuration.execute_command_configuration.log_configuration.s3_encryption_enabled #=> Boolean
|
|
5124
|
+
# resp.cluster.configuration.execute_command_configuration.log_configuration.s3_key_prefix #=> String
|
|
5008
5125
|
# resp.cluster.status #=> String
|
|
5009
5126
|
# resp.cluster.registered_container_instances_count #=> Integer
|
|
5010
5127
|
# resp.cluster.running_tasks_count #=> Integer
|
|
@@ -5256,7 +5373,7 @@ module Aws::ECS
|
|
|
5256
5373
|
# You must specify a `family` for a task definition, which allows you to
|
|
5257
5374
|
# track multiple versions of the same task definition. The `family` is
|
|
5258
5375
|
# used as a name for your task definition. Up to 255 letters (uppercase
|
|
5259
|
-
# and lowercase), numbers, and hyphens are allowed.
|
|
5376
|
+
# and lowercase), numbers, underscores, and hyphens are allowed.
|
|
5260
5377
|
#
|
|
5261
5378
|
# @option params [String] :task_role_arn
|
|
5262
5379
|
# The short name or full Amazon Resource Name (ARN) of the IAM role that
|
|
@@ -5350,9 +5467,9 @@ module Aws::ECS
|
|
|
5350
5467
|
#
|
|
5351
5468
|
# @option params [Array<String>] :requires_compatibilities
|
|
5352
5469
|
# The task launch type that Amazon ECS should validate the task
|
|
5353
|
-
# definition against.
|
|
5354
|
-
#
|
|
5355
|
-
# specified,
|
|
5470
|
+
# definition against. A client exception is returned if the task
|
|
5471
|
+
# definition doesn't validate against the compatibilities specified. If
|
|
5472
|
+
# no value is specified, the parameter is omitted from the response.
|
|
5356
5473
|
#
|
|
5357
5474
|
# @option params [String] :cpu
|
|
5358
5475
|
# The number of CPU units used by the task. It can be expressed as an
|
|
@@ -5468,8 +5585,8 @@ module Aws::ECS
|
|
|
5468
5585
|
# risk of undesired process namespace expose. For more information, see
|
|
5469
5586
|
# [Docker security][2].
|
|
5470
5587
|
#
|
|
5471
|
-
# <note markdown="1"> This parameter is not supported for Windows containers or tasks
|
|
5472
|
-
#
|
|
5588
|
+
# <note markdown="1"> This parameter is not supported for Windows containers or tasks run on
|
|
5589
|
+
# AWS Fargate.
|
|
5473
5590
|
#
|
|
5474
5591
|
# </note>
|
|
5475
5592
|
#
|
|
@@ -5507,8 +5624,8 @@ module Aws::ECS
|
|
|
5507
5624
|
# * For tasks that use the `task` IPC mode, IPC namespace related
|
|
5508
5625
|
# `systemControls` will apply to all containers within a task.
|
|
5509
5626
|
#
|
|
5510
|
-
# <note markdown="1"> This parameter is not supported for Windows containers or tasks
|
|
5511
|
-
#
|
|
5627
|
+
# <note markdown="1"> This parameter is not supported for Windows containers or tasks run on
|
|
5628
|
+
# AWS Fargate.
|
|
5512
5629
|
#
|
|
5513
5630
|
# </note>
|
|
5514
5631
|
#
|
|
@@ -5521,22 +5638,39 @@ module Aws::ECS
|
|
|
5521
5638
|
# @option params [Types::ProxyConfiguration] :proxy_configuration
|
|
5522
5639
|
# The configuration details for the App Mesh proxy.
|
|
5523
5640
|
#
|
|
5524
|
-
# For tasks
|
|
5525
|
-
# at least version 1.26.0 of the container agent and at least
|
|
5526
|
-
# 1.26.0-1 of the `ecs-init` package to enable a proxy
|
|
5527
|
-
# your container instances are launched from the
|
|
5528
|
-
# AMI version `20190301` or later, then they
|
|
5529
|
-
# versions of the container agent and `ecs-init`.
|
|
5530
|
-
# see [Amazon ECS-optimized
|
|
5641
|
+
# For tasks hosted on Amazon EC2 instances, the container instances
|
|
5642
|
+
# require at least version `1.26.0` of the container agent and at least
|
|
5643
|
+
# version `1.26.0-1` of the `ecs-init` package to enable a proxy
|
|
5644
|
+
# configuration. If your container instances are launched from the
|
|
5645
|
+
# Amazon ECS-optimized AMI version `20190301` or later, then they
|
|
5646
|
+
# contain the required versions of the container agent and `ecs-init`.
|
|
5647
|
+
# For more information, see [Amazon ECS-optimized AMI versions][1] in
|
|
5648
|
+
# the *Amazon Elastic Container Service Developer Guide*.
|
|
5531
5649
|
#
|
|
5532
5650
|
#
|
|
5533
5651
|
#
|
|
5534
|
-
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-
|
|
5652
|
+
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-ami-versions.html
|
|
5535
5653
|
#
|
|
5536
5654
|
# @option params [Array<Types::InferenceAccelerator>] :inference_accelerators
|
|
5537
5655
|
# The Elastic Inference accelerators to use for the containers in the
|
|
5538
5656
|
# task.
|
|
5539
5657
|
#
|
|
5658
|
+
# @option params [Types::EphemeralStorage] :ephemeral_storage
|
|
5659
|
+
# The amount of ephemeral storage to allocate for the task. This
|
|
5660
|
+
# parameter is used to expand the total amount of ephemeral storage
|
|
5661
|
+
# available, beyond the default amount, for tasks hosted on AWS Fargate.
|
|
5662
|
+
# For more information, see [Fargate task storage][1] in the *Amazon ECS
|
|
5663
|
+
# User Guide for AWS Fargate*.
|
|
5664
|
+
#
|
|
5665
|
+
# <note markdown="1"> This parameter is only supported for tasks hosted on AWS Fargate using
|
|
5666
|
+
# platform version `1.4.0` or later.
|
|
5667
|
+
#
|
|
5668
|
+
# </note>
|
|
5669
|
+
#
|
|
5670
|
+
#
|
|
5671
|
+
#
|
|
5672
|
+
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/userguide/using_data_volumes.html
|
|
5673
|
+
#
|
|
5540
5674
|
# @return [Types::RegisterTaskDefinitionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
5541
5675
|
#
|
|
5542
5676
|
# * {Types::RegisterTaskDefinitionResponse#task_definition #task_definition} => Types::TaskDefinition
|
|
@@ -5799,7 +5933,7 @@ module Aws::ECS
|
|
|
5799
5933
|
# expression: "String",
|
|
5800
5934
|
# },
|
|
5801
5935
|
# ],
|
|
5802
|
-
# requires_compatibilities: ["EC2"], # accepts EC2, FARGATE
|
|
5936
|
+
# requires_compatibilities: ["EC2"], # accepts EC2, FARGATE, EXTERNAL
|
|
5803
5937
|
# cpu: "String",
|
|
5804
5938
|
# memory: "String",
|
|
5805
5939
|
# tags: [
|
|
@@ -5826,6 +5960,9 @@ module Aws::ECS
|
|
|
5826
5960
|
# device_type: "String", # required
|
|
5827
5961
|
# },
|
|
5828
5962
|
# ],
|
|
5963
|
+
# ephemeral_storage: {
|
|
5964
|
+
# size_in_gi_b: 1, # required
|
|
5965
|
+
# },
|
|
5829
5966
|
# })
|
|
5830
5967
|
#
|
|
5831
5968
|
# @example Response structure
|
|
@@ -5967,9 +6104,9 @@ module Aws::ECS
|
|
|
5967
6104
|
# resp.task_definition.placement_constraints[0].type #=> String, one of "memberOf"
|
|
5968
6105
|
# resp.task_definition.placement_constraints[0].expression #=> String
|
|
5969
6106
|
# resp.task_definition.compatibilities #=> Array
|
|
5970
|
-
# resp.task_definition.compatibilities[0] #=> String, one of "EC2", "FARGATE"
|
|
6107
|
+
# resp.task_definition.compatibilities[0] #=> String, one of "EC2", "FARGATE", "EXTERNAL"
|
|
5971
6108
|
# resp.task_definition.requires_compatibilities #=> Array
|
|
5972
|
-
# resp.task_definition.requires_compatibilities[0] #=> String, one of "EC2", "FARGATE"
|
|
6109
|
+
# resp.task_definition.requires_compatibilities[0] #=> String, one of "EC2", "FARGATE", "EXTERNAL"
|
|
5973
6110
|
# resp.task_definition.cpu #=> String
|
|
5974
6111
|
# resp.task_definition.memory #=> String
|
|
5975
6112
|
# resp.task_definition.inference_accelerators #=> Array
|
|
@@ -5985,6 +6122,7 @@ module Aws::ECS
|
|
|
5985
6122
|
# resp.task_definition.registered_at #=> Time
|
|
5986
6123
|
# resp.task_definition.deregistered_at #=> Time
|
|
5987
6124
|
# resp.task_definition.registered_by #=> String
|
|
6125
|
+
# resp.task_definition.ephemeral_storage.size_in_gi_b #=> Integer
|
|
5988
6126
|
# resp.tags #=> Array
|
|
5989
6127
|
# resp.tags[0].key #=> String
|
|
5990
6128
|
# resp.tags[0].value #=> String
|
|
@@ -6037,31 +6175,11 @@ module Aws::ECS
|
|
|
6037
6175
|
# @option params [Array<Types::CapacityProviderStrategyItem>] :capacity_provider_strategy
|
|
6038
6176
|
# The capacity provider strategy to use for the task.
|
|
6039
6177
|
#
|
|
6040
|
-
# A capacity provider strategy consists of one or more capacity
|
|
6041
|
-
# providers along with the `base` and `weight` to assign to them. A
|
|
6042
|
-
# capacity provider must be associated with the cluster to be used in a
|
|
6043
|
-
# capacity provider strategy. The PutClusterCapacityProviders API is
|
|
6044
|
-
# used to associate a capacity provider with a cluster. Only capacity
|
|
6045
|
-
# providers with an `ACTIVE` or `UPDATING` status can be used.
|
|
6046
|
-
#
|
|
6047
6178
|
# If a `capacityProviderStrategy` is specified, the `launchType`
|
|
6048
6179
|
# parameter must be omitted. If no `capacityProviderStrategy` or
|
|
6049
6180
|
# `launchType` is specified, the `defaultCapacityProviderStrategy` for
|
|
6050
6181
|
# the cluster is used.
|
|
6051
6182
|
#
|
|
6052
|
-
# If specifying a capacity provider that uses an Auto Scaling group, the
|
|
6053
|
-
# capacity provider must already be created. New capacity providers can
|
|
6054
|
-
# be created with the CreateCapacityProvider API operation.
|
|
6055
|
-
#
|
|
6056
|
-
# To use a AWS Fargate capacity provider, specify either the `FARGATE`
|
|
6057
|
-
# or `FARGATE_SPOT` capacity providers. The AWS Fargate capacity
|
|
6058
|
-
# providers are available to all accounts and only need to be associated
|
|
6059
|
-
# with a cluster to be used.
|
|
6060
|
-
#
|
|
6061
|
-
# The PutClusterCapacityProviders API operation is used to update the
|
|
6062
|
-
# list of available capacity providers for a cluster after the cluster
|
|
6063
|
-
# is created.
|
|
6064
|
-
#
|
|
6065
6183
|
# @option params [String] :cluster
|
|
6066
6184
|
# The short name or full Amazon Resource Name (ARN) of the cluster on
|
|
6067
6185
|
# which to run your task. If you do not specify a cluster, the default
|
|
@@ -6080,22 +6198,44 @@ module Aws::ECS
|
|
|
6080
6198
|
#
|
|
6081
6199
|
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html
|
|
6082
6200
|
#
|
|
6201
|
+
# @option params [Boolean] :enable_execute_command
|
|
6202
|
+
# Whether or not to enable the execute command functionality for the
|
|
6203
|
+
# containers in this task. If `true`, this enables execute command
|
|
6204
|
+
# functionality on all containers in the task.
|
|
6205
|
+
#
|
|
6083
6206
|
# @option params [String] :group
|
|
6084
6207
|
# The name of the task group to associate with the task. The default
|
|
6085
6208
|
# value is the family name of the task definition (for example,
|
|
6086
6209
|
# family:my-family-name).
|
|
6087
6210
|
#
|
|
6088
6211
|
# @option params [String] :launch_type
|
|
6089
|
-
# The
|
|
6090
|
-
# [Amazon ECS
|
|
6091
|
-
# Developer Guide*.
|
|
6212
|
+
# The infrastructure on which to run your standalone task. For more
|
|
6213
|
+
# information, see [Amazon ECS launch types][1] in the *Amazon Elastic
|
|
6214
|
+
# Container Service Developer Guide*.
|
|
6215
|
+
#
|
|
6216
|
+
# The `FARGATE` launch type runs your tasks on AWS Fargate On-Demand
|
|
6217
|
+
# infrastructure.
|
|
6218
|
+
#
|
|
6219
|
+
# <note markdown="1"> Fargate Spot infrastructure is available for use but a capacity
|
|
6220
|
+
# provider strategy must be used. For more information, see [AWS Fargate
|
|
6221
|
+
# capacity providers][2] in the *Amazon ECS User Guide for AWS Fargate*.
|
|
6222
|
+
#
|
|
6223
|
+
# </note>
|
|
6224
|
+
#
|
|
6225
|
+
# The `EC2` launch type runs your tasks on Amazon EC2 instances
|
|
6226
|
+
# registered to your cluster.
|
|
6227
|
+
#
|
|
6228
|
+
# The `EXTERNAL` launch type runs your tasks on your on-premise server
|
|
6229
|
+
# or virtual machine (VM) capacity registered to your cluster.
|
|
6092
6230
|
#
|
|
6231
|
+
# A task can use either a launch type or a capacity provider strategy.
|
|
6093
6232
|
# If a `launchType` is specified, the `capacityProviderStrategy`
|
|
6094
6233
|
# parameter must be omitted.
|
|
6095
6234
|
#
|
|
6096
6235
|
#
|
|
6097
6236
|
#
|
|
6098
6237
|
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_types.html
|
|
6238
|
+
# [2]: https://docs.aws.amazon.com/AmazonECS/latest/userguide/fargate-capacity-providers.html
|
|
6099
6239
|
#
|
|
6100
6240
|
# @option params [Types::NetworkConfiguration] :network_configuration
|
|
6101
6241
|
# The network configuration for the task. This parameter is required for
|
|
@@ -6260,8 +6400,9 @@ module Aws::ECS
|
|
|
6260
6400
|
# cluster: "String",
|
|
6261
6401
|
# count: 1,
|
|
6262
6402
|
# enable_ecs_managed_tags: false,
|
|
6403
|
+
# enable_execute_command: false,
|
|
6263
6404
|
# group: "String",
|
|
6264
|
-
# launch_type: "EC2", # accepts EC2, FARGATE
|
|
6405
|
+
# launch_type: "EC2", # accepts EC2, FARGATE, EXTERNAL
|
|
6265
6406
|
# network_configuration: {
|
|
6266
6407
|
# awsvpc_configuration: {
|
|
6267
6408
|
# subnets: ["String"], # required
|
|
@@ -6307,6 +6448,9 @@ module Aws::ECS
|
|
|
6307
6448
|
# execution_role_arn: "String",
|
|
6308
6449
|
# memory: "String",
|
|
6309
6450
|
# task_role_arn: "String",
|
|
6451
|
+
# ephemeral_storage: {
|
|
6452
|
+
# size_in_gi_b: 1, # required
|
|
6453
|
+
# },
|
|
6310
6454
|
# },
|
|
6311
6455
|
# placement_constraints: [
|
|
6312
6456
|
# {
|
|
@@ -6374,6 +6518,11 @@ module Aws::ECS
|
|
|
6374
6518
|
# resp.tasks[0].containers[0].network_interfaces[0].private_ipv_4_address #=> String
|
|
6375
6519
|
# resp.tasks[0].containers[0].network_interfaces[0].ipv6_address #=> String
|
|
6376
6520
|
# resp.tasks[0].containers[0].health_status #=> String, one of "HEALTHY", "UNHEALTHY", "UNKNOWN"
|
|
6521
|
+
# resp.tasks[0].containers[0].managed_agents #=> Array
|
|
6522
|
+
# resp.tasks[0].containers[0].managed_agents[0].last_started_at #=> Time
|
|
6523
|
+
# resp.tasks[0].containers[0].managed_agents[0].name #=> String, one of "ExecuteCommandAgent"
|
|
6524
|
+
# resp.tasks[0].containers[0].managed_agents[0].reason #=> String
|
|
6525
|
+
# resp.tasks[0].containers[0].managed_agents[0].last_status #=> String
|
|
6377
6526
|
# resp.tasks[0].containers[0].cpu #=> String
|
|
6378
6527
|
# resp.tasks[0].containers[0].memory #=> String
|
|
6379
6528
|
# resp.tasks[0].containers[0].memory_reservation #=> String
|
|
@@ -6382,6 +6531,7 @@ module Aws::ECS
|
|
|
6382
6531
|
# resp.tasks[0].cpu #=> String
|
|
6383
6532
|
# resp.tasks[0].created_at #=> Time
|
|
6384
6533
|
# resp.tasks[0].desired_status #=> String
|
|
6534
|
+
# resp.tasks[0].enable_execute_command #=> Boolean
|
|
6385
6535
|
# resp.tasks[0].execution_stopped_at #=> Time
|
|
6386
6536
|
# resp.tasks[0].group #=> String
|
|
6387
6537
|
# resp.tasks[0].health_status #=> String, one of "HEALTHY", "UNHEALTHY", "UNKNOWN"
|
|
@@ -6389,7 +6539,7 @@ module Aws::ECS
|
|
|
6389
6539
|
# resp.tasks[0].inference_accelerators[0].device_name #=> String
|
|
6390
6540
|
# resp.tasks[0].inference_accelerators[0].device_type #=> String
|
|
6391
6541
|
# resp.tasks[0].last_status #=> String
|
|
6392
|
-
# resp.tasks[0].launch_type #=> String, one of "EC2", "FARGATE"
|
|
6542
|
+
# resp.tasks[0].launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
|
|
6393
6543
|
# resp.tasks[0].memory #=> String
|
|
6394
6544
|
# resp.tasks[0].overrides.container_overrides #=> Array
|
|
6395
6545
|
# resp.tasks[0].overrides.container_overrides[0].name #=> String
|
|
@@ -6414,6 +6564,7 @@ module Aws::ECS
|
|
|
6414
6564
|
# resp.tasks[0].overrides.execution_role_arn #=> String
|
|
6415
6565
|
# resp.tasks[0].overrides.memory #=> String
|
|
6416
6566
|
# resp.tasks[0].overrides.task_role_arn #=> String
|
|
6567
|
+
# resp.tasks[0].overrides.ephemeral_storage.size_in_gi_b #=> Integer
|
|
6417
6568
|
# resp.tasks[0].platform_version #=> String
|
|
6418
6569
|
# resp.tasks[0].pull_started_at #=> Time
|
|
6419
6570
|
# resp.tasks[0].pull_stopped_at #=> Time
|
|
@@ -6429,6 +6580,7 @@ module Aws::ECS
|
|
|
6429
6580
|
# resp.tasks[0].task_arn #=> String
|
|
6430
6581
|
# resp.tasks[0].task_definition_arn #=> String
|
|
6431
6582
|
# resp.tasks[0].version #=> Integer
|
|
6583
|
+
# resp.tasks[0].ephemeral_storage.size_in_gi_b #=> Integer
|
|
6432
6584
|
# resp.failures #=> Array
|
|
6433
6585
|
# resp.failures[0].arn #=> String
|
|
6434
6586
|
# resp.failures[0].reason #=> String
|
|
@@ -6473,6 +6625,11 @@ module Aws::ECS
|
|
|
6473
6625
|
#
|
|
6474
6626
|
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html
|
|
6475
6627
|
#
|
|
6628
|
+
# @option params [Boolean] :enable_execute_command
|
|
6629
|
+
# Whether or not the execute command functionality is enabled for the
|
|
6630
|
+
# task. If `true`, this enables execute command functionality on all
|
|
6631
|
+
# containers in the task.
|
|
6632
|
+
#
|
|
6476
6633
|
# @option params [String] :group
|
|
6477
6634
|
# The name of the task group to associate with the task. The default
|
|
6478
6635
|
# value is the family name of the task definition (for example,
|
|
@@ -6564,6 +6721,7 @@ module Aws::ECS
|
|
|
6564
6721
|
# cluster: "String",
|
|
6565
6722
|
# container_instances: ["String"], # required
|
|
6566
6723
|
# enable_ecs_managed_tags: false,
|
|
6724
|
+
# enable_execute_command: false,
|
|
6567
6725
|
# group: "String",
|
|
6568
6726
|
# network_configuration: {
|
|
6569
6727
|
# awsvpc_configuration: {
|
|
@@ -6610,6 +6768,9 @@ module Aws::ECS
|
|
|
6610
6768
|
# execution_role_arn: "String",
|
|
6611
6769
|
# memory: "String",
|
|
6612
6770
|
# task_role_arn: "String",
|
|
6771
|
+
# ephemeral_storage: {
|
|
6772
|
+
# size_in_gi_b: 1, # required
|
|
6773
|
+
# },
|
|
6613
6774
|
# },
|
|
6614
6775
|
# propagate_tags: "TASK_DEFINITION", # accepts TASK_DEFINITION, SERVICE
|
|
6615
6776
|
# reference_id: "String",
|
|
@@ -6664,6 +6825,11 @@ module Aws::ECS
|
|
|
6664
6825
|
# resp.tasks[0].containers[0].network_interfaces[0].private_ipv_4_address #=> String
|
|
6665
6826
|
# resp.tasks[0].containers[0].network_interfaces[0].ipv6_address #=> String
|
|
6666
6827
|
# resp.tasks[0].containers[0].health_status #=> String, one of "HEALTHY", "UNHEALTHY", "UNKNOWN"
|
|
6828
|
+
# resp.tasks[0].containers[0].managed_agents #=> Array
|
|
6829
|
+
# resp.tasks[0].containers[0].managed_agents[0].last_started_at #=> Time
|
|
6830
|
+
# resp.tasks[0].containers[0].managed_agents[0].name #=> String, one of "ExecuteCommandAgent"
|
|
6831
|
+
# resp.tasks[0].containers[0].managed_agents[0].reason #=> String
|
|
6832
|
+
# resp.tasks[0].containers[0].managed_agents[0].last_status #=> String
|
|
6667
6833
|
# resp.tasks[0].containers[0].cpu #=> String
|
|
6668
6834
|
# resp.tasks[0].containers[0].memory #=> String
|
|
6669
6835
|
# resp.tasks[0].containers[0].memory_reservation #=> String
|
|
@@ -6672,6 +6838,7 @@ module Aws::ECS
|
|
|
6672
6838
|
# resp.tasks[0].cpu #=> String
|
|
6673
6839
|
# resp.tasks[0].created_at #=> Time
|
|
6674
6840
|
# resp.tasks[0].desired_status #=> String
|
|
6841
|
+
# resp.tasks[0].enable_execute_command #=> Boolean
|
|
6675
6842
|
# resp.tasks[0].execution_stopped_at #=> Time
|
|
6676
6843
|
# resp.tasks[0].group #=> String
|
|
6677
6844
|
# resp.tasks[0].health_status #=> String, one of "HEALTHY", "UNHEALTHY", "UNKNOWN"
|
|
@@ -6679,7 +6846,7 @@ module Aws::ECS
|
|
|
6679
6846
|
# resp.tasks[0].inference_accelerators[0].device_name #=> String
|
|
6680
6847
|
# resp.tasks[0].inference_accelerators[0].device_type #=> String
|
|
6681
6848
|
# resp.tasks[0].last_status #=> String
|
|
6682
|
-
# resp.tasks[0].launch_type #=> String, one of "EC2", "FARGATE"
|
|
6849
|
+
# resp.tasks[0].launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
|
|
6683
6850
|
# resp.tasks[0].memory #=> String
|
|
6684
6851
|
# resp.tasks[0].overrides.container_overrides #=> Array
|
|
6685
6852
|
# resp.tasks[0].overrides.container_overrides[0].name #=> String
|
|
@@ -6704,6 +6871,7 @@ module Aws::ECS
|
|
|
6704
6871
|
# resp.tasks[0].overrides.execution_role_arn #=> String
|
|
6705
6872
|
# resp.tasks[0].overrides.memory #=> String
|
|
6706
6873
|
# resp.tasks[0].overrides.task_role_arn #=> String
|
|
6874
|
+
# resp.tasks[0].overrides.ephemeral_storage.size_in_gi_b #=> Integer
|
|
6707
6875
|
# resp.tasks[0].platform_version #=> String
|
|
6708
6876
|
# resp.tasks[0].pull_started_at #=> Time
|
|
6709
6877
|
# resp.tasks[0].pull_stopped_at #=> Time
|
|
@@ -6719,6 +6887,7 @@ module Aws::ECS
|
|
|
6719
6887
|
# resp.tasks[0].task_arn #=> String
|
|
6720
6888
|
# resp.tasks[0].task_definition_arn #=> String
|
|
6721
6889
|
# resp.tasks[0].version #=> Integer
|
|
6890
|
+
# resp.tasks[0].ephemeral_storage.size_in_gi_b #=> Integer
|
|
6722
6891
|
# resp.failures #=> Array
|
|
6723
6892
|
# resp.failures[0].arn #=> String
|
|
6724
6893
|
# resp.failures[0].reason #=> String
|
|
@@ -6821,6 +6990,11 @@ module Aws::ECS
|
|
|
6821
6990
|
# resp.task.containers[0].network_interfaces[0].private_ipv_4_address #=> String
|
|
6822
6991
|
# resp.task.containers[0].network_interfaces[0].ipv6_address #=> String
|
|
6823
6992
|
# resp.task.containers[0].health_status #=> String, one of "HEALTHY", "UNHEALTHY", "UNKNOWN"
|
|
6993
|
+
# resp.task.containers[0].managed_agents #=> Array
|
|
6994
|
+
# resp.task.containers[0].managed_agents[0].last_started_at #=> Time
|
|
6995
|
+
# resp.task.containers[0].managed_agents[0].name #=> String, one of "ExecuteCommandAgent"
|
|
6996
|
+
# resp.task.containers[0].managed_agents[0].reason #=> String
|
|
6997
|
+
# resp.task.containers[0].managed_agents[0].last_status #=> String
|
|
6824
6998
|
# resp.task.containers[0].cpu #=> String
|
|
6825
6999
|
# resp.task.containers[0].memory #=> String
|
|
6826
7000
|
# resp.task.containers[0].memory_reservation #=> String
|
|
@@ -6829,6 +7003,7 @@ module Aws::ECS
|
|
|
6829
7003
|
# resp.task.cpu #=> String
|
|
6830
7004
|
# resp.task.created_at #=> Time
|
|
6831
7005
|
# resp.task.desired_status #=> String
|
|
7006
|
+
# resp.task.enable_execute_command #=> Boolean
|
|
6832
7007
|
# resp.task.execution_stopped_at #=> Time
|
|
6833
7008
|
# resp.task.group #=> String
|
|
6834
7009
|
# resp.task.health_status #=> String, one of "HEALTHY", "UNHEALTHY", "UNKNOWN"
|
|
@@ -6836,7 +7011,7 @@ module Aws::ECS
|
|
|
6836
7011
|
# resp.task.inference_accelerators[0].device_name #=> String
|
|
6837
7012
|
# resp.task.inference_accelerators[0].device_type #=> String
|
|
6838
7013
|
# resp.task.last_status #=> String
|
|
6839
|
-
# resp.task.launch_type #=> String, one of "EC2", "FARGATE"
|
|
7014
|
+
# resp.task.launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
|
|
6840
7015
|
# resp.task.memory #=> String
|
|
6841
7016
|
# resp.task.overrides.container_overrides #=> Array
|
|
6842
7017
|
# resp.task.overrides.container_overrides[0].name #=> String
|
|
@@ -6861,6 +7036,7 @@ module Aws::ECS
|
|
|
6861
7036
|
# resp.task.overrides.execution_role_arn #=> String
|
|
6862
7037
|
# resp.task.overrides.memory #=> String
|
|
6863
7038
|
# resp.task.overrides.task_role_arn #=> String
|
|
7039
|
+
# resp.task.overrides.ephemeral_storage.size_in_gi_b #=> Integer
|
|
6864
7040
|
# resp.task.platform_version #=> String
|
|
6865
7041
|
# resp.task.pull_started_at #=> Time
|
|
6866
7042
|
# resp.task.pull_stopped_at #=> Time
|
|
@@ -6876,6 +7052,7 @@ module Aws::ECS
|
|
|
6876
7052
|
# resp.task.task_arn #=> String
|
|
6877
7053
|
# resp.task.task_definition_arn #=> String
|
|
6878
7054
|
# resp.task.version #=> Integer
|
|
7055
|
+
# resp.task.ephemeral_storage.size_in_gi_b #=> Integer
|
|
6879
7056
|
#
|
|
6880
7057
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/StopTask AWS API Documentation
|
|
6881
7058
|
#
|
|
@@ -7024,6 +7201,9 @@ module Aws::ECS
|
|
|
7024
7201
|
# @option params [Array<Types::AttachmentStateChange>] :attachments
|
|
7025
7202
|
# Any attachments associated with the state change request.
|
|
7026
7203
|
#
|
|
7204
|
+
# @option params [Array<Types::ManagedAgentStateChange>] :managed_agents
|
|
7205
|
+
# The details for the managed agent associated with the task.
|
|
7206
|
+
#
|
|
7027
7207
|
# @option params [Time,DateTime,Date,Integer,String] :pull_started_at
|
|
7028
7208
|
# The Unix timestamp for when the container image pull began.
|
|
7029
7209
|
#
|
|
@@ -7068,6 +7248,14 @@ module Aws::ECS
|
|
|
7068
7248
|
# status: "String", # required
|
|
7069
7249
|
# },
|
|
7070
7250
|
# ],
|
|
7251
|
+
# managed_agents: [
|
|
7252
|
+
# {
|
|
7253
|
+
# container_name: "String", # required
|
|
7254
|
+
# managed_agent_name: "ExecuteCommandAgent", # required, accepts ExecuteCommandAgent
|
|
7255
|
+
# status: "String", # required
|
|
7256
|
+
# reason: "String",
|
|
7257
|
+
# },
|
|
7258
|
+
# ],
|
|
7071
7259
|
# pull_started_at: Time.now,
|
|
7072
7260
|
# pull_stopped_at: Time.now,
|
|
7073
7261
|
# execution_stopped_at: Time.now,
|
|
@@ -7267,6 +7455,95 @@ module Aws::ECS
|
|
|
7267
7455
|
req.send_request(options)
|
|
7268
7456
|
end
|
|
7269
7457
|
|
|
7458
|
+
# Updates the cluster.
|
|
7459
|
+
#
|
|
7460
|
+
# @option params [required, String] :cluster
|
|
7461
|
+
# The name of the cluster to modify the settings for.
|
|
7462
|
+
#
|
|
7463
|
+
# @option params [Array<Types::ClusterSetting>] :settings
|
|
7464
|
+
# The cluster settings for your cluster.
|
|
7465
|
+
#
|
|
7466
|
+
# @option params [Types::ClusterConfiguration] :configuration
|
|
7467
|
+
# The execute command configuration for the cluster.
|
|
7468
|
+
#
|
|
7469
|
+
# @return [Types::UpdateClusterResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
7470
|
+
#
|
|
7471
|
+
# * {Types::UpdateClusterResponse#cluster #cluster} => Types::Cluster
|
|
7472
|
+
#
|
|
7473
|
+
# @example Request syntax with placeholder values
|
|
7474
|
+
#
|
|
7475
|
+
# resp = client.update_cluster({
|
|
7476
|
+
# cluster: "String", # required
|
|
7477
|
+
# settings: [
|
|
7478
|
+
# {
|
|
7479
|
+
# name: "containerInsights", # accepts containerInsights
|
|
7480
|
+
# value: "String",
|
|
7481
|
+
# },
|
|
7482
|
+
# ],
|
|
7483
|
+
# configuration: {
|
|
7484
|
+
# execute_command_configuration: {
|
|
7485
|
+
# kms_key_id: "String",
|
|
7486
|
+
# logging: "NONE", # accepts NONE, DEFAULT, OVERRIDE
|
|
7487
|
+
# log_configuration: {
|
|
7488
|
+
# cloud_watch_log_group_name: "String",
|
|
7489
|
+
# cloud_watch_encryption_enabled: false,
|
|
7490
|
+
# s3_bucket_name: "String",
|
|
7491
|
+
# s3_encryption_enabled: false,
|
|
7492
|
+
# s3_key_prefix: "String",
|
|
7493
|
+
# },
|
|
7494
|
+
# },
|
|
7495
|
+
# },
|
|
7496
|
+
# })
|
|
7497
|
+
#
|
|
7498
|
+
# @example Response structure
|
|
7499
|
+
#
|
|
7500
|
+
# resp.cluster.cluster_arn #=> String
|
|
7501
|
+
# resp.cluster.cluster_name #=> String
|
|
7502
|
+
# resp.cluster.configuration.execute_command_configuration.kms_key_id #=> String
|
|
7503
|
+
# resp.cluster.configuration.execute_command_configuration.logging #=> String, one of "NONE", "DEFAULT", "OVERRIDE"
|
|
7504
|
+
# resp.cluster.configuration.execute_command_configuration.log_configuration.cloud_watch_log_group_name #=> String
|
|
7505
|
+
# resp.cluster.configuration.execute_command_configuration.log_configuration.cloud_watch_encryption_enabled #=> Boolean
|
|
7506
|
+
# resp.cluster.configuration.execute_command_configuration.log_configuration.s3_bucket_name #=> String
|
|
7507
|
+
# resp.cluster.configuration.execute_command_configuration.log_configuration.s3_encryption_enabled #=> Boolean
|
|
7508
|
+
# resp.cluster.configuration.execute_command_configuration.log_configuration.s3_key_prefix #=> String
|
|
7509
|
+
# resp.cluster.status #=> String
|
|
7510
|
+
# resp.cluster.registered_container_instances_count #=> Integer
|
|
7511
|
+
# resp.cluster.running_tasks_count #=> Integer
|
|
7512
|
+
# resp.cluster.pending_tasks_count #=> Integer
|
|
7513
|
+
# resp.cluster.active_services_count #=> Integer
|
|
7514
|
+
# resp.cluster.statistics #=> Array
|
|
7515
|
+
# resp.cluster.statistics[0].name #=> String
|
|
7516
|
+
# resp.cluster.statistics[0].value #=> String
|
|
7517
|
+
# resp.cluster.tags #=> Array
|
|
7518
|
+
# resp.cluster.tags[0].key #=> String
|
|
7519
|
+
# resp.cluster.tags[0].value #=> String
|
|
7520
|
+
# resp.cluster.settings #=> Array
|
|
7521
|
+
# resp.cluster.settings[0].name #=> String, one of "containerInsights"
|
|
7522
|
+
# resp.cluster.settings[0].value #=> String
|
|
7523
|
+
# resp.cluster.capacity_providers #=> Array
|
|
7524
|
+
# resp.cluster.capacity_providers[0] #=> String
|
|
7525
|
+
# resp.cluster.default_capacity_provider_strategy #=> Array
|
|
7526
|
+
# resp.cluster.default_capacity_provider_strategy[0].capacity_provider #=> String
|
|
7527
|
+
# resp.cluster.default_capacity_provider_strategy[0].weight #=> Integer
|
|
7528
|
+
# resp.cluster.default_capacity_provider_strategy[0].base #=> Integer
|
|
7529
|
+
# resp.cluster.attachments #=> Array
|
|
7530
|
+
# resp.cluster.attachments[0].id #=> String
|
|
7531
|
+
# resp.cluster.attachments[0].type #=> String
|
|
7532
|
+
# resp.cluster.attachments[0].status #=> String
|
|
7533
|
+
# resp.cluster.attachments[0].details #=> Array
|
|
7534
|
+
# resp.cluster.attachments[0].details[0].name #=> String
|
|
7535
|
+
# resp.cluster.attachments[0].details[0].value #=> String
|
|
7536
|
+
# resp.cluster.attachments_status #=> String
|
|
7537
|
+
#
|
|
7538
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/UpdateCluster AWS API Documentation
|
|
7539
|
+
#
|
|
7540
|
+
# @overload update_cluster(params = {})
|
|
7541
|
+
# @param [Hash] params ({})
|
|
7542
|
+
def update_cluster(params = {}, options = {})
|
|
7543
|
+
req = build_request(:update_cluster, params)
|
|
7544
|
+
req.send_request(options)
|
|
7545
|
+
end
|
|
7546
|
+
|
|
7270
7547
|
# Modifies the settings to use for a cluster.
|
|
7271
7548
|
#
|
|
7272
7549
|
# @option params [required, String] :cluster
|
|
@@ -7298,6 +7575,13 @@ module Aws::ECS
|
|
|
7298
7575
|
#
|
|
7299
7576
|
# resp.cluster.cluster_arn #=> String
|
|
7300
7577
|
# resp.cluster.cluster_name #=> String
|
|
7578
|
+
# resp.cluster.configuration.execute_command_configuration.kms_key_id #=> String
|
|
7579
|
+
# resp.cluster.configuration.execute_command_configuration.logging #=> String, one of "NONE", "DEFAULT", "OVERRIDE"
|
|
7580
|
+
# resp.cluster.configuration.execute_command_configuration.log_configuration.cloud_watch_log_group_name #=> String
|
|
7581
|
+
# resp.cluster.configuration.execute_command_configuration.log_configuration.cloud_watch_encryption_enabled #=> Boolean
|
|
7582
|
+
# resp.cluster.configuration.execute_command_configuration.log_configuration.s3_bucket_name #=> String
|
|
7583
|
+
# resp.cluster.configuration.execute_command_configuration.log_configuration.s3_encryption_enabled #=> Boolean
|
|
7584
|
+
# resp.cluster.configuration.execute_command_configuration.log_configuration.s3_key_prefix #=> String
|
|
7301
7585
|
# resp.cluster.status #=> String
|
|
7302
7586
|
# resp.cluster.registered_container_instances_count #=> Integer
|
|
7303
7587
|
# resp.cluster.running_tasks_count #=> Integer
|
|
@@ -7343,15 +7627,25 @@ module Aws::ECS
|
|
|
7343
7627
|
# instance was launched with the Amazon ECS-optimized AMI or another
|
|
7344
7628
|
# operating system.
|
|
7345
7629
|
#
|
|
7346
|
-
# `UpdateContainerAgent`
|
|
7347
|
-
#
|
|
7348
|
-
#
|
|
7349
|
-
#
|
|
7350
|
-
# *Amazon Elastic Container
|
|
7630
|
+
# <note markdown="1"> The `UpdateContainerAgent` API isn't supported for container
|
|
7631
|
+
# instances using the Amazon ECS-optimized Amazon Linux 2 (arm64) AMI.
|
|
7632
|
+
# To update the container agent, you can update the `ecs-init` package
|
|
7633
|
+
# which will update the agent. For more information, see [Updating the
|
|
7634
|
+
# Amazon ECS container agent][1] in the *Amazon Elastic Container
|
|
7635
|
+
# Service Developer Guide*.
|
|
7351
7636
|
#
|
|
7637
|
+
# </note>
|
|
7638
|
+
#
|
|
7639
|
+
# The `UpdateContainerAgent` API requires an Amazon ECS-optimized AMI or
|
|
7640
|
+
# Amazon Linux AMI with the `ecs-init` service installed and running.
|
|
7641
|
+
# For help updating the Amazon ECS container agent on other operating
|
|
7642
|
+
# systems, see [Manually updating the Amazon ECS container agent][2] in
|
|
7643
|
+
# the *Amazon Elastic Container Service Developer Guide*.
|
|
7352
7644
|
#
|
|
7353
7645
|
#
|
|
7354
|
-
#
|
|
7646
|
+
#
|
|
7647
|
+
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/agent-update-ecs-ami.html
|
|
7648
|
+
# [2]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-update.html#manually_update_agent
|
|
7355
7649
|
#
|
|
7356
7650
|
# @option params [String] :cluster
|
|
7357
7651
|
# The short name or full Amazon Resource Name (ARN) of the cluster that
|
|
@@ -7752,8 +8046,7 @@ module Aws::ECS
|
|
|
7752
8046
|
# the deployment and the ordering of stopping and starting tasks.
|
|
7753
8047
|
#
|
|
7754
8048
|
# @option params [Types::NetworkConfiguration] :network_configuration
|
|
7755
|
-
# An object representing the network configuration for
|
|
7756
|
-
# service.
|
|
8049
|
+
# An object representing the network configuration for the service.
|
|
7757
8050
|
#
|
|
7758
8051
|
# @option params [Array<Types::PlacementConstraint>] :placement_constraints
|
|
7759
8052
|
# An array of task placement constraint objects to update the service to
|
|
@@ -7807,6 +8100,13 @@ module Aws::ECS
|
|
|
7807
8100
|
# prevent the ECS service scheduler from marking tasks as unhealthy and
|
|
7808
8101
|
# stopping them before they have time to come up.
|
|
7809
8102
|
#
|
|
8103
|
+
# @option params [Boolean] :enable_execute_command
|
|
8104
|
+
# If `true`, this enables execute command functionality on all task
|
|
8105
|
+
# containers.
|
|
8106
|
+
#
|
|
8107
|
+
# If you do not want to override the value that was set when the service
|
|
8108
|
+
# was created, you can set this to `null` when performing this action.
|
|
8109
|
+
#
|
|
7810
8110
|
# @return [Types::UpdateServiceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
7811
8111
|
#
|
|
7812
8112
|
# * {Types::UpdateServiceResponse#service #service} => Types::Service
|
|
@@ -7882,6 +8182,7 @@ module Aws::ECS
|
|
|
7882
8182
|
# platform_version: "String",
|
|
7883
8183
|
# force_new_deployment: false,
|
|
7884
8184
|
# health_check_grace_period_seconds: 1,
|
|
8185
|
+
# enable_execute_command: false,
|
|
7885
8186
|
# })
|
|
7886
8187
|
#
|
|
7887
8188
|
# @example Response structure
|
|
@@ -7903,7 +8204,7 @@ module Aws::ECS
|
|
|
7903
8204
|
# resp.service.desired_count #=> Integer
|
|
7904
8205
|
# resp.service.running_count #=> Integer
|
|
7905
8206
|
# resp.service.pending_count #=> Integer
|
|
7906
|
-
# resp.service.launch_type #=> String, one of "EC2", "FARGATE"
|
|
8207
|
+
# resp.service.launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
|
|
7907
8208
|
# resp.service.capacity_provider_strategy #=> Array
|
|
7908
8209
|
# resp.service.capacity_provider_strategy[0].capacity_provider #=> String
|
|
7909
8210
|
# resp.service.capacity_provider_strategy[0].weight #=> Integer
|
|
@@ -7928,7 +8229,7 @@ module Aws::ECS
|
|
|
7928
8229
|
# resp.service.task_sets[0].running_count #=> Integer
|
|
7929
8230
|
# resp.service.task_sets[0].created_at #=> Time
|
|
7930
8231
|
# resp.service.task_sets[0].updated_at #=> Time
|
|
7931
|
-
# resp.service.task_sets[0].launch_type #=> String, one of "EC2", "FARGATE"
|
|
8232
|
+
# resp.service.task_sets[0].launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
|
|
7932
8233
|
# resp.service.task_sets[0].capacity_provider_strategy #=> Array
|
|
7933
8234
|
# resp.service.task_sets[0].capacity_provider_strategy[0].capacity_provider #=> String
|
|
7934
8235
|
# resp.service.task_sets[0].capacity_provider_strategy[0].weight #=> Integer
|
|
@@ -7970,7 +8271,7 @@ module Aws::ECS
|
|
|
7970
8271
|
# resp.service.deployments[0].capacity_provider_strategy[0].capacity_provider #=> String
|
|
7971
8272
|
# resp.service.deployments[0].capacity_provider_strategy[0].weight #=> Integer
|
|
7972
8273
|
# resp.service.deployments[0].capacity_provider_strategy[0].base #=> Integer
|
|
7973
|
-
# resp.service.deployments[0].launch_type #=> String, one of "EC2", "FARGATE"
|
|
8274
|
+
# resp.service.deployments[0].launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
|
|
7974
8275
|
# resp.service.deployments[0].platform_version #=> String
|
|
7975
8276
|
# resp.service.deployments[0].network_configuration.awsvpc_configuration.subnets #=> Array
|
|
7976
8277
|
# resp.service.deployments[0].network_configuration.awsvpc_configuration.subnets[0] #=> String
|
|
@@ -8005,6 +8306,7 @@ module Aws::ECS
|
|
|
8005
8306
|
# resp.service.created_by #=> String
|
|
8006
8307
|
# resp.service.enable_ecs_managed_tags #=> Boolean
|
|
8007
8308
|
# resp.service.propagate_tags #=> String, one of "TASK_DEFINITION", "SERVICE"
|
|
8309
|
+
# resp.service.enable_execute_command #=> Boolean
|
|
8008
8310
|
#
|
|
8009
8311
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/UpdateService AWS API Documentation
|
|
8010
8312
|
#
|
|
@@ -8065,7 +8367,7 @@ module Aws::ECS
|
|
|
8065
8367
|
# resp.task_set.running_count #=> Integer
|
|
8066
8368
|
# resp.task_set.created_at #=> Time
|
|
8067
8369
|
# resp.task_set.updated_at #=> Time
|
|
8068
|
-
# resp.task_set.launch_type #=> String, one of "EC2", "FARGATE"
|
|
8370
|
+
# resp.task_set.launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
|
|
8069
8371
|
# resp.task_set.capacity_provider_strategy #=> Array
|
|
8070
8372
|
# resp.task_set.capacity_provider_strategy[0].capacity_provider #=> String
|
|
8071
8373
|
# resp.task_set.capacity_provider_strategy[0].weight #=> Integer
|
|
@@ -8159,7 +8461,7 @@ module Aws::ECS
|
|
|
8159
8461
|
# resp.task_set.running_count #=> Integer
|
|
8160
8462
|
# resp.task_set.created_at #=> Time
|
|
8161
8463
|
# resp.task_set.updated_at #=> Time
|
|
8162
|
-
# resp.task_set.launch_type #=> String, one of "EC2", "FARGATE"
|
|
8464
|
+
# resp.task_set.launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
|
|
8163
8465
|
# resp.task_set.capacity_provider_strategy #=> Array
|
|
8164
8466
|
# resp.task_set.capacity_provider_strategy[0].capacity_provider #=> String
|
|
8165
8467
|
# resp.task_set.capacity_provider_strategy[0].weight #=> Integer
|
|
@@ -8210,7 +8512,7 @@ module Aws::ECS
|
|
|
8210
8512
|
params: params,
|
|
8211
8513
|
config: config)
|
|
8212
8514
|
context[:gem_name] = 'aws-sdk-ecs'
|
|
8213
|
-
context[:gem_version] = '1.
|
|
8515
|
+
context[:gem_version] = '1.79.0'
|
|
8214
8516
|
Seahorse::Client::Request.new(handlers, context)
|
|
8215
8517
|
end
|
|
8216
8518
|
|