1. Packages
  2. Vcd Provider
  3. API Docs
  4. getNsxtEdgegateway
vcd 3.14.1 published on Monday, Apr 14, 2025 by vmware

vcd.getNsxtEdgegateway

Explore with Pulumi AI

Provides a VMware Cloud Director NSX-T edge gateway data source. This can be used to read NSX-T edge gateway configurations.

Supported in provider v3.1+.

Example Usage

NSX-T Edge Gateway Belonging To VDC Group)

import * as pulumi from "@pulumi/pulumi";
import * as vcd from "@pulumi/vcd";

const group1 = vcd.getVdcGroup({
    name: "existing-group",
});
const t1 = group1.then(group1 => vcd.getNsxtEdgegateway({
    org: "myorg",
    ownerId: group1.id,
    name: "nsxt-edge-gateway",
}));
Copy
import pulumi
import pulumi_vcd as vcd

group1 = vcd.get_vdc_group(name="existing-group")
t1 = vcd.get_nsxt_edgegateway(org="myorg",
    owner_id=group1.id,
    name="nsxt-edge-gateway")
Copy
package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/vcd/v3/vcd"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		group1, err := vcd.LookupVdcGroup(ctx, &vcd.LookupVdcGroupArgs{
			Name: pulumi.StringRef("existing-group"),
		}, nil)
		if err != nil {
			return err
		}
		_, err = vcd.LookupNsxtEdgegateway(ctx, &vcd.LookupNsxtEdgegatewayArgs{
			Org:     pulumi.StringRef("myorg"),
			OwnerId: pulumi.StringRef(group1.Id),
			Name:    "nsxt-edge-gateway",
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
Copy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Vcd = Pulumi.Vcd;

return await Deployment.RunAsync(() => 
{
    var group1 = Vcd.GetVdcGroup.Invoke(new()
    {
        Name = "existing-group",
    });

    var t1 = Vcd.GetNsxtEdgegateway.Invoke(new()
    {
        Org = "myorg",
        OwnerId = group1.Apply(getVdcGroupResult => getVdcGroupResult.Id),
        Name = "nsxt-edge-gateway",
    });

});
Copy
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.vcd.VcdFunctions;
import com.pulumi.vcd.inputs.GetVdcGroupArgs;
import com.pulumi.vcd.inputs.GetNsxtEdgegatewayArgs;
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 group1 = VcdFunctions.getVdcGroup(GetVdcGroupArgs.builder()
            .name("existing-group")
            .build());

        final var t1 = VcdFunctions.getNsxtEdgegateway(GetNsxtEdgegatewayArgs.builder()
            .org("myorg")
            .ownerId(group1.applyValue(getVdcGroupResult -> getVdcGroupResult.id()))
            .name("nsxt-edge-gateway")
            .build());

    }
}
Copy
variables:
  group1:
    fn::invoke:
      function: vcd:getVdcGroup
      arguments:
        name: existing-group
  t1:
    fn::invoke:
      function: vcd:getNsxtEdgegateway
      arguments:
        org: myorg
        ownerId: ${group1.id}
        name: nsxt-edge-gateway
Copy

NSX-T Edge Gateway Belonging To VDC)

import * as pulumi from "@pulumi/pulumi";
import * as vcd from "@pulumi/vcd";

const vdc1 = vcd.getOrgVdc({
    name: "existing-vdc",
});
const t1 = vdc1.then(vdc1 => vcd.getNsxtEdgegateway({
    org: "myorg",
    ownerId: vdc1.id,
    name: "nsxt-edge-gateway",
}));
Copy
import pulumi
import pulumi_vcd as vcd

vdc1 = vcd.get_org_vdc(name="existing-vdc")
t1 = vcd.get_nsxt_edgegateway(org="myorg",
    owner_id=vdc1.id,
    name="nsxt-edge-gateway")
