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	支持：不支持	在差异模式下，将返回有关已更改内容（或可能需要在 `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 布尔值	指定端口的管理状态。返回：success
allowed_address_pairs 列表 / 元素=字符串	指定一组零个或多个允许的地址对。返回：success
ip_address 字符串	指定 IP 地址。不能将其设置为 0.0.0.0。如果为参数 allowed_address_pairs 配置了较大的 CIDR 块（子网掩码小于 24），则为端口配置一个独立的安全组。返回：success
mac_address 字符串	指定 MAC 地址。返回：success
extra_dhcp_opts 列表 / 元素=字符串	指定 DHCP 的扩展选项。返回：success
name 字符串	指定选项名称。返回：success
value 字符串	指定选项值。返回：success
ip_address 字符串	指定端口的 IP 地址。返回：success
mac_address 字符串	指定端口MAC地址。返回：success
name 字符串	指定端口名称。值不能超过 255 个字符。返回：success
security_groups 列表 / 元素=字符串	指定安全组的 ID。返回：success
subnet_id 字符串	指定端口所属的子网的 ID。返回：success

作者

华为公司 (@huaweicloud)