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。您需要其他要求才能使用此模块，有关详细信息，请参见 要求。

要在 playbook 中使用它，请指定： ngine_io.cloudstack.cs_zone。

ngine_io.cloudstack 0.1.0 中的新增功能

概要

• 创建、更新和删除区域。

要求

以下要求是在执行此模块的主机上所需的。

• python >= 2.6

• cs >= 0.9.0

参数

参数	注释
api_http_method 字符串	用于查询 API 端点的 HTTP 方法。 如果未给出，则考虑 CLOUDSTACK_METHOD 环境变量。 选项 "get" ← (默认) "post"
api_key 字符串 / 必需	CloudStack API 的 API 密钥。 如果未给出，则考虑 CLOUDSTACK_KEY 环境变量。
api_secret 字符串 / 必需	CloudStack API 的密钥。 如果未设置，则考虑 CLOUDSTACK_SECRET 环境变量。
api_timeout 整数	HTTP 超时（秒）。 如果未给出，则考虑 CLOUDSTACK_TIMEOUT 环境变量。 默认值： 10
api_url 字符串 / 必需	CloudStack API 的 URL，例如 https://cloud.example.com/client/api。 如果未给出，则考虑 CLOUDSTACK_ENDPOINT 环境变量。
api_verify_ssl_cert 字符串	验证 CA 权威证书文件。 如果未给出，则考虑 CLOUDSTACK_VERIFY 环境变量。
dhcp_provider 字符串	区域的 DHCP 提供程序。
dns1 字符串	区域的第一个 DNS。 如果 state=present，则为必需。
dns1_ipv6 字符串	区域的第一个 IPv6 DNS。
dns2 字符串	区域的第二个 DNS。
dns2_ipv6 字符串	区域的第二个 IPv6 DNS。
domain 字符串	区域相关的域。 如果未设置，则区域为公共区域。
guest_cidr_address 字符串	区域的访客 CIDR 地址。
id 字符串	现有区域的 UUID。
internal_dns1 字符串	区域的第一个内部 DNS。 如果未设置，则在 state=present 时将使用 dns1。
internal_dns2 字符串	区域的第二个内部 DNS。
local_storage_enabled 布尔值	是否为区域启用本地存储。 选项 false true
name 字符串 / 必需	区域的名称。
network_domain 字符串	区域的网络域。
network_type 字符串	区域的网络类型。 选项 "Basic" ← (默认) "Advanced"
securitygroups_enabled 布尔值	区域是否启用安全组。 选项 false true
state 字符串	区域的状态。 选项 "present" ← (默认) "enabled" "disabled" "absent"
validate_certs 布尔值 ngine_io.cloudstack 2.4.0 中新增	如果为 false，则不会验证 SSL 证书。 如果未给出，则考虑 CLOUDSTACK_DANGEROUS_NO_TLS_VERIFY 环境变量。 这仅应在使用自签名证书的个人控制站点上使用。 选项 false true ← (默认)

注释

注意

• 有关 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

返回值

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

键	描述
allocation_state 字符串	区域的状态。 返回：成功 示例： "Enabled"
dhcp_provider 字符串	区域的 DHCP 提供程序 返回：成功 示例： "VirtualRouter"
dns1 字符串	区域的第一个 DNS。 返回：成功 示例： "8.8.8.8"
dns1_ipv6 字符串	区域的第一个 IPv6 DNS。 返回：成功 示例： "2001:4860:4860::8888"
dns2 字符串	区域的第二个 DNS。 返回：成功 示例： "8.8.4.4"
dns2_ipv6 字符串	区域的第二个 IPv6 DNS。 返回：成功 示例： "2001:4860:4860::8844"
domain 字符串	区域相关的域。 返回：成功 示例： "ROOT"
guest_cidr_address 字符串	区域的访客 CIDR 地址 返回：成功 示例： "10.1.1.0/24"
id 字符串	区域的 UUID。 返回：成功 示例： "04589590-ac63-4ffc-93f5-b698b8ac38b6"
internal_dns1 字符串	区域的第一个内部 DNS。 返回：成功 示例： "8.8.8.8"
internal_dns2 字符串	区域的第二个内部 DNS。 返回：成功 示例： "8.8.4.4"
local_storage_enabled 布尔值	启用本地存储。 返回：成功 示例： false
name 字符串	区域的名称。 返回：成功 示例： "zone01"
network_domain 字符串	区域的网络域。 返回：成功 示例： "example.com"
network_type 字符串	区域的网络类型。 返回：成功 示例： "basic"
securitygroups_enabled 布尔值	启用了安全组支持。 返回：成功 示例： false
标签 列表 / 元素=字符串	与区域关联的资源标签列表。 返回：成功 示例： [{"key": "foo", "value": "bar"}]
区域令牌 字符串	区域令牌 返回：成功 示例： "ccb0a60c-79c8-3230-ab8b-8bdbe8c45bb7"

作者

• René Moser (@resmo)

资源链接

• 问题追踪器
• 代码仓库