Microsoft.Sql managedInstances

Definizione di risorsa Bicep

Il tipo di risorsa managedInstances 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.Sql/managedInstances, aggiungere il bicep seguente al modello.

resource symbolicname 'Microsoft.Sql/managedInstances@2024-11-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

Name	Description	Value
identity	Identità di Azure Active Directory dell'istanza gestita.	ResourceIdentity
location	Percorso della risorsa.	stringa (obbligatorio)
name	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
tags	Tag delle risorse	Dizionario di nomi e valori di tag. Vedere tag nei modelli

ManagedInstanceExternalAdministrator

Name	Description	Value
administratorType	Tipo dell'amministratore di sever.	'ActiveDirectory'
azureADOnlyAuthentication	Autenticazione di Azure Active Directory abilitata solo.	bool
login	Nome di accesso dell'amministratore del server.	string
principalType	Tipo di entità dell'amministratore di sever.	'Application' 'Group' 'User'
sid	SID (ID oggetto) dell'amministratore del server.	string Constraints: 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 Constraints: Lunghezza minima = 36 Lunghezza massima = 36 Modello = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`

ManagedInstanceProperties

Name	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 Constraints: Valore sensibile. Passare come parametro sicuro.
administrators	L'amministratore di Azure Active Directory può essere usato durante la creazione dell'istanza e per gli aggiornamenti dell'istanza, 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).	'Active' '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' 'LicenseIncluded'
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 determinazione dei prezzi 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' 'Local' 'Zone'
requestedLogicalAvailabilityZone	Specifica la zona di disponibilità logica a cui è aggiunta Istanza gestita.	'1' '2' '3' 'NoPreference'
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	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 mantiene i dettagli sui fusi orari supportati, incluso l'ID, nel Registro di sistema in KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fusi orari. È 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
zoneRedundant	Se la ridondanza della zona è abilitata o meno.	bool

ResourceIdentity

Name	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.	'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned'
userAssignedIdentities	ID risorsa delle identità assegnate dall'utente da usare	ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Name	Description	Value

ServicePrincipal

Name	Description	Value
type	Tipo di entità servizio.	'None' 'SystemAssigned'

Sku

Name	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
name	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

Name	Description	Value

UserIdentity

Name	Description	Value

Esempi di utilizzo

Moduli verificati di Azure

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

Module	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.

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa managedInstances 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.Sql/managedInstances, aggiungere il codice JSON seguente al modello.

