Microsoft.DocumentDB-DatenbankKonten 2020-04-01

Bicep-Ressourcendefinition

Der Ressourcentyp databaseAccounts kann mit Vorgängen bereitgestellt werden, die Folgendes zum Ziel haben:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.DocumentDB/databaseAccounts-Ressource zu erstellen, fügen Sie der Vorlage den folgenden Bicep hinzu.

resource symbolicname 'Microsoft.DocumentDB/databaseAccounts@2020-04-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  kind: 'string'
  properties: {
    apiProperties: {
      serverVersion: 'string'
    }
    capabilities: [
      {
        name: 'string'
      }
    ]
    connectorOffer: 'Small'
    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
      }
    ]
  }
}

Eigenschaftswerte

databaseAccounts

Name BESCHREIBUNG Wert
name Der Ressourcenname Zeichenfolge (erforderlich)

Zeichenlimit: 3-44

Gültige Zeichen:
Kleinbuchstaben, Zahlen und Bindestriche.

Beginnen Sie mit einem Kleinbuchstaben oder einer Zahl.

Der Ressourcenname muss in Azure eindeutig sein.
location Der Speicherort der Ressourcengruppe, zu der die Ressource gehört. Zeichenfolge
tags Tags sind eine Liste von Schlüssel-Wert-Paaren, die die Ressource beschreiben. Diese Tags können über Ressourcengruppen hinweg zum Anzeigen und Gruppieren von Ressourcen verwendet werden. Für eine Ressource können maximal 15 Tags bereitgestellt werden. Der Schlüssel eines Tags darf nicht länger als 128 Zeichen und der Wert nicht länger als 256 Zeichen sein. Die Standardumgebung für einen Vorlagentyp ist beispielsweise mit "defaultExperience": "Cassandra" festgelegt. Zu den aktuellen "defaultExperience"-Werten gehören auch "Table", "Graph", "DocumentDB" und "MongoDB". Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
kind Gibt den Typ des Datenbankkontos an. Dies kann nur bei der Erstellung eines Datenbankkontos festgelegt werden. "GlobalDocumentDB"
"MongoDB"
"Analysieren"
properties Eigenschaften zum Erstellen und Aktualisieren von Azure Cosmos DB-Datenbankkonten. DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou... (erforderlich)

DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou...

Name BESCHREIBUNG Wert
apiProperties API-spezifische Eigenschaften. Derzeit nur für die MongoDB-API unterstützt. ApiProperties
capabilities Liste der Cosmos DB-Funktionen für das Konto Funktion[]
connectorOffer Der Cassandra-Connectorangebotstyp für das C*-Konto der Cosmos DB-Datenbank. "Klein"
consistencyPolicy Die Konsistenzrichtlinie für das Cosmos DB-Konto. ConsistencyPolicy
cors Die CORS-Richtlinie für das Cosmos DB-Datenbankkonto. CorsPolicy[]
databaseAccountOfferType Der Angebotstyp für die Datenbank "Standard" (erforderlich)
disableKeyBasedMetadataWriteAccess Deaktivieren von Schreibvorgängen für Metadatenressourcen (Datenbanken, Container, Durchsatz) über Kontoschlüssel bool
enableAnalyticalStorage Flag, um anzugeben, ob die Speicheranalyse aktiviert werden soll. bool
enableAutomaticFailover Aktiviert das automatische Failover der Schreibregion in dem seltenen Fall, dass die Region aufgrund eines Ausfalls nicht verfügbar ist. Das automatische Failover führt zu einer neuen Schreibregion für das Konto und wird basierend auf den für das Konto konfigurierten Failoverprioritäten ausgewählt. bool
enableCassandraConnector Aktiviert den Cassandra-Connector für das Cosmos DB-C*-Konto. bool
enableFreeTier Flag, um anzugeben, ob der Free-Tarif aktiviert ist. bool
enableMultipleWriteLocations Ermöglicht dem Konto das Schreiben an mehreren Speicherorten. bool
ipRules Liste der IpRules. IpAddressOrRange[]
isVirtualNetworkFilterEnabled Flag, um anzugeben, ob ACL-Regeln für virtuelle Netzwerke aktiviert/deaktiviert werden sollen. bool
keyVaultKeyUri Der URI des Schlüsseltresors Zeichenfolge
locations Ein Array, das die georeplizierungsspeicherorte enthält, die für das Cosmos DB-Konto aktiviert sind. Location[] (erforderlich)
virtualNetworkRules Liste der VNET-ACL-Regeln, die für das Cosmos DB-Konto konfiguriert sind. VirtualNetworkRule[]

ApiProperties

Name BESCHREIBUNG Wert
serverVersion Beschreibt die ServerVersion eines MongoDB-Kontos. '3.2'
'3.6'

Funktion

Name BESCHREIBUNG Wert
name Name der Cosmos DB-Funktion. Beispiel: "name": "EnableCassandra". Zu den aktuellen Werten gehören auch "EnableTable" und "EnableGremlin". Zeichenfolge

ConsistencyPolicy

Name BESCHREIBUNG Wert
defaultConsistencyLevel Die Standardkonsistenzebene und die Konfigurationseinstellungen des Cosmos DB-Kontos. "BoundedStaleness"
"ConsistentPrefix"
"Letztlich"
"Sitzung"
"Strong" (erforderlich)
maxIntervalInSeconds Bei Verwendung mit der Konsistenzebene "Begrenzte Veraltung" stellt dieser Wert den Zeitraum der Veraltung (in Sekunden) dar, der toleriert wird. Der zulässige Bereich für diesen Wert ist 5 bis 86400. Erforderlich, wenn defaultConsistencyPolicy auf "BoundedStaleness" festgelegt ist. INT

Einschränkungen:
Minimaler Wert = 5
Max. Wert = 86400
maxStalenessPrefix Bei Verwendung mit der Konsistenzebene "Begrenzte Veraltung" stellt dieser Wert die Anzahl veralteter Anforderungen dar, die toleriert werden. Für diesen Wert ist ein Bereich von 1 bis 2.147.483.647 zulässig. Erforderlich, wenn defaultConsistencyPolicy auf "BoundedStaleness" festgelegt ist. INT

Einschränkungen:
Minimaler Wert = 1
Max. Wert = 2147483647

CorsPolicy

Name BESCHREIBUNG Wert
allowedHeaders Die Anforderungsheader, die die Ursprungsdomäne für die CORS-Anforderung angeben kann. Zeichenfolge
allowedMethods Die Methoden (HTTP-Anforderungsverben), die die Ursprungsdomäne für eine CORS-Anforderung verwenden kann. Zeichenfolge
allowedOrigins Die Ursprungsdomänen, die über CORS eine Anforderung an den Dienst stellen dürfen. Zeichenfolge (erforderlich)
exposedHeaders Die Antwortheader, die in der Antwort an die CORS-Anforderung gesendet und vom Browser gegenüber dem Anforderungsaussteller verfügbar gemacht werden können. Zeichenfolge
maxAgeInSeconds Die maximale Zeit, über die die OPTIONS-Preflight-Anforderung vom Browser zwischengespeichert werden soll. INT

Einschränkungen:
Minimaler Wert = 1
Max. Wert = 2147483647

IpAddressOrRange

Name BESCHREIBUNG Wert
ipAddressOrRange Eine einzelne IPv4-Adresse oder ein einzelner IPv4-Adressbereich im CIDR-Format. Bereitgestellte IP-Adressen müssen gut formatiert sein und können nicht in einem der folgenden Bereiche enthalten sein: 10.0.0.0/8, 100.64.0.0/10, 172.16.0.0/12, 192.168.0.0/16, da diese durch den IP-Adressfilter nicht durchsetzbar sind. Beispiel für gültige Eingaben: "23.40.210.245" oder "23.40.210.0/8". Zeichenfolge

Standort

Name BESCHREIBUNG Wert
failoverPriority Die Failoverpriorität der Region. Eine Failoverpriorität von 0 gibt einen Schreibbereich an. Der maximale Wert für eine Failoverpriorität = (Gesamtanzahl der Regionen - 1). Failoverprioritätswerte müssen für jede Region, in der das Datenbankkonto vorhanden ist, eindeutig sein. INT

Einschränkungen:
Minimaler Wert = 0
isZoneRedundant Flag, um anzugeben, ob es sich bei dieser Region um eine AvailabilityZone-Region handelt bool
locationName Der Name der Region. Zeichenfolge

VirtualNetworkRule

Name BESCHREIBUNG Wert
id Ressourcen-ID eines Subnetzes, z. B.: /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}. Zeichenfolge
ignoreMissingVNetServiceEndpoint Erstellen Sie eine Firewallregel, bevor der VNET-Dienstendpunkt für das virtuelle Netzwerk aktiviert ist. bool

Schnellstartvorlagen

In den folgenden Schnellstartvorlagen wird dieser Ressourcentyp bereitgestellt.

Vorlage BESCHREIBUNG
CI/CD mit Jenkins in Azure Container Service (AKS)

Bereitstellen in Azure
Container vereinfachen sehr die kontinuierliche Erstellung und Bereitstellung Ihrer Anwendungen. Wenn Sie die Bereitstellung dieser Container mithilfe von Kubernetes in Azure Container Service orchestrieren, können Sie replizierbare, verwaltbare Cluster von Containern erreichen. Durch Einrichten eines kontinuierlichen Builds zur Erstellung Ihrer Containerimages und -orchestrierung können Sie die Geschwindigkeit und Zuverlässigkeit Ihrer Bereitstellung erhöhen.
Web-App mit EINER SQL-Datenbank, Azure Cosmos DB, Azure Search

Bereitstellen in Azure
Diese Vorlage stellt eine Web-App, eine SQL-Datenbank, Azure Cosmos DB, Azure Search und Application Insights bereit.
Erstellen eines Azure Cosmos DB-Kontos für die Cassandra-API

Bereitstellen in Azure
Mit dieser Vorlage wird ein Azure Cosmos DB-Konto für die Cassandra-API in zwei Regionen mit einem Keyspace und einer Tabelle mit dediziertem Durchsatz erstellt.
Erstellen eines Azure Cosmos DB-Kontos mit automatischer Skalierung für die Cassandra-API

Bereitstellen in Azure
Diese Vorlage erstellt ein Azure Cosmos DB-Konto für die Cassandra-API in zwei Regionen mit einem Keyspace und einer Tabelle mit automatischem Skalierungsdurchsatz.
Erstellen eines Azure CosmosDB-Kontos

Bereitstellen in Azure
Diese ARM-Vorlage soll schnell ein CosmosDB-Konto mit den minimal erforderlichen Werten erstellen.
Erstellen eines Azure Cosmos DB-Kontos in mehreren Regionen

Bereitstellen in Azure
Diese Vorlage erstellt ein Azure Cosmos DB-Konto für jeden Datenbank-API-Typ mit einer primären und sekundären Region mit auswahl von Konsistenzebene und Failovertyp.
Erstellen eines Azure Cosmos DB-Kontos im Free-Tarif

Bereitstellen in Azure
Mit dieser Vorlage wird ein Azure Cosmos DB-Konto im freien Tarif für die SQL-API mit einer Datenbank mit freigegebenem Durchsatz und Container erstellt.
Erstellen eines Azure Cosmos DB-Kontos für die Gremlin-API

