Spec-Zone.ru › Ansible

модуль 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 / обязательный

Тип используемых учетных данных.

Варианты:

  • "application"
  • "machineaccount"
  • "serviceaccount"
  • "accesstoken"

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.

Варианты:

  • false
  • true

description

string

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

disks

list / elements=dictionary

Массив дисков, связанных с экземплярами, созданными на основе этого шаблона.

auto_delete

boolean

Указывает, следует ли автоматически удалять диск при удалении экземпляра (но не при отключении диска от экземпляра).

Совет: для дисков следует задать autoDelete=true, чтобы после удаления машины не оставались неиспользуемые диски.

Варианты:

  • false
  • true

boot

boolean

Указывает, что это загрузочный диск. Виртуальная машина будет использовать первый раздел диска для корневой файловой системы.

Варианты:

  • false
  • true

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.

Варианты:

  • false
  • true

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 (а не пользователем).

Параметр автоматического перезапуска можно задать только для стандартных экземпляров. Прерываемые экземпляры нельзя перезапускать автоматически.

Варианты:

  • false
  • true

on_host_maintenance

string

Определяет поведение этого экземпляра во время обслуживания. Для стандартных экземпляров поведение по умолчанию — MIGRATE. Для прерываемых экземпляров поведение по умолчанию, а также единственный возможный вариант — TERMINATE.

Дополнительную информацию см. в разделе «Настройка параметров планирования экземпляров».

preemptible

boolean

Определяет, является ли экземпляр прерываемым. Это значение можно задать только при создании экземпляра; задать или изменить его после создания экземпляра нельзя.

Варианты:

  • false
  • true

service_accounts

list / elements=dictionary

Список учетных записей служб с указанными для них областями действия, которым разрешен доступ к этому экземпляру. Для одного экземпляра виртуальной машины поддерживается только одна учетная запись службы.

email

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

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

Примеры

- 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

Список сервисных аккаунтов с указанными для них областями доступа, авторизованных для этого экземпляра. Для одного экземпляра виртуальной машины поддерживается только один сервисный аккаунт.

Возвращается: при успешном выполнении

email

string

Возвращается: при успешном выполнении

scopes

list / elements=string

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

Возвращается: при успешном выполнении

tags

complex

Список тегов, применяемых к этому экземпляру. Теги используются для определения допустимых источников или целевых объектов для сетевых брандмауэров и задаются клиентом при создании экземпляра. Позднее теги можно изменить с помощью метода setTags. Каждый тег в списке должен соответствовать RFC1035.

Возвращается: при успешном выполнении

fingerprint

string

Указывает отпечаток для этого запроса — по сути, хеш содержимого метаданных, используемый для оптимистической блокировки.

Отпечаток изначально создается Compute Engine и меняется после каждого запроса на изменение или обновление метаданных. Для обновления или изменения метаданных необходимо всегда указывать актуальный хеш отпечатка.

Возвращается: при успешном выполнении

tag_values

list / elements=string

Массив тегов. Длина каждого тега должна составлять от 1 до 63 символов, и он должен соответствовать RFC1035.

Возвращается: при успешном выполнении

Авторы

  • Google Inc. (@googlecloudplatform)

Ссылки на коллекцию

  • Отслеживание проблем
  • Главная страница
  • Репозиторий (исходный код)

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API