Copy
package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/vcd/v3/vcd"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		vdc1, err := vcd.LookupOrgVdc(ctx, &vcd.LookupOrgVdcArgs{
			Name: "existing-vdc",
		}, nil)
		if err != nil {
			return err
		}
		_, err = vcd.LookupNsxtEdgegateway(ctx, &vcd.LookupNsxtEdgegatewayArgs{
			Org:     pulumi.StringRef("myorg"),
			OwnerId: pulumi.StringRef(vdc1.Id),
			Name:    "nsxt-edge-gateway",
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
Copy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Vcd = Pulumi.Vcd;

return await Deployment.RunAsync(() => 
{
    var vdc1 = Vcd.GetOrgVdc.Invoke(new()
    {
        Name = "existing-vdc",
    });

    var t1 = Vcd.GetNsxtEdgegateway.Invoke(new()
    {
        Org = "myorg",
        OwnerId = vdc1.Apply(getOrgVdcResult => getOrgVdcResult.Id),
        Name = "nsxt-edge-gateway",
    });

});
Copy
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.vcd.VcdFunctions;
import com.pulumi.vcd.inputs.GetOrgVdcArgs;
import com.pulumi.vcd.inputs.GetNsxtEdgegatewayArgs;
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 vdc1 = VcdFunctions.getOrgVdc(GetOrgVdcArgs.builder()
            .name("existing-vdc")
            .build());

        final var t1 = VcdFunctions.getNsxtEdgegateway(GetNsxtEdgegatewayArgs.builder()
            .org("myorg")
            .ownerId(vdc1.applyValue(getOrgVdcResult -> getOrgVdcResult.id()))
            .name("nsxt-edge-gateway")
            .build());

    }
}
Copy
variables:
  vdc1:
    fn::invoke:
      function: vcd:getOrgVdc
      arguments:
        name: existing-vdc
  t1:
    fn::invoke:
      function: vcd:getNsxtEdgegateway
      arguments:
        org: myorg
        ownerId: ${vdc1.id}
        name: nsxt-edge-gateway
Copy

Using getNsxtEdgegateway

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 getNsxtEdgegateway(args: GetNsxtEdgegatewayArgs, opts?: InvokeOptions): Promise<GetNsxtEdgegatewayResult>
function getNsxtEdgegatewayOutput(args: GetNsxtEdgegatewayOutputArgs, opts?: InvokeOptions): Output<GetNsxtEdgegatewayResult>
Copy
def get_nsxt_edgegateway(edge_cluster_id: Optional[str] = None,
                         id: Optional[str] = None,
                         ip_count_read_limit: Optional[float] = None,
                         name: Optional[str] = None,
                         org: Optional[str] = None,
                         owner_id: Optional[str] = None,
                         vdc: Optional[str] = None,
                         opts: Optional[InvokeOptions] = None) -> GetNsxtEdgegatewayResult
def get_nsxt_edgegateway_output(edge_cluster_id: Optional[pulumi.Input[str]] = None,
                         id: Optional[pulumi.Input[str]] = None,
                         ip_count_read_limit: Optional[pulumi.Input[float]] = None,
                         name: Optional[pulumi.Input[str]] = None,
                         org: Optional[pulumi.Input[str]] = None,
                         owner_id: Optional[pulumi.Input[str]] = None,
                         vdc: Optional[pulumi.Input[str]] = None,
                         opts: Optional[InvokeOptions] = None) -> Output[GetNsxtEdgegatewayResult]
Copy
func LookupNsxtEdgegateway(ctx *Context, args *LookupNsxtEdgegatewayArgs, opts ...InvokeOption) (*LookupNsxtEdgegatewayResult, error)
func LookupNsxtEdgegatewayOutput(ctx *Context, args *LookupNsxtEdgegatewayOutputArgs, opts ...InvokeOption) LookupNsxtEdgegatewayResultOutput
Copy

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

public static class GetNsxtEdgegateway 
{
    public static Task<GetNsxtEdgegatewayResult> InvokeAsync(GetNsxtEdgegatewayArgs args, InvokeOptions? opts = null)
    public static Output<GetNsxtEdgegatewayResult> Invoke(GetNsxtEdgegatewayInvokeArgs args, InvokeOptions? opts = null)
}
Copy
public static CompletableFuture<GetNsxtEdgegatewayResult> getNsxtEdgegateway(GetNsxtEdgegatewayArgs args, InvokeOptions options)
public static Output<GetNsxtEdgegatewayResult> getNsxtEdgegateway(GetNsxtEdgegatewayArgs args, InvokeOptions options)
Copy
fn::invoke:
  function: vcd:index/getNsxtEdgegateway:getNsxtEdgegateway
  arguments:
    # arguments dictionary
Copy

The following arguments are supported:

Name This property is required. string
NSX-T Edge Gateway name.
EdgeClusterId string
Id string
IpCountReadLimit double
Sets a limit of IPs to count for used_ip_count and unused_ip_count attributes to avoid exhausting compute resource while counting IPs in large IPv6 subnets. It does not affect operation of Edge Gateway configuration, only IP count reporting. Defaults to 1000000. While it is unlikely that a single Edge Gateway can effectively manage more IPs, one can specify 0 for unlimited value.
Org string
The name of organization to which the NSX-T Edge Gateway belongs. Optional if defined at provider level.
OwnerId string

The ID of VDC or VDC Group. Note: Data sources vcd.VdcGroup or vcd.OrgVdc can be used to lookup IDs by name.

Only one of vdc or owner_id can be specified. owner_id takes precedence over vdc definition at provider level.

