W3cubDocs

/Ansible

a10_virtual_server - Manage A10 Networks devices’ virtual servers

New in version 1.8.

Synopsis

Manage slb virtual server objects on A10 Networks devices via aXAPI

Options

parameter required default choices comments
host
 yes
Hostname or IP of the A10 Networks device.
password
 yes
Password for the username account.
aliases: pass, pwd
username
 yes
An account with administrator privileges.
aliases: user, admin
validate_certs
(added in 2.2)
 no yes
  • yes
  • no
If no, SSL certificates will not be validated. This should only be used on personally controlled devices using self-signed certificates.
virtual_server
 yes
SLB virtual server name.
aliases: vip, virtual
virtual_server_ip
 no
SLB virtual server IP address.
aliases: ip, address
virtual_server_ports
 no
A list of ports to create for the virtual server. Each list item should be a dictionary which specifies the port: and type:, but can also optionally specify the service_group: as well as the status:. See the examples below for details. This parameter is required when state is present.
virtual_server_status
 no enable
  • enabled
  • disabled
SLB virtual server status.
aliases: status
write_config
(added in 2.2)
 no no
  • yes
  • no
If yes, any changes will cause a write of the running configuration to non-volatile memory. This will save all configuration changes, including those that may have been made manually or through other modules, so care should be taken when specifying yes.

Examples

# Create a new virtual server
- a10_virtual_server:
    host: a10.mydomain.com
    username: myadmin
    password: mypassword
    virtual_server: vserver1
    virtual_server_ip: 1.1.1.1
    virtual_server_ports:
      - port: 80
        protocol: TCP
        service_group: sg-80-tcp
      - port: 443
        protocol: HTTPS
        service_group: sg-443-https
      - port: 8080
        protocol: http
        status: disabled

Notes

Note

Requires A10 Networks aXAPI 2.1

This is an Extras Module

For more information on what this means please read Extras Modules

For help in developing on modules, should you be so inclined, please read Community Information & Contributing, developing_test_pr and Developing Modules.

© 2012–2016 Michael DeHaan
© 2016 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/a10_virtual_server_module.html