a10_service_group – Manage A10 Networks AX/SoftAX/Thunder/vThunder devices’ service groups
a10_service_group – Manage A10 Networks AX/SoftAX/Thunder/vThunder devices’ service groups
Synopsis
- Manage SLB (Server Load Balancing) service-group 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
| |
servers - |
A list of servers to add to the service group. Each list item should be a dictionary which specifies the
| |
service_group - / required |
The SLB (Server Load Balancing) service-group name
| |
service_group_method - |
|
The SLB service-group load balancing method, such as round-robin or weighted-rr.
|
service_group_protocol - |
|
The SLB service-group protocol of TCP or UDP.
|
state - |
|
If the specified service group should exists. |
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 |
write_config boolean added in 2.2 |
|
If |
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.
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, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
content string |
success |
the full info regarding the slb_service_group
Sample: mynewservicegroup |
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)
- Mischa Peters (@mischapeters)
© 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_service_group_module.html