Microsoft.DocumentDB-DatenbankAccounts/gremlinDatabases

Bicep-Ressourcendefinition

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

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

Verwendungsbeispiele

Bicep-Beispiele

Ein grundlegendes Beispiel für die Bereitstellung von Gremlin-Datenbank in einem Cosmos DB-Konto.

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

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

resource gremlinDatabase 'Microsoft.DocumentDB/databaseAccounts/gremlinDatabases@2023-04-15' = {
  name: resourceName
  parent: databaseAccount
  properties: {
    options: {}
    resource: {
      id: resourceName
    }
  }
}

Von Azure verifizierte Module

Die folgenden Azure Verified Modules können verwendet werden, um diesen Ressourcentyp bereitzustellen.

Module Beschreibung
Cosmos DB Datenbankkonto - Gremlin Datenbank AVM-Kindmodul für das Cosmos-DB-Datenbankkonto – Gremlin-Datenbank

Azure-Schnellstartbeispiele

Die folgenden Azure-Schnellstartvorlagen Bicep-Beispiele für die Bereitstellung dieses Ressourcentyps enthalten.

Bicep-Datei Beschreibung
Erstellen eines Azure Cosmos DB-Kontos für gremlin-API- Diese Vorlage erstellt ein Azure Cosmos DB-Konto für die Gremlin-API in zwei Regionen mit einer Datenbank und einem Diagramm mit dediziertem Durchsatz.
Erstellen eines Azure Cosmos DB-Kontos für gremlin-API autoscale Diese Vorlage erstellt ein Azure Cosmos DB-Konto für die Gremlin-API in zwei Regionen mit einer Datenbank und einem Diagramm mit autoskalen Durchsatz.

Ressourcenformat

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

