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. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.
Список других модулей, которые также поддерживаются сообществом 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.6/modules/gcdns_zone_module.html
