Spec-Zone.ru › Ansible

Модуль google.cloud.gcp_compute_instance_template – Создаёт шаблон виртуальной машины GCP

Примечание

Этот модуль входит в коллекцию google.cloud (версия 1.4.1).

Возможно, эта коллекция уже установлена, если вы используете пакет 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
END_OF_DOCUMENT_MARKER

Параметры

Параметр

Комментарии

access_token

строка

Токен доступа OAuth2, если тип учетных данных — accesstoken.

auth_kind

строка / обязательно

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

Варианты:

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

description

строка

Необязательное описание этого ресурса. Укажите это свойство при создании ресурса.

env_type

строка

Указывает, в какой среде Ansible выполняется этот модуль.

Не устанавливайте это значение, если вы не знаете, что делаете.

Это изменяет только строку User Agent для всех запросов API.

name

строка / обязательно

Имя ресурса. Длина имени составляет от 1 до 63 символов и соответствует RFC1035.

project

строка

Используемый проект Google Cloud Platform.

properties

словарь

Свойства виртуальной машины для этого шаблона виртуальной машины.

can_ip_forward

булево

Разрешает экземплярам, созданным на основе этого шаблона, отправлять пакеты с исходными IP-адресами, отличными от их собственных, и принимать пакеты с целевыми IP-адресами, отличными от их собственных. Если эти экземпляры будут использоваться в качестве IP-шлюза или будут установлены как следующий шлюз в ресурсе маршрута, укажите true. Если не уверены, оставьте это значение false.

Варианты:

  • false
  • true

description

строка

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

disks

список / элементы=словарь

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

auto_delete

булево

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

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

Варианты:

  • false
  • true

boot

булево

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

Варианты:

  • false
  • true

device_name

строка

Указывает уникальное имя устройства по вашему выбору, которое отображается в дереве /dev/disk/by-id/google-* операционной системы Linux, работающей в виртуальной машине. Это имя можно использовать для ссылки на устройство для монтирования, изменения размера и т. д. внутри виртуальной машины.

disk_encryption_key

словарь

Шифрует или расшифровывает диск с помощью предоставленного пользователем ключа шифрования.

raw_key

строка

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

rsa_encrypted_key

строка

Указывает закодированный в base64 RFC 4648, RSA-зашифрованный 2048-битный ключ шифрования, предоставленный пользователем, для шифрования или расшифровки этого ресурса.

index

целое число

Присваивает индекс, начиная с нуля, этому диску, где 0 зарезервирован для системного диска. Например, если к виртуальной машине подключено несколько дисков, каждый диск будет иметь уникальный индекс. Если не указано, сервер выберет подходящее значение.

initialize_params

словарь

Указывает параметры для нового диска, который будет создан вместе с новой виртуальной машиной. Используйте параметры инициализации для создания системных дисков или локальных SSD-накопителей, подключенных к новой виртуальной машине.

disk_name

строка

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

disk_size_gb

целое число

Указывает размер диска в гигабайтах (2 в степени n).

END_OF_DOCUMENT_MARKER

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 / required

Тип машины, который будет использоваться в шаблоне виртуальной машины.

metadata

dictionary

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

min_cpu_platform

string

Указывает минимальную платформу ЦП для виртуальной машины. Допустимые значения — понятные имена платформ ЦП.

network_interfaces

list / elements=dictionary

Массив конфигураций для этого интерфейса. Это указывает, как этот интерфейс настроен для взаимодействия с другими сетевыми службами, например, для подключения к Интернету. Поддерживается только один сетевой интерфейс на экземпляр.

access_configs

list / elements=dictionary

Массив конфигураций для этого интерфейса. В настоящее время поддерживается только одна конфигурация доступа, ONE_TO_ONE_NAT. Если конфигурации accessConfigs не указаны, этот экземпляр не будет иметь внешнего доступа к Интернету.

name

string / required

Имя этой конфигурации доступа. Имя по умолчанию и рекомендуемое имя — 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 / required

