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_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

布尔值

是否为区域启用本地存储。

选项

name

字符串 / 必需

区域的名称。

network_domain

字符串

区域的网络域。

network_type

字符串

区域的网络类型。

选项

  • "Basic" ← (默认)

  • "Advanced"

securitygroups_enabled

布尔值

区域是否启用了安全组。

选项

state

字符串

区域的状态。

选项

  • "present" ← (默认)

  • "enabled"

  • "disabled"

  • "absent"

validate_certs

布尔值

在 ngine_io.cloudstack 2.4.0 中添加

如果 false,则不会验证 SSL 证书。

如果未给出,则考虑 CLOUDSTACK_DANGEROUS_NO_TLS_VERIFY 环境变量。

这仅应在个人控制的站点上使用自签名证书。

选项

  • 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"}]

zone_token

字符串

区域令牌

返回: 成功

示例: "ccb0a60c-79c8-3230-ab8b-8bdbe8c45bb7"

作者

  • René Moser (@resmo)