Bereitstellen in Azure
Mit dieser Vorlage wird ein Azure Cosmos DB-Konto für die Gremlin-API in zwei Regionen mit einer Datenbank und einem Graphen mit dediziertem Durchsatz erstellt.
Erstellen eines Azure Cosmos DB-Kontos für die automatische Gremlin-API-Skalierung

Bereitstellen in Azure
Diese Vorlage erstellt ein Azure Cosmos DB-Konto für die Gremlin-API in zwei Regionen mit einer Datenbank und einem Graphen unter Verwendung des automatischen Skalierungsdurchsatzes.
Erstellen eines Azure Cosmos-Kontos für die MongoDB-API

Bereitstellen in Azure
Diese Vorlage erstellt ein Azure Cosmos DB-Konto für die MongoDB-API 4.2 in zwei Regionen mit freigegebenem und dediziertem Durchsatz mit zwei Sammlungen.
Erstellen eines Azure Cosmos-Kontos für die automatische Skalierung der MongoDB-API

Bereitstellen in Azure
Mit dieser Vorlage wird ein Azure Cosmos DB-Konto für die MongoDB-API 4.2 in zwei Regionen mit freigegebenem und dediziertem Durchsatz für die autoskalierte Skalierung erstellt.
Erstellen eines Azure Cosmos DB-Kontos mit einem privaten Endpunkt

Bereitstellen in Azure
Diese Vorlage erstellt ein Cosmos-Konto, ein virtuelles Netzwerk und einen privaten Endpunkt, wodurch das Cosmos-Konto für das virtuelle Netzwerk verfügbar gemacht wird.
Erstellen eines Azure Cosmos DB-Kontos für die Core-API (SQL)

Bereitstellen in Azure
Mit dieser Vorlage wird ein Azure Cosmos-Konto für die Core-API (SQL) mit einer Datenbank und einem Container mit Durchsatz mit mehreren anderen Optionen erstellt.
SQL-API für Azure Cosmos DB-Konten mit Analysespeicher

Bereitstellen in Azure
Mit dieser Vorlage wird ein Azure Cosmos-Konto für die CORE-API (SQL) mit einer Datenbank und einem Container erstellt, die mit einem Analysespeicher konfiguriert sind.
Erstellen einer SQL-API für ein Azure Cosmos DB-Konto mit Autoskalierung

Bereitstellen in Azure
Mit dieser Vorlage wird ein Azure Cosmos-Konto für die Core-API (SQL) mit einer Datenbank und einem Container mit automatisch skaliertem Durchsatz mit mehreren anderen Optionen erstellt.
Erstellen gespeicherter Prozeduren der Azure Cosmos DB Core-API (SQL)

Bereitstellen in Azure
Mit dieser Vorlage werden ein Azure Cosmos DB-Konto für die Core-API (SQL) und ein Container mit einer gespeicherten Prozedur, einem Trigger und einer benutzerdefinierten Funktion erstellt.
Erstellen eines minimalen Azure Cosmos DB-Kontos für die Core-API (SQL)

Bereitstellen in Azure
Diese Vorlage erstellt ein Azure Cosmos DB-Konto für die Core-API (SQL) und gibt dabei nur die minimal erforderlichen Ressourceneigenschaften an.
Erstellen von Azure Cosmos mit SQL-API und mehreren Containern

Bereitstellen in Azure
Die Vorlage erstellt einen Cosmos-Container mit einer SQL-API und ermöglicht das Hinzufügen von mehreren Containern.
Erstellen eines Azure Cosmos DB-SQL-Kontos mit RBAC auf Datenebene

Bereitstellen in Azure
Mit dieser Vorlage wird ein SQL Cosmos-Konto erstellt, eine nativ gepflegte Rollendefinition und eine nativ gepflegte Rollenzuweisung für eine AAD-Identität.
Erstellen eines serverlosen Azure Cosmos DB-Kontos für die SQL-API

Bereitstellen in Azure
Mit dieser Vorlage wird ein serverloses Azure Cosmos DB-Konto für die Core-API (SQL) erstellt.
Erstellen eines Azure Cosmos-Kontos für die Tabellen-API

Bereitstellen in Azure
Mit dieser Vorlage wird ein Azure Cosmos DB-Konto für die Tabellen-API in zwei Regionen und eine einzelne Tabelle mit bereitgestelltem Durchsatz erstellt.
Erstellen eines Azure Cosmos-Kontos für die Tabellen-API mit automatischer Skalierung

Bereitstellen in Azure
Diese Vorlage erstellt ein Azure Cosmos DB-Konto für die Tabellen-API in zwei Regionen und eine einzelne Tabelle mit automatischem Skalierungsdurchsatz.
Erstellen eines Azure Cosmos-Kontos und einer Azure-Web-App

Bereitstellen in Azure
Diese Vorlage erstellt ein Azure Cosmos-Konto, fügt den Cosmos DB-Endpunkt und die Schlüssel in die Azure-Web-App-Einstellungen ein und stellt dann eine ASP MVC-Web-App von GitHub bereit.
Erstellen eines Cosmos DB-Kontos mit aktiviertem Microsoft Defender

Bereitstellen in Azure
Mit dieser ARM-Vorlage können Sie ein Azure Cosmos DB-Konto bereitstellen, bei dem Microsoft Defender für Azure Cosmos DB aktiviert ist. Microsoft Defender für Azure Cosmos DB ist eine in Azure native Sicherheitsebene, die Versuche erkennt, Datenbanken in Ihren Azure Cosmos DB-Konten auszunutzen. Microsoft Defender für Azure Cosmos DB erkennt potenzielle SQL-Einschleusungen, bekannte schlechte Akteure basierend auf Microsoft Threat Intelligence, verdächtige Zugriffsmuster und potenzielle Ausnutzungen Ihrer Datenbank durch kompromittierte Identitäten oder böswillige Insider.
Bereitstellen von Azure Data Explorer DB mit Cosmos DB-Verbindung

