Microsoft. Sql managedInstances 2026-08-01-preview

Definizione di risorsa Bicep

Il tipo di risorsa managedInstances può essere distribuito con operazioni destinate a:

Resource groups - Vedi resource group

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

Esempi di utilizzo

Moduli verificati di Azure

Per distribuire questo tipo di risorsa, è possibile usare moduli verificati di Azure.

Modulo	Description
Istanza gestita di SQL	Modulo di Risorse AVM per Istanza gestita di SQL

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 l'istanza gestita di SQL all'interno della nuova rete virtuale	Distribuire Istanza gestita di database SQL di Azure all'interno di una nuova rete virtuale.

Formato risorsa

Per creare un Microsoft. Risorsa Sql/managedInstances, aggiungi il seguente Bicep al tuo template.

resource symbolicname 'Microsoft.Sql/managedInstances@2026-08-01-preview' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    administratorLogin: 'string'
    administratorLoginPassword: 'string'
    administrators: {
      administratorType: 'string'
      azureADOnlyAuthentication: bool
      login: 'string'
      principalType: 'string'
      sid: 'string'
      tenantId: 'string'
    }
    authenticationMetadata: 'string'
    collation: 'string'
    databaseFormat: 'string'
    dnsZonePartner: 'string'
    hybridSecondaryUsage: 'string'
    instancePoolId: 'string'
    isGeneralPurposeV2: bool
    keyId: 'string'
    licenseType: 'string'
    maintenanceConfigurationId: 'string'
    managedInstanceCreateMode: 'string'
    memorySizeInGB: int
    minimalTlsVersion: 'string'
    pricingModel: 'string'
    primaryUserAssignedIdentityId: 'string'
    proxyOverride: 'string'
    publicDataEndpointEnabled: bool
    requestedBackupStorageRedundancy: 'string'
    requestedLogicalAvailabilityZone: 'string'
    restorePointInTime: 'string'
    servicePrincipal: {
      type: 'string'
    }
    sourceManagedInstanceId: 'string'
    storageIOps: int
    storageSizeInGB: int
    storageThroughputMBps: int
    subnetId: 'string'
    timezoneId: 'string'
    vCores: int
    zoneRedundant: bool
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valori delle proprietà

Microsoft.Sql/managedInstances

Nome	Description	Value
identity	Identità di Azure Active Directory dell'istanza gestita.	ResourceIdentity
location	Posizione geografica in cui risiede la risorsa	stringa (obbligatorio)
nome	Nome della risorsa	stringa (obbligatorio)
properties	Proprietà delle risorse.	ManagedInstanceProperties
sku	SKU dell'istanza gestita. Valori consentiti per sku.name: GP_Gen5 (General Purpose, serie standard); GP_G8IM (General Purpose, serie Premium); GP_G8IH (per utilizzo generico, ottimizzata per la memoria della serie Premium); BC_Gen5 (Business Critical, Standard-Series); BC_G8IM (Business Critical, serie Premium); BC_G8IH (Business Critical, ottimizzata per la memoria della serie Premium).	Sku
etichette	Tag delle risorse	Dizionario di nomi e valori di tag. Vedi tag nei template

ManagedInstanceExternalAdministrator

Nome	Description	Value
administratorType	Tipo dell'amministratore di sever.	'ActiveDirectory'
azureADOnlyAuthentication	Autenticazione di Azure Active Directory abilitata solo.	bool
Accesso al sistema	Nome di accesso dell'amministratore del server.	string
principalType	Tipo di entità dell'amministratore di sever.	'Application' 'Gruppo' 'User'
sid	SID (ID oggetto) dell'amministratore del server.	string Vincoli: Lunghezza minima = 36 Lunghezza massima = 36 Modello = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
tenantId	ID tenant dell'amministratore.	string Vincoli: Lunghezza minima = 36 Lunghezza massima = 36 Modello = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`

ManagedInstanceProperties

