ngine_io.cloudstack.cs_vlan_ip_range 模块 – 在基于 Apache CloudStack 的云上管理 VLAN IP 范围。

注意

此模块是 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_vlan_ip_range。

ngine_io.cloudstack 0.1.0 中的新增功能

概要

• 创建和删除 VLAN IP 范围。

需求

执行此模块的主机需要以下需求。

• python >= 2.6

• cs >= 0.9.0

参数

参数	注释
account 字符串	拥有 VLAN 的帐户。 与 *project* 互斥。
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 环境变量。
cidr_ipv6 字符串	IPv6 网络的 CIDR，至少必须为 /64。
domain 字符串	拥有 VLAN 的帐户的域。
end_ip 字符串	VLAN IP 范围中的结束 IPv4 地址。 如果未指定，则使用 *start_ip* 的值。 仅在创建时考虑。
end_ipv6 字符串	IPv6 网络范围中的结束 IPv6 地址。 如果未指定，则使用 *start_ipv6* 的值。 仅在创建时考虑。
for_system_vms 布尔值	如果 IP 范围设置为系统虚拟机，则为 yes，否则为 no 选项 false ← (默认) true
for_virtual_network 布尔值 ngine_io.cloudstack 1.0.0 中新增	如果 VLAN 为虚拟类型，则为 yes，如果为直接类型，则为 no。 如果设置为 yes 但既未设置 *physical_network* 也未设置 *network*，CloudStack 将尝试将 VLAN 范围添加到具有公共流量类型的物理网络。 选项 false ← (默认) true
gateway 字符串	VLAN IP 范围的网关。 如果 *state=present*，则需要。
gateway_ipv6 字符串	IPv6 网络的网关。 仅在创建时考虑。
netmask 字符串	VLAN IP 范围的网络掩码。 如果 *state=present*，则需要。
network 字符串	网络名称或 ID。 如果未设置 *for_virtual_network* 和 *physical_network*，则需要。
physical_network 字符串	物理网络名称或 ID。
pod 字符串 ngine_io.cloudstack 1.0.0 中新增	pod 的名称。
project 字符串	拥有 VLAN 的项目。 与 *account* 互斥。
start_ip 字符串 / 必需	VLAN IP 范围中的起始 IPv4 地址。 仅在创建时考虑。
start_ipv6 字符串	IPv6 网络范围中的起始 IPv6 地址。 仅在创建时考虑。
state 字符串	网络 IP 范围的状态。 选项 "present" ← (默认) "absent"
validate_certs 布尔值 ngine_io.cloudstack 2.4.0 中新增	如果为 false，则不会验证 SSL 证书。 如果没有给出，则考虑 CLOUDSTACK_DANGEROUS_NO_TLS_VERIFY 环境变量。 这仅应在使用自签名证书的个人控制站点上使用。 选项 false true ← (默认)
vlan 字符串	网络的 ID 或 VID。 如果未指定，将默认为网络的 vlan。
zone 字符串 / 必需	VLAN IP 范围的区域 ID。

注释

注意

• 有关 cloudstack 模块的详细指南，请参阅 CloudStack 云指南。

• 此模块支持检查模式。

示例

- name: create a VLAN IP range for network test
  ngine_io.cloudstack.cs_vlan_ip_range:
    network: test
    vlan: 98
    start_ip: 10.2.4.10
    end_ip: 10.2.4.100
    gateway: 10.2.4.1
    netmask: 255.255.255.0
    zone: zone-02

- name: remove a VLAN IP range for network test
  ngine_io.cloudstack.cs_vlan_ip_range:
    state: absent
    network: test
    start_ip: 10.2.4.10
    end_ip: 10.2.4.100
    zone: zone-02

返回值

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

键	描述
account 字符串	拥有网络的帐户。 返回：如果可用 示例： "example account"
cidr_ipv6 字符串	IPv6 网络的 CIDR。 返回：如果可用 示例： "2001:db8::/64"
domain 字符串	VLAN IP 范围的域名。 返回：成功 示例： "ROOT"
end_ip 字符串	VLAN IP 范围的结束 IP 地址。 返回：成功 示例： "10.2.4.100"
end_ipv6 字符串	VLAN IP 范围的结束 IPv6 地址。 返回：如果可用 示例： "2001:db8::50"
for_systemvms 布尔值	VLAN IP 范围是否专用于系统虚拟机。 返回：成功 示例： false
for_virtual_network 布尔值	VLAN IP 范围是否为虚拟类型。 返回：成功 示例： false
gateway 字符串	IPv4 网关。 返回：成功 示例： "10.2.4.1"
gateway_ipv6 字符串	IPv6 网关。 返回：如果可用 示例： "2001:db8::1"
id 字符串	VLAN IP 范围的 UUID。 返回：成功 示例： "04589590-ac63-4ffc-93f5-b698b8ac38b6"
netmask 字符串	IPv4 子网掩码。 返回：成功 示例： "255.255.255.0"
network 字符串	VLAN 范围的网络。 返回：如果可用 示例： "test"
physical_network 字符串	VLAN IP 范围所属的物理网络。 返回：成功 示例： "04589590-ac63-4ffc-93f5-b698b8ac38b6"
project 字符串	拥有该网络的项目。 返回：如果可用 示例： "example project"
start_ip 字符串	VLAN IP 范围的起始 IP 地址。 返回：成功 示例： "10.2.4.10"
start_ipv6 字符串	VLAN IP 范围的起始 IPv6 地址。 返回：如果可用 示例： "2001:db8::10"
vlan 字符串	VLAN 的 ID 或 VID。 返回：成功 示例： "vlan://98"
zone 字符串	区域名称。 返回：成功 示例： "zone-02"

作者

• David Passante (@dpassante)

资源链接

• 问题追踪器
• 代码仓库