модуль google.cloud.gcp_compute_instance_template — создание шаблона экземпляра GCP
Примечание
Этот модуль входит в коллекцию google.cloud (версия 1.13.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install google.cloud. Для использования этого модуля требуются дополнительные компоненты. Подробнее см. в разделе Требования.
Чтобы использовать его в плейбуке, укажите: google.cloud.gcp_compute_instance_template.
Краткое описание
- Определяет ресурс шаблона экземпляра, содержащий параметры конфигурации для ваших экземпляров виртуальных машин. Шаблоны экземпляров не привязаны к сроку жизни экземпляра и могут использоваться повторно для развёртывания виртуальных машин. Вы также можете использовать разные шаблоны для создания виртуальных машин с разными конфигурациями. Шаблоны экземпляров необходимы при создании управляемой группы экземпляров.
- Совет: для дисков следует установить autoDelete=true, чтобы после удаления машины не оставались неиспользуемые диски.
Требования
Следующие компоненты должны быть установлены на хосте, на котором выполняется этот модуль.
- python >= 2.6
- requests >= 2.18.4
- google-auth >= 1.3.0
Параметры
Параметр | Комментарии |
|---|---|
access_token string | Токен доступа OAuth2, если тип учетных данных — accesstoken. |
auth_kind string / обязательный | Тип используемых учетных данных. Варианты:
|
description string | Необязательное описание этого ресурса. Укажите это свойство при создании ресурса. |
env_type string | Указывает среду Ansible, в которой выполняется этот модуль. Не задавайте это значение, если не уверены в том, что делаете. Это влияет только на строку User Agent для всех запросов API. |
name string / обязательный | Имя ресурса. Длина имени составляет от 1 до 63 символов; оно должно соответствовать RFC1035. |
project string | Проект Google Cloud Platform, который следует использовать. |
properties dictionary | Свойства экземпляра для этого шаблона экземпляра. |
|
can_ip_forward boolean |
Разрешает экземплярам, созданным на основе этого шаблона, отправлять пакеты с исходными IP-адресами, отличными от их собственных, и получать пакеты с IP-адресами назначения, отличными от их собственных. Укажите true, если эти экземпляры будут использоваться в качестве IP-шлюза или задаваться как следующий узел в ресурсе Route. Если вы не уверены, оставьте значение false. Варианты:
|
|
description string |
Необязательное текстовое описание экземпляров, созданных на основе этого шаблона экземпляра. |
|
disks list / elements=dictionary |
Массив дисков, связанных с экземплярами, созданными на основе этого шаблона. |
|
auto_delete boolean |
Указывает, следует ли автоматически удалять диск при удалении экземпляра (но не при отключении диска от экземпляра). Совет: для дисков следует задать autoDelete=true, чтобы после удаления машины не оставались неиспользуемые диски. Варианты:
|
|
boot boolean |
Указывает, что это загрузочный диск. Виртуальная машина будет использовать первый раздел диска для корневой файловой системы. Варианты:
|
|
device_name string |
Задает уникальное имя устройства по вашему выбору, которое отображается в дереве /dev/disk/by-id/google-* операционной системы Linux, работающей в экземпляре. Это имя можно использовать внутри экземпляра для обращения к устройству, например, при монтировании или изменении размера. |
|
disk_encryption_key dictionary |
Шифрует или расшифровывает диск с помощью предоставленного клиентом ключа шифрования. |
|
raw_key string |
Задает предоставленный клиентом ключ шифрования длиной 256 бит, закодированный в base64 согласно RFC 4648, для шифрования или расшифровки этого ресурса. |
|
rsa_encrypted_key string |
Задает предоставленный клиентом ключ шифрования RSA длиной 2048 бит, обернутый и закодированный в base64 согласно RFC 4648, для шифрования или расшифровки этого ресурса. |
|
index integer |
Назначает этому диску индекс, начинающийся с нуля; значение 0 зарезервировано для загрузочного диска. Например, если к экземпляру подключено несколько дисков, у каждого диска будет уникальный номер индекса. Если значение не задано, сервер выберет подходящее. |
|
initialize_params dictionary |
Задает параметры нового диска, который будет создан вместе с новым экземпляром. Используйте параметры инициализации для создания загрузочных дисков или локальных SSD, подключаемых к новому экземпляру. |
|
disk_name string |
Задает имя диска. Если оно не указано, по умолчанию используется имя экземпляра. |
|
disk_size_gb integer |
Задает размер диска в ГБ по основанию 2. |
|
disk_type string |
Ссылка на тип диска. Задает тип диска, используемого для создания экземпляра. Если значение не указано, по умолчанию используется pd-standard. |
|
source_image string |
Исходный образ для создания этого диска. При создании нового экземпляра необходимо указать initializeParams.sourceImage или disks.source. Чтобы создать диск с одним из общедоступных образов операционных систем, укажите образ по имени семейства. |
|
source_image_encryption_key dictionary |
Предоставленный клиентом ключ шифрования исходного образа. Обязателен, если исходный образ защищен ключом шифрования, предоставленным клиентом. Шаблоны экземпляров не хранят ключи шифрования, предоставленные клиентом, поэтому нельзя создавать диски для экземпляров в управляемой группе экземпляров, если исходные образы зашифрованы вашими ключами. |
|
raw_key string |
Задает предоставленный клиентом ключ шифрования длиной 256 бит, закодированный в base64 согласно RFC 4648, для шифрования или расшифровки этого ресурса. |
|
interface string |
Задает интерфейс для подключения этого диска: SCSI или NVME. По умолчанию используется SCSI. Для постоянных дисков всегда необходимо использовать SCSI. Запрос завершится ошибкой, если попытаться подключить постоянный диск в формате, отличном от SCSI. Допустимые варианты: “SCSI”, “NVME” |
|
mode string |
Режим подключения диска: READ_WRITE или READ_ONLY. Если значение не указано, по умолчанию диск подключается в режиме READ_WRITE. Допустимые варианты: “READ_WRITE”, “READ_ONLY” |
|
source dictionary |
Ссылка на диск. При создании нового экземпляра необходимо указать initializeParams.sourceImage или disks.source. При необходимости с помощью этого свойства можно также подключить существующие постоянные диски, не являющиеся корневыми. Это поле применимо только к постоянным дискам. Для InstanceTemplate укажите имя диска, а не его URL. Это поле представляет ссылку на ресурс Disk в GCP. Его можно задать двумя способами. Во-первых, можно указать словарь с ключом ‘name’ и значением, равным имени ресурса. Также можно добавить `register: name-of-resource` в задачу gcp_compute_disk, а затем задать для этого поля source значение “{{ name-of-resource }}” |
|
type string |
Задает тип диска: SCRATCH или PERSISTENT. Если значение не указано, по умолчанию используется PERSISTENT. Допустимые варианты: “SCRATCH”, “PERSISTENT” |
|
guest_accelerators list / elements=dictionary |
Список типов и количества ускорительных карт, подключенных к экземпляру. |
|
accelerator_count integer |
Количество ускорительных карт, доступных этому экземпляру. |
|
accelerator_type string |
Полный или частичный URL ресурса типа ускорителя, который будет доступен этому экземпляру. |
|
labels dictionary |
Метки, применяемые к этому адресу. Список пар ключ->значение. |
|
machine_type string / обязательный |
Тип машины, используемый в шаблоне экземпляра виртуальной машины. |
|
metadata dictionary |
Пары ключ/значение метаданных, назначаемые экземплярам, созданным на основе этого шаблона. Эти пары могут содержать пользовательские метаданные или предопределенные ключи. |
|
min_cpu_platform string |
Задает минимальную платформу ЦП для экземпляра виртуальной машины. Допустимые значения — понятные названия платформ ЦП. |
|
network_interfaces list / elements=dictionary |
Массив конфигураций этого интерфейса. Задает способ взаимодействия интерфейса с другими сетевыми службами, например подключение к Интернету. Для каждого экземпляра поддерживается только один сетевой интерфейс. |
|
access_configs list / elements=dictionary |
Массив конфигураций этого интерфейса. В настоящее время поддерживается только одна конфигурация доступа — ONE_TO_ONE_NAT. Если accessConfigs не указаны, у экземпляра не будет внешнего доступа к Интернету. |
|
name string / обязательный |
Имя этой конфигурации доступа. По умолчанию рекомендуется использовать имя External NAT, однако можно указать любую произвольную строку. Например: My external IP или Network Access. |
|
nat_ip dictionary | Ссылка на адрес. Внешний IP-адрес, связанный с этим экземпляром. Укажите неиспользуемый статический внешний IP-адрес, доступный проекту, или оставьте это поле незаполненным, чтобы использовать IP-адрес из общего пула эфемерных IP-адресов. Если вы укажете статический внешний IP-адрес, он должен находиться в том же регионе, что и зона экземпляра. Это поле представляет ссылку на ресурс Address в GCP. Его можно задать двумя способами. Во-первых, можно указать словарь с ключом ‘address’ и значением, равным адресу ресурса. Также можно добавить `register: name-of-resource` в задачу gcp_compute_address, а затем задать для этого поля nat_ip значение “{{ name-of-resource }}” |
|
network_tier string |
Уровень сети, используемый для настройки этой конфигурации доступа. Если указана AccessConfig без допустимого внешнего IP-адреса, будет создан эфемерный IP-адрес с этим значением networkTier. Если указана AccessConfig с допустимым внешним IP-адресом, он должен соответствовать networkTier, связанному с ресурсом Address, которому принадлежит этот IP-адрес. Допустимые варианты: “PREMIUM”, “STANDARD” |
|
public_ptr_domain_name string |
Доменное имя DNS для общедоступной PTR-записи. Это поле можно задать, только если включено поле setPublicPtr. |
|
set_public_ptr boolean |
Указывает, следует ли создать общедоступную DNS PTR-запись, связывающую внешний IP-адрес экземпляра с доменным именем DNS. Варианты:
|
|
type string / обязательный |
Тип конфигурации. По умолчанию доступен только вариант ONE_TO_ONE_NAT. Допустимый вариант: “ONE_TO_ONE_NAT” |
|
alias_ip_ranges list / elements=dictionary |
Массив диапазонов псевдонимных IP-адресов для этого сетевого интерфейса. Указывается только для сетевых интерфейсов в сетях с режимом подсетей. |
|
ip_cidr_range string |
Диапазон IP CIDR, представленный этим диапазоном псевдонимных IP-адресов. Этот диапазон IP CIDR должен принадлежать указанной подсети и не может содержать IP-адреса, зарезервированные системой или используемые другими сетевыми интерфейсами. Диапазон может представлять собой один IP-адрес (например, 10.2.3.4), маску подсети (например, /24) или строку в формате CIDR (например, 10.1.2.0/24). |
|
subnetwork_range_name string |
Необязательное имя дополнительного диапазона подсети, из которого выделяется диапазон IP CIDR для этого диапазона псевдонимных IP-адресов. Если значение не указано, будет использоваться основной диапазон подсети. |
|
network dictionary |
Указывает название существующей сети. При создании экземпляра, если не указаны ни сеть, ни подсеть, используется сеть по умолчанию global/networks/default; если сеть не указана, но задана подсеть, сеть определяется автоматически. Это поле представляет ссылку на ресурс Network в GCP. Его можно задать двумя способами. Во-первых, можно указать словарь с ключом ‘selfLink’ и значением selfLink ресурса. Также можно добавить `register: name-of-resource` в задачу gcp_compute_network, а затем задать для этого поля network значение “{{ name-of-resource }}” |
|
network_ip string |
Внутренний сетевой адрес IPv4, назначаемый экземпляру для этого сетевого интерфейса. Если пользователь не указал адрес, система назначит неиспользуемый внутренний IP-адрес. |
|
subnetwork dictionary |
Ссылка на сеть VPC. Если сетевой ресурс работает в устаревшем режиме, не указывайте это свойство. Если сеть работает в режиме автоматических подсетей, указывать подсеть необязательно. Если сеть работает в режиме пользовательских подсетей, это поле необходимо задать. Это поле представляет ссылку на ресурс Subnetwork в GCP. Его можно задать двумя способами. Во-первых, можно указать словарь с ключом ‘selfLink’ и значением selfLink ресурса. Также можно добавить `register: name-of-resource` в задачу gcp_compute_subnetwork, а затем задать для этого поля subnetwork значение “{{ name-of-resource }}” |
|
scheduling dictionary |
Задает параметры планирования для этого экземпляра. |
|
automatic_restart boolean |
Указывает, следует ли автоматически перезапускать экземпляр, если он был остановлен Compute Engine (а не пользователем). Параметр автоматического перезапуска можно задать только для стандартных экземпляров. Прерываемые экземпляры нельзя перезапускать автоматически. Варианты:
|
|
on_host_maintenance string |
Определяет поведение этого экземпляра во время обслуживания. Для стандартных экземпляров поведение по умолчанию — MIGRATE. Для прерываемых экземпляров поведение по умолчанию, а также единственный возможный вариант — TERMINATE. Дополнительную информацию см. в разделе «Настройка параметров планирования экземпляров». |
|
preemptible boolean |
Определяет, является ли экземпляр прерываемым. Это значение можно задать только при создании экземпляра; задать или изменить его после создания экземпляра нельзя. Варианты:
|
|
service_accounts list / elements=dictionary |
Список учетных записей служб с указанными для них областями действия, которым разрешен доступ к этому экземпляру. Для одного экземпляра виртуальной машины поддерживается только одна учетная запись службы. |
|
string |
|
|
scopes list / elements=string |
Список областей действия, доступных для этой учетной записи службы. |
|
tags dictionary |
Список тегов, применяемых к этому экземпляру. Теги используются для определения допустимых источников или целей сетевых брандмауэров и задаются клиентом при создании экземпляра. Позже теги можно изменить с помощью метода setTags. Каждый тег в списке должен соответствовать RFC1035. |
|
fingerprint string |
Указывает отпечаток для этого запроса — по сути, хеш содержимого метаданных, используемый для оптимистической блокировки. Отпечаток изначально создается Compute Engine и изменяется после каждого запроса на изменение или обновление метаданных. Для обновления или изменения метаданных необходимо всегда указывать актуальный хеш отпечатка. |
|
items list / elements=string |
Устарело. Используйте tag_values. |
|
tag_values list / elements=string |
Массив тегов. Длина каждого тега должна составлять от 1 до 63 символов; он должен соответствовать RFC1035. |
scopes list / elements=string | Массив используемых областей действия |
service_account_contents jsonarg | Содержимое JSON-файла учетной записи службы в виде словаря или JSON-строки, представляющей его. |
service_account_email string | Необязательный адрес электронной почты учетной записи службы, если выбран machineaccount и пользователь не хочет использовать адрес по умолчанию. |
service_account_file path | Путь к JSON-файлу учетной записи службы, если в качестве типа выбрано serviceaccount. |
state string | Определяет, должен ли указанный объект существовать в GCP Варианты:
|
Примеры
- name: create a network
google.cloud.gcp_compute_network:
name: network-instancetemplate
project: "{{ gcp_project }}"
auth_kind: "{{ gcp_cred_kind }}"
service_account_file: "{{ gcp_cred_file }}"
state: present
register: network
- name: create a address
google.cloud.gcp_compute_address:
name: address-instancetemplate
region: us-west1
project: "{{ gcp_project }}"
auth_kind: "{{ gcp_cred_kind }}"
service_account_file: "{{ gcp_cred_file }}"
state: present
register: address
- name: create a instance template
google.cloud.gcp_compute_instance_template:
name: test_object
properties:
disks:
- auto_delete: 'true'
boot: 'true'
initialize_params:
source_image: projects/ubuntu-os-cloud/global/images/family/ubuntu-1604-lts
machine_type: n1-standard-1
network_interfaces:
- network: "{{ network }}"
access_configs:
- name: test-config
type: ONE_TO_ONE_NAT
nat_ip: "{{ address }}"
project: test_project
auth_kind: serviceaccount
service_account_file: "/tmp/auth.pem"
state: present
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
creationTimestamp string | Временная метка создания в текстовом формате RFC3339. Возвращается: при успешном выполнении |
description string | Необязательное описание этого ресурса. Укажите это свойство при создании ресурса. Возвращается: при успешном выполнении |
id integer | Уникальный идентификатор ресурса. Этот идентификатор назначается сервером. Возвращается: при успешном выполнении |
name string | Имя ресурса. Имя должно содержать от 1 до 63 символов и соответствовать RFC1035. Возвращается: при успешном выполнении |
properties complex | Свойства экземпляра для этого шаблона экземпляра. Возвращается: при успешном выполнении |
|
canIpForward boolean |
Разрешает экземплярам, созданным на основе этого шаблона, отправлять пакеты с IP-адресами источника, отличными от их собственных, и получать пакеты с IP-адресами назначения, отличными от их собственных. Если эти экземпляры будут использоваться в качестве IP-шлюза или указываться как следующий переход в ресурсе Route, задайте значение true. Если вы не уверены, оставьте значение false. Возвращается: при успешном выполнении |
|
description string |
Необязательное текстовое описание экземпляров, создаваемых на основе этого шаблона экземпляра. Возвращается: при успешном выполнении |
|
disks complex |
Массив дисков, связанных с экземплярами, создаваемыми на основе этого шаблона. Возвращается: при успешном выполнении |
|
autoDelete boolean |
Указывает, следует ли автоматически удалять диск при удалении экземпляра (но не при отключении диска от экземпляра). Совет: для дисков следует задавать autoDelete=true, чтобы после удаления машины не оставались неиспользуемые диски. Возвращается: при успешном выполнении |
|
boot boolean |
Указывает, что это загрузочный диск. Виртуальная машина будет использовать первый раздел диска для корневой файловой системы. Возвращается: при успешном выполнении |
|
deviceName string |
Задает выбранное вами уникальное имя устройства, которое отображается в дереве /dev/disk/by-id/google-* операционной системы Linux, работающей внутри экземпляра. Это имя можно использовать внутри экземпляра для обращения к устройству при его подключении, изменении размера и выполнении других операций. Возвращается: при успешном выполнении |
|
diskEncryptionKey complex |
Шифрует или расшифровывает диск с помощью предоставленного клиентом ключа шифрования. Возвращается: при успешном выполнении |
|
rawKey string |
Задает предоставленный клиентом ключ шифрования длиной 256 бит в кодировке base64 по RFC 4648 для шифрования или расшифровки этого ресурса. Возвращается: при успешном выполнении |
|
rsaEncryptedKey string |
Задает предоставленный клиентом ключ шифрования длиной 2048 бит, обернутый с помощью RSA и закодированный в base64 по RFC 4648, для шифрования или расшифровки этого ресурса. Возвращается: при успешном выполнении |
|
sha256 string |
Хеш SHA-256 предоставленного клиентом ключа шифрования, защищающего этот ресурс, закодированный в base64 по RFC 4648. Возвращается: при успешном выполнении |
|
index integer |
Назначает этому диску индекс, начинающийся с нуля; значение 0 зарезервировано для загрузочного диска. Например, если к экземпляру подключено несколько дисков, у каждого диска будет уникальный индекс. Если значение не указано, сервер выберет подходящее значение. Возвращается: при успешном выполнении |
|
initializeParams complex |
Задает параметры нового диска, который будет создан вместе с новым экземпляром. Используйте параметры инициализации для создания загрузочных дисков или локальных SSD, подключаемых к новому экземпляру. Возвращается: при успешном выполнении |
|
diskName string |
Задает имя диска. Если значение не указано, по умолчанию используется имя экземпляра. Возвращается: при успешном выполнении |
|
diskSizeGb integer |
Задает размер диска в ГБ по основанию 2. Возвращается: при успешном выполнении |
|
diskType string |
Ссылка на тип диска. Задает тип диска, используемого для создания экземпляра. Если значение не указано, по умолчанию используется pd-standard. Возвращается: при успешном выполнении |
|
sourceImage string |
Исходный образ для создания этого диска. При создании нового экземпляра требуется указать либо initializeParams.sourceImage, либо disks.source. Чтобы создать диск с одним из общедоступных образов операционных систем, укажите образ по имени его семейства. Возвращается: при успешном выполнении |
|
sourceImageEncryptionKey complex |
Предоставленный клиентом ключ шифрования исходного образа. Обязателен, если исходный образ защищен предоставленным клиентом ключом шифрования. Шаблоны экземпляров не хранят предоставленные клиентом ключи шифрования, поэтому нельзя создавать диски для экземпляров в управляемой группе экземпляров, если исходные образы зашифрованы собственными ключами. Возвращается: при успешном выполнении |
|
rawKey string |
Задает предоставленный клиентом ключ шифрования длиной 256 бит в кодировке base64 по RFC 4648 для шифрования или расшифровки этого ресурса. Возвращается: при успешном выполнении |
|
sha256 string |
Хеш SHA-256 предоставленного клиентом ключа шифрования, защищающего этот ресурс, закодированный в base64 по RFC 4648. Возвращается: при успешном выполнении |
|
interface string |
Задает интерфейс для подключения этого диска: SCSI или NVME. По умолчанию используется SCSI. Для постоянных дисков всегда необходимо использовать SCSI. Запрос завершится ошибкой, если попытаться подключить постоянный диск в формате, отличном от SCSI. Возвращается: при успешном выполнении |
|
licenses list / elements=string |
URI применимой лицензии. Возвращается: при успешном выполнении |
|
mode string |
Режим подключения диска: READ_WRITE или READ_ONLY. Если значение не указано, по умолчанию диск подключается в режиме READ_WRITE. Возвращается: при успешном выполнении |
|
source dictionary |
Ссылка на диск. При создании нового экземпляра требуется указать либо initializeParams.sourceImage, либо disks.source. При необходимости с помощью этого свойства также можно подключать существующие постоянные диски, не являющиеся корневыми. Это поле применимо только к постоянным дискам. Обратите внимание: для InstanceTemplate укажите имя диска, а не его URL. Возвращается: при успешном выполнении |
|
type string |
Задает тип диска: SCRATCH или PERSISTENT. Если значение не указано, по умолчанию используется PERSISTENT. Возвращается: при успешном выполнении |
|
guestAccelerators complex |
Список типов и количества ускорительных карт, подключенных к экземпляру. Возвращается: при успешном выполнении |
|
acceleratorCount integer |
Количество ускорительных карт, доступных этому экземпляру. Возвращается: при успешном выполнении |
|
acceleratorType string |
Полный или частичный URL ресурса типа ускорителя, который будет доступен этому экземпляру. Возвращается: при успешном выполнении |
|
labels dictionary |
Метки, применяемые к этому адресу. Список пар ключ->значение. Возвращается: при успешном выполнении |
|
machineType string |
Тип машины, используемый в шаблоне экземпляра виртуальной машины. Возвращается: при успешном выполнении |
|
metadata dictionary |
Пары ключ/значение метаданных, назначаемые экземплярам, созданным на основе этого шаблона. Эти пары могут содержать пользовательские метаданные или предопределенные ключи. Возвращается: при успешном выполнении |
|
minCpuPlatform string |
Задает минимальную платформу ЦП для экземпляра виртуальной машины. Допустимые значения — общепринятые названия платформ ЦП. Возвращается: при успешном выполнении |
|
networkInterfaces complex |
Массив конфигураций этого интерфейса. Определяет, как интерфейс взаимодействует с другими сетевыми службами, например подключается к интернету. Для одного экземпляра поддерживается только один сетевой интерфейс. Возвращается: при успешном выполнении |
|
accessConfigs complex |
Массив конфигураций этого интерфейса. В настоящее время поддерживается только одна конфигурация доступа — ONE_TO_ONE_NAT. Если accessConfigs не указаны, у этого экземпляра не будет внешнего доступа к интернету. Возвращается: при успешном выполнении |
|
name string |
Имя этой конфигурации доступа. По умолчанию и согласно рекомендациям используется External NAT, но можно указать любую строку. Например, My external IP или Network Access. Возвращается: при успешном выполнении |
|
natIP dictionary |
Ссылка на адрес. Внешний IP-адрес, связанный с этим экземпляром. Укажите неиспользуемый статический внешний IP-адрес, доступный проекту, или оставьте это поле незаданным, чтобы использовать IP-адрес из общего пула эфемерных IP-адресов. Если указан статический внешний IP-адрес, он должен находиться в том же регионе, что и зона экземпляра. Возвращается: при успешном выполнении |
|
networkTier string |
Указывает уровень сети, используемый при настройке этой конфигурации доступа. Если задан AccessConfig без допустимого внешнего IP-адреса, будет создан эфемерный IP-адрес с этим значением networkTier. Если для AccessConfig указан допустимый внешний IP-адрес, его уровень должен совпадать с networkTier ресурса Address, которому принадлежит этот IP-адрес. Возвращается: при успешном выполнении |
|
publicPtrDomainName string |
Доменное имя DNS для общедоступной PTR-записи. Это поле можно задать, только если включено поле setPublicPtr. Возвращается: при успешном выполнении |
|
setPublicPtr boolean |
Указывает, следует ли создать общедоступную DNS PTR-запись для сопоставления внешнего IP-адреса экземпляра с доменным именем DNS. Возвращается: при успешном выполнении |
|
type string |
Тип конфигурации. По умолчанию и в качестве единственного варианта используется ONE_TO_ONE_NAT. Возвращается: при успешном выполнении |
|
aliasIpRanges complex |
Массив диапазонов псевдонимных IP-адресов для этого сетевого интерфейса. Можно указать только для сетевых интерфейсов в сетях с режимом подсетей. Возвращается: при успешном выполнении |
|
ipCidrRange string |
Диапазон IP CIDR, представленный этим диапазоном псевдонимных IP-адресов. Этот диапазон IP CIDR должен принадлежать указанной подсети и не может содержать IP-адреса, зарезервированные системой или используемые другими сетевыми интерфейсами. Диапазон может представлять собой один IP-адрес (например, 10.2.3.4), маску сети (например, /24) или строку в формате CIDR (например, 10.1.2.0/24). Возвращается: при успешном выполнении |
|
subnetworkRangeName string |
Необязательное имя вторичного диапазона подсети, указывающее, из какого вторичного диапазона выделяется диапазон IP CIDR для этого диапазона псевдонимных IP-адресов. Если значение не задано, будет использоваться основной диапазон подсети. Возвращается: при успешном выполнении |
|
name string |
Имя сетевого интерфейса, назначаемое сервером. Для сетевых устройств используются имена eth0, eth1 и т. д. Возвращается: при успешном выполнении |
|
network dictionary |
Указывает имя существующей сети. При создании экземпляра, если не указаны ни сеть, ни подсеть, используется сеть по умолчанию global/networks/default; если сеть не указана, но указана подсеть, сеть определяется автоматически. Возвращается: при успешном выполнении |
|
networkIP string |
Внутренний сетевой адрес IPv4, назначаемый экземпляру для этого сетевого интерфейса. Если пользователь не указал адрес, система назначает неиспользуемый внутренний IP-адрес. Возвращается: при успешном выполнении |
|
subnetwork dictionary |
Ссылка на сеть VPC. Если ресурс сети работает в устаревшем режиме, не указывайте это свойство. Если сеть работает в режиме автоматического создания подсетей, указывать подсеть необязательно. Если сеть работает в режиме пользовательских подсетей, это поле необходимо указать. Возвращается: при успешном выполнении |
|
scheduling complex |
Задает параметры планирования для этого экземпляра. Возвращается: при успешном выполнении |
|
automaticRestart boolean |
Указывает, следует ли автоматически перезапускать экземпляр, если его завершил Compute Engine (а не пользователь). Параметр автоматического перезапуска можно задать только для стандартных экземпляров. Экземпляры с прерываемым выполнением нельзя перезапускать автоматически. Возвращается: при успешном выполнении |
|
onHostMaintenance string |
Определяет поведение этого экземпляра во время обслуживания. Для стандартных экземпляров поведение по умолчанию — MIGRATE. Для экземпляров с прерываемым выполнением поведение по умолчанию и единственно возможное поведение — TERMINATE. Дополнительные сведения см. в разделе «Настройка параметров планирования экземпляра». Возвращается: при успешном выполнении |
|
preemptible boolean |
Определяет, является ли экземпляр прерываемым. Это свойство можно задать только при создании экземпляра; после создания его нельзя задать или изменить. Возвращается: при успешном выполнении |
|
serviceAccounts complex |
Список сервисных аккаунтов с указанными для них областями доступа, авторизованных для этого экземпляра. Для одного экземпляра виртуальной машины поддерживается только один сервисный аккаунт. Возвращается: при успешном выполнении |
|
string |
Возвращается: при успешном выполнении |
|
scopes list / elements=string |
Список областей доступа, предоставляемых этому сервисному аккаунту. Возвращается: при успешном выполнении |
|
tags complex |
Список тегов, применяемых к этому экземпляру. Теги используются для определения допустимых источников или целевых объектов для сетевых брандмауэров и задаются клиентом при создании экземпляра. Позднее теги можно изменить с помощью метода setTags. Каждый тег в списке должен соответствовать RFC1035. Возвращается: при успешном выполнении |
|
fingerprint string |
Указывает отпечаток для этого запроса — по сути, хеш содержимого метаданных, используемый для оптимистической блокировки. Отпечаток изначально создается Compute Engine и меняется после каждого запроса на изменение или обновление метаданных. Для обновления или изменения метаданных необходимо всегда указывать актуальный хеш отпечатка. Возвращается: при успешном выполнении |
|
tag_values list / elements=string |
Массив тегов. Длина каждого тега должна составлять от 1 до 63 символов, и он должен соответствовать RFC1035. Возвращается: при успешном выполнении |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/google/cloud/gcp_compute_instance_template_module.html