Database Microsoft.DocumentDBAccounts/sqlDatabases 2023-11-15

  • Articolo

Definizione di risorsa Bicep

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

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

Formato di risorsa

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

resource symbolicname 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases@2023-11-15' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  parent: resourceSymbolicName
  properties: {
    options: {
      autoscaleSettings: {
        maxThroughput: int
      }
      throughput: int
    }
    resource: {
      createMode: 'string'
      id: 'string'
      restoreParameters: {
        restoreSource: 'string'
        restoreTimestampInUtc: 'string'
      }
    }
  }
}

Valori delle proprietà

databaseAccounts/sqlDatabases

Nome Descrizione valore
name Nome della risorsa

Vedere come impostare nomi e tipi per le risorse figlio in Bicep.		 stringa (obbligatoria)
posizione Posizione del gruppo di risorse a cui appartiene la risorsa. string
tags I tag sono un elenco di coppie chiave-valore che descrivono la risorsa. Questi tag possono essere utilizzati nella visualizzazione e nel raggruppamento di questa risorsa (tra gruppi di risorse). È possibile specificare un massimo di 15 tag per una risorsa. Ogni tag deve avere una chiave non superiore a 128 caratteri con un valore che non superi i 256 caratteri. Ad esempio, l'esperienza predefinita per un tipo di modello è impostata con "defaultExperience": "Cassandra". I valori "defaultExperience" correnti includono anche "Table", "Graph", "DocumentDB" e "MongoDB". Dizionario dei nomi e dei valori dei tag. Vedere Tag nei modelli
padre 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 esterna alla risorsa padre.		 Nome simbolico per la risorsa di tipo: databaseAccounts
properties Proprietà per creare e aggiornare il database SQL di Azure Cosmos DB. SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetPro... (obbligatorio)

SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetPro...

Nome Descrizione Valore
opzioni Coppia chiave-valore delle opzioni da applicare per la richiesta. Corrisponde alle intestazioni inviate con la richiesta. CreateUpdateOptionsOrSqlDatabaseGetPropertiesOptions
Risorsa Formato JSON standard di un database SQL SqlDatabaseResourceOrSqlDatabaseGetPropertiesResourc... (obbligatorio)

CreateUpdateOptionsOrSqlDatabaseGetPropertiesOptions

Nome Descrizione Valore
autoscaleSettings Specifica le impostazioni di scalabilità automatica. Nota: è necessaria la velocità effettiva o la scalabilità automaticaSettings, ma non entrambe. Scalabilità automaticaSettings
throughput Unità richiesta al secondo. Ad esempio, "velocità effettiva": 10000. INT

Scalabilità automaticaSettings

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

SqlDatabaseResourceOrSqlDatabaseGetPropertiesResourc...

Nome Descrizione Valore
createMode Enumerazione per indicare la modalità di creazione delle risorse. Impostazione predefinita
'Restore'
id Nome del database SQL di Cosmos DB stringa (obbligatorio)
restoreParameters Parametri per indicare le informazioni sul ripristino ResourceRestoreParameters

ResourceRestoreParameters

Nome Descrizione Valore
restoreSource ID dell'account del database ripristinabile da cui deve essere avviato il ripristino. Ad esempio: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} string
restoreTimestampInUtc Ora in cui è necessario ripristinare l'account (formato ISO-8601). string

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Modello Descrizione
Creare un account Azure Cosmos DB di livello gratuito

Distribuisci in Azure		 Questo modello crea un account Azure Cosmos DB di livello gratuito per l'API SQL con un database con velocità effettiva condivisa e contenitore.
Creare un account Azure Cosmos DB per l'API Core (SQL)

Distribuisci in Azure		 Questo modello crea un account Azure Cosmos per l'API Core (SQL) con un database e un contenitore con velocità effettiva con più altre opzioni.
API SQL dell'account Azure Cosmos DB con archivio analitico

Distribuisci in Azure		 Questo modello crea un account Azure Cosmos per l'API Core (SQL) con un database e un contenitore configurati con l'archivio analitico.
Creare un'API SQL dell'account Azure Cosmos DB con scalabilità automatica

