Spec-Zone.ru › Ansible

Модуль community.general.hwc_vpc_eip – Создаёт ресурс Vpc/EIP в Huawei Cloud

Примечание

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

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

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

Для использования в плейбуке укажите: community.general.hwc_vpc_eip.

Новое в community.general 0.2.0

  • Описание
  • Требования
  • Параметры
  • Атрибуты
  • Примечания
  • Примеры
  • Возвращаемые значения

Описание

  • Управление эластичными IP-адресами.

Требования

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

  • keystoneauth1 >= 3.6.0

Параметры

Параметр

Комментарии

dedicated_bandwidth

dictionary

Задает объект выделенной полосы пропускания.

charge_mode

string / required

Указывает, оплачивается ли полоса пропускания по трафику или по размеру полосы пропускания. Значение может быть bandwidth или traffic. Если этот параметр оставлен пустым или является пустой строкой, используется значение по умолчанию bandwidth. Для адресов IPv6 значение параметра по умолчанию — bandwidth за пределами Китая и traffic в Китае.

name

string / required

Указывает имя полосы пропускания. Значение представляет собой строку от 1 до 64 символов, которая может содержать буквы, цифры, символы подчеркивания (_), дефисы (-) и точки (.).

size

integer / required

Указывает размер полосы пропускания. По умолчанию значение находится в диапазоне от 1 Мбит/с до 2000 Мбит/с. (Конкретный диапазон может варьироваться в зависимости от конфигурации в каждом регионе. Диапазон полосы пропускания для каждого региона можно посмотреть на консоли управления.) Минимальная единица для регулировки полосы пропускания зависит от диапазона полосы пропускания. Подробности приведены ниже.

Минимальная единица составляет 1 Мбит/с, если допустимый размер полосы пропускания находится в диапазоне от 0 до 300 Мбит/с (включая 300 Мбит/с).

Минимальная единица составляет 50 Мбит/с, если допустимый размер полосы пропускания находится в диапазоне от 300 Мбит/с до 1000 Мбит/с (включая 1000 Мбит/с).

Минимальная единица составляет 500 Мбит/с, если допустимый размер полосы пропускания больше 1000 Мбит/с.

domain

string / required

Имя домена для ограничения области действия (Identity v3).

В настоящее время поддерживаются только имена доменов, а не идентификаторы доменов.

enterprise_project_id

string

Указывает идентификатор проекта предприятия.

id

string

Идентификатор ресурса, которым нужно управлять.

identity_endpoint

string / required

URL-адрес проверки подлинности Identity.

ip_version

integer

Значение может быть 4 (адрес IPv4) или 6 (адрес IPv6). Если этот параметр оставлен пустым, будет назначен адрес IPv4.

ipv4_address

string

Указывает полученный IPv4 EIP. Система автоматически назначает EIP, если вы его не указываете.

password

string / required

Пароль для входа.

port_id

string

Указывает идентификатор порта. Этот параметр возвращается только тогда, когда с EIP связан частный IP-адрес.

project

string / required

Имя клиента (Identity v2) или проекта (Identity v3).

В настоящее время поддерживаются только имена проектов, а не идентификаторы проектов.

region

string

Регион, которому принадлежит проект.

shared_bandwidth_id

string

Указывает идентификатор общей полосы пропускания.

state

string

Должен ли данный объект существовать в облаке Huawei.

Варианты:

  • "present" ← (default)
  • "absent"

timeouts

dictionary

Тайм-ауты для каждой операции.

Значение по умолчанию: {}

create

string

Тайм-ауты для операции создания.

Значение по умолчанию: "5m"

update

string

Тайм-ауты для операции обновления.

Значение по умолчанию: "5m"

type

string / required

Указывает тип EIP.

user

string / required

Имя пользователя для входа.

В настоящее время поддерживаются только имена пользователей, а не идентификаторы пользователей.

Атрибуты

Атрибут

Поддержка

Описание

check_mode

Поддержка: полная

Может выполняться в check_mode и возвращать прогноз состояния изменения без модификации целевого объекта.

diff_mode

Поддержка: нет

При использовании режима diff возвращает информацию о том, что изменилось (или, возможно, требует изменения в check_mode).

Примечания

