1. Packages
  2. Packages
  3. Cisco Catalyst SD-WAN Provider
  4. API Docs
  5. getNetworkHierarchyNode
Viewing docs for Cisco Catalyst SD-WAN v0.9.2
published on Wednesday, Jul 29, 2026 by Pulumi
sdwan logo
Viewing docs for Cisco Catalyst SD-WAN v0.9.2
published on Wednesday, Jul 29, 2026 by Pulumi

    This data source can read a Network Hierarchy Node.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as sdwan from "@pulumi/sdwan";
    
    const example = sdwan.getNetworkHierarchyNode({
        id: "f6b2c44c-693c-4763-b010-895aa3d236bd",
    });
    
    import pulumi
    import pulumi_sdwan as sdwan
    
    example = sdwan.get_network_hierarchy_node(id="f6b2c44c-693c-4763-b010-895aa3d236bd")
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-sdwan/sdk/go/sdwan"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := sdwan.GetNetworkHierarchyNode(ctx, &sdwan.LookupNetworkHierarchyNodeArgs{
    			Id: pulumi.StringRef("f6b2c44c-693c-4763-b010-895aa3d236bd"),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Sdwan = Pulumi.Sdwan;
    
    return await Deployment.RunAsync(() => 
    {
        var example = Sdwan.GetNetworkHierarchyNode.Invoke(new()
        {
            Id = "f6b2c44c-693c-4763-b010-895aa3d236bd",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.sdwan.SdwanFunctions;
    import com.pulumi.sdwan.inputs.GetNetworkHierarchyNodeArgs;
    import java.util.ArrayList;
    import java.util.Arrays;
    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 = SdwanFunctions.getNetworkHierarchyNode(GetNetworkHierarchyNodeArgs.builder()
                .id("f6b2c44c-693c-4763-b010-895aa3d236bd")
                .build());
    
        }
    }
    
    variables:
      example:
        fn::invoke:
          function: sdwan:getNetworkHierarchyNode
          arguments:
            id: f6b2c44c-693c-4763-b010-895aa3d236bd
    
    pulumi {
      required_providers {
        sdwan = {
          source = "pulumi/sdwan"
        }
      }
    }
    
    data "sdwan_getnetworkhierarchynode" "example" {
      id = "f6b2c44c-693c-4763-b010-895aa3d236bd"
    }
    

    Using getNetworkHierarchyNode

    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 getNetworkHierarchyNode(args: GetNetworkHierarchyNodeArgs, opts?: InvokeOptions): Promise<GetNetworkHierarchyNodeResult>
    function getNetworkHierarchyNodeOutput(args: GetNetworkHierarchyNodeOutputArgs, opts?: InvokeOptions): Output<GetNetworkHierarchyNodeResult>
    def get_network_hierarchy_node(id: Optional[str] = None,
                                   name: Optional[str] = None,
                                   site_id: Optional[int] = None,
                                   opts: Optional[InvokeOptions] = None) -> GetNetworkHierarchyNodeResult
    def get_network_hierarchy_node_output(id: pulumi.Input[Optional[str]] = None,
                                   name: pulumi.Input[Optional[str]] = None,
                                   site_id: pulumi.Input[Optional[int]] = None,
                                   opts: Optional[InvokeOptions] = None) -> Output[GetNetworkHierarchyNodeResult]
    func LookupNetworkHierarchyNode(ctx *Context, args *LookupNetworkHierarchyNodeArgs, opts ...InvokeOption) (*LookupNetworkHierarchyNodeResult, error)
    func LookupNetworkHierarchyNodeOutput(ctx *Context, args *LookupNetworkHierarchyNodeOutputArgs, opts ...InvokeOption) LookupNetworkHierarchyNodeResultOutput

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

    public static class GetNetworkHierarchyNode 
    {
        public static Task<GetNetworkHierarchyNodeResult> InvokeAsync(GetNetworkHierarchyNodeArgs args, InvokeOptions? opts = null)
        public static Output<GetNetworkHierarchyNodeResult> Invoke(GetNetworkHierarchyNodeInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetNetworkHierarchyNodeResult> getNetworkHierarchyNode(GetNetworkHierarchyNodeArgs args, InvokeOptions options)
    public static Output<GetNetworkHierarchyNodeResult> getNetworkHierarchyNode(GetNetworkHierarchyNodeArgs args, InvokeOptions options)
    
    fn::invoke:
      function: sdwan:index/getNetworkHierarchyNode:getNetworkHierarchyNode
      arguments:
        # arguments dictionary
    data "sdwan_get_network_hierarchy_node" "name" {
        # arguments
    }

    The following arguments are supported:

    Id string
    The id of the object
    Name string
    The name of the node
    SiteId int
    The site ID (only for site type nodes). Can be used to look up a site node by its site ID.
    Id string
    The id of the object
    Name string
    The name of the node
    SiteId int
    The site ID (only for site type nodes). Can be used to look up a site node by its site ID.
    id string
    The id of the object
    name string
    The name of the node
    site_id number
    The site ID (only for site type nodes). Can be used to look up a site node by its site ID.
    id String
    The id of the object
    name String
    The name of the node
    siteId Integer
    The site ID (only for site type nodes). Can be used to look up a site node by its site ID.
    id string
    The id of the object
    name string
    The name of the node
    siteId number
    The site ID (only for site type nodes). Can be used to look up a site node by its site ID.
    id str
    The id of the object
    name str
    The name of the node
    site_id int
    The site ID (only for site type nodes). Can be used to look up a site node by its site ID.
    id String
    The id of the object
    name String
    The name of the node
    siteId Number
    The site ID (only for site type nodes). Can be used to look up a site node by its site ID.

    getNetworkHierarchyNode Result

    The following output properties are available:

    Address GetNetworkHierarchyNodeAddress
    The address of the site (only for site type nodes)
    Description string
    The description of the node
    Id string
    The id of the object
    IsSecondary bool
    Whether this is a secondary region (only for region type nodes)
    Latitude double
    The GPS latitude of the site (only for site type nodes). Required when location is set to a real location. Supported on SD-WAN Manager 20.18 and later.
    Location string
    The location (place name) of the site (only for site type nodes). On SD-WAN Manager 20.18 and later this replaces address; defaults to Undisclosed when not set. When a real location is set, latitude and longitude are required.
    Longitude double
    The GPS longitude of the site (only for site type nodes). Required when location is set to a real location. Supported on SD-WAN Manager 20.18 and later.
    Name string
    The name of the node
    ParentGroup string
    The name of the parent group
    SiteId int
    The site ID (only for site type nodes). Can be used to look up a site node by its site ID.
    Type string
    The type of node (group, region, or site)
    Address GetNetworkHierarchyNodeAddress
    The address of the site (only for site type nodes)
    Description string
    The description of the node
    Id string
    The id of the object
    IsSecondary bool
    Whether this is a secondary region (only for region type nodes)
    Latitude float64
    The GPS latitude of the site (only for site type nodes). Required when location is set to a real location. Supported on SD-WAN Manager 20.18 and later.
    Location string
    The location (place name) of the site (only for site type nodes). On SD-WAN Manager 20.18 and later this replaces address; defaults to Undisclosed when not set. When a real location is set, latitude and longitude are required.
    Longitude float64
    The GPS longitude of the site (only for site type nodes). Required when location is set to a real location. Supported on SD-WAN Manager 20.18 and later.
    Name string
    The name of the node
    ParentGroup string
    The name of the parent group
    SiteId int
    The site ID (only for site type nodes). Can be used to look up a site node by its site ID.
    Type string
    The type of node (group, region, or site)
    address object
    The address of the site (only for site type nodes)
    description string
    The description of the node
    id string
    The id of the object
    is_secondary bool
    Whether this is a secondary region (only for region type nodes)
    latitude number
    The GPS latitude of the site (only for site type nodes). Required when location is set to a real location. Supported on SD-WAN Manager 20.18 and later.
    location string
    The location (place name) of the site (only for site type nodes). On SD-WAN Manager 20.18 and later this replaces address; defaults to Undisclosed when not set. When a real location is set, latitude and longitude are required.
    longitude number
    The GPS longitude of the site (only for site type nodes). Required when location is set to a real location. Supported on SD-WAN Manager 20.18 and later.
    name string
    The name of the node
    parent_group string
    The name of the parent group
    site_id number
    The site ID (only for site type nodes). Can be used to look up a site node by its site ID.
    type string
    The type of node (group, region, or site)
    address GetNetworkHierarchyNodeAddress
    The address of the site (only for site type nodes)
    description String
    The description of the node
    id String
    The id of the object
    isSecondary Boolean
    Whether this is a secondary region (only for region type nodes)
    latitude Double
    The GPS latitude of the site (only for site type nodes). Required when location is set to a real location. Supported on SD-WAN Manager 20.18 and later.
    location String
    The location (place name) of the site (only for site type nodes). On SD-WAN Manager 20.18 and later this replaces address; defaults to Undisclosed when not set. When a real location is set, latitude and longitude are required.
    longitude Double
    The GPS longitude of the site (only for site type nodes). Required when location is set to a real location. Supported on SD-WAN Manager 20.18 and later.
    name String
    The name of the node
    parentGroup String
    The name of the parent group
    siteId Integer
    The site ID (only for site type nodes). Can be used to look up a site node by its site ID.
    type String
    The type of node (group, region, or site)
    address GetNetworkHierarchyNodeAddress
    The address of the site (only for site type nodes)
    description string
    The description of the node
    id string
    The id of the object
    isSecondary boolean
    Whether this is a secondary region (only for region type nodes)
    latitude number
    The GPS latitude of the site (only for site type nodes). Required when location is set to a real location. Supported on SD-WAN Manager 20.18 and later.
    location string
    The location (place name) of the site (only for site type nodes). On SD-WAN Manager 20.18 and later this replaces address; defaults to Undisclosed when not set. When a real location is set, latitude and longitude are required.
    longitude number
    The GPS longitude of the site (only for site type nodes). Required when location is set to a real location. Supported on SD-WAN Manager 20.18 and later.
    name string
    The name of the node
    parentGroup string
    The name of the parent group
    siteId number
    The site ID (only for site type nodes). Can be used to look up a site node by its site ID.
    type string
    The type of node (group, region, or site)
    address GetNetworkHierarchyNodeAddress
    The address of the site (only for site type nodes)
    description str
    The description of the node
    id str
    The id of the object
    is_secondary bool
    Whether this is a secondary region (only for region type nodes)
    latitude float
    The GPS latitude of the site (only for site type nodes). Required when location is set to a real location. Supported on SD-WAN Manager 20.18 and later.
    location str
    The location (place name) of the site (only for site type nodes). On SD-WAN Manager 20.18 and later this replaces address; defaults to Undisclosed when not set. When a real location is set, latitude and longitude are required.
    longitude float
    The GPS longitude of the site (only for site type nodes). Required when location is set to a real location. Supported on SD-WAN Manager 20.18 and later.
    name str
    The name of the node
    parent_group str
    The name of the parent group
    site_id int
    The site ID (only for site type nodes). Can be used to look up a site node by its site ID.
    type str
    The type of node (group, region, or site)
    address Property Map
    The address of the site (only for site type nodes)
    description String
    The description of the node
    id String
    The id of the object
    isSecondary Boolean
    Whether this is a secondary region (only for region type nodes)
    latitude Number
    The GPS latitude of the site (only for site type nodes). Required when location is set to a real location. Supported on SD-WAN Manager 20.18 and later.
    location String
    The location (place name) of the site (only for site type nodes). On SD-WAN Manager 20.18 and later this replaces address; defaults to Undisclosed when not set. When a real location is set, latitude and longitude are required.
    longitude Number
    The GPS longitude of the site (only for site type nodes). Required when location is set to a real location. Supported on SD-WAN Manager 20.18 and later.
    name String
    The name of the node
    parentGroup String
    The name of the parent group
    siteId Number
    The site ID (only for site type nodes). Can be used to look up a site node by its site ID.
    type String
    The type of node (group, region, or site)

    Supporting Types

    GetNetworkHierarchyNodeAddress

    City string
    City
    Country string
    Country
    State string
    State or province
    Street string
    Street address
    Zipcode string
    Zip or postal code
    City string
    City
    Country string
    Country
    State string
    State or province
    Street string
    Street address
    Zipcode string
    Zip or postal code
    city string
    City
    country string
    Country
    state string
    State or province
    street string
    Street address
    zipcode string
    Zip or postal code
    city String
    City
    country String
    Country
    state String
    State or province
    street String
    Street address
    zipcode String
    Zip or postal code
    city string
    City
    country string
    Country
    state string
    State or province
    street string
    Street address
    zipcode string
    Zip or postal code
    city str
    City
    country str
    Country
    state str
    State or province
    street str
    Street address
    zipcode str
    Zip or postal code
    city String
    City
    country String
    Country
    state String
    State or province
    street String
    Street address
    zipcode String
    Zip or postal code

    Package Details

    Repository
    sdwan pulumi/pulumi-sdwan
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the sdwan Terraform Provider.
    sdwan logo
    Viewing docs for Cisco Catalyst SD-WAN v0.9.2
    published on Wednesday, Jul 29, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial