Condividi tramite


Database Microsoft.DocumentDBAccounts 2019-12-12

Definizione di risorsa Bicep

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

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

Formato di risorsa

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

resource symbolicname 'Microsoft.DocumentDB/databaseAccounts@2019-12-12' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  kind: 'string'
  properties: {
    capabilities: [
      {
        name: 'string'
      }
    ]
    connectorOffer: 'Small'
    consistencyPolicy: {
      defaultConsistencyLevel: 'string'
      maxIntervalInSeconds: int
      maxStalenessPrefix: int
    }
    databaseAccountOfferType: 'Standard'
    disableKeyBasedMetadataWriteAccess: bool
    enableAutomaticFailover: bool
    enableCassandraConnector: bool
    enableMultipleWriteLocations: bool
    ipRangeFilter: 'string'
    isVirtualNetworkFilterEnabled: bool
    keyVaultKeyUri: 'string'
    locations: [
      {
        failoverPriority: int
        isZoneRedundant: bool
        locationName: 'string'
      }
    ]
    virtualNetworkRules: [
      {
        id: 'string'
        ignoreMissingVNetServiceEndpoint: bool
      }
    ]
  }
}

Valori delle proprietà

databaseAccounts

Nome Descrizione valore
name Nome della risorsa stringa (obbligatorio)

Limite di caratteri: 3-44

Caratteri validi:
Lettere minuscole, numeri e trattini.

Deve iniziare con una lettera minuscola o un numero.

Il nome della risorsa deve essere univoco in Azure.
posizione Posizione del gruppo di risorse a cui appartiene la risorsa. string
tags I tag sono un elenco di coppie chiave-valore che descrivono la risorsa. Questi tag possono essere utilizzati nella visualizzazione e nel raggruppamento di questa risorsa (tra gruppi di risorse). È possibile specificare un massimo di 15 tag per una risorsa. Ogni tag deve avere una chiave non superiore a 128 caratteri con un valore che non superi i 256 caratteri. Ad esempio, l'esperienza predefinita per un tipo di modello è impostata con "defaultExperience": "Cassandra". I valori correnti "defaultExperience" includono anche "Table", "Graph", "DocumentDB" e "MongoDB". Dizionario di nomi e valori di tag. Vedere Tag nei modelli
kind Indica il tipo di account del database. Questa impostazione può essere impostata solo in fase di creazione dell'account di database. 'GlobalDocumentDB'
'MongoDB'
'Analizza'
properties Proprietà per creare e aggiornare gli account del database Azure Cosmos DB. DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou... (obbligatorio)

DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou...

Nome Descrizione Valore
capabilities 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
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
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
enableMultipleWriteLocations Consente all'account di scrivere in più posizioni bool
ipRangeFilter Supporto del firewall di Cosmos DB: questo valore specifica il set di indirizzi IP o intervalli di indirizzi IP nel formato CIDR da includere come elenco consentito di indirizzi IP client per un determinato account di database. Gli intervalli di indirizzi IP o i singoli indirizzi IP devono essere delimitati da virgole e non devono contenere spazi. string
isVirtualNetworkFilterEnabled Flag per indicare se abilitare/disabilitare le regole ACL di rete virtuale. bool
keyVaultKeyUri URI dell'insieme di credenziali delle chiavi string
locations Matrice che contiene le posizioni di replica geografica abilitate per l'account Cosmos DB. Location[] (obbligatorio)
virtualNetworkRules Elenco delle regole ACL di rete virtuale configurate per l'account Cosmos DB. VirtualNetworkRule[]

Funzionalità

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

ConsistencyPolicy

Nome Descrizione Valore
defaultConsistencyLevel Impostazioni di configurazione e livello di coerenza predefinite dell'account Cosmos DB. 'BoundedStaleness'
'ConsistentPrefix'
'Eventual'
'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 aggiornate tollerate. L'intervallo consentito per questo valore è compreso tra 1 e 2.147.483.647. Obbligatorio quando defaultConsistencyPolicy è impostato su "BoundedStaleness". INT

