community.general.clc_group 模块 – 在世纪互联云中创建/删除服务器组

注意

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

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

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

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

概要

• 在世纪互联云中创建或删除服务器组

要求

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

• python = 2.7

• requests >= 2.5.0

• clc-sdk

参数

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

属性

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

注释

注意

• 要使用此模块，需要设置以下环境变量，这些变量允许访问世纪互联云 - CLC_V2_API_USERNAME，世纪互联云的帐户登录 ID - CLC_V2_API_PASSWORD，世纪互联云的帐户密码。

• 或者，该模块接受 API 令牌和帐户别名。可以使用 CLC 帐户登录名和密码通过 HTTP api 调用在 https://api.ctl.io/v2/authentication/login 生成 API 令牌 - CLC_V2_API_TOKEN，从 https://api.ctl.io/v2/authentication/login 生成的 API 令牌 - CLC_ACCT_ALIAS，与世纪互联云关联的帐户别名。

• 用户可以设置 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": "test group", "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": "test group", "status": "active", "type": "default"}

作者

• CLC Runner (@clc-runner)

资源链接

• 问题追踪器
• 代码仓库 (源码)
• 寻求帮助
• 提交错误报告
• 功能请求
• 沟通