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

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.