aws-sdk-ecs 1.4.0 → 1.5.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/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
|
|