Bereitstellen in Azure
Bereitstellen von Azure Data Explorer DB mit Cosmos DB-Verbindung
Azure Cosmos DB-Konto mit Web-App

Bereitstellen in Azure
Diese Vorlage stellt ein Azure Cosmos DB-Konto und einen App Service-Plan bereit und erstellt eine Web-App im App Service-Plan. Außerdem werden der Web-App zwei Anwendungseinstellungen hinzugefügt, die auf den Azure Cosmos DB-Kontoendpunkt verweisen. Auf diese Weise können lösungen, die in der Web-App bereitgestellt werden, mithilfe dieser Einstellungen eine Verbindung mit dem Azure Cosmos DB-Kontoendpunkt herstellen.

Ressourcendefinition mit einer ARM-Vorlage

Der Ressourcentyp databaseAccounts kann mit Vorgängen bereitgestellt werden, die Folgendes zum Ziel haben:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.DocumentDB/databaseAccounts-Ressource zu erstellen, fügen Sie der Vorlage den folgenden JSON-Code hinzu.

{
  "type": "Microsoft.DocumentDB/databaseAccounts",
  "apiVersion": "2020-04-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "kind": "string",
  "properties": {
    "apiProperties": {
      "serverVersion": "string"
    },
    "capabilities": [
      {
        "name": "string"
      }
    ],
    "connectorOffer": "Small",
    "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"
      }
    ]
  }
}

Eigenschaftswerte

databaseAccounts

Name BESCHREIBUNG Wert
type Ressourcentyp "Microsoft.DocumentDB/databaseAccounts"
apiVersion Die Ressourcen-API-Version '2020-04-01'
name Der Ressourcenname Zeichenfolge (erforderlich)

Zeichenlimit: 3-44

Gültige Zeichen:
Kleinbuchstaben, Zahlen und Bindestriche.

Beginnen Sie mit einem Kleinbuchstaben oder einer Zahl.

Der Ressourcenname muss in Azure eindeutig sein.
location Der Speicherort der Ressourcengruppe, zu der die Ressource gehört. Zeichenfolge
tags Tags sind eine Liste von Schlüssel-Wert-Paaren, die die Ressource beschreiben. Diese Tags können über Ressourcengruppen hinweg zum Anzeigen und Gruppieren von Ressourcen verwendet werden. Für eine Ressource können maximal 15 Tags bereitgestellt werden. Der Schlüssel eines Tags darf nicht länger als 128 Zeichen und der Wert nicht länger als 256 Zeichen sein. Die Standardumgebung für einen Vorlagentyp ist beispielsweise mit "defaultExperience": "Cassandra" festgelegt. Zu den aktuellen "defaultExperience"-Werten gehören auch "Table", "Graph", "DocumentDB" und "MongoDB". Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
kind Gibt den Typ des Datenbankkontos an. Dies kann nur bei der Erstellung eines Datenbankkontos festgelegt werden. "GlobalDocumentDB"
"MongoDB"
"Analysieren"
properties Eigenschaften zum Erstellen und Aktualisieren von Azure Cosmos DB-Datenbankkonten. DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou... (erforderlich)

DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou...

Name BESCHREIBUNG Wert
apiProperties API-spezifische Eigenschaften. Derzeit nur für die MongoDB-API unterstützt. ApiProperties
capabilities Liste der Cosmos DB-Funktionen für das Konto Funktion[]
connectorOffer Der Cassandra-Connectorangebotstyp für das C*-Konto der Cosmos DB-Datenbank. "Klein"
consistencyPolicy Die Konsistenzrichtlinie für das Cosmos DB-Konto. ConsistencyPolicy
cors Die CORS-Richtlinie für das Cosmos DB-Datenbankkonto. CorsPolicy[]
databaseAccountOfferType Der Angebotstyp für die Datenbank "Standard" (erforderlich)
disableKeyBasedMetadataWriteAccess Deaktivieren von Schreibvorgängen für Metadatenressourcen (Datenbanken, Container, Durchsatz) über Kontoschlüssel bool
enableAnalyticalStorage Flag, um anzugeben, ob die Speicheranalyse aktiviert werden soll. bool
enableAutomaticFailover Aktiviert das automatische Failover der Schreibregion in dem seltenen Fall, dass die Region aufgrund eines Ausfalls nicht verfügbar ist. Das automatische Failover führt zu einer neuen Schreibregion für das Konto und wird basierend auf den für das Konto konfigurierten Failoverprioritäten ausgewählt. bool
enableCassandraConnector Aktiviert den Cassandra-Connector für das Cosmos DB-C*-Konto. bool
enableFreeTier Flag, um anzugeben, ob der Free-Tarif aktiviert ist. bool
enableMultipleWriteLocations Ermöglicht dem Konto das Schreiben an mehreren Speicherorten. bool
ipRules Liste der IpRules. IpAddressOrRange[]
isVirtualNetworkFilterEnabled Flag, um anzugeben, ob ACL-Regeln für virtuelle Netzwerke aktiviert/deaktiviert werden sollen. bool
keyVaultKeyUri Der URI des Schlüsseltresors Zeichenfolge
locations Ein Array, das die georeplizierungsspeicherorte enthält, die für das Cosmos DB-Konto aktiviert sind. Location[] (erforderlich)
virtualNetworkRules Liste der VNET-ACL-Regeln, die für das Cosmos DB-Konto konfiguriert sind. VirtualNetworkRule[]

