community.general.scaleway_ip 模块 – Scaleway IP 管理模块

注意

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

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

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

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

概要 

此模块管理 Scaleway 帐户上的 IP https://developer.scaleway.com

参数 

参数	注释
api_timeout 别名：timeout 整数	与 Scaleway API 的 HTTP 超时（以秒为单位）。默认值: `30`
api_token 别名：oauth_token 字符串 / 必需	Scaleway OAuth 令牌。
api_url 别名：base_url 字符串	Scaleway API URL。默认值: `"https://api.scaleway.com"`
id 字符串	Scaleway IP 的 ID (UUID)
organization 字符串 / 必需	Scaleway 组织标识符
query_parameters 字典	传递给查询字符串的参数列表。默认值: `{}`
region 字符串 / 必需	要使用的 Scaleway 区域（例如 par1）。选择 `"ams1"` `"EMEA-NL-EVS"` `"par1"` `"EMEA-FR-PAR1"` `"par2"` `"EMEA-FR-PAR2"` `"waw1"` `"EMEA-PL-WAW1"`
reverse 字符串	要分配给 IP 的反向解析
server 字符串	要将 IP 附加到的服务器的 ID。要取消附加 IP，请不要指定此选项
state 字符串	指示 IP 的所需状态。选择 `"present"` ← (默认) `"absent"`
validate_certs 布尔值	验证 Scaleway API 的 SSL 证书。选择 `false` `true` ← (默认)

属性 

属性	支持	描述
check_mode	支持: 完全	可以在 `check_mode` 中运行并返回已更改状态预测，而无需修改目标。
diff_mode	支持: 无	当处于 diff 模式时，将返回有关已更改（或可能需要在 `check_mode` 中更改）的内容的详细信息。

备注 

注意

另请参阅 https://developer.scaleway.com/ 上的 API 文档。
如果未在模块中设置 api_token，则可以使用以下环境变量，优先级递减：SCW_TOKEN、 SCW_API_KEY、 SCW_OAUTH_TOKEN 或 SCW_API_TOKEN。
如果想要使用不同的 api_url，还可以设置 SCW_API_URL 环境变量。

示例 

- name: Create an IP
  community.general.scaleway_ip:
    organization: '{{ scw_org }}'
    state: present
    region: par1
  register: ip_creation_task

- name: Make sure IP deleted
  community.general.scaleway_ip:
    id: '{{ ip_creation_task.scaleway_ip.id }}'
    state: absent
    region: par1

返回值 

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

键	描述
数据字典	仅当 `state=present` 时存在。返回: 当 `state=present` 时示例: `{"ips": [{"address": "212.47.232.136", "id": "dd9e8df6-6775-4863-b517-e0b0ee3d7477", "organization": "951df375-e094-4d26-97c1-ba548eeb9c42", "reverse": null, "server": {"id": "3f1568ca-b1a2-4e98-b6f7-31a0588157f1", "name": "ansible_tuto-1"}}]}`

作者

Remy Leone (@remyleone)