1. Packages
  2. Strata Cloud Manager Provider
  3. API Docs
  4. getLayer3Subinterface
Strata Cloud Manager v0.4.3 published on Saturday, Nov 8, 2025 by Pulumi
scm logo
Strata Cloud Manager v0.4.3 published on Saturday, Nov 8, 2025 by Pulumi

    Layer3Subinterface data source

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as scm from "@pulumi/scm";
    
    // Look up layer3 sub-interface by its ID.
    const scmL3SubinterfaceDs = scm.getLayer3Subinterface({
        id: "88f730d1-6577-492b-88a6-73d4a513dc76",
    });
    export const layer3SubinterfaceDataSourceResults = {
        id: scmL3SubinterfaceDs.then(scmL3SubinterfaceDs => scmL3SubinterfaceDs.id),
        name: scmL3SubinterfaceDs.then(scmL3SubinterfaceDs => scmL3SubinterfaceDs.name),
        comment: scmL3SubinterfaceDs.then(scmL3SubinterfaceDs => scmL3SubinterfaceDs.comment),
        ip: scmL3SubinterfaceDs.then(scmL3SubinterfaceDs => scmL3SubinterfaceDs.ips),
        tag: scmL3SubinterfaceDs.then(scmL3SubinterfaceDs => scmL3SubinterfaceDs.tag),
        parentInterface: scmL3SubinterfaceDs.then(scmL3SubinterfaceDs => scmL3SubinterfaceDs.parentInterface),
        folder: scmL3SubinterfaceDs.then(scmL3SubinterfaceDs => scmL3SubinterfaceDs.folder),
    };
    
    import pulumi
    import pulumi_scm as scm
    
    # Look up layer3 sub-interface by its ID.
    scm_l3_subinterface_ds = scm.get_layer3_subinterface(id="88f730d1-6577-492b-88a6-73d4a513dc76")
    pulumi.export("layer3SubinterfaceDataSourceResults", {
        "id": scm_l3_subinterface_ds.id,
        "name": scm_l3_subinterface_ds.name,
        "comment": scm_l3_subinterface_ds.comment,
        "ip": scm_l3_subinterface_ds.ips,
        "tag": scm_l3_subinterface_ds.tag,
        "parentInterface": scm_l3_subinterface_ds.parent_interface,
        "folder": scm_l3_subinterface_ds.folder,
    })
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-scm/sdk/go/scm"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		// Look up layer3 sub-interface by its ID.
    		scmL3SubinterfaceDs, err := scm.LookupLayer3Subinterface(ctx, &scm.LookupLayer3SubinterfaceArgs{
    			Id: "88f730d1-6577-492b-88a6-73d4a513dc76",
    		}, nil)
    		if err != nil {
    			return err
    		}
    		ctx.Export("layer3SubinterfaceDataSourceResults", pulumi.Map{
    			"id":              scmL3SubinterfaceDs.Id,
    			"name":            scmL3SubinterfaceDs.Name,
    			"comment":         scmL3SubinterfaceDs.Comment,
    			"ip":              scmL3SubinterfaceDs.Ips,
    			"tag":             scmL3SubinterfaceDs.Tag,
    			"parentInterface": scmL3SubinterfaceDs.ParentInterface,
    			"folder":          scmL3SubinterfaceDs.Folder,
    		})
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Scm = Pulumi.Scm;
    
    return await Deployment.RunAsync(() => 
    {
        // Look up layer3 sub-interface by its ID.
        var scmL3SubinterfaceDs = Scm.GetLayer3Subinterface.Invoke(new()
        {
            Id = "88f730d1-6577-492b-88a6-73d4a513dc76",
        });
    
        return new Dictionary<string, object?>
        {
            ["layer3SubinterfaceDataSourceResults"] = 
            {
                { "id", scmL3SubinterfaceDs.Apply(getLayer3SubinterfaceResult => getLayer3SubinterfaceResult.Id) },
                { "name", scmL3SubinterfaceDs.Apply(getLayer3SubinterfaceResult => getLayer3SubinterfaceResult.Name) },
                { "comment", scmL3SubinterfaceDs.Apply(getLayer3SubinterfaceResult => getLayer3SubinterfaceResult.Comment) },
                { "ip", scmL3SubinterfaceDs.Apply(getLayer3SubinterfaceResult => getLayer3SubinterfaceResult.Ips) },
                { "tag", scmL3SubinterfaceDs.Apply(getLayer3SubinterfaceResult => getLayer3SubinterfaceResult.Tag) },
                { "parentInterface", scmL3SubinterfaceDs.Apply(getLayer3SubinterfaceResult => getLayer3SubinterfaceResult.ParentInterface) },
                { "folder", scmL3SubinterfaceDs.Apply(getLayer3SubinterfaceResult => getLayer3SubinterfaceResult.Folder) },
            },
        };
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.scm.ScmFunctions;
    import com.pulumi.scm.inputs.GetLayer3SubinterfaceArgs;
    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) {
            // Look up layer3 sub-interface by its ID.
            final var scmL3SubinterfaceDs = ScmFunctions.getLayer3Subinterface(GetLayer3SubinterfaceArgs.builder()
                .id("88f730d1-6577-492b-88a6-73d4a513dc76")
                .build());
    
            ctx.export("layer3SubinterfaceDataSourceResults", Map.ofEntries(
                Map.entry("id", scmL3SubinterfaceDs.id()),
                Map.entry("name", scmL3SubinterfaceDs.name()),
                Map.entry("comment", scmL3SubinterfaceDs.comment()),
                Map.entry("ip", scmL3SubinterfaceDs.ips()),
                Map.entry("tag", scmL3SubinterfaceDs.tag()),
                Map.entry("parentInterface", scmL3SubinterfaceDs.parentInterface()),
                Map.entry("folder", scmL3SubinterfaceDs.folder())
            ));
        }
    }
    
    variables:
      # Look up layer3 sub-interface by its ID.
      scmL3SubinterfaceDs:
        fn::invoke:
          function: scm:getLayer3Subinterface
          arguments:
            id: 88f730d1-6577-492b-88a6-73d4a513dc76
    outputs:
      # Output various attributes from the found layer3 sub-interface to verify the lookups were successful.
      layer3SubinterfaceDataSourceResults:
        id: ${scmL3SubinterfaceDs.id}
        name: ${scmL3SubinterfaceDs.name}
        comment: ${scmL3SubinterfaceDs.comment}
        ip: ${scmL3SubinterfaceDs.ips}
        tag: ${scmL3SubinterfaceDs.tag}
        parentInterface: ${scmL3SubinterfaceDs.parentInterface}
        folder: ${scmL3SubinterfaceDs.folder}
    

    Using getLayer3Subinterface

    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 getLayer3Subinterface(args: GetLayer3SubinterfaceArgs, opts?: InvokeOptions): Promise<GetLayer3SubinterfaceResult>
    function getLayer3SubinterfaceOutput(args: GetLayer3SubinterfaceOutputArgs, opts?: InvokeOptions): Output<GetLayer3SubinterfaceResult>
    def get_layer3_subinterface(id: Optional[str] = None,
                                name: Optional[str] = None,
                                opts: Optional[InvokeOptions] = None) -> GetLayer3SubinterfaceResult
    def get_layer3_subinterface_output(id: Optional[pulumi.Input[str]] = None,
                                name: Optional[pulumi.Input[str]] = None,
                                opts: Optional[InvokeOptions] = None) -> Output[GetLayer3SubinterfaceResult]
    func LookupLayer3Subinterface(ctx *Context, args *LookupLayer3SubinterfaceArgs, opts ...InvokeOption) (*LookupLayer3SubinterfaceResult, error)
    func LookupLayer3SubinterfaceOutput(ctx *Context, args *LookupLayer3SubinterfaceOutputArgs, opts ...InvokeOption) LookupLayer3SubinterfaceResultOutput

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

    public static class GetLayer3Subinterface 
    {
        public static Task<GetLayer3SubinterfaceResult> InvokeAsync(GetLayer3SubinterfaceArgs args, InvokeOptions? opts = null)
        public static Output<GetLayer3SubinterfaceResult> Invoke(GetLayer3SubinterfaceInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetLayer3SubinterfaceResult> getLayer3Subinterface(GetLayer3SubinterfaceArgs args, InvokeOptions options)
    public static Output<GetLayer3SubinterfaceResult> getLayer3Subinterface(GetLayer3SubinterfaceArgs args, InvokeOptions options)
    
    fn::invoke:
      function: scm:index/getLayer3Subinterface:getLayer3Subinterface
      arguments:
        # arguments dictionary

    The following arguments are supported:

    Id string
    UUID of the resource
    Name string
    L3 sub-interface name
    Id string
    UUID of the resource
    Name string
    L3 sub-interface name
    id String
    UUID of the resource
    name String
    L3 sub-interface name
    id string
    UUID of the resource
    name string
    L3 sub-interface name
    id str
    UUID of the resource
    name str
    L3 sub-interface name
    id String
    UUID of the resource
    name String
    L3 sub-interface name

    getLayer3Subinterface Result

    The following output properties are available:

    Arps List<GetLayer3SubinterfaceArp>
    Layer 3 sub Interfaces ARP configuration
    Comment string
    Description
    DdnsConfig GetLayer3SubinterfaceDdnsConfig
    Dynamic DNS configuration specific to the Layer 3 sub Interfaces.
    Device string
    The device in which the resource is defined
    DhcpClient GetLayer3SubinterfaceDhcpClient
    Layer3 sub interfaces DHCP Client Object
    Folder string
    The folder in which the resource is defined
    Id string
    UUID of the resource
    InterfaceManagementProfile string
    Interface management profile
    Ips List<GetLayer3SubinterfaceIp>
    L3 sub-interface IP Parent
    Mtu int
    MTU
    Name string
    L3 sub-interface name
    ParentInterface string
    Parent interface
    Snippet string
    The snippet in which the resource is defined
    Tag int
    VLAN tag
    Tfid string
    Arps []GetLayer3SubinterfaceArp
    Layer 3 sub Interfaces ARP configuration
    Comment string
    Description
    DdnsConfig GetLayer3SubinterfaceDdnsConfig
    Dynamic DNS configuration specific to the Layer 3 sub Interfaces.
    Device string
    The device in which the resource is defined
    DhcpClient GetLayer3SubinterfaceDhcpClient
    Layer3 sub interfaces DHCP Client Object
    Folder string
    The folder in which the resource is defined
    Id string
    UUID of the resource
    InterfaceManagementProfile string
    Interface management profile
    Ips []GetLayer3SubinterfaceIp
    L3 sub-interface IP Parent
    Mtu int
    MTU
    Name string
    L3 sub-interface name
    ParentInterface string
    Parent interface
    Snippet string
    The snippet in which the resource is defined
    Tag int
    VLAN tag
    Tfid string
    arps List<GetLayer3SubinterfaceArp>
    Layer 3 sub Interfaces ARP configuration
    comment String
    Description
    ddnsConfig GetLayer3SubinterfaceDdnsConfig
    Dynamic DNS configuration specific to the Layer 3 sub Interfaces.
    device String
    The device in which the resource is defined
    dhcpClient GetLayer3SubinterfaceDhcpClient
    Layer3 sub interfaces DHCP Client Object
    folder String
    The folder in which the resource is defined
    id String
    UUID of the resource
    interfaceManagementProfile String
    Interface management profile
    ips List<GetLayer3SubinterfaceIp>
    L3 sub-interface IP Parent
    mtu Integer
    MTU
    name String
    L3 sub-interface name
    parentInterface String
    Parent interface
    snippet String
    The snippet in which the resource is defined
    tag Integer
    VLAN tag
    tfid String
    arps GetLayer3SubinterfaceArp[]
    Layer 3 sub Interfaces ARP configuration
    comment string
    Description
    ddnsConfig GetLayer3SubinterfaceDdnsConfig
    Dynamic DNS configuration specific to the Layer 3 sub Interfaces.
    device string
    The device in which the resource is defined
    dhcpClient GetLayer3SubinterfaceDhcpClient
    Layer3 sub interfaces DHCP Client Object
    folder string
    The folder in which the resource is defined
    id string
    UUID of the resource
    interfaceManagementProfile string
    Interface management profile
    ips GetLayer3SubinterfaceIp[]
    L3 sub-interface IP Parent
    mtu number
    MTU
    name string
    L3 sub-interface name
    parentInterface string
    Parent interface
    snippet string
    The snippet in which the resource is defined
    tag number
    VLAN tag
    tfid string
    arps Sequence[GetLayer3SubinterfaceArp]
    Layer 3 sub Interfaces ARP configuration
    comment str
    Description
    ddns_config GetLayer3SubinterfaceDdnsConfig
    Dynamic DNS configuration specific to the Layer 3 sub Interfaces.
    device str
    The device in which the resource is defined
    dhcp_client GetLayer3SubinterfaceDhcpClient
    Layer3 sub interfaces DHCP Client Object
    folder str
    The folder in which the resource is defined
    id str
    UUID of the resource
    interface_management_profile str
    Interface management profile
    ips Sequence[GetLayer3SubinterfaceIp]
    L3 sub-interface IP Parent
    mtu int
    MTU
    name str
    L3 sub-interface name
    parent_interface str
    Parent interface
    snippet str
    The snippet in which the resource is defined
    tag int
    VLAN tag
    tfid str
    arps List<Property Map>
    Layer 3 sub Interfaces ARP configuration
    comment String
    Description
    ddnsConfig Property Map
    Dynamic DNS configuration specific to the Layer 3 sub Interfaces.
    device String
    The device in which the resource is defined
    dhcpClient Property Map
    Layer3 sub interfaces DHCP Client Object
    folder String
    The folder in which the resource is defined
    id String
    UUID of the resource
    interfaceManagementProfile String
    Interface management profile
    ips List<Property Map>
    L3 sub-interface IP Parent
    mtu Number
    MTU
    name String
    L3 sub-interface name
    parentInterface String
    Parent interface
    snippet String
    The snippet in which the resource is defined
    tag Number
    VLAN tag
    tfid String

    Supporting Types

    GetLayer3SubinterfaceArp

    HwAddress string
    MAC address
    Name string
    IP address
    HwAddress string
    MAC address
    Name string
    IP address
    hwAddress String
    MAC address
    name String
    IP address
    hwAddress string
    MAC address
    name string
    IP address
    hw_address str
    MAC address
    name str
    IP address
    hwAddress String
    MAC address
    name String
    IP address

    GetLayer3SubinterfaceDdnsConfig

    DdnsCertProfile string
    Certificate profile
    DdnsEnabled bool
    Enable DDNS?
    DdnsHostname string
    Ddns hostname
    DdnsIp string
    IP to register (static only)
    DdnsUpdateInterval int
    Update interval (days)
    DdnsVendor string
    DDNS vendor
    DdnsVendorConfig string
    DDNS vendor
    DdnsCertProfile string
    Certificate profile
    DdnsEnabled bool
    Enable DDNS?
    DdnsHostname string
    Ddns hostname
    DdnsIp string
    IP to register (static only)
    DdnsUpdateInterval int
    Update interval (days)
    DdnsVendor string
    DDNS vendor
    DdnsVendorConfig string
    DDNS vendor
    ddnsCertProfile String
    Certificate profile
    ddnsEnabled Boolean
    Enable DDNS?
    ddnsHostname String
    Ddns hostname
    ddnsIp String
    IP to register (static only)
    ddnsUpdateInterval Integer
    Update interval (days)
    ddnsVendor String
    DDNS vendor
    ddnsVendorConfig String
    DDNS vendor
    ddnsCertProfile string
    Certificate profile
    ddnsEnabled boolean
    Enable DDNS?
    ddnsHostname string
    Ddns hostname
    ddnsIp string
    IP to register (static only)
    ddnsUpdateInterval number
    Update interval (days)
    ddnsVendor string
    DDNS vendor
    ddnsVendorConfig string
    DDNS vendor
    ddns_cert_profile str
    Certificate profile
    ddns_enabled bool
    Enable DDNS?
    ddns_hostname str
    Ddns hostname
    ddns_ip str
    IP to register (static only)
    ddns_update_interval int
    Update interval (days)
    ddns_vendor str
    DDNS vendor
    ddns_vendor_config str
    DDNS vendor
    ddnsCertProfile String
    Certificate profile
    ddnsEnabled Boolean
    Enable DDNS?
    ddnsHostname String
    Ddns hostname
    ddnsIp String
    IP to register (static only)
    ddnsUpdateInterval Number
    Update interval (days)
    ddnsVendor String
    DDNS vendor
    ddnsVendorConfig String
    DDNS vendor

    GetLayer3SubinterfaceDhcpClient

    CreateDefaultRoute bool
    Automatically create default route pointing to default gateway provided by server
    DefaultRouteMetric int
    Metric of the default route created
    Enable bool
    Enable DHCP?
    SendHostname GetLayer3SubinterfaceDhcpClientSendHostname
    Layer3 sub interfaces DHCP Client Send hostname
    CreateDefaultRoute bool
    Automatically create default route pointing to default gateway provided by server
    DefaultRouteMetric int
    Metric of the default route created
    Enable bool
    Enable DHCP?
    SendHostname GetLayer3SubinterfaceDhcpClientSendHostname
    Layer3 sub interfaces DHCP Client Send hostname
    createDefaultRoute Boolean
    Automatically create default route pointing to default gateway provided by server
    defaultRouteMetric Integer
    Metric of the default route created
    enable Boolean
    Enable DHCP?
    sendHostname GetLayer3SubinterfaceDhcpClientSendHostname
    Layer3 sub interfaces DHCP Client Send hostname
    createDefaultRoute boolean
    Automatically create default route pointing to default gateway provided by server
    defaultRouteMetric number
    Metric of the default route created
    enable boolean
    Enable DHCP?
    sendHostname GetLayer3SubinterfaceDhcpClientSendHostname
    Layer3 sub interfaces DHCP Client Send hostname
    create_default_route bool
    Automatically create default route pointing to default gateway provided by server
    default_route_metric int
    Metric of the default route created
    enable bool
    Enable DHCP?
    send_hostname GetLayer3SubinterfaceDhcpClientSendHostname
    Layer3 sub interfaces DHCP Client Send hostname
    createDefaultRoute Boolean
    Automatically create default route pointing to default gateway provided by server
    defaultRouteMetric Number
    Metric of the default route created
    enable Boolean
    Enable DHCP?
    sendHostname Property Map
    Layer3 sub interfaces DHCP Client Send hostname

    GetLayer3SubinterfaceDhcpClientSendHostname

    Enable bool
    Enable
    Hostname string
    Set interface hostname
    Enable bool
    Enable
    Hostname string
    Set interface hostname
    enable Boolean
    Enable
    hostname String
    Set interface hostname
    enable boolean
    Enable
    hostname string
    Set interface hostname
    enable bool
    Enable
    hostname str
    Set interface hostname
    enable Boolean
    Enable
    hostname String
    Set interface hostname

    GetLayer3SubinterfaceIp

    Name string
    L3 sub-interface IP address(es)
    Name string
    L3 sub-interface IP address(es)
    name String
    L3 sub-interface IP address(es)
    name string
    L3 sub-interface IP address(es)
    name str
    L3 sub-interface IP address(es)
    name String
    L3 sub-interface IP address(es)

    Package Details

    Repository
    scm pulumi/pulumi-scm
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the scm Terraform Provider.
    scm logo
    Strata Cloud Manager v0.4.3 published on Saturday, Nov 8, 2025 by Pulumi
      Meet Neo: Your AI Platform Teammate