We recommend using Azure Native.
azure.devtest.LinuxVirtualMachine
Explore with Pulumi AI
Manages a Linux Virtual Machine within a Dev Test Lab.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as azure from "@pulumi/azure";
import * as std from "@pulumi/std";
const example = new azure.core.ResourceGroup("example", {
name: "example-resources",
location: "West Europe",
});
const exampleLab = new azure.devtest.Lab("example", {
name: "example-devtestlab",
location: example.location,
resourceGroupName: example.name,
tags: {
Sydney: "Australia",
},
});
const exampleVirtualNetwork = new azure.devtest.VirtualNetwork("example", {
name: "example-network",
labName: exampleLab.name,
resourceGroupName: example.name,
subnet: {
usePublicIpAddress: "Allow",
useInVirtualMachineCreation: "Allow",
},
});
const exampleLinuxVirtualMachine = new azure.devtest.LinuxVirtualMachine("example", {
name: "example-vm03",
labName: exampleLab.name,
resourceGroupName: example.name,
location: example.location,
size: "Standard_DS2",
username: "exampleuser99",
sshKey: std.file({
input: "~/.ssh/id_rsa.pub",
}).then(invoke => invoke.result),
labVirtualNetworkId: exampleVirtualNetwork.id,
labSubnetName: exampleVirtualNetwork.subnet.apply(subnet => subnet.name),
storageType: "Premium",
notes: "Some notes about this Virtual Machine.",
galleryImageReference: {
publisher: "Canonical",
offer: "0001-com-ubuntu-server-jammy",
sku: "22_04-lts",
version: "latest",
},
});
import pulumi
import pulumi_azure as azure
import pulumi_std as std
example = azure.core.ResourceGroup("example",
name="example-resources",
location="West Europe")
example_lab = azure.devtest.Lab("example",
name="example-devtestlab",
location=example.location,
resource_group_name=example.name,
tags={
"Sydney": "Australia",
})
example_virtual_network = azure.devtest.VirtualNetwork("example",
name="example-network",
lab_name=example_lab.name,
resource_group_name=example.name,
subnet={
"use_public_ip_address": "Allow",
"use_in_virtual_machine_creation": "Allow",
})
example_linux_virtual_machine = azure.devtest.LinuxVirtualMachine("example",
name="example-vm03",
lab_name=example_lab.name,
resource_group_name=example.name,
location=example.location,
size="Standard_DS2",
username="exampleuser99",
ssh_key=std.file(input="~/.ssh/id_rsa.pub").result,
lab_virtual_network_id=example_virtual_network.id,
lab_subnet_name=example_virtual_network.subnet.name,
storage_type="Premium",
notes="Some notes about this Virtual Machine.",
gallery_image_reference={
"publisher": "Canonical",
"offer": "0001-com-ubuntu-server-jammy",
"sku": "22_04-lts",
"version": "latest",
})
package main
import (
"github.com/pulumi/pulumi-azure/sdk/v6/go/azure/core"
"github.com/pulumi/pulumi-azure/sdk/v6/go/azure/devtest"
"github.com/pulumi/pulumi-std/sdk/go/std"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
example, err := core.NewResourceGroup(ctx, "example", &core.ResourceGroupArgs{
Name: pulumi.String("example-resources"),
Location: pulumi.String("West Europe"),
})
if err != nil {
return err
}
exampleLab, err := devtest.NewLab(ctx, "example", &devtest.LabArgs{
Name: pulumi.String("example-devtestlab"),
Location: example.Location,
ResourceGroupName: example.Name,
Tags: pulumi.StringMap{
"Sydney": pulumi.String("Australia"),
},
})
if err != nil {
return err
}
exampleVirtualNetwork, err := devtest.NewVirtualNetwork(ctx, "example", &devtest.VirtualNetworkArgs{
Name: pulumi.String("example-network"),
LabName: exampleLab.Name,
ResourceGroupName: example.Name,
Subnet: &devtest.VirtualNetworkSubnetArgs{
UsePublicIpAddress: pulumi.String("Allow"),
UseInVirtualMachineCreation: pulumi.String("Allow"),
},
})
if err != nil {
return err
}
invokeFile, err := std.File(ctx, &std.FileArgs{
Input: "~/.ssh/id_rsa.pub",
}, nil)
if err != nil {
return err
}
_, err = devtest.NewLinuxVirtualMachine(ctx, "example", &devtest.LinuxVirtualMachineArgs{
Name: pulumi.String("example-vm03"),
LabName: exampleLab.Name,
ResourceGroupName: example.Name,
Location: example.Location,
Size: pulumi.String("Standard_DS2"),
Username: pulumi.String("exampleuser99"),
SshKey: pulumi.String(invokeFile.Result),
LabVirtualNetworkId: exampleVirtualNetwork.ID(),
LabSubnetName: pulumi.String(exampleVirtualNetwork.Subnet.ApplyT(func(subnet devtest.VirtualNetworkSubnet) (*string, error) {
return &subnet.Name, nil
}).(pulumi.StringPtrOutput)),
StorageType: pulumi.String("Premium"),
Notes: pulumi.String("Some notes about this Virtual Machine."),
GalleryImageReference: &devtest.LinuxVirtualMachineGalleryImageReferenceArgs{
Publisher: pulumi.String("Canonical"),
Offer: pulumi.String("0001-com-ubuntu-server-jammy"),
Sku: pulumi.String("22_04-lts"),
Version: pulumi.String("latest"),
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Azure = Pulumi.Azure;
using Std = Pulumi.Std;
return await Deployment.RunAsync(() =>
{
var example = new Azure.Core.ResourceGroup("example", new()
{
Name = "example-resources",
Location = "West Europe",
});
var exampleLab = new Azure.DevTest.Lab("example", new()
{
Name = "example-devtestlab",
Location = example.Location,
ResourceGroupName = example.Name,
Tags =
{
{ "Sydney", "Australia" },
},
});
var exampleVirtualNetwork = new Azure.DevTest.VirtualNetwork("example", new()
{
Name = "example-network",
LabName = exampleLab.Name,
ResourceGroupName = example.Name,
Subnet = new Azure.DevTest.Inputs.VirtualNetworkSubnetArgs
{
UsePublicIpAddress = "Allow",
UseInVirtualMachineCreation = "Allow",
},
});
var exampleLinuxVirtualMachine = new Azure.DevTest.LinuxVirtualMachine("example", new()
{
Name = "example-vm03",
LabName = exampleLab.Name,
ResourceGroupName = example.Name,
Location = example.Location,
Size = "Standard_DS2",
Username = "exampleuser99",
SshKey = Std.File.Invoke(new()
{
Input = "~/.ssh/id_rsa.pub",
}).Apply(invoke => invoke.Result),
LabVirtualNetworkId = exampleVirtualNetwork.Id,
LabSubnetName = exampleVirtualNetwork.Subnet.Apply(subnet => subnet.Name),
StorageType = "Premium",
Notes = "Some notes about this Virtual Machine.",
GalleryImageReference = new Azure.DevTest.Inputs.LinuxVirtualMachineGalleryImageReferenceArgs
{
Publisher = "Canonical",
Offer = "0001-com-ubuntu-server-jammy",
Sku = "22_04-lts",
Version = "latest",
},
});
});
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.devtest.Lab;
import com.pulumi.azure.devtest.LabArgs;
import com.pulumi.azure.devtest.VirtualNetwork;
import com.pulumi.azure.devtest.VirtualNetworkArgs;
import com.pulumi.azure.devtest.inputs.VirtualNetworkSubnetArgs;
import com.pulumi.azure.devtest.LinuxVirtualMachine;
import com.pulumi.azure.devtest.LinuxVirtualMachineArgs;
import com.pulumi.azure.devtest.inputs.LinuxVirtualMachineGalleryImageReferenceArgs;
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 example = new ResourceGroup("example", ResourceGroupArgs.builder()
.name("example-resources")
.location("West Europe")
.build());
var exampleLab = new Lab("exampleLab", LabArgs.builder()
.name("example-devtestlab")
.location(example.location())
.resourceGroupName(example.name())
.tags(Map.of("Sydney", "Australia"))
.build());
var exampleVirtualNetwork = new VirtualNetwork("exampleVirtualNetwork", VirtualNetworkArgs.builder()
.name("example-network")
.labName(exampleLab.name())
.resourceGroupName(example.name())
.subnet(VirtualNetworkSubnetArgs.builder()
.usePublicIpAddress("Allow")
.useInVirtualMachineCreation("Allow")
.build())
.build());
var exampleLinuxVirtualMachine = new LinuxVirtualMachine("exampleLinuxVirtualMachine", LinuxVirtualMachineArgs.builder()
.name("example-vm03")
.labName(exampleLab.name())
.resourceGroupName(example.name())
.location(example.location())
.size("Standard_DS2")
.username("exampleuser99")
.sshKey(StdFunctions.file(FileArgs.builder()
.input("~/.ssh/id_rsa.pub")
.build()).result())
.labVirtualNetworkId(exampleVirtualNetwork.id())
.labSubnetName(exampleVirtualNetwork.subnet().applyValue(subnet -> subnet.name()))
.storageType("Premium")
.notes("Some notes about this Virtual Machine.")
.galleryImageReference(LinuxVirtualMachineGalleryImageReferenceArgs.builder()
.publisher("Canonical")
.offer("0001-com-ubuntu-server-jammy")
.sku("22_04-lts")
.version("latest")
.build())
.build());
}
}
resources:
example:
type: azure:core:ResourceGroup
properties:
name: example-resources
location: West Europe
exampleLab:
type: azure:devtest:Lab
name: example
properties:
name: example-devtestlab
location: ${example.location}
resourceGroupName: ${example.name}
tags:
Sydney: Australia
exampleVirtualNetwork:
type: azure:devtest:VirtualNetwork
name: example
properties:
name: example-network
labName: ${exampleLab.name}
resourceGroupName: ${example.name}
subnet:
usePublicIpAddress: Allow
useInVirtualMachineCreation: Allow
exampleLinuxVirtualMachine:
type: azure:devtest:LinuxVirtualMachine
name: example
properties:
name: example-vm03
labName: ${exampleLab.name}
resourceGroupName: ${example.name}
location: ${example.location}
size: Standard_DS2
username: exampleuser99
sshKey:
fn::invoke:
Function: std:file
Arguments:
input: ~/.ssh/id_rsa.pub
Return: result
labVirtualNetworkId: ${exampleVirtualNetwork.id}
labSubnetName: ${exampleVirtualNetwork.subnet.name}
storageType: Premium
notes: Some notes about this Virtual Machine.
galleryImageReference:
publisher: Canonical
offer: 0001-com-ubuntu-server-jammy
sku: 22_04-lts
version: latest
Create LinuxVirtualMachine Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new LinuxVirtualMachine(name: string, args: LinuxVirtualMachineArgs, opts?: CustomResourceOptions);
@overload
def LinuxVirtualMachine(resource_name: str,
args: LinuxVirtualMachineArgs,
opts: Optional[ResourceOptions] = None)
@overload
def LinuxVirtualMachine(resource_name: str,
opts: Optional[ResourceOptions] = None,
size: Optional[str] = None,
lab_name: Optional[str] = None,
username: Optional[str] = None,
storage_type: Optional[str] = None,
resource_group_name: Optional[str] = None,
lab_subnet_name: Optional[str] = None,
lab_virtual_network_id: Optional[str] = None,
gallery_image_reference: Optional[LinuxVirtualMachineGalleryImageReferenceArgs] = None,
password: Optional[str] = None,
disallow_public_ip_address: Optional[bool] = None,
location: Optional[str] = None,
notes: Optional[str] = None,
allow_claim: Optional[bool] = None,
ssh_key: Optional[str] = None,
inbound_nat_rules: Optional[Sequence[LinuxVirtualMachineInboundNatRuleArgs]] = None,
tags: Optional[Mapping[str, str]] = None,
name: Optional[str] = None)
func NewLinuxVirtualMachine(ctx *Context, name string, args LinuxVirtualMachineArgs, opts ...ResourceOption) (*LinuxVirtualMachine, error)
public LinuxVirtualMachine(string name, LinuxVirtualMachineArgs args, CustomResourceOptions? opts = null)
public LinuxVirtualMachine(String name, LinuxVirtualMachineArgs args)
public LinuxVirtualMachine(String name, LinuxVirtualMachineArgs args, CustomResourceOptions options)
type: azure:devtest:LinuxVirtualMachine
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args LinuxVirtualMachineArgs
- 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 LinuxVirtualMachineArgs
- 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 LinuxVirtualMachineArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args LinuxVirtualMachineArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args LinuxVirtualMachineArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var azureLinuxVirtualMachineResource = new Azure.DevTest.LinuxVirtualMachine("azureLinuxVirtualMachineResource", new()
{
Size = "string",
LabName = "string",
Username = "string",
StorageType = "string",
ResourceGroupName = "string",
LabSubnetName = "string",
LabVirtualNetworkId = "string",
GalleryImageReference = new Azure.DevTest.Inputs.LinuxVirtualMachineGalleryImageReferenceArgs
{
Offer = "string",
Publisher = "string",
Sku = "string",
Version = "string",
},
Password = "string",
DisallowPublicIpAddress = false,
Location = "string",
Notes = "string",
AllowClaim = false,
SshKey = "string",
InboundNatRules = new[]
{
new Azure.DevTest.Inputs.LinuxVirtualMachineInboundNatRuleArgs
{
BackendPort = 0,
Protocol = "string",
FrontendPort = 0,
},
},
Tags =
{
{ "string", "string" },
},
Name = "string",
});
example, err := devtest.NewLinuxVirtualMachine(ctx, "azureLinuxVirtualMachineResource", &devtest.LinuxVirtualMachineArgs{
Size: pulumi.String("string"),
LabName: pulumi.String("string"),
Username: pulumi.String("string"),
StorageType: pulumi.String("string"),
ResourceGroupName: pulumi.String("string"),
LabSubnetName: pulumi.String("string"),
LabVirtualNetworkId: pulumi.String("string"),
GalleryImageReference: &devtest.LinuxVirtualMachineGalleryImageReferenceArgs{
Offer: pulumi.String("string"),
Publisher: pulumi.String("string"),
Sku: pulumi.String("string"),
Version: pulumi.String("string"),
},
Password: pulumi.String("string"),
DisallowPublicIpAddress: pulumi.Bool(false),
Location: pulumi.String("string"),
Notes: pulumi.String("string"),
AllowClaim: pulumi.Bool(false),
SshKey: pulumi.String("string"),
InboundNatRules: devtest.LinuxVirtualMachineInboundNatRuleArray{
&devtest.LinuxVirtualMachineInboundNatRuleArgs{
BackendPort: pulumi.Int(0),
Protocol: pulumi.String("string"),
FrontendPort: pulumi.Int(0),
},
},
Tags: pulumi.StringMap{
"string": pulumi.String("string"),
},
Name: pulumi.String("string"),
})
var azureLinuxVirtualMachineResource = new LinuxVirtualMachine("azureLinuxVirtualMachineResource", LinuxVirtualMachineArgs.builder()
.size("string")
.labName("string")
.username("string")
.storageType("string")
.resourceGroupName("string")
.labSubnetName("string")
.labVirtualNetworkId("string")
.galleryImageReference(LinuxVirtualMachineGalleryImageReferenceArgs.builder()
.offer("string")
.publisher("string")
.sku("string")
.version("string")
.build())
.password("string")
.disallowPublicIpAddress(false)
.location("string")
.notes("string")
.allowClaim(false)
.sshKey("string")
.inboundNatRules(LinuxVirtualMachineInboundNatRuleArgs.builder()
.backendPort(0)
.protocol("string")
.frontendPort(0)
.build())
.tags(Map.of("string", "string"))
.name("string")
.build());
azure_linux_virtual_machine_resource = azure.devtest.LinuxVirtualMachine("azureLinuxVirtualMachineResource",
size="string",
lab_name="string",
username="string",
storage_type="string",
resource_group_name="string",
lab_subnet_name="string",
lab_virtual_network_id="string",
gallery_image_reference={
"offer": "string",
"publisher": "string",
"sku": "string",
"version": "string",
},
password="string",
disallow_public_ip_address=False,
location="string",
notes="string",
allow_claim=False,
ssh_key="string",
inbound_nat_rules=[{
"backend_port": 0,
"protocol": "string",
"frontend_port": 0,
}],
tags={
"string": "string",
},
name="string")
const azureLinuxVirtualMachineResource = new azure.devtest.LinuxVirtualMachine("azureLinuxVirtualMachineResource", {
size: "string",
labName: "string",
username: "string",
storageType: "string",
resourceGroupName: "string",
labSubnetName: "string",
labVirtualNetworkId: "string",
galleryImageReference: {
offer: "string",
publisher: "string",
sku: "string",
version: "string",
},
password: "string",
disallowPublicIpAddress: false,
location: "string",
notes: "string",
allowClaim: false,
sshKey: "string",
inboundNatRules: [{
backendPort: 0,
protocol: "string",
frontendPort: 0,
}],
tags: {
string: "string",
},
name: "string",
});
type: azure:devtest:LinuxVirtualMachine
properties:
allowClaim: false
disallowPublicIpAddress: false
galleryImageReference:
offer: string
publisher: string
sku: string
version: string
inboundNatRules:
- backendPort: 0
frontendPort: 0
protocol: string
labName: string
labSubnetName: string
labVirtualNetworkId: string
location: string
name: string
notes: string
password: string
resourceGroupName: string
size: string
sshKey: string
storageType: string
tags:
string: string
username: string
LinuxVirtualMachine Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The LinuxVirtualMachine resource accepts the following input properties:
- Gallery
Image LinuxReference Virtual Machine Gallery Image Reference - A
gallery_image_reference
block as defined below. - Lab
Name string - Specifies the name of the Dev Test Lab in which the Virtual Machine should be created. Changing this forces a new resource to be created.
- Lab
Subnet stringName - The name of a Subnet within the Dev Test Virtual Network where this machine should exist. Changing this forces a new resource to be created.
- Lab
Virtual stringNetwork Id - The ID of the Dev Test Virtual Network where this Virtual Machine should be created. Changing this forces a new resource to be created.
- Resource
Group stringName - The name of the resource group in which the Dev Test Lab resource exists. Changing this forces a new resource to be created.
- Size string
- The Machine Size to use for this Virtual Machine, such as
Standard_F2
. Changing this forces a new resource to be created. - Storage
Type string - The type of Storage to use on this Virtual Machine. Possible values are
Standard
andPremium
. Changing this forces a new resource to be created. - Username string
- The Username associated with the local administrator on this Virtual Machine. Changing this forces a new resource to be created.
- Allow
Claim bool - Can this Virtual Machine be claimed by users? Defaults to
true
. - Disallow
Public boolIp Address - Should the Virtual Machine be created without a Public IP Address? Changing this forces a new resource to be created.
- Inbound
Nat List<LinuxRules Virtual Machine Inbound Nat Rule> One or more
inbound_nat_rule
blocks as defined below. Changing this forces a new resource to be created.NOTE: If any
inbound_nat_rule
blocks are specified thendisallow_public_ip_address
must be set totrue
.- Location string
- Specifies the supported Azure location where the Dev Test Lab exists. Changing this forces a new resource to be created.
- Name string
Specifies the name of the Dev Test Machine. Changing this forces a new resource to be created.
NOTE: The validation requirements for the Name change based on the
os_type
used in this Virtual Machine. For a Linux VM the name must be between 1-62 characters, and for a Windows VM the name must be between 1-15 characters. It must begin and end with a letter or number, and cannot be all numbers.- Notes string
- Any notes about the Virtual Machine.
- Password string
- The Password associated with the
username
used to login to this Virtual Machine. Changing this forces a new resource to be created. - Ssh
Key string The SSH Key associated with the
username
used to login to this Virtual Machine. Changing this forces a new resource to be created.NOTE: One or either
password
orssh_key
must be specified.- Dictionary<string, string>
- A mapping of tags to assign to the resource.
- Gallery
Image LinuxReference Virtual Machine Gallery Image Reference Args - A
gallery_image_reference
block as defined below. - Lab
Name string - Specifies the name of the Dev Test Lab in which the Virtual Machine should be created. Changing this forces a new resource to be created.
- Lab
Subnet stringName - The name of a Subnet within the Dev Test Virtual Network where this machine should exist. Changing this forces a new resource to be created.
- Lab
Virtual stringNetwork Id - The ID of the Dev Test Virtual Network where this Virtual Machine should be created. Changing this forces a new resource to be created.
- Resource
Group stringName - The name of the resource group in which the Dev Test Lab resource exists. Changing this forces a new resource to be created.
- Size string
- The Machine Size to use for this Virtual Machine, such as
Standard_F2
. Changing this forces a new resource to be created. - Storage
Type string - The type of Storage to use on this Virtual Machine. Possible values are
Standard
andPremium
. Changing this forces a new resource to be created. - Username string
- The Username associated with the local administrator on this Virtual Machine. Changing this forces a new resource to be created.
- Allow
Claim bool - Can this Virtual Machine be claimed by users? Defaults to
true
. - Disallow
Public boolIp Address - Should the Virtual Machine be created without a Public IP Address? Changing this forces a new resource to be created.
- Inbound
Nat []LinuxRules Virtual Machine Inbound Nat Rule Args One or more
inbound_nat_rule
blocks as defined below. Changing this forces a new resource to be created.NOTE: If any
inbound_nat_rule
blocks are specified thendisallow_public_ip_address
must be set totrue
.- Location string
- Specifies the supported Azure location where the Dev Test Lab exists. Changing this forces a new resource to be created.
- Name string
Specifies the name of the Dev Test Machine. Changing this forces a new resource to be created.
NOTE: The validation requirements for the Name change based on the
os_type
used in this Virtual Machine. For a Linux VM the name must be between 1-62 characters, and for a Windows VM the name must be between 1-15 characters. It must begin and end with a letter or number, and cannot be all numbers.- Notes string
- Any notes about the Virtual Machine.
- Password string
- The Password associated with the
username
used to login to this Virtual Machine. Changing this forces a new resource to be created. - Ssh
Key string The SSH Key associated with the
username
used to login to this Virtual Machine. Changing this forces a new resource to be created.NOTE: One or either
password
orssh_key
must be specified.- map[string]string
- A mapping of tags to assign to the resource.
- gallery
Image LinuxReference Virtual Machine Gallery Image Reference - A
gallery_image_reference
block as defined below. - lab
Name String - Specifies the name of the Dev Test Lab in which the Virtual Machine should be created. Changing this forces a new resource to be created.
- lab
Subnet StringName - The name of a Subnet within the Dev Test Virtual Network where this machine should exist. Changing this forces a new resource to be created.
- lab
Virtual StringNetwork Id - The ID of the Dev Test Virtual Network where this Virtual Machine should be created. Changing this forces a new resource to be created.
- resource
Group StringName - The name of the resource group in which the Dev Test Lab resource exists. Changing this forces a new resource to be created.
- size String
- The Machine Size to use for this Virtual Machine, such as
Standard_F2
. Changing this forces a new resource to be created. - storage
Type String - The type of Storage to use on this Virtual Machine. Possible values are
Standard
andPremium
. Changing this forces a new resource to be created. - username String
- The Username associated with the local administrator on this Virtual Machine. Changing this forces a new resource to be created.
- allow
Claim Boolean - Can this Virtual Machine be claimed by users? Defaults to
true
. - disallow
Public BooleanIp Address - Should the Virtual Machine be created without a Public IP Address? Changing this forces a new resource to be created.
- inbound
Nat List<LinuxRules Virtual Machine Inbound Nat Rule> One or more
inbound_nat_rule
blocks as defined below. Changing this forces a new resource to be created.NOTE: If any
inbound_nat_rule
blocks are specified thendisallow_public_ip_address
must be set totrue
.- location String
- Specifies the supported Azure location where the Dev Test Lab exists. Changing this forces a new resource to be created.
- name String
Specifies the name of the Dev Test Machine. Changing this forces a new resource to be created.
NOTE: The validation requirements for the Name change based on the
os_type
used in this Virtual Machine. For a Linux VM the name must be between 1-62 characters, and for a Windows VM the name must be between 1-15 characters. It must begin and end with a letter or number, and cannot be all numbers.- notes String
- Any notes about the Virtual Machine.
- password String
- The Password associated with the
username
used to login to this Virtual Machine. Changing this forces a new resource to be created. - ssh
Key String The SSH Key associated with the
username
used to login to this Virtual Machine. Changing this forces a new resource to be created.NOTE: One or either
password
orssh_key
must be specified.- Map<String,String>
- A mapping of tags to assign to the resource.
- gallery
Image LinuxReference Virtual Machine Gallery Image Reference - A
gallery_image_reference
block as defined below. - lab
Name string - Specifies the name of the Dev Test Lab in which the Virtual Machine should be created. Changing this forces a new resource to be created.
- lab
Subnet stringName - The name of a Subnet within the Dev Test Virtual Network where this machine should exist. Changing this forces a new resource to be created.
- lab
Virtual stringNetwork Id - The ID of the Dev Test Virtual Network where this Virtual Machine should be created. Changing this forces a new resource to be created.
- resource
Group stringName - The name of the resource group in which the Dev Test Lab resource exists. Changing this forces a new resource to be created.
- size string
- The Machine Size to use for this Virtual Machine, such as
Standard_F2
. Changing this forces a new resource to be created. - storage
Type string - The type of Storage to use on this Virtual Machine. Possible values are
Standard
andPremium
. Changing this forces a new resource to be created. - username string
- The Username associated with the local administrator on this Virtual Machine. Changing this forces a new resource to be created.
- allow
Claim boolean - Can this Virtual Machine be claimed by users? Defaults to
true
. - disallow
Public booleanIp Address - Should the Virtual Machine be created without a Public IP Address? Changing this forces a new resource to be created.
- inbound
Nat LinuxRules Virtual Machine Inbound Nat Rule[] One or more
inbound_nat_rule
blocks as defined below. Changing this forces a new resource to be created.NOTE: If any
inbound_nat_rule
blocks are specified thendisallow_public_ip_address
must be set totrue
.- location string
- Specifies the supported Azure location where the Dev Test Lab exists. Changing this forces a new resource to be created.
- name string
Specifies the name of the Dev Test Machine. Changing this forces a new resource to be created.
NOTE: The validation requirements for the Name change based on the
os_type
used in this Virtual Machine. For a Linux VM the name must be between 1-62 characters, and for a Windows VM the name must be between 1-15 characters. It must begin and end with a letter or number, and cannot be all numbers.- notes string
- Any notes about the Virtual Machine.
- password string
- The Password associated with the
username
used to login to this Virtual Machine. Changing this forces a new resource to be created. - ssh
Key string The SSH Key associated with the
username
used to login to this Virtual Machine. Changing this forces a new resource to be created.NOTE: One or either
password
orssh_key
must be specified.- {[key: string]: string}
- A mapping of tags to assign to the resource.
- gallery_
image_ Linuxreference Virtual Machine Gallery Image Reference Args - A
gallery_image_reference
block as defined below. - lab_
name str - Specifies the name of the Dev Test Lab in which the Virtual Machine should be created. Changing this forces a new resource to be created.
- lab_
subnet_ strname - The name of a Subnet within the Dev Test Virtual Network where this machine should exist. Changing this forces a new resource to be created.
- lab_
virtual_ strnetwork_ id - The ID of the Dev Test Virtual Network where this Virtual Machine should be created. Changing this forces a new resource to be created.
- resource_
group_ strname - The name of the resource group in which the Dev Test Lab resource exists. Changing this forces a new resource to be created.
- size str
- The Machine Size to use for this Virtual Machine, such as
Standard_F2
. Changing this forces a new resource to be created. - storage_
type str - The type of Storage to use on this Virtual Machine. Possible values are
Standard
andPremium
. Changing this forces a new resource to be created. - username str
- The Username associated with the local administrator on this Virtual Machine. Changing this forces a new resource to be created.
- allow_
claim bool - Can this Virtual Machine be claimed by users? Defaults to
true
. - disallow_
public_ boolip_ address - Should the Virtual Machine be created without a Public IP Address? Changing this forces a new resource to be created.
- inbound_
nat_ Sequence[Linuxrules Virtual Machine Inbound Nat Rule Args] One or more
inbound_nat_rule
blocks as defined below. Changing this forces a new resource to be created.NOTE: If any
inbound_nat_rule
blocks are specified thendisallow_public_ip_address
must be set totrue
.- location str
- Specifies the supported Azure location where the Dev Test Lab exists. Changing this forces a new resource to be created.
- name str
Specifies the name of the Dev Test Machine. Changing this forces a new resource to be created.
NOTE: The validation requirements for the Name change based on the
os_type
used in this Virtual Machine. For a Linux VM the name must be between 1-62 characters, and for a Windows VM the name must be between 1-15 characters. It must begin and end with a letter or number, and cannot be all numbers.- notes str
- Any notes about the Virtual Machine.
- password str
- The Password associated with the
username
used to login to this Virtual Machine. Changing this forces a new resource to be created. - ssh_
key str The SSH Key associated with the
username
used to login to this Virtual Machine. Changing this forces a new resource to be created.NOTE: One or either
password
orssh_key
must be specified.- Mapping[str, str]
- A mapping of tags to assign to the resource.
- gallery
Image Property MapReference - A
gallery_image_reference
block as defined below. - lab
Name String - Specifies the name of the Dev Test Lab in which the Virtual Machine should be created. Changing this forces a new resource to be created.
- lab
Subnet StringName - The name of a Subnet within the Dev Test Virtual Network where this machine should exist. Changing this forces a new resource to be created.
- lab
Virtual StringNetwork Id - The ID of the Dev Test Virtual Network where this Virtual Machine should be created. Changing this forces a new resource to be created.
- resource
Group StringName - The name of the resource group in which the Dev Test Lab resource exists. Changing this forces a new resource to be created.
- size String
- The Machine Size to use for this Virtual Machine, such as
Standard_F2
. Changing this forces a new resource to be created. - storage
Type String - The type of Storage to use on this Virtual Machine. Possible values are
Standard
andPremium
. Changing this forces a new resource to be created. - username String
- The Username associated with the local administrator on this Virtual Machine. Changing this forces a new resource to be created.
- allow
Claim Boolean - Can this Virtual Machine be claimed by users? Defaults to
true
. - disallow
Public BooleanIp Address - Should the Virtual Machine be created without a Public IP Address? Changing this forces a new resource to be created.
- inbound
Nat List<Property Map>Rules One or more
inbound_nat_rule
blocks as defined below. Changing this forces a new resource to be created.NOTE: If any
inbound_nat_rule
blocks are specified thendisallow_public_ip_address
must be set totrue
.- location String
- Specifies the supported Azure location where the Dev Test Lab exists. Changing this forces a new resource to be created.
- name String
Specifies the name of the Dev Test Machine. Changing this forces a new resource to be created.
NOTE: The validation requirements for the Name change based on the
os_type
used in this Virtual Machine. For a Linux VM the name must be between 1-62 characters, and for a Windows VM the name must be between 1-15 characters. It must begin and end with a letter or number, and cannot be all numbers.- notes String
- Any notes about the Virtual Machine.
- password String
- The Password associated with the
username
used to login to this Virtual Machine. Changing this forces a new resource to be created. - ssh
Key String The SSH Key associated with the
username
used to login to this Virtual Machine. Changing this forces a new resource to be created.NOTE: One or either
password
orssh_key
must be specified.- Map<String>
- A mapping of tags to assign to the resource.
Outputs
All input properties are implicitly available as output properties. Additionally, the LinuxVirtualMachine resource produces the following output properties:
- Fqdn string
- The FQDN of the Virtual Machine.
- Id string
- The provider-assigned unique ID for this managed resource.
- Unique
Identifier string - The unique immutable identifier of the Virtual Machine.
- Fqdn string
- The FQDN of the Virtual Machine.
- Id string
- The provider-assigned unique ID for this managed resource.
- Unique
Identifier string - The unique immutable identifier of the Virtual Machine.
- fqdn String
- The FQDN of the Virtual Machine.
- id String
- The provider-assigned unique ID for this managed resource.
- unique
Identifier String - The unique immutable identifier of the Virtual Machine.
- fqdn string
- The FQDN of the Virtual Machine.
- id string
- The provider-assigned unique ID for this managed resource.
- unique
Identifier string - The unique immutable identifier of the Virtual Machine.
- fqdn str
- The FQDN of the Virtual Machine.
- id str
- The provider-assigned unique ID for this managed resource.
- unique_
identifier str - The unique immutable identifier of the Virtual Machine.
- fqdn String
- The FQDN of the Virtual Machine.
- id String
- The provider-assigned unique ID for this managed resource.
- unique
Identifier String - The unique immutable identifier of the Virtual Machine.
Look up Existing LinuxVirtualMachine Resource
Get an existing LinuxVirtualMachine 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?: LinuxVirtualMachineState, opts?: CustomResourceOptions): LinuxVirtualMachine
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
allow_claim: Optional[bool] = None,
disallow_public_ip_address: Optional[bool] = None,
fqdn: Optional[str] = None,
gallery_image_reference: Optional[LinuxVirtualMachineGalleryImageReferenceArgs] = None,
inbound_nat_rules: Optional[Sequence[LinuxVirtualMachineInboundNatRuleArgs]] = None,
lab_name: Optional[str] = None,
lab_subnet_name: Optional[str] = None,
lab_virtual_network_id: Optional[str] = None,
location: Optional[str] = None,
name: Optional[str] = None,
notes: Optional[str] = None,
password: Optional[str] = None,
resource_group_name: Optional[str] = None,
size: Optional[str] = None,
ssh_key: Optional[str] = None,
storage_type: Optional[str] = None,
tags: Optional[Mapping[str, str]] = None,
unique_identifier: Optional[str] = None,
username: Optional[str] = None) -> LinuxVirtualMachine
func GetLinuxVirtualMachine(ctx *Context, name string, id IDInput, state *LinuxVirtualMachineState, opts ...ResourceOption) (*LinuxVirtualMachine, error)
public static LinuxVirtualMachine Get(string name, Input<string> id, LinuxVirtualMachineState? state, CustomResourceOptions? opts = null)
public static LinuxVirtualMachine get(String name, Output<String> id, LinuxVirtualMachineState 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.
- Allow
Claim bool - Can this Virtual Machine be claimed by users? Defaults to
true
. - Disallow
Public boolIp Address - Should the Virtual Machine be created without a Public IP Address? Changing this forces a new resource to be created.
- Fqdn string
- The FQDN of the Virtual Machine.
- Gallery
Image LinuxReference Virtual Machine Gallery Image Reference - A
gallery_image_reference
block as defined below. - Inbound
Nat List<LinuxRules Virtual Machine Inbound Nat Rule> One or more
inbound_nat_rule
blocks as defined below. Changing this forces a new resource to be created.NOTE: If any
inbound_nat_rule
blocks are specified thendisallow_public_ip_address
must be set totrue
.- Lab
Name string - Specifies the name of the Dev Test Lab in which the Virtual Machine should be created. Changing this forces a new resource to be created.
- Lab
Subnet stringName - The name of a Subnet within the Dev Test Virtual Network where this machine should exist. Changing this forces a new resource to be created.
- Lab
Virtual stringNetwork Id - The ID of the Dev Test Virtual Network where this Virtual Machine should be created. Changing this forces a new resource to be created.
- Location string
- Specifies the supported Azure location where the Dev Test Lab exists. Changing this forces a new resource to be created.
- Name string
Specifies the name of the Dev Test Machine. Changing this forces a new resource to be created.
NOTE: The validation requirements for the Name change based on the
os_type
used in this Virtual Machine. For a Linux VM the name must be between 1-62 characters, and for a Windows VM the name must be between 1-15 characters. It must begin and end with a letter or number, and cannot be all numbers.- Notes string
- Any notes about the Virtual Machine.
- Password string
- The Password associated with the
username
used to login to this Virtual Machine. Changing this forces a new resource to be created. - Resource
Group stringName - The name of the resource group in which the Dev Test Lab resource exists. Changing this forces a new resource to be created.
- Size string
- The Machine Size to use for this Virtual Machine, such as
Standard_F2
. Changing this forces a new resource to be created. - Ssh
Key string The SSH Key associated with the
username
used to login to this Virtual Machine. Changing this forces a new resource to be created.NOTE: One or either
password
orssh_key
must be specified.- Storage
Type string - The type of Storage to use on this Virtual Machine. Possible values are
Standard
andPremium
. Changing this forces a new resource to be created. - Dictionary<string, string>
- A mapping of tags to assign to the resource.
- Unique
Identifier string - The unique immutable identifier of the Virtual Machine.
- Username string
- The Username associated with the local administrator on this Virtual Machine. Changing this forces a new resource to be created.
- Allow
Claim bool - Can this Virtual Machine be claimed by users? Defaults to
true
. - Disallow
Public boolIp Address - Should the Virtual Machine be created without a Public IP Address? Changing this forces a new resource to be created.
- Fqdn string
- The FQDN of the Virtual Machine.
- Gallery
Image LinuxReference Virtual Machine Gallery Image Reference Args - A
gallery_image_reference
block as defined below. - Inbound
Nat []LinuxRules Virtual Machine Inbound Nat Rule Args One or more
inbound_nat_rule
blocks as defined below. Changing this forces a new resource to be created.NOTE: If any
inbound_nat_rule
blocks are specified thendisallow_public_ip_address
must be set totrue
.- Lab
Name string - Specifies the name of the Dev Test Lab in which the Virtual Machine should be created. Changing this forces a new resource to be created.
- Lab
Subnet stringName - The name of a Subnet within the Dev Test Virtual Network where this machine should exist. Changing this forces a new resource to be created.
- Lab
Virtual stringNetwork Id - The ID of the Dev Test Virtual Network where this Virtual Machine should be created. Changing this forces a new resource to be created.
- Location string
- Specifies the supported Azure location where the Dev Test Lab exists. Changing this forces a new resource to be created.
- Name string
Specifies the name of the Dev Test Machine. Changing this forces a new resource to be created.
NOTE: The validation requirements for the Name change based on the
os_type
used in this Virtual Machine. For a Linux VM the name must be between 1-62 characters, and for a Windows VM the name must be between 1-15 characters. It must begin and end with a letter or number, and cannot be all numbers.- Notes string
- Any notes about the Virtual Machine.
- Password string
- The Password associated with the
username
used to login to this Virtual Machine. Changing this forces a new resource to be created. - Resource
Group stringName - The name of the resource group in which the Dev Test Lab resource exists. Changing this forces a new resource to be created.
- Size string
- The Machine Size to use for this Virtual Machine, such as
Standard_F2
. Changing this forces a new resource to be created. - Ssh
Key string The SSH Key associated with the
username
used to login to this Virtual Machine. Changing this forces a new resource to be created.NOTE: One or either
password
orssh_key
must be specified.- Storage
Type string - The type of Storage to use on this Virtual Machine. Possible values are
Standard
andPremium
. Changing this forces a new resource to be created. - map[string]string
- A mapping of tags to assign to the resource.
- Unique
Identifier string - The unique immutable identifier of the Virtual Machine.
- Username string
- The Username associated with the local administrator on this Virtual Machine. Changing this forces a new resource to be created.
- allow
Claim Boolean - Can this Virtual Machine be claimed by users? Defaults to
true
. - disallow
Public BooleanIp Address - Should the Virtual Machine be created without a Public IP Address? Changing this forces a new resource to be created.
- fqdn String
- The FQDN of the Virtual Machine.
- gallery
Image LinuxReference Virtual Machine Gallery Image Reference - A
gallery_image_reference
block as defined below. - inbound
Nat List<LinuxRules Virtual Machine Inbound Nat Rule> One or more
inbound_nat_rule
blocks as defined below. Changing this forces a new resource to be created.NOTE: If any
inbound_nat_rule
blocks are specified thendisallow_public_ip_address
must be set totrue
.- lab
Name String - Specifies the name of the Dev Test Lab in which the Virtual Machine should be created. Changing this forces a new resource to be created.
- lab
Subnet StringName - The name of a Subnet within the Dev Test Virtual Network where this machine should exist. Changing this forces a new resource to be created.
- lab
Virtual StringNetwork Id - The ID of the Dev Test Virtual Network where this Virtual Machine should be created. Changing this forces a new resource to be created.
- location String
- Specifies the supported Azure location where the Dev Test Lab exists. Changing this forces a new resource to be created.
- name String
Specifies the name of the Dev Test Machine. Changing this forces a new resource to be created.
NOTE: The validation requirements for the Name change based on the
os_type
used in this Virtual Machine. For a Linux VM the name must be between 1-62 characters, and for a Windows VM the name must be between 1-15 characters. It must begin and end with a letter or number, and cannot be all numbers.- notes String
- Any notes about the Virtual Machine.
- password String
- The Password associated with the
username
used to login to this Virtual Machine. Changing this forces a new resource to be created. - resource
Group StringName - The name of the resource group in which the Dev Test Lab resource exists. Changing this forces a new resource to be created.
- size String
- The Machine Size to use for this Virtual Machine, such as
Standard_F2
. Changing this forces a new resource to be created. - ssh
Key String The SSH Key associated with the
username
used to login to this Virtual Machine. Changing this forces a new resource to be created.NOTE: One or either
password
orssh_key
must be specified.- storage
Type String - The type of Storage to use on this Virtual Machine. Possible values are
Standard
andPremium
. Changing this forces a new resource to be created. - Map<String,String>
- A mapping of tags to assign to the resource.
- unique
Identifier String - The unique immutable identifier of the Virtual Machine.
- username String
- The Username associated with the local administrator on this Virtual Machine. Changing this forces a new resource to be created.
- allow
Claim boolean - Can this Virtual Machine be claimed by users? Defaults to
true
. - disallow
Public booleanIp Address - Should the Virtual Machine be created without a Public IP Address? Changing this forces a new resource to be created.
- fqdn string
- The FQDN of the Virtual Machine.
- gallery
Image LinuxReference Virtual Machine Gallery Image Reference - A
gallery_image_reference
block as defined below. - inbound
Nat LinuxRules Virtual Machine Inbound Nat Rule[] One or more
inbound_nat_rule
blocks as defined below. Changing this forces a new resource to be created.NOTE: If any
inbound_nat_rule
blocks are specified thendisallow_public_ip_address
must be set totrue
.- lab
Name string - Specifies the name of the Dev Test Lab in which the Virtual Machine should be created. Changing this forces a new resource to be created.
- lab
Subnet stringName - The name of a Subnet within the Dev Test Virtual Network where this machine should exist. Changing this forces a new resource to be created.
- lab
Virtual stringNetwork Id - The ID of the Dev Test Virtual Network where this Virtual Machine should be created. Changing this forces a new resource to be created.
- location string
- Specifies the supported Azure location where the Dev Test Lab exists. Changing this forces a new resource to be created.
- name string
Specifies the name of the Dev Test Machine. Changing this forces a new resource to be created.
NOTE: The validation requirements for the Name change based on the
os_type
used in this Virtual Machine. For a Linux VM the name must be between 1-62 characters, and for a Windows VM the name must be between 1-15 characters. It must begin and end with a letter or number, and cannot be all numbers.- notes string
- Any notes about the Virtual Machine.
- password string
- The Password associated with the
username
used to login to this Virtual Machine. Changing this forces a new resource to be created. - resource
Group stringName - The name of the resource group in which the Dev Test Lab resource exists. Changing this forces a new resource to be created.
- size string
- The Machine Size to use for this Virtual Machine, such as
Standard_F2
. Changing this forces a new resource to be created. - ssh
Key string The SSH Key associated with the
username
used to login to this Virtual Machine. Changing this forces a new resource to be created.NOTE: One or either
password
orssh_key
must be specified.- storage
Type string - The type of Storage to use on this Virtual Machine. Possible values are
Standard
andPremium
. Changing this forces a new resource to be created. - {[key: string]: string}
- A mapping of tags to assign to the resource.
- unique
Identifier string - The unique immutable identifier of the Virtual Machine.
- username string
- The Username associated with the local administrator on this Virtual Machine. Changing this forces a new resource to be created.
- allow_
claim bool - Can this Virtual Machine be claimed by users? Defaults to
true
. - disallow_
public_ boolip_ address - Should the Virtual Machine be created without a Public IP Address? Changing this forces a new resource to be created.
- fqdn str
- The FQDN of the Virtual Machine.
- gallery_
image_ Linuxreference Virtual Machine Gallery Image Reference Args - A
gallery_image_reference
block as defined below. - inbound_
nat_ Sequence[Linuxrules Virtual Machine Inbound Nat Rule Args] One or more
inbound_nat_rule
blocks as defined below. Changing this forces a new resource to be created.NOTE: If any
inbound_nat_rule
blocks are specified thendisallow_public_ip_address
must be set totrue
.- lab_
name str - Specifies the name of the Dev Test Lab in which the Virtual Machine should be created. Changing this forces a new resource to be created.
- lab_
subnet_ strname - The name of a Subnet within the Dev Test Virtual Network where this machine should exist. Changing this forces a new resource to be created.
- lab_
virtual_ strnetwork_ id - The ID of the Dev Test Virtual Network where this Virtual Machine should be created. Changing this forces a new resource to be created.
- location str
- Specifies the supported Azure location where the Dev Test Lab exists. Changing this forces a new resource to be created.
- name str
Specifies the name of the Dev Test Machine. Changing this forces a new resource to be created.
NOTE: The validation requirements for the Name change based on the
os_type
used in this Virtual Machine. For a Linux VM the name must be between 1-62 characters, and for a Windows VM the name must be between 1-15 characters. It must begin and end with a letter or number, and cannot be all numbers.- notes str
- Any notes about the Virtual Machine.
- password str
- The Password associated with the
username
used to login to this Virtual Machine. Changing this forces a new resource to be created. - resource_
group_ strname - The name of the resource group in which the Dev Test Lab resource exists. Changing this forces a new resource to be created.
- size str
- The Machine Size to use for this Virtual Machine, such as
Standard_F2
. Changing this forces a new resource to be created. - ssh_
key str The SSH Key associated with the
username
used to login to this Virtual Machine. Changing this forces a new resource to be created.NOTE: One or either
password
orssh_key
must be specified.- storage_
type str - The type of Storage to use on this Virtual Machine. Possible values are
Standard
andPremium
. Changing this forces a new resource to be created. - Mapping[str, str]
- A mapping of tags to assign to the resource.
- unique_
identifier str - The unique immutable identifier of the Virtual Machine.
- username str
- The Username associated with the local administrator on this Virtual Machine. Changing this forces a new resource to be created.
- allow
Claim Boolean - Can this Virtual Machine be claimed by users? Defaults to
true
. - disallow
Public BooleanIp Address - Should the Virtual Machine be created without a Public IP Address? Changing this forces a new resource to be created.
- fqdn String
- The FQDN of the Virtual Machine.
- gallery
Image Property MapReference - A
gallery_image_reference
block as defined below. - inbound
Nat List<Property Map>Rules One or more
inbound_nat_rule
blocks as defined below. Changing this forces a new resource to be created.NOTE: If any
inbound_nat_rule
blocks are specified thendisallow_public_ip_address
must be set totrue
.- lab
Name String - Specifies the name of the Dev Test Lab in which the Virtual Machine should be created. Changing this forces a new resource to be created.
- lab
Subnet StringName - The name of a Subnet within the Dev Test Virtual Network where this machine should exist. Changing this forces a new resource to be created.
- lab
Virtual StringNetwork Id - The ID of the Dev Test Virtual Network where this Virtual Machine should be created. Changing this forces a new resource to be created.
- location String
- Specifies the supported Azure location where the Dev Test Lab exists. Changing this forces a new resource to be created.
- name String
Specifies the name of the Dev Test Machine. Changing this forces a new resource to be created.
NOTE: The validation requirements for the Name change based on the
os_type
used in this Virtual Machine. For a Linux VM the name must be between 1-62 characters, and for a Windows VM the name must be between 1-15 characters. It must begin and end with a letter or number, and cannot be all numbers.- notes String
- Any notes about the Virtual Machine.
- password String
- The Password associated with the
username
used to login to this Virtual Machine. Changing this forces a new resource to be created. - resource
Group StringName - The name of the resource group in which the Dev Test Lab resource exists. Changing this forces a new resource to be created.
- size String
- The Machine Size to use for this Virtual Machine, such as
Standard_F2
. Changing this forces a new resource to be created. - ssh
Key String The SSH Key associated with the
username
used to login to this Virtual Machine. Changing this forces a new resource to be created.NOTE: One or either
password
orssh_key
must be specified.- storage
Type String - The type of Storage to use on this Virtual Machine. Possible values are
Standard
andPremium
. Changing this forces a new resource to be created. - Map<String>
- A mapping of tags to assign to the resource.
- unique
Identifier String - The unique immutable identifier of the Virtual Machine.
- username String
- The Username associated with the local administrator on this Virtual Machine. Changing this forces a new resource to be created.
Supporting Types
LinuxVirtualMachineGalleryImageReference, LinuxVirtualMachineGalleryImageReferenceArgs
- Offer string
- The Offer of the Gallery Image. Changing this forces a new resource to be created.
- Publisher string
- The Publisher of the Gallery Image. Changing this forces a new resource to be created.
- Sku string
- The SKU of the Gallery Image. Changing this forces a new resource to be created.
- Version string
- The Version of the Gallery Image. Changing this forces a new resource to be created.
- Offer string
- The Offer of the Gallery Image. Changing this forces a new resource to be created.
- Publisher string
- The Publisher of the Gallery Image. Changing this forces a new resource to be created.
- Sku string
- The SKU of the Gallery Image. Changing this forces a new resource to be created.
- Version string
- The Version of the Gallery Image. Changing this forces a new resource to be created.
- offer String
- The Offer of the Gallery Image. Changing this forces a new resource to be created.
- publisher String
- The Publisher of the Gallery Image. Changing this forces a new resource to be created.
- sku String
- The SKU of the Gallery Image. Changing this forces a new resource to be created.
- version String
- The Version of the Gallery Image. Changing this forces a new resource to be created.
- offer string
- The Offer of the Gallery Image. Changing this forces a new resource to be created.
- publisher string
- The Publisher of the Gallery Image. Changing this forces a new resource to be created.
- sku string
- The SKU of the Gallery Image. Changing this forces a new resource to be created.
- version string
- The Version of the Gallery Image. Changing this forces a new resource to be created.
- offer str
- The Offer of the Gallery Image. Changing this forces a new resource to be created.
- publisher str
- The Publisher of the Gallery Image. Changing this forces a new resource to be created.
- sku str
- The SKU of the Gallery Image. Changing this forces a new resource to be created.
- version str
- The Version of the Gallery Image. Changing this forces a new resource to be created.
- offer String
- The Offer of the Gallery Image. Changing this forces a new resource to be created.
- publisher String
- The Publisher of the Gallery Image. Changing this forces a new resource to be created.
- sku String
- The SKU of the Gallery Image. Changing this forces a new resource to be created.
- version String
- The Version of the Gallery Image. Changing this forces a new resource to be created.
LinuxVirtualMachineInboundNatRule, LinuxVirtualMachineInboundNatRuleArgs
- Backend
Port int - The Backend Port associated with this NAT Rule. Changing this forces a new resource to be created.
- Protocol string
- The Protocol used for this NAT Rule. Possible values are
Tcp
andUdp
. - Frontend
Port int - The frontend port associated with this Inbound NAT Rule.
- Backend
Port int - The Backend Port associated with this NAT Rule. Changing this forces a new resource to be created.
- Protocol string
- The Protocol used for this NAT Rule. Possible values are
Tcp
andUdp
. - Frontend
Port int - The frontend port associated with this Inbound NAT Rule.
- backend
Port Integer - The Backend Port associated with this NAT Rule. Changing this forces a new resource to be created.
- protocol String
- The Protocol used for this NAT Rule. Possible values are
Tcp
andUdp
. - frontend
Port Integer - The frontend port associated with this Inbound NAT Rule.
- backend
Port number - The Backend Port associated with this NAT Rule. Changing this forces a new resource to be created.
- protocol string
- The Protocol used for this NAT Rule. Possible values are
Tcp
andUdp
. - frontend
Port number - The frontend port associated with this Inbound NAT Rule.
- backend_
port int - The Backend Port associated with this NAT Rule. Changing this forces a new resource to be created.
- protocol str
- The Protocol used for this NAT Rule. Possible values are
Tcp
andUdp
. - frontend_
port int - The frontend port associated with this Inbound NAT Rule.
- backend
Port Number - The Backend Port associated with this NAT Rule. Changing this forces a new resource to be created.
- protocol String
- The Protocol used for this NAT Rule. Possible values are
Tcp
andUdp
. - frontend
Port Number - The frontend port associated with this Inbound NAT Rule.
Import
Dev Test Linux Virtual Machines can be imported using the resource id
, e.g.
$ pulumi import azure:devtest/linuxVirtualMachine:LinuxVirtualMachine machine1 /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/group1/providers/Microsoft.DevTestLab/labs/lab1/virtualMachines/machine1
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Azure Classic pulumi/pulumi-azure
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
azurerm
Terraform Provider.