gcdns_record – Создаёт или удаляет записи ресурсов в Google Cloud DNS
УСТЕРЕШЕНО
| Удалено в Ansible: | |
|---|---|
| версия: 2.12 | |
| Почему: | Выпущены обновлённые модули с расширенными возможностями |
| Альтернатива: | Используйте gcp_dns_resource_record_set вместо этого. |
Синопсис
- Создаёт или удаляет записи ресурсов в Google Cloud DNS.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.6
- apache-libcloud >= 0.19.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| credentials_file - | Путь к JSON-файлу, связанному с электронным адресом учётной записи службы. | |
| overwrite boolean |
| Определяет, должно ли удачное переопределение существующей записи выполняться или завершиться неудачей. Поведение этого параметра зависит от параметра state. Если state — present и overwrite — True, этот модуль заменит существующую запись ресурса с тем же именем предоставленным record_data. Если state — present и overwrite — False, этот модуль завершится неудачей, если существует существующая запись ресурса с тем же именем и типом, но разными данными ресурса.Если state — absent и overwrite — True, этот модуль удалит предоставленную запись ресурса безусловно. Если state — absent и overwrite — False, этот модуль завершится неудачей, если предоставленные record_data не точно соответствуют данным существующей записи ресурса. |
| pem_file - | Путь к PEM-файлу, связанному с электронным адресом учётной записи службы. Этот параметр устарел и может быть удален в будущих версиях. Используйте credentials_file вместо него. | |
| project_id - | Идентификатор проекта Google Cloud Platform, который нужно использовать. | |
| record - / обязательно | Полное доменное имя записи ресурса. псевдонимы: имя | |
| record_data - | Данные record_data для использования в записи ресурса.
record_data должен быть указан, если state — present или overwrite — True, иначе модуль завершится неудачей.Допустимые значения record_data зависят от типа записи. Кроме того, записи ресурсов, которые содержат доменное имя DNS в поле значения (например, CNAME, PTR, SRV и т. д.), ДОЛЖНЫ содержать конечную точку в значении. Отдельные строковые данные записи для записей TXT должны быть заключены в двойные кавычки. Для записей ресурсов с одинаковым именем, но разными данными record_data (например, несколько записей A), они должны быть определены как несколько записей в списке в одной записи. псевдонимы: значение | |
| service_account_email - | Электронный адрес учётной записи службы с доступом к Google Cloud DNS. | |
| state - |
| Определяет, должна ли указанная запись ресурса присутствовать. |
| ttl - | По умолчанию: 300 | Количество секунд, в течение которых запись ресурса будет кешироваться решателем кэша. |
| type - / обязательно |
| Тип записи ресурса для добавления. |
| zone - | Доменное имя DNS зоны (например, example.com). Должен быть указан один из zone или zone_id, иначе модуль завершится неудачей. Если указаны оба zone и zone_id, будет использоваться zone_id. | |
| zone_id - | Идентификатор зоны Google Cloud (например, example-com). Должен быть указан один из zone или zone_id, иначе модуль завершится неудачей. Они обычно имеют вид доменных имён с точками, заменёнными дефисами. Идентификатор зоны никогда не будет содержать точек.
zone_id может быть быстрее, чем zone в проектах с большим количеством зон. Если указаны оба zone и zone_id, будет использоваться zone_id. |
Примечания
Примечание
- См. также gcdns_zone.
- Внутренняя библиотека этого модуля не поддерживает обновление записей ресурсов DNS на месте. Вместо этого записи ресурсов быстро удаляются и пересоздаются.
- Записи SOA технически поддерживаются, но их функциональность ограничена проверкой соответствия существующей записи SOA зоны предопределённому значению. Запись SOA не может быть обновлена.
- Корневые записи NS не могут быть обновлены.
- Записи NAPTR не поддерживаются.
Примеры
# Create an A record.
- gcdns_record:
record: 'www1.example.com'
zone: 'example.com'
type: A
value: '1.2.3.4'
# Update an existing record.
- gcdns_record:
record: 'www1.example.com'
zone: 'example.com'
type: A
overwrite: true
value: '5.6.7.8'
# Remove an A record.
- gcdns_record:
record: 'www1.example.com'
zone_id: 'example-com'
state: absent
type: A
value: '5.6.7.8'
# Create a CNAME record.
- gcdns_record:
record: 'www.example.com'
zone_id: 'example-com'
type: CNAME
value: 'www.example.com.' # Note the trailing dot
# Create an MX record with a custom TTL.
- gcdns_record:
record: 'example.com'
zone: 'example.com'
type: MX
ttl: 3600
value: '10 mail.example.com.' # Note the trailing dot
# Create multiple A records with the same name.
- gcdns_record:
record: 'api.example.com'
zone_id: 'example-com'
type: A
record_data:
- '192.0.2.23'
- '10.4.5.6'
- '198.51.100.5'
- '203.0.113.10'
# Change the value of an existing record with multiple record_data.
- gcdns_record:
record: 'api.example.com'
zone: 'example.com'
type: A
overwrite: true
record_data: # WARNING: All values in a record will be replaced
- '192.0.2.23'
- '192.0.2.42' # The changed record
- '198.51.100.5'
- '203.0.113.10'
# Safely remove a multi-line record.
- gcdns_record:
record: 'api.example.com'
zone_id: 'example-com'
state: absent
type: A
record_data: # NOTE: All of the values must match exactly
- '192.0.2.23'
- '192.0.2.42'
- '198.51.100.5'
- '203.0.113.10'
# Unconditionally remove a record.
- gcdns_record:
record: 'api.example.com'
zone_id: 'example-com'
state: absent
overwrite: true # overwrite is true, so no values are needed
type: A
# Create an AAAA record
- gcdns_record:
record: 'www1.example.com'
zone: 'example.com'
type: AAAA
value: 'fd00:db8::1'
# Create a PTR record
- gcdns_record:
record: '10.5.168.192.in-addr.arpa'
zone: '5.168.192.in-addr.arpa'
type: PTR
value: 'api.example.com.' # Note the trailing dot.
# Create an NS record
- gcdns_record:
record: 'subdomain.example.com'
zone: 'example.com'
type: NS
ttl: 21600
record_data:
- 'ns-cloud-d1.googledomains.com.' # Note the trailing dots on values
- 'ns-cloud-d2.googledomains.com.'
- 'ns-cloud-d3.googledomains.com.'
- 'ns-cloud-d4.googledomains.com.'
# Create a TXT record
- gcdns_record:
record: 'example.com'
zone_id: 'example-com'
type: TXT
record_data:
- '"v=spf1 include:_spf.google.com -all"' # A single-string TXT value
- '"hello " "world"' # A multi-string TXT value
Возвращаемые значения
Общие значения возврата описаны здесь, следующие — поля, уникальные для данного модуля:
| Ключ | Возвращённое значение | Описание |
|---|---|---|
| overwrite boolean | успешно | Будет ли модуль разрешен на переопределение записи Пример: True |
| record строка | успешно | Полное доменное имя записи ресурса Пример: mail.example.com. |
| record_data список | успешно | Значения записи ресурса Пример: ['5.6.7.8', '9.10.11.12'] |
| state строка | успешно | Состояние записи: присутствует или отсутствует Пример: present |
| ttl целое число | успешно | Время жизни записи ресурса Пример: 300 |
| type строка | успешно | Тип записи ресурса Пример: A |
| zone строка | успешно | Имя домена зоны Пример: example.com. |
| zone_id строка | успешно | Идентификатор зоны Google Cloud DNS Пример: example-com |
Статус
- Этот модуль будет удалён в версии 2.12. [устаревший]
- Для получения дополнительной информации см. УСТАРЕВШИЙ.
Авторы
- Уильям Альберт (@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_record_module.html