Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
- più recenti
- 2026-04-01-anteprima
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.
Esempi di utilizzo
Esempi bicep
Esempio di base di distribuzione di una tabella all'interno di un account Cosmos DB.
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: '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: []
}
}
resource table 'Microsoft.DocumentDB/databaseAccounts/tables@2021-10-15' = {
name: resourceName
parent: databaseAccount
properties: {
options: {}
resource: {
id: resourceName
}
}
}
Moduli verificati di Azure
Per distribuire questo tipo di risorsa, è possibile usare moduli verificati di Azure.
| Module | Descrizione |
|---|---|
| Conto Database Cosmos DB - Tabella | Modulo figlio AVM per l'Account del Database Cosmos DB - Tabella |
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. |
Formato risorsa
Per creare una risorsa Microsoft.DocumentDB/databaseAccounts/tables, aggiungere il bicep seguente al modello.
resource symbolicname 'Microsoft.DocumentDB/databaseAccounts/tables@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'
}
}
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à | Le proprietà di una tabella Azure Cosmos DB | TableGetProperties |
| 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 |
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}'. | Record |
Record
| 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 |
TableGetProperties
| Nome | Descrizione | Valore |
|---|---|---|
| Opzioni | TabellaGetPropertiesOpzioni | |
| risorsa | TableGetPropertiesResource |
TabellaGetPropertiesOpzioni
| Nome | Descrizione | Valore |
|---|---|---|
| autoscaleImpostazioni | Specifica le impostazioni di scalabilità automatica. | impostazione di scalabilità automaticaImpostazioni di scalabilità automatica |
| Velocità effettiva | Valore della velocità effettiva delle risorse di Cosmos DB o delle impostazioni di scalabilità automatica. Usare la risorsa ThroughputSetting durante il recupero dei dettagli dell'offerta. | Int |
TableGetPropertiesResource
| Nome | Descrizione | Valore |
|---|---|---|
| createMode | Enumerazione per indicare la modalità di creazione dell'account. | Impostazione predefinita 'Ripristina' |
| Id | Nome della tabella Cosmos DB | stringa (obbligatorio) |
| restoreParameters | Parametri per indicare le informazioni sul ripristino | Parametri di ripristino delle risorse |
Definizione di risorsa del modello di Resource Manager
Il tipo di risorsa databaseAccounts/tables può essere distribuito con operazioni destinate a:
- Gruppi di risorse - Vedi comandi di distribuzione dei gruppi di risorse Per un elenco delle proprietà modificate in ciascuna versione API, vedi registro delle modifiche.
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 |
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. |
Formato risorsa
Per creare una risorsa Microsoft.DocumentDB/databaseAccounts/tables, aggiungere il codice JSON seguente al modello.
{
"type": "Microsoft.DocumentDB/databaseAccounts/tables",
"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"
}
}
Valori delle proprietà
Microsoft.DocumentDB/databaseAccounts/tabelle
| Nome | Descrizione | Valore |
|---|---|---|
| versione dell'API | Versione dell'API | 'Anteprima 2026-04-01' |
| 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à | Le proprietà di una tabella Azure Cosmos DB | TableGetProperties |
| 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 |
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}'. | Record |
Record
| 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 |
TableGetProperties
| Nome | Descrizione | Valore |
|---|---|---|
| Opzioni | TabellaGetPropertiesOpzioni | |
| risorsa | TableGetPropertiesResource |
TabellaGetPropertiesOpzioni
| Nome | Descrizione | Valore |
|---|---|---|
| autoscaleImpostazioni | Specifica le impostazioni di scalabilità automatica. | impostazione di scalabilità automaticaImpostazioni di scalabilità automatica |
| Velocità effettiva | Valore della velocità effettiva delle risorse di Cosmos DB o delle impostazioni di scalabilità automatica. Usare la risorsa ThroughputSetting durante il recupero dei dettagli dell'offerta. | Int |
TableGetPropertiesResource
| Nome | Descrizione | Valore |
|---|---|---|
| createMode | Enumerazione per indicare la modalità di creazione dell'account. | Impostazione predefinita 'Ripristina' |
| Id | Nome della tabella Cosmos DB | stringa (obbligatorio) |
| restoreParameters | Parametri per indicare le informazioni sul ripristino | Parametri di ripristino delle risorse |
Definizione di risorsa Terraform (provider AzAPI)
Il tipo di risorsa databaseAccounts/tables può essere distribuito con operazioni destinate a:
- Gruppi di risorse Per un elenco delle proprietà modificate in ogni versione dell'API, vedi il registro modifiche.
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 = ["*"]
}
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@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
}
}
}
}
}
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à | Le proprietà di una tabella Azure Cosmos DB | TableGetProperties |
| Tag | Tag delle risorse | Dizionario di nomi e valori di tag. |
| digitare | Tipo di risorsa | "Microsoft. DocumentDB/databaseAccounts/tables@2026-04-01-anteprima" |
Impostazioni di scalabilità automatica
| Nome | Descrizione | Valore |
|---|---|---|
| maxThroughput | Rappresenta la velocità effettiva massima, la risorsa può aumentare le prestazioni. | 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}'. | Record |
Record
| 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 |
TableGetProperties
| Nome | Descrizione | Valore |
|---|---|---|
| Opzioni | TabellaGetPropertiesOpzioni | |
| risorsa | TableGetPropertiesResource |
TabellaGetPropertiesOpzioni
| Nome | Descrizione | Valore |
|---|---|---|
| autoscaleImpostazioni | Specifica le impostazioni di scalabilità automatica. | impostazione di scalabilità automaticaImpostazioni di scalabilità automatica |
| Velocità effettiva | Valore della velocità effettiva delle risorse di Cosmos DB o delle impostazioni di scalabilità automatica. Usare la risorsa ThroughputSetting durante il recupero dei dettagli dell'offerta. | Int |
TableGetPropertiesResource
| Nome | Descrizione | Valore |
|---|---|---|
| createMode | Enumerazione per indicare la modalità di creazione dell'account. | Impostazione predefinita 'Ripristina' |
| Id | Nome della tabella Cosmos DB | stringa (obbligatorio) |
| restoreParameters | Parametri per indicare le informazioni sul ripristino | Parametri di ripristino delle risorse |