google.cloud.gcp_filestore_instance – Создаёт экземпляр GCP Filestore

Примечание

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

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

Для использования в книге задач укажите: google.cloud.gcp_filestore_instance.

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

Описание

Экземпляр Google Cloud Filestore.

Требования

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

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
auth_kind строка / обязательно		Варианты: application machineaccount serviceaccount	Тип используемых учетных данных.
description строка			Описание экземпляра.
env_type строка			Указывает, в какой среде Ansible выполняется этот модуль. Не следует устанавливать, если вы не знаете, что делаете. Это только изменяет строку User Agent для всех запросов API.
file_shares список / элементы=словарь / обязательно			Файловые системы на экземпляре. В этой версии поддерживается только одна файловая система.
	capacity_gb целое число / обязательно		Ёмкость файловой системы в ГиБ. Для стандартного уровня она должна быть не менее 1024 ГиБ, а для премиум-уровня — не менее 2560 ГиБ.
	name строка / обязательно		Имя файловой системы (максимум 16 символов).
labels словарь			Метки ресурсов для представления пользовательских метаданных.
name строка / обязательно			Имя ресурса экземпляра.
networks список / элементы=словарь / обязательно			Сети VPC, к которым подключен экземпляр. В этой версии поддерживается только одна сеть.
	modes список / элементы=строка / обязательно		Версии IP, для которых экземпляру назначены IP-адреса.
	network строка / обязательно		Имя сети GCE VPC, к которой подключен экземпляр.
	reserved_ip_range строка		CIDR-блок /29, определяющий диапазон IP-адресов, зарезервированных для этого экземпляра.
project строка			Проект Google Cloud Platform, который нужно использовать.
scopes список / элементы=строка			Массив используемых областей видимости.
service_account_contents jsonarg			Содержимое файла JSON учетной записи службы, либо в виде словаря, либо как строка JSON, представляющая его.
service_account_email строка			Дополнительно, адрес электронной почты учетной записи службы, если выбран machineaccount, и пользователь не хочет использовать адрес по умолчанию.
service_account_file путь			Путь к файлу JSON учетной записи службы, если тип выбран как serviceaccount.
state строка		Варианты: present ← absent	Требуется ли наличие данного объекта в GCP
tier строка / обязательно			Уровень обслуживания экземпляра. Некоторые допустимые значения: "TIER_UNSPECIFIED", "STANDARD", "PREMIUM", "BASIC_HDD", "BASIC_SSD", "HIGH_SCALE_SSD"
zone строка / обязательно			Название зоны Filestore экземпляра.

Примечания

Примечание

Справочник по API: https://cloud.google.com/filestore/docs/reference/rest/v1beta1/projects.locations.instances/create
Официальная документация: https://cloud.google.com/filestore/docs/creating-instances
Использование с Kubernetes: https://cloud.google.com/filestore/docs/accessing-fileshares
Копирование данных В/Из: https://cloud.google.com/filestore/docs/copying-data
Для аутентификации можно установить 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: create a instance
  google.cloud.gcp_filestore_instance:
    name: test_object
    zone: us-central1-b
    tier: PREMIUM
    file_shares:
    - capacity_gb: 2660
      name: share1
    networks:
    - network: default
      modes:
      - MODE_IPV4
    project: test_project
    auth_kind: serviceaccount
    service_account_file: "/tmp/auth.pem"
    state: present

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

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

Ключ		Возвращаемое значение	Описание
createTime строка		успех	Маркер времени создания в формате RFC3339.
description строка		успех	Описание экземпляра.
etag строка		успех	Установленный сервером ETag для ресурса экземпляра, чтобы предотвратить одновременные обновления, которые могут перезаписывать друг друга.
fileShares сложный		успех	Файловые системы на экземпляре. В этой версии поддерживается только одна файловая система.
	capacityGb целое число	успех	Ёмкость файловой системы в ГиБ. Для стандартного уровня она должна быть не менее 1024 ГиБ, а для премиум-уровня — не менее 2560 ГиБ.
	name строка	успех	Имя файловой системы (максимум 16 символов).
labels словарь		успех	Метки ресурсов для представления пользовательских метаданных.
name строка		успех	Имя ресурса экземпляра.
networks сложный		успех	Сети VPC, к которым подключен экземпляр. В этой версии поддерживается только одна сеть.
	ipAddresses список / элементы=строка	успех	Список IP-адресов IPv4 или IPv6.
	modes список / элементы=строка	успех	Версии IP, для которых экземпляру назначены IP-адреса.
	network строка	успех	Имя сети GCE VPC, к которой подключен экземпляр.
	reservedIpRange строка	успех	CIDR-блок /29, определяющий диапазон IP-адресов, зарезервированных для этого экземпляра.
tier строка		успех	Уровень обслуживания экземпляра.
zone строка		успех	Название зоны Filestore экземпляра.

Авторы

Google Inc. (@googlecloudplatform)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/google/cloud/gcp_filestore_instance_module.html