Nome	Description	Value
administratorLogin	Nome utente amministratore per l'istanza gestita. Può essere specificato solo quando l'istanza gestita viene creata (ed è necessaria per la creazione).	string
administratorLoginPassword	Password di accesso dell'amministratore (necessaria per la creazione dell'istanza gestita).	string Vincoli: Valore sensibile. Passare come parametro sicuro.
administrators	L'amministratore di Azure Active Directory può essere utilizzato durante la creazione delle istanze e per gli aggiornamenti delle istanze, ad eccezione della proprietà azureADOnlyAuthentication. Per aggiornare la proprietà azureADOnlyAuthentication, è necessario usare una singola API.	ManagedInstanceExternalAdministrator
authenticationMetadata	Modalità di ricerca dei metadati di autenticazione dell'istanza gestita.	'AzureAD' 'Paired' 'Windows'
collation	Regole di confronto dell'istanza gestita.	string
databaseFormat	Specifica il formato interno dei database dell'istanza specifici della versione del motore SQL.	'AlwaysUpToDate' 'SQLServer2022' 'SQLServer2025'
dnsZonePartner	ID risorsa di un'altra istanza gestita la cui zona DNS questa istanza gestita condividerà dopo la creazione.	string
hybridSecondaryUsage	Uso secondario ibrido. I valori possibili sono 'Active' (valore predefinito) e 'Passive' (il cliente usa il database secondario come ripristino di emergenza passivo).	'Attivo' 'Passive'
instancePoolId	ID del pool di istanze a cui appartiene il server gestito.	string
isGeneralPurposeV2	Indica se si tratta di una variante GPv2 dell'edizione Per utilizzo generico.	bool
keyId	URI della chiave da usare per la crittografia.	string
licenseType	Tipo di licenza. I valori possibili sono "LicenseIncluded" (prezzo regolare inclusivo di una nuova licenza SQL) e "BasePrice" (prezzo AHB scontato per portare le proprie licenze SQL).	'BasePrice' 'Licenza inclusa'
maintenanceConfigurationId	Specifica l'ID di configurazione della manutenzione da applicare a questa istanza gestita.	string
managedInstanceCreateMode	Specifica la modalità di creazione del database. Impostazione predefinita: creazione di istanze regolari. Ripristino: crea un'istanza ripristinando un set di backup a un punto specifico nel tempo. È necessario specificare RestorePointInTime e SourceManagedInstanceId.	'Default' 'PointInTimeRestore'
Dimensionedella memoriaInGB	Dimensione della memoria in GB. Valore minimo: 28. Valore massimo: 870. Il valore minimo e massimo dipendono dal numero di vCore e dal livello di servizio. Per saperne di più sui limiti delle risorse: https://aka.ms/mi-resource-limits-api.	int
minimalTlsVersion	Versione minima di TLS. Valori consentiti: 'Nessuno', '1.0', '1.1', '1.2'	string
pricingModel	Modello di pricing di Istanza gestita.	'Freemium' 'Regular'
primaryUserAssignedIdentityId	ID risorsa di un'identità assegnata dall'utente da usare per impostazione predefinita.	string
proxyOverride	Tipo di connessione utilizzato per la connessione all'istanza di .	'Default' 'Proxy' 'Redirect'
publicDataEndpointEnabled	Indica se l'endpoint dati pubblico è abilitato o meno.	bool
requestedBackupStorageRedundancy	Tipo di account di archiviazione da usare per archiviare i backup per questa istanza. Le opzioni sono Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage)	'Geo' 'GeoZone' 'Locale' 'Zona'
requestedLogicalAvailabilityZone	Specifica la zona di disponibilità logica a cui è fissata Istanza gestita.	'1' '2' '3' 'Nessuna preferenza'
restorePointInTime	Specifica il punto nel tempo (formato ISO8601) del database di origine che verrà ripristinato per creare il nuovo database.	string
servicePrincipal	Entità servizio dell'istanza gestita.	ServicePrincipal
sourceManagedInstanceId	Identificatore della risorsa dell'istanza gestita di origine associata all'operazione di creazione di questa istanza.	string
storageIOps	Operazioni di I/O al secondo di archiviazione. Valore minimo: 300. Valore massimo: 80000. Incrementi di 1 operazioni di I/O al secondo consentite solo. Il valore massimo dipende dalla famiglia di hardware e dal numero di vCore selezionati.	int
storageSizeInGB	Dimensioni di archiviazione in GB. Valore minimo: 32. Valore massimo: 32768. Incrementi di soli 32 GB consentiti. Il valore massimo dipende dalla famiglia di hardware e dal numero di vCore selezionati.	int
storageThroughputMBps	Il parametro MBps della velocità effettiva di archiviazione non è supportato nell'operazione di creazione/aggiornamento dell'istanza.	int
subnetId	ID risorsa subnet per l'istanza gestita.	string
timezoneId	ID del fuso orario. I valori consentiti sono fusi orari supportati da Windows. Windows conserva i dettagli sui fusi orari supportati, incluso l'id, nel registro sotto KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. È possibile ottenere questi valori del Registro di sistema tramite SQL Server eseguendo query su SELECT name AS timezone_id FROM sys.time_zone_info. È anche possibile ottenere un elenco di ID eseguendo [System.TimeZoneInfo]::GetSystemTimeZones() in PowerShell. Un esempio di ID fuso orario valido è "Pacific Standard Time" o "W. Ora solare europa".	string
vCores	Numero di vCore. Valori consentiti: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. I vCore supportati dipendono dalla famiglia di hardware e dal livello di servizio selezionati.	int
di zonaRidondante	Se la ridondanza della zona è abilitata o meno.	bool

