aws-sdk-ecs 1.4.0 → 1.5.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/lib/aws-sdk-ecs.rb +1 -1
- data/lib/aws-sdk-ecs/client.rb +360 -138
- data/lib/aws-sdk-ecs/client_api.rb +74 -0
- data/lib/aws-sdk-ecs/types.rb +724 -271
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA1:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 74ae1f26ecb159663820d5c11a94efae1d8a3fbb
|
4
|
+
data.tar.gz: e936d9c1094a91d52ecf88487e926b736b3fa18b
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: df9b816393b140c06f4afcb5a0768bd7239dfe02f0c258c44ebfd2d9a467168727bf18e7fa7bd08a84baac6f70dfb1907ef0a752f3569e56f2361629b27153fb
|
7
|
+
data.tar.gz: 694c9f7577d3265fd1969d60e95d1059a1aeac3b82a86e0805bf581a351d97950e66aa64561f25b294bd4491b364545f1537676367c93984a70366144d7eba60
|
data/lib/aws-sdk-ecs.rb
CHANGED
data/lib/aws-sdk-ecs/client.rb
CHANGED
@@ -166,13 +166,13 @@ module Aws::ECS
|
|
166
166
|
# However, if the IAM user that makes the call does not have permissions
|
167
167
|
# to create the service-linked role, it is not created. For more
|
168
168
|
# information, see [Using Service-Linked Roles for Amazon ECS][1] in the
|
169
|
-
# *Amazon
|
169
|
+
# *Amazon Elastic Container Service Developer Guide*.
|
170
170
|
#
|
171
171
|
# </note>
|
172
172
|
#
|
173
173
|
#
|
174
174
|
#
|
175
|
-
# [1]: http://docs.aws.amazon.com/AmazonECS/latest/
|
175
|
+
# [1]: http://docs.aws.amazon.com/AmazonECS/latest/developerguide/using-service-linked-roles.html
|
176
176
|
#
|
177
177
|
# @option params [String] :cluster_name
|
178
178
|
# The name of your cluster. If you do not specify a name for your
|
@@ -221,6 +221,9 @@ module Aws::ECS
|
|
221
221
|
# resp.cluster.running_tasks_count #=> Integer
|
222
222
|
# resp.cluster.pending_tasks_count #=> Integer
|
223
223
|
# resp.cluster.active_services_count #=> Integer
|
224
|
+
# resp.cluster.statistics #=> Array
|
225
|
+
# resp.cluster.statistics[0].name #=> String
|
226
|
+
# resp.cluster.statistics[0].value #=> String
|
224
227
|
#
|
225
228
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/CreateCluster AWS API Documentation
|
226
229
|
#
|
@@ -240,13 +243,14 @@ module Aws::ECS
|
|
240
243
|
# you can optionally run your service behind a load balancer. The load
|
241
244
|
# balancer distributes traffic across the tasks that are associated with
|
242
245
|
# the service. For more information, see [Service Load Balancing][1] in
|
243
|
-
# the *Amazon
|
246
|
+
# the *Amazon Elastic Container Service Developer Guide*.
|
244
247
|
#
|
245
248
|
# You can optionally specify a deployment configuration for your
|
246
|
-
# service. During a deployment
|
247
|
-
#
|
248
|
-
#
|
249
|
-
#
|
249
|
+
# service. During a deployment, the service scheduler uses the
|
250
|
+
# `minimumHealthyPercent` and `maximumPercent` parameters to determine
|
251
|
+
# the deployment strategy. The deployment is triggered by changing the
|
252
|
+
# task definition or the desired count of a service with an
|
253
|
+
# UpdateService operation.
|
250
254
|
#
|
251
255
|
# The `minimumHealthyPercent` represents a lower limit on the number of
|
252
256
|
# your service's tasks that must remain in the `RUNNING` state during a
|
@@ -313,9 +317,9 @@ module Aws::ECS
|
|
313
317
|
# multiple clusters within a region or across multiple regions.
|
314
318
|
#
|
315
319
|
# @option params [required, String] :task_definition
|
316
|
-
# The `family` and `revision` (`family:revision`) or full
|
317
|
-
#
|
318
|
-
#
|
320
|
+
# The `family` and `revision` (`family:revision`) or full ARN of the
|
321
|
+
# task definition to run in your service. If a `revision` is not
|
322
|
+
# specified, the latest `ACTIVE` revision is used.
|
319
323
|
#
|
320
324
|
# @option params [Array<Types::LoadBalancer>] :load_balancers
|
321
325
|
# A load balancer object representing the load balancer to use with your
|
@@ -345,6 +349,13 @@ module Aws::ECS
|
|
345
349
|
# Unique, case-sensitive identifier you provide to ensure the
|
346
350
|
# idempotency of the request. Up to 32 ASCII characters are allowed.
|
347
351
|
#
|
352
|
+
# @option params [String] :launch_type
|
353
|
+
# The launch type on which to run your service.
|
354
|
+
#
|
355
|
+
# @option params [String] :platform_version
|
356
|
+
# The platform version on which to run your service. If one is not
|
357
|
+
# specified, the latest version is used by default.
|
358
|
+
#
|
348
359
|
# @option params [String] :role
|
349
360
|
# The name or full Amazon Resource Name (ARN) of the IAM role that
|
350
361
|
# allows Amazon ECS to make calls to your load balancer on your behalf.
|
@@ -358,8 +369,8 @@ module Aws::ECS
|
|
358
369
|
# a role here. The service-linked role is required if your task
|
359
370
|
# definition uses the `awsvpc` network mode, in which case you should
|
360
371
|
# not specify a role here. For more information, see [Using
|
361
|
-
# Service-Linked Roles for Amazon ECS][1] in the *Amazon
|
362
|
-
# Service Developer Guide*.
|
372
|
+
# Service-Linked Roles for Amazon ECS][1] in the *Amazon Elastic
|
373
|
+
# Container Service Developer Guide*.
|
363
374
|
#
|
364
375
|
# If your specified role has a path other than `/`, then you must either
|
365
376
|
# specify the full role ARN (this is recommended) or prefix the role
|
@@ -370,7 +381,7 @@ module Aws::ECS
|
|
370
381
|
#
|
371
382
|
#
|
372
383
|
#
|
373
|
-
# [1]: http://docs.aws.amazon.com/AmazonECS/latest/
|
384
|
+
# [1]: http://docs.aws.amazon.com/AmazonECS/latest/developerguide/using-service-linked-roles.html
|
374
385
|
# [2]: http://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-friendly-names
|
375
386
|
#
|
376
387
|
# @option params [Types::DeploymentConfiguration] :deployment_configuration
|
@@ -385,18 +396,18 @@ module Aws::ECS
|
|
385
396
|
#
|
386
397
|
# @option params [Array<Types::PlacementStrategy>] :placement_strategy
|
387
398
|
# The placement strategy objects to use for tasks in your service. You
|
388
|
-
# can specify a maximum of
|
399
|
+
# can specify a maximum of five strategy rules per service.
|
389
400
|
#
|
390
401
|
# @option params [Types::NetworkConfiguration] :network_configuration
|
391
402
|
# The network configuration for the service. This parameter is required
|
392
403
|
# for task definitions that use the `awsvpc` network mode to receive
|
393
404
|
# their own Elastic Network Interface, and it is not supported for other
|
394
405
|
# network modes. For more information, see [Task Networking][1] in the
|
395
|
-
# *Amazon
|
406
|
+
# *Amazon Elastic Container Service Developer Guide*.
|
396
407
|
#
|
397
408
|
#
|
398
409
|
#
|
399
|
-
# [1]: http://docs.aws.amazon.com/AmazonECS/latest/
|
410
|
+
# [1]: http://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-networking.html
|
400
411
|
#
|
401
412
|
# @return [Types::CreateServiceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
402
413
|
#
|
@@ -536,6 +547,8 @@ module Aws::ECS
|
|
536
547
|
# ],
|
537
548
|
# desired_count: 1, # required
|
538
549
|
# client_token: "String",
|
550
|
+
# launch_type: "EC2", # accepts EC2, FARGATE
|
551
|
+
# platform_version: "String",
|
539
552
|
# role: "String",
|
540
553
|
# deployment_configuration: {
|
541
554
|
# maximum_percent: 1,
|
@@ -557,6 +570,7 @@ module Aws::ECS
|
|
557
570
|
# awsvpc_configuration: {
|
558
571
|
# subnets: ["String"], # required
|
559
572
|
# security_groups: ["String"],
|
573
|
+
# assign_public_ip: "ENABLED", # accepts ENABLED, DISABLED
|
560
574
|
# },
|
561
575
|
# },
|
562
576
|
# })
|
@@ -575,6 +589,8 @@ module Aws::ECS
|
|
575
589
|
# resp.service.desired_count #=> Integer
|
576
590
|
# resp.service.running_count #=> Integer
|
577
591
|
# resp.service.pending_count #=> Integer
|
592
|
+
# resp.service.launch_type #=> String, one of "EC2", "FARGATE"
|
593
|
+
# resp.service.platform_version #=> String
|
578
594
|
# resp.service.task_definition #=> String
|
579
595
|
# resp.service.deployment_configuration.maximum_percent #=> Integer
|
580
596
|
# resp.service.deployment_configuration.minimum_healthy_percent #=> Integer
|
@@ -587,10 +603,13 @@ module Aws::ECS
|
|
587
603
|
# resp.service.deployments[0].running_count #=> Integer
|
588
604
|
# resp.service.deployments[0].created_at #=> Time
|
589
605
|
# resp.service.deployments[0].updated_at #=> Time
|
606
|
+
# resp.service.deployments[0].launch_type #=> String, one of "EC2", "FARGATE"
|
607
|
+
# resp.service.deployments[0].platform_version #=> String
|
590
608
|
# resp.service.deployments[0].network_configuration.awsvpc_configuration.subnets #=> Array
|
591
609
|
# resp.service.deployments[0].network_configuration.awsvpc_configuration.subnets[0] #=> String
|
592
610
|
# resp.service.deployments[0].network_configuration.awsvpc_configuration.security_groups #=> Array
|
593
611
|
# resp.service.deployments[0].network_configuration.awsvpc_configuration.security_groups[0] #=> String
|
612
|
+
# resp.service.deployments[0].network_configuration.awsvpc_configuration.assign_public_ip #=> String, one of "ENABLED", "DISABLED"
|
594
613
|
# resp.service.role_arn #=> String
|
595
614
|
# resp.service.events #=> Array
|
596
615
|
# resp.service.events[0].id #=> String
|
@@ -607,6 +626,7 @@ module Aws::ECS
|
|
607
626
|
# resp.service.network_configuration.awsvpc_configuration.subnets[0] #=> String
|
608
627
|
# resp.service.network_configuration.awsvpc_configuration.security_groups #=> Array
|
609
628
|
# resp.service.network_configuration.awsvpc_configuration.security_groups[0] #=> String
|
629
|
+
# resp.service.network_configuration.awsvpc_configuration.assign_public_ip #=> String, one of "ENABLED", "DISABLED"
|
610
630
|
#
|
611
631
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/CreateService AWS API Documentation
|
612
632
|
#
|
@@ -715,6 +735,9 @@ module Aws::ECS
|
|
715
735
|
# resp.cluster.running_tasks_count #=> Integer
|
716
736
|
# resp.cluster.pending_tasks_count #=> Integer
|
717
737
|
# resp.cluster.active_services_count #=> Integer
|
738
|
+
# resp.cluster.statistics #=> Array
|
739
|
+
# resp.cluster.statistics[0].name #=> String
|
740
|
+
# resp.cluster.statistics[0].value #=> String
|
718
741
|
#
|
719
742
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DeleteCluster AWS API Documentation
|
720
743
|
#
|
@@ -737,9 +760,9 @@ module Aws::ECS
|
|
737
760
|
# API operations. After the tasks have stopped, then the service status
|
738
761
|
# moves from `DRAINING` to `INACTIVE`. Services in the `DRAINING` or
|
739
762
|
# `INACTIVE` status can still be viewed with DescribeServices API
|
740
|
-
# operations
|
763
|
+
# operations. However, in the future, `INACTIVE` services may be cleaned
|
741
764
|
# up and purged from Amazon ECS record keeping, and DescribeServices API
|
742
|
-
# operations on those services
|
765
|
+
# operations on those services return a `ServiceNotFoundException`
|
743
766
|
# error.
|
744
767
|
#
|
745
768
|
# </note>
|
@@ -791,6 +814,8 @@ module Aws::ECS
|
|
791
814
|
# resp.service.desired_count #=> Integer
|
792
815
|
# resp.service.running_count #=> Integer
|
793
816
|
# resp.service.pending_count #=> Integer
|
817
|
+
# resp.service.launch_type #=> String, one of "EC2", "FARGATE"
|
818
|
+
# resp.service.platform_version #=> String
|
794
819
|
# resp.service.task_definition #=> String
|
795
820
|
# resp.service.deployment_configuration.maximum_percent #=> Integer
|
796
821
|
# resp.service.deployment_configuration.minimum_healthy_percent #=> Integer
|
@@ -803,10 +828,13 @@ module Aws::ECS
|
|
803
828
|
# resp.service.deployments[0].running_count #=> Integer
|
804
829
|
# resp.service.deployments[0].created_at #=> Time
|
805
830
|
# resp.service.deployments[0].updated_at #=> Time
|
831
|
+
# resp.service.deployments[0].launch_type #=> String, one of "EC2", "FARGATE"
|
832
|
+
# resp.service.deployments[0].platform_version #=> String
|
806
833
|
# resp.service.deployments[0].network_configuration.awsvpc_configuration.subnets #=> Array
|
807
834
|
# resp.service.deployments[0].network_configuration.awsvpc_configuration.subnets[0] #=> String
|
808
835
|
# resp.service.deployments[0].network_configuration.awsvpc_configuration.security_groups #=> Array
|
809
836
|
# resp.service.deployments[0].network_configuration.awsvpc_configuration.security_groups[0] #=> String
|
837
|
+
# resp.service.deployments[0].network_configuration.awsvpc_configuration.assign_public_ip #=> String, one of "ENABLED", "DISABLED"
|
810
838
|
# resp.service.role_arn #=> String
|
811
839
|
# resp.service.events #=> Array
|
812
840
|
# resp.service.events[0].id #=> String
|
@@ -823,6 +851,7 @@ module Aws::ECS
|
|
823
851
|
# resp.service.network_configuration.awsvpc_configuration.subnets[0] #=> String
|
824
852
|
# resp.service.network_configuration.awsvpc_configuration.security_groups #=> Array
|
825
853
|
# resp.service.network_configuration.awsvpc_configuration.security_groups[0] #=> String
|
854
|
+
# resp.service.network_configuration.awsvpc_configuration.assign_public_ip #=> String, one of "ENABLED", "DISABLED"
|
826
855
|
#
|
827
856
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DeleteService AWS API Documentation
|
828
857
|
#
|
@@ -838,8 +867,8 @@ module Aws::ECS
|
|
838
867
|
#
|
839
868
|
# If you intend to use the container instance for some other purpose
|
840
869
|
# after deregistration, you should stop all of the tasks running on the
|
841
|
-
# container instance before deregistration
|
842
|
-
# from consuming resources.
|
870
|
+
# container instance before deregistration. That prevents any orphaned
|
871
|
+
# tasks from consuming resources.
|
843
872
|
#
|
844
873
|
# Deregistering a container instance removes the instance from a
|
845
874
|
# cluster, but it does not terminate the EC2 instance; if you are
|
@@ -859,11 +888,11 @@ module Aws::ECS
|
|
859
888
|
# cluster, the default cluster is assumed.
|
860
889
|
#
|
861
890
|
# @option params [required, String] :container_instance
|
862
|
-
# The container instance ID or full
|
863
|
-
#
|
864
|
-
#
|
865
|
-
#
|
866
|
-
#
|
891
|
+
# The container instance ID or full ARN of the container instance to
|
892
|
+
# deregister. The ARN contains the `arn:aws:ecs` namespace, followed by
|
893
|
+
# the region of the container instance, the AWS account ID of the
|
894
|
+
# container instance owner, the `container-instance` namespace, and then
|
895
|
+
# the container instance ID. For example,
|
867
896
|
# `arn:aws:ecs:region:aws_account_id:container-instance/container_instance_ID
|
868
897
|
# `.
|
869
898
|
#
|
@@ -879,8 +908,8 @@ module Aws::ECS
|
|
879
908
|
#
|
880
909
|
# Any containers in orphaned service tasks that are registered with a
|
881
910
|
# Classic Load Balancer or an Application Load Balancer target group are
|
882
|
-
# deregistered
|
883
|
-
#
|
911
|
+
# deregistered. They begin connection draining according to the settings
|
912
|
+
# on the load balancer or target group.
|
884
913
|
#
|
885
914
|
# @return [Types::DeregisterContainerInstanceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
886
915
|
#
|
@@ -972,13 +1001,13 @@ module Aws::ECS
|
|
972
1001
|
# You cannot use an `INACTIVE` task definition to run new tasks or
|
973
1002
|
# create new services, and you cannot update an existing service to
|
974
1003
|
# reference an `INACTIVE` task definition (although there may be up to a
|
975
|
-
# 10
|
1004
|
+
# 10-minute window following deregistration where these restrictions
|
976
1005
|
# have not yet taken effect).
|
977
1006
|
#
|
978
1007
|
# <note markdown="1"> At this time, `INACTIVE` task definitions remain discoverable in your
|
979
1008
|
# account indefinitely; however, this behavior is subject to change in
|
980
1009
|
# the future, so you should not rely on `INACTIVE` task definitions
|
981
|
-
# persisting beyond the
|
1010
|
+
# persisting beyond the lifecycle of any associated tasks and services.
|
982
1011
|
#
|
983
1012
|
# </note>
|
984
1013
|
#
|
@@ -1063,6 +1092,7 @@ module Aws::ECS
|
|
1063
1092
|
# resp.task_definition.container_definitions[0].log_configuration.options["String"] #=> String
|
1064
1093
|
# resp.task_definition.family #=> String
|
1065
1094
|
# resp.task_definition.task_role_arn #=> String
|
1095
|
+
# resp.task_definition.execution_role_arn #=> String
|
1066
1096
|
# resp.task_definition.network_mode #=> String, one of "bridge", "host", "awsvpc", "none"
|
1067
1097
|
# resp.task_definition.revision #=> Integer
|
1068
1098
|
# resp.task_definition.volumes #=> Array
|
@@ -1077,6 +1107,12 @@ module Aws::ECS
|
|
1077
1107
|
# resp.task_definition.placement_constraints #=> Array
|
1078
1108
|
# resp.task_definition.placement_constraints[0].type #=> String, one of "memberOf"
|
1079
1109
|
# resp.task_definition.placement_constraints[0].expression #=> String
|
1110
|
+
# resp.task_definition.compatibilities #=> Array
|
1111
|
+
# resp.task_definition.compatibilities[0] #=> String, one of "EC2", "FARGATE"
|
1112
|
+
# resp.task_definition.requires_compatibilities #=> Array
|
1113
|
+
# resp.task_definition.requires_compatibilities[0] #=> String, one of "EC2", "FARGATE"
|
1114
|
+
# resp.task_definition.cpu #=> String
|
1115
|
+
# resp.task_definition.memory #=> String
|
1080
1116
|
#
|
1081
1117
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DeregisterTaskDefinition AWS API Documentation
|
1082
1118
|
#
|
@@ -1094,6 +1130,26 @@ module Aws::ECS
|
|
1094
1130
|
# (ARN) entries. If you do not specify a cluster, the default cluster is
|
1095
1131
|
# assumed.
|
1096
1132
|
#
|
1133
|
+
# @option params [Array<String>] :include
|
1134
|
+
# Additional information about your clusters to be separated by launch
|
1135
|
+
# type, including:
|
1136
|
+
#
|
1137
|
+
# * runningEC2TasksCount
|
1138
|
+
#
|
1139
|
+
# * RunningFargateTasksCount
|
1140
|
+
#
|
1141
|
+
# * pendingEC2TasksCount
|
1142
|
+
#
|
1143
|
+
# * pendingFargateTasksCount
|
1144
|
+
#
|
1145
|
+
# * activeEC2ServiceCount
|
1146
|
+
#
|
1147
|
+
# * activeFargateServiceCount
|
1148
|
+
#
|
1149
|
+
# * drainingEC2ServiceCount
|
1150
|
+
#
|
1151
|
+
# * drainingFargateServiceCount
|
1152
|
+
#
|
1097
1153
|
# @return [Types::DescribeClustersResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1098
1154
|
#
|
1099
1155
|
# * {Types::DescribeClustersResponse#clusters #clusters} => Array<Types::Cluster>
|
@@ -1127,6 +1183,7 @@ module Aws::ECS
|
|
1127
1183
|
#
|
1128
1184
|
# resp = client.describe_clusters({
|
1129
1185
|
# clusters: ["String"],
|
1186
|
+
# include: ["STATISTICS"], # accepts STATISTICS
|
1130
1187
|
# })
|
1131
1188
|
#
|
1132
1189
|
# @example Response structure
|
@@ -1139,6 +1196,9 @@ module Aws::ECS
|
|
1139
1196
|
# resp.clusters[0].running_tasks_count #=> Integer
|
1140
1197
|
# resp.clusters[0].pending_tasks_count #=> Integer
|
1141
1198
|
# resp.clusters[0].active_services_count #=> Integer
|
1199
|
+
# resp.clusters[0].statistics #=> Array
|
1200
|
+
# resp.clusters[0].statistics[0].name #=> String
|
1201
|
+
# resp.clusters[0].statistics[0].value #=> String
|
1142
1202
|
# resp.failures #=> Array
|
1143
1203
|
# resp.failures[0].arn #=> String
|
1144
1204
|
# resp.failures[0].reason #=> String
|
@@ -1152,9 +1212,9 @@ module Aws::ECS
|
|
1152
1212
|
req.send_request(options)
|
1153
1213
|
end
|
1154
1214
|
|
1155
|
-
# Describes Amazon
|
1156
|
-
# metadata about registered and remaining resources on each
|
1157
|
-
# instance requested.
|
1215
|
+
# Describes Amazon Elastic Container Service container instances.
|
1216
|
+
# Returns metadata about registered and remaining resources on each
|
1217
|
+
# container instance requested.
|
1158
1218
|
#
|
1159
1219
|
# @option params [String] :cluster
|
1160
1220
|
# The short name or full Amazon Resource Name (ARN) of the cluster that
|
@@ -1162,8 +1222,7 @@ module Aws::ECS
|
|
1162
1222
|
# cluster, the default cluster is assumed.
|
1163
1223
|
#
|
1164
1224
|
# @option params [required, Array<String>] :container_instances
|
1165
|
-
# A list of container instance IDs or full
|
1166
|
-
# entries.
|
1225
|
+
# A list of container instance IDs or full ARN entries.
|
1167
1226
|
#
|
1168
1227
|
# @return [Types::DescribeContainerInstancesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1169
1228
|
#
|
@@ -1414,6 +1473,8 @@ module Aws::ECS
|
|
1414
1473
|
# resp.services[0].desired_count #=> Integer
|
1415
1474
|
# resp.services[0].running_count #=> Integer
|
1416
1475
|
# resp.services[0].pending_count #=> Integer
|
1476
|
+
# resp.services[0].launch_type #=> String, one of "EC2", "FARGATE"
|
1477
|
+
# resp.services[0].platform_version #=> String
|
1417
1478
|
# resp.services[0].task_definition #=> String
|
1418
1479
|
# resp.services[0].deployment_configuration.maximum_percent #=> Integer
|
1419
1480
|
# resp.services[0].deployment_configuration.minimum_healthy_percent #=> Integer
|
@@ -1426,10 +1487,13 @@ module Aws::ECS
|
|
1426
1487
|
# resp.services[0].deployments[0].running_count #=> Integer
|
1427
1488
|
# resp.services[0].deployments[0].created_at #=> Time
|
1428
1489
|
# resp.services[0].deployments[0].updated_at #=> Time
|
1490
|
+
# resp.services[0].deployments[0].launch_type #=> String, one of "EC2", "FARGATE"
|
1491
|
+
# resp.services[0].deployments[0].platform_version #=> String
|
1429
1492
|
# resp.services[0].deployments[0].network_configuration.awsvpc_configuration.subnets #=> Array
|
1430
1493
|
# resp.services[0].deployments[0].network_configuration.awsvpc_configuration.subnets[0] #=> String
|
1431
1494
|
# resp.services[0].deployments[0].network_configuration.awsvpc_configuration.security_groups #=> Array
|
1432
1495
|
# resp.services[0].deployments[0].network_configuration.awsvpc_configuration.security_groups[0] #=> String
|
1496
|
+
# resp.services[0].deployments[0].network_configuration.awsvpc_configuration.assign_public_ip #=> String, one of "ENABLED", "DISABLED"
|
1433
1497
|
# resp.services[0].role_arn #=> String
|
1434
1498
|
# resp.services[0].events #=> Array
|
1435
1499
|
# resp.services[0].events[0].id #=> String
|
@@ -1446,6 +1510,7 @@ module Aws::ECS
|
|
1446
1510
|
# resp.services[0].network_configuration.awsvpc_configuration.subnets[0] #=> String
|
1447
1511
|
# resp.services[0].network_configuration.awsvpc_configuration.security_groups #=> Array
|
1448
1512
|
# resp.services[0].network_configuration.awsvpc_configuration.security_groups[0] #=> String
|
1513
|
+
# resp.services[0].network_configuration.awsvpc_configuration.assign_public_ip #=> String, one of "ENABLED", "DISABLED"
|
1449
1514
|
# resp.failures #=> Array
|
1450
1515
|
# resp.failures[0].arn #=> String
|
1451
1516
|
# resp.failures[0].reason #=> String
|
@@ -1613,6 +1678,7 @@ module Aws::ECS
|
|
1613
1678
|
# resp.task_definition.container_definitions[0].log_configuration.options["String"] #=> String
|
1614
1679
|
# resp.task_definition.family #=> String
|
1615
1680
|
# resp.task_definition.task_role_arn #=> String
|
1681
|
+
# resp.task_definition.execution_role_arn #=> String
|
1616
1682
|
# resp.task_definition.network_mode #=> String, one of "bridge", "host", "awsvpc", "none"
|
1617
1683
|
# resp.task_definition.revision #=> Integer
|
1618
1684
|
# resp.task_definition.volumes #=> Array
|
@@ -1627,6 +1693,12 @@ module Aws::ECS
|
|
1627
1693
|
# resp.task_definition.placement_constraints #=> Array
|
1628
1694
|
# resp.task_definition.placement_constraints[0].type #=> String, one of "memberOf"
|
1629
1695
|
# resp.task_definition.placement_constraints[0].expression #=> String
|
1696
|
+
# resp.task_definition.compatibilities #=> Array
|
1697
|
+
# resp.task_definition.compatibilities[0] #=> String, one of "EC2", "FARGATE"
|
1698
|
+
# resp.task_definition.requires_compatibilities #=> Array
|
1699
|
+
# resp.task_definition.requires_compatibilities[0] #=> String, one of "EC2", "FARGATE"
|
1700
|
+
# resp.task_definition.cpu #=> String
|
1701
|
+
# resp.task_definition.memory #=> String
|
1630
1702
|
#
|
1631
1703
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DescribeTaskDefinition AWS API Documentation
|
1632
1704
|
#
|
@@ -1645,8 +1717,7 @@ module Aws::ECS
|
|
1645
1717
|
# default cluster is assumed.
|
1646
1718
|
#
|
1647
1719
|
# @option params [required, Array<String>] :tasks
|
1648
|
-
# A list of up to 100 task IDs or full
|
1649
|
-
# entries.
|
1720
|
+
# A list of up to 100 task IDs or full ARN entries.
|
1650
1721
|
#
|
1651
1722
|
# @return [Types::DescribeTasksResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1652
1723
|
#
|
@@ -1728,8 +1799,11 @@ module Aws::ECS
|
|
1728
1799
|
# resp.tasks[0].overrides.container_overrides[0].memory #=> Integer
|
1729
1800
|
# resp.tasks[0].overrides.container_overrides[0].memory_reservation #=> Integer
|
1730
1801
|
# resp.tasks[0].overrides.task_role_arn #=> String
|
1802
|
+
# resp.tasks[0].overrides.execution_role_arn #=> String
|
1731
1803
|
# resp.tasks[0].last_status #=> String
|
1732
1804
|
# resp.tasks[0].desired_status #=> String
|
1805
|
+
# resp.tasks[0].cpu #=> String
|
1806
|
+
# resp.tasks[0].memory #=> String
|
1733
1807
|
# resp.tasks[0].containers #=> Array
|
1734
1808
|
# resp.tasks[0].containers[0].container_arn #=> String
|
1735
1809
|
# resp.tasks[0].containers[0].task_arn #=> String
|
@@ -1749,10 +1823,18 @@ module Aws::ECS
|
|
1749
1823
|
# resp.tasks[0].started_by #=> String
|
1750
1824
|
# resp.tasks[0].version #=> Integer
|
1751
1825
|
# resp.tasks[0].stopped_reason #=> String
|
1826
|
+
# resp.tasks[0].connectivity #=> String, one of "CONNECTED", "DISCONNECTED"
|
1827
|
+
# resp.tasks[0].connectivity_at #=> Time
|
1828
|
+
# resp.tasks[0].pull_started_at #=> Time
|
1829
|
+
# resp.tasks[0].pull_stopped_at #=> Time
|
1830
|
+
# resp.tasks[0].execution_stopped_at #=> Time
|
1752
1831
|
# resp.tasks[0].created_at #=> Time
|
1753
1832
|
# resp.tasks[0].started_at #=> Time
|
1833
|
+
# resp.tasks[0].stopping_at #=> Time
|
1754
1834
|
# resp.tasks[0].stopped_at #=> Time
|
1755
1835
|
# resp.tasks[0].group #=> String
|
1836
|
+
# resp.tasks[0].launch_type #=> String, one of "EC2", "FARGATE"
|
1837
|
+
# resp.tasks[0].platform_version #=> String
|
1756
1838
|
# resp.tasks[0].attachments #=> Array
|
1757
1839
|
# resp.tasks[0].attachments[0].id #=> String
|
1758
1840
|
# resp.tasks[0].attachments[0].type #=> String
|
@@ -1773,20 +1855,19 @@ module Aws::ECS
|
|
1773
1855
|
req.send_request(options)
|
1774
1856
|
end
|
1775
1857
|
|
1776
|
-
# <note markdown="1"> This action is only used by the Amazon
|
1777
|
-
#
|
1858
|
+
# <note markdown="1"> This action is only used by the Amazon ECS agent, and it is not
|
1859
|
+
# intended for use outside of the agent.
|
1778
1860
|
#
|
1779
1861
|
# </note>
|
1780
1862
|
#
|
1781
|
-
# Returns an endpoint for the Amazon
|
1782
|
-
# for updates.
|
1863
|
+
# Returns an endpoint for the Amazon ECS agent to poll for updates.
|
1783
1864
|
#
|
1784
1865
|
# @option params [String] :container_instance
|
1785
|
-
# The container instance ID or full
|
1786
|
-
#
|
1787
|
-
#
|
1788
|
-
#
|
1789
|
-
#
|
1866
|
+
# The container instance ID or full ARN of the container instance. The
|
1867
|
+
# ARN contains the `arn:aws:ecs` namespace, followed by the region of
|
1868
|
+
# the container instance, the AWS account ID of the container instance
|
1869
|
+
# owner, the `container-instance` namespace, and then the container
|
1870
|
+
# instance ID. For example,
|
1790
1871
|
# `arn:aws:ecs:region:aws_account_id:container-instance/container_instance_ID
|
1791
1872
|
# `.
|
1792
1873
|
#
|
@@ -1848,8 +1929,7 @@ module Aws::ECS
|
|
1848
1929
|
# The `nextToken` value returned from a previous paginated
|
1849
1930
|
# `ListAttributes` request where `maxResults` was used and the results
|
1850
1931
|
# exceeded the value of that parameter. Pagination continues from the
|
1851
|
-
# end of the previous results that returned the `nextToken` value.
|
1852
|
-
# value is `null` when there are no more results to return.
|
1932
|
+
# end of the previous results that returned the `nextToken` value.
|
1853
1933
|
#
|
1854
1934
|
# <note markdown="1"> This token should be treated as an opaque identifier that is only used
|
1855
1935
|
# to retrieve the next items in a list and not for other programmatic
|
@@ -1907,8 +1987,7 @@ module Aws::ECS
|
|
1907
1987
|
# The `nextToken` value returned from a previous paginated
|
1908
1988
|
# `ListClusters` request where `maxResults` was used and the results
|
1909
1989
|
# exceeded the value of that parameter. Pagination continues from the
|
1910
|
-
# end of the previous results that returned the `nextToken` value.
|
1911
|
-
# value is `null` when there are no more results to return.
|
1990
|
+
# end of the previous results that returned the `nextToken` value.
|
1912
1991
|
#
|
1913
1992
|
# <note markdown="1"> This token should be treated as an opaque identifier that is only used
|
1914
1993
|
# to retrieve the next items in a list and not for other programmatic
|
@@ -1972,8 +2051,8 @@ module Aws::ECS
|
|
1972
2051
|
# Returns a list of container instances in a specified cluster. You can
|
1973
2052
|
# filter the results of a `ListContainerInstances` operation with
|
1974
2053
|
# cluster query language statements inside the `filter` parameter. For
|
1975
|
-
# more information, see [Cluster Query Language][1] in the *Amazon
|
1976
|
-
# Container Service Developer Guide*.
|
2054
|
+
# more information, see [Cluster Query Language][1] in the *Amazon
|
2055
|
+
# Elastic Container Service Developer Guide*.
|
1977
2056
|
#
|
1978
2057
|
#
|
1979
2058
|
#
|
@@ -1987,7 +2066,7 @@ module Aws::ECS
|
|
1987
2066
|
# @option params [String] :filter
|
1988
2067
|
# You can filter the results of a `ListContainerInstances` operation
|
1989
2068
|
# with cluster query language statements. For more information, see
|
1990
|
-
# [Cluster Query Language][1] in the *Amazon
|
2069
|
+
# [Cluster Query Language][1] in the *Amazon Elastic Container Service
|
1991
2070
|
# Developer Guide*.
|
1992
2071
|
#
|
1993
2072
|
#
|
@@ -1999,7 +2078,7 @@ module Aws::ECS
|
|
1999
2078
|
# `ListContainerInstances` request where `maxResults` was used and the
|
2000
2079
|
# results exceeded the value of that parameter. Pagination continues
|
2001
2080
|
# from the end of the previous results that returned the `nextToken`
|
2002
|
-
# value.
|
2081
|
+
# value.
|
2003
2082
|
#
|
2004
2083
|
# <note markdown="1"> This token should be treated as an opaque identifier that is only used
|
2005
2084
|
# to retrieve the next items in a list and not for other programmatic
|
@@ -2083,8 +2162,7 @@ module Aws::ECS
|
|
2083
2162
|
# The `nextToken` value returned from a previous paginated
|
2084
2163
|
# `ListServices` request where `maxResults` was used and the results
|
2085
2164
|
# exceeded the value of that parameter. Pagination continues from the
|
2086
|
-
# end of the previous results that returned the `nextToken` value.
|
2087
|
-
# value is `null` when there are no more results to return.
|
2165
|
+
# end of the previous results that returned the `nextToken` value.
|
2088
2166
|
#
|
2089
2167
|
# <note markdown="1"> This token should be treated as an opaque identifier that is only used
|
2090
2168
|
# to retrieve the next items in a list and not for other programmatic
|
@@ -2102,6 +2180,9 @@ module Aws::ECS
|
|
2102
2180
|
# parameter is not used, then `ListServices` returns up to 10 results
|
2103
2181
|
# and a `nextToken` value if applicable.
|
2104
2182
|
#
|
2183
|
+
# @option params [String] :launch_type
|
2184
|
+
# The launch type for services you want to list.
|
2185
|
+
#
|
2105
2186
|
# @return [Types::ListServicesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2106
2187
|
#
|
2107
2188
|
# * {Types::ListServicesResponse#service_arns #service_arns} => Array<String>
|
@@ -2128,6 +2209,7 @@ module Aws::ECS
|
|
2128
2209
|
# cluster: "String",
|
2129
2210
|
# next_token: "String",
|
2130
2211
|
# max_results: 1,
|
2212
|
+
# launch_type: "EC2", # accepts EC2, FARGATE
|
2131
2213
|
# })
|
2132
2214
|
#
|
2133
2215
|
# @example Response structure
|
@@ -2176,7 +2258,7 @@ module Aws::ECS
|
|
2176
2258
|
# `ListTaskDefinitionFamilies` request where `maxResults` was used and
|
2177
2259
|
# the results exceeded the value of that parameter. Pagination continues
|
2178
2260
|
# from the end of the previous results that returned the `nextToken`
|
2179
|
-
# value.
|
2261
|
+
# value.
|
2180
2262
|
#
|
2181
2263
|
# <note markdown="1"> This token should be treated as an opaque identifier that is only used
|
2182
2264
|
# to retrieve the next items in a list and not for other programmatic
|
@@ -2290,7 +2372,7 @@ module Aws::ECS
|
|
2290
2372
|
# `ListTaskDefinitions` request where `maxResults` was used and the
|
2291
2373
|
# results exceeded the value of that parameter. Pagination continues
|
2292
2374
|
# from the end of the previous results that returned the `nextToken`
|
2293
|
-
# value.
|
2375
|
+
# value.
|
2294
2376
|
#
|
2295
2377
|
# <note markdown="1"> This token should be treated as an opaque identifier that is only used
|
2296
2378
|
# to retrieve the next items in a list and not for other programmatic
|
@@ -2382,7 +2464,7 @@ module Aws::ECS
|
|
2382
2464
|
# desired status of the task with the `family`, `containerInstance`, and
|
2383
2465
|
# `desiredStatus` parameters.
|
2384
2466
|
#
|
2385
|
-
# Recently
|
2467
|
+
# Recently stopped tasks might appear in the returned results.
|
2386
2468
|
# Currently, stopped tasks appear in the returned results for at least
|
2387
2469
|
# one hour.
|
2388
2470
|
#
|
@@ -2392,10 +2474,10 @@ module Aws::ECS
|
|
2392
2474
|
# cluster is assumed.
|
2393
2475
|
#
|
2394
2476
|
# @option params [String] :container_instance
|
2395
|
-
# The container instance ID or full
|
2396
|
-
#
|
2397
|
-
#
|
2398
|
-
#
|
2477
|
+
# The container instance ID or full ARN of the container instance with
|
2478
|
+
# which to filter the `ListTasks` results. Specifying a
|
2479
|
+
# `containerInstance` limits the results to tasks that belong to that
|
2480
|
+
# container instance.
|
2399
2481
|
#
|
2400
2482
|
# @option params [String] :family
|
2401
2483
|
# The name of the family with which to filter the `ListTasks` results.
|
@@ -2406,8 +2488,7 @@ module Aws::ECS
|
|
2406
2488
|
# The `nextToken` value returned from a previous paginated `ListTasks`
|
2407
2489
|
# request where `maxResults` was used and the results exceeded the value
|
2408
2490
|
# of that parameter. Pagination continues from the end of the previous
|
2409
|
-
# results that returned the `nextToken` value.
|
2410
|
-
# there are no more results to return.
|
2491
|
+
# results that returned the `nextToken` value.
|
2411
2492
|
#
|
2412
2493
|
# <note markdown="1"> This token should be treated as an opaque identifier that is only used
|
2413
2494
|
# to retrieve the next items in a list and not for other programmatic
|
@@ -2438,18 +2519,21 @@ module Aws::ECS
|
|
2438
2519
|
# @option params [String] :desired_status
|
2439
2520
|
# The task desired status with which to filter the `ListTasks` results.
|
2440
2521
|
# Specifying a `desiredStatus` of `STOPPED` limits the results to tasks
|
2441
|
-
# that ECS has set the desired status to `STOPPED`, which can be
|
2442
|
-
# for debugging tasks that are not starting properly or have died
|
2443
|
-
# finished. The default status filter is `RUNNING`, which shows tasks
|
2444
|
-
# that ECS has set the desired status to `RUNNING`.
|
2522
|
+
# that Amazon ECS has set the desired status to `STOPPED`, which can be
|
2523
|
+
# useful for debugging tasks that are not starting properly or have died
|
2524
|
+
# or finished. The default status filter is `RUNNING`, which shows tasks
|
2525
|
+
# that Amazon ECS has set the desired status to `RUNNING`.
|
2445
2526
|
#
|
2446
2527
|
# <note markdown="1"> Although you can filter results based on a desired status of
|
2447
|
-
# `PENDING`, this
|
2448
|
-
# desired status of a task to that value (only a task's
|
2449
|
-
# may have a value of `PENDING`).
|
2528
|
+
# `PENDING`, this does not return any results because Amazon ECS never
|
2529
|
+
# sets the desired status of a task to that value (only a task's
|
2530
|
+
# `lastStatus` may have a value of `PENDING`).
|
2450
2531
|
#
|
2451
2532
|
# </note>
|
2452
2533
|
#
|
2534
|
+
# @option params [String] :launch_type
|
2535
|
+
# The launch type for services you want to list.
|
2536
|
+
#
|
2453
2537
|
# @return [Types::ListTasksResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2454
2538
|
#
|
2455
2539
|
# * {Types::ListTasksResponse#task_arns #task_arns} => Array<String>
|
@@ -2500,6 +2584,7 @@ module Aws::ECS
|
|
2500
2584
|
# started_by: "String",
|
2501
2585
|
# service_name: "String",
|
2502
2586
|
# desired_status: "RUNNING", # accepts RUNNING, PENDING, STOPPED
|
2587
|
+
# launch_type: "EC2", # accepts EC2, FARGATE
|
2503
2588
|
# })
|
2504
2589
|
#
|
2505
2590
|
# @example Response structure
|
@@ -2521,7 +2606,7 @@ module Aws::ECS
|
|
2521
2606
|
# attribute does not exist, it is created. If the attribute exists, its
|
2522
2607
|
# value is replaced with the specified value. To delete an attribute,
|
2523
2608
|
# use DeleteAttributes. For more information, see [Attributes][1] in the
|
2524
|
-
# *Amazon
|
2609
|
+
# *Amazon Elastic Container Service Developer Guide*.
|
2525
2610
|
#
|
2526
2611
|
#
|
2527
2612
|
#
|
@@ -2572,8 +2657,8 @@ module Aws::ECS
|
|
2572
2657
|
req.send_request(options)
|
2573
2658
|
end
|
2574
2659
|
|
2575
|
-
# <note markdown="1"> This action is only used by the Amazon
|
2576
|
-
#
|
2660
|
+
# <note markdown="1"> This action is only used by the Amazon ECS agent, and it is not
|
2661
|
+
# intended for use outside of the agent.
|
2577
2662
|
#
|
2578
2663
|
# </note>
|
2579
2664
|
#
|
@@ -2605,8 +2690,7 @@ module Aws::ECS
|
|
2605
2690
|
# daemon running on the container instance.
|
2606
2691
|
#
|
2607
2692
|
# @option params [String] :container_instance_arn
|
2608
|
-
# The
|
2609
|
-
# previously registered).
|
2693
|
+
# The ARN of the container instance (if it was previously registered).
|
2610
2694
|
#
|
2611
2695
|
# @option params [Array<Types::Attribute>] :attributes
|
2612
2696
|
# The container instance attributes that this container instance
|
@@ -2704,25 +2788,32 @@ module Aws::ECS
|
|
2704
2788
|
# `containerDefinitions`. Optionally, you can add data volumes to your
|
2705
2789
|
# containers with the `volumes` parameter. For more information about
|
2706
2790
|
# task definition parameters and defaults, see [Amazon ECS Task
|
2707
|
-
# Definitions][1] in the *Amazon
|
2791
|
+
# Definitions][1] in the *Amazon Elastic Container Service Developer
|
2792
|
+
# Guide*.
|
2708
2793
|
#
|
2709
2794
|
# You can specify an IAM role for your task with the `taskRoleArn`
|
2710
2795
|
# parameter. When you specify an IAM role for a task, its containers can
|
2711
2796
|
# then use the latest versions of the AWS CLI or SDKs to make API
|
2712
2797
|
# requests to the AWS services that are specified in the IAM policy
|
2713
2798
|
# associated with the role. For more information, see [IAM Roles for
|
2714
|
-
# Tasks][2] in the *Amazon
|
2799
|
+
# Tasks][2] in the *Amazon Elastic Container Service Developer Guide*.
|
2715
2800
|
#
|
2716
2801
|
# You can specify a Docker networking mode for the containers in your
|
2717
2802
|
# task definition with the `networkMode` parameter. The available
|
2718
2803
|
# network modes correspond to those described in [Network settings][3]
|
2719
|
-
# in the Docker run reference.
|
2804
|
+
# in the Docker run reference. If you specify the `awsvpc` network mode,
|
2805
|
+
# the task is allocated an Elastic Network Interface, and you must
|
2806
|
+
# specify a NetworkConfiguration when you create a service or run a task
|
2807
|
+
# with the task definition. For more information, see [Task
|
2808
|
+
# Networking][4] in the *Amazon Elastic Container Service Developer
|
2809
|
+
# Guide*.
|
2720
2810
|
#
|
2721
2811
|
#
|
2722
2812
|
#
|
2723
2813
|
# [1]: http://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_defintions.html
|
2724
2814
|
# [2]: http://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-iam-roles.html
|
2725
2815
|
# [3]: https://docs.docker.com/engine/reference/run/#/network-settings
|
2816
|
+
# [4]: http://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-networking.html
|
2726
2817
|
#
|
2727
2818
|
# @option params [required, String] :family
|
2728
2819
|
# You must specify a `family` for a task definition, which allows you to
|
@@ -2734,35 +2825,42 @@ module Aws::ECS
|
|
2734
2825
|
# The short name or full Amazon Resource Name (ARN) of the IAM role that
|
2735
2826
|
# containers in this task can assume. All containers in this task are
|
2736
2827
|
# granted the permissions that are specified in this role. For more
|
2737
|
-
# information, see [IAM Roles for Tasks][1] in the *Amazon
|
2738
|
-
# Service Developer Guide*.
|
2828
|
+
# information, see [IAM Roles for Tasks][1] in the *Amazon Elastic
|
2829
|
+
# Container Service Developer Guide*.
|
2739
2830
|
#
|
2740
2831
|
#
|
2741
2832
|
#
|
2742
2833
|
# [1]: http://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-iam-roles.html
|
2743
2834
|
#
|
2835
|
+
# @option params [String] :execution_role_arn
|
2836
|
+
# The Amazon Resource Name (ARN) of the task execution role that the
|
2837
|
+
# Amazon ECS container agent and the Docker daemon can assume.
|
2838
|
+
#
|
2744
2839
|
# @option params [String] :network_mode
|
2745
2840
|
# The Docker networking mode to use for the containers in the task. The
|
2746
2841
|
# valid values are `none`, `bridge`, `awsvpc`, and `host`. The default
|
2747
|
-
# Docker network mode is `bridge`. If the
|
2748
|
-
#
|
2749
|
-
#
|
2750
|
-
#
|
2751
|
-
#
|
2842
|
+
# Docker network mode is `bridge`. If using the Fargate launch type, the
|
2843
|
+
# `awsvpc` network mode is required. If using the EC2 launch type, any
|
2844
|
+
# network mode can be used. If the network mode is set to `none`, you
|
2845
|
+
# can't specify port mappings in your container definitions, and the
|
2846
|
+
# task's containers do not have external connectivity. The `host` and
|
2847
|
+
# `awsvpc` network modes offer the highest networking performance for
|
2848
|
+
# containers because they use the EC2 network stack instead of the
|
2752
2849
|
# virtualized network stack provided by the `bridge` mode.
|
2753
2850
|
#
|
2754
2851
|
# With the `host` and `awsvpc` network modes, exposed container ports
|
2755
2852
|
# are mapped directly to the corresponding host port (for the `host`
|
2756
|
-
# network mode) or the attached
|
2757
|
-
# mode), so you cannot take advantage of dynamic host
|
2853
|
+
# network mode) or the attached elastic network interface port (for the
|
2854
|
+
# `awsvpc` network mode), so you cannot take advantage of dynamic host
|
2855
|
+
# port mappings.
|
2758
2856
|
#
|
2759
2857
|
# If the network mode is `awsvpc`, the task is allocated an Elastic
|
2760
2858
|
# Network Interface, and you must specify a NetworkConfiguration when
|
2761
2859
|
# you create a service or run a task with the task definition. For more
|
2762
|
-
# information, see [Task Networking][1] in the *Amazon
|
2860
|
+
# information, see [Task Networking][1] in the *Amazon Elastic Container
|
2763
2861
|
# Service Developer Guide*.
|
2764
2862
|
#
|
2765
|
-
# If the network mode is `host`, you can
|
2863
|
+
# If the network mode is `host`, you can't run multiple instantiations
|
2766
2864
|
# of the same task on a single container instance when port mappings are
|
2767
2865
|
# used.
|
2768
2866
|
#
|
@@ -2771,7 +2869,7 @@ module Aws::ECS
|
|
2771
2869
|
#
|
2772
2870
|
#
|
2773
2871
|
#
|
2774
|
-
# [1]: http://docs.aws.amazon.com/AmazonECS/latest/
|
2872
|
+
# [1]: http://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-networking.html
|
2775
2873
|
# [2]: https://docs.docker.com/engine/reference/run/#network-settings
|
2776
2874
|
#
|
2777
2875
|
# @option params [required, Array<Types::ContainerDefinition>] :container_definitions
|
@@ -2787,6 +2885,50 @@ module Aws::ECS
|
|
2787
2885
|
# specify a maximum of 10 constraints per task (this limit includes
|
2788
2886
|
# constraints in the task definition and those specified at run time).
|
2789
2887
|
#
|
2888
|
+
# @option params [Array<String>] :requires_compatibilities
|
2889
|
+
# The launch type required by the task. If no value is specified, it
|
2890
|
+
# defaults to `EC2`.
|
2891
|
+
#
|
2892
|
+
# @option params [String] :cpu
|
2893
|
+
# The number of `cpu` units used by the task. If using the EC2 launch
|
2894
|
+
# type, this field is optional and any value can be used. If you are
|
2895
|
+
# using the Fargate launch type, this field is required and you must use
|
2896
|
+
# one of the following values, which determines your range of valid
|
2897
|
+
# values for the `memory` parameter:
|
2898
|
+
#
|
2899
|
+
# * 256 (.25 vCPU) - Available `memory` values: 512MB, 1GB, 2GB
|
2900
|
+
#
|
2901
|
+
# * 512 (.5 vCPU) - Available `memory` values: 1GB, 2GB, 3GB, 4GB
|
2902
|
+
#
|
2903
|
+
# * 1024 (1 vCPU) - Available `memory` values: 2GB, 3GB, 4GB, 5GB, 6GB,
|
2904
|
+
# 7GB, 8GB
|
2905
|
+
#
|
2906
|
+
# * 2048 (2 vCPU) - Available `memory` values: Between 4GB and 16GB in
|
2907
|
+
# 1GB increments
|
2908
|
+
#
|
2909
|
+
# * 4096 (4 vCPU) - Available `memory` values: Between 8GB and 30GB in
|
2910
|
+
# 1GB increments
|
2911
|
+
#
|
2912
|
+
# @option params [String] :memory
|
2913
|
+
# The amount (in MiB) of memory used by the task. If using the EC2
|
2914
|
+
# launch type, this field is optional and any value can be used. If you
|
2915
|
+
# are using the Fargate launch type, this field is required and you must
|
2916
|
+
# use one of the following values, which determines your range of valid
|
2917
|
+
# values for the `cpu` parameter:
|
2918
|
+
#
|
2919
|
+
# * 512MB, 1GB, 2GB - Available `cpu` values: 256 (.25 vCPU)
|
2920
|
+
#
|
2921
|
+
# * 1GB, 2GB, 3GB, 4GB - Available `cpu` values: 512 (.5 vCPU)
|
2922
|
+
#
|
2923
|
+
# * 2GB, 3GB, 4GB, 5GB, 6GB, 7GB, 8GB - Available `cpu` values: 1024 (1
|
2924
|
+
# vCPU)
|
2925
|
+
#
|
2926
|
+
# * Between 4GB and 16GB in 1GB increments - Available `cpu` values:
|
2927
|
+
# 2048 (2 vCPU)
|
2928
|
+
#
|
2929
|
+
# * Between 8GB and 30GB in 1GB increments - Available `cpu` values:
|
2930
|
+
# 4096 (4 vCPU)
|
2931
|
+
#
|
2790
2932
|
# @return [Types::RegisterTaskDefinitionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2791
2933
|
#
|
2792
2934
|
# * {Types::RegisterTaskDefinitionResponse#task_definition #task_definition} => Types::TaskDefinition
|
@@ -2853,6 +2995,7 @@ module Aws::ECS
|
|
2853
2995
|
# resp = client.register_task_definition({
|
2854
2996
|
# family: "String", # required
|
2855
2997
|
# task_role_arn: "String",
|
2998
|
+
# execution_role_arn: "String",
|
2856
2999
|
# network_mode: "bridge", # accepts bridge, host, awsvpc, none
|
2857
3000
|
# container_definitions: [ # required
|
2858
3001
|
# {
|
@@ -2952,6 +3095,9 @@ module Aws::ECS
|
|
2952
3095
|
# expression: "String",
|
2953
3096
|
# },
|
2954
3097
|
# ],
|
3098
|
+
# requires_compatibilities: ["EC2"], # accepts EC2, FARGATE
|
3099
|
+
# cpu: "String",
|
3100
|
+
# memory: "String",
|
2955
3101
|
# })
|
2956
3102
|
#
|
2957
3103
|
# @example Response structure
|
@@ -3020,6 +3166,7 @@ module Aws::ECS
|
|
3020
3166
|
# resp.task_definition.container_definitions[0].log_configuration.options["String"] #=> String
|
3021
3167
|
# resp.task_definition.family #=> String
|
3022
3168
|
# resp.task_definition.task_role_arn #=> String
|
3169
|
+
# resp.task_definition.execution_role_arn #=> String
|
3023
3170
|
# resp.task_definition.network_mode #=> String, one of "bridge", "host", "awsvpc", "none"
|
3024
3171
|
# resp.task_definition.revision #=> Integer
|
3025
3172
|
# resp.task_definition.volumes #=> Array
|
@@ -3034,6 +3181,12 @@ module Aws::ECS
|
|
3034
3181
|
# resp.task_definition.placement_constraints #=> Array
|
3035
3182
|
# resp.task_definition.placement_constraints[0].type #=> String, one of "memberOf"
|
3036
3183
|
# resp.task_definition.placement_constraints[0].expression #=> String
|
3184
|
+
# resp.task_definition.compatibilities #=> Array
|
3185
|
+
# resp.task_definition.compatibilities[0] #=> String, one of "EC2", "FARGATE"
|
3186
|
+
# resp.task_definition.requires_compatibilities #=> Array
|
3187
|
+
# resp.task_definition.requires_compatibilities[0] #=> String, one of "EC2", "FARGATE"
|
3188
|
+
# resp.task_definition.cpu #=> String
|
3189
|
+
# resp.task_definition.memory #=> String
|
3037
3190
|
#
|
3038
3191
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/RegisterTaskDefinition AWS API Documentation
|
3039
3192
|
#
|
@@ -3049,7 +3202,7 @@ module Aws::ECS
|
|
3049
3202
|
# You can allow Amazon ECS to place tasks for you, or you can customize
|
3050
3203
|
# how Amazon ECS places tasks using placement constraints and placement
|
3051
3204
|
# strategies. For more information, see [Scheduling Tasks][1] in the
|
3052
|
-
# *Amazon
|
3205
|
+
# *Amazon Elastic Container Service Developer Guide*.
|
3053
3206
|
#
|
3054
3207
|
# Alternatively, you can use StartTask to use your own scheduler or
|
3055
3208
|
# place tasks manually on specific container instances.
|
@@ -3064,9 +3217,9 @@ module Aws::ECS
|
|
3064
3217
|
# cluster is assumed.
|
3065
3218
|
#
|
3066
3219
|
# @option params [required, String] :task_definition
|
3067
|
-
# The `family` and `revision` (`family:revision`) or full
|
3068
|
-
#
|
3069
|
-
#
|
3220
|
+
# The `family` and `revision` (`family:revision`) or full ARN of the
|
3221
|
+
# task definition to run. If a `revision` is not specified, the latest
|
3222
|
+
# `ACTIVE` revision is used.
|
3070
3223
|
#
|
3071
3224
|
# @option params [Types::TaskOverride] :overrides
|
3072
3225
|
# A list of container overrides in JSON format that specify the name of
|
@@ -3111,18 +3264,25 @@ module Aws::ECS
|
|
3111
3264
|
#
|
3112
3265
|
# @option params [Array<Types::PlacementStrategy>] :placement_strategy
|
3113
3266
|
# The placement strategy objects to use for the task. You can specify a
|
3114
|
-
# maximum of
|
3267
|
+
# maximum of five strategy rules per task.
|
3268
|
+
#
|
3269
|
+
# @option params [String] :launch_type
|
3270
|
+
# The launch type on which to run your task.
|
3271
|
+
#
|
3272
|
+
# @option params [String] :platform_version
|
3273
|
+
# The platform version on which to run your task. If one is not
|
3274
|
+
# specified, the latest version is used by default.
|
3115
3275
|
#
|
3116
3276
|
# @option params [Types::NetworkConfiguration] :network_configuration
|
3117
3277
|
# The network configuration for the task. This parameter is required for
|
3118
3278
|
# task definitions that use the `awsvpc` network mode to receive their
|
3119
3279
|
# own Elastic Network Interface, and it is not supported for other
|
3120
3280
|
# network modes. For more information, see [Task Networking][1] in the
|
3121
|
-
# *Amazon
|
3281
|
+
# *Amazon Elastic Container Service Developer Guide*.
|
3122
3282
|
#
|
3123
3283
|
#
|
3124
3284
|
#
|
3125
|
-
# [1]: http://docs.aws.amazon.com/AmazonECS/latest/
|
3285
|
+
# [1]: http://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-networking.html
|
3126
3286
|
#
|
3127
3287
|
# @return [Types::RunTaskResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
3128
3288
|
#
|
@@ -3189,6 +3349,7 @@ module Aws::ECS
|
|
3189
3349
|
# },
|
3190
3350
|
# ],
|
3191
3351
|
# task_role_arn: "String",
|
3352
|
+
# execution_role_arn: "String",
|
3192
3353
|
# },
|
3193
3354
|
# count: 1,
|
3194
3355
|
# started_by: "String",
|
@@ -3205,10 +3366,13 @@ module Aws::ECS
|
|
3205
3366
|
# field: "String",
|
3206
3367
|
# },
|
3207
3368
|
# ],
|
3369
|
+
# launch_type: "EC2", # accepts EC2, FARGATE
|
3370
|
+
# platform_version: "String",
|
3208
3371
|
# network_configuration: {
|
3209
3372
|
# awsvpc_configuration: {
|
3210
3373
|
# subnets: ["String"], # required
|
3211
3374
|
# security_groups: ["String"],
|
3375
|
+
# assign_public_ip: "ENABLED", # accepts ENABLED, DISABLED
|
3212
3376
|
# },
|
3213
3377
|
# },
|
3214
3378
|
# })
|
@@ -3231,8 +3395,11 @@ module Aws::ECS
|
|
3231
3395
|
# resp.tasks[0].overrides.container_overrides[0].memory #=> Integer
|
3232
3396
|
# resp.tasks[0].overrides.container_overrides[0].memory_reservation #=> Integer
|
3233
3397
|
# resp.tasks[0].overrides.task_role_arn #=> String
|
3398
|
+
# resp.tasks[0].overrides.execution_role_arn #=> String
|
3234
3399
|
# resp.tasks[0].last_status #=> String
|
3235
3400
|
# resp.tasks[0].desired_status #=> String
|
3401
|
+
# resp.tasks[0].cpu #=> String
|
3402
|
+
# resp.tasks[0].memory #=> String
|
3236
3403
|
# resp.tasks[0].containers #=> Array
|
3237
3404
|
# resp.tasks[0].containers[0].container_arn #=> String
|
3238
3405
|
# resp.tasks[0].containers[0].task_arn #=> String
|
@@ -3252,10 +3419,18 @@ module Aws::ECS
|
|
3252
3419
|
# resp.tasks[0].started_by #=> String
|
3253
3420
|
# resp.tasks[0].version #=> Integer
|
3254
3421
|
# resp.tasks[0].stopped_reason #=> String
|
3422
|
+
# resp.tasks[0].connectivity #=> String, one of "CONNECTED", "DISCONNECTED"
|
3423
|
+
# resp.tasks[0].connectivity_at #=> Time
|
3424
|
+
# resp.tasks[0].pull_started_at #=> Time
|
3425
|
+
# resp.tasks[0].pull_stopped_at #=> Time
|
3426
|
+
# resp.tasks[0].execution_stopped_at #=> Time
|
3255
3427
|
# resp.tasks[0].created_at #=> Time
|
3256
3428
|
# resp.tasks[0].started_at #=> Time
|
3429
|
+
# resp.tasks[0].stopping_at #=> Time
|
3257
3430
|
# resp.tasks[0].stopped_at #=> Time
|
3258
3431
|
# resp.tasks[0].group #=> String
|
3432
|
+
# resp.tasks[0].launch_type #=> String, one of "EC2", "FARGATE"
|
3433
|
+
# resp.tasks[0].platform_version #=> String
|
3259
3434
|
# resp.tasks[0].attachments #=> Array
|
3260
3435
|
# resp.tasks[0].attachments[0].id #=> String
|
3261
3436
|
# resp.tasks[0].attachments[0].type #=> String
|
@@ -3280,8 +3455,8 @@ module Aws::ECS
|
|
3280
3455
|
# container instance or instances.
|
3281
3456
|
#
|
3282
3457
|
# Alternatively, you can use RunTask to place tasks for you. For more
|
3283
|
-
# information, see [Scheduling Tasks][1] in the *Amazon
|
3284
|
-
# Service Developer Guide*.
|
3458
|
+
# information, see [Scheduling Tasks][1] in the *Amazon Elastic
|
3459
|
+
# Container Service Developer Guide*.
|
3285
3460
|
#
|
3286
3461
|
#
|
3287
3462
|
#
|
@@ -3293,9 +3468,9 @@ module Aws::ECS
|
|
3293
3468
|
# cluster is assumed.
|
3294
3469
|
#
|
3295
3470
|
# @option params [required, String] :task_definition
|
3296
|
-
# The `family` and `revision` (`family:revision`) or full
|
3297
|
-
#
|
3298
|
-
#
|
3471
|
+
# The `family` and `revision` (`family:revision`) or full ARN of the
|
3472
|
+
# task definition to start. If a `revision` is not specified, the latest
|
3473
|
+
# `ACTIVE` revision is used.
|
3299
3474
|
#
|
3300
3475
|
# @option params [Types::TaskOverride] :overrides
|
3301
3476
|
# A list of container overrides in JSON format that specify the name of
|
@@ -3313,9 +3488,9 @@ module Aws::ECS
|
|
3313
3488
|
# </note>
|
3314
3489
|
#
|
3315
3490
|
# @option params [required, Array<String>] :container_instances
|
3316
|
-
# The container instance IDs or full
|
3317
|
-
#
|
3318
|
-
#
|
3491
|
+
# The container instance IDs or full ARN entries for the container
|
3492
|
+
# instances on which you would like to place your task. You can specify
|
3493
|
+
# up to 10 container instances.
|
3319
3494
|
#
|
3320
3495
|
# @option params [String] :started_by
|
3321
3496
|
# An optional tag specified when a task is started. For example if you
|
@@ -3366,6 +3541,7 @@ module Aws::ECS
|
|
3366
3541
|
# },
|
3367
3542
|
# ],
|
3368
3543
|
# task_role_arn: "String",
|
3544
|
+
# execution_role_arn: "String",
|
3369
3545
|
# },
|
3370
3546
|
# container_instances: ["String"], # required
|
3371
3547
|
# started_by: "String",
|
@@ -3374,6 +3550,7 @@ module Aws::ECS
|
|
3374
3550
|
# awsvpc_configuration: {
|
3375
3551
|
# subnets: ["String"], # required
|
3376
3552
|
# security_groups: ["String"],
|
3553
|
+
# assign_public_ip: "ENABLED", # accepts ENABLED, DISABLED
|
3377
3554
|
# },
|
3378
3555
|
# },
|
3379
3556
|
# })
|
@@ -3396,8 +3573,11 @@ module Aws::ECS
|
|
3396
3573
|
# resp.tasks[0].overrides.container_overrides[0].memory #=> Integer
|
3397
3574
|
# resp.tasks[0].overrides.container_overrides[0].memory_reservation #=> Integer
|
3398
3575
|
# resp.tasks[0].overrides.task_role_arn #=> String
|
3576
|
+
# resp.tasks[0].overrides.execution_role_arn #=> String
|
3399
3577
|
# resp.tasks[0].last_status #=> String
|
3400
3578
|
# resp.tasks[0].desired_status #=> String
|
3579
|
+
# resp.tasks[0].cpu #=> String
|
3580
|
+
# resp.tasks[0].memory #=> String
|
3401
3581
|
# resp.tasks[0].containers #=> Array
|
3402
3582
|
# resp.tasks[0].containers[0].container_arn #=> String
|
3403
3583
|
# resp.tasks[0].containers[0].task_arn #=> String
|
@@ -3417,10 +3597,18 @@ module Aws::ECS
|
|
3417
3597
|
# resp.tasks[0].started_by #=> String
|
3418
3598
|
# resp.tasks[0].version #=> Integer
|
3419
3599
|
# resp.tasks[0].stopped_reason #=> String
|
3600
|
+
# resp.tasks[0].connectivity #=> String, one of "CONNECTED", "DISCONNECTED"
|
3601
|
+
# resp.tasks[0].connectivity_at #=> Time
|
3602
|
+
# resp.tasks[0].pull_started_at #=> Time
|
3603
|
+
# resp.tasks[0].pull_stopped_at #=> Time
|
3604
|
+
# resp.tasks[0].execution_stopped_at #=> Time
|
3420
3605
|
# resp.tasks[0].created_at #=> Time
|
3421
3606
|
# resp.tasks[0].started_at #=> Time
|
3607
|
+
# resp.tasks[0].stopping_at #=> Time
|
3422
3608
|
# resp.tasks[0].stopped_at #=> Time
|
3423
3609
|
# resp.tasks[0].group #=> String
|
3610
|
+
# resp.tasks[0].launch_type #=> String, one of "EC2", "FARGATE"
|
3611
|
+
# resp.tasks[0].platform_version #=> String
|
3424
3612
|
# resp.tasks[0].attachments #=> Array
|
3425
3613
|
# resp.tasks[0].attachments[0].id #=> String
|
3426
3614
|
# resp.tasks[0].attachments[0].type #=> String
|
@@ -3453,7 +3641,7 @@ module Aws::ECS
|
|
3453
3641
|
# <note markdown="1"> The default 30-second timeout can be configured on the Amazon ECS
|
3454
3642
|
# container agent with the `ECS_CONTAINER_STOP_TIMEOUT` variable. For
|
3455
3643
|
# more information, see [Amazon ECS Container Agent Configuration][1] in
|
3456
|
-
# the *Amazon
|
3644
|
+
# the *Amazon Elastic Container Service Developer Guide*.
|
3457
3645
|
#
|
3458
3646
|
# </note>
|
3459
3647
|
#
|
@@ -3467,15 +3655,14 @@ module Aws::ECS
|
|
3467
3655
|
# cluster is assumed.
|
3468
3656
|
#
|
3469
3657
|
# @option params [required, String] :task
|
3470
|
-
# The task ID or full
|
3471
|
-
# stop.
|
3658
|
+
# The task ID or full ARN entry of the task to stop.
|
3472
3659
|
#
|
3473
3660
|
# @option params [String] :reason
|
3474
3661
|
# An optional message specified when a task is stopped. For example, if
|
3475
3662
|
# you are using a custom scheduler, you can use this parameter to
|
3476
|
-
# specify the reason for stopping the task here, and the message
|
3477
|
-
#
|
3478
|
-
#
|
3663
|
+
# specify the reason for stopping the task here, and the message appears
|
3664
|
+
# in subsequent DescribeTasks API operations on this task. Up to 255
|
3665
|
+
# characters are allowed in this message.
|
3479
3666
|
#
|
3480
3667
|
# @return [Types::StopTaskResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
3481
3668
|
#
|
@@ -3506,8 +3693,11 @@ module Aws::ECS
|
|
3506
3693
|
# resp.task.overrides.container_overrides[0].memory #=> Integer
|
3507
3694
|
# resp.task.overrides.container_overrides[0].memory_reservation #=> Integer
|
3508
3695
|
# resp.task.overrides.task_role_arn #=> String
|
3696
|
+
# resp.task.overrides.execution_role_arn #=> String
|
3509
3697
|
# resp.task.last_status #=> String
|
3510
3698
|
# resp.task.desired_status #=> String
|
3699
|
+
# resp.task.cpu #=> String
|
3700
|
+
# resp.task.memory #=> String
|
3511
3701
|
# resp.task.containers #=> Array
|
3512
3702
|
# resp.task.containers[0].container_arn #=> String
|
3513
3703
|
# resp.task.containers[0].task_arn #=> String
|
@@ -3527,10 +3717,18 @@ module Aws::ECS
|
|
3527
3717
|
# resp.task.started_by #=> String
|
3528
3718
|
# resp.task.version #=> Integer
|
3529
3719
|
# resp.task.stopped_reason #=> String
|
3720
|
+
# resp.task.connectivity #=> String, one of "CONNECTED", "DISCONNECTED"
|
3721
|
+
# resp.task.connectivity_at #=> Time
|
3722
|
+
# resp.task.pull_started_at #=> Time
|
3723
|
+
# resp.task.pull_stopped_at #=> Time
|
3724
|
+
# resp.task.execution_stopped_at #=> Time
|
3530
3725
|
# resp.task.created_at #=> Time
|
3531
3726
|
# resp.task.started_at #=> Time
|
3727
|
+
# resp.task.stopping_at #=> Time
|
3532
3728
|
# resp.task.stopped_at #=> Time
|
3533
3729
|
# resp.task.group #=> String
|
3730
|
+
# resp.task.launch_type #=> String, one of "EC2", "FARGATE"
|
3731
|
+
# resp.task.platform_version #=> String
|
3534
3732
|
# resp.task.attachments #=> Array
|
3535
3733
|
# resp.task.attachments[0].id #=> String
|
3536
3734
|
# resp.task.attachments[0].type #=> String
|
@@ -3548,16 +3746,15 @@ module Aws::ECS
|
|
3548
3746
|
req.send_request(options)
|
3549
3747
|
end
|
3550
3748
|
|
3551
|
-
# <note markdown="1"> This action is only used by the Amazon
|
3552
|
-
#
|
3749
|
+
# <note markdown="1"> This action is only used by the Amazon ECS agent, and it is not
|
3750
|
+
# intended for use outside of the agent.
|
3553
3751
|
#
|
3554
3752
|
# </note>
|
3555
3753
|
#
|
3556
3754
|
# Sent to acknowledge that a container changed states.
|
3557
3755
|
#
|
3558
3756
|
# @option params [String] :cluster
|
3559
|
-
# The short name or full
|
3560
|
-
# hosts the container.
|
3757
|
+
# The short name or full ARN of the cluster that hosts the container.
|
3561
3758
|
#
|
3562
3759
|
# @option params [String] :task
|
3563
3760
|
# The task ID or full Amazon Resource Name (ARN) of the task that hosts
|
@@ -3614,8 +3811,8 @@ module Aws::ECS
|
|
3614
3811
|
req.send_request(options)
|
3615
3812
|
end
|
3616
3813
|
|
3617
|
-
# <note markdown="1"> This action is only used by the Amazon
|
3618
|
-
#
|
3814
|
+
# <note markdown="1"> This action is only used by the Amazon ECS agent, and it is not
|
3815
|
+
# intended for use outside of the agent.
|
3619
3816
|
#
|
3620
3817
|
# </note>
|
3621
3818
|
#
|
@@ -3626,8 +3823,7 @@ module Aws::ECS
|
|
3626
3823
|
# hosts the task.
|
3627
3824
|
#
|
3628
3825
|
# @option params [String] :task
|
3629
|
-
# The task ID or full
|
3630
|
-
# state change request.
|
3826
|
+
# The task ID or full ARN of the task in the state change request.
|
3631
3827
|
#
|
3632
3828
|
# @option params [String] :status
|
3633
3829
|
# The status of the state change request.
|
@@ -3641,6 +3837,15 @@ module Aws::ECS
|
|
3641
3837
|
# @option params [Array<Types::AttachmentStateChange>] :attachments
|
3642
3838
|
# Any attachments associated with the state change request.
|
3643
3839
|
#
|
3840
|
+
# @option params [Time,DateTime,Date,Integer,String] :pull_started_at
|
3841
|
+
# The Unix time stamp for when the container image pull began.
|
3842
|
+
#
|
3843
|
+
# @option params [Time,DateTime,Date,Integer,String] :pull_stopped_at
|
3844
|
+
# The Unix time stamp for when the container image pull completed.
|
3845
|
+
#
|
3846
|
+
# @option params [Time,DateTime,Date,Integer,String] :execution_stopped_at
|
3847
|
+
# The Unix timestamp for when the task execution stopped.
|
3848
|
+
#
|
3644
3849
|
# @return [Types::SubmitTaskStateChangeResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
3645
3850
|
#
|
3646
3851
|
# * {Types::SubmitTaskStateChangeResponse#acknowledgment #acknowledgment} => String
|
@@ -3674,6 +3879,9 @@ module Aws::ECS
|
|
3674
3879
|
# status: "String", # required
|
3675
3880
|
# },
|
3676
3881
|
# ],
|
3882
|
+
# pull_started_at: Time.now,
|
3883
|
+
# pull_stopped_at: Time.now,
|
3884
|
+
# execution_stopped_at: Time.now,
|
3677
3885
|
# })
|
3678
3886
|
#
|
3679
3887
|
# @example Response structure
|
@@ -3700,7 +3908,7 @@ module Aws::ECS
|
|
3700
3908
|
# Linux with the `ecs-init` service installed and running. For help
|
3701
3909
|
# updating the Amazon ECS container agent on other operating systems,
|
3702
3910
|
# see [Manually Updating the Amazon ECS Container Agent][1] in the
|
3703
|
-
# *Amazon
|
3911
|
+
# *Amazon Elastic Container Service Developer Guide*.
|
3704
3912
|
#
|
3705
3913
|
#
|
3706
3914
|
#
|
@@ -3712,9 +3920,9 @@ module Aws::ECS
|
|
3712
3920
|
# cluster, the default cluster is assumed.
|
3713
3921
|
#
|
3714
3922
|
# @option params [required, String] :container_instance
|
3715
|
-
# The container instance ID or full
|
3716
|
-
#
|
3717
|
-
#
|
3923
|
+
# The container instance ID or full ARN entries for the container
|
3924
|
+
# instance on which you would like to update the Amazon ECS container
|
3925
|
+
# agent.
|
3718
3926
|
#
|
3719
3927
|
# @return [Types::UpdateContainerAgentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
3720
3928
|
#
|
@@ -3794,10 +4002,10 @@ module Aws::ECS
|
|
3794
4002
|
# immediately.
|
3795
4003
|
#
|
3796
4004
|
# Service tasks on the container instance that are in the `RUNNING`
|
3797
|
-
# state are stopped and replaced according the service's deployment
|
4005
|
+
# state are stopped and replaced according to the service's deployment
|
3798
4006
|
# configuration parameters, `minimumHealthyPercent` and
|
3799
|
-
# `maximumPercent`.
|
3800
|
-
#
|
4007
|
+
# `maximumPercent`. You can change the deployment configuration of your
|
4008
|
+
# service using UpdateService.
|
3801
4009
|
#
|
3802
4010
|
# * If `minimumHealthyPercent` is below 100%, the scheduler can ignore
|
3803
4011
|
# `desiredCount` temporarily during task replacement. For example,
|
@@ -3835,8 +4043,7 @@ module Aws::ECS
|
|
3835
4043
|
# cluster, the default cluster is assumed.
|
3836
4044
|
#
|
3837
4045
|
# @option params [required, Array<String>] :container_instances
|
3838
|
-
# A list of container instance IDs or full
|
3839
|
-
# entries.
|
4046
|
+
# A list of container instance IDs or full ARN entries.
|
3840
4047
|
#
|
3841
4048
|
# @option params [required, String] :status
|
3842
4049
|
# The container instance state with which to update the container
|
@@ -4000,12 +4207,12 @@ module Aws::ECS
|
|
4000
4207
|
# your service.
|
4001
4208
|
#
|
4002
4209
|
# @option params [String] :task_definition
|
4003
|
-
# The `family` and `revision` (`family:revision`) or full
|
4004
|
-
#
|
4005
|
-
#
|
4006
|
-
#
|
4007
|
-
#
|
4008
|
-
#
|
4210
|
+
# The `family` and `revision` (`family:revision`) or full ARN of the
|
4211
|
+
# task definition to run in your service. If a `revision` is not
|
4212
|
+
# specified, the latest `ACTIVE` revision is used. If you modify the
|
4213
|
+
# task definition with `UpdateService`, Amazon ECS spawns a task with
|
4214
|
+
# the new version of the task definition and then stops an old task
|
4215
|
+
# after the new version is running.
|
4009
4216
|
#
|
4010
4217
|
# @option params [Types::DeploymentConfiguration] :deployment_configuration
|
4011
4218
|
# Optional deployment parameters that control how many tasks run during
|
@@ -4016,7 +4223,7 @@ module Aws::ECS
|
|
4016
4223
|
# for task definitions that use the `awsvpc` network mode to receive
|
4017
4224
|
# their own Elastic Network Interface, and it is not supported for other
|
4018
4225
|
# network modes. For more information, see [Task Networking][1] in the
|
4019
|
-
# *Amazon
|
4226
|
+
# *Amazon Elastic Container Service Developer Guide*.
|
4020
4227
|
#
|
4021
4228
|
# <note markdown="1"> Updating a service to add a subnet to a list of existing subnets does
|
4022
4229
|
# not trigger a service deployment. For example, if your network
|
@@ -4028,7 +4235,13 @@ module Aws::ECS
|
|
4028
4235
|
#
|
4029
4236
|
#
|
4030
4237
|
#
|
4031
|
-
# [1]: http://docs.aws.amazon.com/AmazonECS/latest/
|
4238
|
+
# [1]: http://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-networking.html
|
4239
|
+
#
|
4240
|
+
# @option params [String] :platform_version
|
4241
|
+
# The platform version you want to update your service to run.
|
4242
|
+
#
|
4243
|
+
# @option params [Boolean] :force_new_deployment
|
4244
|
+
# Whether or not to force a new deployment of the service.
|
4032
4245
|
#
|
4033
4246
|
# @return [Types::UpdateServiceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
4034
4247
|
#
|
@@ -4076,8 +4289,11 @@ module Aws::ECS
|
|
4076
4289
|
# awsvpc_configuration: {
|
4077
4290
|
# subnets: ["String"], # required
|
4078
4291
|
# security_groups: ["String"],
|
4292
|
+
# assign_public_ip: "ENABLED", # accepts ENABLED, DISABLED
|
4079
4293
|
# },
|
4080
4294
|
# },
|
4295
|
+
# platform_version: "String",
|
4296
|
+
# force_new_deployment: false,
|
4081
4297
|
# })
|
4082
4298
|
#
|
4083
4299
|
# @example Response structure
|
@@ -4094,6 +4310,8 @@ module Aws::ECS
|
|
4094
4310
|
# resp.service.desired_count #=> Integer
|
4095
4311
|
# resp.service.running_count #=> Integer
|
4096
4312
|
# resp.service.pending_count #=> Integer
|
4313
|
+
# resp.service.launch_type #=> String, one of "EC2", "FARGATE"
|
4314
|
+
# resp.service.platform_version #=> String
|
4097
4315
|
# resp.service.task_definition #=> String
|
4098
4316
|
# resp.service.deployment_configuration.maximum_percent #=> Integer
|
4099
4317
|
# resp.service.deployment_configuration.minimum_healthy_percent #=> Integer
|
@@ -4106,10 +4324,13 @@ module Aws::ECS
|
|
4106
4324
|
# resp.service.deployments[0].running_count #=> Integer
|
4107
4325
|
# resp.service.deployments[0].created_at #=> Time
|
4108
4326
|
# resp.service.deployments[0].updated_at #=> Time
|
4327
|
+
# resp.service.deployments[0].launch_type #=> String, one of "EC2", "FARGATE"
|
4328
|
+
# resp.service.deployments[0].platform_version #=> String
|
4109
4329
|
# resp.service.deployments[0].network_configuration.awsvpc_configuration.subnets #=> Array
|
4110
4330
|
# resp.service.deployments[0].network_configuration.awsvpc_configuration.subnets[0] #=> String
|
4111
4331
|
# resp.service.deployments[0].network_configuration.awsvpc_configuration.security_groups #=> Array
|
4112
4332
|
# resp.service.deployments[0].network_configuration.awsvpc_configuration.security_groups[0] #=> String
|
4333
|
+
# resp.service.deployments[0].network_configuration.awsvpc_configuration.assign_public_ip #=> String, one of "ENABLED", "DISABLED"
|
4113
4334
|
# resp.service.role_arn #=> String
|
4114
4335
|
# resp.service.events #=> Array
|
4115
4336
|
# resp.service.events[0].id #=> String
|
@@ -4126,6 +4347,7 @@ module Aws::ECS
|
|
4126
4347
|
# resp.service.network_configuration.awsvpc_configuration.subnets[0] #=> String
|
4127
4348
|
# resp.service.network_configuration.awsvpc_configuration.security_groups #=> Array
|
4128
4349
|
# resp.service.network_configuration.awsvpc_configuration.security_groups[0] #=> String
|
4350
|
+
# resp.service.network_configuration.awsvpc_configuration.assign_public_ip #=> String, one of "ENABLED", "DISABLED"
|
4129
4351
|
#
|
4130
4352
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/UpdateService AWS API Documentation
|
4131
4353
|
#
|
@@ -4149,7 +4371,7 @@ module Aws::ECS
|
|
4149
4371
|
params: params,
|
4150
4372
|
config: config)
|
4151
4373
|
context[:gem_name] = 'aws-sdk-ecs'
|
4152
|
-
context[:gem_version] = '1.
|
4374
|
+
context[:gem_version] = '1.5.0'
|
4153
4375
|
Seahorse::Client::Request.new(handlers, context)
|
4154
4376
|
end
|
4155
4377
|
|