MongoDB Atlas v3.30.0 published on Friday, Mar 21, 2025 by Pulumi
mongodbatlas.getNetworkPeerings
Explore with Pulumi AI
# Data Source: mongodbatlas.getNetworkPeerings
mongodbatlas.getNetworkPeerings describes all Network Peering Connections.
NOTE: Groups and projects are synonymous terms. You may find group_id in the official documentation.
Example Usage
Basic Example (AWS).
import * as pulumi from "@pulumi/pulumi";
import * as mongodbatlas from "@pulumi/mongodbatlas";
const testNetworkPeering = new mongodbatlas.NetworkPeering("test", {
    accepterRegionName: "us-east-1",
    projectId: "<YOUR-PROJEC-ID>",
    containerId: "507f1f77bcf86cd799439011",
    providerName: "AWS",
    routeTableCidrBlock: "192.168.0.0/24",
    vpcId: "vpc-abc123abc123",
    awsAccountId: "abc123abc123",
});
const test = mongodbatlas.getNetworkPeeringsOutput({
    projectId: testNetworkPeering.projectId,
});
import pulumi
import pulumi_mongodbatlas as mongodbatlas
test_network_peering = mongodbatlas.NetworkPeering("test",
    accepter_region_name="us-east-1",
    project_id="<YOUR-PROJEC-ID>",
    container_id="507f1f77bcf86cd799439011",
    provider_name="AWS",
    route_table_cidr_block="192.168.0.0/24",
    vpc_id="vpc-abc123abc123",
    aws_account_id="abc123abc123")
test = mongodbatlas.get_network_peerings_output(project_id=test_network_peering.project_id)
package main
import (
	"github.com/pulumi/pulumi-mongodbatlas/sdk/v3/go/mongodbatlas"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		testNetworkPeering, err := mongodbatlas.NewNetworkPeering(ctx, "test", &mongodbatlas.NetworkPeeringArgs{
			AccepterRegionName:  pulumi.String("us-east-1"),
			ProjectId:           pulumi.String("<YOUR-PROJEC-ID>"),
			ContainerId:         pulumi.String("507f1f77bcf86cd799439011"),
			ProviderName:        pulumi.String("AWS"),
			RouteTableCidrBlock: pulumi.String("192.168.0.0/24"),
			VpcId:               pulumi.String("vpc-abc123abc123"),
			AwsAccountId:        pulumi.String("abc123abc123"),
		})
		if err != nil {
			return err
		}
		_ = mongodbatlas.LookupNetworkPeeringsOutput(ctx, mongodbatlas.GetNetworkPeeringsOutputArgs{
			ProjectId: testNetworkPeering.ProjectId,
		}, nil)
		return nil
	})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Mongodbatlas = Pulumi.Mongodbatlas;
return await Deployment.RunAsync(() => 
{
    var testNetworkPeering = new Mongodbatlas.NetworkPeering("test", new()
    {
        AccepterRegionName = "us-east-1",
        ProjectId = "<YOUR-PROJEC-ID>",
        ContainerId = "507f1f77bcf86cd799439011",
        ProviderName = "AWS",
        RouteTableCidrBlock = "192.168.0.0/24",
        VpcId = "vpc-abc123abc123",
        AwsAccountId = "abc123abc123",
    });
    var test = Mongodbatlas.GetNetworkPeerings.Invoke(new()
    {
        ProjectId = testNetworkPeering.ProjectId,
    });
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.mongodbatlas.NetworkPeering;
import com.pulumi.mongodbatlas.NetworkPeeringArgs;
import com.pulumi.mongodbatlas.MongodbatlasFunctions;
import com.pulumi.mongodbatlas.inputs.GetNetworkPeeringsArgs;
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) {
        var testNetworkPeering = new NetworkPeering("testNetworkPeering", NetworkPeeringArgs.builder()
            .accepterRegionName("us-east-1")
            .projectId("<YOUR-PROJEC-ID>")
            .containerId("507f1f77bcf86cd799439011")
            .providerName("AWS")
            .routeTableCidrBlock("192.168.0.0/24")
            .vpcId("vpc-abc123abc123")
            .awsAccountId("abc123abc123")
            .build());
        final var test = MongodbatlasFunctions.getNetworkPeerings(GetNetworkPeeringsArgs.builder()
            .projectId(testNetworkPeering.projectId())
            .build());
    }
}
resources:
  testNetworkPeering:
    type: mongodbatlas:NetworkPeering
    name: test
    properties:
      accepterRegionName: us-east-1
      projectId: <YOUR-PROJEC-ID>
      containerId: 507f1f77bcf86cd799439011
      providerName: AWS
      routeTableCidrBlock: 192.168.0.0/24
      vpcId: vpc-abc123abc123
      awsAccountId: abc123abc123
