gcp_dns_managed_zone_facts – Сбор фактов для управляемой зоны GCP

Новая в версии 2.8.

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

Обзор

Сбор фактов для управляемой зоны GCP

Требования

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

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
auth_kind строка / обязательно	Варианты: application machineaccount serviceaccount	Тип используемых учетных данных.
dns_name -		Ограничивает список, возвращая только зоны с указанным именем домена.
project строка		Проект Google Cloud Platform, который нужно использовать.
scopes список		Массив используемых областей.
service_account_contents строка		Строка, представляющая содержимое JSON-файла учетной записи службы. Не следует передавать в виде словаря, а в виде строки с точным содержимым файла service account json (корректный JSON).
service_account_email строка		Необязательный адрес электронной почты учетной записи службы, если выбран machineaccount, и пользователь не хочет использовать адрес по умолчанию.
service_account_file путь		Путь к файлу JSON учетной записи службы, если в качестве типа выбран serviceaccount.

Примечания

Примечание

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

Примеры

- name: " a managed zone facts"
  gcp_dns_managed_zone_facts:
    dns_name: test.somewild2.example.com.
    project: test_project
    auth_kind: serviceaccount
    service_account_file: "/tmp/auth.pem"
    state: facts

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

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

Ключ				Возвращается	Описание
items сложное				всегда	Список элементов
	creationTime строка			успех	Время создания этого ресурса на сервере. Формат — RFC3339.
	description строка			успех	Изменяемая строка длиной не более 1024 символов, связанная с этим ресурсом для удобства пользователя. Не влияет на работу управляемой зоны.
	dnsName строка			успех	Имя домена этой управляемой зоны, например «example.com.».
	id целое число			успех	Уникальный идентификатор ресурса, определенный сервером.
	labels словарь			успех	Набор пар ключ/значение тегов, которые необходимо назначить этой управляемой зоне.
	name строка			успех	Назначенное пользователем имя этого ресурса. Должно быть уникальным в рамках проекта.
	nameServers список			успех	Делегируйте свою управляемую зону этим виртуальным серверам имен; определяется сервером.
	nameServerSet строка			успех	Необязательно указывает NameServerSet для этой управляемой зоны. NameServerSet — это набор серверов DNS, которые все содержат те же управляемые зоны. Большинство пользователей оставят это поле пустым.
	privateVisibilityConfig сложное			успех	Для зон с частной видимостью — набор ресурсов виртуальных частных облаков, с которых доступна зона.
		networks сложное		успех	Список сетей VPC, которые могут видеть эту зону.
			networkUrl строка	успех	Полный URL-адрес сети VPC, которая должна быть связана. Должен быть отформатирован как `https://www.googleapis.com/compute/v1/projects/{project}/global/networks/{network}`.
	visibility строка			успех	Видимость зоны: общедоступные зоны доступны в Интернете, а зоны с ограниченным доступом видны только ресурсам виртуальных частных облаков. Должно быть одно из: `public`, `private`.

Статус

Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
Этот модуль поддерживается сообществом 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.8/modules/gcp_dns_managed_zone_facts_module.html