{
  "type": "Microsoft.Sql/managedInstances",
  "apiVersion": "2024-11-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

Name	Description	Value
apiVersion	Versione dell'API	'2024-11-01-preview'
identity	Identità di Azure Active Directory dell'istanza gestita.	ResourceIdentity
location	Percorso della risorsa.	stringa (obbligatorio)
name	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
tags	Tag delle risorse	Dizionario di nomi e valori di tag. Vedere tag nei modelli
type	Tipo di risorsa	'Microsoft.Sql/managedInstances'

ManagedInstanceExternalAdministrator

Name	Description	Value
administratorType	Tipo dell'amministratore di sever.	'ActiveDirectory'
azureADOnlyAuthentication	Autenticazione di Azure Active Directory abilitata solo.	bool
login	Nome di accesso dell'amministratore del server.	string
principalType	Tipo di entità dell'amministratore di sever.	'Application' 'Group' 'User'
sid	SID (ID oggetto) dell'amministratore del server.	string Constraints: 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 Constraints: Lunghezza minima = 36 Lunghezza massima = 36 Modello = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`

ManagedInstanceProperties

Name	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 Constraints: Valore sensibile. Passare come parametro sicuro.
administrators	L'amministratore di Azure Active Directory può essere usato durante la creazione dell'istanza e per gli aggiornamenti dell'istanza, 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).	'Active' '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' 'LicenseIncluded'
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 determinazione dei prezzi 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' 'Local' 'Zone'
requestedLogicalAvailabilityZone	Specifica la zona di disponibilità logica a cui è aggiunta Istanza gestita.	'1' '2' '3' 'NoPreference'
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	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 mantiene i dettagli sui fusi orari supportati, incluso l'ID, nel Registro di sistema in KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fusi orari. È 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
zoneRedundant	Se la ridondanza della zona è abilitata o meno.	bool

ResourceIdentity

Name	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.	'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned'
userAssignedIdentities	ID risorsa delle identità assegnate dall'utente da usare	ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Name	Description	Value

ServicePrincipal

Name	Description	Value
type	Tipo di entità servizio.	'None' 'SystemAssigned'

Sku

Name	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
name	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

Name	Description	Value

UserIdentity

Name	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 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.
Distribuire Istanza gestita di SQL con rete	Distribuire la route definita dall'utente e il gruppo di sicurezza di rete per supportare Istanza gestita di SQL di Azure e distribuire l'istanza gestita

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, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.Sql/managedInstances, aggiungere il codice Terraform seguente al modello.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/managedInstances@2024-11-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

Name	Description	Value
identity	Identità di Azure Active Directory dell'istanza gestita.	ResourceIdentity
location	Percorso della risorsa.	stringa (obbligatorio)
name	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
tags	Tag delle risorse	Dizionario di nomi e valori di tag.
type	Tipo di risorsa	"Microsoft.Sql/managedInstances@2024-11-01-preview"

ManagedInstanceExternalAdministrator

Name	Description	Value
administratorType	Tipo dell'amministratore di sever.	'ActiveDirectory'
azureADOnlyAuthentication	Autenticazione di Azure Active Directory abilitata solo.	bool
login	Nome di accesso dell'amministratore del server.	string
principalType	Tipo di entità dell'amministratore di sever.	'Application' 'Group' 'User'
sid	SID (ID oggetto) dell'amministratore del server.	string Constraints: 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 Constraints: Lunghezza minima = 36 Lunghezza massima = 36 Modello = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`

ManagedInstanceProperties

Name	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 Constraints: Valore sensibile. Passare come parametro sicuro.
administrators	L'amministratore di Azure Active Directory può essere usato durante la creazione dell'istanza e per gli aggiornamenti dell'istanza, 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).	'Active' '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' 'LicenseIncluded'
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 determinazione dei prezzi 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' 'Local' 'Zone'
requestedLogicalAvailabilityZone	Specifica la zona di disponibilità logica a cui è aggiunta Istanza gestita.	'1' '2' '3' 'NoPreference'
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	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 mantiene i dettagli sui fusi orari supportati, incluso l'ID, nel Registro di sistema in KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fusi orari. È 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
zoneRedundant	Se la ridondanza della zona è abilitata o meno.	bool

ResourceIdentity

Name	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.	'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned'
userAssignedIdentities	ID risorsa delle identità assegnate dall'utente da usare	ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Name	Description	Value

ServicePrincipal

Name	Description	Value
type	Tipo di entità servizio.	'None' 'SystemAssigned'

Sku

Name	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
name	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

Name	Description	Value

UserIdentity

Name	Description	Value

Esempi di utilizzo

Moduli verificati di Azure

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

Module	Description
Istanza gestita di SQL	Modulo di risorse AVM per Istanza gestita di SQL

Commenti e suggerimenti

Questa pagina è stata utile?

Last updated on 2025-09-17

Condividi tramite

Microsoft.Sql managedInstances

Definizione di risorsa Bicep

Formato risorsa

Valori delle proprietà

Microsoft.Sql/managedInstances

ManagedInstanceExternalAdministrator

ManagedInstanceProperties

ResourceIdentity

ResourceIdentityUserAssignedIdentities

ServicePrincipal

Sku

TrackedResourceTags

UserIdentity

Esempi di utilizzo

Moduli verificati di Azure

Esempi di avvio rapido di Azure

Definizione di risorsa del modello di Resource Manager

Formato risorsa

Valori delle proprietà

Microsoft.Sql/managedInstances

ManagedInstanceExternalAdministrator

ManagedInstanceProperties

ResourceIdentity

ResourceIdentityUserAssignedIdentities

ServicePrincipal

Sku

TrackedResourceTags

UserIdentity

Esempi di utilizzo

Modelli di avvio rapido di Azure

Definizione di risorsa Terraform (provider AzAPI)

Formato risorsa

Valori delle proprietà

Microsoft.Sql/managedInstances

ManagedInstanceExternalAdministrator

ManagedInstanceProperties

ResourceIdentity

ResourceIdentityUserAssignedIdentities

ServicePrincipal

Sku

TrackedResourceTags

UserIdentity

Esempi di utilizzo

Moduli verificati di Azure

Commenti e suggerimenti

Risorse aggiuntive