community.general.hwc_vpc_eip – Создаёт ресурс Vpc/EIP в Huawei Cloud
Примечание
Этот плагин входит в коллекцию community.general (версия 2.0.1).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в playbook, укажите: community.general.hwc_vpc_eip.
Новое в версии 0.2.0: of community.general
Обзор
- Управление эластичными IP-адресами.
Требования
Ниже перечислены требования, необходимые на хосте, на котором будет выполняться этот модуль.
- keystoneauth1 >= 3.6.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| dedicated_bandwidth словарь | Указывает объект выделенной полосы пропускания. | ||
| charge_mode строка / обязательно | Указывает, по трафику или по размеру полосы пропускания рассчитывается оплата. Возможные значения: bandwidth или traffic. Если этот параметр опущен или имеет значение null, используется значение по умолчанию bandwidth. Для IPv6-адресов значение по умолчанию — bandwidth вне Китая и traffic в Китае. | ||
| name строка / обязательно | Указывает имя полосы пропускания. Значение — строка длиной от 1 до 64 символов, содержащая буквы, цифры, символы подчеркивания _, дефисы (-) и точки (.). | ||
| size целое число / обязательно | Указывает размер полосы пропускания. Значение по умолчанию от 1 Мбит/с до 2000 Мбит/с. (Точный диапазон может варьироваться в зависимости от настроек в каждом регионе. Диапазон полосы пропускания каждого региона можно посмотреть на консоли управления.) Минимальный шаг изменения полосы пропускания зависит от диапазона. Подробности следующие: Минимальный шаг 1 Мбит/с, если допустимый размер полосы пропускания от 0 до 300 Мбит/с (включая 300 Мбит/с). Минимальный шаг 50 Мбит/с, если допустимый размер полосы пропускания от 300 до 1000 Мбит/с (включая 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 строка | Указывает 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. - Значения переменных среды будут использоваться только в том случае, если значения в playbook не заданы.
Примеры
# 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/hwc_vpc_eip_module.html
