cloudscale_ch.cloud.load_balancer_pool_member 模块 – 管理 cloudscale.ch IaaS 服务上的负载均衡器池成员
注意
此模块是 cloudscale_ch.cloud 集合(版本 2.4.0)的一部分。
如果您使用的是 ansible 包,您可能已经安装了这个集合。它不包含在 ansible-core 中。要检查它是否已安装,请运行 ansible-galaxy collection list。
要安装它,请使用:ansible-galaxy collection install cloudscale_ch.cloud。
要在 playbook 中使用它,请指定:cloudscale_ch.cloud.load_balancer_pool_member。
cloudscale_ch.cloud 2.3.0 中的新功能
概要
- 在 cloudscale.ch IaaS 服务上获取、创建、更新、删除池成员。 
参数
| 参数 | 注释 | 
|---|---|
| 流量发送到的 IP 地址。 | |
| 调用 cloudscale.ch API 的超时时间(秒)。 也可以在  默认值:  | |
| cloudscale.ch API 令牌。 也可以在  | |
| cloudscale.ch API URL。 也可以在  默认值:  | |
| 如果为 false,池成员将不会接收流量。默认为 true。 选项 
 | |
| 负载均衡器池的 UUID。 | |
| 发送运行状况监控检查的端口。 如果未指定,将使用 protocol_port。默认为 null。 | |
| 负载均衡器池成员的名称。 需要 name 或 uuid 中的一个。 | |
| 实际流量发送到的端口。 | |
| 负载均衡器池成员的状态。 选项 
 | |
| 必须在此处指定地址的子网。 | |
| 与负载均衡器关联的标签。将其设置为  | |
| 负载均衡器的 UUID。 需要 name 或 uuid 中的一个。 | 
注意
注意
- 如果提供了 uuid 选项,则在池成员选择方面,它优先于 name。这允许更新成员的名称。 
- 如果未提供 uuid 选项,则使用 name 进行池成员选择。如果存在多个具有此名称的负载均衡器,则执行中止。 
- 所有操作均使用 cloudscale.ch 公共 API v1 执行。 
- 有关详细信息,请参阅完整的 API 文档:https://www.cloudscale.ch/en/api/v1。 
- 所有操作都需要有效的 API 令牌。您可以使用 cloudscale.ch 控制面板在 https://control.cloudscale.ch 创建任意数量的令牌。 
示例
# Create a pool member for a load balancer pool using registered variables
- name: Create a load balancer pool
  cloudscale_ch.cloud.load_balancer_pool:
    name: 'swimming-pool'
    load_balancer: '514064c2-cfd4-4b0c-8a4b-c68c552ff84f'
    algorithm: 'round_robin'
    protocol: 'tcp'
    tags:
      project: ansible-test
      stage: production
      sla: 24-7
    api_token: xxxxxx
  register: load_balancer_pool
- name: Create a load balancer pool member
  cloudscale_ch.cloud.load_balancer_pool_member:
    name: 'my-shiny-swimming-pool-member'
    load_balancer_pool: '{{ load_balancer_pool.uuid }}'
    enabled: true
    protocol_port: 8080
    monitor_port: 8081
    subnet: '70d282ab-2a01-4abb-ada5-34e56a5a7eee'
    address: '172.16.0.100'
    tags:
      project: ansible-test
      stage: production
      sla: 24-7
    api_token: xxxxxx
# Get load balancer pool member facts by name
- name: Get facts of a load balancer pool member by name
  cloudscale_ch.cloud.load_balancer_pool_member:
    name: 'my-shiny-swimming-pool-member'
    api_token: xxxxxx
返回值
常见的返回值在此处记录,以下是此模块特有的字段
| 键 | 描述 | 
|---|---|
| 流量发送到的 IP 地址 已返回:成功 示例:  | |
| 负载均衡器池成员的创建日期和时间 已返回:当 state != absent 时成功 示例:  | |
| 负载均衡器池成员的状态 已返回:成功 示例:  | |
| 用于获取有关此负载均衡器详细信息的 API URL 已返回:当 state != absent 时成功 示例:  | |
| 发送运行状况监控检查的端口 已返回:成功 示例:  | |
| 此成员的池运行状况监控检查状态 已返回:成功 示例:  | |
| 负载均衡器池成员的显示名称 已返回:成功 示例:  | |
| 池成员的池 已返回:成功 示例:  | |
| 实际流量发送到的端口 已返回:成功 示例:  | |
| 地址所在的私有网络中的子网 已返回:成功 示例:  | |
| 与负载均衡器关联的标签 已返回:成功 示例:  | |
| 此负载均衡器池成员的唯一标识符 已返回:成功 示例:  | 
