community.general.clc_aa_policy 模块 – 在 CenturyLink Cloud 创建或删除反亲和性策略

注意

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

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

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

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

概要 

一个 Ansible 模块，用于在 CenturyLink Cloud 创建或删除反亲和性策略。

要求 

执行此模块的主机需要满足以下要求。

python = 2.7
requests >= 2.5.0
clc-sdk

参数 

参数	注释
location 字符串 / 必需	策略存在/应该存在的数据中心。
name 字符串 / 必需	反亲和性策略的名称。
state 字符串	是创建还是删除策略。选项 `"present"` ←（默认） `"absent"`

属性 

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

说明 

注意

要使用此模块，需要设置以下环境变量，以启用对 Centurylink Cloud 的访问 - CLC_V2_API_USERNAME，centurylink cloud 的帐户登录 ID - CLC_V2_API_PASSWORD，centurylink cloud 的帐户密码
或者，该模块接受 API 令牌和帐户别名。可以使用 CLC 帐户登录名和密码通过 HTTP api 调用生成 API 令牌 @ https://api.ctl.io/v2/authentication/login - CLC_V2_API_TOKEN，从 https://api.ctl.io/v2/authentication/login 生成的 API 令牌 - CLC_ACCT_ALIAS，与 centurylink cloud 关联的帐户别名
用户可以设置 CLC_V2_API_URL 以指定指向不同 CLC 环境的端点。

示例 

# Note - You must set the CLC_V2_API_USERNAME And CLC_V2_API_PASSWD Environment variables before running these examples

---
- name: Create AA Policy
  hosts: localhost
  gather_facts: false
  connection: local
  tasks:
    - name: Create an Anti Affinity Policy
      community.general.clc_aa_policy:
        name: Hammer Time
        location: UK3
        state: present
      register: policy

    - name: Debug
      ansible.builtin.debug:
        var: policy

- name: Delete AA Policy
  hosts: localhost
  gather_facts: false
  connection: local
  tasks:
    - name: Delete an Anti Affinity Policy
      community.general.clc_aa_policy:
        name: Hammer Time
        location: UK3
        state: absent
      register: policy

    - name: Debug
      ansible.builtin.debug:
        var: policy

返回值 

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

键	描述
policy 字典	反亲和性策略信息已返回：成功示例： `{"id": "1a28dd0988984d87b9cd61fa8da15424", "links": [{"href": "/v2/antiAffinityPolicies/wfad/1a28dd0988984d87b9cd61fa8da15424", "rel": "self", "verbs": ["GET", "DELETE", "PUT"]}, {"href": "/v2/datacenters/wfad/UC1", "id": "uc1", "name": "UC1 - US West (Santa Clara)", "rel": "location"}], "location": "UC1", "name": "test_aa_policy"}`

作者

CLC Runner (@clc-runner)