ngine_io.cloudstack.cs_zone 模块 – 管理基于 Apache CloudStack 的云上的区域。
注意
此模块是 ngine_io.cloudstack 集合(版本 2.5.0)的一部分。
如果您正在使用 ansible
包,您可能已经安装了此集合。它不包含在 ansible-core
中。要检查是否已安装,请运行 ansible-galaxy collection list
。
要安装它,请使用:ansible-galaxy collection install ngine_io.cloudstack
。您需要其他要求才能使用此模块,有关详细信息,请参阅 要求。
要在剧本中使用它,请指定:ngine_io.cloudstack.cs_zone
。
ngine_io.cloudstack 0.1.0 中的新功能
概要
创建、更新和删除区域。
要求
执行此模块的主机需要满足以下要求。
python >= 2.6
cs >= 0.9.0
参数
参数 |
注释 |
---|---|
用于查询 API 端点的 HTTP 方法。 如果未给出,则考虑 选项
|
|
CloudStack API 的 API 密钥。 如果未给出,则考虑 |
|
CloudStack API 的密钥。 如果未设置,则考虑 |
|
HTTP 超时时间(秒)。 如果未给出,则考虑 默认值: |
|
CloudStack API 的 URL,例如 https://cloud.example.com/client/api。 如果未给出,则考虑 |
|
验证 CA 授权证书文件。 如果未给出,则考虑 |
|
区域的 DHCP 提供程序。 |
|
区域的第一个 DNS。 如果 state=present,则为必需 |
|
区域的第一个 IPv6 DNS。 |
|
区域的第二个 DNS。 |
|
区域的第二个 IPv6 DNS。 |
|
区域所属的域。 如果未设置,则区域为公共区域。 |
|
区域的访客 CIDR 地址。 |
|
现有区域的 uuid。 |
|
区域的第一个内部 DNS。 如果未设置,则在 state=present 时将使用 dns1。 |
|
区域的第二个内部 DNS。 |
|
是否为区域启用本地存储。 选项
|
|
区域的名称。 |
|
区域的网络域。 |
|
区域的网络类型。 选项
|
|
区域是否启用了安全组。 选项
|
|
区域的状态。 选项
|
|
如果 如果未给出,则考虑 这仅应在个人控制的站点上使用自签名证书。 选项
|
注释
注意
有关 cloudstack 模块的详细指南,请参见 CloudStack 云指南。
此模块支持检查模式。
示例
- name: Ensure a zone is present
ngine_io.cloudstack.cs_zone:
name: ch-zrh-ix-01
dns1: 8.8.8.8
dns2: 8.8.4.4
network_type: basic
- name: Ensure a zone is disabled
ngine_io.cloudstack.cs_zone:
name: ch-zrh-ix-01
state: disabled
- name: Ensure a zone is enabled
ngine_io.cloudstack.cs_zone:
name: ch-zrh-ix-01
state: enabled
- name: Ensure a zone is absent
ngine_io.cloudstack.cs_zone:
name: ch-zrh-ix-01
state: absent
返回值
常见返回值记录在 此处,以下是此模块特有的字段
键 |
描述 |
---|---|
区域的状态。 返回: 成功 示例: |
|
区域的 DHCP 提供程序 返回: 成功 示例: |
|
区域的第一个 DNS。 返回: 成功 示例: |
|
区域的第一个 IPv6 DNS。 返回: 成功 示例: |
|
区域的第二个 DNS。 返回: 成功 示例: |
|
区域的第二个 IPv6 DNS。 返回: 成功 示例: |
|
区域所属的域。 返回: 成功 示例: |
|
区域的访客 CIDR 地址 返回: 成功 示例: |
|
区域的 UUID。 返回: 成功 示例: |
|
区域的第一个内部 DNS。 返回: 成功 示例: |
|
区域的第二个内部 DNS。 返回: 成功 示例: |
|
是否启用本地存储。 返回: 成功 示例: |
|
区域的名称。 返回: 成功 示例: |
|
区域的网络域。 返回: 成功 示例: |
|
区域的网络类型。 返回: 成功 示例: |
|
是否启用安全组支持。 返回: 成功 示例: |
|
与区域关联的资源标签列表。 返回: 成功 示例: |
|
区域令牌 返回: 成功 示例: |