1. Packages
  2. Packages
  3. Scaleway
  4. API Docs
  5. interlink
  6. getDedicatedConnection
Viewing docs for Scaleway v1.48.0
published on Wednesday, Apr 29, 2026 by pulumiverse
scaleway logo
Viewing docs for Scaleway v1.48.0
published on Wednesday, Apr 29, 2026 by pulumiverse

    Gets information about an Interlink Dedicated Connection.

    A dedicated connection is a physical connection owned by the user at a PoP, used to create self-hosted links between your infrastructure and Scaleway.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as scaleway from "@pulumiverse/scaleway";
    
    // Retrieve a dedicated connection by its ID
    const byId = scaleway.interlink.getDedicatedConnection({
        connectionId: "11111111-1111-1111-1111-111111111111",
    });
    
    import pulumi
    import pulumi_scaleway as scaleway
    
    # Retrieve a dedicated connection by its ID
    by_id = scaleway.interlink.get_dedicated_connection(connection_id="11111111-1111-1111-1111-111111111111")
    
    package main
    
    import (
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    	"github.com/pulumiverse/pulumi-scaleway/sdk/go/scaleway/interlink"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		// Retrieve a dedicated connection by its ID
    		_, err := interlink.GetDedicatedConnection(ctx, &interlink.GetDedicatedConnectionArgs{
    			ConnectionId: pulumi.StringRef("11111111-1111-1111-1111-111111111111"),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Scaleway = Pulumiverse.Scaleway;
    
    return await Deployment.RunAsync(() => 
    {
        // Retrieve a dedicated connection by its ID
        var byId = Scaleway.Interlink.GetDedicatedConnection.Invoke(new()
        {
            ConnectionId = "11111111-1111-1111-1111-111111111111",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.scaleway.interlink.InterlinkFunctions;
    import com.pulumi.scaleway.interlink.inputs.GetDedicatedConnectionArgs;
    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) {
            // Retrieve a dedicated connection by its ID
            final var byId = InterlinkFunctions.getDedicatedConnection(GetDedicatedConnectionArgs.builder()
                .connectionId("11111111-1111-1111-1111-111111111111")
                .build());
    
        }
    }
    
    variables:
      # Retrieve a dedicated connection by its ID
      byId:
        fn::invoke:
          function: scaleway:interlink:getDedicatedConnection
          arguments:
            connectionId: 11111111-1111-1111-1111-111111111111
    
    import * as pulumi from "@pulumi/pulumi";
    import * as scaleway from "@pulumiverse/scaleway";
    
    // Retrieve a dedicated connection by name
    const byName = scaleway.interlink.getDedicatedConnection({
        name: "my-dedicated-connection",
    });
    
    import pulumi
    import pulumi_scaleway as scaleway
    
    # Retrieve a dedicated connection by name
    by_name = scaleway.interlink.get_dedicated_connection(name="my-dedicated-connection")
    
    package main
    
    import (
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    	"github.com/pulumiverse/pulumi-scaleway/sdk/go/scaleway/interlink"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		// Retrieve a dedicated connection by name
    		_, err := interlink.GetDedicatedConnection(ctx, &interlink.GetDedicatedConnectionArgs{
    			Name: pulumi.StringRef("my-dedicated-connection"),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Scaleway = Pulumiverse.Scaleway;
    
    return await Deployment.RunAsync(() => 
    {
        // Retrieve a dedicated connection by name
        var byName = Scaleway.Interlink.GetDedicatedConnection.Invoke(new()
        {
            Name = "my-dedicated-connection",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.scaleway.interlink.InterlinkFunctions;
    import com.pulumi.scaleway.interlink.inputs.GetDedicatedConnectionArgs;
    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) {
            // Retrieve a dedicated connection by name
            final var byName = InterlinkFunctions.getDedicatedConnection(GetDedicatedConnectionArgs.builder()
                .name("my-dedicated-connection")
                .build());
    
        }
    }
    
    variables:
      # Retrieve a dedicated connection by name
      byName:
        fn::invoke:
          function: scaleway:interlink:getDedicatedConnection
          arguments:
            name: my-dedicated-connection
    

    Using getDedicatedConnection

    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 getDedicatedConnection(args: GetDedicatedConnectionArgs, opts?: InvokeOptions): Promise<GetDedicatedConnectionResult>
    function getDedicatedConnectionOutput(args: GetDedicatedConnectionOutputArgs, opts?: InvokeOptions): Output<GetDedicatedConnectionResult>
    def get_dedicated_connection(connection_id: Optional[str] = None,
                                 name: Optional[str] = None,
                                 region: Optional[str] = None,
                                 opts: Optional[InvokeOptions] = None) -> GetDedicatedConnectionResult
    def get_dedicated_connection_output(connection_id: Optional[pulumi.Input[str]] = None,
                                 name: Optional[pulumi.Input[str]] = None,
                                 region: Optional[pulumi.Input[str]] = None,
                                 opts: Optional[InvokeOptions] = None) -> Output[GetDedicatedConnectionResult]
    func GetDedicatedConnection(ctx *Context, args *GetDedicatedConnectionArgs, opts ...InvokeOption) (*GetDedicatedConnectionResult, error)
    func GetDedicatedConnectionOutput(ctx *Context, args *GetDedicatedConnectionOutputArgs, opts ...InvokeOption) GetDedicatedConnectionResultOutput

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

    public static class GetDedicatedConnection 
    {
        public static Task<GetDedicatedConnectionResult> InvokeAsync(GetDedicatedConnectionArgs args, InvokeOptions? opts = null)
        public static Output<GetDedicatedConnectionResult> Invoke(GetDedicatedConnectionInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetDedicatedConnectionResult> getDedicatedConnection(GetDedicatedConnectionArgs args, InvokeOptions options)
    public static Output<GetDedicatedConnectionResult> getDedicatedConnection(GetDedicatedConnectionArgs args, InvokeOptions options)
    
    fn::invoke:
      function: scaleway:interlink/getDedicatedConnection:getDedicatedConnection
      arguments:
        # arguments dictionary

    The following arguments are supported:

    ConnectionId string
    The ID of the dedicated connection. Can be a plain UUID or a regional ID. Conflicts with name.
    Name string
    The name of the dedicated connection to filter for. Conflicts with connectionId.
    Region string
    region) The region in which the dedicated connection exists.
    ConnectionId string
    The ID of the dedicated connection. Can be a plain UUID or a regional ID. Conflicts with name.
    Name string
    The name of the dedicated connection to filter for. Conflicts with connectionId.
    Region string
    region) The region in which the dedicated connection exists.
    connectionId String
    The ID of the dedicated connection. Can be a plain UUID or a regional ID. Conflicts with name.
    name String
    The name of the dedicated connection to filter for. Conflicts with connectionId.
    region String
    region) The region in which the dedicated connection exists.
    connectionId string
    The ID of the dedicated connection. Can be a plain UUID or a regional ID. Conflicts with name.
    name string
    The name of the dedicated connection to filter for. Conflicts with connectionId.
    region string
    region) The region in which the dedicated connection exists.
    connection_id str
    The ID of the dedicated connection. Can be a plain UUID or a regional ID. Conflicts with name.
    name str
    The name of the dedicated connection to filter for. Conflicts with connectionId.
    region str
    region) The region in which the dedicated connection exists.
    connectionId String
    The ID of the dedicated connection. Can be a plain UUID or a regional ID. Conflicts with name.
    name String
    The name of the dedicated connection to filter for. Conflicts with connectionId.
    region String
    region) The region in which the dedicated connection exists.

    getDedicatedConnection Result

    The following output properties are available:

    AvailableLinkBandwidths List<int>
    Sizes of the links supported on this dedicated connection.
    BandwidthMbps int
    Bandwidth size of the dedicated connection in Mbps.
    CreatedAt string
    Creation date of the dedicated connection (RFC 3339 format).
    DemarcationInfo string
    Demarcation details required by the data center to set up the Cross Connect.
    Id string
    The provider-assigned unique ID for this managed resource.
    Name string
    OrganizationId string
    The ID of the organization the dedicated connection belongs to.
    PopId string
    ID of the PoP where the dedicated connection is located.
    ProjectId string
    The ID of the project the dedicated connection belongs to.
    Status string
    Status of the dedicated connection.
    Tags List<string>
    List of tags associated with the dedicated connection.
    UpdatedAt string
    Last modification date of the dedicated connection (RFC 3339 format).
    VlanRanges List<Pulumiverse.Scaleway.Interlink.Outputs.GetDedicatedConnectionVlanRange>
    VLAN range for self-hosted links. Contains start and end.
    ConnectionId string
    Region string
    AvailableLinkBandwidths []int
    Sizes of the links supported on this dedicated connection.
    BandwidthMbps int
    Bandwidth size of the dedicated connection in Mbps.
    CreatedAt string
    Creation date of the dedicated connection (RFC 3339 format).
    DemarcationInfo string
    Demarcation details required by the data center to set up the Cross Connect.
    Id string
    The provider-assigned unique ID for this managed resource.
    Name string
    OrganizationId string
    The ID of the organization the dedicated connection belongs to.
    PopId string
    ID of the PoP where the dedicated connection is located.
    ProjectId string
    The ID of the project the dedicated connection belongs to.
    Status string
    Status of the dedicated connection.
    Tags []string
    List of tags associated with the dedicated connection.
    UpdatedAt string
    Last modification date of the dedicated connection (RFC 3339 format).
    VlanRanges []GetDedicatedConnectionVlanRange
    VLAN range for self-hosted links. Contains start and end.
    ConnectionId string
    Region string
    availableLinkBandwidths List<Integer>
    Sizes of the links supported on this dedicated connection.
    bandwidthMbps Integer
    Bandwidth size of the dedicated connection in Mbps.
    createdAt String
    Creation date of the dedicated connection (RFC 3339 format).
    demarcationInfo String
    Demarcation details required by the data center to set up the Cross Connect.
    id String
    The provider-assigned unique ID for this managed resource.
    name String
    organizationId String
    The ID of the organization the dedicated connection belongs to.
    popId String
    ID of the PoP where the dedicated connection is located.
    projectId String
    The ID of the project the dedicated connection belongs to.
    status String
    Status of the dedicated connection.
    tags List<String>
    List of tags associated with the dedicated connection.
    updatedAt String
    Last modification date of the dedicated connection (RFC 3339 format).
    vlanRanges List<GetDedicatedConnectionVlanRange>
    VLAN range for self-hosted links. Contains start and end.
    connectionId String
    region String
    availableLinkBandwidths number[]
    Sizes of the links supported on this dedicated connection.
    bandwidthMbps number
    Bandwidth size of the dedicated connection in Mbps.
    createdAt string
    Creation date of the dedicated connection (RFC 3339 format).
    demarcationInfo string
    Demarcation details required by the data center to set up the Cross Connect.
    id string
    The provider-assigned unique ID for this managed resource.
    name string
    organizationId string
    The ID of the organization the dedicated connection belongs to.
    popId string
    ID of the PoP where the dedicated connection is located.
    projectId string
    The ID of the project the dedicated connection belongs to.
    status string
    Status of the dedicated connection.
    tags string[]
    List of tags associated with the dedicated connection.
    updatedAt string
    Last modification date of the dedicated connection (RFC 3339 format).
    vlanRanges GetDedicatedConnectionVlanRange[]
    VLAN range for self-hosted links. Contains start and end.
    connectionId string
    region string
    available_link_bandwidths Sequence[int]
    Sizes of the links supported on this dedicated connection.
    bandwidth_mbps int
    Bandwidth size of the dedicated connection in Mbps.
    created_at str
    Creation date of the dedicated connection (RFC 3339 format).
    demarcation_info str
    Demarcation details required by the data center to set up the Cross Connect.
    id str
    The provider-assigned unique ID for this managed resource.
    name str
    organization_id str
    The ID of the organization the dedicated connection belongs to.
    pop_id str
    ID of the PoP where the dedicated connection is located.
    project_id str
    The ID of the project the dedicated connection belongs to.
    status str
    Status of the dedicated connection.
    tags Sequence[str]
    List of tags associated with the dedicated connection.
    updated_at str
    Last modification date of the dedicated connection (RFC 3339 format).
    vlan_ranges Sequence[GetDedicatedConnectionVlanRange]
    VLAN range for self-hosted links. Contains start and end.
    connection_id str
    region str
    availableLinkBandwidths List<Number>
    Sizes of the links supported on this dedicated connection.
    bandwidthMbps Number
    Bandwidth size of the dedicated connection in Mbps.
    createdAt String
    Creation date of the dedicated connection (RFC 3339 format).
    demarcationInfo String
    Demarcation details required by the data center to set up the Cross Connect.
    id String
    The provider-assigned unique ID for this managed resource.
    name String
    organizationId String
    The ID of the organization the dedicated connection belongs to.
    popId String
    ID of the PoP where the dedicated connection is located.
    projectId String
    The ID of the project the dedicated connection belongs to.
    status String
    Status of the dedicated connection.
    tags List<String>
    List of tags associated with the dedicated connection.
    updatedAt String
    Last modification date of the dedicated connection (RFC 3339 format).
    vlanRanges List<Property Map>
    VLAN range for self-hosted links. Contains start and end.
    connectionId String
    region String

    Supporting Types

    GetDedicatedConnectionVlanRange

    End int
    End of the VLAN range
    Start int
    Start of the VLAN range
    End int
    End of the VLAN range
    Start int
    Start of the VLAN range
    end Integer
    End of the VLAN range
    start Integer
    Start of the VLAN range
    end number
    End of the VLAN range
    start number
    Start of the VLAN range
    end int
    End of the VLAN range
    start int
    Start of the VLAN range
    end Number
    End of the VLAN range
    start Number
    Start of the VLAN range

    Package Details

    Repository
    scaleway pulumiverse/pulumi-scaleway
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the scaleway Terraform Provider.
    scaleway logo
    Viewing docs for Scaleway v1.48.0
    published on Wednesday, Apr 29, 2026 by pulumiverse
      Try Pulumi Cloud free. Your team will thank you.