cloudscale_ch.cloud.subnet 模块 – 管理 cloudscale.ch IaaS 服务上的子网
注意
此模块是 cloudscale_ch.cloud 集合 (版本 2.4.0) 的一部分。
如果您使用的是 ansible 软件包，则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。
要安装它，请使用： ansible-galaxy collection install cloudscale_ch.cloud。
要在剧本中使用它，请指定： cloudscale_ch.cloud.subnet。
cloudscale_ch.cloud 1.3.0 中的新增功能
概要
创建、更新和删除子网。
参数
参数 |
注释 |
|---|---|
对 cloudscale.ch API 的调用的超时时间（秒）。 这也可以在 默认值： |
|
cloudscale.ch API 令牌。 这也可以在 |
|
cloudscale.ch API URL。 这也可以在 默认值： |
|
子网的 CIDR。 如果 state=present，则需要此参数。 |
|
充当 DNS 服务器的 DNS 解析器 IP 地址列表。 如果未设置，则使用 cloudscale.ch 默认解析器。 |
|
子网的网关地址。如果未设置，则不使用网关。 不能位于 DHCP 范围内，DHCP 范围是子网中最小的 .101-.254。 |
|
子网相关的网络名称。 如果 state=present，则需要此参数。 |
|
网络的 UUID。 |
|
网络的 UUID。 |
|
网络分配到的区域。 |
|
将 gateway_address 和 dns_servers 重置为 API 的默认值。 注意：不保证幂等性。 选项
|
|
子网的状态。 选项
|
|
与子网关联的标签。将其设置为 |
|
子网的 UUID。 |
注释
注意
所有操作都是使用 cloudscale.ch 公共 API v1 执行的。
有关详细信息，请参阅完整的 API 文档：https://www.cloudscale.ch/en/api/v1。
所有操作都需要有效的 API 令牌。您可以使用 cloudscale.ch 控制面板在 https://control.cloudscale.ch 创建任意数量的令牌。
示例
---
- name: Ensure subnet exists
cloudscale_ch.cloud.subnet:
cidr: 172.16.0.0/24
network:
uuid: 2db69ba3-1864-4608-853a-0771b6885a3a
api_token: xxxxxx
- name: Ensure subnet exists
cloudscale_ch.cloud.subnet:
cidr: 192.168.1.0/24
gateway_address: 192.168.1.1
dns_servers:
- 192.168.1.10
- 192.168.1.11
network:
name: private
zone: lpg1
api_token: xxxxxx
- name: Ensure a subnet is absent
cloudscale_ch.cloud.subnet:
cidr: 172.16.0.0/24
network:
name: private
zone: lpg1
state: absent
api_token: xxxxxx
返回值
常见的返回值已在 此处 记录，以下是此模块特有的字段
键 |
描述 |
|---|---|
子网的 CIDR。 返回： 成功 示例： |
|
DNS 解析器 IP 地址列表。 返回： 成功 示例： |
|
子网的网关地址。 返回： 成功 示例： |
|
获取子网详细信息的 API URL。 返回： 成功 示例： |
|
子网的网络对象。 返回： 成功 |
|
获取网络详细信息的 API URL。 返回： 成功 示例： |
|
网络名称。 返回： 成功 示例： |
|
网络的唯一标识符。 返回： 成功 示例： |
|
网络分配到的区域。 返回： 成功 示例： |
|
子网的状态。 返回： 成功 示例： |
|
与子网关联的标签。 返回： 成功 示例： |
|
子网的唯一标识符。 返回： 成功 示例： |