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

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

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

Описание

Экземпляр 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 целое число / обязательно		Ёмкость файловой доли в ГБ.
	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"
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 используя переменную среды 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.
Значения переменных среды будут использоваться только в том случае, если значения в playbook не заданы.
Параметры service_account_email и service_account_file взаимоисключающие.

Примеры

- name: create a instance
  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 целое число	успешно	Ёмкость файлового общего ресурса в ГБ.
	name строка	успешно	Имя файлового общего ресурса (не более 16 символов).
labels словарь		успешно	Метки ресурсов для представления пользовательских метаданных.
name строка		успешно	Имя ресурса экземпляра.
networks сложный тип		успешно	Сети VPC, к которым подключен экземпляр. В этой версии поддерживается только одна сеть.
	ipAddresses список	успешно	Список адресов IPv4 или IPv6.
	modes список	успешно	Версии IP, для которых экземпляру назначены IP-адреса.
	network строка	успешно	Имя сети GCE VPC, к которой подключен экземпляр.
	reservedIpRange строка	успешно	CIDR-блок /29, который идентифицирует диапазон IP-адресов, зарезервированных для этого экземпляра.
tier строка		успешно	Уровень сервиса экземпляра.
zone строка		успешно	Название зоны Filestore экземпляра.

Статус

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