community.general.hwc_vpc_subnet 模块 – 在华为云中创建 Vpc/子网资源

注意

此模块是 community.general 集合（版本 10.1.0）的一部分。

如果您正在使用 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.general。您需要进一步的要求才能使用此模块，请参阅要求了解详细信息。

要在 playbook 中使用它，请指定：community.general.hwc_vpc_subnet。

community.general 0.2.0 中的新增功能

概要

  • 子网管理。

要求

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

  • keystoneauth1 >= 3.6.0

参数

参数

注释

availability_zone

字符串

指定子网所属的可用区。创建子网后无法更改。

cidr

字符串 / 必需

指定子网 CIDR 块。该值必须在 VPC CIDR 块内，并且为 CIDR 格式。子网掩码不能大于 28。创建子网后无法更改。

dhcp_enable

布尔值

指定是否为子网启用 DHCP。该值可以是 true（启用）或 false（禁用），默认值为 true。如果此参数设置为 false，则新创建的 ECS 无法获取 IP 地址，并且无法使用 Cloud-init 注入用户名和密码。

选择

  • false

  • true

dns_address

列表 / 元素=字符串

指定子网的 DNS 服务器地址。将首先使用头部的地址。

domain

字符串 / 必需

要作用域到的域的名称（Identity v3）。

目前仅支持域名，不支持域 ID。

gateway_ip

字符串 / 必需

指定子网的网关。该值必须是子网中的 IP 地址。创建子网后无法更改。

id

字符串

要管理的资源的 ID。

identity_endpoint

字符串 / 必需

身份验证 URL。

name

字符串 / 必需

指定子网名称。该值是一个 1 到 64 个字符的字符串，可以包含字母、数字、下划线 (_)、连字符 (-) 和句点 (.)。

password

字符串 / 必需

用于登录的密码。

project

字符串 / 必需

租户 (Identity v2) 或项目 (Identity v3) 的名称。

目前仅支持项目名称，不支持项目 ID。

region

字符串

项目所属的区域。

state

字符串

给定对象是否应存在于华为云中。

选择

  • "present" ←（默认）

  • "absent"

timeouts

字典

每个操作的超时时间。

默认值： {}

create

字符串

创建操作的超时时间。

默认值： "15m"

update

字符串

更新操作的超时时间。

默认值： "15m"

user

字符串 / 必需

用于登录的用户名。

目前仅支持用户名，不支持用户 ID。

vpc_id

字符串 / 必需

指定子网所属的 VPC 的 ID。创建子网后无法更改。

属性

属性

支持

描述

check_mode

支持： 完全支持

可以在 check_mode 模式下运行，并返回更改状态预测，而不会修改目标。

diff_mode

支持: 无

当处于 diff 模式时，会返回有关已更改内容（或在 check_mode 模式下可能需要更改的内容）的详细信息。

说明

注意

  • 对于身份验证，您可以使用 ANSIBLE_HWC_IDENTITY_ENDPOINT 环境变量设置 identity_endpoint。

  • 对于身份验证，您可以使用 ANSIBLE_HWC_USER 环境变量设置 user。

  • 对于身份验证，您可以使用 ANSIBLE_HWC_PASSWORD 环境变量设置 password。

  • 对于身份验证，您可以使用 ANSIBLE_HWC_DOMAIN 环境变量设置 domain。

  • 对于身份验证，您可以使用 ANSIBLE_HWC_PROJECT 环境变量设置 project。

  • 对于身份验证，您可以使用 ANSIBLE_HWC_REGION 环境变量设置 region。

  • 仅当未设置 playbook 值时，才会使用环境变量的值。

示例

# create subnet
- name: Create vpc
  hwc_network_vpc:
    cidr: "192.168.100.0/24"
    name: "ansible_network_vpc_test"
  register: vpc
- name: Create subnet
  community.general.hwc_vpc_subnet:
    vpc_id: "{{ vpc.id }}"
    cidr: "192.168.100.0/26"
    gateway_ip: "192.168.100.32"
    name: "ansible_network_subnet_test"
    dhcp_enable: true

返回值

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

键

描述

availability_zone

字符串

指定子网所属的可用区（AZ）。

返回: 成功

cidr

字符串

指定子网 CIDR 块。该值必须在 VPC CIDR 块内，并且采用 CIDR 格式。子网掩码不能大于 28。

返回: 成功

dhcp_enable

布尔值

指定是否为子网启用 DHCP。该值可以是 true（启用）或 false（禁用），默认值为 true。如果此参数设置为 false，则新创建的 ECS 无法获取 IP 地址，并且无法使用 Cloud-init 注入用户名和密码。

返回: 成功

dns_address

列表 / 元素=字符串

指定子网的 DNS 服务器地址。将首先使用头部的地址。

返回: 成功

gateway_ip

字符串

指定子网的网关。该值必须是子网中的 IP 地址。

返回: 成功

name

字符串

指定子网名称。该值是一个 1 到 64 个字符的字符串，可以包含字母、数字、下划线 (_)、连字符 (-) 和句点 (.)。

返回: 成功

vpc_id

字符串

指定子网所属的 VPC 的 ID。

返回: 成功

作者

  • 华为公司 (@huaweicloud)