1. Registry
  2. Packages
  3. Gcore Provider
  4. API Docs
  5. getNetwork
Viewing docs for gcore 0.36.0
published on Friday, Aug 28, 2026 by g-core
Viewing docs for gcore 0.36.0
published on Friday, Aug 28, 2026 by g-core

    Represent network. A network is a software-defined network in a cloud computing infrastructure

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as gcore from "@pulumi/gcore";
    
    const pr = gcore.getProject({
        name: "test",
    });
    const rg = gcore.getRegion({
        name: "ED-10 Preprod",
    });
    const tnw = Promise.all([rg, pr]).then(([rg, pr]) => gcore.getNetwork({
        name: "example",
        regionId: rg.id,
        projectId: pr.id,
    }));
    export const view = tnw;
    
    import pulumi
    import pulumi_gcore as gcore
    
    pr = gcore.get_project(name="test")
    rg = gcore.get_region(name="ED-10 Preprod")
    tnw = gcore.get_network(name="example",
        region_id=rg.id,
        project_id=pr.id)
    pulumi.export("view", tnw)
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-terraform-provider/sdks/go/gcore/gcore"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		pr, err := gcore.GetProject(ctx, &gcore.GetProjectArgs{
    			Name: "test",
    		}, nil)
    		if err != nil {
    			return err
    		}
    		rg, err := gcore.GetRegion(ctx, &gcore.GetRegionArgs{
    			Name: "ED-10 Preprod",
    		}, nil)
    		if err != nil {
    			return err
    		}
    		tnw, err := gcore.LookupNetwork(ctx, &gcore.LookupNetworkArgs{
    			Name:      "example",
    			RegionId:  pulumi.Float64Ref(rg.Id),
    			ProjectId: pulumi.Float64Ref(pr.Id),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		ctx.Export("view", tnw)
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Gcore = Pulumi.Gcore;
    
    return await Deployment.RunAsync(() => 
    {
        var pr = Gcore.GetProject.Invoke(new()
        {
            Name = "test",
        });
    
        var rg = Gcore.GetRegion.Invoke(new()
        {
            Name = "ED-10 Preprod",
        });
    
        var tnw = Gcore.GetNetwork.Invoke(new()
        {
            Name = "example",
            RegionId = rg.Apply(getRegionResult => getRegionResult.Id),
            ProjectId = pr.Apply(getProjectResult => getProjectResult.Id),
        });
    
        return new Dictionary<string, object?>
        {
            ["view"] = tnw,
        };
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.gcore.GcoreFunctions;
    import com.pulumi.gcore.inputs.GetProjectArgs;
    import com.pulumi.gcore.inputs.GetRegionArgs;
    import com.pulumi.gcore.inputs.GetNetworkArgs;
    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 pr = GcoreFunctions.getProject(GetProjectArgs.builder()
                .name("test")
                .build());
    
            final var rg = GcoreFunctions.getRegion(GetRegionArgs.builder()
                .name("ED-10 Preprod")
                .build());
    
            final var tnw = GcoreFunctions.getNetwork(GetNetworkArgs.builder()
                .name("example")
                .regionId(rg.id())
                .projectId(pr.id())
                .build());
    
            ctx.export("view", tnw);
        }
    }
    
    variables:
      pr:
        fn::invoke:
          function: gcore:getProject
          arguments:
            name: test
      rg:
        fn::invoke:
          function: gcore:getRegion
          arguments:
            name: ED-10 Preprod
      tnw:
        fn::invoke:
          function: gcore:getNetwork
          arguments:
            name: example
            regionId: ${rg.id}
            projectId: ${pr.id}
    outputs:
      view: ${tnw}
    
    Example coming soon!
    

    Using getNetwork

    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 getNetwork(args: GetNetworkArgs, opts?: InvokeOptions): Promise<GetNetworkResult>
    function getNetworkOutput(args: GetNetworkOutputArgs, opts?: InvokeOutputOptions): Output<GetNetworkResult>
    def get_network(id: Optional[str] = None,
                    metadata_k: Optional[str] = None,
                    metadata_kv: Optional[Mapping[str, str]] = None,
                    name: Optional[str] = None,
                    project_id: Optional[float] = None,
                    project_name: Optional[str] = None,
                    region_id: Optional[float] = None,
                    region_name: Optional[str] = None,
                    opts: Optional[InvokeOptions] = None) -> GetNetworkResult
    def get_network_output(id: pulumi.Input[Optional[str]] = None,
                    metadata_k: pulumi.Input[Optional[str]] = None,
                    metadata_kv: pulumi.Input[Optional[Mapping[str, pulumi.Input[str]]]] = None,
                    name: pulumi.Input[Optional[str]] = None,
                    project_id: pulumi.Input[Optional[float]] = None,
                    project_name: pulumi.Input[Optional[str]] = None,
                    region_id: pulumi.Input[Optional[float]] = None,
                    region_name: pulumi.Input[Optional[str]] = None,
                    opts: Optional[InvokeOutputOptions] = None) -> Output[GetNetworkResult]
    func LookupNetwork(ctx *Context, args *LookupNetworkArgs, opts ...InvokeOption) (*LookupNetworkResult, error)
    func LookupNetworkOutput(ctx *Context, args *LookupNetworkOutputArgs, opts ...InvokeOption) LookupNetworkResultOutput

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

    public static class GetNetwork 
    {
        public static Task<GetNetworkResult> InvokeAsync(GetNetworkArgs args, InvokeOptions? opts = null)
        public static Output<GetNetworkResult> Invoke(GetNetworkInvokeArgs args, InvokeOptions? opts = null)
        public static Output<GetNetworkResult> Invoke(GetNetworkInvokeArgs args, InvokeOutputOptions opts)
    }
    public static CompletableFuture<GetNetworkResult> getNetwork(GetNetworkArgs args, InvokeOptions options)
    public static Output<GetNetworkResult> getNetwork(GetNetworkArgs args, InvokeOptions options)
    public static Output<GetNetworkResult> getNetwork(GetNetworkArgs args, InvokeOutputOptions options)
    
    fn::invoke:
      function: gcore:index/getNetwork:getNetwork
      arguments:
        # arguments dictionary
    data "gcore_get_network" "name" {
        # arguments
    }

    The following arguments are supported:

    Name string
    Id string
    The ID of this resource.
    MetadataK string
    MetadataKv Dictionary<string, string>
    ProjectId double
    ProjectName string
    RegionId double
    RegionName string
    Name string
    Id string
    The ID of this resource.
    MetadataK string
    MetadataKv map[string]string
    ProjectId float64
    ProjectName string
    RegionId float64
    RegionName string
    name string
    id string
    The ID of this resource.
    metadata_k string
    metadata_kv map(string)
    project_id number
    project_name string
    region_id number
    region_name string
    name String
    id String
    The ID of this resource.
    metadataK String
    metadataKv Map<String,String>
    projectId Double
    projectName String
    regionId Double
    regionName String
    name string
    id string
    The ID of this resource.
    metadataK string
    metadataKv {[key: string]: string}
    projectId number
    projectName string
    regionId number
    regionName string
    name str
    id str
    The ID of this resource.
    metadata_k str
    metadata_kv Mapping[str, str]
    project_id float
    project_name str
    region_id float
    region_name str
    name String
    id String
    The ID of this resource.
    metadataK String
    metadataKv Map<String>
    projectId Number
    projectName String
    regionId Number
    regionName String

    getNetwork Result

    The following output properties are available:

    External bool
    Id string
    The ID of this resource.
    MetadataReadOnlies List<GetNetworkMetadataReadOnly>
    Mtu double
    Name string
    Shared bool
    Type string
    'vlan' or 'vxlan' network type is allowed. Default value is 'vxlan'
    MetadataK string
    MetadataKv Dictionary<string, string>
    ProjectId double
    ProjectName string
    RegionId double
    RegionName string
    External bool
    Id string
    The ID of this resource.
    MetadataReadOnlies []GetNetworkMetadataReadOnly
    Mtu float64
    Name string
    Shared bool
    Type string
    'vlan' or 'vxlan' network type is allowed. Default value is 'vxlan'
    MetadataK string
    MetadataKv map[string]string
    ProjectId float64
    ProjectName string
    RegionId float64
    RegionName string
    external bool
    id string
    The ID of this resource.
    metadata_read_onlies list(object)
    mtu number
    name string
    shared bool
    type string
    'vlan' or 'vxlan' network type is allowed. Default value is 'vxlan'
    metadata_k string
    metadata_kv map(string)
    project_id number
    project_name string
    region_id number
    region_name string
    external Boolean
    id String
    The ID of this resource.
    metadataReadOnlies List<GetNetworkMetadataReadOnly>
    mtu Double
    name String
    shared Boolean
    type String
    'vlan' or 'vxlan' network type is allowed. Default value is 'vxlan'
    metadataK String
    metadataKv Map<String,String>
    projectId Double
    projectName String
    regionId Double
    regionName String
    external boolean
    id string
    The ID of this resource.
    metadataReadOnlies GetNetworkMetadataReadOnly[]
    mtu number
    name string
    shared boolean
    type string
    'vlan' or 'vxlan' network type is allowed. Default value is 'vxlan'
    metadataK string
    metadataKv {[key: string]: string}
    projectId number
    projectName string
    regionId number
    regionName string
    external bool
    id str
    The ID of this resource.
    metadata_read_onlies Sequence[GetNetworkMetadataReadOnly]
    mtu float
    name str
    shared bool
    type str
    'vlan' or 'vxlan' network type is allowed. Default value is 'vxlan'
    metadata_k str
    metadata_kv Mapping[str, str]
    project_id float
    project_name str
    region_id float
    region_name str
    external Boolean
    id String
    The ID of this resource.
    metadataReadOnlies List<Property Map>
    mtu Number
    name String
    shared Boolean
    type String
    'vlan' or 'vxlan' network type is allowed. Default value is 'vxlan'
    metadataK String
    metadataKv Map<String>
    projectId Number
    projectName String
    regionId Number
    regionName String

    Supporting Types

    GetNetworkMetadataReadOnly

    Key string
    ReadOnly bool
    Value string
    Key string
    ReadOnly bool
    Value string
    key string
    read_only bool
    value string
    key String
    readOnly Boolean
    value String
    key string
    readOnly boolean
    value string
    key str
    read_only bool
    value str
    key String
    readOnly Boolean
    value String

    Package Details

    Repository
    gcore g-core/terraform-provider-gcore
    License
    Notes
    This Pulumi package is based on the gcore Terraform Provider.
    Viewing docs for gcore 0.36.0
    published on Friday, Aug 28, 2026 by g-core

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial