community.general.clc_group (8.5.0) — module

Install collection

Install with ansible-galaxy collection install community.general:==8.5.0

Add to requirements.yml

  collections:
    - name: community.general
      version: 8.5.0

Description

Create or delete Server Groups at Centurylink Centurylink Cloud

Requirements

• python = 2.7
• requests >= 2.5.0
• clc-sdk

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

# 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

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

# 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

Inputs

    
name:
    description:
    - The name of the Server Group
    required: true
    type: str

wait:
    default: true
    description:
    - Whether to wait for the tasks to finish before returning.
    required: false
    type: bool

state:
    choices:
    - present
    - absent
    default: present
    description:
    - Whether to create or delete the group
    type: str

parent:
    description:
    - The parent group of the server group. If parent is not provided, it creates the
      group at top level.
    required: false
    type: str

location:
    description:
    - Datacenter to create the group in. If location is not provided, the group gets created
      in the default datacenter associated with the account
    required: false
    type: str

description:
    description:
    - A description of the Server Group
    required: false
    type: str

Outputs

group:
  description: The group information
  returned: success
  sample:
    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
  type: dict