getTeam

MongoDB Atlas v4.0.0, Dec 30 25

MongoDB Atlas v4.0.0 published on Tuesday, Dec 30, 2025 by Pulumi

Schema (JSON)

pulumi/pulumi-mongodbatlas

MongoDB Atlas v4.0.0 published on Tuesday, Dec 30, 2025 by Pulumi

Schema (JSON)

pulumi/pulumi-mongodbatlas

Example Usage

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

const testTeam = new mongodbatlas.Team("test", {
    orgId: "<ORGANIZATION-ID>",
    name: "myNewTeam",
    usernames: [
        "user1",
        "user2",
        "user3",
    ],
});
const test = mongodbatlas.getTeamOutput({
    orgId: testTeam.orgId,
    teamId: testTeam.teamId,
});

import pulumi
import pulumi_mongodbatlas as mongodbatlas

test_team = mongodbatlas.Team("test",
    org_id="<ORGANIZATION-ID>",
    name="myNewTeam",
    usernames=[
        "user1",
        "user2",
        "user3",
    ])
test = mongodbatlas.get_team_output(org_id=test_team.org_id,
    team_id=test_team.team_id)

package main

import (
	"github.com/pulumi/pulumi-mongodbatlas/sdk/v4/go/mongodbatlas"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		testTeam, err := mongodbatlas.NewTeam(ctx, "test", &mongodbatlas.TeamArgs{
			OrgId: pulumi.String("<ORGANIZATION-ID>"),
			Name:  pulumi.String("myNewTeam"),
			Usernames: pulumi.StringArray{
				pulumi.String("user1"),
				pulumi.String("user2"),
				pulumi.String("user3"),
			},
		})
		if err != nil {
			return err
		}
		_ = mongodbatlas.LookupTeamOutput(ctx, mongodbatlas.GetTeamOutputArgs{
			OrgId:  testTeam.OrgId,
			TeamId: testTeam.TeamId,
		}, nil)
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Mongodbatlas = Pulumi.Mongodbatlas;

return await Deployment.RunAsync(() => 
{
    var testTeam = new Mongodbatlas.Team("test", new()
    {
        OrgId = "<ORGANIZATION-ID>",
        Name = "myNewTeam",
        Usernames = new[]
        {
            "user1",
            "user2",
            "user3",
        },
    });

    var test = Mongodbatlas.GetTeam.Invoke(new()
    {
        OrgId = testTeam.OrgId,
        TeamId = testTeam.TeamId,
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.mongodbatlas.Team;
import com.pulumi.mongodbatlas.TeamArgs;
import com.pulumi.mongodbatlas.MongodbatlasFunctions;
import com.pulumi.mongodbatlas.inputs.GetTeamArgs;
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 testTeam = new Team("testTeam", TeamArgs.builder()
            .orgId("<ORGANIZATION-ID>")
            .name("myNewTeam")
            .usernames(            
                "user1",
                "user2",
                "user3")
            .build());

        final var test = MongodbatlasFunctions.getTeam(GetTeamArgs.builder()
            .orgId(testTeam.orgId())
            .teamId(testTeam.teamId())
            .build());

    }
}

resources:
  testTeam:
    type: mongodbatlas:Team
    name: test
    properties:
      orgId: <ORGANIZATION-ID>
      name: myNewTeam
      usernames:
        - user1
        - user2
        - user3
variables:
  test:
    fn::invoke:
      function: mongodbatlas:getTeam
      arguments:
        orgId: ${testTeam.orgId}
        teamId: ${testTeam.teamId}

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

const test = new mongodbatlas.Team("test", {
    orgId: "<ORGANIZATION-ID>",
    name: "myNewTeam",
    usernames: [
        "user1",
        "user2",
        "user3",
    ],
});
const test2 = mongodbatlas.getTeamOutput({
    orgId: test.orgId,
    name: test.name,
});

import pulumi
import pulumi_mongodbatlas as mongodbatlas

test = mongodbatlas.Team("test",
    org_id="<ORGANIZATION-ID>",
    name="myNewTeam",
    usernames=[
        "user1",
        "user2",
        "user3",
    ])
test2 = mongodbatlas.get_team_output(org_id=test.org_id,
    name=test.name)

package main

import (
	"github.com/pulumi/pulumi-mongodbatlas/sdk/v4/go/mongodbatlas"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		test, err := mongodbatlas.NewTeam(ctx, "test", &mongodbatlas.TeamArgs{
			OrgId: pulumi.String("<ORGANIZATION-ID>"),
			Name:  pulumi.String("myNewTeam"),
			Usernames: pulumi.StringArray{
				pulumi.String("user1"),
				pulumi.String("user2"),
				pulumi.String("user3"),
			},
		})
		if err != nil {
			return err
		}
		_ = mongodbatlas.LookupTeamOutput(ctx, mongodbatlas.GetTeamOutputArgs{
			OrgId: test.OrgId,
			Name:  test.Name,
		}, nil)
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Mongodbatlas = Pulumi.Mongodbatlas;

return await Deployment.RunAsync(() => 
{
    var test = new Mongodbatlas.Team("test", new()
    {
        OrgId = "<ORGANIZATION-ID>",
        Name = "myNewTeam",
        Usernames = new[]
        {
            "user1",
            "user2",
            "user3",
        },
    });

    var test2 = Mongodbatlas.GetTeam.Invoke(new()
    {
        OrgId = test.OrgId,
        Name = test.Name,
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.mongodbatlas.Team;
import com.pulumi.mongodbatlas.TeamArgs;
import com.pulumi.mongodbatlas.MongodbatlasFunctions;
import com.pulumi.mongodbatlas.inputs.GetTeamArgs;
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 test = new Team("test", TeamArgs.builder()
            .orgId("<ORGANIZATION-ID>")
            .name("myNewTeam")
            .usernames(            
                "user1",
                "user2",
                "user3")
            .build());

        final var test2 = MongodbatlasFunctions.getTeam(GetTeamArgs.builder()
            .orgId(test.orgId())
            .name(test.name())
            .build());

    }
}

resources:
  test:
    type: mongodbatlas:Team
    properties:
      orgId: <ORGANIZATION-ID>
      name: myNewTeam
      usernames:
        - user1
        - user2
        - user3
variables:
  test2:
    fn::invoke:
      function: mongodbatlas:getTeam
      arguments:
        orgId: ${test.orgId}
        name: ${test.name}

Using getTeam

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 getTeam(args: GetTeamArgs, opts?: InvokeOptions): Promise<GetTeamResult>
function getTeamOutput(args: GetTeamOutputArgs, opts?: InvokeOptions): Output<GetTeamResult>

def get_team(name: Optional[str] = None,
             org_id: Optional[str] = None,
             team_id: Optional[str] = None,
             opts: Optional[InvokeOptions] = None) -> GetTeamResult
def get_team_output(name: Optional[pulumi.Input[str]] = None,
             org_id: Optional[pulumi.Input[str]] = None,
             team_id: Optional[pulumi.Input[str]] = None,
             opts: Optional[InvokeOptions] = None) -> Output[GetTeamResult]

func LookupTeam(ctx *Context, args *LookupTeamArgs, opts ...InvokeOption) (*LookupTeamResult, error)
func LookupTeamOutput(ctx *Context, args *LookupTeamOutputArgs, opts ...InvokeOption) LookupTeamResultOutput

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

public static class GetTeam 
{
    public static Task<GetTeamResult> InvokeAsync(GetTeamArgs args, InvokeOptions? opts = null)
    public static Output<GetTeamResult> Invoke(GetTeamInvokeArgs args, InvokeOptions? opts = null)
}

public static CompletableFuture<GetTeamResult> getTeam(GetTeamArgs args, InvokeOptions options)
public static Output<GetTeamResult> getTeam(GetTeamArgs args, InvokeOptions options)

fn::invoke:
  function: mongodbatlas:index/getTeam:getTeam
  arguments:
    # arguments dictionary

The following arguments are supported:

OrgId string: The unique identifier for the organization you want to associate the team with.
Name string: The team name.
IMPORTANT: Either team_id or name must be configured.
TeamId string: The unique identifier for the team.

OrgId string: The unique identifier for the organization you want to associate the team with.
Name string: The team name.
IMPORTANT: Either team_id or name must be configured.
TeamId string: The unique identifier for the team.

orgId String: The unique identifier for the organization you want to associate the team with.
name String: The team name.
IMPORTANT: Either team_id or name must be configured.
teamId String: The unique identifier for the team.

orgId string: The unique identifier for the organization you want to associate the team with.
name string: The team name.
IMPORTANT: Either team_id or name must be configured.
teamId string: The unique identifier for the team.

org_id str: The unique identifier for the organization you want to associate the team with.
name str: The team name.
IMPORTANT: Either team_id or name must be configured.
team_id str: The unique identifier for the team.

orgId String: The unique identifier for the organization you want to associate the team with.
name String: The team name.
IMPORTANT: Either team_id or name must be configured.
teamId String: The unique identifier for the team.

getTeam Result

The following output properties are available:

Id string: The provider-assigned unique ID for this managed resource.
Name string: The name of the team you want to create.
OrgId string
TeamId string: The unique identifier for the team.
Usernames List<string>: (DEPRECATED) The users who are part of the team. This attribute is deprecated and will be removed in the next major release. Please transition to data.mongodbatlas_team.users. For more details, see Migration Guide: Team Usernames Attribute to Cloud User Team Assignment.
Deprecated: This parameter is deprecated and will be removed in the next major release. Please transition to data.mongodbatlas_team.users. For more details, see https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/guides/atlas-user-management.
Users List<GetTeamUser>: Returns a list of all pending and active MongoDB Cloud users associated with the specified team.

Id string: The provider-assigned unique ID for this managed resource.
Name string: The name of the team you want to create.
OrgId string
TeamId string: The unique identifier for the team.
Usernames []string: (DEPRECATED) The users who are part of the team. This attribute is deprecated and will be removed in the next major release. Please transition to data.mongodbatlas_team.users. For more details, see Migration Guide: Team Usernames Attribute to Cloud User Team Assignment.
Deprecated: This parameter is deprecated and will be removed in the next major release. Please transition to data.mongodbatlas_team.users. For more details, see https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/guides/atlas-user-management.
Users []GetTeamUser: Returns a list of all pending and active MongoDB Cloud users associated with the specified team.

id String: The provider-assigned unique ID for this managed resource.
name String: The name of the team you want to create.
orgId String
teamId String: The unique identifier for the team.
usernames List<String>: (DEPRECATED) The users who are part of the team. This attribute is deprecated and will be removed in the next major release. Please transition to data.mongodbatlas_team.users. For more details, see Migration Guide: Team Usernames Attribute to Cloud User Team Assignment.
Deprecated: This parameter is deprecated and will be removed in the next major release. Please transition to data.mongodbatlas_team.users. For more details, see https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/guides/atlas-user-management.
users List<GetTeamUser>: Returns a list of all pending and active MongoDB Cloud users associated with the specified team.

id string: The provider-assigned unique ID for this managed resource.
name string: The name of the team you want to create.
orgId string
teamId string: The unique identifier for the team.
usernames string[]: (DEPRECATED) The users who are part of the team. This attribute is deprecated and will be removed in the next major release. Please transition to data.mongodbatlas_team.users. For more details, see Migration Guide: Team Usernames Attribute to Cloud User Team Assignment.
Deprecated: This parameter is deprecated and will be removed in the next major release. Please transition to data.mongodbatlas_team.users. For more details, see https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/guides/atlas-user-management.
users GetTeamUser[]: Returns a list of all pending and active MongoDB Cloud users associated with the specified team.

id str: The provider-assigned unique ID for this managed resource.
name str: The name of the team you want to create.
org_id str
team_id str: The unique identifier for the team.
usernames Sequence[str]: (DEPRECATED) The users who are part of the team. This attribute is deprecated and will be removed in the next major release. Please transition to data.mongodbatlas_team.users. For more details, see Migration Guide: Team Usernames Attribute to Cloud User Team Assignment.
Deprecated: This parameter is deprecated and will be removed in the next major release. Please transition to data.mongodbatlas_team.users. For more details, see https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/guides/atlas-user-management.
users Sequence[GetTeamUser]: Returns a list of all pending and active MongoDB Cloud users associated with the specified team.

id String: The provider-assigned unique ID for this managed resource.
name String: The name of the team you want to create.
orgId String
teamId String: The unique identifier for the team.
usernames List<String>: (DEPRECATED) The users who are part of the team. This attribute is deprecated and will be removed in the next major release. Please transition to data.mongodbatlas_team.users. For more details, see Migration Guide: Team Usernames Attribute to Cloud User Team Assignment.
Deprecated: This parameter is deprecated and will be removed in the next major release. Please transition to data.mongodbatlas_team.users. For more details, see https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/guides/atlas-user-management.
users List<Property Map>: Returns a list of all pending and active MongoDB Cloud users associated with the specified team.

Supporting Types

GetTeamUser

Country string: Two-character alphabetical string that identifies the MongoDB Cloud user's geographic location. This parameter uses the ISO 3166-1a2 code format.
CreatedAt string: Date and time when MongoDB Cloud created the current account. This value is in the ISO 8601 timestamp format in UTC.
FirstName string: First or given name that belongs to the MongoDB Cloud user.
Id string: Unique 24-hexadecimal digit string that identifies the MongoDB Cloud user.
InvitationCreatedAt string: Date and time when MongoDB Cloud sent the invitation. MongoDB Cloud represents this timestamp in ISO 8601 format in UTC.
InvitationExpiresAt string: Date and time when the invitation from MongoDB Cloud expires. MongoDB Cloud represents this timestamp in ISO 8601 format in UTC.
InviterUsername string: Username of the MongoDB Cloud user who sent the invitation to join the organization.
LastAuth string: Date and time when the current account last authenticated. This value is in the ISO 8601 timestamp format in UTC.
LastName string: Last name, family name, or surname that belongs to the MongoDB Cloud user.
MobileNumber string: Mobile phone number that belongs to the MongoDB Cloud user.
OrgMembershipStatus string: String enum that indicates whether the MongoDB Cloud user has a pending invitation to join the organization or are already active in the organization.
Roles List<GetTeamUserRole>: Organization and project-level roles assigned to one MongoDB Cloud user within one organization.
TeamIds List<string>: List of unique 24-hexadecimal digit strings that identifies the teams to which this MongoDB Cloud user belongs.
Username string: Email address that represents the username of the MongoDB Cloud user.

Country string: Two-character alphabetical string that identifies the MongoDB Cloud user's geographic location. This parameter uses the ISO 3166-1a2 code format.
CreatedAt string: Date and time when MongoDB Cloud created the current account. This value is in the ISO 8601 timestamp format in UTC.
FirstName string: First or given name that belongs to the MongoDB Cloud user.
Id string: Unique 24-hexadecimal digit string that identifies the MongoDB Cloud user.
InvitationCreatedAt string: Date and time when MongoDB Cloud sent the invitation. MongoDB Cloud represents this timestamp in ISO 8601 format in UTC.
InvitationExpiresAt string: Date and time when the invitation from MongoDB Cloud expires. MongoDB Cloud represents this timestamp in ISO 8601 format in UTC.
InviterUsername string: Username of the MongoDB Cloud user who sent the invitation to join the organization.
LastAuth string: Date and time when the current account last authenticated. This value is in the ISO 8601 timestamp format in UTC.
LastName string: Last name, family name, or surname that belongs to the MongoDB Cloud user.
MobileNumber string: Mobile phone number that belongs to the MongoDB Cloud user.
OrgMembershipStatus string: String enum that indicates whether the MongoDB Cloud user has a pending invitation to join the organization or are already active in the organization.
Roles []GetTeamUserRole: Organization and project-level roles assigned to one MongoDB Cloud user within one organization.
TeamIds []string: List of unique 24-hexadecimal digit strings that identifies the teams to which this MongoDB Cloud user belongs.
Username string: Email address that represents the username of the MongoDB Cloud user.

country String: Two-character alphabetical string that identifies the MongoDB Cloud user's geographic location. This parameter uses the ISO 3166-1a2 code format.
createdAt String: Date and time when MongoDB Cloud created the current account. This value is in the ISO 8601 timestamp format in UTC.
firstName String: First or given name that belongs to the MongoDB Cloud user.
id String: Unique 24-hexadecimal digit string that identifies the MongoDB Cloud user.
invitationCreatedAt String: Date and time when MongoDB Cloud sent the invitation. MongoDB Cloud represents this timestamp in ISO 8601 format in UTC.
invitationExpiresAt String: Date and time when the invitation from MongoDB Cloud expires. MongoDB Cloud represents this timestamp in ISO 8601 format in UTC.
inviterUsername String: Username of the MongoDB Cloud user who sent the invitation to join the organization.
lastAuth String: Date and time when the current account last authenticated. This value is in the ISO 8601 timestamp format in UTC.
lastName String: Last name, family name, or surname that belongs to the MongoDB Cloud user.
mobileNumber String: Mobile phone number that belongs to the MongoDB Cloud user.
orgMembershipStatus String: String enum that indicates whether the MongoDB Cloud user has a pending invitation to join the organization or are already active in the organization.
roles List<GetTeamUserRole>: Organization and project-level roles assigned to one MongoDB Cloud user within one organization.
teamIds List<String>: List of unique 24-hexadecimal digit strings that identifies the teams to which this MongoDB Cloud user belongs.
username String: Email address that represents the username of the MongoDB Cloud user.

country string: Two-character alphabetical string that identifies the MongoDB Cloud user's geographic location. This parameter uses the ISO 3166-1a2 code format.
createdAt string: Date and time when MongoDB Cloud created the current account. This value is in the ISO 8601 timestamp format in UTC.
firstName string: First or given name that belongs to the MongoDB Cloud user.
id string: Unique 24-hexadecimal digit string that identifies the MongoDB Cloud user.
invitationCreatedAt string: Date and time when MongoDB Cloud sent the invitation. MongoDB Cloud represents this timestamp in ISO 8601 format in UTC.
invitationExpiresAt string: Date and time when the invitation from MongoDB Cloud expires. MongoDB Cloud represents this timestamp in ISO 8601 format in UTC.
inviterUsername string: Username of the MongoDB Cloud user who sent the invitation to join the organization.
lastAuth string: Date and time when the current account last authenticated. This value is in the ISO 8601 timestamp format in UTC.
lastName string: Last name, family name, or surname that belongs to the MongoDB Cloud user.
mobileNumber string: Mobile phone number that belongs to the MongoDB Cloud user.
orgMembershipStatus string: String enum that indicates whether the MongoDB Cloud user has a pending invitation to join the organization or are already active in the organization.
roles GetTeamUserRole[]: Organization and project-level roles assigned to one MongoDB Cloud user within one organization.
teamIds string[]: List of unique 24-hexadecimal digit strings that identifies the teams to which this MongoDB Cloud user belongs.
username string: Email address that represents the username of the MongoDB Cloud user.

country str: Two-character alphabetical string that identifies the MongoDB Cloud user's geographic location. This parameter uses the ISO 3166-1a2 code format.
created_at str: Date and time when MongoDB Cloud created the current account. This value is in the ISO 8601 timestamp format in UTC.
first_name str: First or given name that belongs to the MongoDB Cloud user.
id str: Unique 24-hexadecimal digit string that identifies the MongoDB Cloud user.
invitation_created_at str: Date and time when MongoDB Cloud sent the invitation. MongoDB Cloud represents this timestamp in ISO 8601 format in UTC.
invitation_expires_at str: Date and time when the invitation from MongoDB Cloud expires. MongoDB Cloud represents this timestamp in ISO 8601 format in UTC.
inviter_username str: Username of the MongoDB Cloud user who sent the invitation to join the organization.
last_auth str: Date and time when the current account last authenticated. This value is in the ISO 8601 timestamp format in UTC.
last_name str: Last name, family name, or surname that belongs to the MongoDB Cloud user.
mobile_number str: Mobile phone number that belongs to the MongoDB Cloud user.
org_membership_status str: String enum that indicates whether the MongoDB Cloud user has a pending invitation to join the organization or are already active in the organization.
roles Sequence[GetTeamUserRole]: Organization and project-level roles assigned to one MongoDB Cloud user within one organization.
team_ids Sequence[str]: List of unique 24-hexadecimal digit strings that identifies the teams to which this MongoDB Cloud user belongs.
username str: Email address that represents the username of the MongoDB Cloud user.

country String: Two-character alphabetical string that identifies the MongoDB Cloud user's geographic location. This parameter uses the ISO 3166-1a2 code format.
createdAt String: Date and time when MongoDB Cloud created the current account. This value is in the ISO 8601 timestamp format in UTC.
firstName String: First or given name that belongs to the MongoDB Cloud user.
id String: Unique 24-hexadecimal digit string that identifies the MongoDB Cloud user.
invitationCreatedAt String: Date and time when MongoDB Cloud sent the invitation. MongoDB Cloud represents this timestamp in ISO 8601 format in UTC.
invitationExpiresAt String: Date and time when the invitation from MongoDB Cloud expires. MongoDB Cloud represents this timestamp in ISO 8601 format in UTC.
inviterUsername String: Username of the MongoDB Cloud user who sent the invitation to join the organization.
lastAuth String: Date and time when the current account last authenticated. This value is in the ISO 8601 timestamp format in UTC.
lastName String: Last name, family name, or surname that belongs to the MongoDB Cloud user.
mobileNumber String: Mobile phone number that belongs to the MongoDB Cloud user.
orgMembershipStatus String: String enum that indicates whether the MongoDB Cloud user has a pending invitation to join the organization or are already active in the organization.
roles List<Property Map>: Organization and project-level roles assigned to one MongoDB Cloud user within one organization.
teamIds List<String>: List of unique 24-hexadecimal digit strings that identifies the teams to which this MongoDB Cloud user belongs.
username String: Email address that represents the username of the MongoDB Cloud user.