aws-sdk-ecs 1.74.0 → 1.79.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG.md +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
|
|