Viewing docs for Proxmox Virtual Environment (Proxmox VE) v8.1.0
published on Sunday, Apr 26, 2026 by Daniel Muehlbachler-Pietrzykowski
published on Sunday, Apr 26, 2026 by Daniel Muehlbachler-Pietrzykowski
Viewing docs for Proxmox Virtual Environment (Proxmox VE) v8.1.0
published on Sunday, Apr 26, 2026 by Daniel Muehlbachler-Pietrzykowski
published on Sunday, Apr 26, 2026 by Daniel Muehlbachler-Pietrzykowski
Retrieves information about all containers in the Proxmox cluster.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as proxmoxve from "@muhlba91/pulumi-proxmoxve";
const ubuntuContainers = proxmoxve.getContainersLegacy({
tags: ["ubuntu"],
});
const ubuntuTemplates = proxmoxve.getContainersLegacy({
tags: [
"template",
"latest",
],
filters: [
{
name: "template",
values: ["true"],
},
{
name: "status",
values: ["stopped"],
},
{
name: "name",
regex: true,
values: ["^ubuntu-20.*$"],
},
{
name: "node_name",
regex: true,
values: [
"node_us_[1-3]",
"node_eu_[1-3]",
],
},
],
});
import pulumi
import pulumi_proxmoxve as proxmoxve
ubuntu_containers = proxmoxve.get_containers_legacy(tags=["ubuntu"])
ubuntu_templates = proxmoxve.get_containers_legacy(tags=[
"template",
"latest",
],
filters=[
{
"name": "template",
"values": ["true"],
},
{
"name": "status",
"values": ["stopped"],
},
{
"name": "name",
"regex": True,
"values": ["^ubuntu-20.*$"],
},
{
"name": "node_name",
"regex": True,
"values": [
"node_us_[1-3]",
"node_eu_[1-3]",
],
},
])
package main
import (
"github.com/muhlba91/pulumi-proxmoxve/sdk/v8/go/proxmoxve"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := proxmoxve.GetContainersLegacy(ctx, &proxmoxve.GetContainersLegacyArgs{
Tags: []string{
"ubuntu",
},
}, nil)
if err != nil {
return err
}
_, err = proxmoxve.GetContainersLegacy(ctx, &proxmoxve.GetContainersLegacyArgs{
Tags: []string{
"template",
"latest",
},
Filters: []proxmoxve.GetContainersLegacyFilter{
{
Name: "template",
Values: []string{
"true",
},
},
{
Name: "status",
Values: []string{
"stopped",
},
},
{
Name: "name",
Regex: pulumi.BoolRef(true),
Values: []string{
"^ubuntu-20.*$",
},
},
{
Name: "node_name",
Regex: pulumi.BoolRef(true),
Values: []string{
"node_us_[1-3]",
"node_eu_[1-3]",
},
},
},
}, nil)
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using ProxmoxVE = Pulumi.ProxmoxVE;
return await Deployment.RunAsync(() =>
{
var ubuntuContainers = ProxmoxVE.Index.GetContainersLegacy.Invoke(new()
{
Tags = new[]
{
"ubuntu",
},
});
var ubuntuTemplates = ProxmoxVE.Index.GetContainersLegacy.Invoke(new()
{
Tags = new[]
{
"template",
"latest",
},
Filters = new[]
{
new ProxmoxVE.Inputs.GetContainersLegacyFilterInputArgs
{
Name = "template",
Values = new[]
{
"true",
},
},
new ProxmoxVE.Inputs.GetContainersLegacyFilterInputArgs
{
Name = "status",
Values = new[]
{
"stopped",
},
},
new ProxmoxVE.Inputs.GetContainersLegacyFilterInputArgs
{
Name = "name",
Regex = true,
Values = new[]
{
"^ubuntu-20.*$",
},
},
new ProxmoxVE.Inputs.GetContainersLegacyFilterInputArgs
{
Name = "node_name",
Regex = true,
Values = new[]
{
"node_us_[1-3]",
"node_eu_[1-3]",
},
},
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.proxmoxve.ProxmoxveFunctions;
import com.pulumi.proxmoxve.inputs.GetContainersLegacyArgs;
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 ubuntuContainers = ProxmoxveFunctions.getContainersLegacy(GetContainersLegacyArgs.builder()
.tags("ubuntu")
.build());
final var ubuntuTemplates = ProxmoxveFunctions.getContainersLegacy(GetContainersLegacyArgs.builder()
.tags(
"template",
"latest")
.filters(
GetContainersLegacyFilterArgs.builder()
.name("template")
.values("true")
.build(),
GetContainersLegacyFilterArgs.builder()
.name("status")
.values("stopped")
.build(),
GetContainersLegacyFilterArgs.builder()
.name("name")
.regex(true)
.values("^ubuntu-20.*$")
.build(),
GetContainersLegacyFilterArgs.builder()
.name("node_name")
.regex(true)
.values(
"node_us_[1-3]",
"node_eu_[1-3]")
.build())
.build());
}
}
variables:
ubuntuContainers:
fn::invoke:
function: proxmoxve:getContainersLegacy
arguments:
tags:
- ubuntu
ubuntuTemplates:
fn::invoke:
function: proxmoxve:getContainersLegacy
arguments:
tags:
- template
- latest
filters:
- name: template
values:
- true
- name: status
values:
- stopped
- name: name
regex: true
values:
- ^ubuntu-20.*$
- name: node_name
regex: true
values:
- node_us_[1-3]
- node_eu_[1-3]
Using getContainersLegacy
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 getContainersLegacy(args: GetContainersLegacyArgs, opts?: InvokeOptions): Promise<GetContainersLegacyResult>
function getContainersLegacyOutput(args: GetContainersLegacyOutputArgs, opts?: InvokeOptions): Output<GetContainersLegacyResult>def get_containers_legacy(filters: Optional[Sequence[GetContainersLegacyFilter]] = None,
node_name: Optional[str] = None,
tags: Optional[Sequence[str]] = None,
opts: Optional[InvokeOptions] = None) -> GetContainersLegacyResult
def get_containers_legacy_output(filters: Optional[pulumi.Input[Sequence[pulumi.Input[GetContainersLegacyFilterArgs]]]] = None,
node_name: Optional[pulumi.Input[str]] = None,
tags: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetContainersLegacyResult]func GetContainersLegacy(ctx *Context, args *GetContainersLegacyArgs, opts ...InvokeOption) (*GetContainersLegacyResult, error)
func GetContainersLegacyOutput(ctx *Context, args *GetContainersLegacyOutputArgs, opts ...InvokeOption) GetContainersLegacyResultOutput> Note: This function is named GetContainersLegacy in the Go SDK.
public static class GetContainersLegacy
{
public static Task<GetContainersLegacyResult> InvokeAsync(GetContainersLegacyArgs args, InvokeOptions? opts = null)
public static Output<GetContainersLegacyResult> Invoke(GetContainersLegacyInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetContainersLegacyResult> getContainersLegacy(GetContainersLegacyArgs args, InvokeOptions options)
public static Output<GetContainersLegacyResult> getContainersLegacy(GetContainersLegacyArgs args, InvokeOptions options)
fn::invoke:
function: proxmoxve:index/getContainersLegacy:getContainersLegacy
arguments:
# arguments dictionaryThe following arguments are supported:
- Filters
List<Pulumi.
Proxmox VE. Inputs. Get Containers Legacy Filter> - Filter blocks. The container must satisfy all filter blocks to be included in the result.
- Node
Name string - The node name. All cluster nodes will be queried in case this is omitted
- List<string>
- A list of tags to filter the containers. The container must have all the tags to be included in the result.
- Filters
[]Get
Containers Legacy Filter - Filter blocks. The container must satisfy all filter blocks to be included in the result.
- Node
Name string - The node name. All cluster nodes will be queried in case this is omitted
- []string
- A list of tags to filter the containers. The container must have all the tags to be included in the result.
- filters
List<Get
Containers Legacy Filter> - Filter blocks. The container must satisfy all filter blocks to be included in the result.
- node
Name String - The node name. All cluster nodes will be queried in case this is omitted
- List<String>
- A list of tags to filter the containers. The container must have all the tags to be included in the result.
- filters
Get
Containers Legacy Filter[] - Filter blocks. The container must satisfy all filter blocks to be included in the result.
- node
Name string - The node name. All cluster nodes will be queried in case this is omitted
- string[]
- A list of tags to filter the containers. The container must have all the tags to be included in the result.
- filters
Sequence[Get
Containers Legacy Filter] - Filter blocks. The container must satisfy all filter blocks to be included in the result.
- node_
name str - The node name. All cluster nodes will be queried in case this is omitted
- Sequence[str]
- A list of tags to filter the containers. The container must have all the tags to be included in the result.
- filters List<Property Map>
- Filter blocks. The container must satisfy all filter blocks to be included in the result.
- node
Name String - The node name. All cluster nodes will be queried in case this is omitted
- List<String>
- A list of tags to filter the containers. The container must have all the tags to be included in the result.
getContainersLegacy Result
The following output properties are available:
- Containers
List<Pulumi.
Proxmox VE. Outputs. Get Containers Legacy Container> - The containers list.
- Id string
- The provider-assigned unique ID for this managed resource.
- Filters
List<Pulumi.
Proxmox VE. Outputs. Get Containers Legacy Filter> - Node
Name string - The node name.
- List<string>
- A list of tags of the container.
- Containers
[]Get
Containers Legacy Container - The containers list.
- Id string
- The provider-assigned unique ID for this managed resource.
- Filters
[]Get
Containers Legacy Filter - Node
Name string - The node name.
- []string
- A list of tags of the container.
- containers
List<Get
Containers Legacy Container> - The containers list.
- id String
- The provider-assigned unique ID for this managed resource.
- filters
List<Get
Containers Legacy Filter> - node
Name String - The node name.
- List<String>
- A list of tags of the container.
- containers
Get
Containers Legacy Container[] - The containers list.
- id string
- The provider-assigned unique ID for this managed resource.
- filters
Get
Containers Legacy Filter[] - node
Name string - The node name.
- string[]
- A list of tags of the container.
- containers
Sequence[Get
Containers Legacy Container] - The containers list.
- id str
- The provider-assigned unique ID for this managed resource.
- filters
Sequence[Get
Containers Legacy Filter] - node_
name str - The node name.
- Sequence[str]
- A list of tags of the container.
- containers List<Property Map>
- The containers list.
- id String
- The provider-assigned unique ID for this managed resource.
- filters List<Property Map>
- node
Name String - The node name.
- List<String>
- A list of tags of the container.
Supporting Types
GetContainersLegacyContainer
- Name string
- The container name.
- Node
Name string - The node name. All cluster nodes will be queried in case this is omitted
- List<string>
- A list of tags to filter the containers. The container must have all the tags to be included in the result.
- Vm
Id int - The container identifier.
- Status string
- The status of the container.
- Template bool
- Whether the container is a template.
- Name string
- The container name.
- Node
Name string - The node name. All cluster nodes will be queried in case this is omitted
- []string
- A list of tags to filter the containers. The container must have all the tags to be included in the result.
- Vm
Id int - The container identifier.
- Status string
- The status of the container.
- Template bool
- Whether the container is a template.
- name String
- The container name.
- node
Name String - The node name. All cluster nodes will be queried in case this is omitted
- List<String>
- A list of tags to filter the containers. The container must have all the tags to be included in the result.
- vm
Id Integer - The container identifier.
- status String
- The status of the container.
- template Boolean
- Whether the container is a template.
- name string
- The container name.
- node
Name string - The node name. All cluster nodes will be queried in case this is omitted
- string[]
- A list of tags to filter the containers. The container must have all the tags to be included in the result.
- vm
Id number - The container identifier.
- status string
- The status of the container.
- template boolean
- Whether the container is a template.
- name str
- The container name.
- node_
name str - The node name. All cluster nodes will be queried in case this is omitted
- Sequence[str]
- A list of tags to filter the containers. The container must have all the tags to be included in the result.
- vm_
id int - The container identifier.
- status str
- The status of the container.
- template bool
- Whether the container is a template.
- name String
- The container name.
- node
Name String - The node name. All cluster nodes will be queried in case this is omitted
- List<String>
- A list of tags to filter the containers. The container must have all the tags to be included in the result.
- vm
Id Number - The container identifier.
- status String
- The status of the container.
- template Boolean
- Whether the container is a template.
GetContainersLegacyFilter
Package Details
- Repository
- proxmoxve muhlba91/pulumi-proxmoxve
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
proxmoxTerraform Provider.
Viewing docs for Proxmox Virtual Environment (Proxmox VE) v8.1.0
published on Sunday, Apr 26, 2026 by Daniel Muehlbachler-Pietrzykowski
published on Sunday, Apr 26, 2026 by Daniel Muehlbachler-Pietrzykowski
