community.network.a10_virtual_server 模块 – 管理 A10 Networks AX/SoftAX/Thunder/vThunder 设备的虚拟服务器。

注意

此模块是 community.network 集合 (版本 5.1.0) 的一部分。

如果您正在使用 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.network。

要在 playbook 中使用它，请指定：community.network.a10_virtual_server。

注意

community.network 集合已被弃用，并将从 Ansible 12 中删除。有关更多信息，请参阅讨论线程。

已弃用

在以下版本中移除:

版本 6.0.0

原因:

此集合及其中的所有内容都未维护且已弃用。

替代方案:

未知。

概要

• 通过 aXAPIv2 管理 A10 Networks 设备上的 SLB（服务器负载均衡）虚拟服务器对象。

别名：network.a10.a10_virtual_server

参数

参数	注释
client_cert 路径	用于 SSL 客户端身份验证的 PEM 格式的证书链文件。 此文件也可以包含密钥，如果包含密钥，则不需要 client_key。
client_key 路径	PEM 格式的文件，其中包含用于 SSL 客户端身份验证的私钥。 如果 client_cert 同时包含证书和密钥，则不需要此选项。
force 布尔值	如果 yes，则不获取缓存的副本。 选择 false ← (默认) true
force_basic_auth 布尔值	使用 url_username 和 url_password 指定的凭据应在 HTTP 标头中传递。 选择 false ← (默认) true
host 字符串 / 必需	A10 Networks 设备的主机名或 IP。
http_agent 字符串	标识为的标头，通常出现在 Web 服务器日志中。 默认： "ansible-httpget"
partition 字符串	设置 active-partition
password 别名：pass, pwd 字符串 / 必需	username 帐户的密码。
state 字符串	指定的虚拟服务器是否应存在。 选择 "present" ← (默认) "absent"
url 字符串	HTTP、HTTPS 或 FTP URL，格式为 (http|https|ftp)://[user[:pass]]@host.domain[:port]/path
url_password 字符串	用于 HTTP 基本身份验证的密码。 如果未指定 url_username 参数，则不会使用 url_password 参数。
url_username 字符串	用于 HTTP 基本身份验证的用户名。 此参数可以在允许空密码的站点上不使用 url_password 的情况下使用
use_gssapi 布尔值 在 ansible-core 2.11 中添加	使用 GSSAPI 执行身份验证，通常用于 Kerberos 或通过 Negotiate 身份验证的 Kerberos。 需要安装 Python 库 gssapi。 可以使用 url_username/url_password 或 GSSAPI 环境变量 KRB5CCNAME（指定自定义 Kerberos 凭据缓存）来指定 GSSAPI 的凭据。 即使安装了 NTLM 的 GSSAPI 机制，也不支持 NTLM 身份验证。 选择 false ← (默认) true
use_proxy 布尔值	如果 no，即使在目标主机上的环境变量中定义了代理，也不会使用代理。 选择 false true ← (默认)
username 别名：admin, user 字符串 / 必需	具有管理员权限的帐户。
validate_certs 布尔值	如果 no，则不会验证 SSL 证书。这应该仅在个人控制的设备上使用自签名证书时使用。 选择 false true ← (默认)
virtual_server 别名：vip, virtual 字符串 / 必需	SLB（服务器负载均衡）虚拟服务器名称。
virtual_server_ip 别名：ip, address 字符串	SLB 虚拟服务器 IPv4 地址。
virtual_server_ports 字符串	要为虚拟服务器创建的端口列表。每个列表项都应该是一个字典，指定 port: 和 type:，也可以选择指定 service_group: 以及 status:。有关详细信息，请参见下面的示例。当 state 为 present 时，此参数是必需的。
virtual_server_status 别名: status 字符串	SLB 虚拟服务器状态，例如启用或禁用。 选择 "enabled" "disabled" 默认值: "enable"
write_config 布尔值	如果为 yes，任何更改都将导致运行配置写入非易失性内存。这将保存所有配置更改，包括可能手动或通过其他模块进行的更改，因此在指定 yes 时应小心。 选择 false ← (默认) true

备注

注意

• 需要 A10 Networks aXAPI 2.1。

• 需要 A10 Networks aXAPI 2.1。

示例

- name: Create a new virtual server
  community.network.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

返回值

常见返回值记录在此处，以下是此模块特有的字段

键	描述
内容 字符串	有关 slb_virtual 的完整信息 已返回: 成功 示例: "mynewvirtualserver"

状态

• 此模块将在 6.0.0 版本中删除。[已弃用]

• 有关更多信息，请参见 已弃用。

作者

• Eric Chou (@ericchou1)

• Mischa Peters (@mischapeters)

集合链接

• 问题跟踪器
• 存储库（源代码）