community.general.hwc_vpc_route 模块 – 在华为云中创建 Vpc/路由资源

注意

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

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

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

要在剧本中使用它，请指定：community.general.hwc_vpc_route。

community.general 0.2.0 中的新功能

概要 

VPC 路由管理。

要求 

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

keystoneauth1 >= 3.6.0

参数 

参数	注释
destination 字符串 / 必需	指定目标 IP 地址或 CIDR 块。
domain 字符串 / 必需	要作用域到的域的名称（Identity v3）。目前仅支持域名，不支持域 ID。
id 字符串	要管理的资源的 ID。
identity_endpoint 字符串 / 必需	身份验证 URL。
next_hop 字符串 / 必需	指定下一跳。该值为 VPC 对等连接 ID。
password 字符串 / 必需	用于登录的密码。
project 字符串 / 必需	租户（Identity v2）或项目（Identity v3）的名称。目前仅支持项目名称，不支持项目 ID。
region 字符串	项目所属的区域。
state 字符串	给定的对象是否应存在于华为云中。选项 `"present"` ←（默认） `"absent"`
type 字符串	指定路由的类型。默认值：`"peering"`
user 字符串 / 必需	用于登录的用户名。目前仅支持用户名，不支持用户 ID。
vpc_id 字符串 / 必需	指定要向其添加路由的 VPC ID。

属性 

属性	支持	描述
check_mode	支持：完全	可以在 `check_mode` 中运行，并返回已更改的状态预测，而无需修改目标。
diff_mode	支持：无	当处于 diff 模式时，将返回已更改的内容的详细信息（或在 `check_mode` 中可能需要更改的内容）。

注意事项 

注意

如果提供了 id 选项，则它优先于 destination、vpc_id、type 和 next_hop 用于路由选择。
destination、vpc_id、type 和 next_hop 用于路由选择。如果存在多个具有此选项的路由，则会中止执行。
没有参数支持更新。如果其中一个选项已更改，则模块将创建一个新资源。
对于身份验证，您可以使用 ANSIBLE_HWC_IDENTITY_ENDPOINT 环境变量设置 identity_endpoint。
对于身份验证，您可以使用 ANSIBLE_HWC_USER 环境变量设置用户。
对于身份验证，您可以使用 ANSIBLE_HWC_PASSWORD 环境变量设置密码。
对于身份验证，您可以使用 ANSIBLE_HWC_DOMAIN 环境变量设置域。
对于身份验证，您可以使用 ANSIBLE_HWC_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
  hwc_vpc_peering_connect:
    local_vpc_id: "{{ vpc1.id }}"
    name: "ansible_network_peering_test"
    filters:
      - "name"
    peering_vpc:
      vpc_id: "{{ vpc2.id }}"
  register: connect
- name: Create a route
  community.general.hwc_vpc_route:
    vpc_id: "{{ vpc1.id }}"
    destination: "192.168.0.0/16"
    next_hop: "{{ connect.id }}"

返回值 

通用返回值在此处有文档说明：这里，以下是此模块特有的字段

键	描述
destination 字符串	指定目标 IP 地址或 CIDR 块。 Returned: 成功
id 字符串	路由的 UUID。 Returned: 成功
next_hop 字符串	指定下一跳。该值为 VPC 对等连接 ID。 Returned: 成功
type 字符串	指定路由的类型。 Returned: 成功
vpc_id 字符串	指定要向其添加路由的 VPC ID。 Returned: 成功

作者

华为公司 (@huaweicloud)