clc_publicip - Добавление и удаление общедоступных IP-адресов на серверах в CenturyLink Cloud.

Новая версия с 2.0.

Описание
Требования (к хосту, на котором выполняется модуль)
Параметры
Примеры
Возвращаемые значения
Примечания
- Статус

Описание

Модуль Ansible для добавления или удаления общедоступных IP-адресов на существующем или нескольких серверах в CenturyLink Cloud.

Требования (к хосту, на котором выполняется модуль)

python = 2.7
requests >= 2.5.0
clc-sdk

Параметры

параметр	обязательно	по умолчанию	варианты	комментарии
ports	нет	None		Список портов для экспонирования. Требуется, когда состояние равно 'present'.
protocol	нет	TCP	TCP UDP ICMP	Протокол, который будет прослушивать общедоступный IP-адрес.
server_ids	да			Список серверов, для которых будут созданы общедоступные IP-адреса.
state	нет	present	present absent	Определяет, нужно ли создать или удалить общедоступные IP-адреса. Если present, модуль не создаст второй общедоступный IP-адрес, если он уже существует.
wait	нет	True	True False	Нужно ли ожидать завершения задач перед возвратом.

Примеры

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

- name: Add Public IP to Server
  hosts: localhost
  gather_facts: False
  connection: local
  tasks:
    - name: Create Public IP For Servers
      clc_publicip:
        protocol: TCP
        ports:
          - 80
        server_ids:
          - UC1TEST-SVR01
          - UC1TEST-SVR02
        state: present
      register: clc

    - name: debug
      debug:
        var: clc

- name: Delete Public IP from Server
  hosts: localhost
  gather_facts: False
  connection: local
  tasks:
    - name: Create Public IP For Servers
      clc_publicip:
        server_ids:
          - UC1TEST-SVR01
          - UC1TEST-SVR02
        state: absent
      register: clc

    - name: debug
      debug:
        var: clc

Возвращаемые значения

Общие возвращаемые значения описаны здесь Возвращаемые значения, следующие поля уникальны для этого модуля:

название	описание	возвращаемое	тип	пример
server_ids	Список идентификаторов серверов, которые были изменены	успех	список	['UC1TEST-SVR01', 'UC1TEST-SVR02']

Примечания

Примечание

Для использования этого модуля необходимо установить следующие переменные среды, которые обеспечивают доступ к CenturyLink Cloud - CLC_V2_API_USERNAME, идентификатор учетной записи для CenturyLink Cloud - CLC_V2_API_PASSWORD, пароль учетной записи для CenturyLink Cloud.
В качестве альтернативы, модуль принимает токен API и псевдоним учетной записи. Токен API можно сгенерировать, используя данные входа в учетную запись CLC и пароль через вызов HTTP-API по адресу @ https://api.ctl.io/v2/authentication/login - CLC_V2_API_TOKEN, токен API, сгенерированный по адресу https://api.ctl.io/v2/authentication/login - CLC_ACCT_ALIAS, псевдоним учетной записи, связанной с CenturyLink Cloud.
Пользователи могут установить CLC_V2_API_URL для указания конечной точки для подключения к другому окружению CLC.

Статус

Этот модуль помечен как предварительный, что означает, что его интерфейс не гарантируется обратной совместимостью.

Для получения помощи в разработке модулей, если вы заинтересованы, ознакомьтесь с Справочной информацией по сообществу и участию, Тестирование Ansible и Разработка модулей.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/clc_publicip_module.html