Vdc string
Deprecated - please use owner_id field. The name of VDC that owns the NSX-T Edge Gateway. Optional if defined at provider level.

Deprecated: Deprecated

Name This property is required. string
NSX-T Edge Gateway name.
EdgeClusterId string
Id string
IpCountReadLimit float64
Sets a limit of IPs to count for used_ip_count and unused_ip_count attributes to avoid exhausting compute resource while counting IPs in large IPv6 subnets. It does not affect operation of Edge Gateway configuration, only IP count reporting. Defaults to 1000000. While it is unlikely that a single Edge Gateway can effectively manage more IPs, one can specify 0 for unlimited value.
Org string
The name of organization to which the NSX-T Edge Gateway belongs. Optional if defined at provider level.
OwnerId string

The ID of VDC or VDC Group. Note: Data sources vcd.VdcGroup or vcd.OrgVdc can be used to lookup IDs by name.

Only one of vdc or owner_id can be specified. owner_id takes precedence over vdc definition at provider level.

Vdc string
Deprecated - please use owner_id field. The name of VDC that owns the NSX-T Edge Gateway. Optional if defined at provider level.

Deprecated: Deprecated

name This property is required. String
NSX-T Edge Gateway name.
edgeClusterId String
id String
ipCountReadLimit Double
Sets a limit of IPs to count for used_ip_count and unused_ip_count attributes to avoid exhausting compute resource while counting IPs in large IPv6 subnets. It does not affect operation of Edge Gateway configuration, only IP count reporting. Defaults to 1000000. While it is unlikely that a single Edge Gateway can effectively manage more IPs, one can specify 0 for unlimited value.
org String
The name of organization to which the NSX-T Edge Gateway belongs. Optional if defined at provider level.
ownerId String

The ID of VDC or VDC Group. Note: Data sources vcd.VdcGroup or vcd.OrgVdc can be used to lookup IDs by name.

Only one of vdc or owner_id can be specified. owner_id takes precedence over vdc definition at provider level.

vdc String
Deprecated - please use owner_id field. The name of VDC that owns the NSX-T Edge Gateway. Optional if defined at provider level.

Deprecated: Deprecated

name This property is required. string
NSX-T Edge Gateway name.
edgeClusterId string
id string
ipCountReadLimit number
Sets a limit of IPs to count for used_ip_count and unused_ip_count attributes to avoid exhausting compute resource while counting IPs in large IPv6 subnets. It does not affect operation of Edge Gateway configuration, only IP count reporting. Defaults to 1000000. While it is unlikely that a single Edge Gateway can effectively manage more IPs, one can specify 0 for unlimited value.
org string
The name of organization to which the NSX-T Edge Gateway belongs. Optional if defined at provider level.
ownerId string

The ID of VDC or VDC Group. Note: Data sources vcd.VdcGroup or vcd.OrgVdc can be used to lookup IDs by name.

Only one of vdc or owner_id can be specified. owner_id takes precedence over vdc definition at provider level.

vdc string
Deprecated - please use owner_id field. The name of VDC that owns the NSX-T Edge Gateway. Optional if defined at provider level.

Deprecated: Deprecated

name This property is required. str
NSX-T Edge Gateway name.
edge_cluster_id str
id str
ip_count_read_limit float
Sets a limit of IPs to count for used_ip_count and unused_ip_count attributes to avoid exhausting compute resource while counting IPs in large IPv6 subnets. It does not affect operation of Edge Gateway configuration, only IP count reporting. Defaults to 1000000. While it is unlikely that a single Edge Gateway can effectively manage more IPs, one can specify 0 for unlimited value.
org str
The name of organization to which the NSX-T Edge Gateway belongs. Optional if defined at provider level.
owner_id str

The ID of VDC or VDC Group. Note: Data sources vcd.VdcGroup or vcd.OrgVdc can be used to lookup IDs by name.

Only one of vdc or owner_id can be specified. owner_id takes precedence over vdc definition at provider level.

vdc str
Deprecated - please use owner_id field. The name of VDC that owns the NSX-T Edge Gateway. Optional if defined at provider level.

Deprecated: Deprecated

name This property is required. String
NSX-T Edge Gateway name.
edgeClusterId String
id String
ipCountReadLimit Number
Sets a limit of IPs to count for used_ip_count and unused_ip_count attributes to avoid exhausting compute resource while counting IPs in large IPv6 subnets. It does not affect operation of Edge Gateway configuration, only IP count reporting. Defaults to 1000000. While it is unlikely that a single Edge Gateway can effectively manage more IPs, one can specify 0 for unlimited value.
org String
The name of organization to which the NSX-T Edge Gateway belongs. Optional if defined at provider level.
ownerId String

