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

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

Описание
- Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус
Техническое обслуживание
- Автор

Описание

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

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

python = 2.7
requests >= 2.5.0
clc-sdk

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
ports		Список портов для экспонирования. Требуется, когда состояние — 'present'.
protocol	Варианты: TCP ← UDP ICMP	Протокол, на который будет слушать общедоступный IP.
server_ids обязательно		Список идентификаторов серверов, на которых нужно создать общедоступные IP-адреса.
state	Варианты: present ← absent	Определяет, нужно ли создавать или удалять общедоступные IP-адреса. Если present, модуль не создаст второй общедоступный IP, если он уже существует.
wait bool	Варианты: no yes ←	Ожидать завершения задач перед возвратом.

Примечания

Примечание

Для использования этого модуля необходимо установить следующие переменные среды, которые обеспечивают доступ к 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.

Примеры

# 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 список	success	Список идентификаторов серверов, которые были изменены Пример: ['UC1TEST-SVR01', 'UC1TEST-SVR02']

Статус

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

Техническое обслуживание

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

Список других модулей, также поддерживаемых сообществом Ansible, см. в здесь.

Автор

CLC Runner (@clc-runner)

Подсказка

Если вы обнаружите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.

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