1. Packages
  2. Libvirt Provider
  3. API Docs
  4. getNodeDeviceInfo
libvirt 0.9.0 published on Saturday, Nov 8, 2025 by dmacvicar
libvirt logo
libvirt 0.9.0 published on Saturday, Nov 8, 2025 by dmacvicar

    Fetches detailed information about a specific libvirt host node device.

    This data source provides comprehensive details about hardware devices, including PCI devices for passthrough, USB devices, network interfaces, and storage devices.

    Using getNodeDeviceInfo

    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 getNodeDeviceInfo(args: GetNodeDeviceInfoArgs, opts?: InvokeOptions): Promise<GetNodeDeviceInfoResult>
    function getNodeDeviceInfoOutput(args: GetNodeDeviceInfoOutputArgs, opts?: InvokeOptions): Output<GetNodeDeviceInfoResult>
    def get_node_device_info(name: Optional[str] = None,
                             opts: Optional[InvokeOptions] = None) -> GetNodeDeviceInfoResult
    def get_node_device_info_output(name: Optional[pulumi.Input[str]] = None,
                             opts: Optional[InvokeOptions] = None) -> Output[GetNodeDeviceInfoResult]
    func GetNodeDeviceInfo(ctx *Context, args *GetNodeDeviceInfoArgs, opts ...InvokeOption) (*GetNodeDeviceInfoResult, error)
    func GetNodeDeviceInfoOutput(ctx *Context, args *GetNodeDeviceInfoOutputArgs, opts ...InvokeOption) GetNodeDeviceInfoResultOutput

    > Note: This function is named GetNodeDeviceInfo in the Go SDK.

    public static class GetNodeDeviceInfo 
    {
        public static Task<GetNodeDeviceInfoResult> InvokeAsync(GetNodeDeviceInfoArgs args, InvokeOptions? opts = null)
        public static Output<GetNodeDeviceInfoResult> Invoke(GetNodeDeviceInfoInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetNodeDeviceInfoResult> getNodeDeviceInfo(GetNodeDeviceInfoArgs args, InvokeOptions options)
    public static Output<GetNodeDeviceInfoResult> getNodeDeviceInfo(GetNodeDeviceInfoArgs args, InvokeOptions options)
    
    fn::invoke:
      function: libvirt:index/getNodeDeviceInfo:getNodeDeviceInfo
      arguments:
        # arguments dictionary

    The following arguments are supported:

    Name string
    Device name from libvirt.getNodeDevices data source (e.g., pci_0000_00_1f_2).
    Name string
    Device name from libvirt.getNodeDevices data source (e.g., pci_0000_00_1f_2).
    name String
    Device name from libvirt.getNodeDevices data source (e.g., pci_0000_00_1f_2).
    name string
    Device name from libvirt.getNodeDevices data source (e.g., pci_0000_00_1f_2).
    name str
    Device name from libvirt.getNodeDevices data source (e.g., pci_0000_00_1f_2).
    name String
    Device name from libvirt.getNodeDevices data source (e.g., pci_0000_00_1f_2).

    getNodeDeviceInfo Result

    The following output properties are available:

    Capability GetNodeDeviceInfoCapability
    Device capability details. Fields populated depend on the device type.
    Id string
    Internal identifier for this data source.
    Name string
    Device name from libvirt.getNodeDevices data source (e.g., pci_0000_00_1f_2).
    Parent string
    Parent device name in the device hierarchy.
    Path string
    Sysfs path to the device.
    Capability GetNodeDeviceInfoCapability
    Device capability details. Fields populated depend on the device type.
    Id string
    Internal identifier for this data source.
    Name string
    Device name from libvirt.getNodeDevices data source (e.g., pci_0000_00_1f_2).
    Parent string
    Parent device name in the device hierarchy.
    Path string
    Sysfs path to the device.
    capability GetNodeDeviceInfoCapability
    Device capability details. Fields populated depend on the device type.
    id String
    Internal identifier for this data source.
    name String
    Device name from libvirt.getNodeDevices data source (e.g., pci_0000_00_1f_2).
    parent String
    Parent device name in the device hierarchy.
    path String
    Sysfs path to the device.
    capability GetNodeDeviceInfoCapability
    Device capability details. Fields populated depend on the device type.
    id string
    Internal identifier for this data source.
    name string
    Device name from libvirt.getNodeDevices data source (e.g., pci_0000_00_1f_2).
    parent string
    Parent device name in the device hierarchy.
    path string
    Sysfs path to the device.
    capability GetNodeDeviceInfoCapability
    Device capability details. Fields populated depend on the device type.
    id str
    Internal identifier for this data source.
    name str
    Device name from libvirt.getNodeDevices data source (e.g., pci_0000_00_1f_2).
    parent str
    Parent device name in the device hierarchy.
    path str
    Sysfs path to the device.
    capability Property Map
    Device capability details. Fields populated depend on the device type.
    id String
    Internal identifier for this data source.
    name String
    Device name from libvirt.getNodeDevices data source (e.g., pci_0000_00_1f_2).
    parent String
    Parent device name in the device hierarchy.
    path String
    Sysfs path to the device.

    Supporting Types

    GetNodeDeviceInfoCapability

    Address string
    MAC address or device address.
    Block string
    Block device path (e.g., /dev/sda).
    Bus double
    PCI/USB bus number.
    Class string
    PCI class code (e.g., 0x030000 for VGA).
    DeviceNumber double
    USB device number.
    Domain double
    PCI domain number.
    DriveType string
    Drive type (e.g., disk, cdrom).
    Function double
    PCI function number.
    Host double
    SCSI host number.
    Interface string
    Network interface name (e.g., eth0).
    IommuGroup double
    IOMMU group number (for PCI passthrough).
    LinkSpeed string
    Network link speed.
    LinkState string
    Network link state (e.g., up, down).
    LogicalBlockSize double
    Logical block size in bytes.
    Lun double
    SCSI LUN (Logical Unit Number).
    Model string
    Device model name.
    NumBlocks double
    Number of blocks.
    ProductId string
    Product ID (vendor-specific identifier).
    ProductName string
    Product name or description.
    ScsiType string
    SCSI device type.
    Serial string
    Device serial number.
    Size double
    Storage capacity in bytes.
    Slot double
    PCI slot number.
    Target double
    SCSI target number.
    Type string
    Capability type (e.g., pci, usb_device, net, storage).
    VendorId string
    Vendor ID.
    VendorName string
    Vendor name.
    Address string
    MAC address or device address.
    Block string
    Block device path (e.g., /dev/sda).
    Bus float64
    PCI/USB bus number.
    Class string
    PCI class code (e.g., 0x030000 for VGA).
    DeviceNumber float64
    USB device number.
    Domain float64
    PCI domain number.
    DriveType string
    Drive type (e.g., disk, cdrom).
    Function float64
    PCI function number.
    Host float64
    SCSI host number.
    Interface string
    Network interface name (e.g., eth0).
    IommuGroup float64
    IOMMU group number (for PCI passthrough).
    LinkSpeed string
    Network link speed.
    LinkState string
    Network link state (e.g., up, down).
    LogicalBlockSize float64
    Logical block size in bytes.
    Lun float64
    SCSI LUN (Logical Unit Number).
    Model string
    Device model name.
    NumBlocks float64
    Number of blocks.
    ProductId string
    Product ID (vendor-specific identifier).
    ProductName string
    Product name or description.
    ScsiType string
    SCSI device type.
    Serial string
    Device serial number.
    Size float64
    Storage capacity in bytes.
    Slot float64
    PCI slot number.
    Target float64
    SCSI target number.
    Type string
    Capability type (e.g., pci, usb_device, net, storage).
    VendorId string
    Vendor ID.
    VendorName string
    Vendor name.
    address String
    MAC address or device address.
    block String
    Block device path (e.g., /dev/sda).
    bus Double
    PCI/USB bus number.
    class_ String
    PCI class code (e.g., 0x030000 for VGA).
    deviceNumber Double
    USB device number.
    domain Double
    PCI domain number.
    driveType String
    Drive type (e.g., disk, cdrom).
    function Double
    PCI function number.
    host Double
    SCSI host number.
    interface_ String
    Network interface name (e.g., eth0).
    iommuGroup Double
    IOMMU group number (for PCI passthrough).
    linkSpeed String
    Network link speed.
    linkState String
    Network link state (e.g., up, down).
    logicalBlockSize Double
    Logical block size in bytes.
    lun Double
    SCSI LUN (Logical Unit Number).
    model String
    Device model name.
    numBlocks Double
    Number of blocks.
    productId String
    Product ID (vendor-specific identifier).
    productName String
    Product name or description.
    scsiType String
    SCSI device type.
    serial String
    Device serial number.
    size Double
    Storage capacity in bytes.
    slot Double
    PCI slot number.
    target Double
    SCSI target number.
    type String
    Capability type (e.g., pci, usb_device, net, storage).
    vendorId String
    Vendor ID.
    vendorName String
    Vendor name.
    address string
    MAC address or device address.
    block string
    Block device path (e.g., /dev/sda).
    bus number
    PCI/USB bus number.
    class string
    PCI class code (e.g., 0x030000 for VGA).
    deviceNumber number
    USB device number.
    domain number
    PCI domain number.
    driveType string
    Drive type (e.g., disk, cdrom).
    function number
    PCI function number.
    host number
    SCSI host number.
    interface string
    Network interface name (e.g., eth0).
    iommuGroup number
    IOMMU group number (for PCI passthrough).
    linkSpeed string
    Network link speed.
    linkState string
    Network link state (e.g., up, down).
    logicalBlockSize number
    Logical block size in bytes.
    lun number
    SCSI LUN (Logical Unit Number).
    model string
    Device model name.
    numBlocks number
    Number of blocks.
    productId string
    Product ID (vendor-specific identifier).
    productName string
    Product name or description.
    scsiType string
    SCSI device type.
    serial string
    Device serial number.
    size number
    Storage capacity in bytes.
    slot number
    PCI slot number.
    target number
    SCSI target number.
    type string
    Capability type (e.g., pci, usb_device, net, storage).
    vendorId string
    Vendor ID.
    vendorName string
    Vendor name.
    address str
    MAC address or device address.
    block str
    Block device path (e.g., /dev/sda).
    bus float
    PCI/USB bus number.
    class_ str
    PCI class code (e.g., 0x030000 for VGA).
    device_number float
    USB device number.
    domain float
    PCI domain number.
    drive_type str
    Drive type (e.g., disk, cdrom).
    function float
    PCI function number.
    host float
    SCSI host number.
    interface str
    Network interface name (e.g., eth0).
    iommu_group float
    IOMMU group number (for PCI passthrough).
    link_speed str
    Network link speed.
    link_state str
    Network link state (e.g., up, down).
    logical_block_size float
    Logical block size in bytes.
    lun float
    SCSI LUN (Logical Unit Number).
    model str
    Device model name.
    num_blocks float
    Number of blocks.
    product_id str
    Product ID (vendor-specific identifier).
    product_name str
    Product name or description.
    scsi_type str
    SCSI device type.
    serial str
    Device serial number.
    size float
    Storage capacity in bytes.
    slot float
    PCI slot number.
    target float
    SCSI target number.
    type str
    Capability type (e.g., pci, usb_device, net, storage).
    vendor_id str
    Vendor ID.
    vendor_name str
    Vendor name.
    address String
    MAC address or device address.
    block String
    Block device path (e.g., /dev/sda).
    bus Number
    PCI/USB bus number.
    class String
    PCI class code (e.g., 0x030000 for VGA).
    deviceNumber Number
    USB device number.
    domain Number
    PCI domain number.
    driveType String
    Drive type (e.g., disk, cdrom).
    function Number
    PCI function number.
    host Number
    SCSI host number.
    interface String
    Network interface name (e.g., eth0).
    iommuGroup Number
    IOMMU group number (for PCI passthrough).
    linkSpeed String
    Network link speed.
    linkState String
    Network link state (e.g., up, down).
    logicalBlockSize Number
    Logical block size in bytes.
    lun Number
    SCSI LUN (Logical Unit Number).
    model String
    Device model name.
    numBlocks Number
    Number of blocks.
    productId String
    Product ID (vendor-specific identifier).
    productName String
    Product name or description.
    scsiType String
    SCSI device type.
    serial String
    Device serial number.
    size Number
    Storage capacity in bytes.
    slot Number
    PCI slot number.
    target Number
    SCSI target number.
    type String
    Capability type (e.g., pci, usb_device, net, storage).
    vendorId String
    Vendor ID.
    vendorName String
    Vendor name.

    Package Details

    Repository
    libvirt dmacvicar/terraform-provider-libvirt
    License
    Notes
    This Pulumi package is based on the libvirt Terraform Provider.
    libvirt logo
    libvirt 0.9.0 published on Saturday, Nov 8, 2025 by dmacvicar
      Meet Neo: Your AI Platform Teammate