Class InstanceState

Inheritance

System.Object

InputArgs

ResourceArgs

InstanceState

Inherited Members

ResourceArgs.Empty

System.Object.Equals(System.Object)

System.Object.Equals(System.Object, System.Object)

System.Object.GetHashCode()

System.Object.GetType()

System.Object.MemberwiseClone()

System.Object.ReferenceEquals(System.Object, System.Object)

System.Object.ToString()

Namespace: Pulumi.Gcp.Compute

Assembly: Pulumi.Gcp.dll

Syntax

public sealed class InstanceState : ResourceArgs

Constructors

InstanceState()

Declaration

public InstanceState()

Properties

AllowStoppingForUpdate

If true, allows this prvider to stop the instance to update its properties. If you try to update a property that requires stopping the instance without setting this field, the update will fail.

Declaration

public Input<bool> AllowStoppingForUpdate { get; set; }

Property Value

Type	Description
Input<System.Boolean>

AttachedDisks

Additional disks to attach to the instance. Can be repeated multiple times for multiple disks. Structure is documented below.

Declaration

public InputList<InstanceAttachedDiskGetArgs> AttachedDisks { get; set; }

Property Value

Type	Description
InputList<InstanceAttachedDiskGetArgs>

BootDisk

The boot disk for the instance. Structure is documented below.

Declaration

public Input<InstanceBootDiskGetArgs> BootDisk { get; set; }

Property Value

Type	Description
Input<InstanceBootDiskGetArgs>

CanIpForward

Whether to allow sending and receiving of packets with non-matching source or destination IPs. This defaults to false.

Declaration

public Input<bool> CanIpForward { get; set; }

Property Value

Type	Description
Input<System.Boolean>

CpuPlatform

The CPU platform used by this instance.

Declaration

public Input<string> CpuPlatform { get; set; }

Property Value

Type	Description
Input<System.String>

CurrentStatus

Declaration

public Input<string> CurrentStatus { get; set; }

Property Value

Type	Description
Input<System.String>

DeletionProtection

Enable deletion protection on this instance. Defaults to false. Note: you must disable deletion protection before removing the resource (e.g., via pulumi destroy), or the instance cannot be deleted and the provider run will not complete successfully.

Declaration

public Input<bool> DeletionProtection { get; set; }

Property Value

Type	Description
Input<System.Boolean>

Description

A brief description of this resource.

Declaration

public Input<string> Description { get; set; }

Property Value

Type	Description
Input<System.String>

DesiredStatus

Desired status of the instance. Either "RUNNING" or "TERMINATED".

Declaration

public Input<string> DesiredStatus { get; set; }

Property Value

Type	Description
Input<System.String>

EnableDisplay

Enable Virtual Displays on this instance. Note: allow_stopping_for_update must be set to true or your instance must have a desired_status of TERMINATED in order to update this field.

Declaration

public Input<bool> EnableDisplay { get; set; }

Property Value

Type	Description
Input<System.Boolean>

GuestAccelerators

List of the type and count of accelerator cards attached to the instance. Structure documented below. Note: GPU accelerators can only be used with on_host_maintenance option set to TERMINATE.

Declaration

public InputList<InstanceGuestAcceleratorGetArgs> GuestAccelerators { get; set; }

Property Value

Type	Description
InputList<InstanceGuestAcceleratorGetArgs>

Hostname

A custom hostname for the instance. Must be a fully qualified DNS name and RFC-1035-valid. Valid format is a series of labels 1-63 characters long matching the regular expression a-z, concatenated with periods. The entire hostname must not exceed 253 characters. Changing this forces a new resource to be created.

Declaration

public Input<string> Hostname { get; set; }

Property Value

Type	Description
Input<System.String>

InstanceId

The server-assigned unique identifier of this instance.

Declaration

public Input<string> InstanceId { get; set; }

Property Value

Type	Description
Input<System.String>

LabelFingerprint

The unique fingerprint of the labels.

Declaration

public Input<string> LabelFingerprint { get; set; }

Property Value

Type	Description
Input<System.String>

Labels

A map of key/value label pairs to assign to the instance.

Declaration

public InputMap<string> Labels { get; set; }

Property Value

Type	Description
InputMap<System.String>

MachineType

The machine type to create.

Declaration

public Input<string> MachineType { get; set; }

Property Value

Type	Description
Input<System.String>

Metadata

