ibm 1.83.0-beta0 published on Monday, Sep 15, 2025 by ibm-cloud
ibm.getVmaasTransitGatewayConnection
Explore with Pulumi AI
Provides a read-only data source to retrieve information about a vmaas_transit_gateway_connection. You can then reference the fields of the data source in other resources within the same configuration by using interpolation syntax.
Example Usage
Example coming soon!
Example coming soon!
Example coming soon!
Example coming soon!
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ibm.IbmFunctions;
import com.pulumi.ibm.inputs.GetVmaasTransitGatewayConnectionArgs;
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 vmaasTransitGatewayConnection = IbmFunctions.getVmaasTransitGatewayConnection(GetVmaasTransitGatewayConnectionArgs.builder()
.vmaasTransitGatewayConnectionId(ibm_vmaas_transit_gateway_connection.vmaas_transit_gateway_connection_instance().vmaas_transit_gateway_connection_id())
.vdcId("vdc_id")
.edgeId("edge_id")
.region("us-south")
.build());
}
}
variables:
vmaasTransitGatewayConnection:
fn::invoke:
function: ibm:getVmaasTransitGatewayConnection
arguments:
vmaasTransitGatewayConnectionId: ${ibm_vmaas_transit_gateway_connection.vmaas_transit_gateway_connection_instance.vmaas_transit_gateway_connection_id}
vdcId: vdc_id
edgeId: edge_id
region: us-south
Using getVmaasTransitGatewayConnection
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 getVmaasTransitGatewayConnection(args: GetVmaasTransitGatewayConnectionArgs, opts?: InvokeOptions): Promise<GetVmaasTransitGatewayConnectionResult>
function getVmaasTransitGatewayConnectionOutput(args: GetVmaasTransitGatewayConnectionOutputArgs, opts?: InvokeOptions): Output<GetVmaasTransitGatewayConnectionResult>
def get_vmaas_transit_gateway_connection(edge_id: Optional[str] = None,
id: Optional[str] = None,
vdc_id: Optional[str] = None,
vmaas_transit_gateway_connection_id: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetVmaasTransitGatewayConnectionResult
def get_vmaas_transit_gateway_connection_output(edge_id: Optional[pulumi.Input[str]] = None,
id: Optional[pulumi.Input[str]] = None,
vdc_id: Optional[pulumi.Input[str]] = None,
vmaas_transit_gateway_connection_id: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetVmaasTransitGatewayConnectionResult]
func LookupVmaasTransitGatewayConnection(ctx *Context, args *LookupVmaasTransitGatewayConnectionArgs, opts ...InvokeOption) (*LookupVmaasTransitGatewayConnectionResult, error)
func LookupVmaasTransitGatewayConnectionOutput(ctx *Context, args *LookupVmaasTransitGatewayConnectionOutputArgs, opts ...InvokeOption) LookupVmaasTransitGatewayConnectionResultOutput
> Note: This function is named LookupVmaasTransitGatewayConnection
in the Go SDK.
public static class GetVmaasTransitGatewayConnection
{
public static Task<GetVmaasTransitGatewayConnectionResult> InvokeAsync(GetVmaasTransitGatewayConnectionArgs args, InvokeOptions? opts = null)
public static Output<GetVmaasTransitGatewayConnectionResult> Invoke(GetVmaasTransitGatewayConnectionInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetVmaasTransitGatewayConnectionResult> getVmaasTransitGatewayConnection(GetVmaasTransitGatewayConnectionArgs args, InvokeOptions options)
public static Output<GetVmaasTransitGatewayConnectionResult> getVmaasTransitGatewayConnection(GetVmaasTransitGatewayConnectionArgs args, InvokeOptions options)
fn::invoke:
function: ibm:index/getVmaasTransitGatewayConnection:getVmaasTransitGatewayConnection
arguments:
# arguments dictionary
The following arguments are supported:
- Edge
Id string - A unique ID for an edge.
- Constraints: The maximum length is
128
characters. The minimum length is1
character. The value must match regular expression/^[A-Za-z0-9_-]{1,128}$/
.
- Constraints: The maximum length is
- Vdc
Id string - A unique ID for a virtual data center.
- Constraints: The maximum length is
128
characters. The minimum length is1
character. The value must match regular expression/^[A-Za-z0-9_-]{1,128}$/
.
- Constraints: The maximum length is
- Vmaas
Transit stringGateway Connection Id - A unique ID for a specified virtual data center.
- Constraints: The maximum length is
128
characters. The minimum length is1
character. The value must match regular expression/^[A-Za-z0-9_-]{1,128}$/
.
- Constraints: The maximum length is
- Id string
- The unique identifier of the vmaas_transit_gateway_connection.
- Edge
Id string - A unique ID for an edge.
- Constraints: The maximum length is
128
characters. The minimum length is1
character. The value must match regular expression/^[A-Za-z0-9_-]{1,128}$/
.
- Constraints: The maximum length is
- Vdc
Id string - A unique ID for a virtual data center.
- Constraints: The maximum length is
128
characters. The minimum length is1
character. The value must match regular expression/^[A-Za-z0-9_-]{1,128}$/
.
- Constraints: The maximum length is
- Vmaas
Transit stringGateway Connection Id - A unique ID for a specified virtual data center.
- Constraints: The maximum length is
128
characters. The minimum length is1
character. The value must match regular expression/^[A-Za-z0-9_-]{1,128}$/
.
- Constraints: The maximum length is
- Id string
- The unique identifier of the vmaas_transit_gateway_connection.
- edge
Id String - A unique ID for an edge.
- Constraints: The maximum length is
128
characters. The minimum length is1
character. The value must match regular expression/^[A-Za-z0-9_-]{1,128}$/
.
- Constraints: The maximum length is
- vdc
Id String - A unique ID for a virtual data center.
- Constraints: The maximum length is
128
characters. The minimum length is1
character. The value must match regular expression/^[A-Za-z0-9_-]{1,128}$/
.
- Constraints: The maximum length is
- vmaas
Transit StringGateway Connection Id - A unique ID for a specified virtual data center.
- Constraints: The maximum length is
128
characters. The minimum length is1
character. The value must match regular expression/^[A-Za-z0-9_-]{1,128}$/
.
- Constraints: The maximum length is
- id String
- The unique identifier of the vmaas_transit_gateway_connection.
- edge
Id string - A unique ID for an edge.
- Constraints: The maximum length is
128
characters. The minimum length is1
character. The value must match regular expression/^[A-Za-z0-9_-]{1,128}$/
.
- Constraints: The maximum length is
- vdc
Id string - A unique ID for a virtual data center.
- Constraints: The maximum length is
128
characters. The minimum length is1
character. The value must match regular expression/^[A-Za-z0-9_-]{1,128}$/
.
- Constraints: The maximum length is
- vmaas
Transit stringGateway Connection Id - A unique ID for a specified virtual data center.
- Constraints: The maximum length is
128
characters. The minimum length is1
character. The value must match regular expression/^[A-Za-z0-9_-]{1,128}$/
.
- Constraints: The maximum length is
- id string
- The unique identifier of the vmaas_transit_gateway_connection.
- edge_
id str - A unique ID for an edge.
- Constraints: The maximum length is
128
characters. The minimum length is1
character. The value must match regular expression/^[A-Za-z0-9_-]{1,128}$/
.
- Constraints: The maximum length is
- vdc_
id str - A unique ID for a virtual data center.
- Constraints: The maximum length is
128
characters. The minimum length is1
character. The value must match regular expression/^[A-Za-z0-9_-]{1,128}$/
.
- Constraints: The maximum length is
- vmaas_
transit_ strgateway_ connection_ id - A unique ID for a specified virtual data center.
- Constraints: The maximum length is
128
characters. The minimum length is1
character. The value must match regular expression/^[A-Za-z0-9_-]{1,128}$/
.
- Constraints: The maximum length is
- id str
- The unique identifier of the vmaas_transit_gateway_connection.
- edge
Id String - A unique ID for an edge.
- Constraints: The maximum length is
128
characters. The minimum length is1
character. The value must match regular expression/^[A-Za-z0-9_-]{1,128}$/
.
- Constraints: The maximum length is
- vdc
Id String - A unique ID for a virtual data center.
- Constraints: The maximum length is
128
characters. The minimum length is1
character. The value must match regular expression/^[A-Za-z0-9_-]{1,128}$/
.
- Constraints: The maximum length is
- vmaas
Transit StringGateway Connection Id - A unique ID for a specified virtual data center.
- Constraints: The maximum length is
128
characters. The minimum length is1
character. The value must match regular expression/^[A-Za-z0-9_-]{1,128}$/
.
- Constraints: The maximum length is
- id String
- The unique identifier of the vmaas_transit_gateway_connection.
getVmaasTransitGatewayConnection Result
The following output properties are available:
- Connections
List<Get
Vmaas Transit Gateway Connection Connection> - (List) IBM Transit Gateway connections.
- Constraints: The maximum length is
128
items. The minimum length is1
item. Nested schema for connections:
- Constraints: The maximum length is
- Edge
Id string - Id string
- The unique identifier of the vmaas_transit_gateway_connection.
- Region string
- (String) The region where the IBM Transit Gateway is deployed.
- Status string
- (String) Determines the state of the IBM Transit Gateway based on its connections.
- Constraints: Allowable values are:
pending
,creating
,ready_to_use
,deleting
.
- Constraints: Allowable values are:
- Vdc
Id string - Vmaas
Transit stringGateway Connection Id
- Connections
[]Get
Vmaas Transit Gateway Connection Connection - (List) IBM Transit Gateway connections.
- Constraints: The maximum length is
128
items. The minimum length is1
item. Nested schema for connections:
- Constraints: The maximum length is
- Edge
Id string - Id string
- The unique identifier of the vmaas_transit_gateway_connection.
- Region string
- (String) The region where the IBM Transit Gateway is deployed.
- Status string
- (String) Determines the state of the IBM Transit Gateway based on its connections.
- Constraints: Allowable values are:
pending
,creating
,ready_to_use
,deleting
.
- Constraints: Allowable values are:
- Vdc
Id string - Vmaas
Transit stringGateway Connection Id
- connections
List<Get
Vmaas Transit Gateway Connection Connection> - (List) IBM Transit Gateway connections.
- Constraints: The maximum length is
128
items. The minimum length is1
item. Nested schema for connections:
- Constraints: The maximum length is
- edge
Id String - id String
- The unique identifier of the vmaas_transit_gateway_connection.
- region String
- (String) The region where the IBM Transit Gateway is deployed.
- status String
- (String) Determines the state of the IBM Transit Gateway based on its connections.
- Constraints: Allowable values are:
pending
,creating
,ready_to_use
,deleting
.
- Constraints: Allowable values are:
- vdc
Id String - vmaas
Transit StringGateway Connection Id
- connections
Get
Vmaas Transit Gateway Connection Connection[] - (List) IBM Transit Gateway connections.
- Constraints: The maximum length is
128
items. The minimum length is1
item. Nested schema for connections:
- Constraints: The maximum length is
- edge
Id string - id string
- The unique identifier of the vmaas_transit_gateway_connection.
- region string
- (String) The region where the IBM Transit Gateway is deployed.
- status string
- (String) Determines the state of the IBM Transit Gateway based on its connections.
- Constraints: Allowable values are:
pending
,creating
,ready_to_use
,deleting
.
- Constraints: Allowable values are:
- vdc
Id string - vmaas
Transit stringGateway Connection Id
- connections
Sequence[Get
Vmaas Transit Gateway Connection Connection] - (List) IBM Transit Gateway connections.
- Constraints: The maximum length is
128
items. The minimum length is1
item. Nested schema for connections:
- Constraints: The maximum length is
- edge_
id str - id str
- The unique identifier of the vmaas_transit_gateway_connection.
- region str
- (String) The region where the IBM Transit Gateway is deployed.
- status str
- (String) Determines the state of the IBM Transit Gateway based on its connections.
- Constraints: Allowable values are:
pending
,creating
,ready_to_use
,deleting
.
- Constraints: Allowable values are:
- vdc_
id str - vmaas_
transit_ strgateway_ connection_ id
- connections List<Property Map>
- (List) IBM Transit Gateway connections.
- Constraints: The maximum length is
128
items. The minimum length is1
item. Nested schema for connections:
- Constraints: The maximum length is
- edge
Id String - id String
- The unique identifier of the vmaas_transit_gateway_connection.
- region String
- (String) The region where the IBM Transit Gateway is deployed.
- status String
- (String) Determines the state of the IBM Transit Gateway based on its connections.
- Constraints: Allowable values are:
pending
,creating
,ready_to_use
,deleting
.
- Constraints: Allowable values are:
- vdc
Id String - vmaas
Transit StringGateway Connection Id
Supporting Types
GetVmaasTransitGatewayConnectionConnection
- Base
Network stringType - (String) The type of the network that the unbound GRE tunnel is targeting. Only "classic" is supported.
- Local
Bgp doubleAsn - (Integer) Local network BGP ASN for the connection.
- Constraints: The maximum value is
4294967294
. The minimum value is1
.
- Constraints: The maximum value is
- Local
Gateway stringIp - (String) Local gateway IP address for the connection.
- Local
Tunnel stringIp - (String) Local tunnel IP address for the connection.
- Name string
- (String) The autogenerated name for this connection.
- Network
Account stringId - (String) The ID of the account that owns the connected network.
- Network
Type string - (String) The type of the network that is connected through this connection. Only "unbound_gre_tunnel" is supported.
- Remote
Bgp doubleAsn - (Integer) Remote network BGP ASN for the connection.
- Constraints: The maximum value is
4294967294
. The minimum value is1
.
- Constraints: The maximum value is
- Remote
Gateway stringIp - (String) Remote gateway IP address for the connection.
- Remote
Tunnel stringIp - (String) Remote tunnel IP address for the connection.
- Status string
- (String) Determines the state of the IBM Transit Gateway based on its connections.
- Constraints: Allowable values are:
pending
,creating
,ready_to_use
,deleting
.
- Constraints: Allowable values are:
- Transit
Gateway stringConnection Name - (String) The user-defined name of the connection created on the IBM Transit Gateway.
- Zone string
- (String) The location of the connection.
- Base
Network stringType - (String) The type of the network that the unbound GRE tunnel is targeting. Only "classic" is supported.
- Local
Bgp float64Asn - (Integer) Local network BGP ASN for the connection.
- Constraints: The maximum value is
4294967294
. The minimum value is1
.
- Constraints: The maximum value is
- Local
Gateway stringIp - (String) Local gateway IP address for the connection.
- Local
Tunnel stringIp - (String) Local tunnel IP address for the connection.
- Name string
- (String) The autogenerated name for this connection.
- Network
Account stringId - (String) The ID of the account that owns the connected network.
- Network
Type string - (String) The type of the network that is connected through this connection. Only "unbound_gre_tunnel" is supported.
- Remote
Bgp float64Asn - (Integer) Remote network BGP ASN for the connection.
- Constraints: The maximum value is
4294967294
. The minimum value is1
.
- Constraints: The maximum value is
- Remote
Gateway stringIp - (String) Remote gateway IP address for the connection.
- Remote
Tunnel stringIp - (String) Remote tunnel IP address for the connection.
- Status string
- (String) Determines the state of the IBM Transit Gateway based on its connections.
- Constraints: Allowable values are:
pending
,creating
,ready_to_use
,deleting
.
- Constraints: Allowable values are:
- Transit
Gateway stringConnection Name - (String) The user-defined name of the connection created on the IBM Transit Gateway.
- Zone string
- (String) The location of the connection.
- base
Network StringType - (String) The type of the network that the unbound GRE tunnel is targeting. Only "classic" is supported.
- local
Bgp DoubleAsn - (Integer) Local network BGP ASN for the connection.
- Constraints: The maximum value is
4294967294
. The minimum value is1
.
- Constraints: The maximum value is
- local
Gateway StringIp - (String) Local gateway IP address for the connection.
- local
Tunnel StringIp - (String) Local tunnel IP address for the connection.
- name String
- (String) The autogenerated name for this connection.
- network
Account StringId - (String) The ID of the account that owns the connected network.
- network
Type String - (String) The type of the network that is connected through this connection. Only "unbound_gre_tunnel" is supported.
- remote
Bgp DoubleAsn - (Integer) Remote network BGP ASN for the connection.
- Constraints: The maximum value is
4294967294
. The minimum value is1
.
- Constraints: The maximum value is
- remote
Gateway StringIp - (String) Remote gateway IP address for the connection.
- remote
Tunnel StringIp - (String) Remote tunnel IP address for the connection.
- status String
- (String) Determines the state of the IBM Transit Gateway based on its connections.
- Constraints: Allowable values are:
pending
,creating
,ready_to_use
,deleting
.
- Constraints: Allowable values are:
- transit
Gateway StringConnection Name - (String) The user-defined name of the connection created on the IBM Transit Gateway.
- zone String
- (String) The location of the connection.
- base
Network stringType - (String) The type of the network that the unbound GRE tunnel is targeting. Only "classic" is supported.
- local
Bgp numberAsn - (Integer) Local network BGP ASN for the connection.
- Constraints: The maximum value is
4294967294
. The minimum value is1
.
- Constraints: The maximum value is
- local
Gateway stringIp - (String) Local gateway IP address for the connection.
- local
Tunnel stringIp - (String) Local tunnel IP address for the connection.
- name string
- (String) The autogenerated name for this connection.
- network
Account stringId - (String) The ID of the account that owns the connected network.
- network
Type string - (String) The type of the network that is connected through this connection. Only "unbound_gre_tunnel" is supported.
- remote
Bgp numberAsn - (Integer) Remote network BGP ASN for the connection.
- Constraints: The maximum value is
4294967294
. The minimum value is1
.
- Constraints: The maximum value is
- remote
Gateway stringIp - (String) Remote gateway IP address for the connection.
- remote
Tunnel stringIp - (String) Remote tunnel IP address for the connection.
- status string
- (String) Determines the state of the IBM Transit Gateway based on its connections.
- Constraints: Allowable values are:
pending
,creating
,ready_to_use
,deleting
.
- Constraints: Allowable values are:
- transit
Gateway stringConnection Name - (String) The user-defined name of the connection created on the IBM Transit Gateway.
- zone string
- (String) The location of the connection.
- base_
network_ strtype - (String) The type of the network that the unbound GRE tunnel is targeting. Only "classic" is supported.
- local_
bgp_ floatasn - (Integer) Local network BGP ASN for the connection.
- Constraints: The maximum value is
4294967294
. The minimum value is1
.
- Constraints: The maximum value is
- local_
gateway_ strip - (String) Local gateway IP address for the connection.
- local_
tunnel_ strip - (String) Local tunnel IP address for the connection.
- name str
- (String) The autogenerated name for this connection.
- network_
account_ strid - (String) The ID of the account that owns the connected network.
- network_
type str - (String) The type of the network that is connected through this connection. Only "unbound_gre_tunnel" is supported.
- remote_
bgp_ floatasn - (Integer) Remote network BGP ASN for the connection.
- Constraints: The maximum value is
4294967294
. The minimum value is1
.
- Constraints: The maximum value is
- remote_
gateway_ strip - (String) Remote gateway IP address for the connection.
- remote_
tunnel_ strip - (String) Remote tunnel IP address for the connection.
- status str
- (String) Determines the state of the IBM Transit Gateway based on its connections.
- Constraints: Allowable values are:
pending
,creating
,ready_to_use
,deleting
.
- Constraints: Allowable values are:
- transit_
gateway_ strconnection_ name - (String) The user-defined name of the connection created on the IBM Transit Gateway.
- zone str
- (String) The location of the connection.
- base
Network StringType - (String) The type of the network that the unbound GRE tunnel is targeting. Only "classic" is supported.
- local
Bgp NumberAsn - (Integer) Local network BGP ASN for the connection.
- Constraints: The maximum value is
4294967294
. The minimum value is1
.
- Constraints: The maximum value is
- local
Gateway StringIp - (String) Local gateway IP address for the connection.
- local
Tunnel StringIp - (String) Local tunnel IP address for the connection.
- name String
- (String) The autogenerated name for this connection.
- network
Account StringId - (String) The ID of the account that owns the connected network.
- network
Type String - (String) The type of the network that is connected through this connection. Only "unbound_gre_tunnel" is supported.
- remote
Bgp NumberAsn - (Integer) Remote network BGP ASN for the connection.
- Constraints: The maximum value is
4294967294
. The minimum value is1
.
- Constraints: The maximum value is
- remote
Gateway StringIp - (String) Remote gateway IP address for the connection.
- remote
Tunnel StringIp - (String) Remote tunnel IP address for the connection.
- status String
- (String) Determines the state of the IBM Transit Gateway based on its connections.
- Constraints: Allowable values are:
pending
,creating
,ready_to_use
,deleting
.
- Constraints: Allowable values are:
- transit
Gateway StringConnection Name - (String) The user-defined name of the connection created on the IBM Transit Gateway.
- zone String
- (String) The location of the connection.
Package Details
- Repository
- ibm ibm-cloud/terraform-provider-ibm
- License
- Notes
- This Pulumi package is based on the
ibm
Terraform Provider.