cloudscale_ch.cloud.network 模块 – 管理 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.network。

cloudscale_ch.cloud 1.2.0 中的新增功能

概要 

创建、更新和删除网络。

参数 

参数	注释
api_timeout 整数	对 cloudscale.ch API 的调用的超时时间（秒）。这也可以在 `CLOUDSCALE_API_TIMEOUT` 环境变量中传递。默认值： `45`
api_token 字符串 / 必需	cloudscale.ch API 令牌。这也可以在 `CLOUDSCALE_API_TOKEN` 环境变量中传递。
api_url 字符串 cloudscale_ch.cloud 1.3.0 中新增	cloudscale.ch API URL。这也可以在 `CLOUDSCALE_API_URL` 环境变量中传递。默认值： `"https://api.cloudscale.ch/v1"`
auto_create_ipv4_subnet 布尔值	是否自动在网络中创建 IPv4 子网。选项 `false` `true` ← (默认)
mtu 整数	网络的 MTU。默认值： `9000`
name 字符串	网络的名称。需要 `name` 或 `uuid` 之一。
state 字符串	网络的状态。选项 `"present"` ← (默认) `"absent"`
tags 字典	与网络关联的标签。将其设置为 `{}` 以清除所有标签。
uuid 字符串	网络的 UUID。需要 `name` 或 `uuid` 之一。
zone 字符串	网络的区域标识符（例如 `lpg1` 或 `rma1`）。

备注 

注意

所有操作均使用 cloudscale.ch 公共 API v1 执行。
有关详细信息，请参阅完整的 API 文档： https://www.cloudscale.ch/en/api/v1。
所有操作都需要有效的 API 令牌。您可以使用 cloudscale.ch 控制面板在 https://control.cloudscale.ch 创建任意数量的令牌。

示例 

---
- name: Ensure network exists
  cloudscale_ch.cloud.network:
    name: my network
    api_token: xxxxxx

- name: Ensure network in a specific zone
  cloudscale_ch.cloud.network:
    name: my network
    zone: lpg1
    api_token: xxxxxx

- name: Ensure a network is absent
  cloudscale_ch.cloud.network:
    name: my network
    state: absent
    api_token: xxxxxx

返回值 

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

键	描述
created_at 字符串	网络的创建日期和时间。返回：成功示例： `"2019-05-29T13:18:42.511407Z"`
href 字符串	获取有关此网络详细信息的 API URL。返回：成功示例： `"https://api.cloudscale.ch/v1/networks/cfde831a-4e87-4a75-960f-89b0148aa2cc"`
mtu 整数	网络的 MTU。返回：成功示例： `9000`
name 字符串	网络的名称。返回：成功示例： `"my network"`
state 字符串	网络的状态。返回：成功示例： `"present"`
subnets 复杂类型	网络的子网对象列表。返回：成功
cidr 字符串	子网的 CIDR。返回：成功示例： `"172.16.0.0/24"`
href 字符串	获取有关子网详细信息的 API URL。返回：成功示例： `"https://api.cloudscale.ch/v1/subnets/33333333-1864-4608-853a-0771b6885a3"`
uuid 字符串	子网的唯一标识符。返回：成功示例： `"33333333-1864-4608-853a-0771b6885a3"`
tags 字典	与网络关联的标签。返回：成功示例： `{"project": "my project"}`
uuid 字符串	网络的唯一标识符。返回：成功示例： `"cfde831a-4e87-4a75-960f-89b0148aa2cc"`
zone 字典	网络的区域。返回：成功示例： `{"slug": "rma1"}`

作者

René Moser (@resmo)