Condividi tramite

Database Microsoft.DocumentDBAccounts/tables

Definizione di risorsa Bicep

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

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

Formato risorsa

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

resource symbolicname 'Microsoft.DocumentDB/databaseAccounts/tables@2025-11-01-preview' = {
  parent: resourceSymbolicName
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  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'
  }
}

Valori delle proprietà

Microsoft.DocumentDB/databaseAccounts/tabelle

Nome Descrizione Valore
identità Identità per la risorsa. ManagedServiceIdentity
ubicazione Posizione del gruppo di risorse a cui appartiene la risorsa. corda
nome Nome della risorsa stringa (obbligatorio)
genitore In Bicep è possibile specificare la risorsa padre per una risorsa figlio. È necessario aggiungere questa proprietà solo quando la risorsa figlio viene dichiarata all'esterno della risorsa padre.

Per altre informazioni, vedere risorsa figlio all'esterno della risorsa padre.		 Nome simbolico per la risorsa di tipo: databaseAccounts
proprietà Proprietà per creare e aggiornare la tabella di Azure Cosmos DB. TableCreateUpdatePropertiesOrTableGetProperties (obbligatorio)
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli

Impostazioni di scalabilità automatica

Nome Descrizione Valore
maxThroughput Rappresenta la velocità effettiva massima, la risorsa può aumentare le prestazioni. Int

Componenti1Jq1T4ISchemasManagedserviceidentityPropertiesUserassignedidentitiesAdditionalproperties

Nome Descrizione Valore

CreateUpdateOptionsOrTableGetPropertiesOptions

Nome Descrizione Valore
autoscaleImpostazioni Specifica le impostazioni di scalabilità automatica. Nota: la velocità effettiva o la scalabilità automaticaImpostazioni è obbligatoria, ma non entrambe. impostazione di scalabilità automaticaImpostazioni di scalabilità automatica
Velocità effettiva Unità richiesta al secondo. Ad esempio, "velocità effettiva": 10000. Int

Identità dei Servizi Gestiti

Nome Descrizione Valore
digitare Tipo di identità usata per la risorsa. Il tipo 'SystemAssigned,UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'None' rimuoverà tutte le identità dal servizio. 'Nessuno'
'Assegnato dal sistema'
'SystemAssigned,UserAssigned'
'Assegnato dall'utente'
userAssignedIdentities Elenco delle identità utente associate alla risorsa. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nome Descrizione Valore

Parametri di ripristino delle risorse

Nome Descrizione Valore
ripristina ID dell'account di database ripristinabile da cui deve essere avviato il ripristino. Ad esempio: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} corda
restoreTimestampInUtc Ora di ripristino dell'account (formato ISO-8601). corda
restoreWithTtlDisabled Specifica se l'account ripristinato avrà time-To-Live disabilitato al termine del ripristino. Bool

TableCreateUpdatePropertiesOrTableGetProperties

Nome Descrizione Valore
Opzioni Coppia chiave-valore di opzioni da applicare per la richiesta. Corrisponde alle intestazioni inviate con la richiesta. CreateUpdateOptionsOrTableGetPropertiesOptions
risorsa Formato JSON standard di una tabella TableResourceOrTableGetPropertiesResource (obbligatorio)

TableResourceOrTableGetPropertiesResource

Nome Descrizione Valore
createMode Enumerazione per indicare la modalità di creazione della risorsa. Impostazione predefinita
'Ripristina'
Id Nome della tabella Cosmos DB stringa (obbligatorio)
restoreParameters Parametri per indicare le informazioni sul ripristino Parametri di ripristino delle risorse

Tag

Nome Descrizione Valore

Esempi di utilizzo

Esempi di avvio rapido di Azure

I modelli di avvio rapido di Azure seguenti contengono esempi Bicep per la distribuzione di questo tipo di risorsa.

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

Definizione di risorsa del modello di Resource Manager

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

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

Formato risorsa

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

{
  "type": "Microsoft.DocumentDB/databaseAccounts/tables",
  "apiVersion": "2025-11-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "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"
  }
}

Valori delle proprietà

Microsoft.DocumentDB/databaseAccounts/tabelle

Nome Descrizione Valore
versione dell'API Versione dell'API '2025-11-01-anteprima'
identità Identità per la risorsa. ManagedServiceIdentity
ubicazione Posizione del gruppo di risorse a cui appartiene la risorsa. corda
nome Nome della risorsa stringa (obbligatorio)
proprietà Proprietà per creare e aggiornare la tabella di Azure Cosmos DB. TableCreateUpdatePropertiesOrTableGetProperties (obbligatorio)
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli
digitare Tipo di risorsa 'Microsoft.DocumentDB/databaseAccounts/tabelle'

Impostazioni di scalabilità automatica

Nome Descrizione Valore
maxThroughput Rappresenta la velocità effettiva massima, la risorsa può aumentare le prestazioni. Int

Componenti1Jq1T4ISchemasManagedserviceidentityPropertiesUserassignedidentitiesAdditionalproperties

Nome Descrizione Valore

CreateUpdateOptionsOrTableGetPropertiesOptions

Nome Descrizione Valore
autoscaleImpostazioni Specifica le impostazioni di scalabilità automatica. Nota: la velocità effettiva o la scalabilità automaticaImpostazioni è obbligatoria, ma non entrambe. impostazione di scalabilità automaticaImpostazioni di scalabilità automatica
Velocità effettiva Unità richiesta al secondo. Ad esempio, "velocità effettiva": 10000. Int

Identità dei Servizi Gestiti

