google.cloud.gcp_compute_instance 模块 – 创建一个 GCP 实例

注意

此模块是 google.cloud 集合（版本 1.4.1）的一部分。

如果您正在使用 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install google.cloud。您需要其他要求才能使用此模块，请参阅要求了解详细信息。

要在 playbook 中使用它，请指定：google.cloud.gcp_compute_instance。

注意

由于违反了 Ansible 包含要求，google.cloud 集合将从 Ansible 12 中删除。该集合有未解决的健全性测试失败。有关更多信息，请参阅讨论主题。

概要 

实例是托管在 Google 基础设施上的虚拟机 (VM)。

要求 

在执行此模块的主机上需要以下要求。

python >= 2.6
requests >= 2.18.4
google-auth >= 1.3.0

参数 

参数	注释
access_token 字符串	如果凭据类型为 accesstoken，则为 OAuth2 访问令牌。
auth_kind 字符串 / 必需	使用的凭据类型。选择 `"application"` `"machineaccount"` `"serviceaccount"` `"accesstoken"`
can_ip_forward 别名：ip_forward 布尔值	允许此实例发送和接收具有不匹配的目标或源 IP 的数据包。如果您计划使用此实例转发路由，则这是必需的。选择 `false` `true`
confidential_instance_config 字典	机密计算的配置（需要将机器类型设置为任何 n2d-* 类型，并将启动磁盘设置为 pd-ssd 类型）。
enable_confidential_compute 布尔值	启用机密计算。选择 `false` `true`
deletion_protection 布尔值	是否应保护资源免遭删除。选择 `false` `true`
disks 列表 / 元素=字典	与从此模板创建的实例关联的磁盘数组。
auto_delete 布尔值	指定在删除实例时（而不是在从实例分离磁盘时）是否会自动删除磁盘。提示：应将磁盘设置为 autoDelete=true，以便在删除机器时不会留下剩余磁盘。选择 `false` `true`
boot 布尔值	指示这是一个启动磁盘。虚拟机将使用磁盘的第一个分区作为其根文件系统。选择 `false` `true`
device_name 字符串	指定您选择的唯一设备名称，该名称会反映到实例中运行的 Linux 操作系统的 /dev/disk/by-id/google-* 树中。此名称可用于从实例内部引用设备以进行挂载、调整大小等操作。
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 整数	指定磁盘的大小（以 2 为底的 GB 为单位）。
disk_type 字符串	对磁盘类型的引用。指定用于创建实例的磁盘类型。如果未指定，则默认为 pd-standard。
source_image 别名：image, image_family 字符串	用于创建此磁盘的源映像。创建新实例时，需要 initializeParams.sourceImage 或 disks.source 中的一个。要使用其中一个公共操作系统映像创建磁盘，请按其系列名称指定映像。
source_image_encryption_key 字典	源映像的客户提供的加密密钥。如果源映像受客户提供的加密密钥保护，则为必需项。实例模板不存储客户提供的加密密钥，因此如果源映像使用您自己的密钥加密，则无法为托管实例组中的实例创建磁盘。
raw_key 字符串	指定一个 256 位客户提供的加密密钥，以 RFC 4648 base64 编码，用于加密或解密此资源。
interface 字符串	指定用于连接此磁盘的磁盘接口，可以是 SCSI 或 NVME。默认值为 SCSI。持久磁盘必须始终使用 SCSI，并且如果您尝试以 SCSI 以外的任何其他格式连接持久磁盘，则请求将失败。一些有效的选择包括：“SCSI”、“NVME”
mode 字符串	连接此磁盘的模式，可以是 READ_WRITE 或 READ_ONLY。如果未指定，则默认为以 READ_WRITE 模式连接磁盘。一些有效的选择包括：“READ_WRITE”、“READ_ONLY”
source 字典	引用一个磁盘。创建新实例时，需要 `initializeParams.sourceImage` 或 `disks.source` 之一。如果需要，您还可以使用此属性附加现有的非根持久磁盘。此字段仅适用于持久磁盘。此字段表示指向 GCP 中磁盘资源的链接。它可以通过两种方式指定。首先，您可以放置一个字典，其中键为 `selfLink`，值为资源的 `selfLink`。或者，您可以将 `register: name-of-resource` 添加到 `gcp_compute_disk` 任务中，然后将此 source 字段设置为“{{ name-of-resource }}”。
type 字符串	指定磁盘的类型，可以是 SCRATCH 或 PERSISTENT。如果未指定，则默认值为 PERSISTENT。一些有效选项包括：“SCRATCH”、“PERSISTENT”
env_type 字符串	指定您在其中运行此 Ansible 模块的环境。除非您知道自己在做什么，否则不应设置此项。这只会更改任何 API 请求的 User Agent 字符串。
guest_accelerators 列表 / 元素=字典	附加到实例的加速卡类型和数量的列表。
accelerator_count 整数	暴露给此实例的访客加速卡数量。
accelerator_type 字符串	要暴露给此实例的加速器类型资源的完整或部分 URL。
hostname 字符串	要创建的实例的主机名。指定的主机名必须符合 RFC1035 标准。如果未指定主机名，则在使用全局 DNS 时，默认主机名为 [INSTANCE_NAME].c.[PROJECT_ID].internal；在使用区域 DNS 时，默认主机名为 [INSTANCE_NAME].[ZONE].c.[PROJECT_ID].internal。
labels 字典	要应用于此实例的标签。键值对列表。
machine_type 字符串	对定义虚拟机类型的机器类型的引用。
metadata 字典	要分配给从此模板创建的实例的元数据键/值对。这些对可以包含自定义元数据或预定义的键。
min_cpu_platform 字符串	指定虚拟机实例的最低 CPU 平台。适用的值是 CPU 平台的友好名称。
name 字符串	资源名称，由客户端在最初创建资源时提供。资源名称长度必须为 1-63 个字符，并且符合 RFC1035 标准。具体来说，名称长度必须为 1-63 个字符，并且与正则表达式 `[a-z]([-a-z0-9]*[a-z0-9])?` 匹配，这意味着第一个字符必须是小写字母，所有后续字符必须是短划线、小写字母或数字，但最后一个字符不能是短划线。
network_interfaces 列表 / 元素=字典	此接口的配置数组。它指定此接口如何配置为与其他网络服务交互，例如连接到互联网。每个实例仅支持一个网络接口。
access_configs 列表 / 元素=字典	此接口的配置数组。目前，仅支持一个访问配置，即 ONE_TO_ONE_NAT。如果没有指定 `accessConfigs`，则此实例将没有外部互联网访问。
name 字符串 / 必需	此访问配置的名称。默认且推荐的名称是 External NAT，但您可以使用任何您喜欢的任意字符串。例如，My external IP 或 Network Access。
nat_ip 字典	引用一个地址。与此实例关联的外部 IP 地址。指定可用于项目的未使用的静态外部 IP 地址，或保留此字段未定义以使用共享临时 IP 地址池中的 IP。如果您指定静态外部 IP 地址，它必须与实例的区域位于同一区域。此字段表示指向 GCP 中地址资源的链接。它可以通过两种方式指定。首先，您可以放置一个字典，其中键为 `address`，值为资源的地址。或者，您可以将 `register: name-of-resource` 添加到 `gcp_compute_address` 任务中，然后将此 nat_ip 字段设置为“{{ name-of-resource }}”。
network_tier 字符串	这表示用于配置此访问配置的网络层。如果指定了没有有效外部 IP 地址的 `AccessConfig`，则将使用此 `networkTier` 创建一个临时 IP。如果指定了带有有效外部 IP 地址的 `AccessConfig`，它必须与拥有该 IP 的地址资源的 `networkTier` 匹配。一些有效选项包括：“PREMIUM”、“STANDARD”
public_ptr_domain_name 字符串	公共 PTR 记录的 DNS 域名。只有在启用了 `setPublicPtr` 字段时，才能设置此字段。
set_public_ptr 布尔值	指定是否应创建公共 DNS PTR 记录以将实例的外部 IP 地址映射到 DNS 域名。选择 `false` `true`
type 字符串 / 必需	配置的类型。默认和唯一选项是 ONE_TO_ONE_NAT。一些有效选项包括：“ONE_TO_ONE_NAT”
alias_ip_ranges 列表 / 元素=字典	此网络接口的别名 IP 范围数组。只能为子网模式网络上的网络接口指定。
ip_cidr_range 字符串	此别名 IP 范围表示的 IP CIDR 范围。此 IP CIDR 范围必须属于指定的子网，并且不能包含系统保留的 IP 地址或被其他网络接口使用的 IP 地址。此范围可以是单个 IP 地址（例如 10.2.3.4）、子网掩码（例如 /24）或 CIDR 格式的字符串（例如 10.1.2.0/24）。
subnetwork_range_name 字符串	可选子网辅助范围名称，用于指定从中为此别名 IP 范围分配 IP CIDR 范围的辅助范围。如果未指定，将使用子网的主范围。
network 字典	指定现有网络的标题。不设置网络标题将选择默认网络接口，该接口可能已配置 SSH。此字段表示指向 GCP 中网络资源的链接。它可以通过两种方式指定。首先，您可以放置一个字典，其中键为 `selfLink`，值为资源的 `selfLink`。或者，您可以将 `register: name-of-resource` 添加到 `gcp_compute_network` 任务中，然后将此 network 字段设置为“{{ name-of-resource }}”。
network_ip 字符串	要为此网络接口分配给实例的 IPv4 内部网络地址。如果用户未指定，则系统会分配一个未使用的内部 IP。
subnetwork 字典	引用一个 VPC 网络。如果网络资源处于传统模式，请不要提供此属性。如果网络处于自动子网模式，则提供子网是可选的。如果网络处于自定义子网模式，则应指定此字段。此字段表示指向 GCP 中子网资源的链接。它可以通过两种方式指定。首先，您可以放置一个字典，其中键为 `selfLink`，值为资源的 `selfLink`。或者，您可以将 `register: name-of-resource` 添加到 `gcp_compute_subnetwork` 任务中，然后将此 subnetwork 字段设置为“{{ name-of-resource }}”。
project 字符串	要使用的 Google Cloud Platform 项目。
scheduling 字典	设置此实例的调度选项。
automatic_restart 布尔值	指定如果实例被 Compute Engine 终止（而不是由用户终止），是否应自动重启实例。您只能为标准实例设置自动重启选项。抢占式实例无法自动重启。选择 `false` `true`
on_host_maintenance 字符串	定义此实例的维护行为。对于标准实例，默认行为是 MIGRATE。对于抢占式实例，默认且唯一可能的行为是 TERMINATE。有关更多信息，请参阅设置实例调度选项。
preemptible 布尔值	定义实例是否为抢占式实例。只能在实例创建期间设置此项，创建实例后不能设置或更改此项。选择 `false` `true`
scopes 列表 / elements=string	要使用的作用域数组
service_account_contents jsonarg	服务帐户 JSON 文件的内容，可以是字典形式，也可以是表示它的 JSON 字符串。
service_account_email 字符串	如果选择 `machineaccount` 且用户不希望使用默认电子邮件，则可以使用可选的服务帐户电子邮件地址。
service_account_file path	如果选择 `serviceaccount` 作为类型，则为服务帐户 JSON 文件的路径。
service_accounts 列表 / 元素=字典	服务帐户列表及其指定的作用域，已授权用于此实例。每个虚拟机实例仅支持一个服务帐户。
email 字符串	服务帐户的电子邮件地址。
scopes 列表 / elements=string	要为此服务帐户提供的作用域列表。
shielded_instance_config 字典	有关受保护实例的各种参数的配置。
enable_integrity_monitoring 布尔值	定义是否为此实例启用了完整性监视。选择 `false` `true`
enable_secure_boot 布尔值	定义是否为此实例启用了安全启动。选择 `false` `true`
enable_vtpm 布尔值	定义是否为此实例启用了 vTPM。选择 `false` `true`
state 字符串	给定的对象是否应存在于 GCP 中选择 `"present"` ← (默认) `"absent"`
status 字符串	实例的状态。以下值之一：PROVISIONING、STAGING、RUNNING、STOPPING、SUSPENDING、SUSPENDED 和 TERMINATED。作为用户，请使用 RUNNING 来保持机器“开启”，使用 TERMINATED 来关闭机器。一些有效选项包括：“PROVISIONING”、“STAGING”、“RUNNING”、“STOPPING”、“SUSPENDING”、“SUSPENDED”、“TERMINATED”
tags 字典	要应用于此实例的标签列表。标签用于标识网络防火墙的有效源或目标，并由客户端在实例创建期间指定。标签可以通过 `setTags` 方法稍后修改。列表中的每个标签都必须符合 RFC1035 标准。
fingerprint 字符串	为此请求指定指纹，它本质上是元数据内容的哈希值，用于乐观锁定。指纹最初由 Compute Engine 生成，并且在每次修改或更新元数据的请求后都会更改。您必须始终提供最新的指纹哈希值才能更新或更改元数据。
items 列表 / elements=string	标签数组。每个标签的长度必须为 1-63 个字符，并且符合 RFC1035 标准。
zone 字符串 / 必需	对机器所在的区域的引用。

