1. Packages
  2. Azure Classic
  3. API Docs
  4. compute
  5. BastionHost

We recommend using Azure Native.

Azure Classic v5.57.0 published on Tuesday, Nov 28, 2023 by Pulumi

azure.compute.BastionHost

Explore with Pulumi AI

azure logo

We recommend using Azure Native.

Azure Classic v5.57.0 published on Tuesday, Nov 28, 2023 by Pulumi

    Manages a Bastion Host.

    Example Usage

    This example deploys an Azure Bastion Host Instance to a target virtual network.

    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Azure = Pulumi.Azure;
    
    return await Deployment.RunAsync(() => 
    {
        var exampleResourceGroup = new Azure.Core.ResourceGroup("exampleResourceGroup", new()
        {
            Location = "West Europe",
        });
    
        var exampleVirtualNetwork = new Azure.Network.VirtualNetwork("exampleVirtualNetwork", new()
        {
            AddressSpaces = new[]
            {
                "192.168.1.0/24",
            },
            Location = exampleResourceGroup.Location,
            ResourceGroupName = exampleResourceGroup.Name,
        });
    
        var exampleSubnet = new Azure.Network.Subnet("exampleSubnet", new()
        {
            ResourceGroupName = exampleResourceGroup.Name,
            VirtualNetworkName = exampleVirtualNetwork.Name,
            AddressPrefixes = new[]
            {
                "192.168.1.224/27",
            },
        });
    
        var examplePublicIp = new Azure.Network.PublicIp("examplePublicIp", new()
        {
            Location = exampleResourceGroup.Location,
            ResourceGroupName = exampleResourceGroup.Name,
            AllocationMethod = "Static",
            Sku = "Standard",
        });
    
        var exampleBastionHost = new Azure.Compute.BastionHost("exampleBastionHost", new()
        {
            Location = exampleResourceGroup.Location,
            ResourceGroupName = exampleResourceGroup.Name,
            IpConfiguration = new Azure.Compute.Inputs.BastionHostIpConfigurationArgs
            {
                Name = "configuration",
                SubnetId = exampleSubnet.Id,
                PublicIpAddressId = examplePublicIp.Id,
            },
        });
    
    });
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-azure/sdk/v5/go/azure/compute"
    	"github.com/pulumi/pulumi-azure/sdk/v5/go/azure/core"
    	"github.com/pulumi/pulumi-azure/sdk/v5/go/azure/network"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		exampleResourceGroup, err := core.NewResourceGroup(ctx, "exampleResourceGroup", &core.ResourceGroupArgs{
    			Location: pulumi.String("West Europe"),
    		})
    		if err != nil {
    			return err
    		}
    		exampleVirtualNetwork, err := network.NewVirtualNetwork(ctx, "exampleVirtualNetwork", &network.VirtualNetworkArgs{
    			AddressSpaces: pulumi.StringArray{
    				pulumi.String("192.168.1.0/24"),
    			},
    			Location:          exampleResourceGroup.Location,
    			ResourceGroupName: exampleResourceGroup.Name,
    		})
    		if err != nil {
    			return err
    		}
    		exampleSubnet, err := network.NewSubnet(ctx, "exampleSubnet", &network.SubnetArgs{
    			ResourceGroupName:  exampleResourceGroup.Name,
    			VirtualNetworkName: exampleVirtualNetwork.Name,
    			AddressPrefixes: pulumi.StringArray{
    				pulumi.String("192.168.1.224/27"),
    			},
    		})
    		if err != nil {
    			return err
    		}
    		examplePublicIp, err := network.NewPublicIp(ctx, "examplePublicIp", &network.PublicIpArgs{
    			Location:          exampleResourceGroup.Location,
    			ResourceGroupName: exampleResourceGroup.Name,
    			AllocationMethod:  pulumi.String("Static"),
    			Sku:               pulumi.String("Standard"),
    		})
    		if err != nil {
    			return err
    		}
    		_, err = compute.NewBastionHost(ctx, "exampleBastionHost", &compute.BastionHostArgs{
    			Location:          exampleResourceGroup.Location,
    			ResourceGroupName: exampleResourceGroup.Name,
    			IpConfiguration: &compute.BastionHostIpConfigurationArgs{
    				Name:              pulumi.String("configuration"),
    				SubnetId:          exampleSubnet.ID(),
    				PublicIpAddressId: examplePublicIp.ID(),
    			},
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.azure.core.ResourceGroup;
    import com.pulumi.azure.core.ResourceGroupArgs;
    import com.pulumi.azure.network.VirtualNetwork;
    import com.pulumi.azure.network.VirtualNetworkArgs;
    import com.pulumi.azure.network.Subnet;
    import com.pulumi.azure.network.SubnetArgs;
    import com.pulumi.azure.network.PublicIp;
    import com.pulumi.azure.network.PublicIpArgs;
    import com.pulumi.azure.compute.BastionHost;
    import com.pulumi.azure.compute.BastionHostArgs;
    import com.pulumi.azure.compute.inputs.BastionHostIpConfigurationArgs;
    import java.util.List;
    import java.util.ArrayList;
    import java.util.Map;
    import java.io.File;
    import java.nio.file.Files;
    import java.nio.file.Paths;
    
    public class App {
        public static void main(String[] args) {
            Pulumi.run(App::stack);
        }
    
        public static void stack(Context ctx) {
            var exampleResourceGroup = new ResourceGroup("exampleResourceGroup", ResourceGroupArgs.builder()        
                .location("West Europe")
                .build());
    
            var exampleVirtualNetwork = new VirtualNetwork("exampleVirtualNetwork", VirtualNetworkArgs.builder()        
                .addressSpaces("192.168.1.0/24")
                .location(exampleResourceGroup.location())
                .resourceGroupName(exampleResourceGroup.name())
                .build());
    
            var exampleSubnet = new Subnet("exampleSubnet", SubnetArgs.builder()        
                .resourceGroupName(exampleResourceGroup.name())
                .virtualNetworkName(exampleVirtualNetwork.name())
                .addressPrefixes("192.168.1.224/27")
                .build());
    
            var examplePublicIp = new PublicIp("examplePublicIp", PublicIpArgs.builder()        
                .location(exampleResourceGroup.location())
                .resourceGroupName(exampleResourceGroup.name())
                .allocationMethod("Static")
                .sku("Standard")
                .build());
    
            var exampleBastionHost = new BastionHost("exampleBastionHost", BastionHostArgs.builder()        
                .location(exampleResourceGroup.location())
                .resourceGroupName(exampleResourceGroup.name())
                .ipConfiguration(BastionHostIpConfigurationArgs.builder()
                    .name("configuration")
                    .subnetId(exampleSubnet.id())
                    .publicIpAddressId(examplePublicIp.id())
                    .build())
                .build());
    
        }
    }
    
    import pulumi
    import pulumi_azure as azure
    
    example_resource_group = azure.core.ResourceGroup("exampleResourceGroup", location="West Europe")
    example_virtual_network = azure.network.VirtualNetwork("exampleVirtualNetwork",
        address_spaces=["192.168.1.0/24"],
        location=example_resource_group.location,
        resource_group_name=example_resource_group.name)
    example_subnet = azure.network.Subnet("exampleSubnet",
        resource_group_name=example_resource_group.name,
        virtual_network_name=example_virtual_network.name,
        address_prefixes=["192.168.1.224/27"])
    example_public_ip = azure.network.PublicIp("examplePublicIp",
        location=example_resource_group.location,
        resource_group_name=example_resource_group.name,
        allocation_method="Static",
        sku="Standard")
    example_bastion_host = azure.compute.BastionHost("exampleBastionHost",
        location=example_resource_group.location,
        resource_group_name=example_resource_group.name,
        ip_configuration=azure.compute.BastionHostIpConfigurationArgs(
            name="configuration",
            subnet_id=example_subnet.id,
            public_ip_address_id=example_public_ip.id,
        ))
    
    import * as pulumi from "@pulumi/pulumi";
    import * as azure from "@pulumi/azure";
    
    const exampleResourceGroup = new azure.core.ResourceGroup("exampleResourceGroup", {location: "West Europe"});
    const exampleVirtualNetwork = new azure.network.VirtualNetwork("exampleVirtualNetwork", {
        addressSpaces: ["192.168.1.0/24"],
        location: exampleResourceGroup.location,
        resourceGroupName: exampleResourceGroup.name,
    });
    const exampleSubnet = new azure.network.Subnet("exampleSubnet", {
        resourceGroupName: exampleResourceGroup.name,
        virtualNetworkName: exampleVirtualNetwork.name,
        addressPrefixes: ["192.168.1.224/27"],
    });
    const examplePublicIp = new azure.network.PublicIp("examplePublicIp", {
        location: exampleResourceGroup.location,
        resourceGroupName: exampleResourceGroup.name,
        allocationMethod: "Static",
        sku: "Standard",
    });
    const exampleBastionHost = new azure.compute.BastionHost("exampleBastionHost", {
        location: exampleResourceGroup.location,
        resourceGroupName: exampleResourceGroup.name,
        ipConfiguration: {
            name: "configuration",
            subnetId: exampleSubnet.id,
            publicIpAddressId: examplePublicIp.id,
        },
    });
    
    resources:
      exampleResourceGroup:
        type: azure:core:ResourceGroup
        properties:
          location: West Europe
      exampleVirtualNetwork:
        type: azure:network:VirtualNetwork
        properties:
          addressSpaces:
            - 192.168.1.0/24
          location: ${exampleResourceGroup.location}
          resourceGroupName: ${exampleResourceGroup.name}
      exampleSubnet:
        type: azure:network:Subnet
        properties:
          resourceGroupName: ${exampleResourceGroup.name}
          virtualNetworkName: ${exampleVirtualNetwork.name}
          addressPrefixes:
            - 192.168.1.224/27
      examplePublicIp:
        type: azure:network:PublicIp
        properties:
          location: ${exampleResourceGroup.location}
          resourceGroupName: ${exampleResourceGroup.name}
          allocationMethod: Static
          sku: Standard
      exampleBastionHost:
        type: azure:compute:BastionHost
        properties:
          location: ${exampleResourceGroup.location}
          resourceGroupName: ${exampleResourceGroup.name}
          ipConfiguration:
            name: configuration
            subnetId: ${exampleSubnet.id}
            publicIpAddressId: ${examplePublicIp.id}
    

    Create BastionHost Resource

    new BastionHost(name: string, args: BastionHostArgs, opts?: CustomResourceOptions);
    @overload
    def BastionHost(resource_name: str,
                    opts: Optional[ResourceOptions] = None,
                    copy_paste_enabled: Optional[bool] = None,
                    file_copy_enabled: Optional[bool] = None,
                    ip_configuration: Optional[BastionHostIpConfigurationArgs] = None,
                    ip_connect_enabled: Optional[bool] = None,
                    location: Optional[str] = None,
                    name: Optional[str] = None,
                    resource_group_name: Optional[str] = None,
                    scale_units: Optional[int] = None,
                    shareable_link_enabled: Optional[bool] = None,
                    sku: Optional[str] = None,
                    tags: Optional[Mapping[str, str]] = None,
                    tunneling_enabled: Optional[bool] = None)
    @overload
    def BastionHost(resource_name: str,
                    args: BastionHostArgs,
                    opts: Optional[ResourceOptions] = None)
    func NewBastionHost(ctx *Context, name string, args BastionHostArgs, opts ...ResourceOption) (*BastionHost, error)
    public BastionHost(string name, BastionHostArgs args, CustomResourceOptions? opts = null)
    public BastionHost(String name, BastionHostArgs args)
    public BastionHost(String name, BastionHostArgs args, CustomResourceOptions options)
    
    type: azure:compute:BastionHost
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    name string
    The unique name of the resource.
    args BastionHostArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args BastionHostArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args BastionHostArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args BastionHostArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args BastionHostArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    BastionHost Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    The BastionHost resource accepts the following input properties:

    IpConfiguration BastionHostIpConfiguration

    A ip_configuration block as defined below. Changing this forces a new resource to be created.

    ResourceGroupName string

    The name of the resource group in which to create the Bastion Host. Changing this forces a new resource to be created.

    CopyPasteEnabled bool

    Is Copy/Paste feature enabled for the Bastion Host. Defaults to true.

    FileCopyEnabled bool

    Is File Copy feature enabled for the Bastion Host. Defaults to false.

    Note: file_copy_enabled is only supported when sku is Standard.

    IpConnectEnabled bool

    Is IP Connect feature enabled for the Bastion Host. Defaults to false.

    Note: ip_connect_enabled is only supported when sku is Standard.

    Location string

    Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created. Review Azure Bastion Host FAQ for supported locations.

    Name string

    Specifies the name of the Bastion Host. Changing this forces a new resource to be created.

    ScaleUnits int

    The number of scale units with which to provision the Bastion Host. Possible values are between 2 and 50. Defaults to 2.

    Note: scale_units only can be changed when sku is Standard. scale_units is always 2 when sku is Basic.

    ShareableLinkEnabled bool

    Is Shareable Link feature enabled for the Bastion Host. Defaults to false.

    Note: shareable_link_enabled is only supported when sku is Standard.

    Sku string

    The SKU of the Bastion Host. Accepted values are Basic and Standard. Defaults to Basic.

    Note Downgrading the SKU will force a new resource to be created.

    Tags Dictionary<string, string>

    A mapping of tags to assign to the resource.

    TunnelingEnabled bool

    Is Tunneling feature enabled for the Bastion Host. Defaults to false.

    Note: tunneling_enabled is only supported when sku is Standard.

    IpConfiguration BastionHostIpConfigurationArgs

    A ip_configuration block as defined below. Changing this forces a new resource to be created.

    ResourceGroupName string

    The name of the resource group in which to create the Bastion Host. Changing this forces a new resource to be created.

    CopyPasteEnabled bool

    Is Copy/Paste feature enabled for the Bastion Host. Defaults to true.

    FileCopyEnabled bool

    Is File Copy feature enabled for the Bastion Host. Defaults to false.

    Note: file_copy_enabled is only supported when sku is Standard.

    IpConnectEnabled bool

    Is IP Connect feature enabled for the Bastion Host. Defaults to false.

    Note: ip_connect_enabled is only supported when sku is Standard.

    Location string

    Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created. Review Azure Bastion Host FAQ for supported locations.

    Name string

    Specifies the name of the Bastion Host. Changing this forces a new resource to be created.

    ScaleUnits int

    The number of scale units with which to provision the Bastion Host. Possible values are between 2 and 50. Defaults to 2.

    Note: scale_units only can be changed when sku is Standard. scale_units is always 2 when sku is Basic.

    ShareableLinkEnabled bool

    Is Shareable Link feature enabled for the Bastion Host. Defaults to false.

    Note: shareable_link_enabled is only supported when sku is Standard.

    Sku string

    The SKU of the Bastion Host. Accepted values are Basic and Standard. Defaults to Basic.

    Note Downgrading the SKU will force a new resource to be created.

    Tags map[string]string

    A mapping of tags to assign to the resource.

    TunnelingEnabled bool

    Is Tunneling feature enabled for the Bastion Host. Defaults to false.

    Note: tunneling_enabled is only supported when sku is Standard.

    ipConfiguration BastionHostIpConfiguration

    A ip_configuration block as defined below. Changing this forces a new resource to be created.

    resourceGroupName String

    The name of the resource group in which to create the Bastion Host. Changing this forces a new resource to be created.

    copyPasteEnabled Boolean

    Is Copy/Paste feature enabled for the Bastion Host. Defaults to true.

    fileCopyEnabled Boolean

    Is File Copy feature enabled for the Bastion Host. Defaults to false.

    Note: file_copy_enabled is only supported when sku is Standard.

    ipConnectEnabled Boolean

    Is IP Connect feature enabled for the Bastion Host. Defaults to false.

    Note: ip_connect_enabled is only supported when sku is Standard.

    location String

    Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created. Review Azure Bastion Host FAQ for supported locations.

    name String

    Specifies the name of the Bastion Host. Changing this forces a new resource to be created.

    scaleUnits Integer

    The number of scale units with which to provision the Bastion Host. Possible values are between 2 and 50. Defaults to 2.

    Note: scale_units only can be changed when sku is Standard. scale_units is always 2 when sku is Basic.

    shareableLinkEnabled Boolean

    Is Shareable Link feature enabled for the Bastion Host. Defaults to false.

    Note: shareable_link_enabled is only supported when sku is Standard.

    sku String

    The SKU of the Bastion Host. Accepted values are Basic and Standard. Defaults to Basic.

    Note Downgrading the SKU will force a new resource to be created.

    tags Map<String,String>

    A mapping of tags to assign to the resource.

    tunnelingEnabled Boolean

    Is Tunneling feature enabled for the Bastion Host. Defaults to false.

    Note: tunneling_enabled is only supported when sku is Standard.

    ipConfiguration BastionHostIpConfiguration

    A ip_configuration block as defined below. Changing this forces a new resource to be created.

    resourceGroupName string

    The name of the resource group in which to create the Bastion Host. Changing this forces a new resource to be created.

    copyPasteEnabled boolean

    Is Copy/Paste feature enabled for the Bastion Host. Defaults to true.

    fileCopyEnabled boolean

    Is File Copy feature enabled for the Bastion Host. Defaults to false.

    Note: file_copy_enabled is only supported when sku is Standard.

    ipConnectEnabled boolean

    Is IP Connect feature enabled for the Bastion Host. Defaults to false.

    Note: ip_connect_enabled is only supported when sku is Standard.

    location string

    Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created. Review Azure Bastion Host FAQ for supported locations.

    name string

    Specifies the name of the Bastion Host. Changing this forces a new resource to be created.

    scaleUnits number

    The number of scale units with which to provision the Bastion Host. Possible values are between 2 and 50. Defaults to 2.

    Note: scale_units only can be changed when sku is Standard. scale_units is always 2 when sku is Basic.

    shareableLinkEnabled boolean

    Is Shareable Link feature enabled for the Bastion Host. Defaults to false.

    Note: shareable_link_enabled is only supported when sku is Standard.

    sku string

    The SKU of the Bastion Host. Accepted values are Basic and Standard. Defaults to Basic.

    Note Downgrading the SKU will force a new resource to be created.

    tags {[key: string]: string}

    A mapping of tags to assign to the resource.

    tunnelingEnabled boolean

    Is Tunneling feature enabled for the Bastion Host. Defaults to false.

    Note: tunneling_enabled is only supported when sku is Standard.

    ip_configuration BastionHostIpConfigurationArgs

    A ip_configuration block as defined below. Changing this forces a new resource to be created.

    resource_group_name str

    The name of the resource group in which to create the Bastion Host. Changing this forces a new resource to be created.

    copy_paste_enabled bool

    Is Copy/Paste feature enabled for the Bastion Host. Defaults to true.

    file_copy_enabled bool

    Is File Copy feature enabled for the Bastion Host. Defaults to false.

    Note: file_copy_enabled is only supported when sku is Standard.

    ip_connect_enabled bool

    Is IP Connect feature enabled for the Bastion Host. Defaults to false.

    Note: ip_connect_enabled is only supported when sku is Standard.

    location str

    Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created. Review Azure Bastion Host FAQ for supported locations.

    name str

    Specifies the name of the Bastion Host. Changing this forces a new resource to be created.

    scale_units int

    The number of scale units with which to provision the Bastion Host. Possible values are between 2 and 50. Defaults to 2.

    Note: scale_units only can be changed when sku is Standard. scale_units is always 2 when sku is Basic.

    shareable_link_enabled bool

    Is Shareable Link feature enabled for the Bastion Host. Defaults to false.

    Note: shareable_link_enabled is only supported when sku is Standard.

    sku str

    The SKU of the Bastion Host. Accepted values are Basic and Standard. Defaults to Basic.

    Note Downgrading the SKU will force a new resource to be created.

    tags Mapping[str, str]

    A mapping of tags to assign to the resource.

    tunneling_enabled bool

    Is Tunneling feature enabled for the Bastion Host. Defaults to false.

    Note: tunneling_enabled is only supported when sku is Standard.

    ipConfiguration Property Map

    A ip_configuration block as defined below. Changing this forces a new resource to be created.

    resourceGroupName String

    The name of the resource group in which to create the Bastion Host. Changing this forces a new resource to be created.

    copyPasteEnabled Boolean

    Is Copy/Paste feature enabled for the Bastion Host. Defaults to true.

    fileCopyEnabled Boolean

    Is File Copy feature enabled for the Bastion Host. Defaults to false.

    Note: file_copy_enabled is only supported when sku is Standard.

    ipConnectEnabled Boolean

    Is IP Connect feature enabled for the Bastion Host. Defaults to false.

    Note: ip_connect_enabled is only supported when sku is Standard.

    location String

    Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created. Review Azure Bastion Host FAQ for supported locations.

    name String

    Specifies the name of the Bastion Host. Changing this forces a new resource to be created.

    scaleUnits Number

    The number of scale units with which to provision the Bastion Host. Possible values are between 2 and 50. Defaults to 2.

    Note: scale_units only can be changed when sku is Standard. scale_units is always 2 when sku is Basic.

    shareableLinkEnabled Boolean

    Is Shareable Link feature enabled for the Bastion Host. Defaults to false.

    Note: shareable_link_enabled is only supported when sku is Standard.

    sku String

    The SKU of the Bastion Host. Accepted values are Basic and Standard. Defaults to Basic.

    Note Downgrading the SKU will force a new resource to be created.

    tags Map<String>

    A mapping of tags to assign to the resource.

    tunnelingEnabled Boolean

    Is Tunneling feature enabled for the Bastion Host. Defaults to false.

    Note: tunneling_enabled is only supported when sku is Standard.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the BastionHost resource produces the following output properties:

    DnsName string

    The FQDN for the Bastion Host.

    Id string

    The provider-assigned unique ID for this managed resource.

    DnsName string

    The FQDN for the Bastion Host.

    Id string

    The provider-assigned unique ID for this managed resource.

    dnsName String

    The FQDN for the Bastion Host.

    id String

    The provider-assigned unique ID for this managed resource.

    dnsName string

    The FQDN for the Bastion Host.

    id string

    The provider-assigned unique ID for this managed resource.

    dns_name str

    The FQDN for the Bastion Host.

    id str

    The provider-assigned unique ID for this managed resource.

    dnsName String

    The FQDN for the Bastion Host.

    id String

    The provider-assigned unique ID for this managed resource.

    Look up Existing BastionHost Resource

    Get an existing BastionHost resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: BastionHostState, opts?: CustomResourceOptions): BastionHost
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            copy_paste_enabled: Optional[bool] = None,
            dns_name: Optional[str] = None,
            file_copy_enabled: Optional[bool] = None,
            ip_configuration: Optional[BastionHostIpConfigurationArgs] = None,
            ip_connect_enabled: Optional[bool] = None,
            location: Optional[str] = None,
            name: Optional[str] = None,
            resource_group_name: Optional[str] = None,
            scale_units: Optional[int] = None,
            shareable_link_enabled: Optional[bool] = None,
            sku: Optional[str] = None,
            tags: Optional[Mapping[str, str]] = None,
            tunneling_enabled: Optional[bool] = None) -> BastionHost
    func GetBastionHost(ctx *Context, name string, id IDInput, state *BastionHostState, opts ...ResourceOption) (*BastionHost, error)
    public static BastionHost Get(string name, Input<string> id, BastionHostState? state, CustomResourceOptions? opts = null)
    public static BastionHost get(String name, Output<String> id, BastionHostState state, CustomResourceOptions options)
    Resource lookup is not supported in YAML
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    CopyPasteEnabled bool

    Is Copy/Paste feature enabled for the Bastion Host. Defaults to true.

    DnsName string

    The FQDN for the Bastion Host.

    FileCopyEnabled bool

    Is File Copy feature enabled for the Bastion Host. Defaults to false.

    Note: file_copy_enabled is only supported when sku is Standard.

    IpConfiguration BastionHostIpConfiguration

    A ip_configuration block as defined below. Changing this forces a new resource to be created.

    IpConnectEnabled bool

    Is IP Connect feature enabled for the Bastion Host. Defaults to false.

    Note: ip_connect_enabled is only supported when sku is Standard.

    Location string

    Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created. Review Azure Bastion Host FAQ for supported locations.

    Name string

    Specifies the name of the Bastion Host. Changing this forces a new resource to be created.

    ResourceGroupName string

    The name of the resource group in which to create the Bastion Host. Changing this forces a new resource to be created.

    ScaleUnits int

    The number of scale units with which to provision the Bastion Host. Possible values are between 2 and 50. Defaults to 2.

    Note: scale_units only can be changed when sku is Standard. scale_units is always 2 when sku is Basic.

    ShareableLinkEnabled bool

    Is Shareable Link feature enabled for the Bastion Host. Defaults to false.

    Note: shareable_link_enabled is only supported when sku is Standard.

    Sku string

    The SKU of the Bastion Host. Accepted values are Basic and Standard. Defaults to Basic.

    Note Downgrading the SKU will force a new resource to be created.

    Tags Dictionary<string, string>

    A mapping of tags to assign to the resource.

    TunnelingEnabled bool

    Is Tunneling feature enabled for the Bastion Host. Defaults to false.

    Note: tunneling_enabled is only supported when sku is Standard.

    CopyPasteEnabled bool

    Is Copy/Paste feature enabled for the Bastion Host. Defaults to true.

    DnsName string

    The FQDN for the Bastion Host.

    FileCopyEnabled bool

    Is File Copy feature enabled for the Bastion Host. Defaults to false.

    Note: file_copy_enabled is only supported when sku is Standard.

    IpConfiguration BastionHostIpConfigurationArgs

    A ip_configuration block as defined below. Changing this forces a new resource to be created.

    IpConnectEnabled bool

    Is IP Connect feature enabled for the Bastion Host. Defaults to false.

    Note: ip_connect_enabled is only supported when sku is Standard.

    Location string

    Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created. Review Azure Bastion Host FAQ for supported locations.

    Name string

    Specifies the name of the Bastion Host. Changing this forces a new resource to be created.

    ResourceGroupName string

    The name of the resource group in which to create the Bastion Host. Changing this forces a new resource to be created.

    ScaleUnits int

    The number of scale units with which to provision the Bastion Host. Possible values are between 2 and 50. Defaults to 2.

    Note: scale_units only can be changed when sku is Standard. scale_units is always 2 when sku is Basic.

    ShareableLinkEnabled bool

    Is Shareable Link feature enabled for the Bastion Host. Defaults to false.

    Note: shareable_link_enabled is only supported when sku is Standard.

    Sku string

    The SKU of the Bastion Host. Accepted values are Basic and Standard. Defaults to Basic.

    Note Downgrading the SKU will force a new resource to be created.

    Tags map[string]string

    A mapping of tags to assign to the resource.

    TunnelingEnabled bool

    Is Tunneling feature enabled for the Bastion Host. Defaults to false.

    Note: tunneling_enabled is only supported when sku is Standard.

    copyPasteEnabled Boolean

    Is Copy/Paste feature enabled for the Bastion Host. Defaults to true.

    dnsName String

    The FQDN for the Bastion Host.

    fileCopyEnabled Boolean

    Is File Copy feature enabled for the Bastion Host. Defaults to false.

    Note: file_copy_enabled is only supported when sku is Standard.

    ipConfiguration BastionHostIpConfiguration

    A ip_configuration block as defined below. Changing this forces a new resource to be created.

    ipConnectEnabled Boolean

    Is IP Connect feature enabled for the Bastion Host. Defaults to false.

    Note: ip_connect_enabled is only supported when sku is Standard.

    location String

    Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created. Review Azure Bastion Host FAQ for supported locations.

    name String

    Specifies the name of the Bastion Host. Changing this forces a new resource to be created.

    resourceGroupName String

    The name of the resource group in which to create the Bastion Host. Changing this forces a new resource to be created.

    scaleUnits Integer

    The number of scale units with which to provision the Bastion Host. Possible values are between 2 and 50. Defaults to 2.

    Note: scale_units only can be changed when sku is Standard. scale_units is always 2 when sku is Basic.

    shareableLinkEnabled Boolean

    Is Shareable Link feature enabled for the Bastion Host. Defaults to false.

    Note: shareable_link_enabled is only supported when sku is Standard.

    sku String

    The SKU of the Bastion Host. Accepted values are Basic and Standard. Defaults to Basic.

    Note Downgrading the SKU will force a new resource to be created.

    tags Map<String,String>

    A mapping of tags to assign to the resource.

    tunnelingEnabled Boolean

    Is Tunneling feature enabled for the Bastion Host. Defaults to false.

    Note: tunneling_enabled is only supported when sku is Standard.

    copyPasteEnabled boolean

    Is Copy/Paste feature enabled for the Bastion Host. Defaults to true.

    dnsName string

    The FQDN for the Bastion Host.

    fileCopyEnabled boolean

    Is File Copy feature enabled for the Bastion Host. Defaults to false.

    Note: file_copy_enabled is only supported when sku is Standard.

    ipConfiguration BastionHostIpConfiguration

    A ip_configuration block as defined below. Changing this forces a new resource to be created.

    ipConnectEnabled boolean

    Is IP Connect feature enabled for the Bastion Host. Defaults to false.

    Note: ip_connect_enabled is only supported when sku is Standard.

    location string

    Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created. Review Azure Bastion Host FAQ for supported locations.

    name string

    Specifies the name of the Bastion Host. Changing this forces a new resource to be created.

    resourceGroupName string

    The name of the resource group in which to create the Bastion Host. Changing this forces a new resource to be created.

    scaleUnits number

    The number of scale units with which to provision the Bastion Host. Possible values are between 2 and 50. Defaults to 2.

    Note: scale_units only can be changed when sku is Standard. scale_units is always 2 when sku is Basic.

    shareableLinkEnabled boolean

    Is Shareable Link feature enabled for the Bastion Host. Defaults to false.

    Note: shareable_link_enabled is only supported when sku is Standard.

    sku string

    The SKU of the Bastion Host. Accepted values are Basic and Standard. Defaults to Basic.

    Note Downgrading the SKU will force a new resource to be created.

    tags {[key: string]: string}

    A mapping of tags to assign to the resource.

    tunnelingEnabled boolean

    Is Tunneling feature enabled for the Bastion Host. Defaults to false.

    Note: tunneling_enabled is only supported when sku is Standard.

    copy_paste_enabled bool

    Is Copy/Paste feature enabled for the Bastion Host. Defaults to true.

    dns_name str

    The FQDN for the Bastion Host.

    file_copy_enabled bool

    Is File Copy feature enabled for the Bastion Host. Defaults to false.

    Note: file_copy_enabled is only supported when sku is Standard.

    ip_configuration BastionHostIpConfigurationArgs

    A ip_configuration block as defined below. Changing this forces a new resource to be created.

    ip_connect_enabled bool

    Is IP Connect feature enabled for the Bastion Host. Defaults to false.

    Note: ip_connect_enabled is only supported when sku is Standard.

    location str

    Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created. Review Azure Bastion Host FAQ for supported locations.

    name str

    Specifies the name of the Bastion Host. Changing this forces a new resource to be created.

    resource_group_name str

    The name of the resource group in which to create the Bastion Host. Changing this forces a new resource to be created.

    scale_units int

    The number of scale units with which to provision the Bastion Host. Possible values are between 2 and 50. Defaults to 2.

    Note: scale_units only can be changed when sku is Standard. scale_units is always 2 when sku is Basic.

    shareable_link_enabled bool

    Is Shareable Link feature enabled for the Bastion Host. Defaults to false.

    Note: shareable_link_enabled is only supported when sku is Standard.

    sku str

    The SKU of the Bastion Host. Accepted values are Basic and Standard. Defaults to Basic.

    Note Downgrading the SKU will force a new resource to be created.

    tags Mapping[str, str]

    A mapping of tags to assign to the resource.

    tunneling_enabled bool

    Is Tunneling feature enabled for the Bastion Host. Defaults to false.

    Note: tunneling_enabled is only supported when sku is Standard.

    copyPasteEnabled Boolean

    Is Copy/Paste feature enabled for the Bastion Host. Defaults to true.

    dnsName String

    The FQDN for the Bastion Host.

    fileCopyEnabled Boolean

    Is File Copy feature enabled for the Bastion Host. Defaults to false.

    Note: file_copy_enabled is only supported when sku is Standard.

    ipConfiguration Property Map

    A ip_configuration block as defined below. Changing this forces a new resource to be created.

    ipConnectEnabled Boolean

    Is IP Connect feature enabled for the Bastion Host. Defaults to false.

    Note: ip_connect_enabled is only supported when sku is Standard.

    location String

    Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created. Review Azure Bastion Host FAQ for supported locations.

    name String

    Specifies the name of the Bastion Host. Changing this forces a new resource to be created.

    resourceGroupName String

    The name of the resource group in which to create the Bastion Host. Changing this forces a new resource to be created.

    scaleUnits Number

    The number of scale units with which to provision the Bastion Host. Possible values are between 2 and 50. Defaults to 2.

    Note: scale_units only can be changed when sku is Standard. scale_units is always 2 when sku is Basic.

    shareableLinkEnabled Boolean

    Is Shareable Link feature enabled for the Bastion Host. Defaults to false.

    Note: shareable_link_enabled is only supported when sku is Standard.

    sku String

    The SKU of the Bastion Host. Accepted values are Basic and Standard. Defaults to Basic.

    Note Downgrading the SKU will force a new resource to be created.

    tags Map<String>

    A mapping of tags to assign to the resource.

    tunnelingEnabled Boolean

    Is Tunneling feature enabled for the Bastion Host. Defaults to false.

    Note: tunneling_enabled is only supported when sku is Standard.

    Supporting Types

    BastionHostIpConfiguration, BastionHostIpConfigurationArgs

    Name string

    The name of the IP configuration. Changing this forces a new resource to be created.

    PublicIpAddressId string

    Reference to a Public IP Address to associate with this Bastion Host. Changing this forces a new resource to be created.

    SubnetId string

    Reference to a subnet in which this Bastion Host has been created. Changing this forces a new resource to be created.

    Note: The Subnet used for the Bastion Host must have the name AzureBastionSubnet and the subnet mask must be at least a /26.

    Name string

    The name of the IP configuration. Changing this forces a new resource to be created.

    PublicIpAddressId string

    Reference to a Public IP Address to associate with this Bastion Host. Changing this forces a new resource to be created.

    SubnetId string

    Reference to a subnet in which this Bastion Host has been created. Changing this forces a new resource to be created.

    Note: The Subnet used for the Bastion Host must have the name AzureBastionSubnet and the subnet mask must be at least a /26.

    name String

    The name of the IP configuration. Changing this forces a new resource to be created.

    publicIpAddressId String

    Reference to a Public IP Address to associate with this Bastion Host. Changing this forces a new resource to be created.

    subnetId String

    Reference to a subnet in which this Bastion Host has been created. Changing this forces a new resource to be created.

    Note: The Subnet used for the Bastion Host must have the name AzureBastionSubnet and the subnet mask must be at least a /26.

    name string

    The name of the IP configuration. Changing this forces a new resource to be created.

    publicIpAddressId string

    Reference to a Public IP Address to associate with this Bastion Host. Changing this forces a new resource to be created.

    subnetId string

    Reference to a subnet in which this Bastion Host has been created. Changing this forces a new resource to be created.

    Note: The Subnet used for the Bastion Host must have the name AzureBastionSubnet and the subnet mask must be at least a /26.

    name str

    The name of the IP configuration. Changing this forces a new resource to be created.

    public_ip_address_id str

    Reference to a Public IP Address to associate with this Bastion Host. Changing this forces a new resource to be created.

    subnet_id str

    Reference to a subnet in which this Bastion Host has been created. Changing this forces a new resource to be created.

    Note: The Subnet used for the Bastion Host must have the name AzureBastionSubnet and the subnet mask must be at least a /26.

    name String

    The name of the IP configuration. Changing this forces a new resource to be created.

    publicIpAddressId String

    Reference to a Public IP Address to associate with this Bastion Host. Changing this forces a new resource to be created.

    subnetId String

    Reference to a subnet in which this Bastion Host has been created. Changing this forces a new resource to be created.

    Note: The Subnet used for the Bastion Host must have the name AzureBastionSubnet and the subnet mask must be at least a /26.

    Import

    Bastion Hosts can be imported using the resource id, e.g.

     $ pulumi import azure:compute/bastionHost:BastionHost example /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mygroup1/providers/Microsoft.Network/bastionHosts/instance1
    

    Package Details

    Repository
    Azure Classic pulumi/pulumi-azure
    License
    Apache-2.0
    Notes

    This Pulumi package is based on the azurerm Terraform Provider.

    azure logo

    We recommend using Azure Native.

    Azure Classic v5.57.0 published on Tuesday, Nov 28, 2023 by Pulumi