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 обязательно		Ссылка на ресурс ManagedZone.
name обязательно		Например, www.example.com.
project		Проект 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 }}"
      scopes:
        - https://www.googleapis.com/auth/ndev.clouddns.readwrite
      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: testProject
      auth_kind: service_account
      service_account_file: /tmp/auth.pem
      scopes:
        - https://www.googleapis.com/auth/ndev.clouddns.readwrite
      state: present

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

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

Ключ	Возвращаемое значение	Описание
managed_zone dict	success	Ссылка на ресурс ManagedZone.
name str	success	Например, www.example.com.
target list	success	Определено в RFC 1035 (раздел 5) и RFC 1034 (раздел 3.6.1).
ttl int	success	Количество секунд, в течение которых этот ResourceRecordSet может кэшироваться решателями.
type str	success	Один из допустимых типов ресурсов DNS.

Статус

Этот модуль помечен как preview, что означает, что он не гарантирует обратную совместимость интерфейса.

Техническое обслуживание

Этот модуль помечен как community, что означает, что он поддерживается сообществом Ansible. См. Поддержка модулей и техническое обслуживание для получения дополнительной информации.

Список других модулей, поддерживаемых сообществом Ansible, см. здесь.

Автор

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.6/modules/gcp_dns_resource_record_set_module.html