ResourceIdentity

Nome	Description	Value
type	Tipo di identità. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di azure Active Directory per la risorsa.	'Nessuno' 'Assegnato dal sistema' 'SystemAssigned,UserAssigned' 'UserAssigned'
userAssignedIdentities	ID risorsa delle identità assegnate dall'utente da usare	ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Nome	Description	Value

ServicePrincipal

Nome	Description	Value
type	Tipo di entità servizio.	'Nessuno' 'Assegnato dal sistema'

Sku

Nome	Description	Value
capacity	Capacità dello SKU specifico.	int
family	Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui.	string
nome	Il nome dello SKU, in genere, una lettera + codice numerico, ad esempio P3.	stringa (obbligatorio)
size	Dimensioni dello SKU specifico	string
tier	Il livello o l'edizione dello SKU specifico, ad esempio Basic, Premium.	string

TrackedResourceTags

Nome	Description	Value

UserIdentity

Nome	Description	Value

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa managedInstances 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.

Template	Description
Creare l'istanza gestita di SQL all'interno della nuova rete virtuale	Distribuire Istanza gestita di database SQL di Azure all'interno di una nuova rete virtuale.
Creare l'istanza gestita di SQL con l'invio di log e metriche	Questo modello consente di distribuire l'istanza gestita di SQL e risorse aggiuntive usate per l'archiviazione di log e metriche (area di lavoro diagnostica, account di archiviazione, hub eventi).
Creare l'istanza gestita di SQL con jumpbox all'interno di una nuova rete virtuale	Distribuire Istanza gestita di database SQL di Azure e JumpBox con SSMS all'interno di una nuova rete virtuale.
Creare l'istanza gestita di SQL con connessione da punto a sito configurata	Distribuire Istanza gestita di database SQL di Azure e gateway di rete virtuale configurati per la connessione da punto a sito all'interno della nuova rete virtuale.
Distribuisci Istanza gestita di SQL con Networking	Distribuire UDR e NSG per supportare Istanza gestita di SQL di Azure e distribuire la Istanza gestita

Formato risorsa

Per creare un Microsoft. Sql/managedInstances, aggiungi il seguente JSON al tuo template.

