Модуль community.general.clc_aa_policy – Создание или удаление политик антисродства в CenturyLink Cloud

Примечание

Этот модуль входит в коллекцию community.general (версия 9.5.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.general. Для использования этого модуля необходимы дополнительные требования. Подробнее см. Требования.

Для использования в плейбуке укажите: 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	Поддержка: отсутствует	Возвращает детали изменений (или, возможно, требующих изменения в `check_mode`) в режиме сравнения.

Примечания

Примечание

Для использования данного модуля необходимо установить переменные окружения, которые обеспечивают доступ к CenturyLink Cloud: CLC_V2_API_USERNAME (идентификатор входа в систему), CLC_V2_API_PASSWORD (пароль).
Альтернативно, модуль принимает токен API и псевдоним учетной записи. Токен API можно получить, выполнив вход в учетную запись CLC с помощью имени пользователя и пароля через вызов HTTP API по адресу https://api.ctl.io/v2/authentication/login - CLC_V2_API_TOKEN (токен API), CLC_ACCT_ALIAS (псевдоним учетной записи).
Пользователи могут установить 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"}`

Ключ

Описание

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)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/clc_aa_policy_module.html