community.general.dimensiondata_network 模块 – 创建、更新和删除 MCP 1.0 & 2.0 网络

注意

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

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

要安装它，请使用：ansible-galaxy collection install community.general。

要在剧本中使用它，请指定：community.general.dimensiondata_network。

概要 

创建、更新和删除 MCP 1.0 & 2.0 网络

参数 

参数	注释
description 字符串	网络域的附加描述。
location 字符串 / 必需	目标数据中心。
mcp_password 字符串	用于向 CloudControl API 进行身份验证的密码。如果未指定，将回退到环境变量中的 `MCP_PASSWORD` 或 `~/.dimensiondata`。如果指定了 `mcp_user`，则需要此参数。
mcp_user 字符串	用于向 CloudControl API 进行身份验证的用户名。如果未指定，将回退到环境变量中的 `MCP_USER` 或 `~/.dimensiondata`。
name 字符串 / 必需	要创建的网络域的名称。
region 字符串	目标区域。区域在 Apache libcloud 项目 [libcloud/common/dimensiondata.py] 中定义。它们也在 https://libcloud.readthedocs.io/en/latest/compute/drivers/dimensiondata.html 中列出。请注意，默认值 `na` 代表“北美洲”。该模块会在区域选择前添加 `dd-`。默认值： `"na"`
service_plan 字符串	服务计划，“ESSENTIALS”或“ADVANCED”。仅限 MCP 2.0。选项 `"ESSENTIALS"` ← (默认) `"ADVANCED"`
state 字符串	资源应该是存在还是不存在。选项 `"present"` ← (默认) `"absent"`
validate_certs 布尔值	如果为 `false`，则不会验证 SSL 证书。这仅应在使用自签名证书的 CloudControl API 的私有实例上使用。选项 `false` `true` ← (默认)
wait 布尔值	我们是否应该等待任务完成再继续下一个任务。选项 `false` ← (默认) `true`
wait_poll_interval 整数	等待检查任务完成之间的时间量（以秒为单位）。仅当 `wait=true` 时适用。默认值： `2`
wait_time 整数	等待任务完成的最大时间量（以秒为单位）。仅当 `wait=true` 时适用。默认值： `600`

属性 

属性	支持	描述
check_mode	支持：不支持	可以在 `check_mode` 中运行并返回更改状态预测，而无需修改目标。
diff_mode	支持：不支持	在差异模式下，将返回关于已更改内容（或可能需要在`check_mode`中更改的内容）的详细信息。

示例 

- name: Create an MCP 1.0 network
  community.general.dimensiondata_network:
    region: na
    location: NA5
    name: mynet

- name: Create an MCP 2.0 network
  community.general.dimensiondata_network:
    region: na
    mcp_user: my_user
    mcp_password: my_password
    location: NA9
    name: mynet
    service_plan: ADVANCED

- name: Delete a network
  community.general.dimensiondata_network:
    region: na
    location: NA1
    name: mynet
    state: absent

返回值 

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

键	描述
network complex	描述网络的字典。返回：当`state=present`时成功。
description 字符串	网络描述。返回：成功示例： `"My network description"`
id 字符串	网络ID。返回：成功示例： `"8c787000-a000-4050-a215-280893411a7d"`
location 字符串	数据中心位置。返回：成功示例： `"NA3"`
multicast 布尔值	是否启用多播？（仅限MCP 1.0）返回：成功示例： `false`
name 字符串	网络名称。返回：成功示例： `"My network"`
private_net 字符串	专用网络子网。（仅限MCP 1.0）返回：成功示例： `"10.2.3.0"`
status 字符串	网络状态。（仅限MCP 2.0）返回：成功示例： `"NORMAL"`

作者

Aimon Bustardo (@aimonb)