gcp_dns_resource_record_set – Создаёт ресурсный набор записей GCP ResourceRecordSet

Новое в версии 2.6.

Обзор
Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

Обзор

Единая запись DNS, которая существует в доменном имени (т.е. в управляемой зоне).
Эта запись определяет информацию о домене и куда направляются домен / поддомены.
Запись будет содержать имя домена/поддомена, тип (т.е. A, AAA, CAA, MX, CNAME, NS и т.д.).

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

python >= 2.6
requests >= 2.18.4
google-auth >= 1.3.0

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
auth_kind - / обязательно	Варианты: machineaccount serviceaccount application	Тип используемых учетных данных.
managed_zone - / обязательно		Идентификатор управляемой зоны, на которую обращается этот запрос. Может быть именем или идентификатором управляемой зоны.
name - / обязательно		Например, www.example.com.
project -	По умолчанию: null	Проект Google Cloud Platform, который следует использовать.
scopes -		Массив используемых областей.
service_account_email -		Дополнительный адрес электронной почты учетной записи сервиса, если выбран machineaccount и пользователь не хочет использовать адрес по умолчанию.
service_account_file -		Путь к файлу JSON учетной записи сервиса, если в качестве типа выбран serviceaccount.
state -	Варианты: present ← absent	Должен ли данный объект существовать в GCP
target -		Определено в RFC 1035 (раздел 5) и RFC 1034 (раздел 3.6.1).
ttl -		Количество секунд, в течение которых этот ResourceRecordSet может быть кэширован решателями.
type - / обязательно	Варианты: A AAAA CAA CNAME MX NAPTR NS PTR SOA SPF SRV TXT	Один из допустимых типов ресурсов DNS.

Примечания

Примечание

Для аутентификации можно установить service_account_file с помощью переменной окружения GCP_SERVICE_ACCOUNT_FILE.
Для аутентификации можно установить service_account_email с помощью переменной окружения GCP_SERVICE_ACCOUNT_EMAIL.
Для аутентификации можно установить auth_kind с помощью переменной окружения GCP_AUTH_KIND.
Для аутентификации можно установить scopes с помощью переменной окружения GCP_SCOPES.
Значения переменных окружения будут использоваться только в том случае, если значения в книге задач не заданы.
Параметры service_account_email и service_account_file взаимоисключающие.

Примеры

- name: create a managed zone
  gcp_dns_managed_zone:
      name: "managedzone-rrs"
      dns_name: testzone-4.com.
      description: test zone
      project: "{{ gcp_project }}"
      auth_kind: "{{ gcp_cred_kind }}"
      service_account_file: "{{ gcp_cred_file }}"
      state: present
  register: managed_zone

- name: create a resource record set
  gcp_dns_resource_record_set:
      name: www.testzone-4.com.
      managed_zone: "{{ managed_zone }}"
      type: A
      ttl: 600
      target:
      - 10.1.2.3
      - 40.5.6.7
      project: "test_project"
      auth_kind: "service_account"
      service_account_file: "/tmp/auth.pem"
      state: present

Возвращаемые значения

Общие возвращаемые значения документированы здесь, следующие являются полями, уникальными для этого модуля:

Ключ	Возвращаемое значение	Описание
managed_zone словарь	успех	Идентификатор управляемой зоны, на которую обращается этот запрос. Может быть именем или идентификатором управляемой зоны.
name строка	успех	Например, www.example.com.
target список	успех	Определено в RFC 1035 (раздел 5) и RFC 1034 (раздел 3.6.1).
ttl целое число	успех	Количество секунд, в течение которых этот ResourceRecordSet может быть кэширован решателями.
type строка	успех	Один из допустимых типов ресурсов DNS.

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

Google Inc. (@googlecloudplatform)

Подсказка

Если вы заметите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/gcp_dns_resource_record_set_module.html