gcp_compute_network_info – Сбор информации о сети GCP

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

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

Обзор

Сбор информации о сети GCP
Этот модуль назывался gcp_compute_network_facts до Ansible 2.9. Способ использования не изменился.

Псевдонимы: gcp_compute_network_facts

Требования

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

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
auth_kind строка / обязательно	Варианты: application machineaccount serviceaccount	Тип используемых учетных данных.
env_type строка		Указывает, в какой среде Ansible выполняется этот модуль. Не устанавливайте это значение, если вы не знаете, что делаете. Это изменяет только строку User Agent для любых запросов к API.
filters список		Список пар значений фильтров. Доступные фильтры перечислены здесь https://cloud.google.com/sdk/gcloud/reference/topic/filters. Каждый дополнительный фильтр в списке будет добавлен как условие И (filter1 и filter2).
project строка		Проект Google Cloud Platform для использования.
scopes список		Массив используемых областей.
service_account_contents jsonarg		Содержание файла JSON учетной записи службы, либо в виде словаря, либо как строка JSON, его представляющая.
service_account_email строка		Дополнительный адрес электронной почты учетной записи службы, если выбрано machineaccount и пользователь не хочет использовать адрес по умолчанию.
service_account_file путь		Путь к файлу JSON учетной записи службы, если в качестве типа выбран serviceaccount.

Примечания

Примечание

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

Примеры

- name: get info on a network
  gcp_compute_network_info:
    filters:
    - name = test_object
    project: test_project
    auth_kind: serviceaccount
    service_account_file: "/tmp/auth.pem"

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

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

Ключ			Возвращается	Описание
resources сложное			всегда	Список ресурсов
	autoCreateSubnetworks логическое		успех	При установке в `true`, сеть создается в режиме "автоматическое создание подсетей" и будет автоматически создавать подсеть для каждого региона в диапазоне адресов `10.128.0.0/9`. При установке в `false`, сеть создается в режиме "пользовательское создание подсетей", поэтому пользователь может явно подключить ресурсы подсетей.
	creationTimestamp строка		успех	Дата и время создания в формате RFC3339.
	description строка		успех	Необязательное описание этого ресурса. Для изменения этого поля необходимо повторно создать ресурс.
	gateway_ipv4 строка		успех	Адрес шлюза для маршрутизации по умолчанию из сети. Это значение выбирается GCP.
	id целое число		успех	Уникальный идентификатор ресурса.
	ipv4_range строка		успех	Если это поле указано, создается устаревшая сеть legacy. Вы больше не сможете создавать сети legacy с 1 февраля 2020 года. См. [документацию по сетям legacy](https://cloud.google.com/vpc/docs/legacy) для получения дополнительной информации. Диапазон внутренних адресов, допустимых в этой сети legacy. Этот диапазон — спецификация CIDR, например: `192.168.0.0/16`. Для изменения этого поля необходимо повторно создать ресурс.
	name строка		успех	Имя ресурса. Указывается клиентом при создании ресурса. Длина имени должна составлять от 1 до 63 символов и соответствовать RFC1035. В частности, длина имени должна составлять от 1 до 63 символов и соответствовать регулярному выражению `[a-z]([-a-z0-9]*[a-z0-9])?`, что означает, что первый символ должен быть строчной буквой, а все последующие символы должны быть тире, строчной буквой или цифрой, за исключением последнего символа, который не может быть тире.
	routingConfig сложное		успех	Настройка маршрутизации на уровне сети для этой сети. Используется маршрутизатором Cloud для определения типа поведения маршрутизации по всей сети.
		routingMode строка	успех	Режим маршрутизации по всей сети для использования. Если установлено в `REGIONAL`, маршрутизаторы облака этой сети будут рекламировать только маршруты с подсетями этой сети в том же регионе, что и маршрутизатор. Если установлено в `GLOBAL`, маршрутизаторы облака этой сети будут рекламировать маршруты со всеми подсетями этой сети в разных регионах.
	subnetworks список		успех	Определяемые сервером полные URL-адреса всех подсетей в этой сети.

Статус

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