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]
       [--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 (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.0>

home | help