Vincoli:
Valore minimo = 1
Valore massimo = 2147483647

Location

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 ogni area in cui è presente l'account del database. INT

Vincoli:
Valore minimo = 0
isZoneRedundant Flag per indicare se questa area è un'area AvailabilityZone bool
locationName Il nome dell'area. string

VirtualNetworkRule

Nome Descrizione Valore
id ID risorsa di una subnet, ad esempio: /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}. string
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.

Modello Descrizione
CI/CD con Jenkins nel servizio Azure Container

Distribuisci 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 gestibili e gestibili di contenitori. Configurando una compilazione continua per produrre le immagini e l'orchestrazione dei contenitori, è possibile aumentare la velocità e l'affidabilità della distribuzione.
App Web con un database SQL, Azure Cosmos DB, Ricerca di Azure

Distribuisci in Azure
Questo modello effettua il provisioning di un'app Web, un database SQL, Azure Cosmos DB, Ricerca di Azure e Application Insights.
Creare un account Azure Cosmos DB per l'API Cassandra

Distribuisci 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 la scalabilità automatica per l'API Cassandra

Distribuisci 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 un account Azure CosmosDB

Distribuisci 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 in più aree

Distribuisci 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 account Azure Cosmos DB di livello gratuito

Distribuisci in Azure
Questo modello crea un account Azure Cosmos DB di livello gratuito per l'API SQL con un database con velocità effettiva condivisa e contenitore.
Creare un account Azure Cosmos DB per l'API Gremlin

Distribuisci 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

Distribuisci 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 per l'API MongoDB

Distribuisci 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

Distribuisci 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 DB con un endpoint privato

Distribuisci 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 Azure Cosmos DB per l'API Core (SQL)

Distribuisci 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.
API SQL dell'account Azure Cosmos DB con archivio analitico

Distribuisci 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.
Creare un'API SQL dell'account Azure Cosmos DB con scalabilità automatica

Distribuisci 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 stored procedure dell'API Core (SQL) di Azure Cosmos DB

Distribuisci 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 un account Azure Cosmos DB minimo per l'API Core (SQL)

Distribuisci 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 Azure Cosmos con l'API SQL e più contenitori

Distribuisci in Azure
Il modello crea un contenitore Cosmos con un'API SQL e consente di aggiungere contenitori mulitple.
Creare un account SQL di Azure Cosmos DB con il controllo degli accessi in base al ruolo del piano dati

Distribuisci 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 Cosmos DB serverless per l'API SQL

Distribuisci in Azure
Questo modello crea un account Azure Cosmos DB serverless per l'API Core (SQL).
Creare un account Azure Cosmos per l'API Tabella

Distribuisci 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

Distribuisci 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 senza tocco e un'app Web di Azure

Distribuisci 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 Cosmos DB con Microsoft Defender abilitato

Distribuisci 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.
Distribuire Azure Data Explorer DB con connessione Cosmos DB

Distribuisci in Azure
Distribuire Azure Data Explorer DB con la connessione Cosmos DB.
Account Azure Cosmos DB con app Web

Distribuisci 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.

Definizione di risorsa del modello di Resource Manager

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

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

Formato di risorsa

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

{
  "type": "Microsoft.DocumentDB/databaseAccounts",
  "apiVersion": "2019-12-12",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "kind": "string",
  "properties": {
    "capabilities": [
      {
        "name": "string"
      }
    ],
    "connectorOffer": "Small",
    "consistencyPolicy": {
      "defaultConsistencyLevel": "string",
      "maxIntervalInSeconds": "int",
      "maxStalenessPrefix": "int"
    },
    "databaseAccountOfferType": "Standard",
    "disableKeyBasedMetadataWriteAccess": "bool",
    "enableAutomaticFailover": "bool",
    "enableCassandraConnector": "bool",
    "enableMultipleWriteLocations": "bool",
    "ipRangeFilter": "string",
    "isVirtualNetworkFilterEnabled": "bool",
    "keyVaultKeyUri": "string",
    "locations": [
      {
        "failoverPriority": "int",
        "isZoneRedundant": "bool",
        "locationName": "string"
      }
    ],
    "virtualNetworkRules": [
      {
        "id": "string",
        "ignoreMissingVNetServiceEndpoint": "bool"
      }
    ]
  }
}