{
  "type": "Microsoft.Sql/managedInstances",
  "apiVersion": "2026-08-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "administratorLogin": "string",
    "administratorLoginPassword": "string",
    "administrators": {
      "administratorType": "string",
      "azureADOnlyAuthentication": "bool",
      "login": "string",
      "principalType": "string",
      "sid": "string",
      "tenantId": "string"
    },
    "authenticationMetadata": "string",
    "collation": "string",
    "databaseFormat": "string",
    "dnsZonePartner": "string",
    "hybridSecondaryUsage": "string",
    "instancePoolId": "string",
    "isGeneralPurposeV2": "bool",
    "keyId": "string",
    "licenseType": "string",
    "maintenanceConfigurationId": "string",
    "managedInstanceCreateMode": "string",
    "memorySizeInGB": "int",
    "minimalTlsVersion": "string",
    "pricingModel": "string",
    "primaryUserAssignedIdentityId": "string",
    "proxyOverride": "string",
    "publicDataEndpointEnabled": "bool",
    "requestedBackupStorageRedundancy": "string",
    "requestedLogicalAvailabilityZone": "string",
    "restorePointInTime": "string",
    "servicePrincipal": {
      "type": "string"
    },
    "sourceManagedInstanceId": "string",
    "storageIOps": "int",
    "storageSizeInGB": "int",
    "storageThroughputMBps": "int",
    "subnetId": "string",
    "timezoneId": "string",
    "vCores": "int",
    "zoneRedundant": "bool"
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valori delle proprietà

Microsoft.Sql/managedInstances

Nome	Description	Value
apiVersion	Versione dell'API	'Anteprima 2026-08-01-Preview'
identity	Identità di Azure Active Directory dell'istanza gestita.	ResourceIdentity
location	Posizione geografica in cui risiede la risorsa	stringa (obbligatorio)
nome	Nome della risorsa	stringa (obbligatorio)
properties	Proprietà delle risorse.	ManagedInstanceProperties
sku	SKU dell'istanza gestita. Valori consentiti per sku.name: GP_Gen5 (General Purpose, serie standard); GP_G8IM (General Purpose, serie Premium); GP_G8IH (per utilizzo generico, ottimizzata per la memoria della serie Premium); BC_Gen5 (Business Critical, Standard-Series); BC_G8IM (Business Critical, serie Premium); BC_G8IH (Business Critical, ottimizzata per la memoria della serie Premium).	Sku
etichette	Tag delle risorse	Dizionario di nomi e valori di tag. Vedi tag nei template
type	Tipo di risorsa	'Microsoft. Sql/managedInstances'

ManagedInstanceExternalAdministrator

Nome	Description	Value
administratorType	Tipo dell'amministratore di sever.	'ActiveDirectory'
azureADOnlyAuthentication	Autenticazione di Azure Active Directory abilitata solo.	bool
Accesso al sistema	Nome di accesso dell'amministratore del server.	string
principalType	Tipo di entità dell'amministratore di sever.	'Application' 'Gruppo' 'User'
sid	SID (ID oggetto) dell'amministratore del server.	string Vincoli: Lunghezza minima = 36 Lunghezza massima = 36 Modello = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
tenantId	ID tenant dell'amministratore.	string Vincoli: Lunghezza minima = 36 Lunghezza massima = 36 Modello = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`

ManagedInstanceProperties

Nome	Description	Value
administratorLogin	Nome utente amministratore per l'istanza gestita. Può essere specificato solo quando l'istanza gestita viene creata (ed è necessaria per la creazione).	string
administratorLoginPassword	Password di accesso dell'amministratore (necessaria per la creazione dell'istanza gestita).	string Vincoli: Valore sensibile. Passare come parametro sicuro.
administrators	L'amministratore di Azure Active Directory può essere utilizzato durante la creazione delle istanze e per gli aggiornamenti delle istanze, ad eccezione della proprietà azureADOnlyAuthentication. Per aggiornare la proprietà azureADOnlyAuthentication, è necessario usare una singola API.	ManagedInstanceExternalAdministrator
authenticationMetadata	Modalità di ricerca dei metadati di autenticazione dell'istanza gestita.	'AzureAD' 'Paired' 'Windows'
collation	Regole di confronto dell'istanza gestita.	string
databaseFormat	Specifica il formato interno dei database dell'istanza specifici della versione del motore SQL.	'AlwaysUpToDate' 'SQLServer2022' 'SQLServer2025'
dnsZonePartner	ID risorsa di un'altra istanza gestita la cui zona DNS questa istanza gestita condividerà dopo la creazione.	string
hybridSecondaryUsage	Uso secondario ibrido. I valori possibili sono 'Active' (valore predefinito) e 'Passive' (il cliente usa il database secondario come ripristino di emergenza passivo).	'Attivo' 'Passive'
instancePoolId	ID del pool di istanze a cui appartiene il server gestito.	string
isGeneralPurposeV2	Indica se si tratta di una variante GPv2 dell'edizione Per utilizzo generico.	bool
keyId	URI della chiave da usare per la crittografia.	string
licenseType	Tipo di licenza. I valori possibili sono "LicenseIncluded" (prezzo regolare inclusivo di una nuova licenza SQL) e "BasePrice" (prezzo AHB scontato per portare le proprie licenze SQL).	'BasePrice' 'Licenza inclusa'
maintenanceConfigurationId	Specifica l'ID di configurazione della manutenzione da applicare a questa istanza gestita.	string
managedInstanceCreateMode	Specifica la modalità di creazione del database. Impostazione predefinita: creazione di istanze regolari. Ripristino: crea un'istanza ripristinando un set di backup a un punto specifico nel tempo. È necessario specificare RestorePointInTime e SourceManagedInstanceId.	'Default' 'PointInTimeRestore'
Dimensionedella memoriaInGB	Dimensione della memoria in GB. Valore minimo: 28. Valore massimo: 870. Il valore minimo e massimo dipendono dal numero di vCore e dal livello di servizio. Per saperne di più sui limiti delle risorse: https://aka.ms/mi-resource-limits-api.	int
minimalTlsVersion	Versione minima di TLS. Valori consentiti: 'Nessuno', '1.0', '1.1', '1.2'	string
pricingModel	Modello di pricing di Istanza gestita.	'Freemium' 'Regular'
primaryUserAssignedIdentityId	ID risorsa di un'identità assegnata dall'utente da usare per impostazione predefinita.	string
proxyOverride	Tipo di connessione utilizzato per la connessione all'istanza di .	'Default' 'Proxy' 'Redirect'
publicDataEndpointEnabled	Indica se l'endpoint dati pubblico è abilitato o meno.	bool
requestedBackupStorageRedundancy	Tipo di account di archiviazione da usare per archiviare i backup per questa istanza. Le opzioni sono Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage)	'Geo' 'GeoZone' 'Locale' 'Zona'
requestedLogicalAvailabilityZone	Specifica la zona di disponibilità logica a cui è fissata Istanza gestita.	'1' '2' '3' 'Nessuna preferenza'
restorePointInTime	Specifica il punto nel tempo (formato ISO8601) del database di origine che verrà ripristinato per creare il nuovo database.	string
servicePrincipal	Entità servizio dell'istanza gestita.	ServicePrincipal
sourceManagedInstanceId	Identificatore della risorsa dell'istanza gestita di origine associata all'operazione di creazione di questa istanza.	string
storageIOps	Operazioni di I/O al secondo di archiviazione. Valore minimo: 300. Valore massimo: 80000. Incrementi di 1 operazioni di I/O al secondo consentite solo. Il valore massimo dipende dalla famiglia di hardware e dal numero di vCore selezionati.	int
storageSizeInGB	Dimensioni di archiviazione in GB. Valore minimo: 32. Valore massimo: 32768. Incrementi di soli 32 GB consentiti. Il valore massimo dipende dalla famiglia di hardware e dal numero di vCore selezionati.	int
storageThroughputMBps	Il parametro MBps della velocità effettiva di archiviazione non è supportato nell'operazione di creazione/aggiornamento dell'istanza.	int
subnetId	ID risorsa subnet per l'istanza gestita.	string
timezoneId	ID del fuso orario. I valori consentiti sono fusi orari supportati da Windows. Windows conserva i dettagli sui fusi orari supportati, incluso l'id, nel registro sotto KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. È possibile ottenere questi valori del Registro di sistema tramite SQL Server eseguendo query su SELECT name AS timezone_id FROM sys.time_zone_info. È anche possibile ottenere un elenco di ID eseguendo [System.TimeZoneInfo]::GetSystemTimeZones() in PowerShell. Un esempio di ID fuso orario valido è "Pacific Standard Time" o "W. Ora solare europa".	string
vCores	Numero di vCore. Valori consentiti: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. I vCore supportati dipendono dalla famiglia di hardware e dal livello di servizio selezionati.	int
di zonaRidondante	Se la ridondanza della zona è abilitata o meno.	bool

