Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »

MANAGE-VLAN(1)         AppNexus CLI Documentation v0.157        MANAGE-VLAN(1)

NAME
       manage-vlan - list VLANs, list/reserve/modify/release IP addresses

SYNOPSIS
       manage-vlan list [-s col_name | -b col_name] [-f filters] [-R]
       manage-vlan list-addresses [-a | -r | -u] [-s col_name | -b col_name] 
       [-f filters] [-R]
       manage-vlan reserve-address --ip address [-d description]
       manage-vlan modify-address --ip address -d description
       manage-vlan release-address --ip address
       manage-vlan history [--vlan-id vlan_id] [--depth number]
       manage-vlan command -h
       manage-vlan (help | -h) [command]
       manage-vlan -V

DESCRIPTION
       This command lets you list your VLANs, and list, reserve, modify, and release
       IP addresses in your VLANs. Reserving an IP address means it will not be used
       to launch an instance unless you explicitly specify it. You do not need to
       reserve an IP address from your VLAN before using it.

OPTIONS
       --vlan-id
           ID number of VLAN. Must be a composite string '<datacenter_id>:<vlan_id>',
           e.g. 'NYM1:1', 'LAX1:210'.

       --ip
           IP address to reserve, release, or modify. Must be a composite string
           '<datacenter_id>:<ip_address>', e.g. 'NYM1:192.168.128.1',
           'LAX1:192.168.128.2'.

       -a, --available
           List available IP addresses in your VLANs.

       -r, --reserved
           List IP addresses that you have already reserved.

       -u, --used
           List IP addresses that are used by your instances.

       -d, --description
           Optional custom description to attach to the IP address.

       --depth
           Number of most recent operations to show in history.  Default is 20.

       -s, --sort
           Column name(s) for sorting (ip_address, vlan_id, subnet, priority, state,
           instance_id, description). Use --sort <column_name1>{,<column_nameN>}.

       -b, --rsort
           Column name(s) for reverse sorting.

       -f, --filter
           Filter results by column name (ip_address, vlan_id, subnet, priority,
           state, instance_id, description). Use --filter <column_name1>=<pat-
           tern1>{,<patternN>} {<column_name2>=<pattern2>{,<patternN>} where {} indi-
           cates an optional parameter. Do not use a space between multiple patterns.
           For example, --filter state=reserved,available.

       -R, --raw
           Output data in tab-delimited form.

       -V, --version
           Version of the command-line interface you are currently using.

       -h, --help
           Display help.

COMMANDS
       list

           List all VLANs belonging to the customer.

           Required Parameters: none
           Optional Parameters: (-s/--sort | -b/--rsort), -f/--filter, -R/--raw

       list-addresses

           List all available IP addresses. Output includes VLAN ID; state (used,
           available, or reserved); instance ID if applicable; and description, if you
           have added one.

           Required Parameters: none
           Optional Parameters: (-a/--available | -r/--reserved | -u/--used),
           (-s/--sort | -b/--rsort), -f/--filter, -R/--raw

       reserve-address

           Reserve IP address from being automatically used for instance launch. You
           still can launch an instance with an already reserved IP address: pass the
           optional parameter '--ip' for the 'manage-instance launch' command.

           Required Parameters: --ip
           Optional Parameters: -d/--description

       modify-address

           Change or add a description for an IP address.

           Required Parameters: --ip, -d/--description
           Optional Parameters: none

       release-address

           Release a previously reserved IP address.

           Required Parameters: --ip
           Optional Parameters: none

       history

           Show history of operations on VLANs. If no particular VLAN is specified
           then operations on all VLANs will be displayed.

           Required Parameters: none
           Optional Parameters: --vlan-id, --depth

       help

           Show help.

           Required Parameters: none
           Optional Parameters: list, list-addresses, reserve-address, modify-address,
           release-address, history

SEE ALSO
       manage-instance, manage-server, manage-lb-ip, manage-lb-pool, manage-cdn-domain

0.157                             2009-01-15                    MANAGE-VLAN(1)

  • No labels