Valori delle proprietà

databaseAccounts

Nome Descrizione Valore
tipo Tipo di risorsa 'Microsoft.DocumentDB/databaseAccounts'
apiVersion Versione dell'API della risorsa '2019-12-12'
name Nome della risorsa stringa (obbligatoria)

Limite di caratteri: 3-44

Caratteri validi:
Lettere minuscole, numeri e trattini.

Deve iniziare con una lettera minuscola o un numero.

Il nome della risorsa deve essere univoco in Azure.
posizione Posizione del gruppo di risorse a cui appartiene la risorsa. string
tags I tag sono un elenco di coppie chiave-valore che descrivono la risorsa. Questi tag possono essere utilizzati nella visualizzazione e nel raggruppamento di questa risorsa (tra gruppi di risorse). È possibile specificare un massimo di 15 tag per una risorsa. Ogni tag deve avere una chiave non superiore a 128 caratteri con un valore che non superi i 256 caratteri. Ad esempio, l'esperienza predefinita per un tipo di modello è impostata con "defaultExperience": "Cassandra". I valori "defaultExperience" correnti includono anche "Table", "Graph", "DocumentDB" e "MongoDB". Dizionario dei nomi e dei valori dei tag. Vedere Tag nei modelli
kind Indica il tipo di account del database. Questa operazione può essere impostata solo alla creazione dell'account di database. 'GlobalDocumentDB'
'MongoDB'
'Analizza'
properties Proprietà per creare e aggiornare gli account di database di Azure Cosmos DB. DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou... (obbligatorio)

DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou...

Nome Descrizione Valore
capabilities 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'
coerenzaPolicy Criteri di coerenza per l'account Cosmos DB. CoerenzaPolicy
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
enableAutomaticFailover Abilita il failover automatico dell'area di scrittura nell'evento raro in cui l'area non è disponibile a causa di un'interruzione. Il failover automatico comporta 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
enableMultipleWriteLocations Consente all'account di scrivere in più posizioni bool
ipRangeFilter Supporto del firewall di Cosmos DB: questo valore specifica il set di indirizzi IP o intervalli di indirizzi IP nel formato CIDR da includere come elenco consentito di indirizzi IP client per un determinato account di database. Gli intervalli di indirizzi IP o i singoli indirizzi IP devono essere delimitati da virgole e non devono contenere spazi. string
isVirtualNetworkFilterEnabled Flag per indicare se abilitare/disabilitare le regole ACL della rete virtuale. bool
keyVaultKeyUri URI dell'insieme di credenziali delle chiavi string
locations Matrice che contiene le posizioni di georeplicazione abilitate per l'account Cosmos DB. Location[] (obbligatorio)
virtualNetworkRules Elenco delle regole ACL di rete virtuale configurate per l'account Cosmos DB. VirtualNetworkRule[]

Funzionalità

Nome Descrizione valore
name Nome della funzionalità Cosmos DB. Ad esempio, "name": "EnableCassandra". I valori correnti includono anche "EnableTable" e "EnableGremlin". string

CoerenzaPolicy