Тип конфигурации. Единственный и используемый по умолчанию вариант - 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.

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

Это поле представляет собой ссылку на ресурс 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

Массив тегов. Каждый тег должен иметь длину от 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

Указывает закодированный в base64 по RFC 4648, 2048-битный ключ шифрования, предоставленный клиентом и обернутый с помощью RSA, для шифрования или расшифровки этого ресурса.

Возвращается: успех

sha256

string

Закодированный в base64 по RFC 4648 хэш SHA-256 предоставленного клиентом ключа шифрования, который защищает этот ресурс.

Возвращается: успех

index

integer

Назначает этому диску индекс, начинающийся с нуля, где 0 зарезервировано для загрузочного диска. Например, если у вас много дисков, подключенных к экземпляру, каждый диск будет иметь уникальный номер индекса. Если не указано, сервер выберет соответствующее значение.

Возвращается: успех

initializeParams

complex

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

Возвращается: успех

diskName

string

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

Возвращается: успех

diskSizeGb

integer

Задает размер диска в базе-2 ГБ.

Возвращено: success

diskType

string

Ссылка на тип диска.

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

Если не указано, по умолчанию используется pd-standard.

Возвращено: success

sourceImage

string

Исходный образ для создания этого диска. При создании нового экземпляра необходимо указать один из параметров initializeParams.sourceImage или disks.source. Чтобы создать диск с одним из общедоступных образов операционной системы, укажите образ по его семейному имени.

Возвращено: success

sourceImageEncryptionKey

complex

Предоставленный клиентом ключ шифрования исходного образа. Требуется, если исходный образ защищен ключом шифрования, предоставленным клиентом.

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

Возвращено: success

rawKey

string

Задает 256-битный ключ шифрования, предоставленный клиентом, закодированный в base64 в соответствии с RFC 4648, для шифрования или дешифрования этого ресурса.

Возвращено: success

sha256

string

Хэш SHA-256, закодированный в base64 в соответствии с RFC 4648, ключа шифрования, предоставленного клиентом, который защищает этот ресурс.

Возвращено: success

interface

string

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

Постоянные диски всегда должны использовать SCSI, и запрос завершится неудачей, если вы попытаетесь подключить постоянный диск в любом другом формате, кроме SCSI.

Возвращено: success

licenses

list / elements=string

Любой применимый URI лицензии.

Возвращено: success

mode

string

Режим подключения этого диска, READ_WRITE или READ_ONLY. Если не указано, по умолчанию диск подключается в режиме READ_WRITE.

Возвращено: success

source

dictionary

Ссылка на диск. При создании нового экземпляра необходимо указать один из параметров initializeParams.sourceImage или disks.source.

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

Обратите внимание, что для InstanceTemplate необходимо указать имя диска, а не URL-адрес диска.

Возвращено: success

type

string

Указывает тип диска, SCRATCH или PERSISTENT. Если не указано, по умолчанию используется PERSISTENT.

Возвращено: success

guestAccelerators

complex

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

Возвращено: success

acceleratorCount

integer

Количество плат гостевых ускорителей, предоставляемых этому экземпляру.

Возвращено: success

acceleratorType

string

Полный или частичный URL-адрес ресурса типа ускорителя, предоставляемого этому экземпляру.

Возвращено: success

labels

dictionary

Метки для применения к этому адресу. Список пар ключ->значение.

Возвращено: success

machineType

string

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

Возвращено: success

metadata

dictionary

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

Возвращено: success

minCpuPlatform

string

Задает минимальную платформу ЦП для экземпляра виртуальной машины. Применимые значения — это понятные имена платформ ЦП.

Возвращено: success

networkInterfaces

complex

Массив конфигураций для этого интерфейса. Это указывает, как этот интерфейс настроен для взаимодействия с другими сетевыми службами, например, для подключения к Интернету. Поддерживается только один сетевой интерфейс на экземпляр.

Returned: success

accessConfigs

complex

