Condividi tramite


Database Microsoft.DocumentDBAccounts 2020-09-01

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.

Formato risorsa

Per creare una risorsa Microsoft.DocumentDB/databaseAccounts, aggiungere il bicep seguente al modello.

resource symbolicname 'Microsoft.DocumentDB/databaseAccounts@2020-09-01' = {
  kind: 'string'
  location: 'string'
  name: 'string'
  properties: {
    apiProperties: {
      serverVersion: 'string'
    }
    backupPolicy: {
      type: 'string'
      // For remaining properties, see BackupPolicy objects
    }
    capabilities: [
      {
        name: 'string'
      }
    ]
    connectorOffer: 'string'
    consistencyPolicy: {
      defaultConsistencyLevel: 'string'
      maxIntervalInSeconds: int
      maxStalenessPrefix: int
    }
    cors: [
      {
        allowedHeaders: 'string'
        allowedMethods: 'string'
        allowedOrigins: 'string'
        exposedHeaders: 'string'
        maxAgeInSeconds: int
      }
    ]
    databaseAccountOfferType: 'Standard'
    disableKeyBasedMetadataWriteAccess: bool
    enableAnalyticalStorage: bool
    enableAutomaticFailover: bool
    enableCassandraConnector: bool
    enableFreeTier: bool
    enableMultipleWriteLocations: bool
    ipRules: [
      {
        ipAddressOrRange: 'string'
      }
    ]
    isVirtualNetworkFilterEnabled: bool
    keyVaultKeyUri: 'string'
    locations: [
      {
        failoverPriority: int
        isZoneRedundant: bool
        locationName: '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:

{
  type: 'Continuous'
}

Per periodico, usare:

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

Valori delle proprietà

ApiProperties

Nome Descrizione Valore
serverVersion Descrive ServerVersion di un account MongoDB. '3.2'
'3.6'

BackupPolicy

Nome Descrizione Valore
digitare Impostare su "Continuous" per il tipo ContinuousModeBackupPolicy. Impostare su "Periodico" per il tipo PeriodicModeBackupPolicy. 'Continuous'
'Periodico' (obbligatorio)

Capacità

Nome Descrizione Valore
nome Nome della funzionalità di Cosmos DB. Ad esempio, "name": "EnableCassandra". I valori correnti includono anche "EnableTable" e "EnableGremlin". corda

ConsistencyPolicy

Nome Descrizione Valore
defaultConsistencyLevel Il livello di coerenza predefinito e le impostazioni di configurazione dell'account Cosmos DB. 'BoundedStaleness'
'ConsistentPrefix'
'Finale'
'Session'
'Strong' (obbligatorio)
maxIntervalInSeconds Se usato con il livello di coerenza decadimento ristretto, questo valore rappresenta la quantità di tempo di decadimento (in secondi) tollerata. L'intervallo accettato per questo valore è 5 - 86400. Obbligatorio quando defaultConsistencyPolicy è impostato su "BoundedStaleness". Int

Vincoli:
Valore minimo = 5
Valore massimo = 86400
maxStalenessPrefix Se usato con il livello di coerenza decadimento ristretto, questo valore rappresenta il numero di richieste non aggiornati tollerate. L'intervallo accettato per questo valore è 1 - 2.147.483.647. Obbligatorio quando defaultConsistencyPolicy è impostato su "BoundedStaleness". Int

Vincoli:
Valore minimo = 1
Valore massimo = 2147483647

ContinuousModeBackupPolicy

Nome Descrizione Valore
digitare Descrive la modalità di backup. 'Continuous' (obbligatorio)

CorsPolicy

Nome Descrizione Valore
allowedHeaders Intestazioni di richiesta che il dominio di origine può specificare nella richiesta CORS. corda
allowedMethods I metodi (verbi di richiesta HTTP) che il dominio di origine può usare per una richiesta CORS. corda
allowedOrigins Domini di origine autorizzati a effettuare una richiesta al servizio tramite CORS. stringa (obbligatorio)
exposedHeaders Intestazioni di risposta che possono essere inviate nella risposta alla richiesta CORS ed esposte dal browser all'emittente della richiesta. corda
maxAgeInSeconds Periodo massimo di tempo in cui un browser deve memorizzare nella cache la richiesta OPTIONS preliminare. Int

Vincoli:
Valore minimo = 1
Valore massimo = 2147483647

DatabaseAccountCreateUpdatePropertiesOrDatabaseAccountGetProperties

Nome Descrizione Valore
apiProperties Proprietà specifiche dell'API. Attualmente, supportato solo per l'API MongoDB. ApiProperties
backupPolicy Oggetto che rappresenta i criteri per l'esecuzione di backup in un account. BackupPolicy
Funzionalità Elenco delle funzionalità di Cosmos DB per l'account funzionalità[]
connectorOffer Tipo di offerta del connettore cassandra per l'account C* del database Cosmos DB. 'Small'
consistencyPolicy Criteri di coerenza per l'account Cosmos DB. ConsistencyPolicy
cors Criteri CORS per l'account del database Cosmos DB. CorsPolicy[]
databaseAccountOfferType Tipo di offerta per il database 'Standard' (obbligatorio)
disableKeyBasedMetadataWriteAccess Disabilitare le operazioni di scrittura sulle risorse dei metadati (database, contenitori, velocità effettiva) tramite chiavi dell'account Bool
enableAnalyticalStorage Flag per indicare se abilitare l'analisi dell'archiviazione. Bool
enableAutomaticFailover Abilita il failover automatico dell'area di scrittura nel raro caso in cui l'area non sia disponibile a causa di un'interruzione del servizio. Il failover automatico comporterà una nuova area di scrittura per l'account e viene scelta in base alle priorità di failover configurate per l'account. Bool
enableCassandraConnector Abilita il connettore cassandra nell'account C* di Cosmos DB Bool
enableFreeTier Flag per indicare se il livello gratuito è abilitato. Bool
enableMultipleWriteLocations Consente all'account di scrivere in più posizioni Bool
ipRules Elenco di IpRules. IpAddressOrRange[]
isVirtualNetworkFilterEnabled Flag per indicare se abilitare o disabilitare le regole ACL di rete virtuale. Bool
keyVaultKeyUri URI dell'insieme di credenziali delle chiavi corda
Luoghi Matrice che contiene le posizioni di replica geografica abilitate per l'account Cosmos DB. percorso[] (obbligatorio)
virtualNetworkRules Elenco delle regole ACL di rete virtuale configurate per l'account Cosmos DB. VirtualNetworkRule[]

IpAddressOrRange

Nome Descrizione Valore
ipAddressOrRange Un singolo indirizzo IPv4 o un singolo intervallo di indirizzi IPv4 in formato CIDR. Gli indirizzi IP forniti devono essere formattati correttamente e non possono essere contenuti in uno degli intervalli seguenti: 10.0.0.0/8, 100.64.0.0/10, 172.16.0.0/12, 192.168.0.0.0/16, perché non sono applicabili dal filtro di indirizzi IP. Esempio di input validi: "23.40.210.245" o "23.40.210.0/8". corda

Ubicazione

Nome Descrizione Valore
failoverPriority Priorità di failover dell'area. Una priorità di failover pari a 0 indica un'area di scrittura. Valore massimo per una priorità di failover = (numero totale di aree - 1). I valori di priorità di failover devono essere univoci per ognuna delle aree in cui è presente l'account di database. Int

Vincoli:
Valore minimo = 0
isZoneRedundant Flag per indicare se questa area è un'area availabilityZone Bool
locationName Nome dell'area. corda

Microsoft.DocumentDB/databaseAccounts

Nome Descrizione Valore
gentile Indica il tipo di account di database. Questa impostazione può essere impostata solo durante la creazione dell'account di database. 'GlobalDocumentDB'
'MongoDB'
'Parse'
ubicazione Posizione del gruppo di risorse a cui appartiene la risorsa. corda
nome Nome della risorsa corda

Vincoli:
Lunghezza minima = 3
Lunghezza massima = 3
Pattern = ^[a-z0-9]+(-[a-z0-9]+)* (obbligatorio)
proprietà Proprietà per creare e aggiornare gli account del database Azure Cosmos DB. DatabaseAccountCreateUpdatePropertiesOrDatabaseAccountGetProperties (obbligatorio)
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli

PeriodicModeBackupPolicy

Nome Descrizione Valore
periodicModeProperties Valori di configurazione per il backup in modalità periodica PeriodicModeProperties
digitare Descrive la modalità di backup. 'Periodico' (obbligatorio)

PeriodicModeProperties

Nome Descrizione Valore
backupIntervalInMinutes Intero che rappresenta l'intervallo in minuti tra due backup Int

Vincoli:
Valore minimo = 0
backupRetentionIntervalInHours Intero che rappresenta l'ora (in ore) di conservazione di ogni backup Int

Vincoli:
Valore minimo = 0

Tag

Nome Descrizione Valore

VirtualNetworkRule

Nome Descrizione Valore
Id ID risorsa di una subnet, ad esempio: /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}. corda
ignoreMissingVNetServiceEndpoint Creare una regola del firewall prima che la rete virtuale disponga dell'endpoint servizio di rete virtuale abilitato. Bool

Esempi di avvio rapido

Gli esempi di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Bicep File Descrizione
'API SQL dell'account Azure Cosmos DB con l'archivio analitico Questo modello crea un account Azure Cosmos per l'API Core (SQL) con un database e un contenitore configurati con l'archivio analitico.
account Azure Cosmos DB con app Web Questo modello distribuisce un account Azure Cosmos DB, un piano di servizio app e crea un'app Web nel piano di servizio app. Aggiunge anche due impostazioni dell'applicazione all'app Web che fanno riferimento all'endpoint dell'account Azure Cosmos DB. In questo modo le soluzioni distribuite nell'app Web possono connettersi all'endpoint dell'account Azure Cosmos DB usando tali impostazioni.
Creare un account Cosmos DB con Microsoft Defender abilitato Usando questo modello di Resource Manager, è possibile 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 per Azure Cosmos DB rileva potenziali attacchi SQL injection, attori malintenzionati noti basati su Microsoft Threat Intelligence, modelli di accesso sospetti e potenziali sfruttamento del database tramite identità compromesse o utenti malintenzionati.
Creare un account Azure Cosmos DB di livello gratuito Questo modello crea un account Azure Cosmos DB di livello gratuito per l'API SQL con un database con velocità effettiva e contenitore condivisi.
Creare un account Azure Cosmos DB minimo per l'API Core (SQL) Questo modello crea un account Azure Cosmos DB per l'API Core (SQL) specificando solo le proprietà minime necessarie per le risorse.
Creare un account Azure Cosmos DB serverless per l'API SQL Questo modello crea un account Azure Cosmos DB serverless per l'API Core (SQL).
Creare un account Azure Cosmos senza tocco e un'app Web di Azure Questo modello crea un account Azure Cosmos, inserisce l'endpoint e le chiavi di Cosmos DB nelle impostazioni dell'app Web di Azure e quindi distribuisce un'app Web ASP MVC da GitHub.
Creare un account Azure Cosmos per l'API MongoDB Questo modello crea un account Azure Cosmos DB per l'API MongoDB 4.2 in due aree usando la velocità effettiva condivisa e dedicata con due raccolte.
Creare un account Azure Cosmos per la scalabilità automatica dell'API MongoDB Questo modello crea un account Azure Cosmos DB per l'API MongoDB 4.2 in due aree usando la velocità effettiva di scalabilità automatica condivisa e dedicata.
Creare un account Azure Cosmos per l'API Tabella Questo modello crea un account Azure Cosmos DB per l'API Tabella in due aree e una singola tabella con velocità effettiva con provisioning.
Creare un account Azure Cosmos per l'API Tabella con scalabilità automatica Questo modello crea un account Azure Cosmos DB per l'API Tabella in due aree e una singola tabella con velocità effettiva di scalabilità automatica.
Creare un account Azure Cosmos DB per l'API Cassandra Questo modello crea un account Azure Cosmos DB per l'API Cassandra in due aree con un keyspace e una tabella con velocità effettiva dedicata.
Creare un account Azure Cosmos DB per l'API Core (SQL) Questo modello crea un account Azure Cosmos per l'API Core (SQL) con un database e un contenitore con velocità effettiva con più altre opzioni.
Creare un account Azure Cosmos DB per l'API Gremlin Questo modello crea un account Azure Cosmos DB per l'API Gremlin in due aree con un database e un grafo usando la velocità effettiva dedicata.
Creare un account Azure Cosmos DB per la scalabilità automatica dell'API Gremlin Questo modello crea un account Azure Cosmos DB per l'API Gremlin in due aree con un database e un grafo usando la velocità effettiva di scalabilità automatica.
Creare un account Azure Cosmos DB in più aree Questo modello crea un account Azure Cosmos DB per qualsiasi tipo di API di database con un'area primaria e secondaria con la scelta del livello di coerenza e del tipo di failover.
Creare un'API SQL dell'account Azure Cosmos DB con scalabilità automatica Questo modello crea un account Azure Cosmos per l'API Core (SQL) con un database e un contenitore con velocità effettiva con scalabilità automatica con più 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.
Creare un account SQL di Azure Cosmos DB con controllo degli accessi in base al ruolo del piano dati 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.
Creare un account Azure CosmosDB Questo modello di Resource Manager ha lo scopo di creare rapidamente un account CosmosDB con i valori minimi necessari
Creare un account Azure Cosmos DB di scalabilità automatica per l'API Cassandra Questo modello crea un account Azure Cosmos DB per l'API Cassandra in due aree con un keyspace e una tabella con velocità effettiva di scalabilità automatica.
Creare stored procedure dell'API Core (SQL) di Azure Cosmos DB Questo modello crea un account Azure Cosmos DB per l'API Core (SQL) e un contenitore con una stored procedure, 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 pub-sub-servicebus dapr usando app contenitore Creare un'app pub-sub servicebus dapr usando App contenitore.
Distribuire Azure Data Explorer DB con la connessione di Cosmos DB Distribuire Azure Data Explorer DB con la connessione Cosmos DB.

Definizione di risorsa del modello di Resource Manager

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.

Formato risorsa

Per creare una risorsa Microsoft.DocumentDB/databaseAccounts, aggiungere il codice JSON seguente al modello.

{
  "type": "Microsoft.DocumentDB/databaseAccounts",
  "apiVersion": "2020-09-01",
  "name": "string",
  "kind": "string",
  "location": "string",
  "properties": {
    "apiProperties": {
      "serverVersion": "string"
    },
    "backupPolicy": {
      "type": "string"
      // For remaining properties, see BackupPolicy objects
    },
    "capabilities": [
      {
        "name": "string"
      }
    ],
    "connectorOffer": "string",
    "consistencyPolicy": {
      "defaultConsistencyLevel": "string",
      "maxIntervalInSeconds": "int",
      "maxStalenessPrefix": "int"
    },
    "cors": [
      {
        "allowedHeaders": "string",
        "allowedMethods": "string",
        "allowedOrigins": "string",
        "exposedHeaders": "string",
        "maxAgeInSeconds": "int"
      }
    ],
    "databaseAccountOfferType": "Standard",
    "disableKeyBasedMetadataWriteAccess": "bool",
    "enableAnalyticalStorage": "bool",
    "enableAutomaticFailover": "bool",
    "enableCassandraConnector": "bool",
    "enableFreeTier": "bool",
    "enableMultipleWriteLocations": "bool",
    "ipRules": [
      {
        "ipAddressOrRange": "string"
      }
    ],
    "isVirtualNetworkFilterEnabled": "bool",
    "keyVaultKeyUri": "string",
    "locations": [
      {
        "failoverPriority": "int",
        "isZoneRedundant": "bool",
        "locationName": "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:

{
  "type": "Continuous"
}

Per periodico, usare:

{
  "periodicModeProperties": {
    "backupIntervalInMinutes": "int",
    "backupRetentionIntervalInHours": "int"
  },
  "type": "Periodic"
}

Valori delle proprietà

ApiProperties

Nome Descrizione Valore
serverVersion Descrive ServerVersion di un account MongoDB. '3.2'
'3.6'

BackupPolicy

Nome Descrizione Valore
digitare Impostare su "Continuous" per il tipo ContinuousModeBackupPolicy. Impostare su "Periodico" per il tipo PeriodicModeBackupPolicy. 'Continuous'
'Periodico' (obbligatorio)

Capacità

Nome Descrizione Valore
nome Nome della funzionalità di Cosmos DB. Ad esempio, "name": "EnableCassandra". I valori correnti includono anche "EnableTable" e "EnableGremlin". corda

ConsistencyPolicy

Nome Descrizione Valore
defaultConsistencyLevel Il livello di coerenza predefinito e le impostazioni di configurazione dell'account Cosmos DB. 'BoundedStaleness'
'ConsistentPrefix'
'Finale'
'Session'
'Strong' (obbligatorio)
maxIntervalInSeconds Se usato con il livello di coerenza decadimento ristretto, questo valore rappresenta la quantità di tempo di decadimento (in secondi) tollerata. L'intervallo accettato per questo valore è 5 - 86400. Obbligatorio quando defaultConsistencyPolicy è impostato su "BoundedStaleness". Int

Vincoli:
Valore minimo = 5
Valore massimo = 86400
maxStalenessPrefix Se usato con il livello di coerenza decadimento ristretto, questo valore rappresenta il numero di richieste non aggiornati tollerate. L'intervallo accettato per questo valore è 1 - 2.147.483.647. Obbligatorio quando defaultConsistencyPolicy è impostato su "BoundedStaleness". Int

Vincoli:
Valore minimo = 1
Valore massimo = 2147483647

ContinuousModeBackupPolicy

Nome Descrizione Valore
digitare Descrive la modalità di backup. 'Continuous' (obbligatorio)

CorsPolicy

Nome Descrizione Valore
allowedHeaders Intestazioni di richiesta che il dominio di origine può specificare nella richiesta CORS. corda
allowedMethods I metodi (verbi di richiesta HTTP) che il dominio di origine può usare per una richiesta CORS. corda
allowedOrigins Domini di origine autorizzati a effettuare una richiesta al servizio tramite CORS. stringa (obbligatorio)
exposedHeaders Intestazioni di risposta che possono essere inviate nella risposta alla richiesta CORS ed esposte dal browser all'emittente della richiesta. corda
maxAgeInSeconds Periodo massimo di tempo in cui un browser deve memorizzare nella cache la richiesta OPTIONS preliminare. Int

Vincoli:
Valore minimo = 1
Valore massimo = 2147483647

DatabaseAccountCreateUpdatePropertiesOrDatabaseAccountGetProperties

Nome Descrizione Valore
apiProperties Proprietà specifiche dell'API. Attualmente, supportato solo per l'API MongoDB. ApiProperties
backupPolicy Oggetto che rappresenta i criteri per l'esecuzione di backup in un account. BackupPolicy
Funzionalità Elenco delle funzionalità di Cosmos DB per l'account funzionalità[]
connectorOffer Tipo di offerta del connettore cassandra per l'account C* del database Cosmos DB. 'Small'
consistencyPolicy Criteri di coerenza per l'account Cosmos DB. ConsistencyPolicy
cors Criteri CORS per l'account del database Cosmos DB. CorsPolicy[]
databaseAccountOfferType Tipo di offerta per il database 'Standard' (obbligatorio)
disableKeyBasedMetadataWriteAccess Disabilitare le operazioni di scrittura sulle risorse dei metadati (database, contenitori, velocità effettiva) tramite chiavi dell'account Bool
enableAnalyticalStorage Flag per indicare se abilitare l'analisi dell'archiviazione. Bool
enableAutomaticFailover Abilita il failover automatico dell'area di scrittura nel raro caso in cui l'area non sia disponibile a causa di un'interruzione del servizio. Il failover automatico comporterà una nuova area di scrittura per l'account e viene scelta in base alle priorità di failover configurate per l'account. Bool
enableCassandraConnector Abilita il connettore cassandra nell'account C* di Cosmos DB Bool
enableFreeTier Flag per indicare se il livello gratuito è abilitato. Bool
enableMultipleWriteLocations Consente all'account di scrivere in più posizioni Bool
ipRules Elenco di IpRules. IpAddressOrRange[]
isVirtualNetworkFilterEnabled Flag per indicare se abilitare o disabilitare le regole ACL di rete virtuale. Bool
keyVaultKeyUri URI dell'insieme di credenziali delle chiavi corda
Luoghi Matrice che contiene le posizioni di replica geografica abilitate per l'account Cosmos DB. percorso[] (obbligatorio)
virtualNetworkRules Elenco delle regole ACL di rete virtuale configurate per l'account Cosmos DB. VirtualNetworkRule[]

IpAddressOrRange

Nome Descrizione Valore
ipAddressOrRange Un singolo indirizzo IPv4 o un singolo intervallo di indirizzi IPv4 in formato CIDR. Gli indirizzi IP forniti devono essere formattati correttamente e non possono essere contenuti in uno degli intervalli seguenti: 10.0.0.0/8, 100.64.0.0/10, 172.16.0.0/12, 192.168.0.0.0/16, perché non sono applicabili dal filtro di indirizzi IP. Esempio di input validi: "23.40.210.245" o "23.40.210.0/8". corda

Ubicazione

Nome Descrizione Valore
failoverPriority Priorità di failover dell'area. Una priorità di failover pari a 0 indica un'area di scrittura. Valore massimo per una priorità di failover = (numero totale di aree - 1). I valori di priorità di failover devono essere univoci per ognuna delle aree in cui è presente l'account di database. Int

Vincoli:
Valore minimo = 0
isZoneRedundant Flag per indicare se questa area è un'area availabilityZone Bool
locationName Nome dell'area. corda

Microsoft.DocumentDB/databaseAccounts

Nome Descrizione Valore
apiVersion Versione dell'API '2020-09-01'
gentile Indica il tipo di account di database. Questa impostazione può essere impostata solo durante la creazione dell'account di database. 'GlobalDocumentDB'
'MongoDB'
'Parse'
ubicazione Posizione del gruppo di risorse a cui appartiene la risorsa. corda
nome Nome della risorsa corda

Vincoli:
Lunghezza minima = 3
Lunghezza massima = 3
Pattern = ^[a-z0-9]+(-[a-z0-9]+)* (obbligatorio)
proprietà Proprietà per creare e aggiornare gli account del database Azure Cosmos DB. DatabaseAccountCreateUpdatePropertiesOrDatabaseAccountGetProperties (obbligatorio)
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli
digitare Tipo di risorsa 'Microsoft.DocumentDB/databaseAccounts'

PeriodicModeBackupPolicy

Nome Descrizione Valore
periodicModeProperties Valori di configurazione per il backup in modalità periodica PeriodicModeProperties
digitare Descrive la modalità di backup. 'Periodico' (obbligatorio)

PeriodicModeProperties

Nome Descrizione Valore
backupIntervalInMinutes Intero che rappresenta l'intervallo in minuti tra due backup Int

Vincoli:
Valore minimo = 0
backupRetentionIntervalInHours Intero che rappresenta l'ora (in ore) di conservazione di ogni backup Int

Vincoli:
Valore minimo = 0

Tag

Nome Descrizione Valore

VirtualNetworkRule

Nome Descrizione Valore
Id ID risorsa di una subnet, ad esempio: /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}. corda
ignoreMissingVNetServiceEndpoint Creare una regola del firewall prima che la rete virtuale disponga dell'endpoint servizio di rete virtuale abilitato. Bool

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Sagoma Descrizione
'API SQL dell'account Azure Cosmos DB con l'archivio analitico

Distribuire in Azure
Questo modello crea un account Azure Cosmos per l'API Core (SQL) con un database e un contenitore configurati con l'archivio analitico.
account Azure Cosmos DB con app Web

Distribuire in Azure
Questo modello distribuisce un account Azure Cosmos DB, un piano di servizio app e crea un'app Web nel piano di servizio app. Aggiunge anche due impostazioni dell'applicazione all'app Web che fanno riferimento all'endpoint dell'account Azure Cosmos DB. In questo modo le soluzioni distribuite nell'app Web possono connettersi all'endpoint dell'account Azure Cosmos DB usando tali impostazioni.
CI/CD con Jenkins nel servizio Azure Container (AKS)

Distribuire in Azure
I contenitori semplificano la compilazione e la distribuzione continua delle applicazioni. Orchestrando la distribuzione di tali contenitori usando Kubernetes nel servizio Azure Container, è possibile ottenere cluster replicabili e gestibili di contenitori. Configurando una compilazione continua per produrre immagini e orchestrazioni del contenitore, è possibile aumentare la velocità e l'affidabilità della distribuzione.
Creare un account Cosmos DB con Microsoft Defender abilitato

Distribuire in Azure
Usando questo modello di Resource Manager, è possibile 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 per Azure Cosmos DB rileva potenziali attacchi SQL injection, attori malintenzionati noti basati su Microsoft Threat Intelligence, modelli di accesso sospetti e potenziali sfruttamento del database tramite identità compromesse o utenti malintenzionati.
Creare un account Azure Cosmos DB di livello gratuito

Distribuire in Azure
Questo modello crea un account Azure Cosmos DB di livello gratuito per l'API SQL con un database con velocità effettiva e contenitore condivisi.
Creare un account Azure Cosmos DB minimo per l'API Core (SQL)

Distribuire in Azure
Questo modello crea un account Azure Cosmos DB per l'API Core (SQL) specificando solo le proprietà minime necessarie per le risorse.
Creare un account Azure Cosmos DB serverless per l'API SQL

Distribuire in Azure
Questo modello crea un account Azure Cosmos DB serverless per l'API Core (SQL).
Creare un account Azure Cosmos senza tocco e un'app Web di Azure

Distribuire in Azure
Questo modello crea un account Azure Cosmos, inserisce l'endpoint e le chiavi di Cosmos DB nelle impostazioni dell'app Web di Azure e quindi distribuisce un'app Web ASP MVC da GitHub.
Creare un account Azure Cosmos per l'API MongoDB

Distribuire in Azure
Questo modello crea un account Azure Cosmos DB per l'API MongoDB 4.2 in due aree usando la velocità effettiva condivisa e dedicata con due raccolte.
Creare un account Azure Cosmos per la scalabilità automatica dell'API MongoDB

Distribuire in Azure
Questo modello crea un account Azure Cosmos DB per l'API MongoDB 4.2 in due aree usando la velocità effettiva di scalabilità automatica condivisa e dedicata.
Creare un account Azure Cosmos per l'API Tabella

Distribuire in Azure
Questo modello crea un account Azure Cosmos DB per l'API Tabella in due aree e una singola tabella con velocità effettiva con provisioning.
Creare un account Azure Cosmos per l'API Tabella con scalabilità automatica

Distribuire in Azure
Questo modello crea un account Azure Cosmos DB per l'API Tabella in due aree e una singola tabella con velocità effettiva di scalabilità automatica.
Creare un account Azure Cosmos DB per l'API Cassandra

Distribuire in Azure
Questo modello crea un account Azure Cosmos DB per l'API Cassandra in due aree con un keyspace e una tabella con velocità effettiva dedicata.
Creare un account Azure Cosmos DB per l'API Core (SQL)

Distribuire in Azure
Questo modello crea un account Azure Cosmos per l'API Core (SQL) con un database e un contenitore con velocità effettiva con più altre opzioni.
Creare un account Azure Cosmos DB per l'API Gremlin

Distribuire in Azure
Questo modello crea un account Azure Cosmos DB per l'API Gremlin in due aree con un database e un grafo usando la velocità effettiva dedicata.
Creare un account Azure Cosmos DB per la scalabilità automatica dell'API Gremlin

Distribuire in Azure
Questo modello crea un account Azure Cosmos DB per l'API Gremlin in due aree con un database e un grafo usando la velocità effettiva di scalabilità automatica.
Creare un account Azure Cosmos DB in più aree

Distribuire in Azure
Questo modello crea un account Azure Cosmos DB per qualsiasi tipo di API di database con un'area primaria e secondaria con la scelta del livello di coerenza e del tipo di failover.
Creare un'API SQL dell'account Azure Cosmos DB con scalabilità automatica

Distribuire in Azure
Questo modello crea un account Azure Cosmos per l'API Core (SQL) con un database e un contenitore con velocità effettiva con scalabilità automatica con più altre opzioni.
Creare un account Azure Cosmos DB con un endpoint privato

Distribuire in Azure
Questo modello creerà un account Cosmos, una rete virtuale e un endpoint privato che espone l'account Cosmos alla rete virtuale.
Creare un account SQL di Azure Cosmos DB con controllo degli accessi in base al ruolo del piano dati

Distribuire in Azure
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.
Creare un account Azure CosmosDB

Distribuire in Azure
Questo modello di Resource Manager ha lo scopo di creare rapidamente un account CosmosDB con i valori minimi necessari
Creare un account Azure Cosmos DB di scalabilità automatica per l'API Cassandra

Distribuire in Azure
Questo modello crea un account Azure Cosmos DB per l'API Cassandra in due aree con un keyspace e una tabella con velocità effettiva di scalabilità automatica.
Creare stored procedure dell'API Core (SQL) di Azure Cosmos DB

Distribuire in Azure
Questo modello crea un account Azure Cosmos DB per l'API Core (SQL) e un contenitore con una stored procedure, un trigger e una funzione definita dall'utente.
Creare Azure Cosmos con l'API SQL e più contenitori

Distribuire in Azure
Il modello crea un contenitore Cosmos con un'API SQL e consente di aggiungere contenitori mulitple.
Crea un'app di microservizi Dapr usando app contenitore

Distribuire in Azure
Creare un'app di microservizi Dapr usando App contenitore.
Crea un'app pub-sub-servicebus dapr usando app contenitore

Distribuire in Azure
Creare un'app pub-sub servicebus dapr usando App contenitore.
Distribuire Azure Data Explorer DB con la connessione di Cosmos DB

Distribuire in Azure
Distribuire Azure Data Explorer DB con la connessione Cosmos DB.
'app Web con un database SQL, Azure Cosmos DB, Ricerca di Azure

Distribuire in Azure
Questo modello effettua il provisioning di un'app Web, un database SQL, Azure Cosmos DB, Ricerca di Azure e Application Insights.

Definizione di risorsa Terraform (provider AzAPI)

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

  • gruppi di risorse

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

Formato risorsa

Per creare una risorsa Microsoft.DocumentDB/databaseAccounts, aggiungere il file Terraform seguente al modello.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DocumentDB/databaseAccounts@2020-09-01"
  name = "string"
  kind = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      apiProperties = {
        serverVersion = "string"
      }
      backupPolicy = {
        type = "string"
        // For remaining properties, see BackupPolicy objects
      }
      capabilities = [
        {
          name = "string"
        }
      ]
      connectorOffer = "string"
      consistencyPolicy = {
        defaultConsistencyLevel = "string"
        maxIntervalInSeconds = int
        maxStalenessPrefix = int
      }
      cors = [
        {
          allowedHeaders = "string"
          allowedMethods = "string"
          allowedOrigins = "string"
          exposedHeaders = "string"
          maxAgeInSeconds = int
        }
      ]
      databaseAccountOfferType = "Standard"
      disableKeyBasedMetadataWriteAccess = bool
      enableAnalyticalStorage = bool
      enableAutomaticFailover = bool
      enableCassandraConnector = bool
      enableFreeTier = bool
      enableMultipleWriteLocations = bool
      ipRules = [
        {
          ipAddressOrRange = "string"
        }
      ]
      isVirtualNetworkFilterEnabled = bool
      keyVaultKeyUri = "string"
      locations = [
        {
          failoverPriority = int
          isZoneRedundant = bool
          locationName = "string"
        }
      ]
      virtualNetworkRules = [
        {
          id = "string"
          ignoreMissingVNetServiceEndpoint = bool
        }
      ]
    }
  })
}

Oggetti BackupPolicy

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

Per continuo, usare:

{
  type = "Continuous"
}

Per periodico, usare:

{
  periodicModeProperties = {
    backupIntervalInMinutes = int
    backupRetentionIntervalInHours = int
  }
  type = "Periodic"
}

Valori delle proprietà

ApiProperties

Nome Descrizione Valore
serverVersion Descrive ServerVersion di un account MongoDB. '3.2'
'3.6'

BackupPolicy

Nome Descrizione Valore
digitare Impostare su "Continuous" per il tipo ContinuousModeBackupPolicy. Impostare su "Periodico" per il tipo PeriodicModeBackupPolicy. 'Continuous'
'Periodico' (obbligatorio)

Capacità

Nome Descrizione Valore
nome Nome della funzionalità di Cosmos DB. Ad esempio, "name": "EnableCassandra". I valori correnti includono anche "EnableTable" e "EnableGremlin". corda

ConsistencyPolicy

Nome Descrizione Valore
defaultConsistencyLevel Il livello di coerenza predefinito e le impostazioni di configurazione dell'account Cosmos DB. 'BoundedStaleness'
'ConsistentPrefix'
'Finale'
'Session'
'Strong' (obbligatorio)
maxIntervalInSeconds Se usato con il livello di coerenza decadimento ristretto, questo valore rappresenta la quantità di tempo di decadimento (in secondi) tollerata. L'intervallo accettato per questo valore è 5 - 86400. Obbligatorio quando defaultConsistencyPolicy è impostato su "BoundedStaleness". Int

Vincoli:
Valore minimo = 5
Valore massimo = 86400
maxStalenessPrefix Se usato con il livello di coerenza decadimento ristretto, questo valore rappresenta il numero di richieste non aggiornati tollerate. L'intervallo accettato per questo valore è 1 - 2.147.483.647. Obbligatorio quando defaultConsistencyPolicy è impostato su "BoundedStaleness". Int

Vincoli:
Valore minimo = 1
Valore massimo = 2147483647

ContinuousModeBackupPolicy

Nome Descrizione Valore
digitare Descrive la modalità di backup. 'Continuous' (obbligatorio)

CorsPolicy

Nome Descrizione Valore
allowedHeaders Intestazioni di richiesta che il dominio di origine può specificare nella richiesta CORS. corda
allowedMethods I metodi (verbi di richiesta HTTP) che il dominio di origine può usare per una richiesta CORS. corda
allowedOrigins Domini di origine autorizzati a effettuare una richiesta al servizio tramite CORS. stringa (obbligatorio)
exposedHeaders Intestazioni di risposta che possono essere inviate nella risposta alla richiesta CORS ed esposte dal browser all'emittente della richiesta. corda
maxAgeInSeconds Periodo massimo di tempo in cui un browser deve memorizzare nella cache la richiesta OPTIONS preliminare. Int

Vincoli:
Valore minimo = 1
Valore massimo = 2147483647

DatabaseAccountCreateUpdatePropertiesOrDatabaseAccountGetProperties

Nome Descrizione Valore
apiProperties Proprietà specifiche dell'API. Attualmente, supportato solo per l'API MongoDB. ApiProperties
backupPolicy Oggetto che rappresenta i criteri per l'esecuzione di backup in un account. BackupPolicy
Funzionalità Elenco delle funzionalità di Cosmos DB per l'account funzionalità[]
connectorOffer Tipo di offerta del connettore cassandra per l'account C* del database Cosmos DB. 'Small'
consistencyPolicy Criteri di coerenza per l'account Cosmos DB. ConsistencyPolicy
cors Criteri CORS per l'account del database Cosmos DB. CorsPolicy[]
databaseAccountOfferType Tipo di offerta per il database 'Standard' (obbligatorio)
disableKeyBasedMetadataWriteAccess Disabilitare le operazioni di scrittura sulle risorse dei metadati (database, contenitori, velocità effettiva) tramite chiavi dell'account Bool
enableAnalyticalStorage Flag per indicare se abilitare l'analisi dell'archiviazione. Bool
enableAutomaticFailover Abilita il failover automatico dell'area di scrittura nel raro caso in cui l'area non sia disponibile a causa di un'interruzione del servizio. Il failover automatico comporterà una nuova area di scrittura per l'account e viene scelta in base alle priorità di failover configurate per l'account. Bool
enableCassandraConnector Abilita il connettore cassandra nell'account C* di Cosmos DB Bool
enableFreeTier Flag per indicare se il livello gratuito è abilitato. Bool
enableMultipleWriteLocations Consente all'account di scrivere in più posizioni Bool
ipRules Elenco di IpRules. IpAddressOrRange[]
isVirtualNetworkFilterEnabled Flag per indicare se abilitare o disabilitare le regole ACL di rete virtuale. Bool
keyVaultKeyUri URI dell'insieme di credenziali delle chiavi corda
Luoghi Matrice che contiene le posizioni di replica geografica abilitate per l'account Cosmos DB. percorso[] (obbligatorio)
virtualNetworkRules Elenco delle regole ACL di rete virtuale configurate per l'account Cosmos DB. VirtualNetworkRule[]

IpAddressOrRange

Nome Descrizione Valore
ipAddressOrRange Un singolo indirizzo IPv4 o un singolo intervallo di indirizzi IPv4 in formato CIDR. Gli indirizzi IP forniti devono essere formattati correttamente e non possono essere contenuti in uno degli intervalli seguenti: 10.0.0.0/8, 100.64.0.0/10, 172.16.0.0/12, 192.168.0.0.0/16, perché non sono applicabili dal filtro di indirizzi IP. Esempio di input validi: "23.40.210.245" o "23.40.210.0/8". corda

Ubicazione

Nome Descrizione Valore
failoverPriority Priorità di failover dell'area. Una priorità di failover pari a 0 indica un'area di scrittura. Valore massimo per una priorità di failover = (numero totale di aree - 1). I valori di priorità di failover devono essere univoci per ognuna delle aree in cui è presente l'account di database. Int

Vincoli:
Valore minimo = 0
isZoneRedundant Flag per indicare se questa area è un'area availabilityZone Bool
locationName Nome dell'area. corda

Microsoft.DocumentDB/databaseAccounts

Nome Descrizione Valore
gentile Indica il tipo di account di database. Questa impostazione può essere impostata solo durante la creazione dell'account di database. 'GlobalDocumentDB'
'MongoDB'
'Parse'
ubicazione Posizione del gruppo di risorse a cui appartiene la risorsa. corda
nome Nome della risorsa corda

Vincoli:
Lunghezza minima = 3
Lunghezza massima = 3
Pattern = ^[a-z0-9]+(-[a-z0-9]+)* (obbligatorio)
proprietà Proprietà per creare e aggiornare gli account del database Azure Cosmos DB. DatabaseAccountCreateUpdatePropertiesOrDatabaseAccountGetProperties (obbligatorio)
Tag Tag delle risorse Dizionario di nomi e valori di tag.
digitare Tipo di risorsa "Microsoft.DocumentDB/databaseAccounts@2020-09-01"

PeriodicModeBackupPolicy

Nome Descrizione Valore
periodicModeProperties Valori di configurazione per il backup in modalità periodica PeriodicModeProperties
digitare Descrive la modalità di backup. 'Periodico' (obbligatorio)

PeriodicModeProperties

Nome Descrizione Valore
backupIntervalInMinutes Intero che rappresenta l'intervallo in minuti tra due backup Int

Vincoli:
Valore minimo = 0
backupRetentionIntervalInHours Intero che rappresenta l'ora (in ore) di conservazione di ogni backup Int

Vincoli:
Valore minimo = 0

Tag

Nome Descrizione Valore

VirtualNetworkRule

Nome Descrizione Valore
Id ID risorsa di una subnet, ad esempio: /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}. corda
ignoreMissingVNetServiceEndpoint Creare una regola del firewall prima che la rete virtuale disponga dell'endpoint servizio di rete virtuale abilitato. Bool