Package com.pulumi.gcp.compute

Class RegionInstanceTemplate

  • public class RegionInstanceTemplate
extends com.pulumi.resources.CustomResource
    ## Import Instance templates can be imported using any of these accepted formats ```sh $ pulumi import gcp:compute/regionInstanceTemplate:RegionInstanceTemplate default projects/{{project}}/regions/{{region}}/instanceTemplates/{{name}} ``` ```sh $ pulumi import gcp:compute/regionInstanceTemplate:RegionInstanceTemplate default {{project}}/{{name}} ``` ```sh $ pulumi import gcp:compute/regionInstanceTemplate:RegionInstanceTemplate default {{name}} ``` [custom-vm-types]https://cloud.google.com/dataproc/docs/concepts/compute/custom-machine-types [network-tier]https://cloud.google.com/network-tiers/docs/overview

    • Constructor Detail

      • RegionInstanceTemplate

        public RegionInstanceTemplate​(java.lang.String name)
        Parameters:
        name - The _unique_ name of the resulting resource.

      • RegionInstanceTemplate

        public RegionInstanceTemplate​(java.lang.String name,
                              RegionInstanceTemplateArgs args)
        Parameters:
        name - The _unique_ name of the resulting resource.
        args - The arguments to use to populate this resource's properties.

      • RegionInstanceTemplate

        public RegionInstanceTemplate​(java.lang.String name,
                              RegionInstanceTemplateArgs args,
                              @Nullable
                              com.pulumi.resources.CustomResourceOptions options)
        Parameters:
        name - The _unique_ name of the resulting resource.
        args - The arguments to use to populate this resource's properties.
        options - A bag of options that control this resource's behavior.

    • Method Detail

      • advancedMachineFeatures

        public com.pulumi.core.Output<java.util.Optional<RegionInstanceTemplateAdvancedMachineFeatures>> advancedMachineFeatures()
        Returns:
        Configure Nested Virtualisation and Simultaneous Hyper Threading on this VM. Structure is documented below

      • canIpForward

        public com.pulumi.core.Output<java.util.Optional<java.lang.Boolean>> canIpForward()
        Returns:
        Whether to allow sending and receiving of packets with non-matching source or destination IPs. This defaults to false.

      • confidentialInstanceConfig

        public com.pulumi.core.Output<RegionInstanceTemplateConfidentialInstanceConfig> confidentialInstanceConfig()
        Returns:
        Enable [Confidential Mode](https://cloud.google.com/compute/confidential-vm/docs/about-cvm) on this VM. Structure is documented below

      • description

        public com.pulumi.core.Output<java.util.Optional<java.lang.String>> description()
        Returns:
        A brief description of this resource.

      • disks

        public com.pulumi.core.Output<java.util.List<RegionInstanceTemplateDisk>> disks()
        Returns:
        Disks to attach to instances created from this template. This can be specified multiple times for multiple disks. Structure is documented below.

      • enableDisplay

        public com.pulumi.core.Output<java.util.Optional<java.lang.Boolean>> enableDisplay()
        Returns:
        Enable [Virtual Displays](https://cloud.google.com/compute/docs/instances/enable-instance-virtual-display#verify_display_driver) on this instance. **Note**: `allow_stopping_for_update` must be set to true in order to update this field.

      • guestAccelerators

        public com.pulumi.core.Output<java.util.Optional<java.util.List<RegionInstanceTemplateGuestAccelerator>>> guestAccelerators()
        Returns:
        List of the type and count of accelerator cards attached to the instance. Structure documented below.

      • instanceDescription

        public com.pulumi.core.Output<java.util.Optional<java.lang.String>> instanceDescription()
        Returns:
        A brief description to use for instances created from this template.

      • labels

        public com.pulumi.core.Output<java.util.Optional<java.util.Map<java.lang.String,​java.lang.String>>> labels()
        Returns:
        A set of key/value label pairs to assign to instances created from this template.

      • machineType

        public com.pulumi.core.Output<java.lang.String> machineType()
        Returns:
        The machine type to create. To create a machine with a [custom type][custom-vm-types] (such as extended memory), format the value like `custom-VCPUS-MEM_IN_MB` like `custom-6-20480` for 6 vCPU and 20GB of RAM. ***

      • metadata

        public com.pulumi.core.Output<java.util.Optional<java.util.Map<java.lang.String,​java.lang.Object>>> metadata()
        Returns:
        Metadata key/value pairs to make available from within instances created from this template.

      • metadataFingerprint

        public com.pulumi.core.Output<java.lang.String> metadataFingerprint()
        Returns:
        The unique fingerprint of the metadata.

      • metadataStartupScript

        public com.pulumi.core.Output<java.util.Optional<java.lang.String>> metadataStartupScript()
        Returns:
        An alternative to using the startup-script metadata key, mostly to match the compute_instance resource. This replaces the startup-script metadata key on the created instance and thus the two mechanisms are not allowed to be used simultaneously.

      • minCpuPlatform

        public com.pulumi.core.Output<java.util.Optional<java.lang.String>> minCpuPlatform()
        Returns:
        Specifies a minimum CPU platform. Applicable values are the friendly names of CPU platforms, such as `Intel Haswell` or `Intel Skylake`. See the complete list [here](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform).

      • name

        public com.pulumi.core.Output<java.lang.String> name()
        Returns:
        The name of the instance template. If you leave this blank, Terraform will auto-generate a unique name.

      • namePrefix

        public com.pulumi.core.Output<java.lang.String> namePrefix()
        Returns:
        Creates a unique name beginning with the specified prefix. Conflicts with `name`.

      • networkInterfaces

        public com.pulumi.core.Output<java.util.Optional<java.util.List<RegionInstanceTemplateNetworkInterface>>> networkInterfaces()
        Returns:
        Networks to attach to instances created from this template. This can be specified multiple times for multiple networks. Structure is documented below.

      • networkPerformanceConfig

        public com.pulumi.core.Output<java.util.Optional<RegionInstanceTemplateNetworkPerformanceConfig>> networkPerformanceConfig()
        Returns:
        Configures network performance settings for the instance created from the template. Structure is documented below. **Note**: `machine_type` must be a [supported type](https://cloud.google.com/compute/docs/networking/configure-vm-with-high-bandwidth-configuration), the `image` used must include the [`GVNIC`](https://cloud.google.com/compute/docs/networking/using-gvnic#create-instance-gvnic-image) in `guest-os-features`, and `network_interface.0.nic-type` must be `GVNIC` in order for this setting to take effect.

      • project

        public com.pulumi.core.Output<java.lang.String> project()
        Returns:
        The ID of the project in which the resource belongs. If it is not provided, the provider project is used.

      • region

        public com.pulumi.core.Output<java.lang.String> region()
        Returns:
        The Region in which the resource belongs. If region is not provided, the provider region is used.

      • reservationAffinity

        public com.pulumi.core.Output<java.util.Optional<RegionInstanceTemplateReservationAffinity>> reservationAffinity()
        Returns:
        Specifies the reservations that this instance can consume from. Structure is documented below.

      • resourcePolicies

        public com.pulumi.core.Output<java.util.Optional<java.lang.String>> resourcePolicies()
        Returns:
        - A list of 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.

      • scheduling

        public com.pulumi.core.Output<RegionInstanceTemplateScheduling> scheduling()
        Returns:
        The scheduling strategy to use. More details about this configuration option are detailed below.

      • selfLink

        public com.pulumi.core.Output<java.lang.String> selfLink()
        Returns:
        The URI of the created resource.

      • serviceAccount

        public com.pulumi.core.Output<java.util.Optional<RegionInstanceTemplateServiceAccount>> serviceAccount()
        Returns:
        Service account to attach to the instance. Structure is documented below.

      • shieldedInstanceConfig

        public com.pulumi.core.Output<RegionInstanceTemplateShieldedInstanceConfig> shieldedInstanceConfig()
        Returns:
        Enable [Shielded VM](https://cloud.google.com/security/shielded-cloud/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](https://cloud.google.com/compute/docs/images#shielded-images).

      • tags

        public com.pulumi.core.Output<java.util.Optional<java.util.List<java.lang.String>>> tags()
        Returns:
        Tags to attach to the instance.

      • tagsFingerprint

        public com.pulumi.core.Output<java.lang.String> tagsFingerprint()
        Returns:
        The unique fingerprint of the tags.

      • get

        public static RegionInstanceTemplate get​(java.lang.String name,
                                         com.pulumi.core.Output<java.lang.String> id,
                                         @Nullable
                                         RegionInstanceTemplateState state,
                                         @Nullable
                                         com.pulumi.resources.CustomResourceOptions options)
        Get an existing Host resource's state with the given name, ID, and optional extra properties used to qualify the lookup.
        Parameters:
        name - The _unique_ name of the resulting resource.
        id - The _unique_ provider ID of the resource to lookup.
        state -
        options - Optional settings to control the behavior of the CustomResource.