We recommend using Azure Native.
Viewing docs for Azure v4.42.0 (Older version)
published on Monday, Mar 9, 2026 by Pulumi
published on Monday, Mar 9, 2026 by Pulumi
We recommend using Azure Native.
Viewing docs for Azure v4.42.0 (Older version)
published on Monday, Mar 9, 2026 by Pulumi
published on Monday, Mar 9, 2026 by Pulumi
Use this data source to access information about an existing CosmosDB (formally DocumentDB) Account.
Example Usage
using Pulumi;
using Azure = Pulumi.Azure;
class MyStack : Stack
{
public MyStack()
{
var example = Output.Create(Azure.CosmosDB.GetAccount.InvokeAsync(new Azure.CosmosDB.GetAccountArgs
{
Name = "tfex-cosmosdb-account",
ResourceGroupName = "tfex-cosmosdb-account-rg",
}));
this.CosmosdbAccountEndpoint = example.Apply(example => example.Endpoint);
}
[Output("cosmosdbAccountEndpoint")]
public Output<string> CosmosdbAccountEndpoint { get; set; }
}
package main
import (
"github.com/pulumi/pulumi-azure/sdk/v4/go/azure/cosmosdb"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
example, err := cosmosdb.LookupAccount(ctx, &cosmosdb.LookupAccountArgs{
Name: "tfex-cosmosdb-account",
ResourceGroupName: "tfex-cosmosdb-account-rg",
}, nil)
if err != nil {
return err
}
ctx.Export("cosmosdbAccountEndpoint", example.Endpoint)
return nil
})
}
Example coming soon!
import * as pulumi from "@pulumi/pulumi";
import * as azure from "@pulumi/azure";
const example = azure.cosmosdb.getAccount({
name: "tfex-cosmosdb-account",
resourceGroupName: "tfex-cosmosdb-account-rg",
});
export const cosmosdbAccountEndpoint = example.then(example => example.endpoint);
import pulumi
import pulumi_azure as azure
example = azure.cosmosdb.get_account(name="tfex-cosmosdb-account",
resource_group_name="tfex-cosmosdb-account-rg")
pulumi.export("cosmosdbAccountEndpoint", example.endpoint)
Example coming soon!
Using getAccount
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 getAccount(args: GetAccountArgs, opts?: InvokeOptions): Promise<GetAccountResult>
function getAccountOutput(args: GetAccountOutputArgs, opts?: InvokeOptions): Output<GetAccountResult>def get_account(name: Optional[str] = None,
resource_group_name: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetAccountResult
def get_account_output(name: Optional[pulumi.Input[str]] = None,
resource_group_name: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetAccountResult]func LookupAccount(ctx *Context, args *LookupAccountArgs, opts ...InvokeOption) (*LookupAccountResult, error)
func LookupAccountOutput(ctx *Context, args *LookupAccountOutputArgs, opts ...InvokeOption) LookupAccountResultOutput> Note: This function is named LookupAccount in the Go SDK.
public static class GetAccount
{
public static Task<GetAccountResult> InvokeAsync(GetAccountArgs args, InvokeOptions? opts = null)
public static Output<GetAccountResult> Invoke(GetAccountInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetAccountResult> getAccount(GetAccountArgs args, InvokeOptions options)
public static Output<GetAccountResult> getAccount(GetAccountArgs args, InvokeOptions options)
fn::invoke:
function: azure:cosmosdb/getAccount:getAccount
arguments:
# arguments dictionaryThe following arguments are supported:
- Name string
- Specifies the name of the CosmosDB Account.
- Resource
Group stringName - Specifies the name of the resource group in which the CosmosDB Account resides.
- Name string
- Specifies the name of the CosmosDB Account.
- Resource
Group stringName - Specifies the name of the resource group in which the CosmosDB Account resides.
- name String
- Specifies the name of the CosmosDB Account.
- resource
Group StringName - Specifies the name of the resource group in which the CosmosDB Account resides.
- name string
- Specifies the name of the CosmosDB Account.
- resource
Group stringName - Specifies the name of the resource group in which the CosmosDB Account resides.
- name str
- Specifies the name of the CosmosDB Account.
- resource_
group_ strname - Specifies the name of the resource group in which the CosmosDB Account resides.
- name String
- Specifies the name of the CosmosDB Account.
- resource
Group StringName - Specifies the name of the resource group in which the CosmosDB Account resides.
getAccount Result
The following output properties are available:
- Capabilities
List<Get
Account Capability> - Capabilities enabled on this Cosmos DB account.
- Consistency
Policies List<GetAccount Consistency Policy> - Enable
Automatic boolFailover - If automatic failover is enabled for this CosmosDB Account.
- Enable
Free boolTier - If Free Tier pricing option is enabled for this CosmosDB Account.
- Enable
Multiple boolWrite Locations - If multiple write locations are enabled for this Cosmos DB account.
- Endpoint string
- The endpoint used to connect to the CosmosDB account.
- Geo
Locations List<GetAccount Geo Location> - Id string
- The provider-assigned unique ID for this managed resource.
- Ip
Range stringFilter - The current IP Filter for this CosmosDB account
- Is
Virtual boolNetwork Filter Enabled - If virtual network filtering is enabled for this Cosmos DB account.
- Key
Vault stringKey Id - The Key Vault key URI for CMK encryption.
- Kind string
- The Kind of the CosmosDB account.
- Location string
- The name of the Azure region hosting replicated data.
- Name string
- Offer
Type string - The Offer Type to used by this CosmosDB Account.
- Primary
Key string - The Primary key for the CosmosDB Account.
- Primary
Master stringKey - Primary
Readonly stringKey - The Primary read-only Key for the CosmosDB Account.
- Primary
Readonly stringMaster Key - Read
Endpoints List<string> - A list of read endpoints available for this CosmosDB account.
- Resource
Group stringName - Secondary
Key string - The Secondary key for the CosmosDB Account.
- Secondary
Master stringKey - Secondary
Readonly stringKey - The Secondary read-only key for the CosmosDB Account.
- Secondary
Readonly stringMaster Key - Dictionary<string, string>
- A mapping of tags assigned to the resource.
- Virtual
Network List<GetRules Account Virtual Network Rule> - Subnets that are allowed to access this CosmosDB account.
- Write
Endpoints List<string> - A list of write endpoints available for this CosmosDB account.
- Capabilities
[]Get
Account Capability - Capabilities enabled on this Cosmos DB account.
- Consistency
Policies []GetAccount Consistency Policy - Enable
Automatic boolFailover - If automatic failover is enabled for this CosmosDB Account.
- Enable
Free boolTier - If Free Tier pricing option is enabled for this CosmosDB Account.
- Enable
Multiple boolWrite Locations - If multiple write locations are enabled for this Cosmos DB account.
- Endpoint string
- The endpoint used to connect to the CosmosDB account.
- Geo
Locations []GetAccount Geo Location - Id string
- The provider-assigned unique ID for this managed resource.
- Ip
Range stringFilter - The current IP Filter for this CosmosDB account
- Is
Virtual boolNetwork Filter Enabled - If virtual network filtering is enabled for this Cosmos DB account.
- Key
Vault stringKey Id - The Key Vault key URI for CMK encryption.
- Kind string
- The Kind of the CosmosDB account.
- Location string
- The name of the Azure region hosting replicated data.
- Name string
- Offer
Type string - The Offer Type to used by this CosmosDB Account.
- Primary
Key string - The Primary key for the CosmosDB Account.
- Primary
Master stringKey - Primary
Readonly stringKey - The Primary read-only Key for the CosmosDB Account.
- Primary
Readonly stringMaster Key - Read
Endpoints []string - A list of read endpoints available for this CosmosDB account.
- Resource
Group stringName - Secondary
Key string - The Secondary key for the CosmosDB Account.
- Secondary
Master stringKey - Secondary
Readonly stringKey - The Secondary read-only key for the CosmosDB Account.
- Secondary
Readonly stringMaster Key - map[string]string
- A mapping of tags assigned to the resource.
- Virtual
Network []GetRules Account Virtual Network Rule - Subnets that are allowed to access this CosmosDB account.
- Write
Endpoints []string - A list of write endpoints available for this CosmosDB account.
- capabilities
List<Get
Account Capability> - Capabilities enabled on this Cosmos DB account.
- consistency
Policies List<GetAccount Consistency Policy> - enable
Automatic BooleanFailover - If automatic failover is enabled for this CosmosDB Account.
- enable
Free BooleanTier - If Free Tier pricing option is enabled for this CosmosDB Account.
- enable
Multiple BooleanWrite Locations - If multiple write locations are enabled for this Cosmos DB account.
- endpoint String
- The endpoint used to connect to the CosmosDB account.
- geo
Locations List<GetAccount Geo Location> - id String
- The provider-assigned unique ID for this managed resource.
- ip
Range StringFilter - The current IP Filter for this CosmosDB account
- is
Virtual BooleanNetwork Filter Enabled - If virtual network filtering is enabled for this Cosmos DB account.
- key
Vault StringKey Id - The Key Vault key URI for CMK encryption.
- kind String
- The Kind of the CosmosDB account.
- location String
- The name of the Azure region hosting replicated data.
- name String
- offer
Type String - The Offer Type to used by this CosmosDB Account.
- primary
Key String - The Primary key for the CosmosDB Account.
- primary
Master StringKey - primary
Readonly StringKey - The Primary read-only Key for the CosmosDB Account.
- primary
Readonly StringMaster Key - read
Endpoints List<String> - A list of read endpoints available for this CosmosDB account.
- resource
Group StringName - secondary
Key String - The Secondary key for the CosmosDB Account.
- secondary
Master StringKey - secondary
Readonly StringKey - The Secondary read-only key for the CosmosDB Account.
- secondary
Readonly StringMaster Key - Map<String,String>
- A mapping of tags assigned to the resource.
- virtual
Network List<GetRules Account Virtual Network Rule> - Subnets that are allowed to access this CosmosDB account.
- write
Endpoints List<String> - A list of write endpoints available for this CosmosDB account.
- capabilities
Get
Account Capability[] - Capabilities enabled on this Cosmos DB account.
- consistency
Policies GetAccount Consistency Policy[] - enable
Automatic booleanFailover - If automatic failover is enabled for this CosmosDB Account.
- enable
Free booleanTier - If Free Tier pricing option is enabled for this CosmosDB Account.
- enable
Multiple booleanWrite Locations - If multiple write locations are enabled for this Cosmos DB account.
- endpoint string
- The endpoint used to connect to the CosmosDB account.
- geo
Locations GetAccount Geo Location[] - id string
- The provider-assigned unique ID for this managed resource.
- ip
Range stringFilter - The current IP Filter for this CosmosDB account
- is
Virtual booleanNetwork Filter Enabled - If virtual network filtering is enabled for this Cosmos DB account.
- key
Vault stringKey Id - The Key Vault key URI for CMK encryption.
- kind string
- The Kind of the CosmosDB account.
- location string
- The name of the Azure region hosting replicated data.
- name string
- offer
Type string - The Offer Type to used by this CosmosDB Account.
- primary
Key string - The Primary key for the CosmosDB Account.
- primary
Master stringKey - primary
Readonly stringKey - The Primary read-only Key for the CosmosDB Account.
- primary
Readonly stringMaster Key - read
Endpoints string[] - A list of read endpoints available for this CosmosDB account.
- resource
Group stringName - secondary
Key string - The Secondary key for the CosmosDB Account.
- secondary
Master stringKey - secondary
Readonly stringKey - The Secondary read-only key for the CosmosDB Account.
- secondary
Readonly stringMaster Key - {[key: string]: string}
- A mapping of tags assigned to the resource.
- virtual
Network GetRules Account Virtual Network Rule[] - Subnets that are allowed to access this CosmosDB account.
- write
Endpoints string[] - A list of write endpoints available for this CosmosDB account.
- capabilities
Sequence[Get
Account Capability] - Capabilities enabled on this Cosmos DB account.
- consistency_
policies Sequence[GetAccount Consistency Policy] - enable_
automatic_ boolfailover - If automatic failover is enabled for this CosmosDB Account.
- enable_
free_ booltier - If Free Tier pricing option is enabled for this CosmosDB Account.
- enable_
multiple_ boolwrite_ locations - If multiple write locations are enabled for this Cosmos DB account.
- endpoint str
- The endpoint used to connect to the CosmosDB account.
- geo_
locations Sequence[GetAccount Geo Location] - id str
- The provider-assigned unique ID for this managed resource.
- ip_
range_ strfilter - The current IP Filter for this CosmosDB account
- is_
virtual_ boolnetwork_ filter_ enabled - If virtual network filtering is enabled for this Cosmos DB account.
- key_
vault_ strkey_ id - The Key Vault key URI for CMK encryption.
- kind str
- The Kind of the CosmosDB account.
- location str
- The name of the Azure region hosting replicated data.
- name str
- offer_
type str - The Offer Type to used by this CosmosDB Account.
- primary_
key str - The Primary key for the CosmosDB Account.
- primary_
master_ strkey - primary_
readonly_ strkey - The Primary read-only Key for the CosmosDB Account.
- primary_
readonly_ strmaster_ key - read_
endpoints Sequence[str] - A list of read endpoints available for this CosmosDB account.
- resource_
group_ strname - secondary_
key str - The Secondary key for the CosmosDB Account.
- secondary_
master_ strkey - secondary_
readonly_ strkey - The Secondary read-only key for the CosmosDB Account.
- secondary_
readonly_ strmaster_ key - Mapping[str, str]
- A mapping of tags assigned to the resource.
- virtual_
network_ Sequence[Getrules Account Virtual Network Rule] - Subnets that are allowed to access this CosmosDB account.
- write_
endpoints Sequence[str] - A list of write endpoints available for this CosmosDB account.
- capabilities List<Property Map>
- Capabilities enabled on this Cosmos DB account.
- consistency
Policies List<Property Map> - enable
Automatic BooleanFailover - If automatic failover is enabled for this CosmosDB Account.
- enable
Free BooleanTier - If Free Tier pricing option is enabled for this CosmosDB Account.
- enable
Multiple BooleanWrite Locations - If multiple write locations are enabled for this Cosmos DB account.
- endpoint String
- The endpoint used to connect to the CosmosDB account.
- geo
Locations List<Property Map> - id String
- The provider-assigned unique ID for this managed resource.
- ip
Range StringFilter - The current IP Filter for this CosmosDB account
- is
Virtual BooleanNetwork Filter Enabled - If virtual network filtering is enabled for this Cosmos DB account.
- key
Vault StringKey Id - The Key Vault key URI for CMK encryption.
- kind String
- The Kind of the CosmosDB account.
- location String
- The name of the Azure region hosting replicated data.
- name String
- offer
Type String - The Offer Type to used by this CosmosDB Account.
- primary
Key String - The Primary key for the CosmosDB Account.
- primary
Master StringKey - primary
Readonly StringKey - The Primary read-only Key for the CosmosDB Account.
- primary
Readonly StringMaster Key - read
Endpoints List<String> - A list of read endpoints available for this CosmosDB account.
- resource
Group StringName - secondary
Key String - The Secondary key for the CosmosDB Account.
- secondary
Master StringKey - secondary
Readonly StringKey - The Secondary read-only key for the CosmosDB Account.
- secondary
Readonly StringMaster Key - Map<String>
- A mapping of tags assigned to the resource.
- virtual
Network List<Property Map>Rules - Subnets that are allowed to access this CosmosDB account.
- write
Endpoints List<String> - A list of write endpoints available for this CosmosDB account.
Supporting Types
GetAccountCapability
- Name string
- Specifies the name of the CosmosDB Account.
- Name string
- Specifies the name of the CosmosDB Account.
- name String
- Specifies the name of the CosmosDB Account.
- name string
- Specifies the name of the CosmosDB Account.
- name str
- Specifies the name of the CosmosDB Account.
- name String
- Specifies the name of the CosmosDB Account.
GetAccountConsistencyPolicy
- Consistency
Level string - The Consistency Level used by this CosmosDB Account.
- Max
Interval intIn Seconds - The amount of staleness (in seconds) tolerated when the consistency level is Bounded Staleness.
- Max
Staleness intPrefix - The number of stale requests tolerated when the consistency level is Bounded Staleness.
- Consistency
Level string - The Consistency Level used by this CosmosDB Account.
- Max
Interval intIn Seconds - The amount of staleness (in seconds) tolerated when the consistency level is Bounded Staleness.
- Max
Staleness intPrefix - The number of stale requests tolerated when the consistency level is Bounded Staleness.
- consistency
Level String - The Consistency Level used by this CosmosDB Account.
- max
Interval IntegerIn Seconds - The amount of staleness (in seconds) tolerated when the consistency level is Bounded Staleness.
- max
Staleness IntegerPrefix - The number of stale requests tolerated when the consistency level is Bounded Staleness.
- consistency
Level string - The Consistency Level used by this CosmosDB Account.
- max
Interval numberIn Seconds - The amount of staleness (in seconds) tolerated when the consistency level is Bounded Staleness.
- max
Staleness numberPrefix - The number of stale requests tolerated when the consistency level is Bounded Staleness.
- consistency_
level str - The Consistency Level used by this CosmosDB Account.
- max_
interval_ intin_ seconds - The amount of staleness (in seconds) tolerated when the consistency level is Bounded Staleness.
- max_
staleness_ intprefix - The number of stale requests tolerated when the consistency level is Bounded Staleness.
- consistency
Level String - The Consistency Level used by this CosmosDB Account.
- max
Interval NumberIn Seconds - The amount of staleness (in seconds) tolerated when the consistency level is Bounded Staleness.
- max
Staleness NumberPrefix - The number of stale requests tolerated when the consistency level is Bounded Staleness.
GetAccountGeoLocation
- Failover
Priority int - Id string
- The ID of the virtual network subnet.
- Location string
- The name of the Azure region hosting replicated data.
- Failover
Priority int - Id string
- The ID of the virtual network subnet.
- Location string
- The name of the Azure region hosting replicated data.
- failover
Priority Integer - id String
- The ID of the virtual network subnet.
- location String
- The name of the Azure region hosting replicated data.
- failover
Priority number - id string
- The ID of the virtual network subnet.
- location string
- The name of the Azure region hosting replicated data.
- failover_
priority int - id str
- The ID of the virtual network subnet.
- location str
- The name of the Azure region hosting replicated data.
- failover
Priority Number - id String
- The ID of the virtual network subnet.
- location String
- The name of the Azure region hosting replicated data.
GetAccountVirtualNetworkRule
- Id string
- The ID of the virtual network subnet.
- Id string
- The ID of the virtual network subnet.
- id String
- The ID of the virtual network subnet.
- id string
- The ID of the virtual network subnet.
- id str
- The ID of the virtual network subnet.
- id String
- The ID of the virtual network subnet.
Package Details
- Repository
- Azure Classic pulumi/pulumi-azure
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
azurermTerraform Provider.
We recommend using Azure Native.
Viewing docs for Azure v4.42.0 (Older version)
published on Monday, Mar 9, 2026 by Pulumi
published on Monday, Mar 9, 2026 by Pulumi
