a10_virtual_server – Manage A10 Networks AX/SoftAX/Thunder/vThunder devices’ virtual servers
a10_virtual_server – Manage A10 Networks AX/SoftAX/Thunder/vThunder devices’ virtual servers
Synopsis
- Manage SLB (Server Load Balancing) virtual server objects on A10 Networks devices via aXAPIv2.
Parameters
Parameter | Choices/Defaults | Comments |
---|---|---|
client_cert path |
PEM formatted certificate chain file to be used for SSL client authentication. This file can also include the key as well, and if the key is included, | |
client_key path |
PEM formatted file that contains your private key to be used for SSL client authentication. If | |
force boolean |
|
If
|
force_basic_auth boolean |
|
Credentials specified with url_username and url_password should be passed in HTTP Header. |
host string / required |
Hostname or IP of the A10 Networks device. | |
http_agent string |
Default: "ansible-httpget" |
Header to identify as, generally appears in web server logs. |
partition - added in 2.3 |
set active-partition | |
password string / required |
Password for the
| |
state - |
|
If the specified virtual server should exist. |
url string |
HTTP, HTTPS, or FTP URL in the form (http|https|ftp)://[user[:pass]]@host.domain[:port]/path | |
url_password string |
The password for use in HTTP basic authentication. If the url_username parameter is not specified, the url_password parameter will not be used. | |
url_username string |
The username for use in HTTP basic authentication. This parameter can be used without url_password for sites that allow empty passwords | |
use_proxy boolean |
|
If |
username string / required |
An account with administrator privileges.
| |
validate_certs boolean added in 2.2 |
|
If |
virtual_server - / required |
The SLB (Server Load Balancing) virtual server name.
| |
virtual_server_ip - |
The SLB virtual server IPv4 address.
| |
virtual_server_ports - |
A list of ports to create for the virtual server. Each list item should be a dictionary which specifies the | |
virtual_server_status - |
Default: "enable" |
The SLB virtual server status, such as enabled or disabled.
|
write_config boolean added in 2.2 |
|
If |
Notes
Note
- Requires A10 Networks aXAPI 2.1.
- Requires A10 Networks aXAPI 2.1.
Examples
# Create a new virtual server
- a10_virtual_server:
host: a10.mydomain.com
username: myadmin
password: mypassword
partition: mypartition
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
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
content string |
success |
the full info regarding the slb_virtual
Sample: mynewvirtualserver |
Status
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors
- Eric Chou (@ericchou) 2016, Mischa Peters (@mischapeters) 2014
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/a10_virtual_server_module.html