1{
2  "version": "1.0",
3  "examples": {
4    "CreateCluster": [
5      {
6        "input": {
7          "clusterName": "my_cluster"
8        },
9        "output": {
10          "cluster": {
11            "activeServicesCount": 0,
12            "clusterArn": "arn:aws:ecs:us-east-1:012345678910:cluster/my_cluster",
13            "clusterName": "my_cluster",
14            "pendingTasksCount": 0,
15            "registeredContainerInstancesCount": 0,
16            "runningTasksCount": 0,
17            "status": "ACTIVE"
18          }
19        },
20        "comments": {
21          "input": {
22          },
23          "output": {
24          }
25        },
26        "description": "This example creates a cluster in your default region.",
27        "id": "to-create-a-new-cluster-1472514079365",
28        "title": "To create a new cluster"
29      }
30    ],
31    "CreateService": [
32      {
33        "input": {
34          "desiredCount": 10,
35          "serviceName": "ecs-simple-service",
36          "taskDefinition": "hello_world"
37        },
38        "output": {
39          "service": {
40            "clusterArn": "arn:aws:ecs:us-east-1:012345678910:cluster/default",
41            "createdAt": "2016-08-29T16:13:47.298Z",
42            "deploymentConfiguration": {
43              "maximumPercent": 200,
44              "minimumHealthyPercent": 100
45            },
46            "deployments": [
47              {
48                "createdAt": "2016-08-29T16:13:47.298Z",
49                "desiredCount": 10,
50                "id": "ecs-svc/9223370564342348388",
51                "pendingCount": 0,
52                "runningCount": 0,
53                "status": "PRIMARY",
54                "taskDefinition": "arn:aws:ecs:us-east-1:012345678910:task-definition/hello_world:6",
55                "updatedAt": "2016-08-29T16:13:47.298Z"
56              },
57              {
58                "createdAt": "2016-08-29T15:52:44.481Z",
59                "desiredCount": 0,
60                "id": "ecs-svc/9223370564343611322",
61                "pendingCount": 0,
62                "runningCount": 0,
63                "status": "ACTIVE",
64                "taskDefinition": "arn:aws:ecs:us-east-1:012345678910:task-definition/hello_world:6",
65                "updatedAt": "2016-08-29T16:11:38.941Z"
66              }
67            ],
68            "desiredCount": 10,
69            "events": [
70
71            ],
72            "loadBalancers": [
73
74            ],
75            "pendingCount": 0,
76            "runningCount": 0,
77            "serviceArn": "arn:aws:ecs:us-east-1:012345678910:service/ecs-simple-service",
78            "serviceName": "ecs-simple-service",
79            "status": "ACTIVE",
80            "taskDefinition": "arn:aws:ecs:us-east-1:012345678910:task-definition/hello_world:6"
81          }
82        },
83        "comments": {
84          "input": {
85          },
86          "output": {
87          }
88        },
89        "description": "This example creates a service in your default region called ``ecs-simple-service``. The service uses the ``hello_world`` task definition and it maintains 10 copies of that task.",
90        "id": "to-create-a-new-service-1472512584282",
91        "title": "To create a new service"
92      },
93      {
94        "input": {
95          "desiredCount": 10,
96          "loadBalancers": [
97            {
98              "containerName": "simple-app",
99              "containerPort": 80,
100              "loadBalancerName": "EC2Contai-EcsElast-15DCDAURT3ZO2"
101            }
102          ],
103          "role": "ecsServiceRole",
104          "serviceName": "ecs-simple-service-elb",
105          "taskDefinition": "console-sample-app-static"
106        },
107        "output": {
108          "service": {
109            "clusterArn": "arn:aws:ecs:us-east-1:012345678910:cluster/default",
110            "createdAt": "2016-08-29T16:02:54.884Z",
111            "deploymentConfiguration": {
112              "maximumPercent": 200,
113              "minimumHealthyPercent": 100
114            },
115            "deployments": [
116              {
117                "createdAt": "2016-08-29T16:02:54.884Z",
118                "desiredCount": 10,
119                "id": "ecs-svc/9223370564343000923",
120                "pendingCount": 0,
121                "runningCount": 0,
122                "status": "PRIMARY",
123                "taskDefinition": "arn:aws:ecs:us-east-1:012345678910:task-definition/console-sample-app-static:6",
124                "updatedAt": "2016-08-29T16:02:54.884Z"
125              }
126            ],
127            "desiredCount": 10,
128            "events": [
129
130            ],
131            "loadBalancers": [
132              {
133                "containerName": "simple-app",
134                "containerPort": 80,
135                "loadBalancerName": "EC2Contai-EcsElast-15DCDAURT3ZO2"
136              }
137            ],
138            "pendingCount": 0,
139            "roleArn": "arn:aws:iam::012345678910:role/ecsServiceRole",
140            "runningCount": 0,
141            "serviceArn": "arn:aws:ecs:us-east-1:012345678910:service/ecs-simple-service-elb",
142            "serviceName": "ecs-simple-service-elb",
143            "status": "ACTIVE",
144            "taskDefinition": "arn:aws:ecs:us-east-1:012345678910:task-definition/console-sample-app-static:6"
145          }
146        },
147        "comments": {
148          "input": {
149          },
150          "output": {
151          }
152        },
153        "description": "This example creates a service in your default region called ``ecs-simple-service-elb``. The service uses the ``ecs-demo`` task definition and it maintains 10 copies of that task. You must reference an existing load balancer in the same region by its name.",
154        "id": "to-create-a-new-service-behind-a-load-balancer-1472512484823",
155        "title": "To create a new service behind a load balancer"
156      }
157    ],
158    "DeleteAccountSetting": [
159      {
160        "input": {
161          "name": "serviceLongArnFormat"
162        },
163        "output": {
164          "setting": {
165            "name": "serviceLongArnFormat",
166            "value": "enabled",
167            "principalArn": "arn:aws:iam::<aws_account_id>:user/principalName"
168          }
169        },
170        "comments": {
171          "input": {
172          },
173          "output": {
174          }
175        },
176        "description": "This example deletes the account setting for your user for the specified resource type.",
177        "id": "to-delete-the-account-setting-for-your-user-account-1549524548115",
178        "title": "To delete your account setting"
179      },
180      {
181        "input": {
182          "name": "containerInstanceLongArnFormat",
183          "principalArn": "arn:aws:iam::<aws_account_id>:user/principalName"
184        },
185        "output": {
186          "setting": {
187            "name": "containerInstanceLongArnFormat",
188            "value": "enabled",
189            "principalArn": "arn:aws:iam::<aws_account_id>:user/principalName"
190          }
191        },
192        "comments": {
193          "input": {
194          },
195          "output": {
196          }
197        },
198        "description": "This example deletes the account setting for a specific IAM user or IAM role for the specified resource type. Only the root user can view or modify the account settings for another user.",
199        "id": "to-delete-the-account-setting-for-a-specific-iam-user-or-iam-role-1549524612917",
200        "title": "To delete the account settings for a specific IAM user or IAM role"
201      }
202    ],
203    "DeleteCluster": [
204      {
205        "input": {
206          "cluster": "my_cluster"
207        },
208        "output": {
209          "cluster": {
210            "activeServicesCount": 0,
211            "clusterArn": "arn:aws:ecs:us-east-1:012345678910:cluster/my_cluster",
212            "clusterName": "my_cluster",
213            "pendingTasksCount": 0,
214            "registeredContainerInstancesCount": 0,
215            "runningTasksCount": 0,
216            "status": "INACTIVE"
217          }
218        },
219        "comments": {
220          "input": {
221          },
222          "output": {
223          }
224        },
225        "description": "This example deletes an empty cluster in your default region.",
226        "id": "to-delete-an-empty-cluster-1472512705352",
227        "title": "To delete an empty cluster"
228      }
229    ],
230    "DeleteService": [
231      {
232        "input": {
233          "service": "my-http-service"
234        },
235        "output": {
236        },
237        "comments": {
238          "input": {
239          },
240          "output": {
241          }
242        },
243        "description": "This example deletes the my-http-service service. The service must have a desired count and running count of 0 before you can delete it.",
244        "id": "e8183e38-f86e-4390-b811-f74f30a6007d",
245        "title": "To delete a service"
246      }
247    ],
248    "DeregisterContainerInstance": [
249      {
250        "input": {
251          "cluster": "default",
252          "containerInstance": "container_instance_UUID",
253          "force": true
254        },
255        "output": {
256        },
257        "comments": {
258          "input": {
259          },
260          "output": {
261          }
262        },
263        "description": "This example deregisters a container instance from the specified cluster in your default region. If there are still tasks running on the container instance, you must either stop those tasks before deregistering, or use the force option.",
264        "id": "bf624927-cf64-4f4b-8b7e-c024a4e682f6",
265        "title": "To deregister a container instance from a cluster"
266      }
267    ],
268    "DescribeClusters": [
269      {
270        "input": {
271          "clusters": [
272            "default"
273          ]
274        },
275        "output": {
276          "clusters": [
277            {
278              "clusterArn": "arn:aws:ecs:us-east-1:aws_account_id:cluster/default",
279              "clusterName": "default",
280              "status": "ACTIVE"
281            }
282          ],
283          "failures": [
284
285          ]
286        },
287        "comments": {
288          "input": {
289          },
290          "output": {
291          }
292        },
293        "description": "This example provides a description of the specified cluster in your default region.",
294        "id": "ba88d100-9672-4231-80da-a4bd210bf728",
295        "title": "To describe a cluster"
296      }
297    ],
298    "DescribeContainerInstances": [
299      {
300        "input": {
301          "cluster": "default",
302          "containerInstances": [
303            "f2756532-8f13-4d53-87c9-aed50dc94cd7"
304          ]
305        },
306        "output": {
307          "containerInstances": [
308            {
309              "agentConnected": true,
310              "containerInstanceArn": "arn:aws:ecs:us-east-1:012345678910:container-instance/f2756532-8f13-4d53-87c9-aed50dc94cd7",
311              "ec2InstanceId": "i-807f3249",
312              "pendingTasksCount": 0,
313              "registeredResources": [
314                {
315                  "name": "CPU",
316                  "type": "INTEGER",
317                  "doubleValue": 0.0,
318                  "integerValue": 2048,
319                  "longValue": 0
320                },
321                {
322                  "name": "MEMORY",
323                  "type": "INTEGER",
324                  "doubleValue": 0.0,
325                  "integerValue": 3768,
326                  "longValue": 0
327                },
328                {
329                  "name": "PORTS",
330                  "type": "STRINGSET",
331                  "doubleValue": 0.0,
332                  "integerValue": 0,
333                  "longValue": 0,
334                  "stringSetValue": [
335                    "2376",
336                    "22",
337                    "51678",
338                    "2375"
339                  ]
340                }
341              ],
342              "remainingResources": [
343                {
344                  "name": "CPU",
345                  "type": "INTEGER",
346                  "doubleValue": 0.0,
347                  "integerValue": 1948,
348                  "longValue": 0
349                },
350                {
351                  "name": "MEMORY",
352                  "type": "INTEGER",
353                  "doubleValue": 0.0,
354                  "integerValue": 3668,
355                  "longValue": 0
356                },
357                {
358                  "name": "PORTS",
359                  "type": "STRINGSET",
360                  "doubleValue": 0.0,
361                  "integerValue": 0,
362                  "longValue": 0,
363                  "stringSetValue": [
364                    "2376",
365                    "22",
366                    "80",
367                    "51678",
368                    "2375"
369                  ]
370                }
371              ],
372              "runningTasksCount": 1,
373              "status": "ACTIVE"
374            }
375          ],
376          "failures": [
377
378          ]
379        },
380        "comments": {
381          "input": {
382          },
383          "output": {
384          }
385        },
386        "description": "This example provides a description of the specified container instance in your default region, using the container instance UUID as an identifier.",
387        "id": "c8f439de-eb27-4269-8ca7-2c0a7ba75ab0",
388        "title": "To describe container instance"
389      }
390    ],
391    "DescribeServices": [
392      {
393        "input": {
394          "services": [
395            "ecs-simple-service"
396          ]
397        },
398        "output": {
399          "failures": [
400
401          ],
402          "services": [
403            {
404              "clusterArn": "arn:aws:ecs:us-east-1:012345678910:cluster/default",
405              "createdAt": "2016-08-29T16:25:52.130Z",
406              "deploymentConfiguration": {
407                "maximumPercent": 200,
408                "minimumHealthyPercent": 100
409              },
410              "deployments": [
411                {
412                  "createdAt": "2016-08-29T16:25:52.130Z",
413                  "desiredCount": 1,
414                  "id": "ecs-svc/9223370564341623665",
415                  "pendingCount": 0,
416                  "runningCount": 0,
417                  "status": "PRIMARY",
418                  "taskDefinition": "arn:aws:ecs:us-east-1:012345678910:task-definition/hello_world:6",
419                  "updatedAt": "2016-08-29T16:25:52.130Z"
420                }
421              ],
422              "desiredCount": 1,
423              "events": [
424                {
425                  "createdAt": "2016-08-29T16:25:58.520Z",
426                  "id": "38c285e5-d335-4b68-8b15-e46dedc8e88d",
427                  "message": "(service ecs-simple-service) was unable to place a task because no container instance met all of its requirements. The closest matching (container-instance 3f4de1c5-ffdd-4954-af7e-75b4be0c8841) is already using a port required by your task. For more information, see the Troubleshooting section of the Amazon ECS Developer Guide."
428                }
429              ],
430              "loadBalancers": [
431
432              ],
433              "pendingCount": 0,
434              "runningCount": 0,
435              "serviceArn": "arn:aws:ecs:us-east-1:012345678910:service/ecs-simple-service",
436              "serviceName": "ecs-simple-service",
437              "status": "ACTIVE",
438              "taskDefinition": "arn:aws:ecs:us-east-1:012345678910:task-definition/hello_world:6"
439            }
440          ]
441        },
442        "comments": {
443          "input": {
444          },
445          "output": {
446            "services[0].events[0].message": "In this example, there is a service event that shows unavailable cluster resources."
447          }
448        },
449        "description": "This example provides descriptive information about the service named ``ecs-simple-service``.",
450        "id": "to-describe-a-service-1472513256350",
451        "title": "To describe a service"
452      }
453    ],
454    "DescribeTaskDefinition": [
455      {
456        "input": {
457          "taskDefinition": "hello_world:8"
458        },
459        "output": {
460          "taskDefinition": {
461            "containerDefinitions": [
462              {
463                "name": "wordpress",
464                "cpu": 10,
465                "environment": [
466
467                ],
468                "essential": true,
469                "image": "wordpress",
470                "links": [
471                  "mysql"
472                ],
473                "memory": 500,
474                "mountPoints": [
475
476                ],
477                "portMappings": [
478                  {
479                    "containerPort": 80,
480                    "hostPort": 80
481                  }
482                ],
483                "volumesFrom": [
484
485                ]
486              },
487              {
488                "name": "mysql",
489                "cpu": 10,
490                "environment": [
491                  {
492                    "name": "MYSQL_ROOT_PASSWORD",
493                    "value": "password"
494                  }
495                ],
496                "essential": true,
497                "image": "mysql",
498                "memory": 500,
499                "mountPoints": [
500
501                ],
502                "portMappings": [
503
504                ],
505                "volumesFrom": [
506
507                ]
508              }
509            ],
510            "family": "hello_world",
511            "revision": 8,
512            "taskDefinitionArn": "arn:aws:ecs:us-east-1:<aws_account_id>:task-definition/hello_world:8",
513            "volumes": [
514
515            ]
516          }
517        },
518        "comments": {
519          "input": {
520          },
521          "output": {
522          }
523        },
524        "description": "This example provides a description of the specified task definition.",
525        "id": "4c21eeb1-f1da-4a08-8c44-297fc8d0ea88",
526        "title": "To describe a task definition"
527      }
528    ],
529    "DescribeTasks": [
530      {
531        "input": {
532          "tasks": [
533            "c5cba4eb-5dad-405e-96db-71ef8eefe6a8"
534          ]
535        },
536        "output": {
537          "failures": [
538
539          ],
540          "tasks": [
541            {
542              "clusterArn": "arn:aws:ecs:<region>:<aws_account_id>:cluster/default",
543              "containerInstanceArn": "arn:aws:ecs:<region>:<aws_account_id>:container-instance/18f9eda5-27d7-4c19-b133-45adc516e8fb",
544              "containers": [
545                {
546                  "name": "ecs-demo",
547                  "containerArn": "arn:aws:ecs:<region>:<aws_account_id>:container/7c01765b-c588-45b3-8290-4ba38bd6c5a6",
548                  "lastStatus": "RUNNING",
549                  "networkBindings": [
550                    {
551                      "bindIP": "0.0.0.0",
552                      "containerPort": 80,
553                      "hostPort": 80
554                    }
555                  ],
556                  "taskArn": "arn:aws:ecs:<region>:<aws_account_id>:task/c5cba4eb-5dad-405e-96db-71ef8eefe6a8"
557                }
558              ],
559              "desiredStatus": "RUNNING",
560              "lastStatus": "RUNNING",
561              "overrides": {
562                "containerOverrides": [
563                  {
564                    "name": "ecs-demo"
565                  }
566                ]
567              },
568              "startedBy": "ecs-svc/9223370608528463088",
569              "taskArn": "arn:aws:ecs:<region>:<aws_account_id>:task/c5cba4eb-5dad-405e-96db-71ef8eefe6a8",
570              "taskDefinitionArn": "arn:aws:ecs:<region>:<aws_account_id>:task-definition/amazon-ecs-sample:1"
571            }
572          ]
573        },
574        "comments": {
575          "input": {
576          },
577          "output": {
578          }
579        },
580        "description": "This example provides a description of the specified task, using the task UUID as an identifier.",
581        "id": "a90b0cde-f965-4946-b55e-cfd8cc54e827",
582        "title": "To describe a task"
583      }
584    ],
585    "ListAccountSettings": [
586      {
587        "input": {
588          "effectiveSettings": true
589        },
590        "output": {
591          "settings": [
592            {
593              "name": "containerInstanceLongArnFormat",
594              "value": "disabled",
595              "principalArn": "arn:aws:iam::<aws_account_id>:user/principalName"
596            },
597            {
598              "name": "serviceLongArnFormat",
599              "value": "enabled",
600              "principalArn": "arn:aws:iam::<aws_account_id>:user/principalName"
601            },
602            {
603              "name": "taskLongArnFormat",
604              "value": "disabled",
605              "principalArn": "arn:aws:iam::<aws_account_id>:user/principalName"
606            }
607          ]
608        },
609        "comments": {
610          "input": {
611          },
612          "output": {
613          }
614        },
615        "description": "This example displays the effective account settings for your account.",
616        "id": "to-view-your-account-settings-1549524118170",
617        "title": "To view your effective account settings"
618      },
619      {
620        "input": {
621          "effectiveSettings": true,
622          "principalArn": "arn:aws:iam::<aws_account_id>:user/principalName"
623        },
624        "output": {
625          "settings": [
626            {
627              "name": "containerInstanceLongArnFormat",
628              "value": "disabled",
629              "principalArn": "arn:aws:iam::<aws_account_id>:user/principalName"
630            },
631            {
632              "name": "serviceLongArnFormat",
633              "value": "enabled",
634              "principalArn": "arn:aws:iam::<aws_account_id>:user/principalName"
635            },
636            {
637              "name": "taskLongArnFormat",
638              "value": "disabled",
639              "principalArn": "arn:aws:iam::<aws_account_id>:user/principalName"
640            }
641          ]
642        },
643        "comments": {
644          "input": {
645          },
646          "output": {
647          }
648        },
649        "description": "This example displays the effective account settings for the specified user or role.",
650        "id": "to-view-the-account-settings-for-a-specific-iam-user-or-iam-role-1549524237932",
651        "title": "To view the effective account settings for a specific IAM user or IAM role"
652      }
653    ],
654    "ListClusters": [
655      {
656        "input": {
657        },
658        "output": {
659          "clusterArns": [
660            "arn:aws:ecs:us-east-1:<aws_account_id>:cluster/test",
661            "arn:aws:ecs:us-east-1:<aws_account_id>:cluster/default"
662          ]
663        },
664        "comments": {
665          "input": {
666          },
667          "output": {
668          }
669        },
670        "description": "This example lists all of your available clusters in your default region.",
671        "id": "e337d059-134f-4125-ba8e-4f499139facf",
672        "title": "To list your available clusters"
673      }
674    ],
675    "ListContainerInstances": [
676      {
677        "input": {
678          "cluster": "default"
679        },
680        "output": {
681          "containerInstanceArns": [
682            "arn:aws:ecs:us-east-1:<aws_account_id>:container-instance/f6bbb147-5370-4ace-8c73-c7181ded911f",
683            "arn:aws:ecs:us-east-1:<aws_account_id>:container-instance/ffe3d344-77e2-476c-a4d0-bf560ad50acb"
684          ]
685        },
686        "comments": {
687          "input": {
688          },
689          "output": {
690          }
691        },
692        "description": "This example lists all of your available container instances in the specified cluster in your default region.",
693        "id": "62a82a94-713c-4e18-8420-1d2b2ba9d484",
694        "title": "To list your available container instances in a cluster"
695      }
696    ],
697    "ListServices": [
698      {
699        "input": {
700        },
701        "output": {
702          "serviceArns": [
703            "arn:aws:ecs:us-east-1:012345678910:service/my-http-service"
704          ]
705        },
706        "comments": {
707          "input": {
708          },
709          "output": {
710          }
711        },
712        "description": "This example lists the services running in the default cluster for an account.",
713        "id": "1d9a8037-4e0e-4234-a528-609656809a3a",
714        "title": "To list the services in a cluster"
715      }
716    ],
717    "ListTagsForResource": [
718      {
719        "input": {
720          "resourceArn": "arn:aws:ecs:region:aws_account_id:cluster/dev"
721        },
722        "output": {
723          "tags": [
724            {
725              "key": "team",
726              "value": "dev"
727            }
728          ]
729        },
730        "comments": {
731          "input": {
732          },
733          "output": {
734          }
735        },
736        "description": "This example lists the tags for the 'dev' cluster.",
737        "id": "to-list-the-tags-for-a-cluster-1540582700259",
738        "title": "To list the tags for a cluster."
739      }
740    ],
741    "ListTaskDefinitionFamilies": [
742      {
743        "input": {
744        },
745        "output": {
746          "families": [
747            "node-js-app",
748            "web-timer",
749            "hpcc",
750            "hpcc-c4-8xlarge"
751          ]
752        },
753        "comments": {
754          "input": {
755          },
756          "output": {
757          }
758        },
759        "description": "This example lists all of your registered task definition families.",
760        "id": "b5c89769-1d94-4ca2-a79e-8069103c7f75",
761        "title": "To list your registered task definition families"
762      },
763      {
764        "input": {
765          "familyPrefix": "hpcc"
766        },
767        "output": {
768          "families": [
769            "hpcc",
770            "hpcc-c4-8xlarge"
771          ]
772        },
773        "comments": {
774          "input": {
775          },
776          "output": {
777          }
778        },
779        "description": "This example lists the task definition revisions that start with \"hpcc\".",
780        "id": "8a4cf9a6-42c1-4fe3-852d-99ac8968e11b",
781        "title": "To filter your registered task definition families"
782      }
783    ],
784    "ListTaskDefinitions": [
785      {
786        "input": {
787        },
788        "output": {
789          "taskDefinitionArns": [
790            "arn:aws:ecs:us-east-1:<aws_account_id>:task-definition/sleep300:2",
791            "arn:aws:ecs:us-east-1:<aws_account_id>:task-definition/sleep360:1",
792            "arn:aws:ecs:us-east-1:<aws_account_id>:task-definition/wordpress:3",
793            "arn:aws:ecs:us-east-1:<aws_account_id>:task-definition/wordpress:4",
794            "arn:aws:ecs:us-east-1:<aws_account_id>:task-definition/wordpress:5",
795            "arn:aws:ecs:us-east-1:<aws_account_id>:task-definition/wordpress:6"
796          ]
797        },
798        "comments": {
799          "input": {
800          },
801          "output": {
802          }
803        },
804        "description": "This example lists all of your registered task definitions.",
805        "id": "b381ebaf-7eba-4d60-b99b-7f6ae49d3d60",
806        "title": "To list your registered task definitions"
807      },
808      {
809        "input": {
810          "familyPrefix": "wordpress"
811        },
812        "output": {
813          "taskDefinitionArns": [
814            "arn:aws:ecs:us-east-1:<aws_account_id>:task-definition/wordpress:3",
815            "arn:aws:ecs:us-east-1:<aws_account_id>:task-definition/wordpress:4",
816            "arn:aws:ecs:us-east-1:<aws_account_id>:task-definition/wordpress:5",
817            "arn:aws:ecs:us-east-1:<aws_account_id>:task-definition/wordpress:6"
818          ]
819        },
820        "comments": {
821          "input": {
822          },
823          "output": {
824          }
825        },
826        "description": "This example lists the task definition revisions of a specified family.",
827        "id": "734e7afd-753a-4bc2-85d0-badddce10910",
828        "title": "To list the registered task definitions in a family"
829      }
830    ],
831    "ListTasks": [
832      {
833        "input": {
834          "cluster": "default"
835        },
836        "output": {
837          "taskArns": [
838            "arn:aws:ecs:us-east-1:012345678910:task/0cc43cdb-3bee-4407-9c26-c0e6ea5bee84",
839            "arn:aws:ecs:us-east-1:012345678910:task/6b809ef6-c67e-4467-921f-ee261c15a0a1"
840          ]
841        },
842        "comments": {
843          "input": {
844          },
845          "output": {
846          }
847        },
848        "description": "This example lists all of the tasks in a cluster.",
849        "id": "9a6ec707-1a77-45d0-b2eb-516b5dd9e924",
850        "title": "To list the tasks in a cluster"
851      },
852      {
853        "input": {
854          "cluster": "default",
855          "containerInstance": "f6bbb147-5370-4ace-8c73-c7181ded911f"
856        },
857        "output": {
858          "taskArns": [
859            "arn:aws:ecs:us-east-1:012345678910:task/0cc43cdb-3bee-4407-9c26-c0e6ea5bee84"
860          ]
861        },
862        "comments": {
863          "input": {
864          },
865          "output": {
866          }
867        },
868        "description": "This example lists the tasks of a specified container instance. Specifying a ``containerInstance`` value limits  the  results  to  tasks  that belong to that container instance.",
869        "id": "024bf3b7-9cbb-44e3-848f-9d074e1fecce",
870        "title": "To list the tasks on a particular container instance"
871      }
872    ],
873    "PutAccountSetting": [
874      {
875        "input": {
876          "name": "serviceLongArnFormat",
877          "value": "enabled"
878        },
879        "output": {
880          "setting": {
881            "name": "serviceLongArnFormat",
882            "value": "enabled",
883            "principalArn": "arn:aws:iam::<aws_account_id>:user/principalName"
884          }
885        },
886        "comments": {
887          "input": {
888          },
889          "output": {
890          }
891        },
892        "description": "This example modifies your account settings to opt in to the new ARN and resource ID format for Amazon ECS services. If you’re using this command as the root user, then changes apply to the entire AWS account, unless an IAM user or role explicitly overrides these settings for themselves.",
893        "id": "to-modify-the-account-settings-for-your-iam-user-account-1549523130939",
894        "title": "To modify your account settings"
895      },
896      {
897        "input": {
898          "name": "containerInstanceLongArnFormat",
899          "value": "enabled",
900          "principalArn": "arn:aws:iam::<aws_account_id>:user/principalName"
901        },
902        "output": {
903          "setting": {
904            "name": "containerInstanceLongArnFormat",
905            "value": "enabled",
906            "principalArn": "arn:aws:iam::<aws_account_id>:user/principalName"
907          }
908        },
909        "comments": {
910          "input": {
911          },
912          "output": {
913          }
914        },
915        "description": "This example modifies the account setting for a specific IAM user or IAM role to opt in to the new ARN and resource ID format for Amazon ECS container instances. If you’re using this command as the root user, then changes apply to the entire AWS account, unless an IAM user or role explicitly overrides these settings for themselves.",
916        "id": "to-modify-the-account-settings-for-a-specific-iam-user-or-iam-role-1549523518390",
917        "title": "To modify the account settings for a specific IAM user or IAM role"
918      }
919    ],
920    "PutAccountSettingDefault": [
921      {
922        "input": {
923          "name": "serviceLongArnFormat",
924          "value": "enabled"
925        },
926        "output": {
927          "setting": {
928            "name": "serviceLongArnFormat",
929            "value": "enabled",
930            "principalArn": "arn:aws:iam::<aws_account_id>:root"
931          }
932        },
933        "comments": {
934          "input": {
935          },
936          "output": {
937          }
938        },
939        "description": "This example modifies the default account setting for the specified resource for all IAM users or roles on an account. These changes apply to the entire AWS account, unless an IAM user or role explicitly overrides these settings for themselves.",
940        "id": "to-modify-the-default-account-settings-for-all-iam-users-or-roles-on-your-account-1549523794603",
941        "title": "To modify the default account settings for all IAM users or roles on an account"
942      }
943    ],
944    "RegisterTaskDefinition": [
945      {
946        "input": {
947          "containerDefinitions": [
948            {
949              "name": "sleep",
950              "command": [
951                "sleep",
952                "360"
953              ],
954              "cpu": 10,
955              "essential": true,
956              "image": "busybox",
957              "memory": 10
958            }
959          ],
960          "family": "sleep360",
961          "taskRoleArn": "",
962          "volumes": [
963
964          ]
965        },
966        "output": {
967          "taskDefinition": {
968            "containerDefinitions": [
969              {
970                "name": "sleep",
971                "command": [
972                  "sleep",
973                  "360"
974                ],
975                "cpu": 10,
976                "environment": [
977
978                ],
979                "essential": true,
980                "image": "busybox",
981                "memory": 10,
982                "mountPoints": [
983
984                ],
985                "portMappings": [
986
987                ],
988                "volumesFrom": [
989
990                ]
991              }
992            ],
993            "family": "sleep360",
994            "revision": 1,
995            "taskDefinitionArn": "arn:aws:ecs:us-east-1:<aws_account_id>:task-definition/sleep360:19",
996            "volumes": [
997
998            ]
999          }
1000        },
1001        "comments": {
1002          "input": {
1003          },
1004          "output": {
1005          }
1006        },
1007        "description": "This example registers a task definition to the specified family.",
1008        "id": "to-register-a-task-definition-1470764550877",
1009        "title": "To register a task definition"
1010      }
1011    ],
1012    "RunTask": [
1013      {
1014        "input": {
1015          "cluster": "default",
1016          "taskDefinition": "sleep360:1"
1017        },
1018        "output": {
1019          "tasks": [
1020            {
1021              "containerInstanceArn": "arn:aws:ecs:us-east-1:<aws_account_id>:container-instance/ffe3d344-77e2-476c-a4d0-bf560ad50acb",
1022              "containers": [
1023                {
1024                  "name": "sleep",
1025                  "containerArn": "arn:aws:ecs:us-east-1:<aws_account_id>:container/58591c8e-be29-4ddf-95aa-ee459d4c59fd",
1026                  "lastStatus": "PENDING",
1027                  "taskArn": "arn:aws:ecs:us-east-1:<aws_account_id>:task/a9f21ea7-c9f5-44b1-b8e6-b31f50ed33c0"
1028                }
1029              ],
1030              "desiredStatus": "RUNNING",
1031              "lastStatus": "PENDING",
1032              "overrides": {
1033                "containerOverrides": [
1034                  {
1035                    "name": "sleep"
1036                  }
1037                ]
1038              },
1039              "taskArn": "arn:aws:ecs:us-east-1:<aws_account_id>:task/a9f21ea7-c9f5-44b1-b8e6-b31f50ed33c0",
1040              "taskDefinitionArn": "arn:aws:ecs:us-east-1:<aws_account_id>:task-definition/sleep360:1"
1041            }
1042          ]
1043        },
1044        "comments": {
1045          "input": {
1046          },
1047          "output": {
1048          }
1049        },
1050        "description": "This example runs the specified task definition on your default cluster.",
1051        "id": "6f238c83-a133-42cd-ab3d-abeca0560445",
1052        "title": "To run a task on your default cluster"
1053      }
1054    ],
1055    "TagResource": [
1056      {
1057        "input": {
1058          "resourceArn": "arn:aws:ecs:region:aws_account_id:cluster/dev",
1059          "tags": [
1060            {
1061              "key": "team",
1062              "value": "dev"
1063            }
1064          ]
1065        },
1066        "output": {
1067        },
1068        "comments": {
1069          "input": {
1070          },
1071          "output": {
1072          }
1073        },
1074        "description": "This example tags the 'dev' cluster with key 'team' and value 'dev'.",
1075        "id": "to-tag-a-cluster-1540581863751",
1076        "title": "To tag a cluster."
1077      }
1078    ],
1079    "UntagResource": [
1080      {
1081        "input": {
1082          "resourceArn": "arn:aws:ecs:region:aws_account_id:cluster/dev",
1083          "tagKeys": [
1084            "team"
1085          ]
1086        },
1087        "output": {
1088        },
1089        "comments": {
1090          "input": {
1091          },
1092          "output": {
1093          }
1094        },
1095        "description": "This example deletes the 'team' tag from the 'dev' cluster.",
1096        "id": "to-untag-a-cluster-1540582546056",
1097        "title": "To untag a cluster."
1098      }
1099    ],
1100    "UpdateService": [
1101      {
1102        "input": {
1103          "service": "my-http-service",
1104          "taskDefinition": "amazon-ecs-sample"
1105        },
1106        "output": {
1107        },
1108        "comments": {
1109          "input": {
1110          },
1111          "output": {
1112          }
1113        },
1114        "description": "This example updates the my-http-service service to use the amazon-ecs-sample task definition.",
1115        "id": "cc9e8900-0cc2-44d2-8491-64d1d3d37887",
1116        "title": "To change the task definition used in a service"
1117      },
1118      {
1119        "input": {
1120          "desiredCount": 10,
1121          "service": "my-http-service"
1122        },
1123        "output": {
1124        },
1125        "comments": {
1126          "input": {
1127          },
1128          "output": {
1129          }
1130        },
1131        "description": "This example updates the desired count of the my-http-service service to 10.",
1132        "id": "9581d6c5-02e3-4140-8cc1-5a4301586633",
1133        "title": "To change the number of tasks in a service"
1134      }
1135    ]
1136  }
1137}
1138