Массив конфигураций для этого интерфейса. В настоящее время поддерживается только одна конфигурация доступа, ONE_TO_ONE_NAT. Если конфигурации accessConfigs не указаны, этот экземпляр не будет иметь доступа к внешнему Интернету.

Returned: success

name

string

Имя этой конфигурации доступа. Имя по умолчанию и рекомендуемое имя — External NAT, но вы можете использовать любую произвольную строку. Например, My external IP или Network Access.

Returned: success

natIP

dictionary

Ссылка на адрес.

Внешний IP-адрес, связанный с этим экземпляром.

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

Returned: success

networkTier

string

Это обозначает уровень сети, используемый для настройки этой конфигурации доступа. Если AccessConfig указан без допустимого внешнего IP-адреса, эфемерный IP будет создан с этим networkTier. Если указан AccessConfig с допустимым внешним IP-адресом, он должен соответствовать networkTier, связанному с ресурсом Address, владеющим этим IP-адресом.

Returned: success

publicPtrDomainName

string

Доменное имя DNS для общедоступной записи PTR. Вы можете установить это поле только в том случае, если поле setPublicPtr включено.

Returned: success

setPublicPtr

boolean

Указывает, следует ли создавать общедоступную запись DNS PTR для сопоставления внешнего IP-адреса экземпляра с доменным именем DNS.

Returned: success

type

string

Тип конфигурации. Единственный вариант по умолчанию — ONE_TO_ONE_NAT.

Returned: success

aliasIpRanges

complex

Массив диапазонов IP-адресов псевдонимов для этого сетевого интерфейса. Может быть указан только для сетевых интерфейсов в сетях в режиме подсети.

Returned: success

ipCidrRange

string

Диапазон IP CIDR, представленный этим диапазоном IP-адресов псевдонима.

Этот диапазон IP CIDR должен принадлежать указанной подсети и не может содержать IP-адреса, зарезервированные системой или используемые другими сетевыми интерфейсами. Этот диапазон может быть одним IP-адресом (например, 10.2.3.4), маской сети (например, /24) или строкой в формате CIDR (например, 10.1.2.0/24).

Returned: success

subnetworkRangeName

string

Необязательное имя вторичного диапазона подсети, указывающее вторичный диапазон, из которого следует выделять диапазон IP CIDR для этого диапазона IP-адресов псевдонима. Если не указано, будет использоваться основной диапазон подсети.

Returned: success

name

string

Имя сетевого интерфейса, создаваемое сервером. Для сетевых устройств это eth0, eth1 и т. д.

Returned: success

network

dictionary

Указывает заголовок существующей сети. При создании экземпляра, если не указана ни сеть, ни подсеть, используется сеть по умолчанию global/networks/default; если сеть не указана, но подсеть указана, сеть выводится.

Returned: success

networkIP

string

Внутренний сетевой адрес IPv4, который нужно назначить экземпляру для этого сетевого интерфейса. Если не указано пользователем, система назначает неиспользуемый внутренний IP-адрес.

Returned: success

subnetwork

dictionary

Ссылка на сеть VPC.

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

Returned: success

scheduling

complex

Задает параметры планирования для этого экземпляра.

Returned: success

автоматическоеПерезапуск

boolean

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

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

Возвращается: success

приТехническомОбслуживанииХоста

строка

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

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

Возвращается: success

предварительноРезервируемый

boolean

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

Возвращается: success

учетныеЗаписиСлужбы

сложный

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

Возвращается: success

адрес электронной почты

строка

Адрес электронной почты учетной записи службы.

Возвращается: success

области

список / элементы=строка

Список областей, доступных для этой учетной записи службы.

Возвращается: success

метки

сложный

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

Возвращается: success

отпечаток

строка

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

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

Возвращается: success

элементы

список / элементы=строка

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

Возвращается: success

Авторы

  • Google Inc. (@googlecloudplatform)

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

  • Система отслеживания ошибок
  • Главная страница
  • Репозиторий (источники)

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

Spec-Zone.ru

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