Microsoft.Sql managedInstances 2025-02-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.

Formato risorsa

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

resource symbolicname 'Microsoft.Sql/managedInstances@2025-02-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	Descrizione	Valore
identity	Identità di Azure Active Directory dell'istanza gestita.	ResourceIdentity
ubicazione	Percorso della risorsa.	stringa (obbligatorio)
nome	Nome della risorsa	stringa (obbligatorio)
proprietà	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. Vedi tag nei template

ManagedInstanceExternalAdministrator

Nome	Descrizione	Valore
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
tipoPrincipale	Tipo di entità dell'amministratore di sever.	'Application' 'Gruppo' 'Utente'
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	Descrizione	Valore
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 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' 'Regolare'
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' 'Reindirizzamento'
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
di zonaRidondante	Se la ridondanza della zona è abilitata o meno.	bool

ResourceIdentity

Nome	Descrizione	Valore
tipo	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' 'Assegnato dall'utente'
identità assegnate dall'utente	ID risorsa delle identità assegnate dall'utente da usare	ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Nome	Descrizione	Valore

Servizio Principale

Nome	Descrizione	Valore
tipo	Tipo di entità servizio.	'Nessuno' 'Assegnato dal sistema'

Sku

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

UserIdentity

Nome	Descrizione	Valore

Esempi di utilizzo

Moduli verificati di Azure

I seguenti Azure Moduli Verificati possono essere utilizzati per distribuire questo tipo di risorsa.

Modulo	Descrizione
Istanza gestita SQL	Modulo di risorse AVM per Istanza gestita di SQL

Esempi di Azure Quickstart

I seguenti template Azure Quickstart contengono Bicep esempi per il deployment di questo tipo di risorsa.

File Bicep	Descrizione
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:

Resource groups - Vedi resource group

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": "2025-02-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	Descrizione	Valore
versione dell'API	Versione dell'API	'2025-02-01-anteprima'
identity	Identità di Azure Active Directory dell'istanza gestita.	ResourceIdentity
ubicazione	Percorso della risorsa.	stringa (obbligatorio)
nome	Nome della risorsa	stringa (obbligatorio)
proprietà	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. Vedi tag nei template
tipo	Tipo di risorsa	'Microsoft.Sql/managedInstances'

ManagedInstanceExternalAdministrator

Nome	Descrizione	Valore
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
tipoPrincipale	Tipo di entità dell'amministratore di sever.	'Application' 'Gruppo' 'Utente'
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	Descrizione	Valore
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 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' 'Regolare'
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' 'Reindirizzamento'
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
di zonaRidondante	Se la ridondanza della zona è abilitata o meno.	bool

ResourceIdentity

Nome	Descrizione	Valore
tipo	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' 'Assegnato dall'utente'
identità assegnate dall'utente	ID risorsa delle identità assegnate dall'utente da usare	ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Nome	Descrizione	Valore

Servizio Principale

Nome	Descrizione	Valore
tipo	Tipo di entità servizio.	'Nessuno' 'Assegnato dal sistema'

Sku

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

UserIdentity

Nome	Descrizione	Valore

Esempi di utilizzo

Modelli di avvio rapido di Azure

I seguenti template Azure Quickstart distribuiscono questo tipo di risorsa.

Modello	Descrizione
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@2025-02-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	Descrizione	Valore
identity	Identità di Azure Active Directory dell'istanza gestita.	ResourceIdentity
ubicazione	Percorso della risorsa.	stringa (obbligatorio)
nome	Nome della risorsa	stringa (obbligatorio)
proprietà	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.
tipo	Tipo di risorsa	"Microsoft.Sql/managedInstances@2025-02-01-preview"

ManagedInstanceExternalAdministrator

Nome	Descrizione	Valore
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
tipoPrincipale	Tipo di entità dell'amministratore di sever.	'Application' 'Gruppo' 'Utente'
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	Descrizione	Valore
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 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' 'Regolare'
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' 'Reindirizzamento'
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
di zonaRidondante	Se la ridondanza della zona è abilitata o meno.	bool

ResourceIdentity

Nome	Descrizione	Valore
tipo	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' 'Assegnato dall'utente'
identità assegnate dall'utente	ID risorsa delle identità assegnate dall'utente da usare	ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Nome	Descrizione	Valore

Servizio Principale

Nome	Descrizione	Valore
tipo	Tipo di entità servizio.	'Nessuno' 'Assegnato dal sistema'

Sku

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

UserIdentity

Nome	Descrizione	Valore

Esempi di utilizzo

Moduli verificati di Azure

I seguenti Azure Moduli Verificati possono essere utilizzati per distribuire questo tipo di risorsa.

Modulo	Descrizione
Istanza gestita SQL	Modulo di risorse AVM per Istanza gestita di SQL

Commenti e suggerimenti

Questa pagina è stata utile?

Last updated on 2026-03-23

Condividi tramite

Microsoft.Sql managedInstances 2025-02-01-preview

Definizione di risorsa Bicep

Formato risorsa

Valori delle proprietà

Microsoft.Sql/managedInstances

ManagedInstanceExternalAdministrator

ManagedInstanceProperties

ResourceIdentity

ResourceIdentityUserAssignedIdentities

Servizio Principale

Sku

TrackedResourceTags

UserIdentity

Esempi di utilizzo

Moduli verificati di Azure

Esempi di Azure Quickstart

Definizione di risorsa del modello di Resource Manager

Formato risorsa

Valori delle proprietà

Microsoft.Sql/managedInstances

ManagedInstanceExternalAdministrator

ManagedInstanceProperties

ResourceIdentity

ResourceIdentityUserAssignedIdentities

Servizio Principale

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

Servizio Principale

Sku

TrackedResourceTags

UserIdentity

Esempi di utilizzo

Moduli verificati di Azure

Commenti e suggerimenti

Risorse aggiuntive