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。

要在 playbook 中使用它，请指定：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` 中可能需要更改的内容）的详细信息。

示例 

- 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

返回值 

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

键	描述
网络复杂	描述网络的字典。返回: 当 `state=present` 成功时返回。
description 字符串	网络描述。返回: 成功示例: `"我的网络描述"`
id 字符串	网络 ID。返回: 成功示例: `"8c787000-a000-4050-a215-280893411a7d"`
location 字符串	数据中心位置。返回: 成功示例: `"NA3"`
多播布尔值	是否启用多播？ (仅限 MCP 1.0) 返回: 成功示例: `false`
name 字符串	网络名称。返回: 成功示例: `"我的网络"`
私有网络字符串	私有网络子网。(仅限 MCP 1.0) 返回: 成功示例: `"10.2.3.0"`
状态字符串	网络状态。(仅限 MCP 2.0) 返回: 成功示例: `"NORMAL"`

作者

Aimon Bustardo (@aimonb)