NAME
na - NGS AWS. Command line for AWS.
SYNOPSIS
na [--digest N] resource-specification …
na resource-specification … SET new-tags-and-properties
na resource-specification … DEL
na resource-specification … COUNT
DESCRIPTION
na is a thin wrapper around AWS library in NGS, which in turn uses declarative primitives approach. This means among other things that na is idempotent.
na Allows to manipulate AWS resources. The first variant, without any command shows the specified resource(s). "SET" variant is used for updating the specified resource(s). "DEL" deletes the resources. "COUNT" shows the number of specified resources.
OPTIONS
--digest N (default 10). na is human oriented. Since it’s usually not helpful to have thousands of lines dumped into your screen (not likely to be processed in a meaningful manner by a human), na limits the number of items it outputs. --digest gives the number of items starting at which the output is shown as a digest of the items and not the items themselves.
RESOURCE SPECIFICATION
Option 1 - resource id
RESOURCE-ID – vpc-11111111, subnet-22222222, etc
Option 2 - resource prefix, optional tags, optional properties
RESOURCE-PREFIX TAG_NAME=TAG_VALUE … PROPERTY_NAME:PROPERTY_VALUE …
Where RESOURCE-PREFIX - i, vpc, sg and others as seen in output of aws ... describe-...
commands.
Related resources
resource-specification can be repeated on the command line. In this case the specified resource to show or operate is the resource specified on the right. When na will look up resources on the right, it will restrict the search to resources mentioned to the left:
# Show all subnets in VPC which is has tag "env" with value "proxy-lab" na vpc env=proxy-lab subnet
SPECIFYING NEW TAGS AND PROPERTIES
The syntax after "SET" is TAG_NAME=TAG_VALUE … PROPERTY_NAME:PROPERTY_VALUE … (which is the same syntax as for specified resources option 2 just without the RESOURCE-PREFIX)
EXAMPLES
# Show all VPCs and Subnets na vpc na subnet # Stop these VMs na i role=ocsp-proxy env=dev SET State:stopped # Show these VMs na i role=ocsp-proxy env=dev # Start these VMs na i role=ocsp-proxy env=dev State:'*' SET State:running # Show all subnets in VPC which is has tag "env" with value "proxy-lab" # "Related resources" concept na vpc env=proxy-lab subnet # Show how many VPCs you have (in current region as seen by AWS CLI) na vpc COUNT
AUTHORS
- Ilya Sher