Condividi tramite

Database Microsoft.DocumentDBConconti/tabelle 2025-10-15

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 delle risorse

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

resource symbolicname 'Microsoft.DocumentDB/databaseAccounts/tables@2025-10-15' = {
  parent: resourceSymbolicName
  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 Description Value
location Posizione del gruppo di risorse a cui appartiene la risorsa. corda
nome Nome della risorsa stringa (obbligatorio)
parent 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)
tags Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli

Impostazioni di scalabilità automatica

Nome Description Value
maxThroughput Rappresenta la velocità effettiva massima, la risorsa può aumentare le prestazioni. int

CreateUpdateOptionsOrTableGetPropertiesOptions

Nome Description Value
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
Capacità di trasmissione Unità richiesta al secondo. Ad esempio, "velocità effettiva": 10000. int

Parametri di ripristino delle risorse

Nome Description Value
restoreSource 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 Description Value
options Coppia chiave-valore di opzioni da applicare per la richiesta. Corrisponde alle intestazioni inviate con la richiesta. CreateUpdateOptionsOrTableGetPropertiesOptions
resource Formato JSON standard di una tabella TableResourceOrTableGetPropertiesResource (obbligatorio)

TableResourceOrTableGetPropertiesResource

Nome Description Value
createMode Enumerazione per indicare la modalità di creazione della risorsa. 'Default'
'Restore'
id Nome della tabella Cosmos DB stringa (obbligatorio)
restoreParameters Parametri per indicare le informazioni sul ripristino Parametri di ripristino delle risorse

Etichette

Nome Description Value

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 Description
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 delle risorse

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

{
  "type": "Microsoft.DocumentDB/databaseAccounts/tables",
  "apiVersion": "2025-10-15",
  "name": "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"
  }
}

Valori delle proprietà

Microsoft.DocumentDB/databaseAccounts/tabelle

Nome Description Value
versione dell'API Versione dell'API '2025-10-15'
location 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)
tags Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli
type Tipo di risorsa 'Microsoft.DocumentDB/databaseAccounts/tabelle'

Impostazioni di scalabilità automatica

Nome Description Value
maxThroughput Rappresenta la velocità effettiva massima, la risorsa può aumentare le prestazioni. int

CreateUpdateOptionsOrTableGetPropertiesOptions

Nome Description Value
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
Capacità di trasmissione Unità richiesta al secondo. Ad esempio, "velocità effettiva": 10000. int

Parametri di ripristino delle risorse

Nome Description Value
restoreSource 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 Description Value
options Coppia chiave-valore di opzioni da applicare per la richiesta. Corrisponde alle intestazioni inviate con la richiesta. CreateUpdateOptionsOrTableGetPropertiesOptions
resource Formato JSON standard di una tabella TableResourceOrTableGetPropertiesResource (obbligatorio)

TableResourceOrTableGetPropertiesResource

Nome Description Value
createMode Enumerazione per indicare la modalità di creazione della risorsa. 'Default'
'Restore'
id Nome della tabella Cosmos DB stringa (obbligatorio)
restoreParameters Parametri per indicare le informazioni sul ripristino Parametri di ripristino delle risorse

Etichette

Nome Description Value

Esempi di utilizzo

Modelli di avvio rapido di Azure

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

Template Description
Creare un account Azure Cosmos per l'API Tabella

Pubblica su 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

Pubblica su 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 delle risorse

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-10-15"
  name = "string"
  parent_id = "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 Description Value
location 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)
tags Tag delle risorse Dizionario di nomi e valori di tag.
type Tipo di risorsa "Microsoft.DocumentDB/databaseAccounts/tables@2025-10-15"

Impostazioni di scalabilità automatica

Nome Description Value
maxThroughput Rappresenta la velocità effettiva massima, la risorsa può aumentare le prestazioni. int

CreateUpdateOptionsOrTableGetPropertiesOptions

Nome Description Value
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
Capacità di trasmissione Unità richiesta al secondo. Ad esempio, "velocità effettiva": 10000. int

Parametri di ripristino delle risorse

Nome Description Value
restoreSource 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 Description Value
options Coppia chiave-valore di opzioni da applicare per la richiesta. Corrisponde alle intestazioni inviate con la richiesta. CreateUpdateOptionsOrTableGetPropertiesOptions
resource Formato JSON standard di una tabella TableResourceOrTableGetPropertiesResource (obbligatorio)

TableResourceOrTableGetPropertiesResource

Nome Description Value
createMode Enumerazione per indicare la modalità di creazione della risorsa. 'Default'
'Restore'
id Nome della tabella Cosmos DB stringa (obbligatorio)
restoreParameters Parametri per indicare le informazioni sul ripristino Parametri di ripristino delle risorse

Etichette

Nome Description Value

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