Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
INSPEEK(1)		      Eclat User Reference		      INSPEEK(1)

NAME
     ispeek - EC2 instance store lister

SYNOPSIS
     ispeek [-NQTdr] [-D STRING] [-b URL] [-p NUMBER] [--base-url=URL] [--delim-
     iter=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-cre-
     dentials/ /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 (C) 2012-2018 Sergey Poznyakoff
     License GPLv3+: GNU GPL version 3 or later <http://gnu.org/li-
     censes/gpl.html>
     This  is  free software: you are free to change and redistribute it.  There
     is NO WARRANTY, to the extent permitted by law.

INSPEEK 			January 21, 2015		      INSPEEK(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ispeek&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help