ApiProperties

Name BESCHREIBUNG Wert
serverVersion Beschreibt die ServerVersion eines MongoDB-Kontos. '3.2'
'3.6'

Funktion

Name BESCHREIBUNG Wert
name Name der Cosmos DB-Funktion. Beispiel: "name": "EnableCassandra". Zu den aktuellen Werten gehören auch "EnableTable" und "EnableGremlin". Zeichenfolge

ConsistencyPolicy

Name BESCHREIBUNG Wert
defaultConsistencyLevel Die Standardkonsistenzebene und die Konfigurationseinstellungen des Cosmos DB-Kontos. "BoundedStaleness"
"ConsistentPrefix"
"Letztlich"
"Sitzung"
"Strong" (erforderlich)
maxIntervalInSeconds Bei Verwendung mit der Konsistenzebene "Begrenzte Veraltung" stellt dieser Wert den Zeitraum der Veraltung (in Sekunden) dar, der toleriert wird. Der zulässige Bereich für diesen Wert ist 5 bis 86400. Erforderlich, wenn defaultConsistencyPolicy auf "BoundedStaleness" festgelegt ist. INT

Einschränkungen:
Minimaler Wert = 5
Max. Wert = 86400
maxStalenessPrefix Bei Verwendung mit der Konsistenzebene "Begrenzte Veraltung" stellt dieser Wert die Anzahl veralteter Anforderungen dar, die toleriert werden. Für diesen Wert ist ein Bereich von 1 bis 2.147.483.647 zulässig. Erforderlich, wenn defaultConsistencyPolicy auf "BoundedStaleness" festgelegt ist. INT

Einschränkungen:
Minimaler Wert = 1
Max. Wert = 2147483647

CorsPolicy

Name BESCHREIBUNG Wert
allowedHeaders Die Anforderungsheader, die die Ursprungsdomäne für die CORS-Anforderung angeben kann. Zeichenfolge
allowedMethods Die Methoden (HTTP-Anforderungsverben), die die Ursprungsdomäne für eine CORS-Anforderung verwenden kann. Zeichenfolge
allowedOrigins Die Ursprungsdomänen, die über CORS eine Anforderung an den Dienst stellen dürfen. Zeichenfolge (erforderlich)
exposedHeaders Die Antwortheader, die in der Antwort an die CORS-Anforderung gesendet und vom Browser gegenüber dem Anforderungsaussteller verfügbar gemacht werden können. Zeichenfolge
maxAgeInSeconds Die maximale Zeit, über die die OPTIONS-Preflight-Anforderung vom Browser zwischengespeichert werden soll. INT

Einschränkungen:
Minimaler Wert = 1
Max. Wert = 2147483647

IpAddressOrRange

Name BESCHREIBUNG Wert
ipAddressOrRange Eine einzelne IPv4-Adresse oder ein einzelner IPv4-Adressbereich im CIDR-Format. Bereitgestellte IP-Adressen müssen gut formatiert sein und können nicht in einem der folgenden Bereiche enthalten sein: 10.0.0.0/8, 100.64.0.0/10, 172.16.0.0/12, 192.168.0.0/16, da diese durch den IP-Adressfilter nicht durchsetzbar sind. Beispiel für gültige Eingaben: "23.40.210.245" oder "23.40.210.0/8". Zeichenfolge

Standort

Name BESCHREIBUNG Wert
failoverPriority Die Failoverpriorität der Region. Eine Failoverpriorität von 0 gibt einen Schreibbereich an. Der maximale Wert für eine Failoverpriorität = (Gesamtanzahl der Regionen - 1). Failoverprioritätswerte müssen für jede Region, in der das Datenbankkonto vorhanden ist, eindeutig sein. INT

Einschränkungen:
Minimaler Wert = 0
isZoneRedundant Flag, um anzugeben, ob es sich bei dieser Region um eine AvailabilityZone-Region handelt bool
locationName Der Name der Region. Zeichenfolge

VirtualNetworkRule

Name BESCHREIBUNG Wert
id Ressourcen-ID eines Subnetzes, z. B.: /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}. Zeichenfolge
ignoreMissingVNetServiceEndpoint Erstellen Sie eine Firewallregel, bevor der VNET-Dienstendpunkt für das virtuelle Netzwerk aktiviert ist. bool

Schnellstartvorlagen

In den folgenden Schnellstartvorlagen wird dieser Ressourcentyp bereitgestellt.

Vorlage BESCHREIBUNG
CI/CD mit Jenkins in Azure Container Service (AKS)

Bereitstellen in Azure
Container vereinfachen sehr die kontinuierliche Erstellung und Bereitstellung Ihrer Anwendungen. Wenn Sie die Bereitstellung dieser Container mithilfe von Kubernetes in Azure Container Service orchestrieren, können Sie replizierbare, verwaltbare Cluster von Containern erreichen. Durch Einrichten eines kontinuierlichen Builds zur Erstellung Ihrer Containerimages und -orchestrierung können Sie die Geschwindigkeit und Zuverlässigkeit Ihrer Bereitstellung erhöhen.
Web-App mit EINER SQL-Datenbank, Azure Cosmos DB, Azure Search

Bereitstellen in Azure
Diese Vorlage stellt eine Web-App, eine SQL-Datenbank, Azure Cosmos DB, Azure Search und Application Insights bereit.
Erstellen eines Azure Cosmos DB-Kontos für die Cassandra-API