resource symbolicname 'Microsoft.DocumentDB/databaseAccounts/gremlinDatabases@2026-04-01-preview' = {
  parent: resourceSymbolicName
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: 'string'
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    options: {
      autoscaleSettings: {
        maxThroughput: int
      }
      throughput: int
    }
    resource: {
      createMode: 'string'
      id: 'string'
      restoreParameters: {
        restoreSource: 'string'
        restoreTimestampInUtc: 'string'
        restoreWithTtlDisabled: bool
      }
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Eigenschaftswerte

Microsoft.DocumentDB/databaseAccounts/gremlinDatabases

Name Beschreibung Wert
Identität Identität für die Ressource. ManagedServiceIdentity-
Ort Der Speicherort der Ressourcengruppe, zu der die Ressource gehört. Schnur
Name Der Ressourcenname Zeichenfolge (erforderlich)
Elternteil In Bicep können Sie die übergeordnete Ressource für eine untergeordnete Ressource angeben. Sie müssen diese Eigenschaft nur hinzufügen, wenn die untergeordnete Ressource außerhalb der übergeordneten Ressource deklariert wird.

Weitere Informationen finden Sie unter Untergeordnete Ressource außerhalb der übergeordneten Ressource.
Symbolischer Name für Ressource des Typs: databaseAccounts
Eigenschaften Die Eigenschaften einer Azure Cosmos DB SQL-Datenbank GremlinDatabaseGetProperties
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen

Einstellungen für die automatische Skalierung

Name Beschreibung Wert
max. Durchsatz Stellt den maximalen Durchsatz dar, auf den die Ressource skaliert werden kann. Int

GremlinDatabaseGetProperties

Name Beschreibung Wert
Optionen GremlinDatabaseGetPropertiesOptions
Ressource GremlinDatabaseGetPropertiesResource

GremlinDatabaseGetPropertiesOptions

Name Beschreibung Wert
autoscaleEinstellungen Gibt die Einstellungen für die Autoskalen an. AutoscaleSettings-
Durchsatz Wert des Cosmos DB-Ressourcendurchsatzes oder autoscaleSettings. Verwenden Sie die Durchsatzeinstellungsressource beim Abrufen von Angebotsdetails. Int

GremlinDatabaseGetPropertiesResource

Name Beschreibung Wert
createMode Aufzählung, um den Modus der Ressourcenerstellung anzugeben. 'Standard'
"Wiederherstellen"
id Name der Cosmos DB Gremlin-Datenbank Zeichenfolge (erforderlich)
restore-Parameter Parameter, die die Informationen zur Wiederherstellung angeben sollen ResourceRestoreParameters-

Verwaltete Dienstidentität

Name Beschreibung Wert
Art Der Identitätstyp, der für die Ressource verwendet wird. Der Typ "SystemAssigned,UserAssigned" enthält sowohl eine implizit erstellte Identität als auch eine Gruppe von vom Benutzer zugewiesenen Identitäten. Der Typ "None" entfernt alle Identitäten aus dem Dienst. "Keine"
'SystemZugewiesen'
"SystemAssigned,UserAssigned"
"UserAssigned"
vom Benutzer zugewiesene Identitäten Die Liste der Benutzeridentitäten, die der Ressource zugeordnet sind. Die Benutzeridentitätswörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". Datensatz

Eintrag

Name Beschreibung Wert

ResourceRestoreParameters

Name Beschreibung Wert
restoreSource Die ID des wiederherstellbaren Datenbankkontos, von dem die Wiederherstellung initiiert werden muss. Beispiel: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} Schnur
restoreTimestampInUtc Zeit, zu der das Konto wiederhergestellt werden muss (ISO-8601-Format). Schnur
restoreWithTtlDisabled Gibt an, ob das wiederhergestellte Konto zeit-To-Live bei der erfolgreichen Wiederherstellung deaktiviert ist. Bool

ARM-Vorlagenressourcendefinition

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

Verwendungsbeispiele

Azure-Schnellstartvorlagen

Die folgenden Azure-Schnellstartvorlagen diesen Ressourcentyp bereitstellen.

Schablone Beschreibung
Erstellen eines Azure Cosmos DB-Kontos für gremlin-API-

Bereitstellen in Azure
Diese Vorlage erstellt ein Azure Cosmos DB-Konto für die Gremlin-API in zwei Regionen mit einer Datenbank und einem Diagramm mit dediziertem Durchsatz.
Erstellen eines Azure Cosmos DB-Kontos für gremlin-API autoscale

Bereitstellen in Azure
Diese Vorlage erstellt ein Azure Cosmos DB-Konto für die Gremlin-API in zwei Regionen mit einer Datenbank und einem Diagramm mit autoskalen Durchsatz.

Ressourcenformat

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

{
  "type": "Microsoft.DocumentDB/databaseAccounts/gremlinDatabases",
  "apiVersion": "2026-04-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": "string"
    }
  },
  "location": "string",
  "properties": {
    "options": {
      "autoscaleSettings": {
        "maxThroughput": "int"
      },
      "throughput": "int"
    },
    "resource": {
      "createMode": "string",
      "id": "string",
      "restoreParameters": {
        "restoreSource": "string",
        "restoreTimestampInUtc": "string",
        "restoreWithTtlDisabled": "bool"
      }
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Eigenschaftswerte

Microsoft.DocumentDB/databaseAccounts/gremlinDatabases

Name Beschreibung Wert
apiVersion (Englisch) Die API-Version '2026-04-01-Vorschau'
Identität Identität für die Ressource. ManagedServiceIdentity-
Ort Der Speicherort der Ressourcengruppe, zu der die Ressource gehört. Schnur
Name Der Ressourcenname Zeichenfolge (erforderlich)
Eigenschaften Die Eigenschaften einer Azure Cosmos DB SQL-Datenbank GremlinDatabaseGetProperties
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
Art Der Ressourcentyp 'Microsoft.DocumentDB/databaseAccounts/gremlinDatabases'

Einstellungen für die automatische Skalierung

Name Beschreibung Wert
max. Durchsatz Stellt den maximalen Durchsatz dar, auf den die Ressource skaliert werden kann. Int

GremlinDatabaseGetProperties

Name Beschreibung Wert
Optionen GremlinDatabaseGetPropertiesOptions
Ressource GremlinDatabaseGetPropertiesResource

GremlinDatabaseGetPropertiesOptions

Name Beschreibung Wert
autoscaleEinstellungen Gibt die Einstellungen für die Autoskalen an. AutoscaleSettings-
Durchsatz Wert des Cosmos DB-Ressourcendurchsatzes oder autoscaleSettings. Verwenden Sie die Durchsatzeinstellungsressource beim Abrufen von Angebotsdetails. Int

GremlinDatabaseGetPropertiesResource

Name Beschreibung Wert
createMode Aufzählung, um den Modus der Ressourcenerstellung anzugeben. 'Standard'
"Wiederherstellen"
id Name der Cosmos DB Gremlin-Datenbank Zeichenfolge (erforderlich)
restore-Parameter Parameter, die die Informationen zur Wiederherstellung angeben sollen ResourceRestoreParameters-

Verwaltete Dienstidentität

Name Beschreibung Wert
Art Der Identitätstyp, der für die Ressource verwendet wird. Der Typ "SystemAssigned,UserAssigned" enthält sowohl eine implizit erstellte Identität als auch eine Gruppe von vom Benutzer zugewiesenen Identitäten. Der Typ "None" entfernt alle Identitäten aus dem Dienst. "Keine"
'SystemZugewiesen'
"SystemAssigned,UserAssigned"
"UserAssigned"
vom Benutzer zugewiesene Identitäten Die Liste der Benutzeridentitäten, die der Ressource zugeordnet sind. Die Benutzeridentitätswörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". Datensatz

Eintrag

Name Beschreibung Wert

ResourceRestoreParameters

Name Beschreibung Wert
restoreSource Die ID des wiederherstellbaren Datenbankkontos, von dem die Wiederherstellung initiiert werden muss. Beispiel: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} Schnur
restoreTimestampInUtc Zeit, zu der das Konto wiederhergestellt werden muss (ISO-8601-Format). Schnur
restoreWithTtlDisabled Gibt an, ob das wiederhergestellte Konto zeit-To-Live bei der erfolgreichen Wiederherstellung deaktiviert ist. Bool

Terraform -Ressourcendefinition (AzAPI-Anbieter)

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

  • Ressourcengruppen Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Change Log.

Verwendungsbeispiele

Terraform-Beispiele

Ein grundlegendes Beispiel für die Bereitstellung von Gremlin-Datenbank in einem Cosmos DB-Konto.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "databaseAccount" {
  type      = "Microsoft.DocumentDB/databaseAccounts@2021-10-15"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    kind = "GlobalDocumentDB"
    properties = {
      capabilities = [
        {
          name = "EnableGremlin"
        },
      ]
      consistencyPolicy = {
        defaultConsistencyLevel = "Strong"
        maxIntervalInSeconds    = 5
        maxStalenessPrefix      = 100
      }
      databaseAccountOfferType           = "Standard"
      defaultIdentity                    = "FirstPartyIdentity"
      disableKeyBasedMetadataWriteAccess = false
      disableLocalAuth                   = false
      enableAnalyticalStorage            = false
      enableAutomaticFailover            = false
      enableFreeTier                     = false
      enableMultipleWriteLocations       = false
      ipRules = [
      ]
      isVirtualNetworkFilterEnabled = false
      locations = [
        {
          failoverPriority = 0
          isZoneRedundant  = false
          locationName     = "West Europe"
        },
      ]
      networkAclBypass = "None"
      networkAclBypassResourceIds = [
      ]
      publicNetworkAccess = "Enabled"
      virtualNetworkRules = [
      ]
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "gremlinDatabase" {
  type      = "Microsoft.DocumentDB/databaseAccounts/gremlinDatabases@2023-04-15"
  parent_id = azapi_resource.databaseAccount.id
  name      = var.resource_name
  body = {
    properties = {
      options = {
      }
      resource = {
        id = var.resource_name
      }
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Ressourcenformat

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DocumentDB/databaseAccounts/gremlinDatabases@2026-04-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      options = {
        autoscaleSettings = {
          maxThroughput = int
        }
        throughput = int
      }
      resource = {
        createMode = "string"
        id = "string"
        restoreParameters = {
          restoreSource = "string"
          restoreTimestampInUtc = "string"
          restoreWithTtlDisabled = bool
        }
      }
    }
  }
}

Eigenschaftswerte

Microsoft.DocumentDB/databaseAccounts/gremlinDatabases

Name Beschreibung Wert
Identität Identität für die Ressource. ManagedServiceIdentity-
Ort Der Speicherort der Ressourcengruppe, zu der die Ressource gehört. Schnur
Name Der Ressourcenname Zeichenfolge (erforderlich)
Eltern-ID Die ID der Ressource, die das übergeordnete Element für diese Ressource ist. ID für Ressource des Typs: databaseAccounts
Eigenschaften Die Eigenschaften einer Azure Cosmos DB SQL-Datenbank GremlinDatabaseGetProperties
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte.
Art Der Ressourcentyp "Microsoft. DocumentDB/databaseAccounts/gremlinDatabases@2026-04-01-preview"

Einstellungen für die automatische Skalierung

Name Beschreibung Wert
max. Durchsatz Stellt den maximalen Durchsatz dar, auf den die Ressource skaliert werden kann. Int

GremlinDatabaseGetProperties

Name Beschreibung Wert
Optionen GremlinDatabaseGetPropertiesOptions
Ressource GremlinDatabaseGetPropertiesResource

GremlinDatabaseGetPropertiesOptions

Name Beschreibung Wert
autoscaleEinstellungen Gibt die Einstellungen für die Autoskalen an. AutoscaleSettings-
Durchsatz Wert des Cosmos DB-Ressourcendurchsatzes oder autoscaleSettings. Verwenden Sie die Durchsatzeinstellungsressource beim Abrufen von Angebotsdetails. Int

GremlinDatabaseGetPropertiesResource

Name Beschreibung Wert
createMode Aufzählung, um den Modus der Ressourcenerstellung anzugeben. 'Standard'
"Wiederherstellen"
id Name der Cosmos DB Gremlin-Datenbank Zeichenfolge (erforderlich)
restore-Parameter Parameter, die die Informationen zur Wiederherstellung angeben sollen ResourceRestoreParameters-

Verwaltete Dienstidentität

Name Beschreibung Wert
Art Der Identitätstyp, der für die Ressource verwendet wird. Der Typ "SystemAssigned,UserAssigned" enthält sowohl eine implizit erstellte Identität als auch eine Gruppe von vom Benutzer zugewiesenen Identitäten. Der Typ "None" entfernt alle Identitäten aus dem Dienst. "Keine"
'SystemZugewiesen'
"SystemAssigned,UserAssigned"
"UserAssigned"
vom Benutzer zugewiesene Identitäten Die Liste der Benutzeridentitäten, die der Ressource zugeordnet sind. Die Benutzeridentitätswörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". Datensatz

Eintrag

Name Beschreibung Wert

ResourceRestoreParameters

Name Beschreibung Wert
restoreSource Die ID des wiederherstellbaren Datenbankkontos, von dem die Wiederherstellung initiiert werden muss. Beispiel: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} Schnur
restoreTimestampInUtc Zeit, zu der das Konto wiederhergestellt werden muss (ISO-8601-Format). Schnur
restoreWithTtlDisabled Gibt an, ob das wiederhergestellte Konto zeit-To-Live bei der erfolgreichen Wiederherstellung deaktiviert ist. Bool