示例 

- name: create a disk
  google.cloud.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
  google.cloud.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
  google.cloud.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
  google.cloud.gcp_compute_instance:
    name: test_object
    machine_type: n1-standard-1
    disks:
    - auto_delete: 'true'
      boot: 'true'
      source: "{{ disk }}"
    - auto_delete: 'true'
      interface: NVME
      type: SCRATCH
      initialize_params:
        disk_type: local-ssd
    metadata:
      startup-script-url: gs:://graphite-playground/bootstrap.sh
      cost-center: '12345'
    labels:
      environment: production
    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 布尔值	允许此实例发送和接收具有不匹配的目标或源 IP 的数据包。如果您计划使用此实例转发路由，则这是必需的。已返回：成功
confidentialInstanceConfig 复杂	机密计算的配置（需要将机器类型设置为任何 n2d-* 类型，并将启动磁盘设置为 pd-ssd 类型）。已返回：成功
enableConfidentialCompute 布尔值	启用机密计算。已返回：成功
cpuPlatform 字符串	此实例使用的 CPU 平台。已返回：成功
creationTimestamp 字符串	RFC3339 文本格式的创建时间戳。已返回：成功
deletionProtection 布尔值	是否应保护资源免遭删除。已返回：成功
disks 复杂	与从此模板创建的实例关联的磁盘数组。已返回：成功
autoDelete 布尔值	指定在删除实例时（而不是在从实例分离磁盘时）是否会自动删除磁盘。提示：应将磁盘设置为 autoDelete=true，以便在删除机器时不会留下剩余磁盘。已返回：成功
boot 布尔值	指示这是一个启动磁盘。虚拟机将使用磁盘的第一个分区作为其根文件系统。已返回：成功
deviceName 字符串	指定您选择的唯一设备名称，该名称会反映到实例中运行的 Linux 操作系统的 /dev/disk/by-id/google-* 树中。此名称可用于从实例内部引用设备以进行挂载、调整大小等操作。已返回：成功
diskEncryptionKey 复杂	使用客户提供的加密密钥加密或解密磁盘。已返回：成功
rawKey 字符串	指定一个 256 位客户提供的加密密钥，以 RFC 4648 base64 编码，用于加密或解密此资源。已返回：成功
rsaEncryptedKey 字符串	指定一个 RFC 4648 base64 编码的、RSA 封装的 2048 位客户提供的加密密钥，用于加密或解密此资源。已返回：成功
sha256 字符串	受此资源保护的客户提供的加密密钥的 RFC 4648 base64 编码 SHA-256 哈希值。已返回：成功
index 整数	为此磁盘分配一个从零开始的索引，其中 0 保留给启动磁盘。例如，如果您有多个磁盘连接到实例，则每个磁盘都有一个唯一的索引号。如果未指定，服务器将选择一个适当的值。已返回：成功
initializeParams 复杂	指定将与新实例一起创建的新磁盘的参数。使用初始化参数创建连接到新实例的启动磁盘或本地 SSD。已返回：成功
diskName 字符串	指定磁盘名称。如果未指定，则默认使用实例的名称。已返回：成功
diskSizeGb 整数	指定磁盘的大小（以 2 为底的 GB 为单位）。已返回：成功
diskType 字符串	对磁盘类型的引用。指定用于创建实例的磁盘类型。如果未指定，则默认为 pd-standard。已返回：成功
sourceImage 字符串	用于创建此磁盘的源映像。创建新实例时，需要 initializeParams.sourceImage 或 disks.source 中的一个。要使用其中一个公共操作系统映像创建磁盘，请按其系列名称指定映像。已返回：成功
sourceImageEncryptionKey 复杂	源映像的客户提供的加密密钥。如果源映像受客户提供的加密密钥保护，则为必需项。实例模板不存储客户提供的加密密钥，因此如果源映像使用您自己的密钥加密，则无法为托管实例组中的实例创建磁盘。已返回：成功
rawKey 字符串	指定一个 256 位客户提供的加密密钥，以 RFC 4648 base64 编码，用于加密或解密此资源。已返回：成功
sha256 字符串	受此资源保护的客户提供的加密密钥的 RFC 4648 base64 编码 SHA-256 哈希值。已返回：成功
interface 字符串	指定用于连接此磁盘的磁盘接口，可以是 SCSI 或 NVME。默认值为 SCSI。持久磁盘必须始终使用 SCSI，并且如果您尝试以 SCSI 以外的任何其他格式连接持久磁盘，则请求将失败。已返回：成功
mode 字符串	连接此磁盘的模式，可以是 READ_WRITE 或 READ_ONLY。如果未指定，则默认为以 READ_WRITE 模式连接磁盘。已返回：成功
source 字典	引用一个磁盘。创建新实例时，需要 `initializeParams.sourceImage` 或 `disks.source` 之一。如果需要，您还可以使用此属性附加现有的非根持久磁盘。此字段仅适用于持久磁盘。已返回：成功
type 字符串	指定磁盘的类型，可以是 SCRATCH 或 PERSISTENT。如果未指定，则默认值为 PERSISTENT。已返回：成功
guestAccelerators 复杂	附加到实例的加速卡类型和数量的列表。已返回：成功
acceleratorCount 整数	暴露给此实例的访客加速卡数量。已返回：成功
acceleratorType 字符串	要暴露给此实例的加速器类型资源的完整或部分 URL。已返回：成功
hostname 字符串	要创建的实例的主机名。指定的主机名必须符合 RFC1035 标准。如果未指定主机名，则在使用全局 DNS 时，默认主机名为 [INSTANCE_NAME].c.[PROJECT_ID].internal；在使用区域 DNS 时，默认主机名为 [INSTANCE_NAME].[ZONE].c.[PROJECT_ID].internal。已返回：成功
id 整数	资源的唯一标识符。此标识符由服务器定义。已返回：成功
labelFingerprint 字符串	用于此资源乐观锁定的指纹。在更新期间内部使用。已返回：成功
labels 字典	要应用于此实例的标签。键值对列表。已返回：成功
machineType 字符串	对定义虚拟机类型的机器类型的引用。有关当前有效机器类型的列表，请参阅 https://cloud.google.com/compute/docs/machine-types。已返回：成功
metadata 字典	要分配给从此模板创建的实例的元数据键/值对。这些对可以包含自定义元数据或预定义的键。已返回：成功
minCpuPlatform 字符串	指定虚拟机实例的最低 CPU 平台。适用的值是 CPU 平台的友好名称。已返回：成功
name 字符串	资源名称，由客户端在最初创建资源时提供。资源名称长度必须为 1-63 个字符，并且符合 RFC1035 标准。具体来说，名称长度必须为 1-63 个字符，并且与正则表达式 `[a-z]([-a-z0-9][a-z0-9])?` 匹配，这意味着第一个字符必须是小写字母，所有后续字符必须是短划线、小写字母或数字，但最后一个字符不能是短划线。已返回：* 成功
networkInterfaces 复杂	此接口的配置数组。它指定此接口如何配置为与其他网络服务交互，例如连接到互联网。每个实例仅支持一个网络接口。已返回：成功
accessConfigs 复杂	此接口的配置数组。目前，仅支持一个访问配置，即 ONE_TO_ONE_NAT。如果没有指定 `accessConfigs`，则此实例将没有外部互联网访问。已返回：成功
name 字符串	此访问配置的名称。默认且推荐的名称是 External NAT，但您可以使用任何您喜欢的任意字符串。例如，My external IP 或 Network Access。已返回：成功
natIP 字典	引用一个地址。与此实例关联的外部 IP 地址。指定可用于项目的未使用的静态外部 IP 地址，或保留此字段未定义以使用共享临时 IP 地址池中的 IP。如果您指定静态外部 IP 地址，它必须与实例的区域位于同一区域。已返回：成功
networkTier 字符串	这表示用于配置此访问配置的网络层。如果指定了没有有效外部 IP 地址的 `AccessConfig`，则将使用此 `networkTier` 创建一个临时 IP。如果指定了带有有效外部 IP 地址的 `AccessConfig`，它必须与拥有该 IP 的地址资源的 `networkTier` 匹配。已返回：成功
publicPtrDomainName 字符串	公共 PTR 记录的 DNS 域名。只有在启用了 `setPublicPtr` 字段时，才能设置此字段。已返回：成功
setPublicPtr 布尔值	指定是否应创建公共 DNS PTR 记录以将实例的外部 IP 地址映射到 DNS 域名。已返回：成功
type 字符串	配置的类型。默认和唯一选项是 ONE_TO_ONE_NAT。已返回：成功
aliasIpRanges 复杂	此网络接口的别名 IP 范围数组。只能为子网模式网络上的网络接口指定。已返回：成功
ipCidrRange 字符串	此别名 IP 范围表示的 IP CIDR 范围。此 IP CIDR 范围必须属于指定的子网，并且不能包含系统保留的 IP 地址或被其他网络接口使用的 IP 地址。此范围可以是单个 IP 地址（例如 10.2.3.4）、子网掩码（例如 /24）或 CIDR 格式的字符串（例如 10.1.2.0/24）。已返回：成功
子网范围名称字符串	可选子网辅助范围名称，用于指定从中为此别名 IP 范围分配 IP CIDR 范围的辅助范围。如果未指定，将使用子网的主范围。已返回：成功
name 字符串	服务器生成的网络接口名称。对于网络设备，这些名称为 eth0、eth1 等。已返回：成功
network 字典	指定现有网络的标题。不设置网络标题将选择默认网络接口，该接口可能已配置 SSH。已返回：成功
网络 IP 字符串	要为此网络接口分配给实例的 IPv4 内部网络地址。如果用户未指定，则系统会分配一个未使用的内部 IP。已返回：成功
subnetwork 字典	引用一个 VPC 网络。如果网络资源处于传统模式，请不要提供此属性。如果网络处于自动子网模式，则提供子网是可选的。如果网络处于自定义子网模式，则应指定此字段。已返回：成功
scheduling 复杂	设置此实例的调度选项。已返回：成功
自动重启布尔值	指定如果实例被 Compute Engine 终止（而不是由用户终止），是否应自动重启实例。您只能为标准实例设置自动重启选项。抢占式实例无法自动重启。已返回：成功
主机维护时操作字符串	定义此实例的维护行为。对于标准实例，默认行为是 MIGRATE。对于抢占式实例，默认且唯一可能的行为是 TERMINATE。有关更多信息，请参阅设置实例调度选项。已返回：成功
preemptible 布尔值	定义实例是否为抢占式实例。只能在实例创建期间设置此项，创建实例后不能设置或更改此项。已返回：成功
服务账号复杂	服务帐户列表及其指定的作用域，已授权用于此实例。每个虚拟机实例仅支持一个服务帐户。已返回：成功
email 字符串	服务帐户的电子邮件地址。已返回：成功
scopes 列表 / elements=string	要为此服务帐户提供的作用域列表。已返回：成功
屏蔽实例配置复杂	有关受保护实例的各种参数的配置。已返回：成功
启用完整性监控布尔值	定义是否为此实例启用了完整性监视。已返回：成功
启用安全启动布尔值	定义是否为此实例启用了安全启动。已返回：成功
启用 vTPM 布尔值	定义是否为此实例启用了 vTPM。已返回：成功
status 字符串	实例的状态。以下值之一：PROVISIONING、STAGING、RUNNING、STOPPING、SUSPENDING、SUSPENDED 和 TERMINATED。作为用户，请使用 RUNNING 来保持机器“开启”，使用 TERMINATED 来关闭机器。已返回：成功
状态消息字符串	对状态的可选的人工可读解释。已返回：成功
tags 复杂	要应用于此实例的标签列表。标签用于标识网络防火墙的有效源或目标，并由客户端在实例创建期间指定。标签可以通过 `setTags` 方法稍后修改。列表中的每个标签都必须符合 RFC1035 标准。已返回：成功
fingerprint 字符串	为此请求指定指纹，它本质上是元数据内容的哈希值，用于乐观锁定。指纹最初由 Compute Engine 生成，并且在每次修改或更新元数据的请求后都会更改。您必须始终提供最新的指纹哈希值才能更新或更改元数据。已返回：成功
items 列表 / elements=string	标签数组。每个标签的长度必须为 1-63 个字符，并且符合 RFC1035 标准。已返回：成功
zone 字符串	对机器所在的区域的引用。已返回：成功

作者

Google Inc. (@googlecloudplatform)