Condividi tramite

Database Microsoft.DocumentDBAccounts/sqlDatabases 2024-02-15-preview

  • Articolo

Definizione di risorsa Bicep

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

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

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

Formato risorsa

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

resource symbolicname 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases@2024-02-15-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à

Impostazioni di scalabilità automatica

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

Components1Jq1T4ISchemasManagedserviceidentityPropertiesUserassignedidentitiesAdditionalproperties

Nome Descrizione Valore

CreateUpdateOptionsOrSqlDatabaseGetPropertiesOptions

Nome Descrizione Valore
autoscaleSettings 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

ManagedServiceIdentity

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'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'
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

Microsoft.DocumentDB/databaseAccounts/sqlDatabases

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 il database SQL di Azure Cosmos DB. SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetProperties (obbligatorio)
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli

ResourceRestoreParameters

Nome Descrizione Valore
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

SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetProperties

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 SqlDatabaseResourceOrSqlDatabaseGetPropertiesResource (obbligatorio)

SqlDatabaseResourceOrSqlDatabaseGetPropertiesResource

Nome Descrizione Valore
createMode Enumerazione per indicare la modalità di creazione della risorsa. 'Default'
'PointInTimeRestore'
'Restore'
Id Nome del database SQL di Cosmos DB stringa (obbligatorio)
restoreParameters Parametri per indicare le informazioni sul ripristino ResourceRestoreParameters

Tag

Nome Descrizione Valore

Esempi di avvio rapido

Gli esempi di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Bicep File Descrizione
'API SQL dell'account Azure Cosmos DB con l'archivio analitico 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 account Azure Cosmos DB di livello gratuito Questo modello crea un account Azure Cosmos DB di livello gratuito per l'API SQL con un database con velocità effettiva e contenitore condivisi.
Creare un account Azure Cosmos DB per l'API Core (SQL) 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.
Creare un'API SQL dell'account Azure Cosmos DB con scalabilità automatica 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 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.
Crea un'app di microservizi Dapr usando app contenitore Creare un'app di microservizi Dapr usando App contenitore.
Crea un'app pub-sub-servicebus dapr usando app contenitore Creare un'app pub-sub servicebus dapr usando App contenitore.
Distribuire Azure Data Explorer DB con la connessione di Cosmos DB 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 a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

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

Formato risorsa

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

{
  "type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases",
  "apiVersion": "2024-02-15-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à

Impostazioni di scalabilità automatica

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

Components1Jq1T4ISchemasManagedserviceidentityPropertiesUserassignedidentitiesAdditionalproperties

Nome Descrizione Valore

CreateUpdateOptionsOrSqlDatabaseGetPropertiesOptions

Nome Descrizione Valore
autoscaleSettings 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

ManagedServiceIdentity

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'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'
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

Microsoft.DocumentDB/databaseAccounts/sqlDatabases

Nome Descrizione Valore
apiVersion Versione dell'API '2024-02-15-preview'
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 il database SQL di Azure Cosmos DB. SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetProperties (obbligatorio)
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli
digitare Tipo di risorsa 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases'

ResourceRestoreParameters

Nome Descrizione Valore
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

SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetProperties

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 SqlDatabaseResourceOrSqlDatabaseGetPropertiesResource (obbligatorio)

SqlDatabaseResourceOrSqlDatabaseGetPropertiesResource

Nome Descrizione Valore
createMode Enumerazione per indicare la modalità di creazione della risorsa. 'Default'
'PointInTimeRestore'
'Restore'
Id Nome del database SQL di Cosmos DB stringa (obbligatorio)
restoreParameters Parametri per indicare le informazioni sul ripristino ResourceRestoreParameters

Tag

Nome Descrizione Valore

Modelli di avvio rapido

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

Sagoma Descrizione
'API SQL dell'account Azure Cosmos DB con l'archivio analitico

Distribuire 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 account Azure Cosmos DB di livello gratuito

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

Distribuire 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.
Creare un'API SQL dell'account Azure Cosmos DB con scalabilità automatica

Distribuire 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

Distribuire 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.
Crea un'app di microservizi Dapr usando app contenitore

Distribuire in Azure 		Creare un'app di microservizi Dapr usando App contenitore.
Crea un'app pub-sub-servicebus dapr usando app contenitore

Distribuire in Azure 		Creare un'app pub-sub servicebus dapr usando App contenitore.
Distribuire Azure Data Explorer DB con la connessione di Cosmos DB

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

Definizione di risorsa Terraform (provider AzAPI)

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

  • gruppi di risorse

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

Formato 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@2024-02-15-preview"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      options = {
        autoscaleSettings = {
          maxThroughput = int
        }
        throughput = int
      }
      resource = {
        createMode = "string"
        id = "string"
        restoreParameters = {
          restoreSource = "string"
          restoreTimestampInUtc = "string"
          restoreWithTtlDisabled = bool
        }
      }
    }
  })
}

Valori delle proprietà

Impostazioni di scalabilità automatica

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

Components1Jq1T4ISchemasManagedserviceidentityPropertiesUserassignedidentitiesAdditionalproperties

Nome Descrizione Valore

CreateUpdateOptionsOrSqlDatabaseGetPropertiesOptions

Nome Descrizione Valore
autoscaleSettings 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

ManagedServiceIdentity

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'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'
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

Microsoft.DocumentDB/databaseAccounts/sqlDatabases

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 il database SQL di Azure Cosmos DB. SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetProperties (obbligatorio)
Tag Tag delle risorse Dizionario di nomi e valori di tag.
digitare Tipo di risorsa "Microsoft.DocumentDB/databaseAccounts/sqlDatabases@2024-02-15-preview"

ResourceRestoreParameters

Nome Descrizione Valore
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

SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetProperties

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 SqlDatabaseResourceOrSqlDatabaseGetPropertiesResource (obbligatorio)

SqlDatabaseResourceOrSqlDatabaseGetPropertiesResource

Nome Descrizione Valore
createMode Enumerazione per indicare la modalità di creazione della risorsa. 'Default'
'PointInTimeRestore'
'Restore'
Id Nome del database SQL di Cosmos DB stringa (obbligatorio)
restoreParameters Parametri per indicare le informazioni sul ripristino ResourceRestoreParameters

Tag

Nome Descrizione Valore