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

vcd.getExternalNetwork

Explore with Pulumi AI

Provides a VMware Cloud Director external network data source. This can be used to reference external networks and their properties.

Supported in provider v2.5+

This resource is deprecated in favor of vcd.ExternalNetworkV2

Using getExternalNetwork

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 getExternalNetwork(args: GetExternalNetworkArgs, opts?: InvokeOptions): Promise<GetExternalNetworkResult>
function getExternalNetworkOutput(args: GetExternalNetworkOutputArgs, opts?: InvokeOptions): Output<GetExternalNetworkResult>
Copy
def get_external_network(id: Optional[str] = None,
                         name: Optional[str] = None,
                         opts: Optional[InvokeOptions] = None) -> GetExternalNetworkResult
def get_external_network_output(id: Optional[pulumi.Input[str]] = None,
                         name: Optional[pulumi.Input[str]] = None,
                         opts: Optional[InvokeOptions] = None) -> Output[GetExternalNetworkResult]
Copy
func LookupExternalNetwork(ctx *Context, args *LookupExternalNetworkArgs, opts ...InvokeOption) (*LookupExternalNetworkResult, error)
func LookupExternalNetworkOutput(ctx *Context, args *LookupExternalNetworkOutputArgs, opts ...InvokeOption) LookupExternalNetworkResultOutput
Copy

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

public static class GetExternalNetwork 
{
    public static Task<GetExternalNetworkResult> InvokeAsync(GetExternalNetworkArgs args, InvokeOptions? opts = null)
    public static Output<GetExternalNetworkResult> Invoke(GetExternalNetworkInvokeArgs args, InvokeOptions? opts = null)
}
Copy
public static CompletableFuture<GetExternalNetworkResult> getExternalNetwork(GetExternalNetworkArgs args, InvokeOptions options)
public static Output<GetExternalNetworkResult> getExternalNetwork(GetExternalNetworkArgs args, InvokeOptions options)
Copy
fn::invoke:
  function: vcd:index/getExternalNetwork:getExternalNetwork
  arguments:
    # arguments dictionary
Copy

The following arguments are supported:

Name This property is required. string
external network name
Id string
Name This property is required. string
external network name
Id string
name This property is required. String
external network name
id String
name This property is required. string
external network name
id string
name This property is required. str
external network name
id str
name This property is required. String
external network name
id String

getExternalNetwork Result

The following output properties are available:

Description string
Network friendly description
Id string
IpScopes List<GetExternalNetworkIpScope>
A list of IP scopes for the network. See IP Scope for details.
Name string
RetainNetInfoAcrossDeployments bool
Specifies whether the network resources such as IP/MAC of router will be retained across deployments.
VsphereNetworks List<GetExternalNetworkVsphereNetwork>
A list of DV_PORTGROUP or NETWORK objects names that back this network. Each referenced DV_PORTGROUP or NETWORK must exist on a vCenter server registered with the system. See vSphere Network for details.
Description string
Network friendly description
Id string
IpScopes []GetExternalNetworkIpScope
A list of IP scopes for the network. See IP Scope for details.
Name string
RetainNetInfoAcrossDeployments bool
Specifies whether the network resources such as IP/MAC of router will be retained across deployments.
VsphereNetworks []GetExternalNetworkVsphereNetwork
A list of DV_PORTGROUP or NETWORK objects names that back this network. Each referenced DV_PORTGROUP or NETWORK must exist on a vCenter server registered with the system. See vSphere Network for details.
description String
Network friendly description
id String
ipScopes List<GetExternalNetworkIpScope>
A list of IP scopes for the network. See IP Scope for details.
name String
retainNetInfoAcrossDeployments Boolean
Specifies whether the network resources such as IP/MAC of router will be retained across deployments.
vsphereNetworks List<GetExternalNetworkVsphereNetwork>
A list of DV_PORTGROUP or NETWORK objects names that back this network. Each referenced DV_PORTGROUP or NETWORK must exist on a vCenter server registered with the system. See vSphere Network for details.
description string
Network friendly description
id string
ipScopes GetExternalNetworkIpScope[]
A list of IP scopes for the network. See IP Scope for details.
name string
retainNetInfoAcrossDeployments boolean
Specifies whether the network resources such as IP/MAC of router will be retained across deployments.
vsphereNetworks GetExternalNetworkVsphereNetwork[]
A list of DV_PORTGROUP or NETWORK objects names that back this network. Each referenced DV_PORTGROUP or NETWORK must exist on a vCenter server registered with the system. See vSphere Network for details.
description str
Network friendly description
id str
ip_scopes Sequence[GetExternalNetworkIpScope]
A list of IP scopes for the network. See IP Scope for details.
name str
retain_net_info_across_deployments bool
Specifies whether the network resources such as IP/MAC of router will be retained across deployments.
vsphere_networks Sequence[GetExternalNetworkVsphereNetwork]
A list of DV_PORTGROUP or NETWORK objects names that back this network. Each referenced DV_PORTGROUP or NETWORK must exist on a vCenter server registered with the system. See vSphere Network for details.
description String
Network friendly description
id String
ipScopes List<Property Map>
A list of IP scopes for the network. See IP Scope for details.
name String
retainNetInfoAcrossDeployments Boolean
Specifies whether the network resources such as IP/MAC of router will be retained across deployments.
vsphereNetworks List<Property Map>
A list of DV_PORTGROUP or NETWORK objects names that back this network. Each referenced DV_PORTGROUP or NETWORK must exist on a vCenter server registered with the system. See vSphere Network for details.

Supporting Types

GetExternalNetworkIpScope

Dns1 This property is required. string
Dns2 This property is required. string
DnsSuffix This property is required. string
Gateway This property is required. string
Netmask This property is required. string
StaticIpPools This property is required. List<GetExternalNetworkIpScopeStaticIpPool>
Dns1 This property is required. string
Dns2 This property is required. string
DnsSuffix This property is required. string
Gateway This property is required. string
Netmask This property is required. string
StaticIpPools This property is required. []GetExternalNetworkIpScopeStaticIpPool
dns1 This property is required. String
dns2 This property is required. String
dnsSuffix This property is required. String
gateway This property is required. String
netmask This property is required. String
staticIpPools This property is required. List<GetExternalNetworkIpScopeStaticIpPool>
dns1 This property is required. string
dns2 This property is required. string
dnsSuffix This property is required. string
gateway This property is required. string
netmask This property is required. string
staticIpPools This property is required. GetExternalNetworkIpScopeStaticIpPool[]
dns1 This property is required. str
dns2 This property is required. str
dns_suffix This property is required. str
gateway This property is required. str
netmask This property is required. str
static_ip_pools This property is required. Sequence[GetExternalNetworkIpScopeStaticIpPool]
dns1 This property is required. String
dns2 This property is required. String
dnsSuffix This property is required. String
gateway This property is required. String
netmask This property is required. String
staticIpPools This property is required. List<Property Map>

GetExternalNetworkIpScopeStaticIpPool

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

GetExternalNetworkVsphereNetwork

Name This property is required. string
external network name
Type This property is required. string
Vcenter This property is required. string
Name This property is required. string
external network name
Type This property is required. string
Vcenter This property is required. string
name This property is required. String
external network name
type This property is required. String
vcenter This property is required. String
name This property is required. string
external network name
type This property is required. string
vcenter This property is required. string
name This property is required. str
external network name
type This property is required. str
vcenter This property is required. str
name This property is required. String
external network name
type This property is required. String
vcenter 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.