community.general.hwc_network_vpc 模块 – 创建华为云 VPC

注意

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

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

要安装它，请使用： ansible-galaxy collection install community.general。您需要其他要求才能使用此模块，有关详细信息，请参阅需求。

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

概要 

表示 VPC 资源。

需求 

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

requests >= 2.18.4
keystoneauth1 >= 3.6.0

参数 

参数	注释
cidr 字符串 / 必需	VPC 中可用子网的范围。
domain 字符串 / 必需	要限定到的域的名称 (Identity v3)。目前仅支持域名，不支持域 ID。
id 字符串	要管理的资源的 ID。
identity_endpoint 字符串 / 必需	身份验证 URL。
name 字符串 / 必需	VPC 的名称。
password 字符串 / 必需	登录密码。
project 字符串 / 必需	租户 (Identity v2) 或项目 (Identity v3) 的名称。目前仅支持项目名称，不支持项目 ID。
region 字符串	项目所属的区域。
state 字符串	给定对象是否应该存在于 VPC 中。选项 `"present"` ← (默认) `"absent"`
timeouts 字典	每个操作的超时时间。默认值： `{}`
create 字符串	创建操作的超时时间。默认值： `"15m"`
delete 字符串	删除操作的超时时间。默认值： `"15m"`
update 字符串	更新操作的超时时间。默认值： `"15m"`
user 字符串 / 必需	登录用户名。目前仅支持用户名，不支持用户 ID。

属性 

属性	支持	描述
check_mode	支持：完全支持	可以在 `check_mode` 下运行，并在不修改目标的情况下返回更改状态预测。
diff_mode	支持：不支持	在差异模式下，将返回有关已更改内容（或可能需要在 `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 值时，才会使用环境变量值。

示例 

- name: Create a vpc
  community.general.hwc_network_vpc:
      identity_endpoint: "{{ identity_endpoint }}"
      user: "{{ user }}"
      password: "{{ password }}"
      domain: "{{ domain }}"
      project: "{{ project }}"
      region: "{{ region }}"
      name: "vpc_1"
      cidr: "192.168.100.0/24"
      state: present

返回值 

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

Key	描述
cidr 字符串	VPC中可用子网的范围。返回：成功
enable_shared_snat 布尔值	显示是否启用了共享SNAT。返回：成功
id 字符串	VPC的ID。返回：成功
name 字符串	VPC的名称。返回：成功
routes 复杂类型	路由信息。返回：成功
destination 字符串	路由的目标网络段。返回：成功
next_hop 字符串	路由的下一跳。如果路由类型是对等连接，则会提供VPC对等连接ID。返回：成功
status 字符串	VPC的状态。返回：成功

作者

华为公司 (@huaweicloud)