Spec-Zone.ru › Ansible 2.9

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
-
    Варианты:
  • present ←
  • absent
Определяет, должна ли указанная запись ресурса присутствовать.
ttl
-
По умолчанию:
300
Количество секунд, в течение которых запись ресурса будет кешироваться решателем кэша.
type
- / обязательно
    Варианты:
  • A
  • AAAA
  • CNAME
  • SRV
  • TXT
  • SOA
  • NS
  • MX
  • SPF
  • PTR
Тип записи ресурса для добавления.
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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API