The ID of VDC or VDC Group. Note: Data sources vcd.VdcGroup or vcd.OrgVdc can be used to lookup IDs by name.

Only one of vdc or owner_id can be specified. owner_id takes precedence over vdc definition at provider level.

vdc String
Deprecated - please use owner_id field. The name of VDC that owns the NSX-T Edge Gateway. Optional if defined at provider level.

Deprecated: Deprecated

getNsxtEdgegateway Result

The following output properties are available:

Supporting Types

GetNsxtEdgegatewayExternalNetwork

AllocatedIpCount This property is required. double
ExternalNetworkId This property is required. string
Gateway This property is required. string
PrefixLength This property is required. double
PrimaryIp This property is required. string
AllocatedIpCount This property is required. float64
ExternalNetworkId This property is required. string
Gateway This property is required. string
PrefixLength This property is required. float64
PrimaryIp This property is required. string
allocatedIpCount This property is required. Double
externalNetworkId This property is required. String
gateway This property is required. String
prefixLength This property is required. Double
primaryIp This property is required. String
allocatedIpCount This property is required. number
externalNetworkId This property is required. string
gateway This property is required. string
prefixLength This property is required. number
primaryIp This property is required. string
allocated_ip_count This property is required. float
external_network_id This property is required. str
gateway This property is required. str
prefix_length This property is required. float
primary_ip This property is required. str
allocatedIpCount This property is required. Number
externalNetworkId This property is required. String
gateway This property is required. String
prefixLength This property is required. Number
primaryIp This property is required. String

GetNsxtEdgegatewaySubnet

AllocatedIps This property is required. List<GetNsxtEdgegatewaySubnetAllocatedIp>
Gateway This property is required. string
PrefixLength This property is required. double
PrimaryIp This property is required. string
AllocatedIps This property is required. []GetNsxtEdgegatewaySubnetAllocatedIp
Gateway This property is required. string
PrefixLength This property is required. float64
PrimaryIp This property is required. string
allocatedIps This property is required. List<GetNsxtEdgegatewaySubnetAllocatedIp>
gateway This property is required. String
prefixLength This property is required. Double
primaryIp This property is required. String
allocatedIps This property is required. GetNsxtEdgegatewaySubnetAllocatedIp[]
gateway This property is required. string
prefixLength This property is required. number
primaryIp This property is required. string
allocated_ips This property is required. Sequence[GetNsxtEdgegatewaySubnetAllocatedIp]
gateway This property is required. str
prefix_length This property is required. float
primary_ip This property is required. str
allocatedIps This property is required. List<Property Map>
gateway This property is required. String
prefixLength This property is required. Number
primaryIp This property is required. String

GetNsxtEdgegatewaySubnetAllocatedIp

EndAddress This property is required. string
StartAddress This property is required. string
EndAddress This property is required. string
StartAddress This property is required. string
endAddress This property is required. String
startAddress This property is required. String
endAddress This property is required. string
startAddress This property is required. string
end_address This property is required. str
start_address This property is required. str
endAddress This property is required. String
startAddress This property is required. String

GetNsxtEdgegatewaySubnetWithIpCount

AllocatedIpCount This property is required. double
Gateway This property is required. string
PrefixLength This property is required. double
PrimaryIp This property is required. string
AllocatedIpCount This property is required. float64
Gateway This property is required. string
PrefixLength This property is required. float64
PrimaryIp This property is required. string
allocatedIpCount This property is required. Double
gateway This property is required. String
prefixLength This property is required. Double
primaryIp This property is required. String
allocatedIpCount This property is required. number
gateway This property is required. string
prefixLength This property is required. number
primaryIp This property is required. string
allocated_ip_count This property is required. float
gateway This property is required. str
prefix_length This property is required. float
primary_ip This property is required. str
allocatedIpCount This property is required. Number
gateway This property is required. String
prefixLength This property is required. Number
primaryIp This property is required. String

GetNsxtEdgegatewaySubnetWithTotalIpCount

Gateway This property is required. string
PrefixLength This property is required. double
PrimaryIp This property is required. string
Gateway This property is required. string
PrefixLength This property is required. float64
PrimaryIp This property is required. string
gateway This property is required. String
prefixLength This property is required. Double
primaryIp This property is required. String
gateway This property is required. string
prefixLength This property is required. number
primaryIp This property is required. string
gateway This property is required. str
prefix_length This property is required. float
primary_ip This property is required. str
gateway This property is required. String
prefixLength This property is required. Number
primaryIp This property is required. String

Package Details

Repository
vcd vmware/terraform-provider-vcd
License
Notes
This Pulumi package is based on the vcd Terraform Provider.