community.general.clc_group 模块 – 在 CenturyLink Cloud 创建/删除服务器组

注意

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

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

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

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

概要 

在 CenturyLink Centurylink Cloud 创建或删除服务器组

要求 

在执行此模块的主机上需要以下要求。

python = 2.7
requests >= 2.5.0
clc-sdk

参数 

参数	注释
description 字符串	服务器组的描述
location 字符串	要在其中创建组的数据中心。如果未提供位置，则该组将在与该帐户关联的默认数据中心中创建
name 字符串 / 必需	服务器组的名称
parent 字符串	服务器组的父组。如果未提供父级，它将在顶层创建组。
state 字符串	是创建还是删除组选择 `"present"` ← (默认) `"absent"`
wait 布尔值	是否等待任务完成再返回。选择 `false` `true` ← (默认)

属性 

属性	支持	描述
check_mode	支持: 完全	可以在 `check_mode` 中运行，并返回更改的状态预测，而无需修改目标。
diff_mode	支持: 无	在差异模式下运行时，将返回有关已更改的内容（或可能需要在 `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 环境的端点。

示例 

# Create a Server Group

---
- name: Create Server Group
  hosts: localhost
  gather_facts: false
  connection: local
  tasks:
    - name: Create / Verify a Server Group at CenturyLink Cloud
      community.general.clc_group:
        name: My Cool Server Group
        parent: Default Group
        state: present
      register: clc

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

# Delete a Server Group
- name: Delete Server Group
  hosts: localhost
  gather_facts: false
  connection: local
  tasks:
    - name: Delete / Verify Absent a Server Group at CenturyLink Cloud
      community.general.clc_group:
        name: My Cool Server Group
        parent: Default Group
        state: absent
      register: clc

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

返回值 

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

键

描述

group

字典

组信息

已返回: 成功

示例: {"changeInfo": {"createdBy": "service.wfad", "createdDate": "2015-07-29T18:52:47Z", "modifiedBy": "service.wfad", "modifiedDate": "2015-07-29T18:52:47Z"}, "customFields": [], "description": "测试组", "groups": [], "id": "bb5f12a3c6044ae4ad0a03e73ae12cd1", "links": [{"href": "/v2/groups/wfad", "rel": "createGroup", "verbs": ["POST"]}, {"href": "/v2/servers/wfad", "rel": "createServer", "verbs": ["POST"]}, {"href": "/v2/groups/wfad/bb5f12a3c6044ae4ad0a03e73ae12cd1", "rel": "self", "verbs": ["GET", "PATCH", "DELETE"]}, {"href": "/v2/groups/wfad/086ac1dfe0b6411989e8d1b77c4065f0", "id": "086ac1dfe0b6411989e8d1b77c4065f0", "rel": "parentGroup"}, {"href": "/v2/groups/wfad/bb5f12a3c6044ae4ad0a03e73ae12cd1/defaults", "rel": "defaults", "verbs": ["GET", "POST"]}, {"href": "/v2/groups/wfad/bb5f12a3c6044ae4ad0a03e73ae12cd1/billing", "rel": "billing"}, {"href": "/v2/groups/wfad/bb5f12a3c6044ae4ad0a03e73ae12cd1/archive", "rel": "archiveGroupAction"}, {"href": "/v2/groups/wfad/bb5f12a3c6044ae4ad0a03e73ae12cd1/statistics", "rel": "statistics"}, {"href": "/v2/groups/wfad/bb5f12a3c6044ae4ad0a03e73ae12cd1/upcomingScheduledActivities", "rel": "upcomingScheduledActivities"}, {"href": "/v2/groups/wfad/bb5f12a3c6044ae4ad0a03e73ae12cd1/horizontalAutoscalePolicy", "rel": "horizontalAutoscalePolicyMapping", "verbs": ["GET", "PUT", "DELETE"]}, {"href": "/v2/groups/wfad/bb5f12a3c6044ae4ad0a03e73ae12cd1/scheduledActivities", "rel": "scheduledActivities", "verbs": ["GET", "POST"]}], "locationId": "UC1", "name": "测试组", "status": "active", "type": "default"}

作者

CLC 运行器 (@clc-runner)