ResourceIdentity

Nome	Description	Value
type	Tipo di identità. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di azure Active Directory per la risorsa.	'Nessuno' 'Assegnato dal sistema' 'SystemAssigned,UserAssigned' 'UserAssigned'
userAssignedIdentities	ID risorsa delle identità assegnate dall'utente da usare	ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Nome	Description	Value

ServicePrincipal

Nome	Description	Value
type	Tipo di entità servizio.	'Nessuno' 'Assegnato dal sistema'

Sku

Nome	Description	Value
capacity	Capacità dello SKU specifico.	int
family	Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui.	string
nome	Il nome dello SKU, in genere, una lettera + codice numerico, ad esempio P3.	stringa (obbligatorio)
size	Dimensioni dello SKU specifico	string
tier	Il livello o l'edizione dello SKU specifico, ad esempio Basic, Premium.	string

TrackedResourceTags

Nome	Description	Value

UserIdentity

Nome	Description	Value

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa managedInstances 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

Moduli verificati di Azure

Per distribuire questo tipo di risorsa, è possibile usare moduli verificati di Azure.

Modulo	Description
Istanza gestita di SQL	Modulo di Risorse AVM per Istanza gestita di SQL

Formato risorsa

Per creare un Microsoft. Sql/managedInstances, aggiungi il seguente Terraform al tuo template.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/managedInstances@2026-08-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      administratorLogin = "string"
      administratorLoginPassword = "string"
      administrators = {
        administratorType = "string"
        azureADOnlyAuthentication = bool
        login = "string"
        principalType = "string"
        sid = "string"
        tenantId = "string"
      }
      authenticationMetadata = "string"
      collation = "string"
      databaseFormat = "string"
      dnsZonePartner = "string"
      hybridSecondaryUsage = "string"
      instancePoolId = "string"
      isGeneralPurposeV2 = bool
      keyId = "string"
      licenseType = "string"
      maintenanceConfigurationId = "string"
      managedInstanceCreateMode = "string"
      memorySizeInGB = int
      minimalTlsVersion = "string"
      pricingModel = "string"
      primaryUserAssignedIdentityId = "string"
      proxyOverride = "string"
      publicDataEndpointEnabled = bool
      requestedBackupStorageRedundancy = "string"
      requestedLogicalAvailabilityZone = "string"
      restorePointInTime = "string"
      servicePrincipal = {
        type = "string"
      }
      sourceManagedInstanceId = "string"
      storageIOps = int
      storageSizeInGB = int
      storageThroughputMBps = int
      subnetId = "string"
      timezoneId = "string"
      vCores = int
      zoneRedundant = bool
    }
    sku = {
      capacity = int
      family = "string"
      name = "string"
      size = "string"
      tier = "string"
    }
  }
}

