Sha256: 934e4b3a15a8d8274fa21001f71fca7949186c17bbdfe797b6acfdedf75dace8

Contents?: true

Size: 1.49 KB

Versions: 14

Compression:

Stored size: 1.49 KB

Contents

---
title: Sonic List
---

Sonic provides a quick way to list your instances.

```sh
sonic list [FILTER]
```

Example:

```sh
sonic list i-066b140d9479e9681,i-09482b1a6e330fbf7
sonic list ec2-tag-1,ec2-tag-2
```

You should see something like this:

```sh
$ sonic list i-066b140d9479e9681,i-09482b1a6e330fbf7
i-09482b1a6e330fbf7 prod-20170416110240 54.202.152.168  172.31.21.108 t2.small
i-066b140d9479e9681 docker-20170428071833 34.211.144.113  172.31.11.250 m3.medium
$
```

You can include a header with the `--header` option:

```sh
$ sonic list i-066b140d9479e9681,i-09482b1a6e330fbf7 --header
Instance Id Name  Public IP Private IP  Type
i-09482b1a6e330fbf7 prod-20170416110240 54.202.152.168  172.31.21.108 t2.small
i-066b140d9479e9681 docker-20170428071833 34.211.144.113  172.31.11.250 m3.medium
$
```

The list command can be helpful if you want to list out the instances and pipe it back into other tools. Here's a simple example:

```sh
$ for i in $(sonic list i-066b140d9479e9681,i-09482b1a6e330fbf7 | awk '{print $3}') ; do echo $i ; ssh ec2-user@$i uptime ; done
54.202.152.168
 17:39:14 up 6 days,  1:24,  0 users,  load average: 0.00, 0.00, 0.00
34.211.144.113
 17:39:14 up 3 days, 12:03,  0 users,  load average: 0.00, 0.00, 0.00
$
```

<a id="prev" class="btn btn-basic" href="{% link _docs/tutorial-execute.md %}">Back</a>
<a id="next" class="btn btn-primary" href="{% link _docs/settings.md %}">Next Step</a>
<p class="keyboard-tip">Pro tip: Use the <- and -> arrow keys to move back and forward.</p>

Version data entries

14 entries across 14 versions & 1 rubygems

Version Path
sonic-screwdriver-2.2.7 docs/_docs/tutorial-list.md
sonic-screwdriver-2.2.6 docs/_docs/tutorial-list.md
sonic-screwdriver-2.2.5 docs/_docs/tutorial-list.md
sonic-screwdriver-2.2.4 docs/_docs/tutorial-list.md
sonic-screwdriver-2.2.3 docs/_docs/tutorial-list.md
sonic-screwdriver-2.2.2 docs/_docs/tutorial-list.md
sonic-screwdriver-2.2.1 docs/_docs/tutorial-list.md
sonic-screwdriver-2.2.0 docs/_docs/tutorial-list.md
sonic-screwdriver-2.1.1 docs/_docs/tutorial-list.md
sonic-screwdriver-2.1.0 docs/_docs/tutorial-list.md
sonic-screwdriver-2.0.0 docs/_docs/tutorial-list.md
sonic-screwdriver-1.4.0 docs/_docs/tutorial-list.md
sonic-screwdriver-1.3.2 docs/_docs/tutorial-list.md
sonic-screwdriver-1.3.0 docs/_docs/tutorial-list.md