community.general.hwc_vpc_peering_connect 模块 – 在华为云中创建 Vpc/PeeringConnect 资源

注意

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

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

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

要在 playbook 中使用它,请指定:community.general.hwc_vpc_peering_connect

community.general 0.2.0 中的新增功能

概要

  • VPC 对等连接管理。

要求

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

  • keystoneauth1 >= 3.6.0

参数

参数

注释

description

string

VPC 对等连接的描述。

domain

string / 必需

要将范围限定到的域的名称(Identity v3)。

当前仅支持域名,不支持域 ID。

id

string

要管理的资源的 ID。

identity_endpoint

string / 必需

身份验证 URL。

local_vpc_id

string / 必需

指定本地 VPC 的 ID。

name

string / 必需

指定 VPC 对等连接的名称。该值可以包含 1 到 64 个字符。

password

string / 必需

用于登录的密码。

peering_vpc

dictionary / 必需

指定有关对等 VPC 的信息。

project_id

string

指定对等 VPC 所属项目的 ID。

vpc_id

string / 必需

指定对等 VPC 的 ID。

project

string / 必需

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

当前仅支持项目名称,不支持项目 ID。

region

string

项目所属的区域。

state

string

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

选择

  • "present" ← (默认)

  • "absent"

timeouts

dictionary

每个操作的超时时间。

默认值: {}

create

string

创建操作的超时时间。

默认值: "15m"

user

string / 必需

用于登录的用户名。

当前仅支持用户名,不支持用户 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 环境变量设置区域。

  • 只有在 playbook 值未设置的情况下,才会使用环境变量的值。

示例

# create a peering connect
- name: Create a local vpc
  hwc_network_vpc:
    cidr: "192.168.0.0/16"
    name: "ansible_network_vpc_test_local"
  register: vpc1
- name: Create a peering vpc
  hwc_network_vpc:
    cidr: "192.168.0.0/16"
    name: "ansible_network_vpc_test_peering"
  register: vpc2
- name: Create a peering connect
  community.general.hwc_vpc_peering_connect:
    local_vpc_id: "{{ vpc1.id }}"
    name: "ansible_network_peering_test"
    peering_vpc:
      vpc_id: "{{ vpc2.id }}"

返回值

通用返回值记录在此处,以下是此模块特有的字段

描述

description

string

VPC 对等连接的描述。

返回: 成功

local_vpc_id

string

指定本地 VPC 的 ID。

返回: 成功

name

string

指定 VPC 对等连接的名称。该值可以包含 1 到 64 个字符。

返回: 成功

peering_vpc

dictionary

指定有关对等 VPC 的信息。

返回: 成功

project_id

string

指定对等 VPC 所属项目的 ID。

返回: 成功

vpc_id

string

指定对等 VPC 的 ID。

返回: 成功

作者

  • 华为公司 (@huaweicloud)