Google Cloud Native is in preview. Google Cloud Classic is fully supported.
google-native.vmwareengine/v1.getNetworkPeering
Explore with Pulumi AI
Google Cloud Native is in preview. Google Cloud Classic is fully supported.
Retrieves a NetworkPeering
resource by its resource name. The resource contains details of the network peering, such as peered networks, import and export custom route configurations, and peering state.
Using getNetworkPeering
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 getNetworkPeering(args: GetNetworkPeeringArgs, opts?: InvokeOptions): Promise<GetNetworkPeeringResult>
function getNetworkPeeringOutput(args: GetNetworkPeeringOutputArgs, opts?: InvokeOptions): Output<GetNetworkPeeringResult>
def get_network_peering(network_peering_id: Optional[str] = None,
project: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetNetworkPeeringResult
def get_network_peering_output(network_peering_id: Optional[pulumi.Input[str]] = None,
project: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetNetworkPeeringResult]
func LookupNetworkPeering(ctx *Context, args *LookupNetworkPeeringArgs, opts ...InvokeOption) (*LookupNetworkPeeringResult, error)
func LookupNetworkPeeringOutput(ctx *Context, args *LookupNetworkPeeringOutputArgs, opts ...InvokeOption) LookupNetworkPeeringResultOutput
> Note: This function is named LookupNetworkPeering
in the Go SDK.
public static class GetNetworkPeering
{
public static Task<GetNetworkPeeringResult> InvokeAsync(GetNetworkPeeringArgs args, InvokeOptions? opts = null)
public static Output<GetNetworkPeeringResult> Invoke(GetNetworkPeeringInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetNetworkPeeringResult> getNetworkPeering(GetNetworkPeeringArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
function: google-native:vmwareengine/v1:getNetworkPeering
arguments:
# arguments dictionary
The following arguments are supported:
- Network
Peering stringId - Project string
- Network
Peering stringId - Project string
- network
Peering StringId - project String
- network
Peering stringId - project string
- network_
peering_ strid - project str
- network
Peering StringId - project String
getNetworkPeering Result
The following output properties are available:
- Create
Time string - Creation time of this resource.
- Description string
- Optional. User-provided description for this network peering.
- Exchange
Subnet boolRoutes - Optional. True if full mesh connectivity is created and managed automatically between peered networks; false otherwise. Currently this field is always true because Google Compute Engine automatically creates and manages subnetwork routes between two VPC networks when peering state is 'ACTIVE'.
- Export
Custom boolRoutes - Optional. True if custom routes are exported to the peered network; false otherwise. The default value is true.
- Export
Custom boolRoutes With Public Ip - Optional. True if all subnet routes with a public IP address range are exported; false otherwise. The default value is true. IPv4 special-use ranges (https://en.wikipedia.org/wiki/IPv4#Special_addresses) are always exported to peers and are not controlled by this field.
- Import
Custom boolRoutes - Optional. True if custom routes are imported from the peered network; false otherwise. The default value is true.
- Import
Custom boolRoutes With Public Ip - Optional. True if all subnet routes with public IP address range are imported; false otherwise. The default value is true. IPv4 special-use ranges (https://en.wikipedia.org/wiki/IPv4#Special_addresses) are always imported to peers and are not controlled by this field.
- Name string
- The resource name of the network peering. Resource names are scheme-less URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example:
projects/my-project/locations/global/networkPeerings/my-peering
- Peer
Mtu int - Optional. Maximum transmission unit (MTU) in bytes. The default value is
1500
. If a value of0
is provided for this field, VMware Engine uses the default value instead. - Peer
Network string - The relative resource name of the network to peer with a standard VMware Engine network. The provided network can be a consumer VPC network or another standard VMware Engine network. If the
peer_network_type
is VMWARE_ENGINE_NETWORK, specify the name in the form:projects/{project}/locations/global/vmwareEngineNetworks/{vmware_engine_network_id}
. Otherwise specify the name in the form:projects/{project}/global/networks/{network_id}
, where{project}
can either be a project number or a project ID. - Peer
Network stringType - The type of the network to peer with the VMware Engine network.
- State string
- State of the network peering. This field has a value of 'ACTIVE' when there's a matching configuration in the peer network. New values may be added to this enum when appropriate.
- State
Details string - Output Only. Details about the current state of the network peering.
- Uid string
- System-generated unique identifier for the resource.
- Update
Time string - Last update time of this resource.
- Vmware
Engine stringNetwork - The relative resource name of the VMware Engine network. Specify the name in the following form:
projects/{project}/locations/{location}/vmwareEngineNetworks/{vmware_engine_network_id}
where{project}
can either be a project number or a project ID.
- Create
Time string - Creation time of this resource.
- Description string
- Optional. User-provided description for this network peering.
- Exchange
Subnet boolRoutes - Optional. True if full mesh connectivity is created and managed automatically between peered networks; false otherwise. Currently this field is always true because Google Compute Engine automatically creates and manages subnetwork routes between two VPC networks when peering state is 'ACTIVE'.
- Export
Custom boolRoutes - Optional. True if custom routes are exported to the peered network; false otherwise. The default value is true.
- Export
Custom boolRoutes With Public Ip - Optional. True if all subnet routes with a public IP address range are exported; false otherwise. The default value is true. IPv4 special-use ranges (https://en.wikipedia.org/wiki/IPv4#Special_addresses) are always exported to peers and are not controlled by this field.
- Import
Custom boolRoutes - Optional. True if custom routes are imported from the peered network; false otherwise. The default value is true.
- Import
Custom boolRoutes With Public Ip - Optional. True if all subnet routes with public IP address range are imported; false otherwise. The default value is true. IPv4 special-use ranges (https://en.wikipedia.org/wiki/IPv4#Special_addresses) are always imported to peers and are not controlled by this field.
- Name string
- The resource name of the network peering. Resource names are scheme-less URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example:
projects/my-project/locations/global/networkPeerings/my-peering
- Peer
Mtu int - Optional. Maximum transmission unit (MTU) in bytes. The default value is
1500
. If a value of0
is provided for this field, VMware Engine uses the default value instead. - Peer
Network string - The relative resource name of the network to peer with a standard VMware Engine network. The provided network can be a consumer VPC network or another standard VMware Engine network. If the
peer_network_type
is VMWARE_ENGINE_NETWORK, specify the name in the form:projects/{project}/locations/global/vmwareEngineNetworks/{vmware_engine_network_id}
. Otherwise specify the name in the form:projects/{project}/global/networks/{network_id}
, where{project}
can either be a project number or a project ID. - Peer
Network stringType - The type of the network to peer with the VMware Engine network.
- State string
- State of the network peering. This field has a value of 'ACTIVE' when there's a matching configuration in the peer network. New values may be added to this enum when appropriate.
- State
Details string - Output Only. Details about the current state of the network peering.
- Uid string
- System-generated unique identifier for the resource.
- Update
Time string - Last update time of this resource.
- Vmware
Engine stringNetwork - The relative resource name of the VMware Engine network. Specify the name in the following form:
projects/{project}/locations/{location}/vmwareEngineNetworks/{vmware_engine_network_id}
where{project}
can either be a project number or a project ID.
- create
Time String - Creation time of this resource.
- description String
- Optional. User-provided description for this network peering.
- exchange
Subnet BooleanRoutes - Optional. True if full mesh connectivity is created and managed automatically between peered networks; false otherwise. Currently this field is always true because Google Compute Engine automatically creates and manages subnetwork routes between two VPC networks when peering state is 'ACTIVE'.
- export
Custom BooleanRoutes - Optional. True if custom routes are exported to the peered network; false otherwise. The default value is true.
- export
Custom BooleanRoutes With Public Ip - Optional. True if all subnet routes with a public IP address range are exported; false otherwise. The default value is true. IPv4 special-use ranges (https://en.wikipedia.org/wiki/IPv4#Special_addresses) are always exported to peers and are not controlled by this field.
- import
Custom BooleanRoutes - Optional. True if custom routes are imported from the peered network; false otherwise. The default value is true.
- import
Custom BooleanRoutes With Public Ip - Optional. True if all subnet routes with public IP address range are imported; false otherwise. The default value is true. IPv4 special-use ranges (https://en.wikipedia.org/wiki/IPv4#Special_addresses) are always imported to peers and are not controlled by this field.
- name String
- The resource name of the network peering. Resource names are scheme-less URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example:
projects/my-project/locations/global/networkPeerings/my-peering
- peer
Mtu Integer - Optional. Maximum transmission unit (MTU) in bytes. The default value is
1500
. If a value of0
is provided for this field, VMware Engine uses the default value instead. - peer
Network String - The relative resource name of the network to peer with a standard VMware Engine network. The provided network can be a consumer VPC network or another standard VMware Engine network. If the
peer_network_type
is VMWARE_ENGINE_NETWORK, specify the name in the form:projects/{project}/locations/global/vmwareEngineNetworks/{vmware_engine_network_id}
. Otherwise specify the name in the form:projects/{project}/global/networks/{network_id}
, where{project}
can either be a project number or a project ID. - peer
Network StringType - The type of the network to peer with the VMware Engine network.
- state String
- State of the network peering. This field has a value of 'ACTIVE' when there's a matching configuration in the peer network. New values may be added to this enum when appropriate.
- state
Details String - Output Only. Details about the current state of the network peering.
- uid String
- System-generated unique identifier for the resource.
- update
Time String - Last update time of this resource.
- vmware
Engine StringNetwork - The relative resource name of the VMware Engine network. Specify the name in the following form:
projects/{project}/locations/{location}/vmwareEngineNetworks/{vmware_engine_network_id}
where{project}
can either be a project number or a project ID.
- create
Time string - Creation time of this resource.
- description string
- Optional. User-provided description for this network peering.
- exchange
Subnet booleanRoutes - Optional. True if full mesh connectivity is created and managed automatically between peered networks; false otherwise. Currently this field is always true because Google Compute Engine automatically creates and manages subnetwork routes between two VPC networks when peering state is 'ACTIVE'.
- export
Custom booleanRoutes - Optional. True if custom routes are exported to the peered network; false otherwise. The default value is true.
- export
Custom booleanRoutes With Public Ip - Optional. True if all subnet routes with a public IP address range are exported; false otherwise. The default value is true. IPv4 special-use ranges (https://en.wikipedia.org/wiki/IPv4#Special_addresses) are always exported to peers and are not controlled by this field.
- import
Custom booleanRoutes - Optional. True if custom routes are imported from the peered network; false otherwise. The default value is true.
- import
Custom booleanRoutes With Public Ip - Optional. True if all subnet routes with public IP address range are imported; false otherwise. The default value is true. IPv4 special-use ranges (https://en.wikipedia.org/wiki/IPv4#Special_addresses) are always imported to peers and are not controlled by this field.
- name string
- The resource name of the network peering. Resource names are scheme-less URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example:
projects/my-project/locations/global/networkPeerings/my-peering
- peer
Mtu number - Optional. Maximum transmission unit (MTU) in bytes. The default value is
1500
. If a value of0
is provided for this field, VMware Engine uses the default value instead. - peer
Network string - The relative resource name of the network to peer with a standard VMware Engine network. The provided network can be a consumer VPC network or another standard VMware Engine network. If the
peer_network_type
is VMWARE_ENGINE_NETWORK, specify the name in the form:projects/{project}/locations/global/vmwareEngineNetworks/{vmware_engine_network_id}
. Otherwise specify the name in the form:projects/{project}/global/networks/{network_id}
, where{project}
can either be a project number or a project ID. - peer
Network stringType - The type of the network to peer with the VMware Engine network.
- state string
- State of the network peering. This field has a value of 'ACTIVE' when there's a matching configuration in the peer network. New values may be added to this enum when appropriate.
- state
Details string - Output Only. Details about the current state of the network peering.
- uid string
- System-generated unique identifier for the resource.
- update
Time string - Last update time of this resource.
- vmware
Engine stringNetwork - The relative resource name of the VMware Engine network. Specify the name in the following form:
projects/{project}/locations/{location}/vmwareEngineNetworks/{vmware_engine_network_id}
where{project}
can either be a project number or a project ID.
- create_
time str - Creation time of this resource.
- description str
- Optional. User-provided description for this network peering.
- exchange_
subnet_ boolroutes - Optional. True if full mesh connectivity is created and managed automatically between peered networks; false otherwise. Currently this field is always true because Google Compute Engine automatically creates and manages subnetwork routes between two VPC networks when peering state is 'ACTIVE'.
- export_
custom_ boolroutes - Optional. True if custom routes are exported to the peered network; false otherwise. The default value is true.
- export_
custom_ boolroutes_ with_ public_ ip - Optional. True if all subnet routes with a public IP address range are exported; false otherwise. The default value is true. IPv4 special-use ranges (https://en.wikipedia.org/wiki/IPv4#Special_addresses) are always exported to peers and are not controlled by this field.
- import_
custom_ boolroutes - Optional. True if custom routes are imported from the peered network; false otherwise. The default value is true.
- import_
custom_ boolroutes_ with_ public_ ip - Optional. True if all subnet routes with public IP address range are imported; false otherwise. The default value is true. IPv4 special-use ranges (https://en.wikipedia.org/wiki/IPv4#Special_addresses) are always imported to peers and are not controlled by this field.
- name str
- The resource name of the network peering. Resource names are scheme-less URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example:
projects/my-project/locations/global/networkPeerings/my-peering
- peer_
mtu int - Optional. Maximum transmission unit (MTU) in bytes. The default value is
1500
. If a value of0
is provided for this field, VMware Engine uses the default value instead. - peer_
network str - The relative resource name of the network to peer with a standard VMware Engine network. The provided network can be a consumer VPC network or another standard VMware Engine network. If the
peer_network_type
is VMWARE_ENGINE_NETWORK, specify the name in the form:projects/{project}/locations/global/vmwareEngineNetworks/{vmware_engine_network_id}
. Otherwise specify the name in the form:projects/{project}/global/networks/{network_id}
, where{project}
can either be a project number or a project ID. - peer_
network_ strtype - The type of the network to peer with the VMware Engine network.
- state str
- State of the network peering. This field has a value of 'ACTIVE' when there's a matching configuration in the peer network. New values may be added to this enum when appropriate.
- state_
details str - Output Only. Details about the current state of the network peering.
- uid str
- System-generated unique identifier for the resource.
- update_
time str - Last update time of this resource.
- vmware_
engine_ strnetwork - The relative resource name of the VMware Engine network. Specify the name in the following form:
projects/{project}/locations/{location}/vmwareEngineNetworks/{vmware_engine_network_id}
where{project}
can either be a project number or a project ID.
- create
Time String - Creation time of this resource.
- description String
- Optional. User-provided description for this network peering.
- exchange
Subnet BooleanRoutes - Optional. True if full mesh connectivity is created and managed automatically between peered networks; false otherwise. Currently this field is always true because Google Compute Engine automatically creates and manages subnetwork routes between two VPC networks when peering state is 'ACTIVE'.
- export
Custom BooleanRoutes - Optional. True if custom routes are exported to the peered network; false otherwise. The default value is true.
- export
Custom BooleanRoutes With Public Ip - Optional. True if all subnet routes with a public IP address range are exported; false otherwise. The default value is true. IPv4 special-use ranges (https://en.wikipedia.org/wiki/IPv4#Special_addresses) are always exported to peers and are not controlled by this field.
- import
Custom BooleanRoutes - Optional. True if custom routes are imported from the peered network; false otherwise. The default value is true.
- import
Custom BooleanRoutes With Public Ip - Optional. True if all subnet routes with public IP address range are imported; false otherwise. The default value is true. IPv4 special-use ranges (https://en.wikipedia.org/wiki/IPv4#Special_addresses) are always imported to peers and are not controlled by this field.
- name String
- The resource name of the network peering. Resource names are scheme-less URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example:
projects/my-project/locations/global/networkPeerings/my-peering
- peer
Mtu Number - Optional. Maximum transmission unit (MTU) in bytes. The default value is
1500
. If a value of0
is provided for this field, VMware Engine uses the default value instead. - peer
Network String - The relative resource name of the network to peer with a standard VMware Engine network. The provided network can be a consumer VPC network or another standard VMware Engine network. If the
peer_network_type
is VMWARE_ENGINE_NETWORK, specify the name in the form:projects/{project}/locations/global/vmwareEngineNetworks/{vmware_engine_network_id}
. Otherwise specify the name in the form:projects/{project}/global/networks/{network_id}
, where{project}
can either be a project number or a project ID. - peer
Network StringType - The type of the network to peer with the VMware Engine network.
- state String
- State of the network peering. This field has a value of 'ACTIVE' when there's a matching configuration in the peer network. New values may be added to this enum when appropriate.
- state
Details String - Output Only. Details about the current state of the network peering.
- uid String
- System-generated unique identifier for the resource.
- update
Time String - Last update time of this resource.
- vmware
Engine StringNetwork - The relative resource name of the VMware Engine network. Specify the name in the following form:
projects/{project}/locations/{location}/vmwareEngineNetworks/{vmware_engine_network_id}
where{project}
can either be a project number or a project ID.
Package Details
- Repository
- Google Cloud Native pulumi/pulumi-google-native
- License
- Apache-2.0
Google Cloud Native is in preview. Google Cloud Classic is fully supported.