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 字符串 / 必需	Identity 身份验证 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	支持：无	在 diff 模式下，将返回已更改（或可能需要在 `check_mode` 中更改）的详细信息。

备注 

注意

如果提供 id 选项，则它优先于 subnet_id，ip_address 用于选择私有 IP。
subnet_id，ip_address 用于选择私有 IP。如果存在多个具有此选项的私有 IP，则执行中止。
不支持更新参数。如果其中一个选项发生更改，则该模块将创建一个新资源。
对于身份验证，您可以使用 ANSIBLE_HWC_IDENTITY_ENDPOINT 环境变量设置 identity_endpoint。
对于身份验证，您可以使用 ANSIBLE_HWC_USER 环境变量设置用户。
对于身份验证，您可以使用 ANSIBLE_HWC_PASSWORD 环境变量设置密码。
对于身份验证，您可以使用 ANSIBLE_HWC_DOMAIN 环境变量来设置域。
对于身份验证，您可以使用 ANSIBLE_HWC_PROJECT 环境变量来设置项目。
对于身份验证，您可以使用 ANSIBLE_HWC_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)