INSPEEK

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
SEE ALSO
AUTHORS
BUG REPORTS
COPYRIGHT

---

NAME

ispeek - EC2 instance store lister

SYNOPSIS

ispeek [-NQTdr] [-D STRING] [-b URL] [-p NUMBER] [--base-url=URL] [--delimiter=STRING] [--names] [--quote] [--type] [--port=NUMBER] PATH [KEY...]
ispeek [-Vh] [--help] [--usage] [--version]

DESCRIPTION

Lists contents of the EC2 instance store. The PATH argument specifies the pathname to list. It is relative to http://169.254.169.254/latest. If PATH ends with a slash, it is treated as a directory and its content is listed. Otherwise, it is treated as a file.

Optional KEY arguments are allowed when listing content of a file. If one or more KEYs are given, the file is parsed as a JSON object. For each KEY, a corresponding value is looked up in the resulting object and printed on a separate line, prefixed with KEY and a colon.

The utility must be run from a EC2 instance.

OPTIONS

-b, --base=URL

Base URL to use, instead of http://169.254.169.254/latest.

-d, --debug

Increase debugging level.

-p, --port=NUMBER

Set remote port number, instead of the default 80.

Following option applies only when listing directories:
-r, --recursive

List directories recursively.

The options below configure output if at least one KEY is given:
-D, --delimiter=STRING

Delimit output values with STRING. Default delimiter is a colon.

-N, --names

Print key names.

-Q, --quote

Quote string values. String values will be enclosed in double-quotes. Double-quote and backslash characters appearing within strings will be escaped with backslashes.

-T, --type

Print type character. Type characters are: 0, for null values, b, for booleans, n, for numeric values, s, for strings , a, for arrays, and o, for objects.

The order of printing is: key name, type, value.
-V, --version

Print program version.

-h, --help

Give a concise help summary.

--usage

Give a short usage message.

EXAMPLES

Get instance ID
$ ispeek /meta-data/instance-id
i-deadbeef

Print instance data
$ ispeek /dynamic/instance-identity/document
{
"instanceId" : "i-deadbeef",
"billingProducts" : null,
...

Read availability region and instance type
$ ispeek /dynamic/instance-identity/document region instanceType
eu-west-1
m3.xlarge

Same, including key names and types in the output
$ ispeek -NT /dynamic/instance-identity/document region instanceType
region:s:eu-west-1
instanceType:s:m3.xlarge

Recursively list the contents of /meta-data/iam:
$ ispeek -r meta-data/iam
/meta-data/iam/info
/meta-data/iam/security-credentials/
/meta-data/iam/security-credentials/user

SEE ALSO

eclat(1).

AUTHORS

Sergey Poznyakoff

BUG REPORTS

Report bugs to <bug-eclat@gnu.org.ua>.

COPYRIGHT

Copyright © 2012-2018 Sergey Poznyakoff
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

---