gcp_compute_instance – Создаёт экземпляр GCP
Новая в версии 2.6.
Описание
- Экземпляр — виртуальная машина (ВМ), размещённая на инфраструктуре Google.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- python >= 2.6
- requests >= 2.18.4
- google-auth >= 1.3.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |||
|---|---|---|---|---|---|
| auth_kind строка / обязательно |
| Тип используемых учетных данных. | |||
| can_ip_forward булево |
| Разрешает данному экземпляру отправлять и получать пакеты с несовпадающими IP-адресами назначения или источника. Это необходимо, если вы планируете использовать этот экземпляр для переадресации маршрутов. псевдонимы: ip_forward | |||
| disks - | Массив дисков, связанных с экземплярами, созданными по этому шаблону. | ||||
| auto_delete булево |
| Указывает, будет ли диск автоматически удален при удалении экземпляра (но не при отсоединении диска от экземпляра). Совет: Диски следует устанавливать autoDelete=true, чтобы при удалении машины не оставались лишние диски. | |||
| boot булево |
| Указывает, что это загрузочный диск. Виртуальная машина будет использовать первый раздел диска для своей корневой файловой системы. | |||
| device_name - | Указывает уникальное имя устройства по вашему выбору, которое отображается в дереве /dev/disk/by-id/google-* операционной системы Linux, работающей внутри экземпляра. Это имя можно использовать для ссылки на устройство для монтирования, изменения размера и т.д. внутри экземпляра. | ||||
| disk_encryption_key - | Шифрует или расшифровывает диск с помощью предоставленного клиентом ключа шифрования. | ||||
| raw_key - | Указывает 256-битный ключ шифрования, предоставленный клиентом, закодированный в RFC 4648 base64 для шифрования или расшифровки данного ресурса. | ||||
| rsa_encrypted_key - | Указывает закодированный в RFC 4648 base64, защищенный RSA, 2048-битный ключ шифрования, предоставленный клиентом, для шифрования или расшифровки этого ресурса. | ||||
| index - | Назначает индекс с нуля этому диску, где 0 зарезервирован для загрузочного диска. Например, если к экземпляру подключено много дисков, каждый диск будет иметь уникальный номер индекса. Если не указано, сервер выберет соответствующее значение. | ||||
| initialize_params - | Указывает параметры для нового диска, который будет создан вместе с новым экземпляром. Используйте параметры инициализации для создания загрузочных дисков или локальных SSD, подключенных к новому экземпляру. | ||||
| disk_name - | Указывает имя диска. Если не указано, используется имя экземпляра по умолчанию. | ||||
| disk_size_gb - | Указывает размер диска в гигабайтах (в двоичном формате). | ||||
| disk_type - | Ссылка на тип диска. Указывает тип диска для создания экземпляра. Если не указано, используется значение по умолчанию pd-standard. | ||||
| source_image - | Исходный образ для создания этого диска. При создании нового экземпляра требуется один из initializeParams.sourceImage или disks.source. Для создания диска с одним из общедоступных образов операционных систем укажите образ по его семейному имени. псевдонимы: image, image_family | ||||
| source_image_encryption_key - | Ключ шифрования исходного образа, предоставленный клиентом. Требуется, если исходный образ защищен ключом шифрования, предоставленным клиентом. Шаблоны экземпляров не хранят ключи шифрования, предоставленные клиентом, поэтому вы не можете создавать диски для экземпляров в управляемой группе экземпляров, если исходные образы зашифрованы с помощью ваших собственных ключей. | ||||
| raw_key - | Указывает 256-битный ключ шифрования, предоставленный клиентом, закодированный в RFC 4648 base64 для шифрования или расшифровки этого ресурса. | ||||
| interface - |
| Указывает интерфейс диска для подключения этого диска, который может быть SCSI или NVME. По умолчанию используется SCSI. Постоянные диски всегда должны использовать SCSI, и запрос завершится ошибкой, если вы попытаетесь подключить постоянный диск в другом формате, кроме SCSI. | |||
| mode - |
| Режим подключения этого диска: READ_WRITE или READ_ONLY. Если не указано, диск подключается в режиме READ_WRITE по умолчанию. | |||
| source - | Ссылка на диск. При создании нового экземпляра требуется один из initializeParams.sourceImage или disks.source. По желанию, вы также можете подключить существующие постоянные диски, не являющиеся корневыми, с помощью этого свойства. Это поле применимо только к постоянным дискам. Это поле представляет собой ссылку на ресурс Диск в GCP. Его можно указать двумя способами. Во-первых, вы можете поместить словарь с ключом 'selfLink' и значением selfLink вашего ресурса. Или вы можете добавить `register: name-of-resource` в задачу gcp_compute_disk, а затем установить это поле source в "{{ name-of-resource }}" | ||||
| type - |
| Указывает тип диска: SCRATCH или PERSISTENT. Если не указано, по умолчанию используется PERSISTENT. | |||
| guest_accelerators - | Список типов и количества ускорительных карт, подключенных к экземпляру. | ||||
| accelerator_count - | Количество ускорительных карт гостевого уровня, доступных для этого экземпляра. | ||||
| accelerator_type - | Полный или частичный URL ресурса типа ускорителя, который нужно предоставить этому экземпляру. | ||||
| label_fingerprint - | Отпечаток для этого запроса, который фактически представляет собой хеш содержимого метаданных и используется для оптимистической блокировки. Отпечаток первоначально генерируется Compute Engine и изменяется после каждого запроса на изменение или обновление метаданных. Вы всегда должны указывать актуальный хеш отпечатка для обновления или изменения метаданных. | ||||
| machine_type - | Ссылка на тип машины, определяющий тип ВМ. | ||||
| metadata - | Ключи и значения метаданных, которые нужно назначить экземплярам, созданным по этому шаблону. Эти пары могут состоять из пользовательских метаданных или предопределенных ключей. | ||||
| min_cpu_platform - | Указывает минимальную платформу процессора для виртуального экземпляра. Применимые значения — это дружественные имена платформ процессоров. | ||||
| name - | Имя ресурса, предоставленное клиентом при первоначальном создании ресурса. Имя ресурса должно быть длиной от 1 до 63 символов и соответствовать RFC1035. То есть имя должно быть длиной от 1 до 63 символов и соответствовать регулярному выражению `[a-z]([-a-z0-9]*[a-z0-9])?`, что означает, что первый символ должен быть строчной буквой, а все последующие символы должны быть дефисом, строчной буквой или цифрой, за исключением последнего символа, который не может быть дефисом. | ||||
| сетевые_интерфейсы - | Массив конфигураций для данного интерфейса. Определяет, как этот интерфейс настроен для взаимодействия с другими сетевыми службами, например, для подключения к интернету. На экземпляре поддерживается только один сетевой интерфейс. | ||||
| конфигурации_доступа - | Массив конфигураций для данного интерфейса. В настоящее время поддерживается только одна конфигурация доступа ONE_TO_ONE_NAT. Если конфигурации доступа не указаны, этот экземпляр не будет иметь внешнего доступа к интернету. | ||||
| имя - / обязательно | Имя этой конфигурации доступа. Рекомендуемое и по умолчанию имя — External NAT, но можно использовать любую произвольную строку. Например, My external IP или Network Access. | ||||
| nat_ip - | Ссылка на адрес. Внешний IP-адрес, связанный с этим экземпляром. Укажите неиспользуемый статический внешний IP-адрес, доступный для проекта, или оставьте это поле неопределённым, чтобы использовать IP из общего пула временных IP-адресов. Если вы указываете статический внешний IP-адрес, он должен находиться в той же области, что и зона экземпляра. Это поле представляет собой ссылку на ресурс Address в GCP. Его можно указать двумя способами. Во-первых, можно поместить словарь с ключом 'address' и значением адреса вашего ресурса. Во-вторых, можно добавить `register: имя_ресурса` в задачу gcp_compute_address и затем установить это поле nat_ip в "{{ имя_ресурса }}" | ||||
| тип - / обязательно |
| Тип конфигурации. По умолчанию и единственный вариант — ONE_TO_ONE_NAT. | |||
| alias_ip_ranges - | Массив диапазонов IP-адресов alias для данного сетевого интерфейса. Может быть указан только для сетевых интерфейсов на сетях subnet-mode. | ||||
| ip_cidr_range - | Диапазон IP CIDR, представленный этим диапазоном alias IP. Этот диапазон IP CIDR должен принадлежать указанной подсети и не должен содержать IP-адреса, зарезервированные системой или используемые другими сетевыми интерфейсами. Этот диапазон может быть отдельным IP-адресом (например, 10.2.3.4), маской сети (например, /24) или строкой в формате CIDR (например, 10.1.2.0/24). | ||||
| subnetwork_range_name - | Необязательное имя дополнительного диапазона подсети, указывающее дополнительный диапазон, из которого следует выделять диапазон IP CIDR для этого диапазона alias IP. Если не указано, будет использоваться основной диапазон подсети. | ||||
| сеть - | Указывает название существующей сети. При создании экземпляра, если сеть или подсеть не указаны, используется сеть по умолчанию global/networks/default; если сеть не указана, но указана подсеть, сеть определяется по подсети. Это поле представляет собой ссылку на ресурс Network в GCP. Его можно указать двумя способами. Во-первых, можно поместить словарь с ключом 'selfLink' и значением selfLink вашего ресурса. Во-вторых, можно добавить `register: имя_ресурса` в задачу gcp_compute_network и затем установить это поле network в "{{ имя_ресурса }}" | ||||
| сетевой_ip - | Внутренний IPv4-адрес сети, который следует назначить экземпляру для этого сетевого интерфейса. Если пользователь не указывает, система назначает неиспользуемый внутренний IP. | ||||
| подсеть - | Ссылка на сеть VPC. Если ресурс сети находится в режиме legacy, не предоставляйте это свойство. Если сеть находится в режиме автоматической подсети, предоставление подсети является необязательным. Если сеть находится в режиме подсети по умолчанию, это поле должно быть указано. Это поле представляет собой ссылку на ресурс Subnetwork в GCP. Его можно указать двумя способами. Во-первых, можно поместить словарь с ключом 'selfLink' и значением selfLink вашего ресурса. Во-вторых, можно добавить `register: имя_ресурса` в задачу gcp_compute_subnetwork и затем установить это поле subnetwork в "{{ имя_ресурса }}" | ||||
| проект строка | Используемый проект Google Cloud Platform. | ||||
| планирование - | Настройка параметров планирования для данного экземпляра. | ||||
| автоматический_перезапуск булево |
| Указывает, следует ли автоматически перезапускать экземпляр, если он был завершён Compute Engine (а не пользователем). Автоматический перезапуск можно задать только для стандартных экземпляров. Для предварительно выделенных экземпляров автоматический перезапуск невозможен. | |||
| при_техническом_обслуживании_хоста - | Определяет поведение при техническом обслуживании для данного экземпляра. Для стандартных экземпляров поведение по умолчанию — MIGRATE. Для предварительно выделенных экземпляров поведение по умолчанию и единственно возможное — TERMINATE. Для получения дополнительной информации см. Настройка параметров планирования экземпляров. | ||||
| предварительно_выделенный булево |
| Определяет, является ли экземпляр предварительно выделенным. Это можно задать только при создании экземпляра, изменить после создания экземпляра нельзя. | |||
| разрешения список | Массив разрешений для использования. | ||||
| содержимое_учета_служб строка | Строка, представляющая содержимое файла JSON учетной записи службы. Не следует передавать это как словарь, а как строку с точным содержимым файла service account json (корректный JSON). | ||||
| электронный_адрес_учета_служб строка | Необязательный адрес электронной почты учетной записи службы, если выбран machineaccount и пользователь не хочет использовать адрес по умолчанию. | ||||
| файл_учета_служб путь | Путь к файлу JSON учетной записи службы, если serviceaccount выбран в качестве типа. | ||||
| учетные_записи_служб - | Список учетных записей служб со своими указанными разрешениями, авторизованных для данного экземпляра. На один экземпляр виртуальной машины поддерживается только одна учетная запись службы. | ||||
| электронный_адрес - | Адрес электронной почты учетной записи службы. | ||||
| разрешения - | Список разрешений, которые должны быть доступны для этой учетной записи службы. | ||||
| состояние - |
| Нужно ли, чтобы данный объект существовал в GCP | |||
| статус - добавлено в 2.8 |
| Статус экземпляра. Одно из следующих значений: PROVISIONING, STAGING, RUNNING, STOPPING, SUSPENDING, SUSPENDED и TERMINATED. В качестве пользователя, используйте RUNNING, чтобы машина оставалась "включённой", и TERMINATED, чтобы выключить её. | |||
| теги - | Список тегов, применяемых к этому экземпляру. Теги используются для идентификации допустимых источников или целей для сетевых брандмауэров и указываются клиентом при создании экземпляра. Теги можно изменить позже с помощью метода setTags. Каждый тег в списке должен соответствовать RFC1035. | ||||
| отпечаток - | Указывает отпечаток для этого запроса, который представляет собой хэш содержимого метаданных и используется для оптимистической блокировки. Отпечаток первоначально генерируется Compute Engine и изменяется после каждого запроса на изменение или обновление метаданных. Вы всегда должны предоставить актуальный хэш отпечатка, чтобы обновить или изменить метаданные. | ||||
| items - | Массив тегов. Каждый тег должен иметь длину от 1 до 63 символов и соответствовать RFC1035. | ||||
| zone - / обязательно | Ссылка на зону, в которой расположена машина. | ||||
Примечания
Примечание
- Для аутентификации можно установить service_account_file с помощью переменной окружения
GCP_SERVICE_ACCOUNT_FILE. - Для аутентификации можно установить service_account_email с помощью переменной окружения
GCP_SERVICE_ACCOUNT_EMAIL. - Для аутентификации можно установить service_account_contents с помощью переменной окружения
GCP_SERVICE_ACCOUNT_CONTENTS. - Для аутентификации можно установить auth_kind с помощью переменной окружения
GCP_AUTH_KIND. - Для аутентификации можно установить scopes с помощью переменной окружения
GCP_SCOPES. - Значения переменных окружения будут использоваться только в том случае, если значения в playbook не заданы.
- Параметры service_account_email и service_account_file взаимоисключающие.
Примеры
- name: create a disk
gcp_compute_disk:
name: disk-instance
size_gb: 50
source_image: projects/ubuntu-os-cloud/global/images/family/ubuntu-1604-lts
zone: us-central1-a
project: "{{ gcp_project }}"
auth_kind: "{{ gcp_cred_kind }}"
service_account_file: "{{ gcp_cred_file }}"
state: present
register: disk
- name: create a network
gcp_compute_network:
name: network-instance
project: "{{ gcp_project }}"
auth_kind: "{{ gcp_cred_kind }}"
service_account_file: "{{ gcp_cred_file }}"
state: present
register: network
- name: create a address
gcp_compute_address:
name: address-instance
region: us-central1
project: "{{ gcp_project }}"
auth_kind: "{{ gcp_cred_kind }}"
service_account_file: "{{ gcp_cred_file }}"
state: present
register: address
- name: create a instance
gcp_compute_instance:
name: test_object
machine_type: n1-standard-1
disks:
- auto_delete: 'true'
boot: 'true'
source: "{{ disk }}"
metadata:
startup-script-url: gs:://graphite-playground/bootstrap.sh
cost-center: '12345'
network_interfaces:
- network: "{{ network }}"
access_configs:
- name: External NAT
nat_ip: "{{ address }}"
type: ONE_TO_ONE_NAT
zone: us-central1-a
project: test_project
auth_kind: serviceaccount
service_account_file: "/tmp/auth.pem"
state: present
Значения возврата
Общие значения возврата описаны здесь, ниже приведены поля, уникальные для данного модуля:
| Ключ | Возвращено | Описание | |||
|---|---|---|---|---|---|
| canIpForward boolean | success | Разрешает этому экземпляру отправлять и получать пакеты с несовпадающими IP-адресами назначения или источника. Это необходимо, если вы планируете использовать этот экземпляр для переадресации маршрутов. | |||
| cpuPlatform строка | success | Платформа процессора, используемая этим экземпляром. | |||
| creationTimestamp строка | success | Маркер создания в формате RFC3339. | |||
| disks сложное | success | Массив дисков, связанных с экземплярами, созданными из этой шаблона. | |||
| autoDelete boolean | success | Указывает, будет ли диск автоматически удален при удалении экземпляра (но не при отделении диска от экземпляра). Совет: Диски следует устанавливать autoDelete=true, чтобы не оставались ненужные диски при удалении машины. | |||
| boot boolean | success | Указывает, что это загрузочный диск. Виртуальная машина будет использовать первый раздел диска для своей корневой файловой системы. | |||
| deviceName строка | success | Указывает уникальное имя устройства по вашему выбору, которое отображается в дереве /dev/disk/by-id/google-* операционной системы Linux, работающей в экземпляре. Это имя может быть использовано для ссылки на устройство для монтирования, изменения размера и т. д. изнутри экземпляра. | |||
| diskEncryptionKey сложное | success | Шифрует или расшифровывает диск с помощью предоставленного клиентом ключа шифрования. | |||
| rawKey строка | success | Указывает 256-битный ключ шифрования, предоставленный клиентом, закодированный в base64 RFC 4648 для шифрования или расшифровки этого ресурса. | |||
| rsaEncryptedKey строка | success | Указывает закодированный в base64 RFC 4648, обернутый RSA, 2048-битный ключ шифрования, предоставленный клиентом, для шифрования или расшифровки этого ресурса. | |||
| sha256 строка | success | Закодированный в base64 RFC 4648 SHA-256 хэш ключа шифрования, предоставленного клиентом, который защищает этот ресурс. | |||
| index целое число | success | Присваивает индекс с нулевым основанием этому диску, где 0 зарезервирован для загрузочного диска. Например, если к экземпляру подключено много дисков, каждый диск будет иметь уникальный индекс. Если не указано, сервер выберет соответствующее значение. | |||
| initializeParams сложное | success | Указывает параметры для нового диска, который будет создан вместе с новым экземпляром. Используйте параметры инициализации для создания загрузочных дисков или локальных SSD, подключенных к новому экземпляру. | |||
| diskName строка | success | Указывает имя диска. Если не указано, используется имя экземпляра по умолчанию. | |||
| diskSizeGb целое число | success | Указывает размер диска в GB (в двоичном представлении). | |||
| diskType строка | success | Ссылка на тип диска. Указывает тип диска для создания экземпляра. Если не указано, по умолчанию используется pd-standard. | |||
| sourceImage строка | success | Исходный образ для создания этого диска. При создании нового экземпляра требуется один из initializeParams.sourceImage или disks.source. Чтобы создать диск с одним из общедоступных образов операционных систем, укажите имя семейства образа. | |||
| sourceImageEncryptionKey сложное | success | Ключ шифрования, предоставленный клиентом, исходного образа. Требуется, если исходный образ защищен ключом шифрования, предоставленным клиентом. Шаблоны экземпляров не хранят ключи шифрования, предоставленные клиентом, поэтому вы не можете создавать диски для экземпляров в группе управляемых экземпляров, если исходные образы зашифрованы с помощью ваших собственных ключей. | |||
| rawKey строка | success | Указывает 256-битный ключ шифрования, предоставленный клиентом, закодированный в base64 RFC 4648 для шифрования или расшифровки этого ресурса. | |||
| sha256 строка | success | Закодированный в base64 RFC 4648 SHA-256 хэш ключа шифрования, предоставленного клиентом, который защищает этот ресурс. | |||
| interface строка | success | Указывает интерфейс диска для подключения этого диска, который может быть SCSI или NVME. По умолчанию используется SCSI. Постоянные диски всегда должны использовать SCSI, и запрос завершится ошибкой, если вы попытаетесь подключить постоянный диск в другом формате, кроме SCSI. | |||
| mode строка | success | Режим подключения этого диска, либо READ_WRITE, либо READ_ONLY. Если не указано, по умолчанию диск подключается в режиме READ_WRITE. | |||
| source словарь | success | Ссылка на диск. При создании нового экземпляра требуется один из initializeParams.sourceImage или disks.source. Если необходимо, вы также можете подключить существующие постоянные диски, не являющиеся корневыми, с помощью этого свойства. Это поле применимо только для постоянных дисков. | |||
| type строка | success | Указывает тип диска, либо SCRATCH, либо PERSISTENT. Если не указано, по умолчанию используется PERSISTENT. | |||
| guestAccelerators сложное | success | Список типа и количества карт ускорителей, подключенных к экземпляру. | |||
| acceleratorCount целое число | success | Количество карт ускорителей гостевой системы, доступных этому экземпляру. | |||
| acceleratorType строка | success | Полный или частичный URL ресурса типа ускорителя, который нужно открыть для этого экземпляра. | |||
| id целое число | success | Уникальный идентификатор ресурса. Этот идентификатор определен сервером. | |||
| labelFingerprint строка | success | Отпечаток метки для этого запроса, который по сути является хэшем содержимого метаданных и используется для оптимистической блокировки. Отпечаток первоначально генерируется Compute Engine и изменяется после каждого запроса на изменение или обновление метаданных. Вы всегда должны предоставлять актуальный отпечаток хэша, чтобы обновить или изменить метаданные. | |||
| machineType строка | success | Ссылка на тип машины, которая определяет вид VM. | |||
| metadata словарь | success | Ключевые пары метаданных/значений, которые нужно назначить экземплярам, созданным из этого шаблона. Эти пары могут состоять из пользовательских метаданных или предопределенных ключей. | |||
| minCpuPlatform строка | success | Указывает минимальную платформу процессора для виртуальной машины. Допустимые значения — дружественные имена платформ процессоров. | |||
| name строка | success | Имя ресурса, предоставленное клиентом при первоначальном создании ресурса. Имя ресурса должно содержать от 1 до 63 символов и соответствовать RFC1035. То есть имя должно иметь длину от 1 до 63 символов и соответствовать регулярному выражению `[a-z]([-a-z0-9]*[a-z0-9])?`, что означает, что первый символ должен быть строчной буквой, а все последующие символы — тире, строчная буква или цифра, за исключением последнего символа, который не может быть тире. | |||
| networkInterfaces complex | success | Массив конфигураций для этого интерфейса. Он определяет, как этот интерфейс настроен для взаимодействия с другими сетевыми службами, такими как подключение к Интернету. На экземпляр поддерживается только один сетевой интерфейс. | |||
| accessConfigs complex | success | Массив конфигураций для этого интерфейса. В настоящее время поддерживается только одна конфигурация доступа, ONE_TO_ONE_NAT. Если accessConfigs не указаны, у этого экземпляра не будет внешнего доступа к Интернету. | |||
| name string | success | Имя этой конфигурации доступа. Рекомендуемое имя — External NAT, но вы можете использовать любую произвольную строку. Например, Мой внешний IP-адрес или Сетевой доступ. | |||
| natIP dictionary | success | Ссылка на адрес. Внешний IP-адрес, связанный с этим экземпляром. Укажите свободный статический внешний IP-адрес, доступный для проекта, или оставьте это поле неопределённым, чтобы использовать IP-адрес из общего пула временных IP-адресов. Если вы указываете статический внешний IP-адрес, он должен находиться в той же области, что и зона экземпляра. | |||
| type string | success | Тип конфигурации. Единственный и стандартный вариант — ONE_TO_ONE_NAT. | |||
| aliasIpRanges complex | success | Массив диапазонов IP-адресов для этого сетевого интерфейса. Может быть указан только для сетевых интерфейсов в сетях с режимом подсети. | |||
| ipCidrRange string | success | Диапазон IP CIDR, представленный этим диапазоном alias IP. Этот диапазон IP CIDR должен принадлежать указанной подсети и не может содержать IP-адреса, зарезервированные системой или используемые другими сетевыми интерфейсами. Этот диапазон может представлять собой один IP-адрес (например, 10.2.3.4), маску (например, /24) или строку в формате CIDR (например, 10.1.2.0/24). | |||
| subnetworkRangeName string | success | Необязательное имя вторичного диапазона подсети, определяющее вторичный диапазон, из которого следует выделить диапазон IP CIDR для этого диапазона alias IP. Если не указано, будет использован основной диапазон подсети. | |||
| name string | success | Имя сетевого интерфейса, сгенерированное сервером. Для сетевых устройств это eth0, eth1 и т. д. | |||
| network dictionary | success | Указывает заголовок существующей сети. При создании экземпляра, если не указана сеть или подсеть, используется сеть по умолчанию global/networks/default; если сеть не указана, но указана подсеть, сеть определяется автоматически. | |||
| networkIP string | success | Внутренний IPv4-адрес сети для назначения экземпляру для этого сетевого интерфейса. Если пользователь его не указывает, система назначает свободный внутренний IP. | |||
| subnetwork dictionary | success | Ссылка на VPC-сеть. Если ресурс сети находится в режиме legacy, не предоставляйте это свойство. Если сеть в режиме автоматической подсети, предоставление подсети является необязательным. Если сеть в режиме пользовательской подсети, это поле должно быть указано. | |||
| scheduling complex | success | Настройка параметров планирования для этого экземпляра. | |||
| automaticRestart boolean | success | Определяет, следует ли автоматически перезапускать экземпляр, если он был завершён Compute Engine (а не пользователем). Вы можете задать параметр автоматического перезапуска только для стандартных экземпляров. Предварительные экземпляры не могут быть автоматически перезапущены. | |||
| onHostMaintenance string | success | Определяет поведение обслуживания для этого экземпляра. Для стандартных экземпляров поведение по умолчанию — MIGRATE. Для предварительных экземпляров поведение по умолчанию и единственное возможное поведение — TERMINATE. Для получения дополнительной информации см. Настройка параметров планирования экземпляров. | |||
| preemptible boolean | success | Определяет, является ли экземпляр предварительным. Это можно установить только при создании экземпляра; после создания изменить нельзя. | |||
| serviceAccounts complex | success | Список учётных записей сервисов со своими указанными областями, авторизованными для этого экземпляра. На один виртуальный компьютер поддерживается только одна учётная запись сервиса. | |||
| email string | success | Электронный адрес учётной записи сервиса. | |||
| scopes list | success | Список областей, которые должны быть доступны для этой учётной записи сервиса. | |||
| status string | success | Состояние экземпляра. Одно из следующих значений: PROVISIONING, STAGING, RUNNING, STOPPING, SUSPENDING, SUSPENDED и TERMINATED. В качестве пользователя, используйте RUNNING, чтобы сохранить машину «включённой», и TERMINATED, чтобы выключить её. | |||
| statusMessage string | success | Необязательное, читаемое человеком объяснение состояния. | |||
| tags complex | success | Список тегов, которые необходимо применить к этому экземпляру. Теги используются для определения допустимых источников или целей сетевых брандмауэров и указываются клиентом при создании экземпляра. Теги могут быть изменены позже методом setTags. Каждый тег в списке должен соответствовать RFC1035. | |||
| fingerprint string | success | Указывает отпечаток для этого запроса, который представляет собой хэш содержимого метаданных и используется для оптимистической блокировки. Отпечаток первоначально генерируется Compute Engine и изменяется после каждого запроса на изменение или обновление метаданных. Вы всегда должны указать обновлённый хэш отпечатка, чтобы обновить или изменить метаданные. | |||
| items list | success | Массив тегов. Каждый тег должен быть длиной от 1 до 63 символов и соответствовать RFC1035. | |||
| zone string | success | Ссылка на зону, где находится машина. | |||
Состояние
- Этот модуль не гарантирует обратную совместимость интерфейса. [preview]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Google Inc. (@googlecloudplatform)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете изменить этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/gcp_compute_instance_module.html