Metadata key/value pairs to make available from within the instance. Ssh keys attached in the Cloud Console will be removed. Add them to your config in order to keep them attached to your instance.

Declaration

public InputMap<string> Metadata { get; set; }

Property Value

Type	Description
InputMap<System.String>

MetadataFingerprint

The unique fingerprint of the metadata.

Declaration

public Input<string> MetadataFingerprint { get; set; }

Property Value

Type	Description
Input<System.String>

MetadataStartupScript

An alternative to using the startup-script metadata key, except this one forces the instance to be recreated (thus re-running the script) if it is changed. This replaces the startup-script metadata key on the created instance and thus the two mechanisms are not allowed to be used simultaneously. Users are free to use either mechanism - the only distinction is that this separate attribute willl cause a recreate on modification. On import, metadata_startup_script will be set, but metadata.startup-script will not - if you choose to use the other mechanism, you will see a diff immediately after import, which will cause a destroy/recreate operation. You may want to modify your state file manually using pulumi stack commands, depending on your use case.

Declaration

public Input<string> MetadataStartupScript { get; set; }

Property Value

Type	Description
Input<System.String>

MinCpuPlatform

Specifies a minimum CPU platform for the VM instance. Applicable values are the friendly names of CPU platforms, such as Intel Haswell or Intel Skylake. See the complete list here. Note: allow_stopping_for_update must be set to true or your instance must have a desired_status of TERMINATED in order to update this field.

Declaration

public Input<string> MinCpuPlatform { get; set; }

Property Value

Type	Description
Input<System.String>

Name

A unique name for the resource, required by GCE. Changing this forces a new resource to be created.

Declaration

public Input<string> Name { get; set; }

Property Value

Type	Description
Input<System.String>

NetworkInterfaces

Networks to attach to the instance. This can be specified multiple times. Structure is documented below.

Declaration

public InputList<InstanceNetworkInterfaceGetArgs> NetworkInterfaces { get; set; }

Property Value

Type	Description
InputList<InstanceNetworkInterfaceGetArgs>

Project

The ID of the project in which the resource belongs. If it is not provided, the provider project is used.

Declaration

public Input<string> Project { get; set; }

Property Value

Type	Description
Input<System.String>

ResourcePolicies

-- A list of short names or self_links of resource policies to attach to the instance. Modifying this list will cause the instance to recreate. Currently a max of 1 resource policy is supported.

Declaration

public Input<string> ResourcePolicies { get; set; }

Property Value

Type	Description
Input<System.String>

Scheduling

The scheduling strategy to use. More details about this configuration option are detailed below.

Declaration

public Input<InstanceSchedulingGetArgs> Scheduling { get; set; }

Property Value

Type	Description
Input<InstanceSchedulingGetArgs>

ScratchDisks

Scratch disks to attach to the instance. This can be specified multiple times for multiple scratch disks. Structure is documented below.

Declaration

public InputList<InstanceScratchDiskGetArgs> ScratchDisks { get; set; }

Property Value

Type	Description
InputList<InstanceScratchDiskGetArgs>

SelfLink

The URI of the created resource.

Declaration

public Input<string> SelfLink { get; set; }

Property Value

Type	Description
Input<System.String>

ServiceAccount

Service account to attach to the instance. Structure is documented below. Note: allow_stopping_for_update must be set to true or your instance must have a desired_status of TERMINATED in order to update this field.

Declaration

public Input<InstanceServiceAccountGetArgs> ServiceAccount { get; set; }

Property Value

Type	Description
Input<InstanceServiceAccountGetArgs>

ShieldedInstanceConfig

Enable Shielded VM on this instance. Shielded VM provides verifiable integrity to prevent against malware and rootkits. Defaults to disabled. Structure is documented below. Note: shielded_instance_config can only be used with boot images with shielded vm support. See the complete list here.

Declaration

public Input<InstanceShieldedInstanceConfigGetArgs> ShieldedInstanceConfig { get; set; }

Property Value

Type	Description
Input<InstanceShieldedInstanceConfigGetArgs>

Tags

A list of tags to attach to the instance.

Declaration

public InputList<string> Tags { get; set; }

Property Value

Type	Description
InputList<System.String>

TagsFingerprint

The unique fingerprint of the tags.

Declaration

public Input<string> TagsFingerprint { get; set; }

Property Value

Type	Description
Input<System.String>

Zone

The zone that the machine should be created in.

Declaration

public Input<string> Zone { get; set; }

Property Value

Type	Description
Input<System.String>