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

注意

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

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

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

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

community.general 0.2.0 中的新增功能

概要

  • vpc 私有 IP 管理。

需求

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

  • keystoneauth1 >= 3.6.0

参数

参数

注释

domain

字符串 / 必需

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

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

id

字符串

要管理的资源的 ID。

identity_endpoint

字符串 / 必需

身份验证 URL。

ip_address

字符串

指定目标 IP 地址。该值可以是子网中可用的 IP 地址。如果未指定，系统会自动分配 IP 地址。创建私有 IP 后无法更改。

password

字符串 / 必需

登录密码。

project

字符串 / 必需

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

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

region

字符串

项目所属的区域。

state

字符串

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

选项

  • "present" ← (默认)

  • "absent"

subnet_id

字符串 / 必需

指定从中分配 IP 地址的子网的 ID。创建私有 IP 后无法更改。

user

字符串 / 必需

登录用户名。

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

属性

属性

支持

描述

check_mode

支持：完全支持

可以在 check_mode 下运行并返回更改状态预测，而无需修改目标。

diff_mode

支持：不支持

在差异模式下，将返回有关已更改内容（或可能需要在 check_mode 中更改的内容）的详细信息。

注释

注意

  • 如果提供了 id 选项，则它优先于 subnet_id、ip_address 用于私有 IP 选择。

  • subnet_id、ip_address 用于私有 IP 选择。如果使用这些选项存在多个私有 IP，则执行将中止。

  • 不支持参数更新。如果更改了其中一个选项，模块将创建一个新的资源。

  • 对于身份验证，您可以使用 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 a private ip
- name: Create vpc
  hwc_network_vpc:
    cidr: "192.168.100.0/24"
    name: "ansible_network_vpc_test"
  register: vpc
- name: Create subnet
  hwc_vpc_subnet:
    gateway_ip: "192.168.100.32"
    name: "ansible_network_subnet_test"
    dhcp_enable: true
    vpc_id: "{{ vpc.id }}"
    cidr: "192.168.100.0/26"
  register: subnet
- name: Create a private ip
  community.general.hwc_vpc_private_ip:
    subnet_id: "{{ subnet.id }}"
    ip_address: "192.168.100.33"

返回值

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

键

描述

ip_address

字符串

指定目标 IP 地址。该值可以是子网中可用的 IP 地址。如果未指定，系统会自动分配 IP 地址。

返回：成功

subnet_id

字符串

指定从中分配 IP 地址的子网的 ID。

返回：成功

作者

  • 华为公司 (@huaweicloud)