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 string	拥有 VLAN 的帐户。与 project 互斥。
api_http_method string	用于查询 API 端点的 HTTP 方法。如果未给出，则会考虑 `CLOUDSTACK_METHOD` 环境变量。选择 `"get"` ← （默认） `"post"`
api_key string / 必需	CloudStack API 的 API 密钥。如果未给出，则会考虑 `CLOUDSTACK_KEY` 环境变量。
api_secret string / 必需	CloudStack API 的密钥。如果未设置，则会考虑 `CLOUDSTACK_SECRET` 环境变量。
api_timeout integer	HTTP 超时时间（以秒为单位）。如果未给出，则会考虑 `CLOUDSTACK_TIMEOUT` 环境变量。默认： `10`
api_url string / 必需	CloudStack API 的 URL，例如 https://cloud.example.com/client/api。如果未给出，则会考虑 `CLOUDSTACK_ENDPOINT` 环境变量。
api_verify_ssl_cert string	验证 CA 授权证书文件。如果未给出，则会考虑 `CLOUDSTACK_VERIFY` 环境变量。
cidr_ipv6 string	IPv6 网络的 CIDR，必须至少为 /64。
domain string	拥有 VLAN 的帐户的域。
end_ip string	VLAN IP 范围中的结束 IPv4 地址。如果未指定，则使用 start_ip 的值。仅在创建时考虑。
end_ipv6 string	IPv6 网络范围中的结束 IPv6 地址。如果未指定，则使用 start_ipv6 的值。仅在创建时考虑。
for_system_vms boolean	如果 IP 范围设置为系统虚拟机，则为 `yes`，否则为 `no` 选择 `false` ← （默认） `true`
for_virtual_network boolean 在 ngine_io.cloudstack 1.0.0 中添加	如果 VLAN 为虚拟类型，则为 `yes`，如果为直接类型，则为 `no`。如果设置为 `yes`，但既未设置 physical_network 也未设置 network，则 CloudStack 将尝试将 VLAN 范围添加到具有公共流量类型的物理网络。选择 `false` ← （默认） `true`
gateway string	VLAN IP 范围的网关。如果 state=present，则为必需。
gateway_ipv6 string	IPv6 网络的网关。仅在创建时考虑。
netmask string	VLAN IP 范围的子网掩码。如果 state=present，则为必需。
network string	网络名称或 ID。如果 for_virtual_network 和 physical_network 未设置，则为必需。
physical_network string	物理网络名称或 ID。
pod string 在 ngine_io.cloudstack 1.0.0 中添加	Pod 的名称。
project string	拥有 VLAN 的项目。与 account 互斥。
start_ip string / 必需	VLAN IP 范围中的起始 IPv4 地址。仅在创建时考虑。
start_ipv6 string	IPv6 网络范围中的起始 IPv6 地址。仅在创建时考虑。
state string	网络 IP 范围的状态。选择 `"present"` ← （默认） `"absent"`
validate_certs boolean 在 ngine_io.cloudstack 2.4.0 中添加	如果 `false`，则不会验证 SSL 证书。如果未给出，则会考虑 `CLOUDSTACK_DANGEROUS_NO_TLS_VERIFY` 环境变量。这仅应在个人控制的使用自签名证书的站点上使用。选择 `false` `true` ← （默认）
vlan string	网络的 ID 或 VID。如果未指定，将默认为网络的 vlan。
zone string / 必需	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 string	拥有网络的账户。返回：如果可用示例： `"example account"`
cidr_ipv6 string	IPv6 网络的 CIDR。返回：如果可用示例： `"2001:db8::/64"`
domain string	VLAN IP 范围的域名。返回：成功示例： `"ROOT"`
end_ip string	VLAN IP 范围的结束 IP。返回：成功示例： `"10.2.4.100"`
end_ipv6 string	VLAN IP 范围的结束 IPv6。返回：如果可用示例： `"2001:db8::50"`
for_systemvms boolean	VLAN IP 范围是否专用于系统虚拟机。返回：成功示例： `false`
for_virtual_network boolean	VLAN IP 范围是否为虚拟类型。返回：成功示例： `false`
gateway string	IPv4 网关。返回：成功示例： `"10.2.4.1"`
gateway_ipv6 string	IPv6 网关。返回：如果可用示例： `"2001:db8::1"`
id string	VLAN IP 范围的 UUID。返回：成功示例： `"04589590-ac63-4ffc-93f5-b698b8ac38b6"`
netmask string	IPv4 子网掩码。返回：成功示例： `"255.255.255.0"`
network string	VLAN 范围的网络。返回：如果可用示例： `"test"`
physical_network string	VLAN IP 范围所属的物理网络。返回：成功示例： `"04589590-ac63-4ffc-93f5-b698b8ac38b6"`
project string	拥有网络的项目。返回：如果可用示例： `"example project"`
start_ip string	VLAN IP 范围的起始 IP。返回：成功示例： `"10.2.4.10"`
start_ipv6 string	VLAN IP 范围的起始 IPv6。返回：如果可用示例： `"2001:db8::10"`
vlan string	VLAN 的 ID 或 VID。返回：成功示例： `"vlan://98"`
zone string	区域名称。返回：成功示例： `"zone-02"`

作者

David Passante (@dpassante)