Valori delle proprietà

Microsoft.Sql/managedInstances

Nome	Description	Value
identity	Identità di Azure Active Directory dell'istanza gestita.	ResourceIdentity
location	Posizione geografica in cui risiede la risorsa	stringa (obbligatorio)
nome	Nome della risorsa	stringa (obbligatorio)
properties	Proprietà delle risorse.	ManagedInstanceProperties
sku	SKU dell'istanza gestita. Valori consentiti per sku.name: GP_Gen5 (General Purpose, serie standard); GP_G8IM (General Purpose, serie Premium); GP_G8IH (per utilizzo generico, ottimizzata per la memoria della serie Premium); BC_Gen5 (Business Critical, Standard-Series); BC_G8IM (Business Critical, serie Premium); BC_G8IH (Business Critical, ottimizzata per la memoria della serie Premium).	Sku
etichette	Tag delle risorse	Dizionario di nomi e valori di tag.
type	Tipo di risorsa	"Microsoft. Sql/managedInstances@2026-08-01-anteprima"

ManagedInstanceExternalAdministrator

Nome	Description	Value
administratorType	Tipo dell'amministratore di sever.	'ActiveDirectory'
azureADOnlyAuthentication	Autenticazione di Azure Active Directory abilitata solo.	bool
Accesso al sistema	Nome di accesso dell'amministratore del server.	string
principalType	Tipo di entità dell'amministratore di sever.	'Application' 'Gruppo' 'User'
sid	SID (ID oggetto) dell'amministratore del server.	string Vincoli: Lunghezza minima = 36 Lunghezza massima = 36 Modello = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
tenantId	ID tenant dell'amministratore.	string Vincoli: Lunghezza minima = 36 Lunghezza massima = 36 Modello = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`