Nome Descrizione Valore
defaultConsistencyLevel Livello di coerenza e impostazioni di configurazione predefinite dell'account Cosmos DB. 'BoundedStaleness'
'ConsistentPrefix'
'Finale'
'Session'
'Strong' (obbligatorio)
maxIntervalInSeconds Se usato con il livello di coerenza non vincolato, questo valore rappresenta la quantità di tempo di stalezza (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 aggiornate tollerate. L'intervallo consentito per questo valore è compreso tra 1 e 2.147.483.647. Obbligatorio quando defaultConsistencyPolicy è impostato su "BoundedStaleness". INT

Vincoli:
Valore minimo = 1
Valore massimo = 2147483647

Location

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 ogni area in cui è presente l'account del database. INT

Vincoli:
Valore minimo = 0
isZoneRedundant Flag per indicare se questa area è un'area AvailabilityZone bool
locationName Il nome dell'area. string

VirtualNetworkRule

Nome Descrizione Valore
id ID risorsa di una subnet, ad esempio: /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}. string
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.

Modello Descrizione
CI/CD con Jenkins nel servizio Azure Container

Distribuisci 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 gestibili e gestibili di contenitori. Configurando una compilazione continua per produrre le immagini e l'orchestrazione dei contenitori, è possibile aumentare la velocità e l'affidabilità della distribuzione.
App Web con un database SQL, Azure Cosmos DB, Ricerca di Azure

Distribuisci in Azure
Questo modello effettua il provisioning di un'app Web, un database SQL, Azure Cosmos DB, Ricerca di Azure e Application Insights.
Creare un account Azure Cosmos DB per l'API Cassandra

Distribuisci 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 la scalabilità automatica per l'API Cassandra

Distribuisci 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 un account Azure CosmosDB

Distribuisci 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 in più aree

Distribuisci 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 account Azure Cosmos DB di livello gratuito

Distribuisci in Azure
Questo modello crea un account Azure Cosmos DB di livello gratuito per l'API SQL con un database con velocità effettiva condivisa e contenitore.
Creare un account Azure Cosmos DB per l'API Gremlin

Distribuisci 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

Distribuisci 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 per l'API MongoDB

Distribuisci 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

Distribuisci 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 DB con un endpoint privato

Distribuisci 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 Azure Cosmos DB per l'API Core (SQL)

Distribuisci 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.
API SQL dell'account Azure Cosmos DB con archivio analitico

Distribuisci 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.
Creare un'API SQL dell'account Azure Cosmos DB con scalabilità automatica

Distribuisci 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 stored procedure dell'API Core (SQL) di Azure Cosmos DB

Distribuisci 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 un account Azure Cosmos DB minimo per l'API Core (SQL)

Distribuisci 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 Azure Cosmos con l'API SQL e più contenitori

Distribuisci in Azure
Il modello crea un contenitore Cosmos con un'API SQL e consente di aggiungere contenitori mulitple.
Creare un account SQL di Azure Cosmos DB con il controllo degli accessi in base al ruolo del piano dati

Distribuisci 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 Cosmos DB serverless per l'API SQL

Distribuisci in Azure
Questo modello crea un account Azure Cosmos DB serverless per l'API Core (SQL).
Creare un account Azure Cosmos per l'API Tabella

Distribuisci 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

Distribuisci 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 senza tocco e un'app Web di Azure

Distribuisci 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 Cosmos DB con Microsoft Defender abilitato

Distribuisci 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.
Distribuire Azure Data Explorer DB con connessione Cosmos DB

Distribuisci in Azure
Distribuire Azure Data Explorer DB con la connessione Cosmos DB.
Account Azure Cosmos DB con app Web

Distribuisci 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.

Definizione della 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 di risorsa

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DocumentDB/databaseAccounts@2019-12-12"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      capabilities = [
        {
          name = "string"
        }
      ]
      connectorOffer = "Small"
      consistencyPolicy = {
        defaultConsistencyLevel = "string"
        maxIntervalInSeconds = int
        maxStalenessPrefix = int
      }
      databaseAccountOfferType = "Standard"
      disableKeyBasedMetadataWriteAccess = bool
      enableAutomaticFailover = bool
      enableCassandraConnector = bool
      enableMultipleWriteLocations = bool
      ipRangeFilter = "string"
      isVirtualNetworkFilterEnabled = bool
      keyVaultKeyUri = "string"
      locations = [
        {
          failoverPriority = int
          isZoneRedundant = bool
          locationName = "string"
        }
      ]
      virtualNetworkRules = [
        {
          id = "string"
          ignoreMissingVNetServiceEndpoint = bool
        }
      ]
    }
    kind = "string"
  })
}

