published on Wednesday, Nov 4, 2026 by e-breuninger
published on Wednesday, Nov 4, 2026 by e-breuninger
A virtual machine (virtualization.virtualmachine).
From the official documentation:
A virtual machine is a virtualized compute instance. These behave in NetBox very similarly to device objects, but without any physical attributes. For example, a VM may have interfaces assigned to it with IP addresses and VLANs, however its interfaces cannot be connected via cables (because they are virtual). Each VM may also define its compute, memory, and storage resources as well.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as netbox from "@pulumi/netbox";
const test = netbox.getVirtualMachine({
name: "test-virtual_machine",
});
import pulumi
import pulumi_netbox as netbox
test = netbox.get_virtual_machine(name="test-virtual_machine")
package main
import (
"github.com/pulumi/pulumi-terraform-provider/sdks/go/netbox/v6/netbox"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := netbox.LookupVirtualMachine(ctx, &netbox.LookupVirtualMachineArgs{
Name: pulumi.StringRef("test-virtual_machine"),
}, nil)
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Netbox = Pulumi.Netbox;
return await Deployment.RunAsync(() =>
{
var test = Netbox.GetVirtualMachine.Invoke(new()
{
Name = "test-virtual_machine",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.netbox.NetboxFunctions;
import com.pulumi.netbox.inputs.GetVirtualMachineArgs;
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) {
final var test = NetboxFunctions.getVirtualMachine(GetVirtualMachineArgs.builder()
.name("test-virtual_machine")
.build());
}
}
variables:
test:
fn::invoke:
function: netbox:getVirtualMachine
arguments:
name: test-virtual_machine
Example coming soon!
Using getVirtualMachine
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getVirtualMachine(args: GetVirtualMachineArgs, opts?: InvokeOptions): Promise<GetVirtualMachineResult>
function getVirtualMachineOutput(args: GetVirtualMachineOutputArgs, opts?: InvokeOutputOptions): Output<GetVirtualMachineResult>def get_virtual_machine(cluster_group_slug: Optional[str] = None,
cluster_id: Optional[float] = None,
custom_field_filters: Optional[Mapping[str, str]] = None,
device_id: Optional[float] = None,
device_name: Optional[str] = None,
id: Optional[float] = None,
name: Optional[str] = None,
owner_id: Optional[float] = None,
platform_id: Optional[float] = None,
platform_slug: Optional[str] = None,
region_slug: Optional[str] = None,
role_id: Optional[float] = None,
role_slug: Optional[str] = None,
site_id: Optional[float] = None,
site_slug: Optional[str] = None,
status: Optional[str] = None,
tag_slug: Optional[str] = None,
tenant_id: Optional[float] = None,
opts: Optional[InvokeOptions] = None) -> GetVirtualMachineResult
def get_virtual_machine_output(cluster_group_slug: pulumi.Input[Optional[str]] = None,
cluster_id: pulumi.Input[Optional[float]] = None,
custom_field_filters: pulumi.Input[Optional[Mapping[str, pulumi.Input[str]]]] = None,
device_id: pulumi.Input[Optional[float]] = None,
device_name: pulumi.Input[Optional[str]] = None,
id: pulumi.Input[Optional[float]] = None,
name: pulumi.Input[Optional[str]] = None,
owner_id: pulumi.Input[Optional[float]] = None,
platform_id: pulumi.Input[Optional[float]] = None,
platform_slug: pulumi.Input[Optional[str]] = None,
region_slug: pulumi.Input[Optional[str]] = None,
role_id: pulumi.Input[Optional[float]] = None,
role_slug: pulumi.Input[Optional[str]] = None,
site_id: pulumi.Input[Optional[float]] = None,
site_slug: pulumi.Input[Optional[str]] = None,
status: pulumi.Input[Optional[str]] = None,
tag_slug: pulumi.Input[Optional[str]] = None,
tenant_id: pulumi.Input[Optional[float]] = None,
opts: Optional[InvokeOutputOptions] = None) -> Output[GetVirtualMachineResult]func LookupVirtualMachine(ctx *Context, args *LookupVirtualMachineArgs, opts ...InvokeOption) (*LookupVirtualMachineResult, error)
func LookupVirtualMachineOutput(ctx *Context, args *LookupVirtualMachineOutputArgs, opts ...InvokeOption) LookupVirtualMachineResultOutput> Note: This function is named LookupVirtualMachine in the Go SDK.
public static class GetVirtualMachine
{
public static Task<GetVirtualMachineResult> InvokeAsync(GetVirtualMachineArgs args, InvokeOptions? opts = null)
public static Output<GetVirtualMachineResult> Invoke(GetVirtualMachineInvokeArgs args, InvokeOptions? opts = null)
public static Output<GetVirtualMachineResult> Invoke(GetVirtualMachineInvokeArgs args, InvokeOutputOptions opts)
}public static CompletableFuture<GetVirtualMachineResult> getVirtualMachine(GetVirtualMachineArgs args, InvokeOptions options)
public static Output<GetVirtualMachineResult> getVirtualMachine(GetVirtualMachineArgs args, InvokeOptions options)
public static Output<GetVirtualMachineResult> getVirtualMachine(GetVirtualMachineArgs args, InvokeOutputOptions options)
fn::invoke:
function: netbox:index/getVirtualMachine:getVirtualMachine
arguments:
# arguments dictionarydata "netbox_get_virtual_machine" "name" {
# arguments
}The following arguments are supported:
- Cluster
Group stringSlug - Slug of the cluster group.
- Cluster
Id double - Id of the cluster (a virtual machine needs a cluster or a site).
- Custom
Field Dictionary<string, string>Filters - Custom field values to match, by field name, e.g. { tier = "gold" }: each entry filters as cf_\n\n with the field's own filter logic, loose (case-insensitive substring) or exact.
- Device
Id double - Id of the device hosting the VM.
- Device
Name string - Name of the device hosting the virtual machine.
- Id double
- NetBox id.
- Name string
- Owner
Id double - Id of the owner the object is assigned to.
- Platform
Id double - Id of the platform.
- Platform
Slug string - Slug of the platform.
- Region
Slug string - Slug of the region of the site.
- Role
Id double - Id of the functional device role.
- Role
Slug string - Slug of the role.
- Site
Id double - Id of the site (a virtual machine needs a cluster or a site).
- Site
Slug string - Slug of the site.
- Status string
- Operational status. One of: offline, active, planned, staged, failed, decommissioning, paused.
- string
- Slug of a tag the object carries.
- Tenant
Id double - Id of the tenant.
- Cluster
Group stringSlug - Slug of the cluster group.
- Cluster
Id float64 - Id of the cluster (a virtual machine needs a cluster or a site).
- Custom
Field map[string]stringFilters - Custom field values to match, by field name, e.g. { tier = "gold" }: each entry filters as cf_\n\n with the field's own filter logic, loose (case-insensitive substring) or exact.
- Device
Id float64 - Id of the device hosting the VM.
- Device
Name string - Name of the device hosting the virtual machine.
- Id float64
- NetBox id.
- Name string
- Owner
Id float64 - Id of the owner the object is assigned to.
- Platform
Id float64 - Id of the platform.
- Platform
Slug string - Slug of the platform.
- Region
Slug string - Slug of the region of the site.
- Role
Id float64 - Id of the functional device role.
- Role
Slug string - Slug of the role.
- Site
Id float64 - Id of the site (a virtual machine needs a cluster or a site).
- Site
Slug string - Slug of the site.
- Status string
- Operational status. One of: offline, active, planned, staged, failed, decommissioning, paused.
- string
- Slug of a tag the object carries.
- Tenant
Id float64 - Id of the tenant.
- cluster_
group_ stringslug - Slug of the cluster group.
- cluster_
id number - Id of the cluster (a virtual machine needs a cluster or a site).
- custom_
field_ map(string)filters - Custom field values to match, by field name, e.g. { tier = "gold" }: each entry filters as cf_\n\n with the field's own filter logic, loose (case-insensitive substring) or exact.
- device_
id number - Id of the device hosting the VM.
- device_
name string - Name of the device hosting the virtual machine.
- id number
- NetBox id.
- name string
- owner_
id number - Id of the owner the object is assigned to.
- platform_
id number - Id of the platform.
- platform_
slug string - Slug of the platform.
- region_
slug string - Slug of the region of the site.
- role_
id number - Id of the functional device role.
- role_
slug string - Slug of the role.
- site_
id number - Id of the site (a virtual machine needs a cluster or a site).
- site_
slug string - Slug of the site.
- status string
- Operational status. One of: offline, active, planned, staged, failed, decommissioning, paused.
- tag_
slug string - Slug of a tag the object carries.
- tenant_
id number - Id of the tenant.
- cluster
Group StringSlug - Slug of the cluster group.
- cluster
Id Double - Id of the cluster (a virtual machine needs a cluster or a site).
- custom
Field Map<String,String>Filters - Custom field values to match, by field name, e.g. { tier = "gold" }: each entry filters as cf_\n\n with the field's own filter logic, loose (case-insensitive substring) or exact.
- device
Id Double - Id of the device hosting the VM.
- device
Name String - Name of the device hosting the virtual machine.
- id Double
- NetBox id.
- name String
- owner
Id Double - Id of the owner the object is assigned to.
- platform
Id Double - Id of the platform.
- platform
Slug String - Slug of the platform.
- region
Slug String - Slug of the region of the site.
- role
Id Double - Id of the functional device role.
- role
Slug String - Slug of the role.
- site
Id Double - Id of the site (a virtual machine needs a cluster or a site).
- site
Slug String - Slug of the site.
- status String
- Operational status. One of: offline, active, planned, staged, failed, decommissioning, paused.
- String
- Slug of a tag the object carries.
- tenant
Id Double - Id of the tenant.
- cluster
Group stringSlug - Slug of the cluster group.
- cluster
Id number - Id of the cluster (a virtual machine needs a cluster or a site).
- custom
Field {[key: string]: string}Filters - Custom field values to match, by field name, e.g. { tier = "gold" }: each entry filters as cf_\n\n with the field's own filter logic, loose (case-insensitive substring) or exact.
- device
Id number - Id of the device hosting the VM.
- device
Name string - Name of the device hosting the virtual machine.
- id number
- NetBox id.
- name string
- owner
Id number - Id of the owner the object is assigned to.
- platform
Id number - Id of the platform.
- platform
Slug string - Slug of the platform.
- region
Slug string - Slug of the region of the site.
- role
Id number - Id of the functional device role.
- role
Slug string - Slug of the role.
- site
Id number - Id of the site (a virtual machine needs a cluster or a site).
- site
Slug string - Slug of the site.
- status string
- Operational status. One of: offline, active, planned, staged, failed, decommissioning, paused.
- string
- Slug of a tag the object carries.
- tenant
Id number - Id of the tenant.
- cluster_
group_ strslug - Slug of the cluster group.
- cluster_
id float - Id of the cluster (a virtual machine needs a cluster or a site).
- custom_
field_ Mapping[str, str]filters - Custom field values to match, by field name, e.g. { tier = "gold" }: each entry filters as cf_\n\n with the field's own filter logic, loose (case-insensitive substring) or exact.
- device_
id float - Id of the device hosting the VM.
- device_
name str - Name of the device hosting the virtual machine.
- id float
- NetBox id.
- name str
- owner_
id float - Id of the owner the object is assigned to.
- platform_
id float - Id of the platform.
- platform_
slug str - Slug of the platform.
- region_
slug str - Slug of the region of the site.
- role_
id float - Id of the functional device role.
- role_
slug str - Slug of the role.
- site_
id float - Id of the site (a virtual machine needs a cluster or a site).
- site_
slug str - Slug of the site.
- status str
- Operational status. One of: offline, active, planned, staged, failed, decommissioning, paused.
- tag_
slug str - Slug of a tag the object carries.
- tenant_
id float - Id of the tenant.
- cluster
Group StringSlug - Slug of the cluster group.
- cluster
Id Number - Id of the cluster (a virtual machine needs a cluster or a site).
- custom
Field Map<String>Filters - Custom field values to match, by field name, e.g. { tier = "gold" }: each entry filters as cf_\n\n with the field's own filter logic, loose (case-insensitive substring) or exact.
- device
Id Number - Id of the device hosting the VM.
- device
Name String - Name of the device hosting the virtual machine.
- id Number
- NetBox id.
- name String
- owner
Id Number - Id of the owner the object is assigned to.
- platform
Id Number - Id of the platform.
- platform
Slug String - Slug of the platform.
- region
Slug String - Slug of the region of the site.
- role
Id Number - Id of the functional device role.
- role
Slug String - Slug of the role.
- site
Id Number - Id of the site (a virtual machine needs a cluster or a site).
- site
Slug String - Slug of the site.
- status String
- Operational status. One of: offline, active, planned, staged, failed, decommissioning, paused.
- String
- Slug of a tag the object carries.
- tenant
Id Number - Id of the tenant.
getVirtualMachine Result
The following output properties are available:
- Cluster
Id double - Id of the cluster (a virtual machine needs a cluster or a site).
- Comments string
- Config
Context string - Rendered config context (localcontextdata merged with the context assigned through cluster, platform, role, site, tenant and tags) as JSON text, decode with jsondecode().
- Config
Template doubleId - Id of the config template.
- Created string
- Custom
Fields Dictionary<string, string> - Custom field values by field name. Every value is a string; NetBox coerces numbers and booleans. An object field holds the related object's id, e.g. "12", a multiobject field a JSON list of ids in any order, e.g. jsonencode([12, 13]). A key removed from the map is cleared in NetBox (set {} to clear all).
- Description string
- Device
Id double - Id of the device hosting the VM.
- Disk
Size doubleMb - Disk size in MB. Once the machine has virtual disks NetBox computes it as their sum and it can no longer be set; leave it unset then. Must be a whole number.
- Id double
- NetBox id.
- Interface
Count double - Number of interfaces on the virtual machine.
- Last
Updated string - Local
Context stringData - Local config context data as JSON text (use jsonencode()).
- Memory
Mb double - Memory in MB. Must be a whole number.
- Name string
- Owner
Id double - Id of the owner the object is assigned to.
- Platform
Id double - Id of the platform.
- Primary
Ip4Id double - Id of the primary IPv4 address (managed by netboxprimaryip).
- Primary
Ip6Id double - Id of the primary IPv6 address (managed by netboxprimaryip).
- Role
Id double - Id of the functional device role.
- Serial string
- Serial number.
- Site
Id double - Id of the site (a virtual machine needs a cluster or a site).
- Start
On stringBoot - Power state the virtual machine takes when its host boots. One of: on, off, laststate.
- Status string
- Operational status. One of: offline, active, planned, staged, failed, decommissioning, paused.
- List<string>
- Slugs of the tags assigned to the object (the provider's defaulttags are added on top, see tagsall).
- List<string>
- Slugs of all tags on the object, including the provider's default_tags.
- Tenant
Id double - Id of the tenant.
- Url string
- Vcpus double
- Number of virtual CPUs (fractions allowed).
- Virtual
Disk doubleCount - Number of virtual disks on the virtual machine.
- Virtual
Machine doubleType Id - Id of the virtual machine type.
- Cluster
Group stringSlug - Slug of the cluster group.
- Custom
Field Dictionary<string, string>Filters - Custom field values to match, by field name, e.g. { tier = "gold" }: each entry filters as cf_\n\n with the field's own filter logic, loose (case-insensitive substring) or exact.
- Device
Name string - Name of the device hosting the virtual machine.
- Platform
Slug string - Slug of the platform.
- Region
Slug string - Slug of the region of the site.
- Role
Slug string - Slug of the role.
- Site
Slug string - Slug of the site.
- string
- Slug of a tag the object carries.
- Cluster
Id float64 - Id of the cluster (a virtual machine needs a cluster or a site).
- Comments string
- Config
Context string - Rendered config context (localcontextdata merged with the context assigned through cluster, platform, role, site, tenant and tags) as JSON text, decode with jsondecode().
- Config
Template float64Id - Id of the config template.
- Created string
- Custom
Fields map[string]string - Custom field values by field name. Every value is a string; NetBox coerces numbers and booleans. An object field holds the related object's id, e.g. "12", a multiobject field a JSON list of ids in any order, e.g. jsonencode([12, 13]). A key removed from the map is cleared in NetBox (set {} to clear all).
- Description string
- Device
Id float64 - Id of the device hosting the VM.
- Disk
Size float64Mb - Disk size in MB. Once the machine has virtual disks NetBox computes it as their sum and it can no longer be set; leave it unset then. Must be a whole number.
- Id float64
- NetBox id.
- Interface
Count float64 - Number of interfaces on the virtual machine.
- Last
Updated string - Local
Context stringData - Local config context data as JSON text (use jsonencode()).
- Memory
Mb float64 - Memory in MB. Must be a whole number.
- Name string
- Owner
Id float64 - Id of the owner the object is assigned to.
- Platform
Id float64 - Id of the platform.
- Primary
Ip4Id float64 - Id of the primary IPv4 address (managed by netboxprimaryip).
- Primary
Ip6Id float64 - Id of the primary IPv6 address (managed by netboxprimaryip).
- Role
Id float64 - Id of the functional device role.
- Serial string
- Serial number.
- Site
Id float64 - Id of the site (a virtual machine needs a cluster or a site).
- Start
On stringBoot - Power state the virtual machine takes when its host boots. One of: on, off, laststate.
- Status string
- Operational status. One of: offline, active, planned, staged, failed, decommissioning, paused.
- []string
- Slugs of the tags assigned to the object (the provider's defaulttags are added on top, see tagsall).
- []string
- Slugs of all tags on the object, including the provider's default_tags.
- Tenant
Id float64 - Id of the tenant.
- Url string
- Vcpus float64
- Number of virtual CPUs (fractions allowed).
- Virtual
Disk float64Count - Number of virtual disks on the virtual machine.
- Virtual
Machine float64Type Id - Id of the virtual machine type.
- Cluster
Group stringSlug - Slug of the cluster group.
- Custom
Field map[string]stringFilters - Custom field values to match, by field name, e.g. { tier = "gold" }: each entry filters as cf_\n\n with the field's own filter logic, loose (case-insensitive substring) or exact.
- Device
Name string - Name of the device hosting the virtual machine.
- Platform
Slug string - Slug of the platform.
- Region
Slug string - Slug of the region of the site.
- Role
Slug string - Slug of the role.
- Site
Slug string - Slug of the site.
- string
- Slug of a tag the object carries.
- cluster_
id number - Id of the cluster (a virtual machine needs a cluster or a site).
- comments string
- config_
context string - Rendered config context (localcontextdata merged with the context assigned through cluster, platform, role, site, tenant and tags) as JSON text, decode with jsondecode().
- config_
template_ numberid - Id of the config template.
- created string
- custom_
fields map(string) - Custom field values by field name. Every value is a string; NetBox coerces numbers and booleans. An object field holds the related object's id, e.g. "12", a multiobject field a JSON list of ids in any order, e.g. jsonencode([12, 13]). A key removed from the map is cleared in NetBox (set {} to clear all).
- description string
- device_
id number - Id of the device hosting the VM.
- disk_
size_ numbermb - Disk size in MB. Once the machine has virtual disks NetBox computes it as their sum and it can no longer be set; leave it unset then. Must be a whole number.
- id number
- NetBox id.
- interface_
count number - Number of interfaces on the virtual machine.
- last_
updated string - local_
context_ stringdata - Local config context data as JSON text (use jsonencode()).
- memory_
mb number - Memory in MB. Must be a whole number.
- name string
- owner_
id number - Id of the owner the object is assigned to.
- platform_
id number - Id of the platform.
- primary_
ip4_ numberid - Id of the primary IPv4 address (managed by netboxprimaryip).
- primary_
ip6_ numberid - Id of the primary IPv6 address (managed by netboxprimaryip).
- role_
id number - Id of the functional device role.
- serial string
- Serial number.
- site_
id number - Id of the site (a virtual machine needs a cluster or a site).
- start_
on_ stringboot - Power state the virtual machine takes when its host boots. One of: on, off, laststate.
- status string
- Operational status. One of: offline, active, planned, staged, failed, decommissioning, paused.
- list(string)
- Slugs of the tags assigned to the object (the provider's defaulttags are added on top, see tagsall).
- list(string)
- Slugs of all tags on the object, including the provider's default_tags.
- tenant_
id number - Id of the tenant.
- url string
- vcpus number
- Number of virtual CPUs (fractions allowed).
- virtual_
disk_ numbercount - Number of virtual disks on the virtual machine.
- virtual_
machine_ numbertype_ id - Id of the virtual machine type.
- cluster_
group_ stringslug - Slug of the cluster group.
- custom_
field_ map(string)filters - Custom field values to match, by field name, e.g. { tier = "gold" }: each entry filters as cf_\n\n with the field's own filter logic, loose (case-insensitive substring) or exact.
- device_
name string - Name of the device hosting the virtual machine.
- platform_
slug string - Slug of the platform.
- region_
slug string - Slug of the region of the site.
- role_
slug string - Slug of the role.
- site_
slug string - Slug of the site.
- tag_
slug string - Slug of a tag the object carries.
- cluster
Id Double - Id of the cluster (a virtual machine needs a cluster or a site).
- comments String
- config
Context String - Rendered config context (localcontextdata merged with the context assigned through cluster, platform, role, site, tenant and tags) as JSON text, decode with jsondecode().
- config
Template DoubleId - Id of the config template.
- created String
- custom
Fields Map<String,String> - Custom field values by field name. Every value is a string; NetBox coerces numbers and booleans. An object field holds the related object's id, e.g. "12", a multiobject field a JSON list of ids in any order, e.g. jsonencode([12, 13]). A key removed from the map is cleared in NetBox (set {} to clear all).
- description String
- device
Id Double - Id of the device hosting the VM.
- disk
Size DoubleMb - Disk size in MB. Once the machine has virtual disks NetBox computes it as their sum and it can no longer be set; leave it unset then. Must be a whole number.
- id Double
- NetBox id.
- interface
Count Double - Number of interfaces on the virtual machine.
- last
Updated String - local
Context StringData - Local config context data as JSON text (use jsonencode()).
- memory
Mb Double - Memory in MB. Must be a whole number.
- name String
- owner
Id Double - Id of the owner the object is assigned to.
- platform
Id Double - Id of the platform.
- primary
Ip4Id Double - Id of the primary IPv4 address (managed by netboxprimaryip).
- primary
Ip6Id Double - Id of the primary IPv6 address (managed by netboxprimaryip).
- role
Id Double - Id of the functional device role.
- serial String
- Serial number.
- site
Id Double - Id of the site (a virtual machine needs a cluster or a site).
- start
On StringBoot - Power state the virtual machine takes when its host boots. One of: on, off, laststate.
- status String
- Operational status. One of: offline, active, planned, staged, failed, decommissioning, paused.
- List<String>
- Slugs of the tags assigned to the object (the provider's defaulttags are added on top, see tagsall).
- List<String>
- Slugs of all tags on the object, including the provider's default_tags.
- tenant
Id Double - Id of the tenant.
- url String
- vcpus Double
- Number of virtual CPUs (fractions allowed).
- virtual
Disk DoubleCount - Number of virtual disks on the virtual machine.
- virtual
Machine DoubleType Id - Id of the virtual machine type.
- cluster
Group StringSlug - Slug of the cluster group.
- custom
Field Map<String,String>Filters - Custom field values to match, by field name, e.g. { tier = "gold" }: each entry filters as cf_\n\n with the field's own filter logic, loose (case-insensitive substring) or exact.
- device
Name String - Name of the device hosting the virtual machine.
- platform
Slug String - Slug of the platform.
- region
Slug String - Slug of the region of the site.
- role
Slug String - Slug of the role.
- site
Slug String - Slug of the site.
- String
- Slug of a tag the object carries.
- cluster
Id number - Id of the cluster (a virtual machine needs a cluster or a site).
- comments string
- config
Context string - Rendered config context (localcontextdata merged with the context assigned through cluster, platform, role, site, tenant and tags) as JSON text, decode with jsondecode().
- config
Template numberId - Id of the config template.
- created string
- custom
Fields {[key: string]: string} - Custom field values by field name. Every value is a string; NetBox coerces numbers and booleans. An object field holds the related object's id, e.g. "12", a multiobject field a JSON list of ids in any order, e.g. jsonencode([12, 13]). A key removed from the map is cleared in NetBox (set {} to clear all).
- description string
- device
Id number - Id of the device hosting the VM.
- disk
Size numberMb - Disk size in MB. Once the machine has virtual disks NetBox computes it as their sum and it can no longer be set; leave it unset then. Must be a whole number.
- id number
- NetBox id.
- interface
Count number - Number of interfaces on the virtual machine.
- last
Updated string - local
Context stringData - Local config context data as JSON text (use jsonencode()).
- memory
Mb number - Memory in MB. Must be a whole number.
- name string
- owner
Id number - Id of the owner the object is assigned to.
- platform
Id number - Id of the platform.
- primary
Ip4Id number - Id of the primary IPv4 address (managed by netboxprimaryip).
- primary
Ip6Id number - Id of the primary IPv6 address (managed by netboxprimaryip).
- role
Id number - Id of the functional device role.
- serial string
- Serial number.
- site
Id number - Id of the site (a virtual machine needs a cluster or a site).
- start
On stringBoot - Power state the virtual machine takes when its host boots. One of: on, off, laststate.
- status string
- Operational status. One of: offline, active, planned, staged, failed, decommissioning, paused.
- string[]
- Slugs of the tags assigned to the object (the provider's defaulttags are added on top, see tagsall).
- string[]
- Slugs of all tags on the object, including the provider's default_tags.
- tenant
Id number - Id of the tenant.
- url string
- vcpus number
- Number of virtual CPUs (fractions allowed).
- virtual
Disk numberCount - Number of virtual disks on the virtual machine.
- virtual
Machine numberType Id - Id of the virtual machine type.
- cluster
Group stringSlug - Slug of the cluster group.
- custom
Field {[key: string]: string}Filters - Custom field values to match, by field name, e.g. { tier = "gold" }: each entry filters as cf_\n\n with the field's own filter logic, loose (case-insensitive substring) or exact.
- device
Name string - Name of the device hosting the virtual machine.
- platform
Slug string - Slug of the platform.
- region
Slug string - Slug of the region of the site.
- role
Slug string - Slug of the role.
- site
Slug string - Slug of the site.
- string
- Slug of a tag the object carries.
- cluster_
id float - Id of the cluster (a virtual machine needs a cluster or a site).
- comments str
- config_
context str - Rendered config context (localcontextdata merged with the context assigned through cluster, platform, role, site, tenant and tags) as JSON text, decode with jsondecode().
- config_
template_ floatid - Id of the config template.
- created str
- custom_
fields Mapping[str, str] - Custom field values by field name. Every value is a string; NetBox coerces numbers and booleans. An object field holds the related object's id, e.g. "12", a multiobject field a JSON list of ids in any order, e.g. jsonencode([12, 13]). A key removed from the map is cleared in NetBox (set {} to clear all).
- description str
- device_
id float - Id of the device hosting the VM.
- disk_
size_ floatmb - Disk size in MB. Once the machine has virtual disks NetBox computes it as their sum and it can no longer be set; leave it unset then. Must be a whole number.
- id float
- NetBox id.
- interface_
count float - Number of interfaces on the virtual machine.
- last_
updated str - local_
context_ strdata - Local config context data as JSON text (use jsonencode()).
- memory_
mb float - Memory in MB. Must be a whole number.
- name str
- owner_
id float - Id of the owner the object is assigned to.
- platform_
id float - Id of the platform.
- primary_
ip4_ floatid - Id of the primary IPv4 address (managed by netboxprimaryip).
- primary_
ip6_ floatid - Id of the primary IPv6 address (managed by netboxprimaryip).
- role_
id float - Id of the functional device role.
- serial str
- Serial number.
- site_
id float - Id of the site (a virtual machine needs a cluster or a site).
- start_
on_ strboot - Power state the virtual machine takes when its host boots. One of: on, off, laststate.
- status str
- Operational status. One of: offline, active, planned, staged, failed, decommissioning, paused.
- Sequence[str]
- Slugs of the tags assigned to the object (the provider's defaulttags are added on top, see tagsall).
- Sequence[str]
- Slugs of all tags on the object, including the provider's default_tags.
- tenant_
id float - Id of the tenant.
- url str
- vcpus float
- Number of virtual CPUs (fractions allowed).
- virtual_
disk_ floatcount - Number of virtual disks on the virtual machine.
- virtual_
machine_ floattype_ id - Id of the virtual machine type.
- cluster_
group_ strslug - Slug of the cluster group.
- custom_
field_ Mapping[str, str]filters - Custom field values to match, by field name, e.g. { tier = "gold" }: each entry filters as cf_\n\n with the field's own filter logic, loose (case-insensitive substring) or exact.
- device_
name str - Name of the device hosting the virtual machine.
- platform_
slug str - Slug of the platform.
- region_
slug str - Slug of the region of the site.
- role_
slug str - Slug of the role.
- site_
slug str - Slug of the site.
- tag_
slug str - Slug of a tag the object carries.
- cluster
Id Number - Id of the cluster (a virtual machine needs a cluster or a site).
- comments String
- config
Context String - Rendered config context (localcontextdata merged with the context assigned through cluster, platform, role, site, tenant and tags) as JSON text, decode with jsondecode().
- config
Template NumberId - Id of the config template.
- created String
- custom
Fields Map<String> - Custom field values by field name. Every value is a string; NetBox coerces numbers and booleans. An object field holds the related object's id, e.g. "12", a multiobject field a JSON list of ids in any order, e.g. jsonencode([12, 13]). A key removed from the map is cleared in NetBox (set {} to clear all).
- description String
- device
Id Number - Id of the device hosting the VM.
- disk
Size NumberMb - Disk size in MB. Once the machine has virtual disks NetBox computes it as their sum and it can no longer be set; leave it unset then. Must be a whole number.
- id Number
- NetBox id.
- interface
Count Number - Number of interfaces on the virtual machine.
- last
Updated String - local
Context StringData - Local config context data as JSON text (use jsonencode()).
- memory
Mb Number - Memory in MB. Must be a whole number.
- name String
- owner
Id Number - Id of the owner the object is assigned to.
- platform
Id Number - Id of the platform.
- primary
Ip4Id Number - Id of the primary IPv4 address (managed by netboxprimaryip).
- primary
Ip6Id Number - Id of the primary IPv6 address (managed by netboxprimaryip).
- role
Id Number - Id of the functional device role.
- serial String
- Serial number.
- site
Id Number - Id of the site (a virtual machine needs a cluster or a site).
- start
On StringBoot - Power state the virtual machine takes when its host boots. One of: on, off, laststate.
- status String
- Operational status. One of: offline, active, planned, staged, failed, decommissioning, paused.
- List<String>
- Slugs of the tags assigned to the object (the provider's defaulttags are added on top, see tagsall).
- List<String>
- Slugs of all tags on the object, including the provider's default_tags.
- tenant
Id Number - Id of the tenant.
- url String
- vcpus Number
- Number of virtual CPUs (fractions allowed).
- virtual
Disk NumberCount - Number of virtual disks on the virtual machine.
- virtual
Machine NumberType Id - Id of the virtual machine type.
- cluster
Group StringSlug - Slug of the cluster group.
- custom
Field Map<String>Filters - Custom field values to match, by field name, e.g. { tier = "gold" }: each entry filters as cf_\n\n with the field's own filter logic, loose (case-insensitive substring) or exact.
- device
Name String - Name of the device hosting the virtual machine.
- platform
Slug String - Slug of the platform.
- region
Slug String - Slug of the region of the site.
- role
Slug String - Slug of the role.
- site
Slug String - Slug of the site.
- String
- Slug of a tag the object carries.
Package Details
- Repository
- netbox e-breuninger/terraform-provider-netbox
- License
- Notes
- This Pulumi package is based on the
netboxTerraform Provider.
published on Wednesday, Nov 4, 2026 by e-breuninger