ManagedInstanceProperties

Nome	Description	Value
administratorLogin	Nome utente amministratore per l'istanza gestita. Può essere specificato solo quando l'istanza gestita viene creata (ed è necessaria per la creazione).	string
administratorLoginPassword	Password di accesso dell'amministratore (necessaria per la creazione dell'istanza gestita).	string Vincoli: Valore sensibile. Passare come parametro sicuro.
administrators	L'amministratore di Azure Active Directory può essere utilizzato durante la creazione delle istanze e per gli aggiornamenti delle istanze, ad eccezione della proprietà azureADOnlyAuthentication. Per aggiornare la proprietà azureADOnlyAuthentication, è necessario usare una singola API.	ManagedInstanceExternalAdministrator
authenticationMetadata	Modalità di ricerca dei metadati di autenticazione dell'istanza gestita.	'AzureAD' 'Paired' 'Windows'
collation	Regole di confronto dell'istanza gestita.	string
databaseFormat	Specifica il formato interno dei database dell'istanza specifici della versione del motore SQL.	'AlwaysUpToDate' 'SQLServer2022' 'SQLServer2025'
dnsZonePartner	ID risorsa di un'altra istanza gestita la cui zona DNS questa istanza gestita condividerà dopo la creazione.	string
hybridSecondaryUsage	Uso secondario ibrido. I valori possibili sono 'Active' (valore predefinito) e 'Passive' (il cliente usa il database secondario come ripristino di emergenza passivo).	'Attivo' 'Passive'
instancePoolId	ID del pool di istanze a cui appartiene il server gestito.	string
isGeneralPurposeV2	Indica se si tratta di una variante GPv2 dell'edizione Per utilizzo generico.	bool
keyId	URI della chiave da usare per la crittografia.	string
licenseType	Tipo di licenza. I valori possibili sono "LicenseIncluded" (prezzo regolare inclusivo di una nuova licenza SQL) e "BasePrice" (prezzo AHB scontato per portare le proprie licenze SQL).	'BasePrice' 'Licenza inclusa'
maintenanceConfigurationId	Specifica l'ID di configurazione della manutenzione da applicare a questa istanza gestita.	string
managedInstanceCreateMode	Specifica la modalità di creazione del database. Impostazione predefinita: creazione di istanze regolari. Ripristino: crea un'istanza ripristinando un set di backup a un punto specifico nel tempo. È necessario specificare RestorePointInTime e SourceManagedInstanceId.	'Default' 'PointInTimeRestore'
Dimensionedella memoriaInGB	Dimensione della memoria in GB. Valore minimo: 28. Valore massimo: 870. Il valore minimo e massimo dipendono dal numero di vCore e dal livello di servizio. Per saperne di più sui limiti delle risorse: https://aka.ms/mi-resource-limits-api.	int
minimalTlsVersion	Versione minima di TLS. Valori consentiti: 'Nessuno', '1.0', '1.1', '1.2'	string
pricingModel	Modello di pricing di Istanza gestita.	'Freemium' 'Regular'
primaryUserAssignedIdentityId	ID risorsa di un'identità assegnata dall'utente da usare per impostazione predefinita.	string
proxyOverride	Tipo di connessione utilizzato per la connessione all'istanza di .	'Default' 'Proxy' 'Redirect'
publicDataEndpointEnabled	Indica se l'endpoint dati pubblico è abilitato o meno.	bool
requestedBackupStorageRedundancy	Tipo di account di archiviazione da usare per archiviare i backup per questa istanza. Le opzioni sono Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage)	'Geo' 'GeoZone' 'Locale' 'Zona'
requestedLogicalAvailabilityZone	Specifica la zona di disponibilità logica a cui è fissata Istanza gestita.	'1' '2' '3' 'Nessuna preferenza'
restorePointInTime	Specifica il punto nel tempo (formato ISO8601) del database di origine che verrà ripristinato per creare il nuovo database.	string
servicePrincipal	Entità servizio dell'istanza gestita.	ServicePrincipal
sourceManagedInstanceId	Identificatore della risorsa dell'istanza gestita di origine associata all'operazione di creazione di questa istanza.	string
storageIOps	Operazioni di I/O al secondo di archiviazione. Valore minimo: 300. Valore massimo: 80000. Incrementi di 1 operazioni di I/O al secondo consentite solo. Il valore massimo dipende dalla famiglia di hardware e dal numero di vCore selezionati.	int
storageSizeInGB	Dimensioni di archiviazione in GB. Valore minimo: 32. Valore massimo: 32768. Incrementi di soli 32 GB consentiti. Il valore massimo dipende dalla famiglia di hardware e dal numero di vCore selezionati.	int
storageThroughputMBps	Il parametro MBps della velocità effettiva di archiviazione non è supportato nell'operazione di creazione/aggiornamento dell'istanza.	int
subnetId	ID risorsa subnet per l'istanza gestita.	string
timezoneId	ID del fuso orario. I valori consentiti sono fusi orari supportati da Windows. Windows conserva i dettagli sui fusi orari supportati, incluso l'id, nel registro sotto KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. È possibile ottenere questi valori del Registro di sistema tramite SQL Server eseguendo query su SELECT name AS timezone_id FROM sys.time_zone_info. È anche possibile ottenere un elenco di ID eseguendo [System.TimeZoneInfo]::GetSystemTimeZones() in PowerShell. Un esempio di ID fuso orario valido è "Pacific Standard Time" o "W. Ora solare europa".	string
vCores	Numero di vCore. Valori consentiti: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. I vCore supportati dipendono dalla famiglia di hardware e dal livello di servizio selezionati.	int
di zonaRidondante	Se la ridondanza della zona è abilitata o meno.	bool

