Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Bicep-Ressourcendefinition
Der Ressourcentyp "databaseAccounts/gremlinDatabases" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
- Ressourcengruppen – Siehe Ressourcengruppenbereitstellungsbefehle
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:
- Ressourcengruppen – Siehe Ressourcengruppen-Deployment-Befehle Für eine Liste der geänderten Eigenschaften in jeder API-Version siehe Änderungsprotokoll.
Verwendungsbeispiele
Azure-Schnellstartvorlagen
Die folgenden Azure-Schnellstartvorlagen diesen Ressourcentyp bereitstellen.
| Schablone | 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 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 |