Bereitstellen in Azure
Mit dieser Vorlage wird ein Azure Cosmos DB-Konto für die Cassandra-API in zwei Regionen mit einem Keyspace und einer Tabelle mit dediziertem Durchsatz erstellt.
Erstellen eines Azure Cosmos DB-Kontos mit automatischer Skalierung für die Cassandra-API

Bereitstellen in Azure
Diese Vorlage erstellt ein Azure Cosmos DB-Konto für die Cassandra-API in zwei Regionen mit einem Keyspace und einer Tabelle mit automatischem Skalierungsdurchsatz.
Erstellen eines Azure CosmosDB-Kontos

Bereitstellen in Azure
Diese ARM-Vorlage soll schnell ein CosmosDB-Konto mit den minimal erforderlichen Werten erstellen.
Erstellen eines Azure Cosmos DB-Kontos in mehreren Regionen

Bereitstellen in Azure
Diese Vorlage erstellt ein Azure Cosmos DB-Konto für jeden Datenbank-API-Typ mit einer primären und sekundären Region mit auswahl von Konsistenzebene und Failovertyp.
Erstellen eines Azure Cosmos DB-Kontos im Free-Tarif

Bereitstellen in Azure
Mit dieser Vorlage wird ein Azure Cosmos DB-Konto im freien Tarif für die SQL-API mit einer Datenbank mit freigegebenem Durchsatz und Container erstellt.
Erstellen eines Azure Cosmos DB-Kontos für die Gremlin-API

Bereitstellen in Azure
Mit dieser Vorlage wird ein Azure Cosmos DB-Konto für die Gremlin-API in zwei Regionen mit einer Datenbank und einem Graphen mit dediziertem Durchsatz erstellt.
Erstellen eines Azure Cosmos DB-Kontos für die automatische Gremlin-API-Skalierung

Bereitstellen in Azure
Diese Vorlage erstellt ein Azure Cosmos DB-Konto für die Gremlin-API in zwei Regionen mit einer Datenbank und einem Graphen unter Verwendung des automatischen Skalierungsdurchsatzes.
Erstellen eines Azure Cosmos-Kontos für die MongoDB-API

Bereitstellen in Azure
Diese Vorlage erstellt ein Azure Cosmos DB-Konto für die MongoDB-API 4.2 in zwei Regionen mit freigegebenem und dediziertem Durchsatz mit zwei Sammlungen.
Erstellen eines Azure Cosmos-Kontos für die automatische Skalierung der MongoDB-API

Bereitstellen in Azure
Mit dieser Vorlage wird ein Azure Cosmos DB-Konto für die MongoDB-API 4.2 in zwei Regionen mit freigegebenem und dediziertem Durchsatz für die autoskalierte Skalierung erstellt.
Erstellen eines Azure Cosmos DB-Kontos mit einem privaten Endpunkt

Bereitstellen in Azure
Diese Vorlage erstellt ein Cosmos-Konto, ein virtuelles Netzwerk und einen privaten Endpunkt, wodurch das Cosmos-Konto für das virtuelle Netzwerk verfügbar gemacht wird.
Erstellen eines Azure Cosmos DB-Kontos für die Core-API (SQL)

Bereitstellen in Azure
Mit dieser Vorlage wird ein Azure Cosmos-Konto für die Core-API (SQL) mit einer Datenbank und einem Container mit Durchsatz mit mehreren anderen Optionen erstellt.
SQL-API für Azure Cosmos DB-Konten mit Analysespeicher

Bereitstellen in Azure
Mit dieser Vorlage wird ein Azure Cosmos-Konto für die CORE-API (SQL) mit einer Datenbank und einem Container erstellt, die mit einem Analysespeicher konfiguriert sind.
Erstellen einer SQL-API für ein Azure Cosmos DB-Konto mit Autoskalierung

Bereitstellen in Azure
Mit dieser Vorlage wird ein Azure Cosmos-Konto für die Core-API (SQL) mit einer Datenbank und einem Container mit automatisch skaliertem Durchsatz mit mehreren anderen Optionen erstellt.
Erstellen gespeicherter Prozeduren der Azure Cosmos DB Core-API (SQL)

Bereitstellen in Azure
Mit dieser Vorlage werden ein Azure Cosmos DB-Konto für die Core-API (SQL) und ein Container mit einer gespeicherten Prozedur, einem Trigger und einer benutzerdefinierten Funktion erstellt.
Erstellen eines minimalen Azure Cosmos DB-Kontos für die Core-API (SQL)

Bereitstellen in Azure
Mit dieser Vorlage wird ein Azure Cosmos DB-Konto für die Core-API (SQL) erstellt, wobei nur die minimal erforderlichen Ressourceneigenschaften angegeben werden.
Erstellen von Azure Cosmos mit der SQL-API und mehreren Containern

Bereitstellen in Azure
Die Vorlage erstellt einen Cosmos-Container mit einer SQL-API und ermöglicht das Hinzufügen von multiitple Containern.
Erstellen eines Azure Cosmos DB-SQL-Kontos mit RBAC auf Datenebene

Bereitstellen in Azure
Mit dieser Vorlage wird ein SQL Cosmos-Konto erstellt, eine nativ gepflegte Rollendefinition und eine nativ gepflegte Rollenzuweisung für eine AAD-Identität.
Erstellen eines serverlosen Azure Cosmos DB-Kontos für die SQL-API

Bereitstellen in Azure
Mit dieser Vorlage wird ein serverloses Azure Cosmos DB-Konto für die Core-API (SQL) erstellt.
Erstellen eines Azure Cosmos-Kontos für die Tabellen-API

Bereitstellen in Azure
Diese Vorlage erstellt ein Azure Cosmos DB-Konto für die Tabellen-API in zwei Regionen und eine einzelne Tabelle mit bereitgestelltem Durchsatz.
Erstellen eines Azure Cosmos-Kontos für die Tabellen-API mit automatischer Skalierung