Distribuisci in Azure		 Questo modello crea un account Azure Cosmos per l'API Core (SQL) con un database e un contenitore con velocità effettiva con scalabilità automatica con più altre opzioni.
Creare stored procedure dell'API Core (SQL) di Azure Cosmos DB

Distribuisci in Azure		 Questo modello crea un account Azure Cosmos DB per l'API Core (SQL) e un contenitore con una stored procedure, un trigger e una funzione definita dall'utente.
Distribuire Azure Data Explorer DB con connessione Cosmos DB

Distribuisci in Azure		 Distribuire Azure Data Explorer DB con la connessione Cosmos DB.

Definizione di risorsa del modello di Resource Manager

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

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

Formato di risorsa

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

{
  "type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases",
  "apiVersion": "2023-11-15",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "options": {
      "autoscaleSettings": {
        "maxThroughput": "int"
      },
      "throughput": "int"
    },
    "resource": {
      "createMode": "string",
      "id": "string",
      "restoreParameters": {
        "restoreSource": "string",
        "restoreTimestampInUtc": "string"
      }
    }
  }
}

Valori delle proprietà

databaseAccounts/sqlDatabases

Nome Descrizione Valore
tipo Tipo di risorsa 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases'
apiVersion Versione dell'API della risorsa '2023-11-15'
name Nome della risorsa

Informazioni su come impostare nomi e tipi per le risorse figlio nei modelli di Resource Manager JSON.		 stringa (obbligatorio)
posizione Posizione del gruppo di risorse a cui appartiene la risorsa. string
tags I tag sono un elenco di coppie chiave-valore che descrivono la risorsa. Questi tag possono essere utilizzati nella visualizzazione e nel raggruppamento di questa risorsa (tra gruppi di risorse). È possibile specificare un massimo di 15 tag per una risorsa. Ogni tag deve avere una chiave non superiore a 128 caratteri con un valore che non superi i 256 caratteri. Ad esempio, l'esperienza predefinita per un tipo di modello è impostata con "defaultExperience": "Cassandra". I valori correnti "defaultExperience" includono anche "Table", "Graph", "DocumentDB" e "MongoDB". Dizionario di nomi e valori di tag. Vedere Tag nei modelli
properties Proprietà per creare e aggiornare il database SQL di Azure Cosmos DB. SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetPro... (obbligatorio)

SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetPro...

Nome Descrizione Valore
opzioni Coppia chiave-valore di opzioni da applicare per la richiesta. Corrisponde alle intestazioni inviate con la richiesta. CreateUpdateOptionsOrSqlDatabaseGetPropertiesOptions
Risorsa Formato JSON standard di un database SQL SqlDatabaseResourceOrSqlDatabaseGetPropertiesResourc... (obbligatorio)

CreateUpdateOptionsOrSqlDatabaseGetPropertiesOptions

Nome Descrizione Valore
autoscaleSettings Specifica le impostazioni di scalabilità automatica. Nota: la velocità effettiva o la funzionalità autoscaleSettings è obbligatoria, ma non entrambe. Impostazioni di scalabilità automatica
throughput Unità richiesta al secondo. Ad esempio, "velocità effettiva": 10000. INT

Impostazioni di scalabilità automatica

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

SqlDatabaseResourceOrSqlDatabaseGetPropertiesResourc...

Nome Descrizione Valore
createMode Enumerazione per indicare la modalità di creazione delle risorse. Impostazione predefinita
'Restore'
id Nome del database SQL di Cosmos DB stringa (obbligatorio)
restoreParameters Parametri per indicare le informazioni sul ripristino ResourceRestoreParameters

ResourceRestoreParameters

Nome Descrizione Valore
restoreSource ID dell'account del database ripristinabile da cui deve essere avviato il ripristino. Ad esempio: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} string
restoreTimestampInUtc Ora in cui è necessario ripristinare l'account (formato ISO-8601). string

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Modello Descrizione
Creare un account Azure Cosmos DB di livello gratuito

Distribuisci in Azure		 Questo modello crea un account Azure Cosmos DB di livello gratuito per l'API SQL con un database con velocità effettiva condivisa e contenitore.
Creare un account Azure Cosmos DB per l'API Core (SQL)

Distribuisci in Azure		 Questo modello crea un account Azure Cosmos per l'API Core (SQL) con un database e un contenitore con velocità effettiva con più altre opzioni.
API SQL dell'account Azure Cosmos DB con archivio analitico

