Class ComputeInstanceFromTemplate.Builder

    • Method Detail

      • connection

        @Stability(Experimental)
        public ComputeInstanceFromTemplate.Builder connection​(com.hashicorp.cdktf.SSHProvisionerConnection connection)
        Parameters:
        connection - This parameter is required.
        Returns:
        this
      • connection

        @Stability(Experimental)
        public ComputeInstanceFromTemplate.Builder connection​(com.hashicorp.cdktf.WinrmProvisionerConnection connection)
        Parameters:
        connection - This parameter is required.
        Returns:
        this
      • count

        @Stability(Experimental)
        public ComputeInstanceFromTemplate.Builder count​(com.hashicorp.cdktf.TerraformCount count)
        Parameters:
        count - This parameter is required.
        Returns:
        this
      • dependsOn

        @Stability(Experimental)
        public ComputeInstanceFromTemplate.Builder dependsOn​(List<? extends com.hashicorp.cdktf.ITerraformDependable> dependsOn)
        Parameters:
        dependsOn - This parameter is required.
        Returns:
        this
      • forEach

        @Stability(Experimental)
        public ComputeInstanceFromTemplate.Builder forEach​(com.hashicorp.cdktf.ITerraformIterator forEach)
        Parameters:
        forEach - This parameter is required.
        Returns:
        this
      • lifecycle

        @Stability(Experimental)
        public ComputeInstanceFromTemplate.Builder lifecycle​(com.hashicorp.cdktf.TerraformResourceLifecycle lifecycle)
        Parameters:
        lifecycle - This parameter is required.
        Returns:
        this
      • provider

        @Stability(Experimental)
        public ComputeInstanceFromTemplate.Builder provider​(com.hashicorp.cdktf.TerraformProvider provider)
        Parameters:
        provider - This parameter is required.
        Returns:
        this
      • name

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder name​(String name)
        The name of the instance. One of name or self_link must be provided.

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#name ComputeInstanceFromTemplate#name}

        Parameters:
        name - The name of the instance. One of name or self_link must be provided. This parameter is required.
        Returns:
        this
      • sourceInstanceTemplate

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder sourceInstanceTemplate​(String sourceInstanceTemplate)
        Name or self link of an instance template to create the instance based on.

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#source_instance_template ComputeInstanceFromTemplate#source_instance_template}

        Parameters:
        sourceInstanceTemplate - Name or self link of an instance template to create the instance based on. This parameter is required.
        Returns:
        this
      • advancedMachineFeatures

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder advancedMachineFeatures​(ComputeInstanceFromTemplateAdvancedMachineFeatures advancedMachineFeatures)
        advanced_machine_features block.

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#advanced_machine_features ComputeInstanceFromTemplate#advanced_machine_features}

        Parameters:
        advancedMachineFeatures - advanced_machine_features block. This parameter is required.
        Returns:
        this
      • allowStoppingForUpdate

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder allowStoppingForUpdate​(Boolean allowStoppingForUpdate)
        If true, allows Terraform 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. Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#allow_stopping_for_update ComputeInstanceFromTemplate#allow_stopping_for_update}

        Parameters:
        allowStoppingForUpdate - If true, allows Terraform to stop the instance to update its properties. This parameter is required.
        Returns:
        this
      • allowStoppingForUpdate

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder allowStoppingForUpdate​(com.hashicorp.cdktf.IResolvable allowStoppingForUpdate)
        If true, allows Terraform 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. Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#allow_stopping_for_update ComputeInstanceFromTemplate#allow_stopping_for_update}

        Parameters:
        allowStoppingForUpdate - If true, allows Terraform to stop the instance to update its properties. This parameter is required.
        Returns:
        this
      • attachedDisk

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder attachedDisk​(com.hashicorp.cdktf.IResolvable attachedDisk)
        List of disks attached to the instance.

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#attached_disk ComputeInstanceFromTemplate#attached_disk}

        Parameters:
        attachedDisk - List of disks attached to the instance. This parameter is required.
        Returns:
        this
      • attachedDisk

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder attachedDisk​(List<? extends ComputeInstanceFromTemplateAttachedDisk> attachedDisk)
        List of disks attached to the instance.

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#attached_disk ComputeInstanceFromTemplate#attached_disk}

        Parameters:
        attachedDisk - List of disks attached to the instance. This parameter is required.
        Returns:
        this
      • bootDisk

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder bootDisk​(ComputeInstanceFromTemplateBootDisk bootDisk)
        boot_disk block.

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#boot_disk ComputeInstanceFromTemplate#boot_disk}

        Parameters:
        bootDisk - boot_disk block. This parameter is required.
        Returns:
        this
      • canIpForward

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder canIpForward​(Boolean canIpForward)
        Whether sending and receiving of packets with non-matching source or destination IPs is allowed.

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#can_ip_forward ComputeInstanceFromTemplate#can_ip_forward}

        Parameters:
        canIpForward - Whether sending and receiving of packets with non-matching source or destination IPs is allowed. This parameter is required.
        Returns:
        this
      • canIpForward

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder canIpForward​(com.hashicorp.cdktf.IResolvable canIpForward)
        Whether sending and receiving of packets with non-matching source or destination IPs is allowed.

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#can_ip_forward ComputeInstanceFromTemplate#can_ip_forward}

        Parameters:
        canIpForward - Whether sending and receiving of packets with non-matching source or destination IPs is allowed. This parameter is required.
        Returns:
        this
      • confidentialInstanceConfig

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder confidentialInstanceConfig​(ComputeInstanceFromTemplateConfidentialInstanceConfig confidentialInstanceConfig)
        confidential_instance_config block.

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#confidential_instance_config ComputeInstanceFromTemplate#confidential_instance_config}

        Parameters:
        confidentialInstanceConfig - confidential_instance_config block. This parameter is required.
        Returns:
        this
      • deletionProtection

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder deletionProtection​(Boolean deletionProtection)
        Whether deletion protection is enabled on this instance.

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#deletion_protection ComputeInstanceFromTemplate#deletion_protection}

        Parameters:
        deletionProtection - Whether deletion protection is enabled on this instance. This parameter is required.
        Returns:
        this
      • deletionProtection

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder deletionProtection​(com.hashicorp.cdktf.IResolvable deletionProtection)
        Whether deletion protection is enabled on this instance.

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#deletion_protection ComputeInstanceFromTemplate#deletion_protection}

        Parameters:
        deletionProtection - Whether deletion protection is enabled on this instance. This parameter is required.
        Returns:
        this
      • description

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder description​(String description)
        A brief description of the resource.

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#description ComputeInstanceFromTemplate#description}

        Parameters:
        description - A brief description of the resource. This parameter is required.
        Returns:
        this
      • desiredStatus

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder desiredStatus​(String desiredStatus)
        Desired status of the instance. Either "RUNNING" or "TERMINATED".

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#desired_status ComputeInstanceFromTemplate#desired_status}

        Parameters:
        desiredStatus - Desired status of the instance. Either "RUNNING" or "TERMINATED". This parameter is required.
        Returns:
        this
      • enableDisplay

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder enableDisplay​(Boolean enableDisplay)
        Whether the instance has virtual displays enabled.

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#enable_display ComputeInstanceFromTemplate#enable_display}

        Parameters:
        enableDisplay - Whether the instance has virtual displays enabled. This parameter is required.
        Returns:
        this
      • enableDisplay

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder enableDisplay​(com.hashicorp.cdktf.IResolvable enableDisplay)
        Whether the instance has virtual displays enabled.

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#enable_display ComputeInstanceFromTemplate#enable_display}

        Parameters:
        enableDisplay - Whether the instance has virtual displays enabled. This parameter is required.
        Returns:
        this
      • guestAccelerator

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder guestAccelerator​(com.hashicorp.cdktf.IResolvable guestAccelerator)
        List of the type and count of accelerator cards attached to the instance.

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#guest_accelerator ComputeInstanceFromTemplate#guest_accelerator}

        Parameters:
        guestAccelerator - List of the type and count of accelerator cards attached to the instance. This parameter is required.
        Returns:
        this
      • guestAccelerator

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder guestAccelerator​(List<? extends ComputeInstanceFromTemplateGuestAccelerator> guestAccelerator)
        List of the type and count of accelerator cards attached to the instance.

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#guest_accelerator ComputeInstanceFromTemplate#guest_accelerator}

        Parameters:
        guestAccelerator - List of the type and count of accelerator cards attached to the instance. This parameter is required.
        Returns:
        this
      • hostname

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder hostname​(String 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](%5B-a-z0-9%5D*%5Ba-z0-9%5D), concatenated with periods. The entire hostname must not exceed 253 characters. Changing this forces a new resource to be created. Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#hostname ComputeInstanceFromTemplate#hostname}

        Parameters:
        hostname - A custom hostname for the instance. This parameter is required.
        Returns:
        this
      • id

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder id​(String id)
        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#id ComputeInstanceFromTemplate#id}.

        Please be aware that the id field is automatically added to all resources in Terraform providers using a Terraform provider SDK version below 2. If you experience problems setting this value it might not be settable. Please take a look at the provider documentation to ensure it should be settable.

        Parameters:
        id - Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#id ComputeInstanceFromTemplate#id}. This parameter is required.
        Returns:
        this
      • labels

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder labels​(Map<String,​String> labels)
        A set of key/value label pairs assigned to the instance.

        **Note**: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field 'effective_labels' for all of the labels present on the resource. Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#labels ComputeInstanceFromTemplate#labels}

        Parameters:
        labels - A set of key/value label pairs assigned to the instance. This parameter is required.
        Returns:
        this
      • machineType

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder machineType​(String machineType)
        The machine type to create.

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#machine_type ComputeInstanceFromTemplate#machine_type}

        Parameters:
        machineType - The machine type to create. This parameter is required.
        Returns:
        this
      • metadata

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder metadata​(Map<String,​String> metadata)
        Metadata key/value pairs made available within the instance.

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#metadata ComputeInstanceFromTemplate#metadata}

        Parameters:
        metadata - Metadata key/value pairs made available within the instance. This parameter is required.
        Returns:
        this
      • metadataStartupScript

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder metadataStartupScript​(String metadataStartupScript)
        Metadata startup scripts made available within the instance.

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#metadata_startup_script ComputeInstanceFromTemplate#metadata_startup_script}

        Parameters:
        metadataStartupScript - Metadata startup scripts made available within the instance. This parameter is required.
        Returns:
        this
      • minCpuPlatform

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder minCpuPlatform​(String minCpuPlatform)
        The minimum CPU platform specified for the VM instance.

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#min_cpu_platform ComputeInstanceFromTemplate#min_cpu_platform}

        Parameters:
        minCpuPlatform - The minimum CPU platform specified for the VM instance. This parameter is required.
        Returns:
        this
      • networkInterface

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder networkInterface​(com.hashicorp.cdktf.IResolvable networkInterface)
        network_interface block.

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#network_interface ComputeInstanceFromTemplate#network_interface}

        Parameters:
        networkInterface - network_interface block. This parameter is required.
        Returns:
        this
      • networkInterface

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder networkInterface​(List<? extends ComputeInstanceFromTemplateNetworkInterface> networkInterface)
        network_interface block.

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#network_interface ComputeInstanceFromTemplate#network_interface}

        Parameters:
        networkInterface - network_interface block. This parameter is required.
        Returns:
        this
      • networkPerformanceConfig

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder networkPerformanceConfig​(ComputeInstanceFromTemplateNetworkPerformanceConfig networkPerformanceConfig)
        network_performance_config block.

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#network_performance_config ComputeInstanceFromTemplate#network_performance_config}

        Parameters:
        networkPerformanceConfig - network_performance_config block. This parameter is required.
        Returns:
        this
      • params

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder params​(ComputeInstanceFromTemplateParams params)
        params block.

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#params ComputeInstanceFromTemplate#params}

        Parameters:
        params - params block. This parameter is required.
        Returns:
        this
      • project

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder project​(String project)
        The ID of the project in which the resource belongs.

        If self_link is provided, this value is ignored. If neither self_link nor project are provided, the provider project is used. Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#project ComputeInstanceFromTemplate#project}

        Parameters:
        project - The ID of the project in which the resource belongs. This parameter is required.
        Returns:
        this
      • reservationAffinity

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder reservationAffinity​(ComputeInstanceFromTemplateReservationAffinity reservationAffinity)
        reservation_affinity block.

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#reservation_affinity ComputeInstanceFromTemplate#reservation_affinity}

        Parameters:
        reservationAffinity - reservation_affinity block. This parameter is required.
        Returns:
        this
      • resourcePolicies

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder resourcePolicies​(List<String> resourcePolicies)
        A list of self_links of resource policies to attach to the instance.

        Currently a max of 1 resource policy is supported. Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#resource_policies ComputeInstanceFromTemplate#resource_policies}

        Parameters:
        resourcePolicies - A list of self_links of resource policies to attach to the instance. This parameter is required.
        Returns:
        this
      • scheduling

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder scheduling​(ComputeInstanceFromTemplateScheduling scheduling)
        scheduling block.

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#scheduling ComputeInstanceFromTemplate#scheduling}

        Parameters:
        scheduling - scheduling block. This parameter is required.
        Returns:
        this
      • scratchDisk

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder scratchDisk​(com.hashicorp.cdktf.IResolvable scratchDisk)
        The scratch disks attached to the instance.

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#scratch_disk ComputeInstanceFromTemplate#scratch_disk}

        Parameters:
        scratchDisk - The scratch disks attached to the instance. This parameter is required.
        Returns:
        this
      • scratchDisk

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder scratchDisk​(List<? extends ComputeInstanceFromTemplateScratchDisk> scratchDisk)
        The scratch disks attached to the instance.

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#scratch_disk ComputeInstanceFromTemplate#scratch_disk}

        Parameters:
        scratchDisk - The scratch disks attached to the instance. This parameter is required.
        Returns:
        this
      • serviceAccount

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder serviceAccount​(com.hashicorp.cdktf.IResolvable serviceAccount)
        The service account to attach to the instance.

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#service_account ComputeInstanceFromTemplate#service_account}

        Parameters:
        serviceAccount - The service account to attach to the instance. This parameter is required.
        Returns:
        this
      • serviceAccount

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder serviceAccount​(List<? extends ComputeInstanceFromTemplateServiceAccount> serviceAccount)
        The service account to attach to the instance.

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#service_account ComputeInstanceFromTemplate#service_account}

        Parameters:
        serviceAccount - The service account to attach to the instance. This parameter is required.
        Returns:
        this
      • shieldedInstanceConfig

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder shieldedInstanceConfig​(ComputeInstanceFromTemplateShieldedInstanceConfig shieldedInstanceConfig)
        shielded_instance_config block.

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#shielded_instance_config ComputeInstanceFromTemplate#shielded_instance_config}

        Parameters:
        shieldedInstanceConfig - shielded_instance_config block. This parameter is required.
        Returns:
        this
      • tags

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder tags​(List<String> tags)
        The list of tags attached to the instance.

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#tags ComputeInstanceFromTemplate#tags}

        Parameters:
        tags - The list of tags attached to the instance. This parameter is required.
        Returns:
        this
      • timeouts

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder timeouts​(ComputeInstanceFromTemplateTimeouts timeouts)
        timeouts block.

        Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#timeouts ComputeInstanceFromTemplate#timeouts}

        Parameters:
        timeouts - timeouts block. This parameter is required.
        Returns:
        this
      • zone

        @Stability(Stable)
        public ComputeInstanceFromTemplate.Builder zone​(String zone)
        The zone of the instance.

        If self_link is provided, this value is ignored. If neither self_link nor zone are provided, the provider zone is used. Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/google/5.43.1/docs/resources/compute_instance_from_template#zone ComputeInstanceFromTemplate#zone}

        Parameters:
        zone - The zone of the instance. This parameter is required.
        Returns:
        this