community.general.hwc_vpc_eip 模块 – 在华为云中创建 Vpc/EIP 资源

注意

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

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

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

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

community.general 0.2.0 中的新增功能

概要 

弹性 IP 管理。

要求 

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

keystoneauth1 >= 3.6.0

参数 

参数	注释
dedicated_bandwidth 字典	指定专用带宽对象。
charge_mode 字符串 / 必选	指定带宽是按流量计费还是按带宽大小计费。值可以是带宽或流量。如果此参数留空或为空字符串，则使用默认值带宽。对于 IPv6 地址，默认参数值在中国境外为带宽，在中国境内为流量。
name 字符串 / 必选	指定带宽名称。该值是一个 1 到 64 个字符的字符串，可以包含字母、数字、下划线 (`_`)、连字符 (`-`) 和句点 (`.`)。
size 整数 / 必选	指定带宽大小。默认情况下，该值的范围为 1 Mbit/s 到 2000 Mbit/s。（具体范围可能因每个区域的配置而异。您可以在管理控制台上查看每个区域的带宽范围。）带宽调整的最小单位因带宽范围而异。详细信息如下。如果允许的带宽大小范围为 0 到 300 Mbit/s（包括 300 Mbit/s），则最小单位为 1 Mbit/s。如果允许的带宽大小范围为 300 Mbit/s 到 1000 Mbit/s（包括 1000 Mbit/s），则最小单位为 50 Mbit/s。如果允许的带宽大小大于 1000 Mbit/s，则最小单位为 500 Mbit/s。
domain 字符串 / 必选	要作用域到的域的名称 (Identity v3)。目前仅支持域名，不支持域 ID。
enterprise_project_id 字符串	指定企业项目 ID。
id 字符串	要管理的资源的 ID。
identity_endpoint 字符串 / 必选	身份验证 URL。
ip_version 整数	值可以是 4（IPv4 地址）或 6（IPv6 地址）。如果此参数留空，将分配一个 IPv4 地址。
ipv4_address 字符串	指定获取的 IPv4 EIP。如果您不指定，系统会自动分配一个 EIP。
password 字符串 / 必选	用于登录的密码。
port_id 字符串	指定端口 ID。仅当私有 IP 地址与 EIP 绑定时，才会返回此参数。
project 字符串 / 必选	租户 (Identity v2) 或项目 (Identity v3) 的名称。目前仅支持项目名称，不支持项目 ID。
region 字符串	项目所属的区域。
shared_bandwidth_id 字符串	指定共享带宽的 ID。
state 字符串	给定对象是否应存在于华为云中。选项 `"present"` ← (默认) `"absent"`
timeouts 字典	每个操作的超时时间。默认值： `{}`
create 字符串	创建操作的超时时间。默认值： `"5m"`
update 字符串	更新操作的超时时间。默认值： `"5m"`
type 字符串 / 必选	指定 EIP 类型。
user 字符串 / 必选	用于登录的用户名。目前仅支持用户名，不支持用户 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 环境变量设置 region。
只有当 playbook 值未设置时，才会使用环境变量值。

示例 

# create an eip and bind it to a port
- 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 port
  hwc_vpc_port:
    subnet_id: "{{ subnet.id }}"
    ip_address: "192.168.100.33"
  register: port
- name: Create an eip and bind it to a port
  community.general.hwc_vpc_eip:
    type: "5_bgp"
    dedicated_bandwidth:
      charge_mode: "traffic"
      name: "ansible_test_dedicated_bandwidth"
      size: 1
    port_id: "{{ port.id }}"

返回值 

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

键	描述
create_time 字符串	指定分配 EIP 时的时间（UTC 时间）。返回: 成功
dedicated_bandwidth 字典	指定专用带宽对象。返回: 成功
charge_mode 字符串	指定带宽是按流量计费还是按带宽大小计费。值可以是带宽或流量。如果此参数留空或为空字符串，则使用默认值带宽。对于 IPv6 地址，默认参数值在中国境外为带宽，在中国境内为流量。返回: 成功
id 字符串	指定专用带宽的 ID。返回: 成功
name 字符串	指定带宽名称。该值是一个 1 到 64 个字符的字符串，可以包含字母、数字、下划线 (`_`)、连字符 (`-`) 和句点 (`.`)。返回: 成功
size 整数	指定带宽大小。默认情况下，该值的范围为 1 Mbit/s 到 2000 Mbit/s。（具体范围可能因每个区域的配置而异。您可以在管理控制台上查看每个区域的带宽范围。）带宽调整的最小单位因带宽范围而异。详细信息如下：如果允许的带宽大小范围为 0 到 300 Mbit/s（包括 300 Mbit/s），则最小单位为 1 Mbit/s。如果允许的带宽大小范围为 300 Mbit/s 到 1000 Mbit/s（包括 1000 Mbit/s），则最小单位为 50 Mbit/s。如果允许的带宽大小大于 1000 Mbit/s，则最小单位为 500 Mbit/s。返回: 成功
enterprise_project_id 字符串	指定企业项目 ID。返回: 成功
ip_version 整数	值可以是 4（IPv4 地址）或 6（IPv6 地址）。如果此参数留空，将分配一个 IPv4 地址。返回: 成功
ipv4_address 字符串	指定获取的 IPv4 EIP。如果您不指定，系统会自动分配一个 EIP。返回: 成功
ipv6_address 字符串	指定获取的 IPv6 EIP。返回: 成功
port_id 字符串	指定端口 ID。仅当私有 IP 地址与 EIP 绑定时，才会返回此参数。返回: 成功
private_ip_address 字符串	指定与 EIP 绑定的私有 IP 地址。只有当私有 IP 地址与 EIP 绑定时，才会返回此参数。返回: 成功
shared_bandwidth_id 字符串	指定共享带宽的 ID。返回: 成功
type 字符串	指定 EIP 类型。返回: 成功

作者

华为公司 (@huaweicloud)