openstack-python-openstackc.../doc/source/command-objects/network-agent.rst
Shashank Kumar Shankar f4fd8f6e31 Introduce Neutron DHCP agent commands to OSC
This patch introduces neutron dhcp-agent related commands to OpenStack
client.

The equivalent neutron commands implemented in OSC:

neutron: dhcp-agent-list-hosting-net
OSC: network agent list --network

neutron: dhcp-agent-network-add
OSC: network agent add network

neutron: dhcp-agent-network-remove
OSC: network agent remove network

neutron: net-list-on-dhcp-agent
OSC: network list --agent

Change-Id: I77a933f4b3ce875c63cef5b6a32aee78fd844b03
2017-03-20 15:02:09 -04:00

151 lines
2.9 KiB
ReStructuredText

=============
network agent
=============
A **network agent** is an agent that handles various tasks used to
implement virtual networks. These agents include neutron-dhcp-agent,
neutron-l3-agent, neutron-metering-agent, and neutron-lbaas-agent,
among others. The agent is available when the alive status of the
agent is "True".
Network v2
network agent add network
-------------------------
Add network to an agent
.. program:: network agent add network
.. code:: bash
openstack network agent add network
[--dhcp]
<agent-id>
<network>
.. describe:: --dhcp
Add a network to DHCP agent.
.. describe:: <agent-id>
Agent to which a network is added. (ID only)
.. describe:: <network>
Network to be added to an agent. (ID or name)
network agent delete
--------------------
Delete network agent(s)
.. program:: network agent delete
.. code:: bash
openstack network agent delete
<network-agent> [<network-agent> ...]
.. _network_agent_delete-network-agent:
.. describe:: <network-agent>
Network agent(s) to delete (ID only)
network agent list
------------------
List network agents
.. program:: network agent list
.. code:: bash
openstack network agent list
[--agent-type <agent-type>]
[--host <host>]
[--network <network>]
.. option:: --agent-type <agent-type>
List only agents with the specified agent type.
The supported agent types are: dhcp, open-vswitch,
linux-bridge, ofa, l3, loadbalancer, metering,
metadata, macvtap, nic.
.. option:: --host <host>
List only agents running on the specified host
.. option:: --network <network>
List agents hosting a network. (ID or name)
network agent set
-----------------
Set network agent properties
.. program:: network agent set
.. code:: bash
openstack network agent set
[--description <description>]
[--enable | --disable]
<network-agent>
.. option:: --description <description>
Set network agent description
.. option:: --enable
Enable network agent
.. option:: --disable
Disable network agent
.. _network_agent_set-network-agent:
.. describe:: <network-agent>
Network agent to modify (ID only)
network agent show
------------------
Display network agent details
.. program:: network agent show
.. code:: bash
openstack network agent show
<network-agent>
.. _network_agent_show-network-agent:
.. describe:: <network-agent>
Network agent to display (ID only)
network agent remove network
----------------------------
Remove network from an agent
.. program:: network agent remove network
.. code:: bash
openstack network agent remove network
[--dhcp]
<agent-id>
<network>
.. describe:: --dhcp
Remove network from DHCP agent.
.. describe:: <agent-id>
Agent to which a network is removed. (ID only)
.. describe:: <network>
Network to be removed from an agent. (ID or name)