gcdns_zone - Создание или удаление зон в Google Cloud DNS
Новая версия 2.2.
Обзор
- Создаёт или удаляет управляемые зоны в Google Cloud DNS.
Требования
Ниже перечислены требования к хосту, на котором выполняется данный модуль.
- apache-libcloud >= 0.19.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| credentials_file | Значение по умолчанию: None | Путь к JSON-файлу, связанному с электронным адресом учётной записи сервиса. |
| description | Значение по умолчанию: | Произвольная строка текста для описания зоны. |
| pem_file | Значение по умолчанию: None | Путь к PEM-файлу, связанному с электронным адресом учётной записи сервиса. Этот параметр устарел и может быть удалён в будущих версиях. Используйте credentials_file вместо него. |
| project_id | Значение по умолчанию: None | Идентификатор проекта Google Cloud Platform. |
| service_account_email | Значение по умолчанию: None | Электронный адрес учётной записи сервиса с доступом к 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. |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантирует обратную совместимость.
Автор
- 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.5/modules/gcdns_zone_module.html