Bereitstellen in Azure
Diese Vorlage erstellt ein Azure Cosmos DB-Konto für die Tabellen-API in zwei Regionen und eine einzelne Tabelle mit automatisch skaliertem Durchsatz.
Erstellen eines Zero Touch-Azure Cosmos-Kontos und einer Azure-Web-App

Bereitstellen in Azure
Diese Vorlage erstellt ein Azure Cosmos-Konto, fügt den Cosmos DB-Endpunkt und Schlüssel in die Azure-Web-App-Einstellungen ein und stellt dann eine ASP MVC-Web-App von GitHub bereit.
Erstellen eines Cosmos DB-Kontos mit aktiviertem Microsoft Defender

Bereitstellen in Azure
Mit dieser ARM-Vorlage können Sie ein Azure Cosmos DB-Konto mit aktiviertem Microsoft Defender für Azure Cosmos DB bereitstellen. Microsoft Defender für Azure Cosmos DB ist eine in Azure native Sicherheitsebene, die Versuche erkennt, Datenbanken in Ihren Azure Cosmos DB-Konten auszunutzen. Microsoft Defender für Azure Cosmos DB erkennt potenzielle SQL-Einschleusungen, bekannte böswillige Akteure basierend auf Microsoft Threat Intelligence, verdächtige Zugriffsmuster und potenzielle Nutzungen Ihrer Datenbank durch kompromittierte Identitäten oder böswillige Insider.
Bereitstellen von Azure Data Explorer DB mit Cosmos DB-Verbindung

Bereitstellen in Azure
Bereitstellen von Azure Data Explorer DB mit Cosmos DB-Verbindung
Azure Cosmos DB-Konto mit Web-App

Bereitstellen in Azure
Diese Vorlage stellt ein Azure Cosmos DB-Konto und einen App Service-Plan bereit und erstellt eine Web-App im App Service-Plan. Außerdem werden der Web-App zwei Anwendungseinstellungen hinzugefügt, die auf den Azure Cosmos DB-Kontoendpunkt verweisen. Auf diese Weise können lösungen, die in der Web-App bereitgestellt werden, mithilfe dieser Einstellungen eine Verbindung mit dem Azure Cosmos DB-Kontoendpunkt herstellen.

Terraform-Ressourcendefinition (AzAPI-Anbieter)

Der Ressourcentyp databaseAccounts kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

  • Ressourcengruppen

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie im Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.DocumentDB/databaseAccounts-Ressource zu erstellen, fügen Sie Der Vorlage die folgende Terraform-Ressource hinzu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DocumentDB/databaseAccounts@2020-04-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      apiProperties = {
        serverVersion = "string"
      }
      capabilities = [
        {
          name = "string"
        }
      ]
      connectorOffer = "Small"
      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
        }
      ]
    }
    kind = "string"
  })
}

Eigenschaftswerte

databaseAccounts

Name BESCHREIBUNG Wert
type Der Ressourcentyp "Microsoft.DocumentDB/databaseAccounts@2020-04-01"
name Der Ressourcenname Zeichenfolge (erforderlich)

Zeichenlimit: 3-44

Gültige Zeichen:
Kleinbuchstaben, Zahlen und Bindestriche.

Beginnen Sie mit einem Kleinbuchstaben oder einer Zahl.

Der Ressourcenname muss in Azure eindeutig sein.
location Der Speicherort der Ressourcengruppe, zu der die Ressource gehört. Zeichenfolge
parent_id Verwenden Sie zum Bereitstellen in einer Ressourcengruppe die ID dieser Ressourcengruppe. Zeichenfolge (erforderlich)
tags Tags sind eine Liste von Schlüssel-Wert-Paaren, die die Ressource beschreiben. Diese Tags können über Ressourcengruppen hinweg zum Anzeigen und Gruppieren von Ressourcen verwendet werden. Für eine Ressource können maximal 15 Tags bereitgestellt werden. Der Schlüssel eines Tags darf nicht länger als 128 Zeichen und der Wert nicht länger als 256 Zeichen sein. Beispielsweise ist die Standardumgebung für einen Vorlagentyp auf "defaultExperience": "Cassandra" festgelegt. Zu den aktuellen "defaultExperience"-Werten gehören auch "Table", "Graph", "DocumentDB" und "MongoDB". Wörterbuch der Tagnamen und -werte.
kind Gibt den Typ des Datenbankkontos an. Dies kann nur bei der Erstellung eines Datenbankkontos festgelegt werden. "GlobalDocumentDB"
"MongoDB"
"Analysieren"
properties Eigenschaften zum Erstellen und Aktualisieren von Azure Cosmos DB-Datenbankkonten. DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou... (erforderlich)

DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou...

