Microsoft. DocumentDB databaseAccounts 2026-03-15

Definizione di risorsa Bicep

Il tipo di risorsa databaseAccounts può essere distribuito con operazioni destinate a:

gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Esempi di utilizzo

Esempi di Bicep

Esempio di base di distribuzione dell'account CosmosDB (formalmente DocumentDB).

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource databaseAccount 'Microsoft.DocumentDB/databaseAccounts@2021-10-15' = {
  name: resourceName
  location: location
  kind: 'GlobalDocumentDB'
  properties: {
    capabilities: []
    consistencyPolicy: {
      defaultConsistencyLevel: 'BoundedStaleness'
      maxIntervalInSeconds: 10
      maxStalenessPrefix: 200
    }
    databaseAccountOfferType: 'Standard'
    defaultIdentity: 'FirstPartyIdentity'
    disableKeyBasedMetadataWriteAccess: false
    disableLocalAuth: false
    enableAnalyticalStorage: false
    enableAutomaticFailover: false
    enableFreeTier: false
    enableMultipleWriteLocations: false
    ipRules: []
    isVirtualNetworkFilterEnabled: false
    locations: [
      {
        failoverPriority: 0
        isZoneRedundant: false
        locationName: 'West Europe'
      }
    ]
    networkAclBypass: 'None'
    networkAclBypassResourceIds: []
    publicNetworkAccess: 'Enabled'
    virtualNetworkRules: []
  }
}

Moduli verificati di Azure

Per distribuire questo tipo di risorsa, è possibile usare moduli verificati di Azure.

Module	Description
Cosmos Database Database Account	Modulo di risorse AVM per l'account del database Cosmos DB

Esempi di avvio rapido di Azure

I modelli di avvio rapido di Azure seguenti contengono esempi Bicep per la distribuzione di questo tipo di risorsa.

File bicipite	Description
API SQL Azure Cosmos DB account con analytical store	Questo template crea un account Azure Cosmos per l'API Core (SQL) con un database e un container configurati con lo store analitico.
Azure Cosmos DB Account con Web App	Questo modello implementa un account Azure Cosmos DB, un Piano App Service e crea una Web App nel Piano App Service. Aggiunge inoltre due impostazioni dell'applicazione all'App Web che fanno riferimento all'endpoint dell'account Azure Cosmos DB. In questo modo, le soluzioni distribuite sull'App Web possono connettersi all'endpoint dell'account Azure Cosmos DB utilizzando queste impostazioni.
Crea un account Cosmos DB con Microsoft Defender abilitato	Utilizzando questo modello ARM, puoi distribuire un account Azure Cosmos DB con Microsoft Defender per Azure Cosmos DB abilitato. Microsoft Defender per Azure Cosmos DB è un livello di sicurezza nativo di Azure che rileva i tentativi di sfruttare i database negli account Azure Cosmos DB. Microsoft Defender for Azure Cosmos DB rileva potenziali iniezioni SQL, attori malintenzionati noti basati su Microsoft Threat Intelligence, schemi di accesso sospetti e potenziali sfruttamenti del tuo database tramite identità compromesse o insider malevoli.
Crea un account Azure Cosmos DB di livello gratuito	Questo template crea un account Azure Cosmos DB free-tier per l'API SQL con un database con throughput condiviso e container.
Crea un account Azure Cosmos DB minimo per l'API Core (SQL	Questo template crea un account Azure Cosmos DB per l'API Core (SQL) specificando solo le proprietà minime richieste delle risorse.
Crea un account serverless Azure Cosmos DB per API SQL	Questo template crea un account serverless Azure Cosmos DB per l'API Core (SQL).
Crea un account Cosmos Azure zero touch e Azure Web App	Questo template crea un account Azure Cosmos, inietta l'endpoint Cosmos DB e inserisce le impostazioni di Azure Web App, poi distribuisce un'app web ASP MVC da GitHub.
Crea un account Azure Cosmos per l'API MongoDB	Questo template crea un account Azure Cosmos DB per MongoDB API 4.2 in due regioni utilizzando throughput condiviso e dedicato con due collezioni.
Crea un account Azure Cosmos per l'autoscala API di MongoDB	Questo template crea un account Azure Cosmos DB per MongoDB API 4.2 in due regioni utilizzando sia la velocità di scalabilità automatica condivisa che dedicata.
Crea un account Azure Cosmos per Table API	Questo template crea un account Azure Cosmos DB per l'API delle Tabelle in due regioni e una singola tabella con throughput provisionato.
Crea un account Azure Cosmos per l'API delle Tabelle con autoscale	Questo template crea un account Azure Cosmos DB per Table API in due regioni e una singola tabella con throughput autoscalabile.
Crea un account Azure Cosmos DB per Cassandra API	Questo template crea un account Azure Cosmos DB per Cassandra API in due regioni con uno spazio chiave e una tabella con throughput dedicato.
Crea un account Azure Cosmos DB per l'API Core (SQL	Questo template crea un account Azure Cosmos per l'API Core (SQL) con un database e un container con throughput e molteplici altre opzioni.
Crea un account Azure Cosmos DB per Gremlin API	Questo template crea un account Azure Cosmos DB per l'API Gremlin in due regioni con un database e un grafo utilizzando un throughput dedicato.
Crea un account Azure Cosmos DB per l'autoscala di Gremlin API	Questo template crea un account Azure Cosmos DB per l'API Gremlin in due regioni con un database e un grafo utilizzando la velocità di scalabilità automatica.
Crea un account Azure Cosmos DB in più regioni	Questo template crea un account Azure Cosmos DB per qualsiasi tipo di API di database con una regione primaria e una secondaria, scegliendo il livello di coerenza e il tipo di failover.
Crea un'API SQL per Azure Cosmos DB account con autoscale	Questo template crea un account Azure Cosmos per l'API Core (SQL) con un database e un container con throughput autoscalabile e molte altre opzioni.
Creare un account Azure Cosmos DB con un endpoint privato	Questo modello creerà un account Cosmos, una rete virtuale e un endpoint privato che espone l'account Cosmos alla rete virtuale.
Crea un account SQL Azure Cosmos DB con il piano dati RBAC	Questo modello creerà un account SQL Cosmos, una definizione di ruolo gestita in modo nativo e un'assegnazione di ruolo gestita in modo nativo per un'identità AAD.
Crea un account Azure CosmosDB	Questo modello di Resource Manager ha lo scopo di creare rapidamente un account CosmosDB con i valori minimi necessari
Create autoscale Azure Cosmos DB account per Cassandra API	Questo template crea un account Azure Cosmos DB per l'API Cassandra in due regioni con uno spazio chiave e una tabella con throughput autoscalabile.
Create Azure Cosmos DB Core (SQL) API stored procedure	Questo template crea un account Azure Cosmos DB per l'API Core (SQL) e un contenitore con una procedura memorizzata, un trigger e una funzione definita dall'utente.
Crea un'app di microservizi Dapr usando App contenitore	Creare un'app di microservizi Dapr usando App contenitore.
Crea un'app Servicebus pub-sub Dapr usando Container Apps	Creare un'app pub-sub servicebus dapr usando App contenitore.
Distribuisci Esplora dati di Azure database con connessione Cosmos DB	Deploy Esplora dati di Azure DB con connessione Cosmos DB.

