1. Packages
  2. Packages
  3. Selectel Provider
  4. API Docs
  5. getDedicatedServersV1
Viewing docs for selectel 8.0.1
published on Thursday, May 28, 2026 by selectel
Viewing docs for selectel 8.0.1
published on Thursday, May 28, 2026 by selectel

    Provides a list of dedicated servers in the project. Learn more about About dedicated servers.

    Example Usage

    Get all servers in project

    import * as pulumi from "@pulumi/pulumi";
    import * as selectel from "@pulumi/selectel";
    
    const servers = selectel.getDedicatedServersV1({
        projectId: project.id,
        filter: {
            name: "production-web-01",
            ip: "192.168.1.100",
            locationId: serverLocation.locations[0].id,
            configuration: "EL5",
            privateSubnet: subnets.subnets[0].id,
            publicSubnet: subnetsSelectelDedicatedPublicSubnetV1.subnets[0].id,
        },
    });
    
    import pulumi
    import pulumi_selectel as selectel
    
    servers = selectel.get_dedicated_servers_v1(project_id=project["id"],
        filter={
            "name": "production-web-01",
            "ip": "192.168.1.100",
            "location_id": server_location["locations"][0]["id"],
            "configuration": "EL5",
            "private_subnet": subnets["subnets"][0]["id"],
            "public_subnet": subnets_selectel_dedicated_public_subnet_v1["subnets"][0]["id"],
        })
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-terraform-provider/sdks/go/selectel/v8/selectel"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := selectel.GetDedicatedServersV1(ctx, &selectel.GetDedicatedServersV1Args{
    			ProjectId: project.Id,
    			Filter: selectel.GetDedicatedServersV1Filter{
    				Name:          pulumi.StringRef("production-web-01"),
    				Ip:            pulumi.StringRef("192.168.1.100"),
    				LocationId:    pulumi.StringRef(serverLocation.Locations[0].Id),
    				Configuration: pulumi.StringRef("EL5"),
    				PrivateSubnet: pulumi.StringRef(subnets.Subnets[0].Id),
    				PublicSubnet:  pulumi.StringRef(subnetsSelectelDedicatedPublicSubnetV1.Subnets[0].Id),
    			},
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Selectel = Pulumi.Selectel;
    
    return await Deployment.RunAsync(() => 
    {
        var servers = Selectel.GetDedicatedServersV1.Invoke(new()
        {
            ProjectId = project.Id,
            Filter = new Selectel.Inputs.GetDedicatedServersV1FilterInputArgs
            {
                Name = "production-web-01",
                Ip = "192.168.1.100",
                LocationId = serverLocation.Locations[0].Id,
                Configuration = "EL5",
                PrivateSubnet = subnets.Subnets[0].Id,
                PublicSubnet = subnetsSelectelDedicatedPublicSubnetV1.Subnets[0].Id,
            },
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.selectel.SelectelFunctions;
    import com.pulumi.selectel.inputs.GetDedicatedServersV1Args;
    import com.pulumi.selectel.inputs.GetDedicatedServersV1FilterArgs;
    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 servers = SelectelFunctions.getDedicatedServersV1(GetDedicatedServersV1Args.builder()
                .projectId(project.id())
                .filter(GetDedicatedServersV1FilterArgs.builder()
                    .name("production-web-01")
                    .ip("192.168.1.100")
                    .locationId(serverLocation.locations()[0].id())
                    .configuration("EL5")
                    .privateSubnet(subnets.subnets()[0].id())
                    .publicSubnet(subnetsSelectelDedicatedPublicSubnetV1.subnets()[0].id())
                    .build())
                .build());
    
        }
    }
    
    variables:
      servers:
        fn::invoke:
          function: selectel:getDedicatedServersV1
          arguments:
            projectId: ${project.id}
            filter:
              name: production-web-01
              ip: 192.168.1.100
              locationId: ${serverLocation.locations[0].id}
              configuration: EL5
              privateSubnet: ${subnets.subnets[0].id}
              publicSubnet: ${subnetsSelectelDedicatedPublicSubnetV1.subnets[0].id}
    
    Example coming soon!
    

    Using getDedicatedServersV1

    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 getDedicatedServersV1(args: GetDedicatedServersV1Args, opts?: InvokeOptions): Promise<GetDedicatedServersV1Result>
    function getDedicatedServersV1Output(args: GetDedicatedServersV1OutputArgs, opts?: InvokeOptions): Output<GetDedicatedServersV1Result>
    def get_dedicated_servers_v1(filter: Optional[GetDedicatedServersV1Filter] = None,
                                 id: Optional[str] = None,
                                 project_id: Optional[str] = None,
                                 opts: Optional[InvokeOptions] = None) -> GetDedicatedServersV1Result
    def get_dedicated_servers_v1_output(filter: pulumi.Input[Optional[GetDedicatedServersV1FilterArgs]] = None,
                                 id: pulumi.Input[Optional[str]] = None,
                                 project_id: pulumi.Input[Optional[str]] = None,
                                 opts: Optional[InvokeOptions] = None) -> Output[GetDedicatedServersV1Result]
    func GetDedicatedServersV1(ctx *Context, args *GetDedicatedServersV1Args, opts ...InvokeOption) (*GetDedicatedServersV1Result, error)
    func GetDedicatedServersV1Output(ctx *Context, args *GetDedicatedServersV1OutputArgs, opts ...InvokeOption) GetDedicatedServersV1ResultOutput

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

    public static class GetDedicatedServersV1 
    {
        public static Task<GetDedicatedServersV1Result> InvokeAsync(GetDedicatedServersV1Args args, InvokeOptions? opts = null)
        public static Output<GetDedicatedServersV1Result> Invoke(GetDedicatedServersV1InvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetDedicatedServersV1Result> getDedicatedServersV1(GetDedicatedServersV1Args args, InvokeOptions options)
    public static Output<GetDedicatedServersV1Result> getDedicatedServersV1(GetDedicatedServersV1Args args, InvokeOptions options)
    
    fn::invoke:
      function: selectel:index/getDedicatedServersV1:getDedicatedServersV1
      arguments:
        # arguments dictionary
    data "selectel_getdedicatedserversv1" "name" {
        # arguments
    }

    The following arguments are supported:

    ProjectId string
    Unique identifier of the associated project. Retrieved from the selectel.VpcProjectV2 resource. Learn more about Projects.
    Filter GetDedicatedServersV1Filter
    Values to filter available servers:
    Id string
    Unique identifier of the server.
    ProjectId string
    Unique identifier of the associated project. Retrieved from the selectel.VpcProjectV2 resource. Learn more about Projects.
    Filter GetDedicatedServersV1Filter
    Values to filter available servers:
    Id string
    Unique identifier of the server.
    project_id string
    Unique identifier of the associated project. Retrieved from the selectel.VpcProjectV2 resource. Learn more about Projects.
    filter object
    Values to filter available servers:
    id string
    Unique identifier of the server.
    projectId String
    Unique identifier of the associated project. Retrieved from the selectel.VpcProjectV2 resource. Learn more about Projects.
    filter GetDedicatedServersV1Filter
    Values to filter available servers:
    id String
    Unique identifier of the server.
    projectId string
    Unique identifier of the associated project. Retrieved from the selectel.VpcProjectV2 resource. Learn more about Projects.
    filter GetDedicatedServersV1Filter
    Values to filter available servers:
    id string
    Unique identifier of the server.
    project_id str
    Unique identifier of the associated project. Retrieved from the selectel.VpcProjectV2 resource. Learn more about Projects.
    filter GetDedicatedServersV1Filter
    Values to filter available servers:
    id str
    Unique identifier of the server.
    projectId String
    Unique identifier of the associated project. Retrieved from the selectel.VpcProjectV2 resource. Learn more about Projects.
    filter Property Map
    Values to filter available servers:
    id String
    Unique identifier of the server.

    getDedicatedServersV1 Result

    The following output properties are available:

    Id string
    Unique identifier of the server.
    ProjectId string
    Servers List<GetDedicatedServersV1Server>
    List of the available servers:
    Filter GetDedicatedServersV1Filter
    Id string
    Unique identifier of the server.
    ProjectId string
    Servers []GetDedicatedServersV1Server
    List of the available servers:
    Filter GetDedicatedServersV1Filter
    id string
    Unique identifier of the server.
    project_id string
    servers list(object)
    List of the available servers:
    filter object
    id String
    Unique identifier of the server.
    projectId String
    servers List<GetDedicatedServersV1Server>
    List of the available servers:
    filter GetDedicatedServersV1Filter
    id string
    Unique identifier of the server.
    projectId string
    servers GetDedicatedServersV1Server[]
    List of the available servers:
    filter GetDedicatedServersV1Filter
    id str
    Unique identifier of the server.
    project_id str
    servers Sequence[GetDedicatedServersV1Server]
    List of the available servers:
    filter GetDedicatedServersV1Filter
    id String
    Unique identifier of the server.
    projectId String
    servers List<Property Map>
    List of the available servers:
    filter Property Map

    Supporting Types

    GetDedicatedServersV1Filter

    Configuration string
    Partial, case-insensitive substring of the configuration display name (e.g. "EL50 SSD"). Matches any server whose configuration name contains the specified string.
    Ip string
    IP address of the server.
    LocationId string
    Unique identifier of the location. Retrieved from the selectel.getDedicatedLocationV1 data source. Learn more about available pools in the Availability matrix.
    Name string
    Name of the server. Supports partial match, case-insensitive.
    PrivateSubnet string
    Unique identifier of a private subnet to which the server belongs. Retrieved from the selectel_dedicated_private_subnet_v1.
    PublicSubnet string
    Unique identifier of a public subnet to which the server belongs. Retrieved from the selectel_dedicated_public_subnet_v1.
    Configuration string
    Partial, case-insensitive substring of the configuration display name (e.g. "EL50 SSD"). Matches any server whose configuration name contains the specified string.
    Ip string
    IP address of the server.
    LocationId string
    Unique identifier of the location. Retrieved from the selectel.getDedicatedLocationV1 data source. Learn more about available pools in the Availability matrix.
    Name string
    Name of the server. Supports partial match, case-insensitive.
    PrivateSubnet string
    Unique identifier of a private subnet to which the server belongs. Retrieved from the selectel_dedicated_private_subnet_v1.
    PublicSubnet string
    Unique identifier of a public subnet to which the server belongs. Retrieved from the selectel_dedicated_public_subnet_v1.
    configuration string
    Partial, case-insensitive substring of the configuration display name (e.g. "EL50 SSD"). Matches any server whose configuration name contains the specified string.
    ip string
    IP address of the server.
    location_id string
    Unique identifier of the location. Retrieved from the selectel.getDedicatedLocationV1 data source. Learn more about available pools in the Availability matrix.
    name string
    Name of the server. Supports partial match, case-insensitive.
    private_subnet string
    Unique identifier of a private subnet to which the server belongs. Retrieved from the selectel_dedicated_private_subnet_v1.
    public_subnet string
    Unique identifier of a public subnet to which the server belongs. Retrieved from the selectel_dedicated_public_subnet_v1.
    configuration String
    Partial, case-insensitive substring of the configuration display name (e.g. "EL50 SSD"). Matches any server whose configuration name contains the specified string.
    ip String
    IP address of the server.
    locationId String
    Unique identifier of the location. Retrieved from the selectel.getDedicatedLocationV1 data source. Learn more about available pools in the Availability matrix.
    name String
    Name of the server. Supports partial match, case-insensitive.
    privateSubnet String
    Unique identifier of a private subnet to which the server belongs. Retrieved from the selectel_dedicated_private_subnet_v1.
    publicSubnet String
    Unique identifier of a public subnet to which the server belongs. Retrieved from the selectel_dedicated_public_subnet_v1.
    configuration string
    Partial, case-insensitive substring of the configuration display name (e.g. "EL50 SSD"). Matches any server whose configuration name contains the specified string.
    ip string
    IP address of the server.
    locationId string
    Unique identifier of the location. Retrieved from the selectel.getDedicatedLocationV1 data source. Learn more about available pools in the Availability matrix.
    name string
    Name of the server. Supports partial match, case-insensitive.
    privateSubnet string
    Unique identifier of a private subnet to which the server belongs. Retrieved from the selectel_dedicated_private_subnet_v1.
    publicSubnet string
    Unique identifier of a public subnet to which the server belongs. Retrieved from the selectel_dedicated_public_subnet_v1.
    configuration str
    Partial, case-insensitive substring of the configuration display name (e.g. "EL50 SSD"). Matches any server whose configuration name contains the specified string.
    ip str
    IP address of the server.
    location_id str
    Unique identifier of the location. Retrieved from the selectel.getDedicatedLocationV1 data source. Learn more about available pools in the Availability matrix.
    name str
    Name of the server. Supports partial match, case-insensitive.
    private_subnet str
    Unique identifier of a private subnet to which the server belongs. Retrieved from the selectel_dedicated_private_subnet_v1.
    public_subnet str
    Unique identifier of a public subnet to which the server belongs. Retrieved from the selectel_dedicated_public_subnet_v1.
    configuration String
    Partial, case-insensitive substring of the configuration display name (e.g. "EL50 SSD"). Matches any server whose configuration name contains the specified string.
    ip String
    IP address of the server.
    locationId String
    Unique identifier of the location. Retrieved from the selectel.getDedicatedLocationV1 data source. Learn more about available pools in the Availability matrix.
    name String
    Name of the server. Supports partial match, case-insensitive.
    privateSubnet String
    Unique identifier of a private subnet to which the server belongs. Retrieved from the selectel_dedicated_private_subnet_v1.
    publicSubnet String
    Unique identifier of a public subnet to which the server belongs. Retrieved from the selectel_dedicated_public_subnet_v1.

    GetDedicatedServersV1Server

    Configuration string
    Partial, case-insensitive substring of the configuration display name (e.g. "EL50 SSD"). Matches any server whose configuration name contains the specified string.
    ConfigurationId string
    Configuration ID of the server.
    Id string
    Unique identifier of the server.
    Location string
    LocationId string
    Location ID of the server.
    Name string
    Server name.
    ReservedPrivateIps List<string>
    List of reserved private IP addresses for the server.
    ReservedPublicIps List<string>
    List of reserved public IP addresses for the server.
    Configuration string
    Partial, case-insensitive substring of the configuration display name (e.g. "EL50 SSD"). Matches any server whose configuration name contains the specified string.
    ConfigurationId string
    Configuration ID of the server.
    Id string
    Unique identifier of the server.
    Location string
    LocationId string
    Location ID of the server.
    Name string
    Server name.
    ReservedPrivateIps []string
    List of reserved private IP addresses for the server.
    ReservedPublicIps []string
    List of reserved public IP addresses for the server.
    configuration string
    Partial, case-insensitive substring of the configuration display name (e.g. "EL50 SSD"). Matches any server whose configuration name contains the specified string.
    configuration_id string
    Configuration ID of the server.
    id string
    Unique identifier of the server.
    location string
    location_id string
    Location ID of the server.
    name string
    Server name.
    reserved_private_ips list(string)
    List of reserved private IP addresses for the server.
    reserved_public_ips list(string)
    List of reserved public IP addresses for the server.
    configuration String
    Partial, case-insensitive substring of the configuration display name (e.g. "EL50 SSD"). Matches any server whose configuration name contains the specified string.
    configurationId String
    Configuration ID of the server.
    id String
    Unique identifier of the server.
    location String
    locationId String
    Location ID of the server.
    name String
    Server name.
    reservedPrivateIps List<String>
    List of reserved private IP addresses for the server.
    reservedPublicIps List<String>
    List of reserved public IP addresses for the server.
    configuration string
    Partial, case-insensitive substring of the configuration display name (e.g. "EL50 SSD"). Matches any server whose configuration name contains the specified string.
    configurationId string
    Configuration ID of the server.
    id string
    Unique identifier of the server.
    location string
    locationId string
    Location ID of the server.
    name string
    Server name.
    reservedPrivateIps string[]
    List of reserved private IP addresses for the server.
    reservedPublicIps string[]
    List of reserved public IP addresses for the server.
    configuration str
    Partial, case-insensitive substring of the configuration display name (e.g. "EL50 SSD"). Matches any server whose configuration name contains the specified string.
    configuration_id str
    Configuration ID of the server.
    id str
    Unique identifier of the server.
    location str
    location_id str
    Location ID of the server.
    name str
    Server name.
    reserved_private_ips Sequence[str]
    List of reserved private IP addresses for the server.
    reserved_public_ips Sequence[str]
    List of reserved public IP addresses for the server.
    configuration String
    Partial, case-insensitive substring of the configuration display name (e.g. "EL50 SSD"). Matches any server whose configuration name contains the specified string.
    configurationId String
    Configuration ID of the server.
    id String
    Unique identifier of the server.
    location String
    locationId String
    Location ID of the server.
    name String
    Server name.
    reservedPrivateIps List<String>
    List of reserved private IP addresses for the server.
    reservedPublicIps List<String>
    List of reserved public IP addresses for the server.

    Package Details

    Repository
    selectel selectel/terraform-provider-selectel
    License
    Notes
    This Pulumi package is based on the selectel Terraform Provider.
    Viewing docs for selectel 8.0.1
    published on Thursday, May 28, 2026 by selectel

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial