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

返回值

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

键

描述

cidr

字符串

VPC 中可用子网的范围。

返回：成功

enable_shared_snat

布尔值

显示共享 snat 是否启用。

返回：成功

id

字符串

VPC 的 ID。

返回：成功

name

字符串

VPC 的名称。

返回：成功

routes

复杂类型

路由信息。

返回：成功

目标网络

字符串

路由的目标网络段。

返回：成功

下一跳

字符串

路由的下一跳。如果路由类型是对等连接，则会提供VPC对等连接ID。

返回：成功

状态

字符串

VPC的状态。

返回：成功

作者

  • 华为公司 (@huaweicloud)