1. Packages
  2. Proxmox Virtual Environment (Proxmox VE)
  3. API Docs
  4. hardware
  5. hardware/mapping
  6. getPciLegacy
Viewing docs for Proxmox Virtual Environment (Proxmox VE) v8.0.0
published on Sunday, Apr 5, 2026 by Daniel Muehlbachler-Pietrzykowski
proxmoxve logo
Viewing docs for Proxmox Virtual Environment (Proxmox VE) v8.0.0
published on Sunday, Apr 5, 2026 by Daniel Muehlbachler-Pietrzykowski

    Deprecated: Use proxmoxve.hardware/mapping.Pci instead. This data source will be removed in v1.0.

    Retrieves a PCI hardware mapping from a Proxmox VE cluster.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as proxmoxve from "@muhlba91/pulumi-proxmoxve";
    
    const example = proxmoxve.hardware.mapping.getPciLegacy({
        name: "example",
    });
    export const dataProxmoxVirtualEnvironmentHardwareMappingPci = example;
    
    import pulumi
    import pulumi_proxmoxve as proxmoxve
    
    example = proxmoxve.hardware.mapping.get_pci_legacy(name="example")
    pulumi.export("dataProxmoxVirtualEnvironmentHardwareMappingPci", example)
    
    package main
    
    import (
    	"github.com/muhlba91/pulumi-proxmoxve/sdk/v8/go/proxmoxve/hardware"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		example, err := hardware.GetPciLegacy(ctx, &mapping.GetPciLegacyArgs{
    			Name: "example",
    		}, nil)
    		if err != nil {
    			return err
    		}
    		ctx.Export("dataProxmoxVirtualEnvironmentHardwareMappingPci", example)
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using ProxmoxVE = Pulumi.ProxmoxVE;
    
    return await Deployment.RunAsync(() => 
    {
        var example = ProxmoxVE.Hardware.Mapping.GetPciLegacy.Invoke(new()
        {
            Name = "example",
        });
    
        return new Dictionary<string, object?>
        {
            ["dataProxmoxVirtualEnvironmentHardwareMappingPci"] = example,
        };
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.proxmoxve.hardware_mapping.Hardware_mappingFunctions;
    import com.pulumi.proxmoxve.hardware.inputs.GetPciLegacyArgs;
    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 example = Hardware_mappingFunctions.getPciLegacy(GetPciLegacyArgs.builder()
                .name("example")
                .build());
    
            ctx.export("dataProxmoxVirtualEnvironmentHardwareMappingPci", example);
        }
    }
    
    variables:
      example:
        fn::invoke:
          function: proxmoxve:hardware/mapping:getPciLegacy
          arguments:
            name: example
    outputs:
      dataProxmoxVirtualEnvironmentHardwareMappingPci: ${example}
    

    Using getPciLegacy

    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 getPciLegacy(args: GetPciLegacyArgs, opts?: InvokeOptions): Promise<GetPciLegacyResult>
    function getPciLegacyOutput(args: GetPciLegacyOutputArgs, opts?: InvokeOptions): Output<GetPciLegacyResult>
    def get_pci_legacy(name: Optional[str] = None,
                       opts: Optional[InvokeOptions] = None) -> GetPciLegacyResult
    def get_pci_legacy_output(name: Optional[pulumi.Input[str]] = None,
                       opts: Optional[InvokeOptions] = None) -> Output[GetPciLegacyResult]
    func LookupPciLegacy(ctx *Context, args *LookupPciLegacyArgs, opts ...InvokeOption) (*LookupPciLegacyResult, error)
    func LookupPciLegacyOutput(ctx *Context, args *LookupPciLegacyOutputArgs, opts ...InvokeOption) LookupPciLegacyResultOutput

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

    public static class GetPciLegacy 
    {
        public static Task<GetPciLegacyResult> InvokeAsync(GetPciLegacyArgs args, InvokeOptions? opts = null)
        public static Output<GetPciLegacyResult> Invoke(GetPciLegacyInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetPciLegacyResult> getPciLegacy(GetPciLegacyArgs args, InvokeOptions options)
    public static Output<GetPciLegacyResult> getPciLegacy(GetPciLegacyArgs args, InvokeOptions options)
    
    fn::invoke:
      function: proxmoxve:hardware/mapping/getPciLegacy:getPciLegacy
      arguments:
        # arguments dictionary

    The following arguments are supported:

    Name string
    The name of this PCI hardware mapping.
    Name string
    The name of this PCI hardware mapping.
    name String
    The name of this PCI hardware mapping.
    name string
    The name of this PCI hardware mapping.
    name str
    The name of this PCI hardware mapping.
    name String
    The name of this PCI hardware mapping.

    getPciLegacy Result

    The following output properties are available:

    Comment string
    The comment of this PCI hardware mapping.
    Id string
    The unique identifier of this PCI hardware mapping data source.
    Maps List<Pulumi.ProxmoxVE.Hardware.Mapping.Outputs.GetPciLegacyMap>
    The actual map of devices for the hardware mapping.
    MediatedDevices bool
    Indicates whether to use with mediated devices.
    Name string
    The name of this PCI hardware mapping.
    Comment string
    The comment of this PCI hardware mapping.
    Id string
    The unique identifier of this PCI hardware mapping data source.
    Maps []GetPciLegacyMap
    The actual map of devices for the hardware mapping.
    MediatedDevices bool
    Indicates whether to use with mediated devices.
    Name string
    The name of this PCI hardware mapping.
    comment String
    The comment of this PCI hardware mapping.
    id String
    The unique identifier of this PCI hardware mapping data source.
    maps List<GetPciLegacyMap>
    The actual map of devices for the hardware mapping.
    mediatedDevices Boolean
    Indicates whether to use with mediated devices.
    name String
    The name of this PCI hardware mapping.
    comment string
    The comment of this PCI hardware mapping.
    id string
    The unique identifier of this PCI hardware mapping data source.
    maps GetPciLegacyMap[]
    The actual map of devices for the hardware mapping.
    mediatedDevices boolean
    Indicates whether to use with mediated devices.
    name string
    The name of this PCI hardware mapping.
    comment str
    The comment of this PCI hardware mapping.
    id str
    The unique identifier of this PCI hardware mapping data source.
    maps Sequence[GetPciLegacyMap]
    The actual map of devices for the hardware mapping.
    mediated_devices bool
    Indicates whether to use with mediated devices.
    name str
    The name of this PCI hardware mapping.
    comment String
    The comment of this PCI hardware mapping.
    id String
    The unique identifier of this PCI hardware mapping data source.
    maps List<Property Map>
    The actual map of devices for the hardware mapping.
    mediatedDevices Boolean
    Indicates whether to use with mediated devices.
    name String
    The name of this PCI hardware mapping.

    Supporting Types

    GetPciLegacyMap

    Comment string
    The comment of the mapped PCI device.
    Id string
    The ID attribute of the map.
    IommuGroup int
    The IOMMU group attribute of the map.
    Node string
    The node name attribute of the map.
    Path string
    The path attribute of the map.
    SubsystemId string
    The subsystem ID attribute of the map. While not mandatory for the Proxmox VE API call, omitting this attribute will result in an incomplete PCI hardware mapping.
    Comment string
    The comment of the mapped PCI device.
    Id string
    The ID attribute of the map.
    IommuGroup int
    The IOMMU group attribute of the map.
    Node string
    The node name attribute of the map.
    Path string
    The path attribute of the map.
    SubsystemId string
    The subsystem ID attribute of the map. While not mandatory for the Proxmox VE API call, omitting this attribute will result in an incomplete PCI hardware mapping.
    comment String
    The comment of the mapped PCI device.
    id String
    The ID attribute of the map.
    iommuGroup Integer
    The IOMMU group attribute of the map.
    node String
    The node name attribute of the map.
    path String
    The path attribute of the map.
    subsystemId String
    The subsystem ID attribute of the map. While not mandatory for the Proxmox VE API call, omitting this attribute will result in an incomplete PCI hardware mapping.
    comment string
    The comment of the mapped PCI device.
    id string
    The ID attribute of the map.
    iommuGroup number
    The IOMMU group attribute of the map.
    node string
    The node name attribute of the map.
    path string
    The path attribute of the map.
    subsystemId string
    The subsystem ID attribute of the map. While not mandatory for the Proxmox VE API call, omitting this attribute will result in an incomplete PCI hardware mapping.
    comment str
    The comment of the mapped PCI device.
    id str
    The ID attribute of the map.
    iommu_group int
    The IOMMU group attribute of the map.
    node str
    The node name attribute of the map.
    path str
    The path attribute of the map.
    subsystem_id str
    The subsystem ID attribute of the map. While not mandatory for the Proxmox VE API call, omitting this attribute will result in an incomplete PCI hardware mapping.
    comment String
    The comment of the mapped PCI device.
    id String
    The ID attribute of the map.
    iommuGroup Number
    The IOMMU group attribute of the map.
    node String
    The node name attribute of the map.
    path String
    The path attribute of the map.
    subsystemId String
    The subsystem ID attribute of the map. While not mandatory for the Proxmox VE API call, omitting this attribute will result in an incomplete PCI hardware mapping.

    Package Details

    Repository
    proxmoxve muhlba91/pulumi-proxmoxve
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the proxmox Terraform Provider.
    proxmoxve logo
    Viewing docs for Proxmox Virtual Environment (Proxmox VE) v8.0.0
    published on Sunday, Apr 5, 2026 by Daniel Muehlbachler-Pietrzykowski
      Try Pulumi Cloud free. Your team will thank you.