gcdns_zone – Создание или удаление зон в Google Cloud DNS
Новая в версии 2.2.
Обзор
- Создаёт или удаляет управляемые зоны в 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). Если вы попытаетесь указать идентификатор зоны, этот модуль попытается создать домен верхнего уровня и завершится ошибкой. псевдонимы: name |
Примечания
Примечание
- См. также gcdns_record.
- Недавно созданные зоны должны быть настроены в доменном регистраторе, прежде чем они смогут быть использованы.
Примеры
# Basic zone creation example. - name: Create a basic zone with the minimum number of parameters. gcdns_zone: zone=example.com # Zone removal example. - name: Remove a zone. gcdns_zone: zone=example.com state=absent # Zone creation with description - name: Creating a zone with a description gcdns_zone: zone=example.com description="This is an awesome zone"
Значения возврата
Общие значения возврата описаны в этой документации. Ниже приведены поля, уникальные для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| description строка | успех | Описание зоны. Пример: Это отличная зона |
| state строка | успех | Указывает, присутствует или отсутствует зона. Пример: present |
| zone строка | успех | Имя домена DNS зоны. Пример: example.com. |
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [предварительная версия]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- 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.7/modules/gcdns_zone_module.html