variables:
  test:
    fn::invoke:
      function: mongodbatlas:getNetworkPeerings
      arguments:
        projectId: ${testNetworkPeering.projectId}
Using getNetworkPeerings
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 getNetworkPeerings(args: GetNetworkPeeringsArgs, opts?: InvokeOptions): Promise<GetNetworkPeeringsResult>
function getNetworkPeeringsOutput(args: GetNetworkPeeringsOutputArgs, opts?: InvokeOptions): Output<GetNetworkPeeringsResult>def get_network_peerings(project_id: Optional[str] = None,
                         opts: Optional[InvokeOptions] = None) -> GetNetworkPeeringsResult
def get_network_peerings_output(project_id: Optional[pulumi.Input[str]] = None,
                         opts: Optional[InvokeOptions] = None) -> Output[GetNetworkPeeringsResult]func LookupNetworkPeerings(ctx *Context, args *LookupNetworkPeeringsArgs, opts ...InvokeOption) (*LookupNetworkPeeringsResult, error)
func LookupNetworkPeeringsOutput(ctx *Context, args *LookupNetworkPeeringsOutputArgs, opts ...InvokeOption) LookupNetworkPeeringsResultOutput> Note: This function is named LookupNetworkPeerings in the Go SDK.
public static class GetNetworkPeerings 
{
    public static Task<GetNetworkPeeringsResult> InvokeAsync(GetNetworkPeeringsArgs args, InvokeOptions? opts = null)
    public static Output<GetNetworkPeeringsResult> Invoke(GetNetworkPeeringsInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetNetworkPeeringsResult> getNetworkPeerings(GetNetworkPeeringsArgs args, InvokeOptions options)
public static Output<GetNetworkPeeringsResult> getNetworkPeerings(GetNetworkPeeringsArgs args, InvokeOptions options)
fn::invoke:
  function: mongodbatlas:index/getNetworkPeerings:getNetworkPeerings
  arguments:
    # arguments dictionaryThe following arguments are supported:
- ProjectId string
- The unique ID for the project.
- ProjectId string
- The unique ID for the project.
- projectId String
- The unique ID for the project.
- projectId string
- The unique ID for the project.
- project_id str
- The unique ID for the project.
- projectId String
- The unique ID for the project.
getNetworkPeerings Result
The following output properties are available:
- Id string
- The provider-assigned unique ID for this managed resource.
- ProjectId string
- Results
List<GetNetwork Peerings Result> 
- A list where each represents a Network Peering Connection.
- Id string
- The provider-assigned unique ID for this managed resource.
- ProjectId string
- Results
[]GetNetwork Peerings Result 
- A list where each represents a Network Peering Connection.
- id String
- The provider-assigned unique ID for this managed resource.
- projectId String
- results
List<GetNetwork Peerings Result> 
- A list where each represents a Network Peering Connection.
- id string
- The provider-assigned unique ID for this managed resource.
- projectId string
- results
GetNetwork Peerings Result[] 
- A list where each represents a Network Peering Connection.
- id str
- The provider-assigned unique ID for this managed resource.
- project_id str
- results
Sequence[GetNetwork Peerings Result] 
- A list where each represents a Network Peering Connection.
- id String
- The provider-assigned unique ID for this managed resource.
- projectId String
- results List<Property Map>
- A list where each represents a Network Peering Connection.
Supporting Types
GetNetworkPeeringsResult   
- AccepterRegion stringName 
- Specifies the region where the peer VPC resides. For complete lists of supported regions, see Amazon Web Services.
- AtlasCidr stringBlock 
- AwsAccount stringId 
- Account ID of the owner of the peer VPC.
- AzureDirectory stringId 
- Unique identifier for an Azure AD directory.
- AzureSubscription stringId 
- Unique identifer of the Azure subscription in which the VNet resides.
- ConnectionId string
- Unique identifier for the peering connection.
- ContainerId string
- ErrorMessage string
- When "status" : "FAILED", Atlas provides a description of the error.
- ErrorState string
- Description of the Atlas error when statusisFailed, Otherwise, Atlas returnsnull.
- ErrorState stringName 
- Error state, if any. The VPC peering connection error state value can be one of the following: REJECTED,EXPIRED,INVALID_ARGUMENT.
- GcpProject stringId 
- GCP project ID of the owner of the network peer.
- NetworkName string
- Name of the network peer to which Atlas connects.
- PeeringId string
- Atlas assigned unique ID for the peering connection.
- ProviderName string
- Cloud provider for this VPC peering connection. If omitted, Atlas sets this parameter to AWS. (Possible Values AWS,AZURE,GCP).
- ResourceGroup stringName 
- Name of your Azure resource group.
- RouteTable stringCidr Block 
- Peer VPC CIDR block or subnet.
- Status string
- Status of the Atlas network peering connection: ADDING_PEER,AVAILABLE,FAILED,DELETING,WAITING_FOR_USER.
- StatusName string
- The VPC peering connection status value can be one of the following: INITIATING,PENDING_ACCEPTANCE,FAILED,FINALIZING,AVAILABLE,TERMINATING.
- VnetName string
- Name of your Azure VNet.
- VpcId string
- Unique identifier of the peer VPC.
- AccepterRegion stringName 
- Specifies the region where the peer VPC resides. For complete lists of supported regions, see Amazon Web Services.
- AtlasCidr stringBlock 
- AwsAccount stringId 
- Account ID of the owner of the peer VPC.
- AzureDirectory stringId 
- Unique identifier for an Azure AD directory.
- AzureSubscription stringId 
- Unique identifer of the Azure subscription in which the VNet resides.
- ConnectionId string
- Unique identifier for the peering connection.
- ContainerId string
- ErrorMessage string
- When "status" : "FAILED", Atlas provides a description of the error.
- ErrorState string
- Description of the Atlas error when statusisFailed, Otherwise, Atlas returnsnull.
- ErrorState stringName 
- Error state, if any. The VPC peering connection error state value can be one of the following: REJECTED,EXPIRED,INVALID_ARGUMENT.
- GcpProject stringId 
- GCP project ID of the owner of the network peer.
- NetworkName string
- Name of the network peer to which Atlas connects.
- PeeringId string
- Atlas assigned unique ID for the peering connection.
- ProviderName string
- Cloud provider for this VPC peering connection. If omitted, Atlas sets this parameter to AWS. (Possible Values AWS,AZURE,GCP).
- ResourceGroup stringName 
- Name of your Azure resource group.
- RouteTable stringCidr Block 
- Peer VPC CIDR block or subnet.
- Status string
- Status of the Atlas network peering connection: ADDING_PEER,AVAILABLE,FAILED,DELETING,WAITING_FOR_USER.
- StatusName string
- The VPC peering connection status value can be one of the following: INITIATING,PENDING_ACCEPTANCE,FAILED,FINALIZING,AVAILABLE,TERMINATING.
- VnetName string
- Name of your Azure VNet.
- VpcId string
- Unique identifier of the peer VPC.
- accepterRegion StringName 
- Specifies the region where the peer VPC resides. For complete lists of supported regions, see Amazon Web Services.
- atlasCidr StringBlock 
- awsAccount StringId 
- Account ID of the owner of the peer VPC.
- azureDirectory StringId 
- Unique identifier for an Azure AD directory.
- azureSubscription StringId 
- Unique identifer of the Azure subscription in which the VNet resides.
- connectionId String
- Unique identifier for the peering connection.
- containerId String
- errorMessage String
- When "status" : "FAILED", Atlas provides a description of the error.
- errorState String
- Description of the Atlas error when statusisFailed, Otherwise, Atlas returnsnull.
- errorState StringName 
- Error state, if any. The VPC peering connection error state value can be one of the following: REJECTED,EXPIRED,INVALID_ARGUMENT.
- gcpProject StringId 
- GCP project ID of the owner of the network peer.
- networkName String
- Name of the network peer to which Atlas connects.
- peeringId String
- Atlas assigned unique ID for the peering connection.
- providerName String
- Cloud provider for this VPC peering connection. If omitted, Atlas sets this parameter to AWS. (Possible Values AWS,AZURE,GCP).
- resourceGroup StringName 
- Name of your Azure resource group.
- routeTable StringCidr Block 
- Peer VPC CIDR block or subnet.
- status String
- Status of the Atlas network peering connection: ADDING_PEER,AVAILABLE,FAILED,DELETING,WAITING_FOR_USER.
- statusName String
- The VPC peering connection status value can be one of the following: INITIATING,PENDING_ACCEPTANCE,FAILED,FINALIZING,AVAILABLE,TERMINATING.
- vnetName String
- Name of your Azure VNet.
- vpcId String
- Unique identifier of the peer VPC.
- accepterRegion stringName 
- Specifies the region where the peer VPC resides. For complete lists of supported regions, see Amazon Web Services.
- atlasCidr stringBlock 
- awsAccount stringId 
- Account ID of the owner of the peer VPC.
- azureDirectory stringId 
- Unique identifier for an Azure AD directory.
- azureSubscription stringId 
- Unique identifer of the Azure subscription in which the VNet resides.
- connectionId string
- Unique identifier for the peering connection.
- containerId string
- errorMessage string
- When "status" : "FAILED", Atlas provides a description of the error.
- errorState string
- Description of the Atlas error when statusisFailed, Otherwise, Atlas returnsnull.
- errorState stringName 
- Error state, if any. The VPC peering connection error state value can be one of the following: REJECTED,EXPIRED,INVALID_ARGUMENT.
- gcpProject stringId 
- GCP project ID of the owner of the network peer.
- networkName string
- Name of the network peer to which Atlas connects.
- peeringId string
- Atlas assigned unique ID for the peering connection.
- providerName string
- Cloud provider for this VPC peering connection. If omitted, Atlas sets this parameter to AWS. (Possible Values AWS,AZURE,GCP).
- resourceGroup stringName 
- Name of your Azure resource group.
- routeTable stringCidr Block 
- Peer VPC CIDR block or subnet.
- status string
- Status of the Atlas network peering connection: ADDING_PEER,AVAILABLE,FAILED,DELETING,WAITING_FOR_USER.
- statusName string
- The VPC peering connection status value can be one of the following: INITIATING,PENDING_ACCEPTANCE,FAILED,FINALIZING,AVAILABLE,TERMINATING.
- vnetName string
- Name of your Azure VNet.
- vpcId string
- Unique identifier of the peer VPC.
- accepter_region_ strname 
- Specifies the region where the peer VPC resides. For complete lists of supported regions, see Amazon Web Services.
- atlas_cidr_ strblock 
- aws_account_ strid 
- Account ID of the owner of the peer VPC.
- azure_directory_ strid 
- Unique identifier for an Azure AD directory.
- azure_subscription_ strid 
- Unique identifer of the Azure subscription in which the VNet resides.
- connection_id str
- Unique identifier for the peering connection.
- container_id str
- error_message str
- When "status" : "FAILED", Atlas provides a description of the error.
- error_state str
- Description of the Atlas error when statusisFailed, Otherwise, Atlas returnsnull.
- error_state_ strname 
- Error state, if any. The VPC peering connection error state value can be one of the following: REJECTED,EXPIRED,INVALID_ARGUMENT.
- gcp_project_ strid 
- GCP project ID of the owner of the network peer.
- network_name str
- Name of the network peer to which Atlas connects.
- peering_id str
- Atlas assigned unique ID for the peering connection.
- provider_name str
- Cloud provider for this VPC peering connection. If omitted, Atlas sets this parameter to AWS. (Possible Values AWS,AZURE,GCP).
- resource_group_ strname 
- Name of your Azure resource group.
- route_table_ strcidr_ block 
- Peer VPC CIDR block or subnet.
- status str
- Status of the Atlas network peering connection: ADDING_PEER,AVAILABLE,FAILED,DELETING,WAITING_FOR_USER.
- status_name str
- The VPC peering connection status value can be one of the following: INITIATING,PENDING_ACCEPTANCE,FAILED,FINALIZING,AVAILABLE,TERMINATING.
- vnet_name str
- Name of your Azure VNet.
- vpc_id str
- Unique identifier of the peer VPC.
- accepterRegion StringName 
- Specifies the region where the peer VPC resides. For complete lists of supported regions, see Amazon Web Services.
- atlasCidr StringBlock 
- awsAccount StringId 
- Account ID of the owner of the peer VPC.
- azureDirectory StringId 
- Unique identifier for an Azure AD directory.
- azureSubscription StringId 
- Unique identifer of the Azure subscription in which the VNet resides.
- connectionId String
- Unique identifier for the peering connection.
- containerId String
- errorMessage String
- When "status" : "FAILED", Atlas provides a description of the error.
- errorState String
- Description of the Atlas error when statusisFailed, Otherwise, Atlas returnsnull.
- errorState StringName 
- Error state, if any. The VPC peering connection error state value can be one of the following: REJECTED,EXPIRED,INVALID_ARGUMENT.
- gcpProject StringId 
- GCP project ID of the owner of the network peer.
- networkName String
- Name of the network peer to which Atlas connects.
- peeringId String
- Atlas assigned unique ID for the peering connection.
- providerName String
- Cloud provider for this VPC peering connection. If omitted, Atlas sets this parameter to AWS. (Possible Values AWS,AZURE,GCP).
- resourceGroup StringName 
- Name of your Azure resource group.
- routeTable StringCidr Block 
- Peer VPC CIDR block or subnet.
- status String
- Status of the Atlas network peering connection: ADDING_PEER,AVAILABLE,FAILED,DELETING,WAITING_FOR_USER.
- statusName String
- The VPC peering connection status value can be one of the following: INITIATING,PENDING_ACCEPTANCE,FAILED,FINALIZING,AVAILABLE,TERMINATING.
- vnetName String
- Name of your Azure VNet.
- vpcId String
- Unique identifier of the peer VPC.
Package Details
- Repository
- MongoDB Atlas pulumi/pulumi-mongodbatlas
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the mongodbatlasTerraform Provider.