gcdns_zone - Создание или удаление зон в Google Cloud DNS
Новая версия 2.2.
- Обзор
- Требования (к хосту, на котором выполняется модуль)
- Параметры
- Примеры
- Значения возврата
- Примечания
Обзор
- Создает или удаляет управляемые зоны в Google Cloud DNS.
Требования (к хосту, на котором выполняется модуль)
- python >= 2.6
- 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 | нет | present |
| Указывает, должна ли данная зона быть присутствующей или отсутствовать. |
| zone | да | Имя домена DNS зоны. Это НЕ идентификатор зоны Google Cloud DNS (например, example-com). Если вы попытаетесь указать идентификатор зоны, этот модуль попытается создать домен верхнего уровня и потерпит неудачу. псевдонимы: name |
Примеры
# 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. |
Примечания
Примечание
- См. также gcdns_record.
- Недавно созданные зоны необходимо настроить у регистратора доменов, прежде чем они смогут использоваться.
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантированно будет обратно совместимым.
Для получения помощи в разработке модулей, если вы это планируете, пожалуйста, прочтите Информация о сообществе и внесение вклада, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/gcdns_zone_module.html
