gcp_compute_url_map_info – Сбор информации о GCP UrlMap

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

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

Обзор

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

Псевдонимы: gcp_compute_url_map_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 an URL map
  gcp_compute_url_map_info:
    filters:
    - name = test_object
    project: test_project
    auth_kind: serviceaccount
    service_account_file: "/tmp/auth.pem"

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

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

Ключ				Возвращаемое значение	Описание
resources complex				всегда	Список ресурсов
	creationTimestamp string			успех	Маркер создания в формате RFC3339.
	defaultService dictionary			успех	Ссылка на ресурс BackendService, если ни один из правил hostRules не соответствует.
	description string			успех	Необязательное описание этого ресурса. Укажите это свойство при создании ресурса.
	fingerprint string			успех	Отпечаток этого ресурса. Это поле используется внутри для обновлений этого ресурса.
	hostRules complex			успех	Список HostRules для использования с URL.
		description string		успех	Необязательное описание этого HostRule. Укажите это свойство при создании ресурса.
		hosts list		успех	Список шаблонов хостов для сопоставления. Они должны быть валидными именами хостов, за исключением , которая будет соответствовать любой строке ([a-z0-9-.]). В этом случае * должен быть первым символом и должен быть после него либо - или .
		pathMatcher string		успех	Имя PathMatcher для сопоставления с частью пути URL, если hostRule соответствует части имени хоста URL.
	id integer			успех	Уникальный идентификатор ресурса.
	name string			успех	Имя ресурса. Предоставляется клиентом при создании ресурса. Имя должно быть длиной от 1 до 63 символов и соответствовать RFC1035. То есть, имя должно быть длиной от 1 до 63 символов и соответствовать регулярному выражению `[a-z]([-a-z0-9]*[a-z0-9])?`, что означает, что первый символ должен быть строчной буквой, а все последующие символы — дефисом, строчной буквой или цифрой, за исключением последнего символа, который не может быть дефисом.
	pathMatchers complex			успех	Список именованных PathMatchers для использования с URL.
		defaultService dictionary		успех	Ссылка на ресурс BackendService. Будет использоваться, если ни одно из правил pathRules, определённых этим PathMatcher, не соответствует части пути URL.
		description string		успех	Необязательное описание этого ресурса.
		name string		успех	Имя, к которому этот PathMatcher ссылается по HostRule.
		pathRules complex		успех	Список правил пути.
			paths list	успех	Список шаблонов путей для сопоставления. Каждый должен начинаться с /, и единственное место, где разрешено использовать *, — это конец, за которым следует /. Строка, передаваемая в path matcher, не включает текст после первого ? или #, и эти символы здесь запрещены.
			service dictionary	успех	Ссылка на ресурс BackendService, если правило совпадает.
	tests complex			успех	Список ожидаемых сопоставлений URL. Запросы на обновление UrlMap будут успешны только в том случае, если пройдут все тестовые сценарии.
		description string		успех	Описание этого тестового сценария.
		host string		успех	Часть хоста URL.
		path string		успех	Часть пути URL.
		service dictionary		успех	Ссылка на ожидаемый ресурс BackendService, к которому должен быть сопоставлен данный URL.

Статус

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