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

注意

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

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

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

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

community.general 0.2.0 中的新增功能

概要

  • VPC 端口管理。

要求

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

  • keystoneauth1 >= 3.6.0

参数

参数

注释

admin_state_up

布尔值

指定端口的管理状态。

选项

  • false

  • true

allowed_address_pairs

列表 / 元素=字典

指定一组零个或多个允许的地址对。

ip_address

字符串

指定 IP 地址。不能将其设置为 0.0.0.0。如果为参数 allowed_address_pairs 配置了大型 CIDR 块（子网掩码小于 24），请为端口配置独立的安全性组。

mac_address

字符串

指定 MAC 地址。

domain

字符串 / 必需

要作用域的域的名称 (Identity v3)。

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

extra_dhcp_opts

列表 / 元素=字典

指定 DHCP 的扩展选项。

name

字符串

指定选项名称。

value

字符串

指定选项值。

id

字符串

要管理的资源的 ID。

identity_endpoint

字符串 / 必需

身份验证 URL。

ip_address

字符串

指定端口 IP 地址。

name

字符串

指定端口名称。该值不能超过 255 个字符。

password

字符串 / 必需

用于登录的密码。

project

字符串 / 必需

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

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

region

字符串

项目所属的区域。

security_groups

列表 / 元素=字符串

指定安全组的 ID。

state

字符串

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

选项

  • "present" ← (默认)

  • "absent"

subnet_id

字符串 / 必需

指定端口所属子网的 ID。

timeouts

字典

每个操作的超时时间。

默认： {}

create

字符串

创建操作的超时时间。

默认： "15m"

user

字符串 / 必需

用于登录的用户名。

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

属性

属性

支持

描述

check_mode

支持：完全

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

diff_mode

支持：无

当处于 diff 模式时，将返回有关已更改的内容的详细信息（或可能需要在 check_mode 中更改的内容）。

备注

注意

  • 对于身份验证，您可以使用 ANSIBLE_HWC_IDENTITY_ENDPOINT 环境变量设置 identity_endpoint。

  • 对于身份验证，您可以使用 ANSIBLE_HWC_USER 环境变量设置用户。

  • 对于身份验证，您可以使用 ANSIBLE_HWC_PASSWORD 环境变量设置密码。

  • 对于身份验证，您可以使用 ANSIBLE_HWC_DOMAIN 环境变量设置域。

  • 对于身份验证，您可以使用 ANSIBLE_HWC_PROJECT 环境变量设置项目。

  • 对于身份验证，您可以使用 ANSIBLE_HWC_REGION 环境变量设置区域。

  • 仅当未设置 playbook 值时，才会使用环境变量值。

示例

# create 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
  community.general.hwc_vpc_port:
    subnet_id: "{{ subnet.id }}"
    ip_address: "192.168.100.33"

返回值

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

键

描述

admin_state_up

布尔值

指定端口的管理状态。

返回：成功

allowed_address_pairs

列表 / 元素=字符串

指定一组零个或多个允许的地址对。

返回：成功

ip_address

字符串

指定 IP 地址。不能将其设置为 0.0.0.0。如果为参数 allowed_address_pairs 配置了大型 CIDR 块（子网掩码小于 24），请为端口配置独立的安全性组。

返回：成功

mac_address

字符串

指定 MAC 地址。

返回：成功

extra_dhcp_opts

列表 / 元素=字符串

指定 DHCP 的扩展选项。

返回：成功

name

字符串

指定选项名称。

返回：成功

value

字符串

指定选项值。

返回：成功

ip_address

字符串

指定端口 IP 地址。

返回：成功

mac_address

字符串

指定端口 MAC 地址。

返回：成功

name

字符串

指定端口名称。该值不能超过 255 个字符。

返回：成功

security_groups

列表 / 元素=字符串

指定安全组的 ID。

返回：成功

subnet_id

字符串

指定端口所属子网的 ID。

返回：成功

作者

  • 华为公司 (@huaweicloud)