Nome Descrizione Valore
digitare Tipo di identità usata per la risorsa. Il tipo 'SystemAssigned,UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'None' rimuoverà tutte le identità dal servizio. 'Nessuno'
'Assegnato dal sistema'
'SystemAssigned,UserAssigned'
'Assegnato dall'utente'
userAssignedIdentities Elenco delle identità utente associate alla risorsa. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nome Descrizione Valore

Parametri di ripristino delle risorse

Nome Descrizione Valore
ripristina ID dell'account di database ripristinabile da cui deve essere avviato il ripristino. Ad esempio: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} corda
restoreTimestampInUtc Ora di ripristino dell'account (formato ISO-8601). corda
restoreWithTtlDisabled Specifica se l'account ripristinato avrà time-To-Live disabilitato al termine del ripristino. Bool

TableCreateUpdatePropertiesOrTableGetProperties

Nome Descrizione Valore
Opzioni Coppia chiave-valore di opzioni da applicare per la richiesta. Corrisponde alle intestazioni inviate con la richiesta. CreateUpdateOptionsOrTableGetPropertiesOptions
risorsa Formato JSON standard di una tabella TableResourceOrTableGetPropertiesResource (obbligatorio)

TableResourceOrTableGetPropertiesResource

Nome Descrizione Valore
createMode Enumerazione per indicare la modalità di creazione della risorsa. Impostazione predefinita
'Ripristina'
Id Nome della tabella Cosmos DB stringa (obbligatorio)
restoreParameters Parametri per indicare le informazioni sul ripristino Parametri di ripristino delle risorse

Tag

Nome Descrizione Valore

Esempi di utilizzo

Modelli di avvio rapido di Azure

I modelli di avvio rapido di Azure seguenti distribuire questo tipo di risorsa.

Sagoma Descrizione
Creare un account Azure Cosmos per l'API Tabella

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

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

Definizione di risorsa Terraform (provider AzAPI)

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

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

Formato risorsa

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DocumentDB/databaseAccounts/tables@2025-11-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
        }
      }
    }
  }
}

Valori delle proprietà

Microsoft.DocumentDB/databaseAccounts/tabelle

Nome Descrizione Valore
identità Identità per la risorsa. ManagedServiceIdentity
ubicazione Posizione del gruppo di risorse a cui appartiene la risorsa. corda
nome Nome della risorsa stringa (obbligatorio)
parent_id ID della risorsa padre per questa risorsa. ID per la risorsa di tipo: databaseAccounts
proprietà Proprietà per creare e aggiornare la tabella di Azure Cosmos DB. TableCreateUpdatePropertiesOrTableGetProperties (obbligatorio)
Tag Tag delle risorse Dizionario di nomi e valori di tag.
digitare Tipo di risorsa "Microsoft.DocumentDB/databaseAccounts/tables@2025-11-01-preview"

Impostazioni di scalabilità automatica

Nome Descrizione Valore
maxThroughput Rappresenta la velocità effettiva massima, la risorsa può aumentare le prestazioni. Int

Componenti1Jq1T4ISchemasManagedserviceidentityPropertiesUserassignedidentitiesAdditionalproperties

Nome Descrizione Valore

CreateUpdateOptionsOrTableGetPropertiesOptions

Nome Descrizione Valore
autoscaleImpostazioni Specifica le impostazioni di scalabilità automatica. Nota: la velocità effettiva o la scalabilità automaticaImpostazioni è obbligatoria, ma non entrambe. impostazione di scalabilità automaticaImpostazioni di scalabilità automatica
Velocità effettiva Unità richiesta al secondo. Ad esempio, "velocità effettiva": 10000. Int

Identità dei Servizi Gestiti

Nome Descrizione Valore
digitare Tipo di identità usata per la risorsa. Il tipo 'SystemAssigned,UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'None' rimuoverà tutte le identità dal servizio. 'Nessuno'
'Assegnato dal sistema'
'SystemAssigned,UserAssigned'
'Assegnato dall'utente'
userAssignedIdentities Elenco delle identità utente associate alla risorsa. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nome Descrizione Valore

Parametri di ripristino delle risorse

Nome Descrizione Valore
ripristina ID dell'account di database ripristinabile da cui deve essere avviato il ripristino. Ad esempio: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} corda
restoreTimestampInUtc Ora di ripristino dell'account (formato ISO-8601). corda
restoreWithTtlDisabled Specifica se l'account ripristinato avrà time-To-Live disabilitato al termine del ripristino. Bool

TableCreateUpdatePropertiesOrTableGetProperties

Nome Descrizione Valore
Opzioni Coppia chiave-valore di opzioni da applicare per la richiesta. Corrisponde alle intestazioni inviate con la richiesta. CreateUpdateOptionsOrTableGetPropertiesOptions
risorsa Formato JSON standard di una tabella TableResourceOrTableGetPropertiesResource (obbligatorio)

TableResourceOrTableGetPropertiesResource

Nome Descrizione Valore
createMode Enumerazione per indicare la modalità di creazione della risorsa. Impostazione predefinita
'Ripristina'
Id Nome della tabella Cosmos DB stringa (obbligatorio)
restoreParameters Parametri per indicare le informazioni sul ripristino Parametri di ripristino delle risorse

Tag

Nome Descrizione Valore

Esempi di utilizzo

Esempi di Terraform

Esempio di base di distribuzione di una tabella all'interno di un account Cosmos DB.

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 = "EnableTable"
        },
      ]
      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" "table" {
  type      = "Microsoft.DocumentDB/databaseAccounts/tables@2021-10-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    = ["*"]
}
  • Last updated on