community.general.gcdns_zone – Создаёт или удаляет зоны в Google Cloud DNS
Примечание
Этот плагин входит в коллекцию community.general (версия 1.3.2).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в playbook, укажите: community.general.gcdns_zone.
УСТАРЕВШИЙ
- Удалён в
-
версии 2.0.0
- Почему
-
Обновлённые модули выпущены с расширенными возможностями
- Альтернатива
-
Используйте google.cloud.gcp_dns_managed_zone вместо этого.
Описание
- Создаёт или удаляет управляемые зоны в Google Cloud DNS.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- apache-libcloud >= 0.19.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| credentials_file путь | Путь к JSON-файлу, связанному с электронной почтой учётной записи службы. | |
| description строка | По умолчанию: "" | Произвольная строка текста для описания зоны. |
| pem_file путь | Путь к PEM-файлу, связанному с электронной почтой учётной записи службы. Этот параметр устарел и может быть удалён в будущих версиях. Используйте credentials_file вместо этого. | |
| project_id строка | Идентификатор проекта Google Cloud Platform, который следует использовать. | |
| service_account_email строка | Адрес электронной почты учётной записи службы с доступом к Google Cloud DNS. | |
| state строка |
| Определяет, должна ли данная зона присутствовать. |
| zone строка / обязательный | Имя домена DNS зоны. Это НЕ идентификатор зоны Google Cloud DNS (например, example-com). Если вы попытаетесь указать идентификатор зоны, этот модуль попытается создать TLD и завершится ошибкой. Псевдонимы: name |
Примечания
Примечание
- См. также community.general.gcdns_record.
- Недавно созданные зоны всё ещё должны быть настроены в реестре доменных имён, прежде чем они смогут быть использованы.
Примеры
# Basic zone creation example. - name: Create a basic zone with the minimum number of parameters. community.general.gcdns_zone: zone=example.com # Zone removal example. - name: Remove a zone. community.general.gcdns_zone: zone=example.com state=absent # Zone creation with description - name: Creating a zone with a description community.general.gcdns_zone: zone=example.com description="This is an awesome zone"
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие являются полями, уникальными для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| description строка | success | Описание зоны Пример: Это потрясающая зона |
| state строка | success | Наличие или отсутствие зоны Пример: present |
| zone строка | success | Имя домена DNS зоны Пример: example.com. |
Статус
- Этот модуль будет удалён в версии 2.0.0. [устарел]
- Дополнительную информацию см. в разделе УСТАРЕВШИЙ.
Авторы
- William Albert (@walbert947)
© 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/gcdns_zone_module.html
