a10_service_group - Manage A10 Networks AX/SoftAX/Thunder/vThunder devices’ service groups.
New in version 1.8.
Synopsis
- Manage SLB (Server Load Balancing) service-group objects on A10 Networks devices via aXAPIv2.
Options
parameter | required | default | choices | comments |
---|---|---|---|---|
host |
yes |
Hostname or IP of the A10 Networks device.
|
||
partition
(added in 2.3)
|
no |
set active-partition
|
||
password |
yes |
Password for the
username account.
aliases: pass, pwd
|
||
servers |
no |
A list of servers to add to the service group. Each list item should be a dictionary which specifies the
server: and
port: , but can also optionally specify the
status: . See the examples below for details.
|
||
service_group |
yes |
The SLB (Server Load Balancing) service-group name
aliases: service, pool, group
|
||
service_group_method |
no | round-robin |
|
The SLB service-group load balancing method, such as round-robin or weighted-rr.
aliases: method
|
service_group_protocol |
no | tcp |
|
The SLB service-group protocol of TCP or UDP.
aliases: proto, protocol
|
username |
yes |
An account with administrator privileges.
aliases: user, admin
|
||
validate_certs |
no | yes |
|
If
no , SSL certificates will not be validated. This should only be used on personally controlled devices using self-signed certificates.
|
write_config
(added in 2.2)
|
no | 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 service-group - a10_service_group: host: a10.mydomain.com username: myadmin password: mypassword partition: mypartition service_group: sg-80-tcp servers: - server: foo1.mydomain.com port: 8080 - server: foo2.mydomain.com port: 8080 - server: foo3.mydomain.com port: 8080 - server: foo4.mydomain.com port: 8080 status: disabled
Return Values
Common return values are documented here Return Values, the following are the fields unique to this module:
name | description | returned | type | sample |
---|---|---|---|---|
content |
the full info regarding the slb_service_group
|
success | string | mynewservicegroup |
Notes
Note
- Requires A10 Networks aXAPI 2.1.
- When a server doesn’t exist and is added to the service-group the server will be created.
- Requires A10 Networks aXAPI 2.1
Status
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Testing Ansible and Developing Modules.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/a10_service_group_module.html