ResourceIdentity

Nome	Description	Value
type	Tipo di identità. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di azure Active Directory per la risorsa.	'Nessuno' 'Assegnato dal sistema' 'SystemAssigned,UserAssigned' 'UserAssigned'
userAssignedIdentities	ID risorsa delle identità assegnate dall'utente da usare	ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Nome	Description	Value

ServicePrincipal

Nome	Description	Value
type	Tipo di entità servizio.	'Nessuno' 'Assegnato dal sistema'

Sku

Nome	Description	Value
capacity	Capacità dello SKU specifico.	int
family	Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui.	string
nome	Il nome dello SKU, in genere, una lettera + codice numerico, ad esempio P3.	stringa (obbligatorio)
size	Dimensioni dello SKU specifico	string
tier	Il livello o l'edizione dello SKU specifico, ad esempio Basic, Premium.	string

TrackedResourceTags

Nome	Description	Value

UserIdentity

Nome	Description	Value

Commenti e suggerimenti

Questa pagina è stata utile?

Ultimo aggiornamento: 2026-09-21

Microsoft. Sql managedInstances 2026-08-01-preview

Definizione di risorsa Bicep

Esempi di utilizzo

Moduli verificati di Azure

Esempi di avvio rapido di Azure

Formato risorsa

Valori delle proprietà

Microsoft.Sql/managedInstances

ManagedInstanceExternalAdministrator

ManagedInstanceProperties

ResourceIdentity

ResourceIdentityUserAssignedIdentities

ServicePrincipal

Sku

TrackedResourceTags

UserIdentity

Definizione di risorsa del modello di Resource Manager

Esempi di utilizzo

Modelli di avvio rapido di Azure

Formato risorsa

Valori delle proprietà

Microsoft.Sql/managedInstances

ManagedInstanceExternalAdministrator

ManagedInstanceProperties

ResourceIdentity

ResourceIdentityUserAssignedIdentities

ServicePrincipal

Sku

TrackedResourceTags

UserIdentity

Definizione di risorsa Terraform (provider AzAPI)

Esempi di utilizzo

Moduli verificati di Azure

Formato risorsa

Valori delle proprietà

Microsoft.Sql/managedInstances

ManagedInstanceExternalAdministrator

ManagedInstanceProperties

ResourceIdentity

ResourceIdentityUserAssignedIdentities

ServicePrincipal

Sku

TrackedResourceTags

UserIdentity

Commenti e suggerimenti

Risorse aggiuntive