Documentation

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 your A10 Networks device
    password
    yes
      admin password of your A10 Networks device

      aliases: pass, pwd
      username
      yes
        admin account of your A10 Networks device

        aliases: user, admin
        validate_certs
        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
              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, Helping Testing PRs and Developing Modules.