Formato risorsa

Per creare un Microsoft. Risorsa DocumentDB/databaseAccounts, aggiungi il seguente Bicep al tuo template.

resource symbolicname 'Microsoft.DocumentDB/databaseAccounts@2026-03-15' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  kind: 'string'
  location: 'string'
  name: 'string'
  properties: {
    analyticalStorageConfiguration: {
      schemaType: 'string'
    }
    apiProperties: {
      serverVersion: 'string'
    }
    backupPolicy: {
      migrationState: {
        startTime: 'string'
        status: 'string'
        targetType: 'string'
      }
      type: 'string'
      // For remaining properties, see BackupPolicy objects
    }
    capabilities: [
      {
        name: 'string'
      }
    ]
    capacity: {
      totalThroughputLimit: int
    }
    connectorOffer: 'string'
    consistencyPolicy: {
      defaultConsistencyLevel: 'string'
      maxIntervalInSeconds: int
      maxStalenessPrefix: int
    }
    cors: [
      {
        allowedHeaders: 'string'
        allowedMethods: 'string'
        allowedOrigins: 'string'
        exposedHeaders: 'string'
        maxAgeInSeconds: int
      }
    ]
    createMode: 'string'
    customerManagedKeyStatus: 'string'
    databaseAccountOfferType: 'Standard'
    defaultIdentity: 'string'
    defaultPriorityLevel: 'string'
    disableKeyBasedMetadataWriteAccess: bool
    disableLocalAuth: bool
    enableAnalyticalStorage: bool
    enableAutomaticFailover: bool
    enableBurstCapacity: bool
    enableCassandraConnector: bool
    enableFreeTier: bool
    enableMultipleWriteLocations: bool
    enablePartitionMerge: bool
    enablePerRegionPerPartitionAutoscale: bool
    enablePriorityBasedExecution: bool
    enforceHierarchicalPartitionKeyIdLastLevel: bool
    ipRules: [
      {
        ipAddressOrRange: 'string'
      }
    ]
    isVirtualNetworkFilterEnabled: bool
    keyVaultKeyUri: 'string'
    locations: [
      {
        failoverPriority: int
        isZoneRedundant: bool
        locationName: 'string'
      }
    ]
    minimalTlsVersion: 'string'
    networkAclBypass: 'string'
    networkAclBypassResourceIds: [
      'string'
    ]
    publicNetworkAccess: 'string'
    restoreParameters: {
      databasesToRestore: [
        {
          collectionNames: [
            'string'
          ]
          databaseName: 'string'
        }
      ]
      gremlinDatabasesToRestore: [
        {
          databaseName: 'string'
          graphNames: [
            'string'
          ]
        }
      ]
      restoreMode: 'string'
      restoreSource: 'string'
      restoreTimestampInUtc: 'string'
      restoreWithTtlDisabled: bool
      sourceBackupLocation: 'string'
      tablesToRestore: [
        'string'
      ]
    }
    virtualNetworkRules: [
      {
        id: 'string'
        ignoreMissingVNetServiceEndpoint: bool
      }
    ]
  }
  tags: {
    {customized property}: 'string'
  }
}

Oggetti BackupPolicy

Impostare la proprietà tipo di per specificare il tipo di oggetto.

Per continuo, usare:

{
  continuousModeProperties: {
    tier: 'string'
  }
  type: 'Continuous'
}

Per periodico, usare:

{
  periodicModeProperties: {
    backupIntervalInMinutes: int
    backupRetentionIntervalInHours: int
    backupStorageRedundancy: 'string'
  }
  type: 'Periodic'
}

Valori delle proprietà