community.general.hwc_vpc_eip – Создаёт ресурс Vpc/EIP в Huawei Cloud
Примечание
Этот плагин входит в сборку community.general (версия 1.3.2).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в книге задач укажите: community.general.hwc_vpc_eip.
Новое в версии 0.2.0: сборки community.general
Обзор
- Управление эластичными IP-адресами.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- keystoneauth1 >= 3.6.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| dedicated_bandwidth словарь | Указывает объект выделенной пропускной способности. | ||
| charge_mode строка / обязательно | Указывает, оплачивается ли пропускная способность по трафику или по объёму. Значение может быть bandwidth или traffic. Если этот параметр оставлен пустым или равен пустой строке, используется значение по умолчанию bandwidth. Для IPv6-адресов значение параметра по умолчанию — bandwidth вне Китая и traffic в Китае. | ||
| name строка / обязательно | Указывает имя пропускной способности. Значение — строка длиной от 1 до 64 символов, которая может содержать буквы, цифры, символы нижнего подчеркивания _, дефисы (-) и точки (.). | ||
| size целое число / обязательно | Указывает размер пропускной способности. Значение по умолчанию — от 1 Мбит/с до 2000 Мбит/с. (Конкретный диапазон может варьироваться в зависимости от настроек в каждом регионе. Диапазон пропускной способности для каждого региона можно посмотреть на консоли управления.) Минимальная единица для изменения пропускной способности варьируется в зависимости от диапазона пропускной способности. Подробности приведены ниже. Минимальная единица составляет 1 Мбит/с, если разрешенный размер пропускной способности составляет от 0 до 300 Мбит/с (включительно). Минимальная единица составляет 50 Мбит/с, если разрешенный размер пропускной способности составляет от 300 до 1000 Мбит/с (включительно). Минимальная единица составляет 500 Мбит/с, если разрешенный размер пропускной способности больше 1000 Мбит/с. | ||
| domain строка / обязательно | Имя домена для применения (Identity v3). (В настоящее время поддерживаются только имена доменов, а не идентификаторы доменов). | ||
| enterprise_project_id строка | Указывает идентификатор корпоративного проекта. | ||
| id строка | Идентификатор управляемого ресурса. | ||
| identity_endpoint строка / обязательно | URL аутентификации Identity. | ||
| ip_version целое число | Значение может быть 4 (IPv4-адрес) или 6 (IPv6-адрес). Если этот параметр оставлен пустым, будет назначен IPv4-адрес. | ||
| ipv4_address строка | Указывает полученный IPv4 EIP. Система автоматически назначает EIP, если вы его не укажете. | ||
| password строка / обязательно | Пароль для входа. | ||
| port_id строка | Указывает идентификатор порта. Этот параметр возвращается только при привязке частного IP-адреса к EIP. | ||
| project строка / обязательно | Название арендатора (Identity v2) или проекта (Identity v3). (В настоящее время поддерживаются только имена проектов, а не идентификаторы проектов). | ||
| region строка | Регион, к которому относится проект. | ||
| shared_bandwidth_id строка | Указывает идентификатор общей пропускной способности. | ||
| state строка |
| Нужно ли создать указанный объект в Huawei Cloud. | |
| timeouts словарь | Таймауты для каждой операции. | ||
| create строка | По умолчанию: "5m" | Таймауты для операции создания. | |
| update строка | По умолчанию: "5m" | Таймауты для операции обновления. | |
| type строка / обязательно | Указывает тип EIP. | ||
| user строка / обязательно | Имя пользователя для входа (в настоящее время поддерживаются только имена пользователей, а не идентификаторы пользователей). | ||
Примечания
Примечание
- Для аутентификации можно установить 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/hwc_vpc_eip_module.html