Valori delle proprietà

databaseAccounts

Nome Descrizione Valore
tipo Tipo di risorsa "Microsoft.DocumentDB/databaseAccounts@2019-12-12"
name Nome della risorsa stringa (obbligatorio)

Limite di caratteri: 3-44

Caratteri validi:
Lettere minuscole, numeri e trattini.

Deve iniziare con una lettera minuscola o un numero.

Il nome della risorsa deve essere univoco in Azure.
posizione Posizione del gruppo di risorse a cui appartiene la risorsa. string
parent_id Per eseguire la distribuzione in un gruppo di risorse, usare l'ID del gruppo di risorse. stringa (obbligatorio)
tags I tag sono un elenco di coppie chiave-valore che descrivono la risorsa. Questi tag possono essere utilizzati nella visualizzazione e nel raggruppamento di questa risorsa (tra gruppi di risorse). È possibile specificare un massimo di 15 tag per una risorsa. Ogni tag deve avere una chiave non superiore a 128 caratteri con un valore che non superi i 256 caratteri. Ad esempio, l'esperienza predefinita per un tipo di modello è impostata con "defaultExperience": "Cassandra". I valori correnti "defaultExperience" includono anche "Table", "Graph", "DocumentDB" e "MongoDB". Dizionario di nomi e valori di tag.
kind Indica il tipo di account del database. Questa impostazione può essere impostata solo in fase di creazione dell'account di database. "GlobalDocumentDB"
"MongoDB"
"Analizza"
properties Proprietà per creare e aggiornare gli account del database Azure Cosmos DB. DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou... (obbligatorio)

DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou...

Nome Descrizione Valore
capabilities 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. "Piccolo"
consistencyPolicy Criteri di coerenza per l'account Cosmos DB. ConsistencyPolicy
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
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
enableMultipleWriteLocations Consente all'account di scrivere in più posizioni bool
ipRangeFilter Supporto del firewall di Cosmos DB: questo valore specifica il set di indirizzi IP o intervalli di indirizzi IP nel formato CIDR da includere come elenco consentito di indirizzi IP client per un determinato account di database. Gli intervalli di indirizzi IP o i singoli indirizzi IP devono essere delimitati da virgole e non devono contenere spazi. string
isVirtualNetworkFilterEnabled Flag per indicare se abilitare/disabilitare le regole ACL di rete virtuale. bool
keyVaultKeyUri URI dell'insieme di credenziali delle chiavi string
locations Matrice che contiene le posizioni di replica geografica abilitate per l'account Cosmos DB. Location[] (obbligatorio)
virtualNetworkRules Elenco delle regole ACL di rete virtuale configurate per l'account Cosmos DB. VirtualNetworkRule[]

Funzionalità

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

ConsistencyPolicy

Nome Descrizione Valore
defaultConsistencyLevel Impostazioni di configurazione e livello di coerenza predefinite dell'account Cosmos DB. "BoundedStaleness"
"ConsistentPrefix"
"Finale"
"Sessione"
"Forte" (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 aggiornate tollerate. L'intervallo consentito per questo valore è compreso tra 1 e 2.147.483.647. Obbligatorio quando defaultConsistencyPolicy è impostato su "BoundedStaleness". INT

Vincoli:
Valore minimo = 1
Valore massimo = 2147483647

Location

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 ogni area in cui è presente l'account del database. INT

Vincoli:
Valore minimo = 0
isZoneRedundant Flag per indicare se questa area è un'area AvailabilityZone bool
locationName Il nome dell'area. string

VirtualNetworkRule

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