Distribuisci in Azure		 Questo modello crea un account Azure Cosmos per l'API Core (SQL) con un database e un contenitore configurati con l'archivio analitico.
Creare un'API SQL dell'account Azure Cosmos DB con scalabilità automatica

Distribuisci in Azure		 Questo modello crea un account Azure Cosmos per l'API Core (SQL) con un database e un contenitore con velocità effettiva con scalabilità automatica con più altre opzioni.
Creare stored procedure dell'API Core (SQL) di Azure Cosmos DB

Distribuisci in Azure		 Questo modello crea un account Azure Cosmos DB per l'API Core (SQL) e un contenitore con una stored procedure, un trigger e una funzione definita dall'utente.
Distribuire Azure Data Explorer DB con connessione Cosmos DB

Distribuisci in Azure		 Distribuire Azure Data Explorer DB con la connessione Cosmos DB.

Definizione della risorsa Terraform (provider AzAPI)

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

  • Gruppi di risorse

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

Formato di risorsa

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DocumentDB/databaseAccounts/sqlDatabases@2023-11-15"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      options = {
        autoscaleSettings = {
          maxThroughput = int
        }
        throughput = int
      }
      resource = {
        createMode = "string"
        id = "string"
        restoreParameters = {
          restoreSource = "string"
          restoreTimestampInUtc = "string"
        }
      }
    }
  })
}

Valori delle proprietà

databaseAccounts/sqlDatabases

Nome Descrizione Valore
tipo Tipo di risorsa "Microsoft.DocumentDB/databaseAccounts/sqlDatabases@2023-11-15"
name Nome della risorsa stringa (obbligatorio)
posizione Posizione del gruppo di risorse a cui appartiene la risorsa. string
parent_id ID della risorsa padre per questa risorsa. ID per la risorsa di tipo: databaseAccounts
tags I tag sono un elenco di coppie chiave-valore che descrivono la risorsa. Questi tag possono essere utilizzati nella visualizzazione e nel raggruppamento di questa risorsa (tra gruppi di risorse). È possibile specificare un massimo di 15 tag per una risorsa. Ogni tag deve avere una chiave non superiore a 128 caratteri con un valore che non superi i 256 caratteri. Ad esempio, l'esperienza predefinita per un tipo di modello è impostata con "defaultExperience": "Cassandra". I valori correnti "defaultExperience" includono anche "Table", "Graph", "DocumentDB" e "MongoDB". Dizionario di nomi e valori di tag.
properties Proprietà per creare e aggiornare il database SQL di Azure Cosmos DB. SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetPro... (obbligatorio)

SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetPro...

Nome Descrizione Valore
opzioni Coppia chiave-valore di opzioni da applicare per la richiesta. Corrisponde alle intestazioni inviate con la richiesta. CreateUpdateOptionsOrSqlDatabaseGetPropertiesOptions
Risorsa Formato JSON standard di un database SQL SqlDatabaseResourceOrSqlDatabaseGetPropertiesResourc... (obbligatorio)

CreateUpdateOptionsOrSqlDatabaseGetPropertiesOptions

Nome Descrizione Valore
autoscaleSettings Specifica le impostazioni di scalabilità automatica. Nota: la velocità effettiva o la funzionalità autoscaleSettings è obbligatoria, ma non entrambe. Impostazioni di scalabilità automatica
throughput Unità richiesta al secondo. Ad esempio, "velocità effettiva": 10000. INT

Impostazioni di scalabilità automatica

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

SqlDatabaseResourceOrSqlDatabaseGetPropertiesResourc...

Nome Descrizione Valore
createMode Enumerazione per indicare la modalità di creazione delle risorse. "Default"
"Ripristina"
id Nome del database SQL di Cosmos DB stringa (obbligatorio)
restoreParameters Parametri per indicare le informazioni sul ripristino ResourceRestoreParameters

ResourceRestoreParameters

Nome Descrizione Valore
restoreSource ID dell'account del database ripristinabile da cui deve essere avviato il ripristino. Ad esempio: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} string
restoreTimestampInUtc Ora in cui è necessario ripristinare l'account (formato ISO-8601). string