google.cloud.gcp_redis_instance_info – Сбор информации о виртуальной машине GCP

Примечание

Этот плагин входит в состав коллекции google.cloud (версия 1.0.1).

Для его установки используйте: ansible-galaxy collection install google.cloud.

Чтобы использовать его в книге задач, укажите: google.cloud.gcp_redis_instance_info.

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

Обзор

Сбор информации о виртуальной машине GCP

Требования

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

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
auth_kind строка / обязательно	application machineaccount serviceaccount	Тип используемых учетных данных.
env_type строка		Указывает среду Ansible, в которой выполняется данный модуль. Следует задавать только в случае необходимости. Изменяет только строку User Agent для всех запросов к API.
project строка		Используемый проект Google Cloud Platform.
region строка / обязательно		Имя региона Redis для экземпляра.
scopes список / элементы=строка		Массив используемых областей.
service_account_contents jsonarg		Содержание файла JSON учетной записи службы, либо в виде словаря, либо как строка JSON, представляющая его.
service_account_email строка		Дополнительный адрес электронной почты учетной записи службы, если выбран machineaccount и пользователь не хочет использовать адрес по умолчанию.
service_account_file путь		Путь к файлу JSON учетной записи службы, если в качестве типа выбрано serviceaccount.

Примечания

Примечание

для аутентификации можно установить service_account_file, используя переменную среды gcp_service_account_file.
для аутентификации можно установить service_account_contents, используя переменную среды 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 instance
  gcp_redis_instance_info:
    region: us-central1
    project: test_project
    auth_kind: serviceaccount
    service_account_file: "/tmp/auth.pem"

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

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

Ключ		Возвращаемое значение	Описание
resources сложный		всегда	Список ресурсов
	alternativeLocationId строка	успех	Применимо только для уровня STANDARD_HA, который защищает экземпляр от сбоев в зоне, предоставляя его в двух зонах. Если указано, оно должно отличаться от зоны, указанной в [locationId].
	authorizedNetwork строка	успех	Полное имя сети Google Compute Engine, к которой подключен экземпляр. Если не указано, будет использоваться сеть по умолчанию.
	connectMode строка	успех	Режим подключения экземпляра Redis.
	createTime строка	успех	Время создания экземпляра в формате RFC3339 UTC "Zulu", с точностью до наносекунд.
	currentLocationId строка	успех	Текущая зона размещения конечной точки Redis. Для экземпляров Basic Tier всегда совпадает с [locationId], указанным пользователем при создании. Для экземпляров Standard Tier может быть либо [locationId], либо [alternativeLocationId], и может измениться после события отката.
	displayName строка	успех	Произвольное и необязательное имя, заданное пользователем для экземпляра.
	host строка	успех	Имя хоста или IP-адрес экспонированной конечной точки Redis, используемой клиентами для подключения к службе.
	labels словарь	успех	Метки ресурсов для представления данных, предоставленных пользователем.
	locationId строка	успех	Зона, в которой будет развернут экземпляр. Если не указано, служба выберет зону для экземпляра. Для уровня STANDARD_HA экземпляры будут создаваться в двух зонах для защиты от сбоев в зоне. Если также указан [alternativeLocationId], он должен отличаться от [locationId].
	memorySizeGb целое число	успех	Размер памяти Redis в GiB.
	name строка	успех	Идентификатор экземпляра или полное квалифицированное имя экземпляра.
	persistenceIamIdentity строка	успех	Только для вывода. Идентификатор Cloud IAM, используемый операциями импорта/экспорта для передачи данных в/из Cloud Storage. Формат — "serviceAccount:". Значение может меняться со временем для данного экземпляра, поэтому его следует проверять перед каждой операцией импорта/экспорта.
	port целое число	успех	Номер порта экспонированной конечной точки Redis.
	redisConfigs словарь	успех	Параметры конфигурации Redis в соответствии с http://redis.io/topics/config. Пожалуйста, обратитесь к документации Memorystore за списком поддерживаемых параметров: https://cloud.google.com/memorystore/docs/redis/reference/rest/v1/projects.locations.instances#Instance.FIELDS.redis_configs.
	redisVersion строка	успех	Версия программного обеспечения Redis. Если не указано, будет использована последняя поддерживаемая версия. В настоящее время поддерживаются следующие значения: - REDIS_5_0 для совместимости с Redis 5.0 - REDIS_4_0 для совместимости с Redis 4.0 - REDIS_3_2 для совместимости с Redis 3.2.
	region строка	успех	Имя региона Redis для экземпляра.
	reservedIpRange строка	успех	Диапазон CIDR внутренних адресов, зарезервированных для этого экземпляра. Если не указано, служба выберет незанятый блок /29, например, 10.0.0.0/29 или 192.168.0.0/29. Диапазоны должны быть уникальными и не пересекаться с существующими подсетями в авторизованной сети.
	tier строка	успех	Уровень сервиса экземпляра. Должно быть одно из следующих значений: - BASIC: автономный экземпляр - STANDARD_HA: высокодоступные первичные/реплицированные экземпляры.

Авторы

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.10/collections/google/cloud/gcp_redis_instance_info_module.html