gcdns_zone – Создание или удаление зон в Google Cloud DNS
УСТЕРЕКШЕЕ
| Удалено в Ansible: | |
|---|---|
| версия: 2.12 | |
| Почему: | Обновленные модули выпущены с расширенной функциональностью |
| Альтернатива: | Используйте 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 и завершится ошибкой. псевдонимы: имя |
Примечания
Примечание
- См. также 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 строка | success | Описание зоны Пример: Это отличная зона |
| state строка | success | Указывает, присутствует или отсутствует зона Пример: present |
| zone строка | success | Имя домена DNS зоны Пример: example.com. |
Статус
- Этот модуль будет удален в версии 2.12. [устарел]
- Для получения дополнительной информации см. УСТЕРЕКШЕЕ.
Авторы
- 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.9/modules/gcdns_zone_module.html