Примечание

  • Для аутентификации можно установить identity_endpoint с помощью переменной окружения ANSIBLE_HWC_IDENTITY_ENDPOINT.
  • Для аутентификации можно установить user с помощью переменной окружения ANSIBLE_HWC_USER.
  • Для аутентификации можно установить password с помощью переменной окружения ANSIBLE_HWC_PASSWORD.
  • Для аутентификации можно установить domain с помощью переменной окружения ANSIBLE_HWC_DOMAIN.
  • Для аутентификации можно установить project с помощью переменной окружения ANSIBLE_HWC_PROJECT.
  • Для аутентификации можно установить region с помощью переменной окружения ANSIBLE_HWC_REGION.
  • Значения переменных окружения будут использоваться только в том случае, если значения в плейбуке не заданы.

Примеры

# create an eip and bind it to a port
- name: Create vpc
  hwc_network_vpc:
    cidr: "192.168.100.0/24"
    name: "ansible_network_vpc_test"
  register: vpc
- name: Create subnet
  hwc_vpc_subnet:
    gateway_ip: "192.168.100.32"
    name: "ansible_network_subnet_test"
    dhcp_enable: true
    vpc_id: "{{ vpc.id }}"
    cidr: "192.168.100.0/26"
  register: subnet
- name: Create a port
  hwc_vpc_port:
    subnet_id: "{{ subnet.id }}"
    ip_address: "192.168.100.33"
  register: port
- name: Create an eip and bind it to a port
  community.general.hwc_vpc_eip:
    type: "5_bgp"
    dedicated_bandwidth:
      charge_mode: "traffic"
      name: "ansible_test_dedicated_bandwidth"
      size: 1
    port_id: "{{ port.id }}"

Значения возврата

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

Ключ

Описание

create_time

строка

Указывает время (UTC), когда EIP был назначен.

Возвращается: успех

dedicated_bandwidth

словарь

Указывает объект выделенной пропускной способности.

Возвращается: успех

charge_mode

строка

Указывает, оплачивается ли пропускная способность по трафику или по объему пропускной способности. Значение может быть bandwidth или traffic. Если этот параметр оставлен пустым или является пустой строкой, используется значение по умолчанию bandwidth. Для адресов IPv6 значение параметра по умолчанию — bandwidth за пределами Китая и traffic в Китае.

Возвращается: успех

id

строка

Указывает идентификатор выделенной пропускной способности.

Возвращается: успех

name

строка

Указывает имя пропускной способности. Значение — строка от 1 до 64 символов, которая может содержать буквы, цифры, символы подчеркивания (_), дефисы (-) и точки (.).

Возвращается: успех

size

целое число

Указывает размер пропускной способности. Значение варьируется от 1 Мбит/с до 2000 Мбит/с по умолчанию. (Конкретный диапазон может отличаться в зависимости от конфигурации в каждом регионе. Диапазон пропускной способности для каждого региона можно посмотреть на консоли управления.) Минимальная единица для корректировки пропускной способности зависит от диапазона пропускной способности. Подробности следующие:

Минимальная единица составляет 1 Мбит/с, если допустимый размер пропускной способности находится в диапазоне от 0 до 300 Мбит/с (включая 300 Мбит/с).

Минимальная единица составляет 50 Мбит/с, если допустимый размер пропускной способности находится в диапазоне от 300 Мбит/с до 1000 Мбит/с (включая 1000 Мбит/с).

Минимальная единица составляет 500 Мбит/с, если допустимый размер пропускной способности превышает 1000 Мбит/с.

Возвращается: успех

enterprise_project_id

строка

Указывает идентификатор корпоративного проекта.

Возвращается: успех

ip_version

целое число

Значение может быть 4 (адрес IPv4) или 6 (адрес IPv6). Если этот параметр оставлен пустым, будет назначен адрес IPv4.

Возвращается: успех

ipv4_address

строка

Указывает полученный IPv4 EIP. Система автоматически назначает EIP, если вы его не указываете.

Возвращается: успех

ipv6_address

строка

Указывает полученный IPv6 EIP.

Возвращается: успех

port_id

строка

Указывает идентификатор порта. Этот параметр возвращается только при привязке частного IP-адреса к EIP.

Возвращается: успех

private_ip_address

строка

Указывает частный IP-адрес, привязанный к EIP. Этот параметр возвращается только при привязке частного IP-адреса к EIP.

Возвращается: успех

shared_bandwidth_id

строка

Указывает идентификатор общей пропускной способности.

Возвращается: успех

type

строка

Указывает тип EIP.

Возвращается: успех

Авторы

  • Huawei Inc. (@huaweicloud)

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

  • Система отслеживания проблем
  • Репозиторий (источники)
  • Задать вопрос о помощи
  • Отправить сообщение об ошибке
  • Запросить новую функцию
  • Общение

© 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/hwc_vpc_eip_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API