Name BESCHREIBUNG Wert
apiProperties API-spezifische Eigenschaften. Derzeit wird nur für die MongoDB-API unterstützt. ApiProperties
capabilities Liste der Cosmos DB-Funktionen für das Konto Funktion[]
connectorOffer Der Angebotstyp des Cassandra-Connectors für das C*-Konto der Cosmos DB-Datenbank. "Klein"
consistencyPolicy Die Konsistenzrichtlinie für das Cosmos DB-Konto. ConsistencyPolicy
cors Die CORS-Richtlinie für das Cosmos DB-Datenbankkonto. CorsPolicy[]
databaseAccountOfferType Der Angebotstyp für die Datenbank "Standard" (erforderlich)
disableKeyBasedMetadataWriteAccess Deaktivieren von Schreibvorgängen für Metadatenressourcen (Datenbanken, Container, Durchsatz) über Kontoschlüssel bool
enableAnalyticalStorage Flag, um anzugeben, ob die Speicheranalyse aktiviert werden soll. bool
enableAutomaticFailover Aktiviert das automatische Failover der Schreibregion in dem seltenen Fall, dass die Region aufgrund eines Ausfalls nicht verfügbar ist. Das automatische Failover führt zu einer neuen Schreibregion für das Konto und wird basierend auf den für das Konto konfigurierten Failoverprioritäten ausgewählt. bool
enableCassandraConnector Aktiviert den Cassandra-Connector für das Cosmos DB-C*-Konto. bool
enableFreeTier Flag, um anzugeben, ob der Free-Tarif aktiviert ist. bool
enableMultipleWriteLocations Ermöglicht dem Konto das Schreiben an mehreren Speicherorten. bool
ipRules Liste der IpRules. IpAddressOrRange[]
isVirtualNetworkFilterEnabled Flag, um anzugeben, ob ACL-Regeln für virtuelle Netzwerke aktiviert/deaktiviert werden sollen. bool
keyVaultKeyUri Der URI des Schlüsseltresors Zeichenfolge
locations Ein Array, das die georeplizierungsspeicherorte enthält, die für das Cosmos DB-Konto aktiviert sind. Location[] (erforderlich)
virtualNetworkRules Liste der VNET-ACL-Regeln, die für das Cosmos DB-Konto konfiguriert sind. VirtualNetworkRule[]

ApiProperties

Name BESCHREIBUNG Wert
serverVersion Beschreibt die ServerVersion eines MongoDB-Kontos. "3.2"
"3.6"

Funktion

Name BESCHREIBUNG Wert
name Name der Cosmos DB-Funktion. Beispiel: "name": "EnableCassandra". Zu den aktuellen Werten gehören auch "EnableTable" und "EnableGremlin". Zeichenfolge

ConsistencyPolicy

Name BESCHREIBUNG Wert
defaultConsistencyLevel Die Standardkonsistenzebene und die Konfigurationseinstellungen des Cosmos DB-Kontos. "BoundedStaleness"
"ConsistentPrefix"
"Letztlich"
"Sitzung"
"Strong" (erforderlich)
maxIntervalInSeconds Bei Verwendung mit der Konsistenzebene "Begrenzte Veraltung" stellt dieser Wert den Zeitraum der Veraltung (in Sekunden) dar, der toleriert wird. Der zulässige Bereich für diesen Wert ist 5 bis 86400. Erforderlich, wenn defaultConsistencyPolicy auf "BoundedStaleness" festgelegt ist. INT

Einschränkungen:
Minimaler Wert = 5
Max. Wert = 86400
maxStalenessPrefix Bei Verwendung mit der Konsistenzebene "Begrenzte Veraltung" stellt dieser Wert die Anzahl veralteter Anforderungen dar, die toleriert werden. Für diesen Wert ist ein Bereich von 1 bis 2.147.483.647 zulässig. Erforderlich, wenn defaultConsistencyPolicy auf "BoundedStaleness" festgelegt ist. INT

Einschränkungen:
Minimaler Wert = 1
Max. Wert = 2147483647

CorsPolicy

Name BESCHREIBUNG Wert
allowedHeaders Die Anforderungsheader, die die Ursprungsdomäne für die CORS-Anforderung angeben kann. Zeichenfolge
allowedMethods Die Methoden (HTTP-Anforderungsverben), die die Ursprungsdomäne für eine CORS-Anforderung verwenden kann. Zeichenfolge
allowedOrigins Die Ursprungsdomänen, die über CORS eine Anforderung an den Dienst stellen dürfen. Zeichenfolge (erforderlich)
exposedHeaders Die Antwortheader, die in der Antwort an die CORS-Anforderung gesendet und vom Browser gegenüber dem Anforderungsaussteller verfügbar gemacht werden können. Zeichenfolge
maxAgeInSeconds Die maximale Zeit, über die die OPTIONS-Preflight-Anforderung vom Browser zwischengespeichert werden soll. INT

Einschränkungen:
Minimaler Wert = 1
Max. Wert = 2147483647

IpAddressOrRange

Name BESCHREIBUNG Wert
ipAddressOrRange Eine einzelne IPv4-Adresse oder ein einzelner IPv4-Adressbereich im CIDR-Format. Bereitgestellte IP-Adressen müssen gut formatiert sein und können nicht in einem der folgenden Bereiche enthalten sein: 10.0.0.0/8, 100.64.0.0/10, 172.16.0.0/12, 192.168.0.0/16, da diese durch den IP-Adressfilter nicht durchsetzbar sind. Beispiel für gültige Eingaben: "23.40.210.245" oder "23.40.210.0/8". Zeichenfolge

Standort

Name BESCHREIBUNG Wert
failoverPriority Die Failoverpriorität der Region. Eine Failoverpriorität von 0 gibt einen Schreibbereich an. Der maximale Wert für eine Failoverpriorität = (Gesamtanzahl der Regionen - 1). Failoverprioritätswerte müssen für jede Region, in der das Datenbankkonto vorhanden ist, eindeutig sein. INT

Einschränkungen:
Minimaler Wert = 0
isZoneRedundant Flag, um anzugeben, ob es sich bei dieser Region um eine AvailabilityZone-Region handelt bool
locationName Der Name der Region. Zeichenfolge

VirtualNetworkRule

Name BESCHREIBUNG Wert
id Ressourcen-ID eines Subnetzes, z. B.: /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}. Zeichenfolge
ignoreMissingVNetServiceEndpoint Erstellen Sie eine Firewallregel, bevor der VNET-Dienstendpunkt für das virtuelle Netzwerk aktiviert ist. bool