Microsoft. SQL managedInstances

Bicep-Ressourcendefinition

Der ressourcentyp "managedInstances" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Ressourcengruppen – Siehe Ressourcengruppenbereitstellungsbefehle

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um ein Microsoft zu schaffen. SQL/managedInstances-Ressource, fügen Sie den folgenden Bicep Ihrer Vorlage hinzu.

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'
  }
}

Eigenschaftswerte

Microsoft. SQL/managedInstances

Name	Description	Value
identity	Die Azure Active Directory-Identität der verwalteten Instanz.	ResourceIdentity
location	Ressourcenspeicherort.	Zeichenfolge (erforderlich)
name	Der Ressourcenname	Zeichenfolge (erforderlich)
properties	Ressourceneigenschaften.	ManagedInstanceProperties
sku	SKU der verwalteten Instanz. Zulässige Werte für sku.name: GP_Gen5 (Universell, Standard-Reihe); GP_G8IM (Allzweck, Premium-Serie); GP_G8IH (Allzweck, Speicheroptimierung der Premium-Serie); BC_Gen5 (Geschäftskritisch, Standard-Series); BC_G8IM (Business Critical, Premium-Serie); BC_G8IH (Business Critical, für den Arbeitsspeicher der Premium-Serie optimiert).	Sku
tags	Ressourcenetiketten	Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen

ManagedInstanceExternalAdministrator

Name	Description	Value
administratorType	Typ des Serveradministrators.	'ActiveDirectory'
azureADOnlyAuthentication	Azure Active Directory nur Authentifizierung aktiviert.	bool
login	Anmeldename des Serveradministrators.	string
principalType	Prinzipaltyp des Serveradministrators.	'Application' 'Group' 'User'
sid	SID (Objekt-ID) des Serveradministrators.	string Constraints: Min. Länge = 36 Maximale Länge = 36 Muster = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
tenantId	Mandanten-ID des Administrators.	string Constraints: Min. Länge = 36 Maximale Länge = 36 Muster = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`

ManagedInstanceProperties

Name	Description	Value
administratorLogin	Administratorbenutzername für die verwaltete Instanz. Kann nur angegeben werden, wenn die verwaltete Instanz erstellt wird (und für die Erstellung erforderlich ist).	string
administratorLoginPassword	Das Administratoranmeldungskennwort (erforderlich für die Erstellung verwalteter Instanzen).	string Constraints: Vertraulicher Wert. Übergeben Als sicherer Parameter.
administrators	Der Azure Active Directory-Administrator kann während der Instanzerstellung und für Instanzupdates verwendet werden, mit Ausnahme der Eigenschaft azureADOnlyAuthentication. Zum Aktualisieren der azureADOnlyAuthentication-Eigenschaft muss eine einzelne API verwendet werden.	ManagedInstanceExternalAdministrator
authenticationMetadata	Nachschlagemodus für die Authentifizierungsmetadaten der verwalteten Instanz.	'AzureAD' 'Paired' 'Windows'
collation	Sortierung der verwalteten Instanz.	string
databaseFormat	Gibt das interne Format von Instanzdatenbanken an, die für die SQL-Modulversion spezifisch sind.	'AlwaysUpToDate' 'SQLServer2022' 'SQLServer2025'
dnsZonePartner	Die Ressourcen-ID einer anderen verwalteten Instanz, deren DNS-Zone diese verwaltete Instanz nach der Erstellung freigeben wird.	string
hybridSecondaryUsage	Hybride sekundäre Nutzung. Mögliche Werte sind "Aktiv" (Standardwert) und "Passiv" (Kunde verwendet die sekundäre als passive DR).	'Active' 'Passive'
instancePoolId	Die ID des Instanzpools, zu dem dieser verwaltete Server gehört.	string
isGeneralPurposeV2	Gibt an, ob dies eine GPv2-Variante der General Purpose Edition ist.	bool
keyId	Ein CMK-URI des Schlüssels, der für die Verschlüsselung verwendet werden soll.	string
licenseType	Der Lizenztyp. Mögliche Werte sind "LicenseIncluded" (regulärer Preis inklusive einer neuen SQL-Lizenz) und "BasePrice" (reduzierter AHB-Preis für die Bereitstellung Eigener SQL-Lizenzen).	'BasePrice' 'LicenseIncluded'
maintenanceConfigurationId	Gibt die Wartungskonfigurations-ID an, die auf diese verwaltete Instanz angewendet werden soll.	string
managedInstanceCreateMode	Gibt den Modus der Datenbankerstellung an. Standard: Normale Instanzerstellung. Wiederherstellen: Erstellt eine Instanz, indem eine Reihe von Sicherungen zu einem bestimmten Zeitpunkt wiederhergestellt wird. RestorePointInTime und SourceManagedInstanceId müssen angegeben werden.	'Default' 'PointInTimeRestore'
memorySizeInGB	Speichergröße in GB. Mindestwert: 28. Maximalwert: 870. Der Mindest- und Maximalwert hängt von der Anzahl der virtuellen Kerne und der Dienstebene ab. Weitere Informationen zu Ressourcenbeschränkungen: https://aka.ms/mi-resource-limits-api.	int
minimalTlsVersion	Minimale TLS-Version. Zulässige Werte: 'None', '1.0', '1.1', '1.2'	string
pricingModel	Preismodell der verwaltete Instanz.	'Freemium' 'Regular'
primaryUserAssignedIdentityId	Die Ressourcen-ID einer vom Benutzer zugewiesenen Identität, die standardmäßig verwendet werden soll.	string
proxyOverride	Verbindungstyp, der für die Verbindung mit der Instanz verwendet wird.	'Default' 'Proxy' 'Redirect'
publicDataEndpointEnabled	Gibt an, ob der öffentliche Datenendpunkt aktiviert ist.	bool
requestedBackupStorageRedundancy	Der Speicherkontotyp, der zum Speichern von Sicherungen für diese Instanz verwendet werden soll. Die Optionen sind Lokal (LokalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) und GeoZone(GeoZoneRedundantStorage)	'Geo' 'GeoZone' 'Local' 'Zone'
requestedLogicalAvailabilityZone	Spezifiziert die logische Verfügbarkeitszone, an die die verwaltete Instanz gepinnt ist.	'1' '2' '3' 'NoPreference'
restorePointInTime	Gibt den Zeitpunkt (ISO8601 Format) der Quelldatenbank an, die wiederhergestellt wird, um die neue Datenbank zu erstellen.	string
servicePrincipal	Dienstprinzipal der verwalteten Instanz.	ServicePrincipal
sourceManagedInstanceId	Der Ressourcenbezeichner der verwalteten Quellinstanz, die dem Erstellungsvorgang dieser Instanz zugeordnet ist.	string
storageIOps	Speicher-E/A. Mindestwert: 300. Maximalwert: 80000. Nur Inkremente von 1 IOps zulässig. Der Maximalwert hängt von der ausgewählten Hardwarefamilie und der Anzahl der vCores ab.	int
storageSizeInGB	Speichergröße in GB. Mindestwert: 32. Maximalwert: 32768. Nur Inkremente von 32 GB zulässig. Der Maximalwert hängt von der ausgewählten Hardwarefamilie und der Anzahl der vCores ab.	int
storageThroughputMBps	Der MBps-Parameter für den Speicherdurchsatz wird im Erstellungs-/Aktualisierungsvorgang der Instanz nicht unterstützt.	int
subnetId	Subnetzressourcen-ID für die verwaltete Instanz.	string
timezoneId	ID der Zeitzone. Erlaubte Werte sind von Windows unterstützte Zeitzonen. Windows speichert Details zu unterstützten Zeitzonen, einschließlich der ID, im Register unter KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Sie können diese Registrierungswerte über SQL Server erhalten, indem Sie NAME auswählen ALS timezone_id FROM sys.time_zone_info abfragen. Die Liste der IDs kann auch durch Ausführen von [System.TimeZoneInfo]::GetSystemTimeZones() in PowerShell abgerufen werden. Ein Beispiel für gültige Zeitzonen-ID ist "Pacific Standard Time" oder "W. Europas Standardzeit".	string
vCores	Die Anzahl der vCores. Zulässige Werte: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Die Anzahl der unterstützten virtuellen Kerne hängt von der ausgewählten Hardwarefamilie und der Dienstebene ab.	int
zoneRedundant	Gibt an, ob die Zonenredundanz aktiviert ist.	bool

ResourceIdentity

Name	Description	Value
type	Der Identitätstyp. Setzen Sie dies auf 'SystemAssigned', um automatisch einen Azure Active Directory-Principal für die Ressource zu erstellen und zuzuweisen.	'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned'
userAssignedIdentities	Die Ressourcen-IDs der vom Benutzer zugewiesenen Identitäten, die verwendet werden sollen	ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Name	Description	Value

ServicePrincipal

Name	Description	Value
type	Dienstprinzipaltyp.	'None' 'SystemAssigned'

Sku

Name	Description	Value
capacity	Kapazität der jeweiligen SKU.	int
family	Wenn der Dienst über unterschiedliche Hardwaregenerationen verfügt, kann dies für dieselbe SKU hier erfasst werden.	string
name	Der Name der SKU, in der Regel ein Buchstabe + Zahlencode, z. B. P3.	Zeichenfolge (erforderlich)
size	Größe der jeweiligen SKU	string
tier	Die Stufe oder Edition der jeweiligen SKU, z. B. Basic, Premium.	string

TrackedResourceTags

Name	Description	Value

UserIdentity

Name	Description	Value

Verwendungsbeispiele

Azure Verified Modules

Die folgenden Azure Verifizierte Module können verwendet werden, um diesen Ressourcentyp bereitzustellen.

Module	Description
SQL Managed Instance	AVM-Ressourcenmodul für SQL Managed Instance

Azure Quickstart Samples

Die folgenden Azure Quickstart-Vorlagen enthalten Bicep Beispiele für die Bereitstellung dieses Ressourcentyps.

Bicep-Datei	Description
SQL MI innerhalb des neuen virtuellen Netzwerks	Setzen Sie Azure SQL Database verwaltete Instanz (SQL MI) im neuen Virtual Network ein.

ARM-Vorlagenressourcendefinition

Der ressourcentyp "managedInstances" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Ressourcengruppen – Siehe Ressourcengruppenbereitstellungsbefehle

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um ein Microsoft zu schaffen. SQL/managedInstances-Ressource, fügen Sie das folgende JSON zu Ihrer Vorlage hinzu.

{
  "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"
  }
}

Eigenschaftswerte

Microsoft. SQL/managedInstances

Name	Description	Value
apiVersion	Die API-Version	"2025-02-01-preview"
identity	Die Azure Active Directory-Identität der verwalteten Instanz.	ResourceIdentity
location	Ressourcenspeicherort.	Zeichenfolge (erforderlich)
name	Der Ressourcenname	Zeichenfolge (erforderlich)
properties	Ressourceneigenschaften.	ManagedInstanceProperties
sku	SKU der verwalteten Instanz. Zulässige Werte für sku.name: GP_Gen5 (Universell, Standard-Reihe); GP_G8IM (Allzweck, Premium-Serie); GP_G8IH (Allzweck, Speicheroptimierung der Premium-Serie); BC_Gen5 (Geschäftskritisch, Standard-Series); BC_G8IM (Business Critical, Premium-Serie); BC_G8IH (Business Critical, für den Arbeitsspeicher der Premium-Serie optimiert).	Sku
tags	Ressourcenetiketten	Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
type	Der Ressourcentyp	'Microsoft. SQL/managedInstances'

ManagedInstanceExternalAdministrator

Name	Description	Value
administratorType	Typ des Serveradministrators.	'ActiveDirectory'
azureADOnlyAuthentication	Azure Active Directory nur Authentifizierung aktiviert.	bool
login	Anmeldename des Serveradministrators.	string
principalType	Prinzipaltyp des Serveradministrators.	'Application' 'Group' 'User'
sid	SID (Objekt-ID) des Serveradministrators.	string Constraints: Min. Länge = 36 Maximale Länge = 36 Muster = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
tenantId	Mandanten-ID des Administrators.	string Constraints: Min. Länge = 36 Maximale Länge = 36 Muster = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`

ManagedInstanceProperties

Name	Description	Value
administratorLogin	Administratorbenutzername für die verwaltete Instanz. Kann nur angegeben werden, wenn die verwaltete Instanz erstellt wird (und für die Erstellung erforderlich ist).	string
administratorLoginPassword	Das Administratoranmeldungskennwort (erforderlich für die Erstellung verwalteter Instanzen).	string Constraints: Vertraulicher Wert. Übergeben Als sicherer Parameter.
administrators	Der Azure Active Directory-Administrator kann während der Instanzerstellung und für Instanzupdates verwendet werden, mit Ausnahme der Eigenschaft azureADOnlyAuthentication. Zum Aktualisieren der azureADOnlyAuthentication-Eigenschaft muss eine einzelne API verwendet werden.	ManagedInstanceExternalAdministrator
authenticationMetadata	Nachschlagemodus für die Authentifizierungsmetadaten der verwalteten Instanz.	'AzureAD' 'Paired' 'Windows'
collation	Sortierung der verwalteten Instanz.	string
databaseFormat	Gibt das interne Format von Instanzdatenbanken an, die für die SQL-Modulversion spezifisch sind.	'AlwaysUpToDate' 'SQLServer2022' 'SQLServer2025'
dnsZonePartner	Die Ressourcen-ID einer anderen verwalteten Instanz, deren DNS-Zone diese verwaltete Instanz nach der Erstellung freigeben wird.	string
hybridSecondaryUsage	Hybride sekundäre Nutzung. Mögliche Werte sind "Aktiv" (Standardwert) und "Passiv" (Kunde verwendet die sekundäre als passive DR).	'Active' 'Passive'
instancePoolId	Die ID des Instanzpools, zu dem dieser verwaltete Server gehört.	string
isGeneralPurposeV2	Gibt an, ob dies eine GPv2-Variante der General Purpose Edition ist.	bool
keyId	Ein CMK-URI des Schlüssels, der für die Verschlüsselung verwendet werden soll.	string
licenseType	Der Lizenztyp. Mögliche Werte sind "LicenseIncluded" (regulärer Preis inklusive einer neuen SQL-Lizenz) und "BasePrice" (reduzierter AHB-Preis für die Bereitstellung Eigener SQL-Lizenzen).	'BasePrice' 'LicenseIncluded'
maintenanceConfigurationId	Gibt die Wartungskonfigurations-ID an, die auf diese verwaltete Instanz angewendet werden soll.	string
managedInstanceCreateMode	Gibt den Modus der Datenbankerstellung an. Standard: Normale Instanzerstellung. Wiederherstellen: Erstellt eine Instanz, indem eine Reihe von Sicherungen zu einem bestimmten Zeitpunkt wiederhergestellt wird. RestorePointInTime und SourceManagedInstanceId müssen angegeben werden.	'Default' 'PointInTimeRestore'
memorySizeInGB	Speichergröße in GB. Mindestwert: 28. Maximalwert: 870. Der Mindest- und Maximalwert hängt von der Anzahl der virtuellen Kerne und der Dienstebene ab. Weitere Informationen zu Ressourcenbeschränkungen: https://aka.ms/mi-resource-limits-api.	int
minimalTlsVersion	Minimale TLS-Version. Zulässige Werte: 'None', '1.0', '1.1', '1.2'	string
pricingModel	Preismodell der verwaltete Instanz.	'Freemium' 'Regular'
primaryUserAssignedIdentityId	Die Ressourcen-ID einer vom Benutzer zugewiesenen Identität, die standardmäßig verwendet werden soll.	string
proxyOverride	Verbindungstyp, der für die Verbindung mit der Instanz verwendet wird.	'Default' 'Proxy' 'Redirect'
publicDataEndpointEnabled	Gibt an, ob der öffentliche Datenendpunkt aktiviert ist.	bool
requestedBackupStorageRedundancy	Der Speicherkontotyp, der zum Speichern von Sicherungen für diese Instanz verwendet werden soll. Die Optionen sind Lokal (LokalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) und GeoZone(GeoZoneRedundantStorage)	'Geo' 'GeoZone' 'Local' 'Zone'
requestedLogicalAvailabilityZone	Spezifiziert die logische Verfügbarkeitszone, an die die verwaltete Instanz gepinnt ist.	'1' '2' '3' 'NoPreference'
restorePointInTime	Gibt den Zeitpunkt (ISO8601 Format) der Quelldatenbank an, die wiederhergestellt wird, um die neue Datenbank zu erstellen.	string
servicePrincipal	Dienstprinzipal der verwalteten Instanz.	ServicePrincipal
sourceManagedInstanceId	Der Ressourcenbezeichner der verwalteten Quellinstanz, die dem Erstellungsvorgang dieser Instanz zugeordnet ist.	string
storageIOps	Speicher-E/A. Mindestwert: 300. Maximalwert: 80000. Nur Inkremente von 1 IOps zulässig. Der Maximalwert hängt von der ausgewählten Hardwarefamilie und der Anzahl der vCores ab.	int
storageSizeInGB	Speichergröße in GB. Mindestwert: 32. Maximalwert: 32768. Nur Inkremente von 32 GB zulässig. Der Maximalwert hängt von der ausgewählten Hardwarefamilie und der Anzahl der vCores ab.	int
storageThroughputMBps	Der MBps-Parameter für den Speicherdurchsatz wird im Erstellungs-/Aktualisierungsvorgang der Instanz nicht unterstützt.	int
subnetId	Subnetzressourcen-ID für die verwaltete Instanz.	string
timezoneId	ID der Zeitzone. Erlaubte Werte sind von Windows unterstützte Zeitzonen. Windows speichert Details zu unterstützten Zeitzonen, einschließlich der ID, im Register unter KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Sie können diese Registrierungswerte über SQL Server erhalten, indem Sie NAME auswählen ALS timezone_id FROM sys.time_zone_info abfragen. Die Liste der IDs kann auch durch Ausführen von [System.TimeZoneInfo]::GetSystemTimeZones() in PowerShell abgerufen werden. Ein Beispiel für gültige Zeitzonen-ID ist "Pacific Standard Time" oder "W. Europas Standardzeit".	string
vCores	Die Anzahl der vCores. Zulässige Werte: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Die Anzahl der unterstützten virtuellen Kerne hängt von der ausgewählten Hardwarefamilie und der Dienstebene ab.	int
zoneRedundant	Gibt an, ob die Zonenredundanz aktiviert ist.	bool

ResourceIdentity

Name	Description	Value
type	Der Identitätstyp. Setzen Sie dies auf 'SystemAssigned', um automatisch einen Azure Active Directory-Principal für die Ressource zu erstellen und zuzuweisen.	'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned'
userAssignedIdentities	Die Ressourcen-IDs der vom Benutzer zugewiesenen Identitäten, die verwendet werden sollen	ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Name	Description	Value

ServicePrincipal

Name	Description	Value
type	Dienstprinzipaltyp.	'None' 'SystemAssigned'

Sku

Name	Description	Value
capacity	Kapazität der jeweiligen SKU.	int
family	Wenn der Dienst über unterschiedliche Hardwaregenerationen verfügt, kann dies für dieselbe SKU hier erfasst werden.	string
name	Der Name der SKU, in der Regel ein Buchstabe + Zahlencode, z. B. P3.	Zeichenfolge (erforderlich)
size	Größe der jeweiligen SKU	string
tier	Die Stufe oder Edition der jeweiligen SKU, z. B. Basic, Premium.	string

TrackedResourceTags

Name	Description	Value

UserIdentity

Name	Description	Value

Verwendungsbeispiele

Azure Quickstart Templates

Die folgenden Azure Quickstart-Vorlagen bereitstellen diesen Ressourcentyp aus.

Template	Description
SQL MI innerhalb des neuen virtuellen Netzwerks	Setzen Sie Azure SQL Database verwaltete Instanz (SQL MI) im neuen Virtual Network ein.
Erstellen Sie SQL MI mit konfiguriertem Senden von Logs und Metriken	Mit dieser Vorlage können Sie SQL MI und zusätzliche Ressourcen bereitstellen, die zum Speichern von Protokollen und Metriken (Diagnosearbeitsbereich, Speicherkonto, Event Hub) verwendet werden.
SQL MI mit Jumpbox innerhalb des neuen virtuellen Netzwerks erstellen	Setzen Sie Azure SQL Database verwaltete Instanz (SQL MI) und JumpBox mit SSMS im neuen Virtual Network ein.
Erstellen Sie SQL MI mit konfigurierter Punkt-zu-Site-Verbindung	Setzen Sie Azure SQL Database verwaltete Instanz (SQL MI) und ein Virtual Network Gateway ein, das für eine Punkt-zu-Site-Verbindung innerhalb des neuen virtuellen Netzwerks konfiguriert ist.
Deploye SQL Managed Instance mit Networking	Deploye UDR und NSG zur Unterstützung der Azure SQL Managed Instance und bereite die verwaltete Instanz bereit

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Der ressourcentyp "managedInstances" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Ressourcengruppen

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um ein Microsoft zu schaffen. SQL/managedInstances-Ressource, fügen Sie folgendes Terraform Ihrer Vorlage hinzu.

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"
    }
  }
}

Eigenschaftswerte

Microsoft. SQL/managedInstances

Name	Description	Value
identity	Die Azure Active Directory-Identität der verwalteten Instanz.	ResourceIdentity
location	Ressourcenspeicherort.	Zeichenfolge (erforderlich)
name	Der Ressourcenname	Zeichenfolge (erforderlich)
properties	Ressourceneigenschaften.	ManagedInstanceProperties
sku	SKU der verwalteten Instanz. Zulässige Werte für sku.name: GP_Gen5 (Universell, Standard-Reihe); GP_G8IM (Allzweck, Premium-Serie); GP_G8IH (Allzweck, Speicheroptimierung der Premium-Serie); BC_Gen5 (Geschäftskritisch, Standard-Series); BC_G8IM (Business Critical, Premium-Serie); BC_G8IH (Business Critical, für den Arbeitsspeicher der Premium-Serie optimiert).	Sku
tags	Ressourcenetiketten	Wörterbuch der Tagnamen und -werte.
type	Der Ressourcentyp	"Microsoft. sql/managedInstances@2025-02-01-preview"

ManagedInstanceExternalAdministrator

Name	Description	Value
administratorType	Typ des Serveradministrators.	'ActiveDirectory'
azureADOnlyAuthentication	Azure Active Directory nur Authentifizierung aktiviert.	bool
login	Anmeldename des Serveradministrators.	string
principalType	Prinzipaltyp des Serveradministrators.	'Application' 'Group' 'User'
sid	SID (Objekt-ID) des Serveradministrators.	string Constraints: Min. Länge = 36 Maximale Länge = 36 Muster = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
tenantId	Mandanten-ID des Administrators.	string Constraints: Min. Länge = 36 Maximale Länge = 36 Muster = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`

ManagedInstanceProperties

Name	Description	Value
administratorLogin	Administratorbenutzername für die verwaltete Instanz. Kann nur angegeben werden, wenn die verwaltete Instanz erstellt wird (und für die Erstellung erforderlich ist).	string
administratorLoginPassword	Das Administratoranmeldungskennwort (erforderlich für die Erstellung verwalteter Instanzen).	string Constraints: Vertraulicher Wert. Übergeben Als sicherer Parameter.
administrators	Der Azure Active Directory-Administrator kann während der Instanzerstellung und für Instanzupdates verwendet werden, mit Ausnahme der Eigenschaft azureADOnlyAuthentication. Zum Aktualisieren der azureADOnlyAuthentication-Eigenschaft muss eine einzelne API verwendet werden.	ManagedInstanceExternalAdministrator
authenticationMetadata	Nachschlagemodus für die Authentifizierungsmetadaten der verwalteten Instanz.	'AzureAD' 'Paired' 'Windows'
collation	Sortierung der verwalteten Instanz.	string
databaseFormat	Gibt das interne Format von Instanzdatenbanken an, die für die SQL-Modulversion spezifisch sind.	'AlwaysUpToDate' 'SQLServer2022' 'SQLServer2025'
dnsZonePartner	Die Ressourcen-ID einer anderen verwalteten Instanz, deren DNS-Zone diese verwaltete Instanz nach der Erstellung freigeben wird.	string
hybridSecondaryUsage	Hybride sekundäre Nutzung. Mögliche Werte sind "Aktiv" (Standardwert) und "Passiv" (Kunde verwendet die sekundäre als passive DR).	'Active' 'Passive'
instancePoolId	Die ID des Instanzpools, zu dem dieser verwaltete Server gehört.	string
isGeneralPurposeV2	Gibt an, ob dies eine GPv2-Variante der General Purpose Edition ist.	bool
keyId	Ein CMK-URI des Schlüssels, der für die Verschlüsselung verwendet werden soll.	string
licenseType	Der Lizenztyp. Mögliche Werte sind "LicenseIncluded" (regulärer Preis inklusive einer neuen SQL-Lizenz) und "BasePrice" (reduzierter AHB-Preis für die Bereitstellung Eigener SQL-Lizenzen).	'BasePrice' 'LicenseIncluded'
maintenanceConfigurationId	Gibt die Wartungskonfigurations-ID an, die auf diese verwaltete Instanz angewendet werden soll.	string
managedInstanceCreateMode	Gibt den Modus der Datenbankerstellung an. Standard: Normale Instanzerstellung. Wiederherstellen: Erstellt eine Instanz, indem eine Reihe von Sicherungen zu einem bestimmten Zeitpunkt wiederhergestellt wird. RestorePointInTime und SourceManagedInstanceId müssen angegeben werden.	'Default' 'PointInTimeRestore'
memorySizeInGB	Speichergröße in GB. Mindestwert: 28. Maximalwert: 870. Der Mindest- und Maximalwert hängt von der Anzahl der virtuellen Kerne und der Dienstebene ab. Weitere Informationen zu Ressourcenbeschränkungen: https://aka.ms/mi-resource-limits-api.	int
minimalTlsVersion	Minimale TLS-Version. Zulässige Werte: 'None', '1.0', '1.1', '1.2'	string
pricingModel	Preismodell der verwaltete Instanz.	'Freemium' 'Regular'
primaryUserAssignedIdentityId	Die Ressourcen-ID einer vom Benutzer zugewiesenen Identität, die standardmäßig verwendet werden soll.	string
proxyOverride	Verbindungstyp, der für die Verbindung mit der Instanz verwendet wird.	'Default' 'Proxy' 'Redirect'
publicDataEndpointEnabled	Gibt an, ob der öffentliche Datenendpunkt aktiviert ist.	bool
requestedBackupStorageRedundancy	Der Speicherkontotyp, der zum Speichern von Sicherungen für diese Instanz verwendet werden soll. Die Optionen sind Lokal (LokalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) und GeoZone(GeoZoneRedundantStorage)	'Geo' 'GeoZone' 'Local' 'Zone'
requestedLogicalAvailabilityZone	Spezifiziert die logische Verfügbarkeitszone, an die die verwaltete Instanz gepinnt ist.	'1' '2' '3' 'NoPreference'
restorePointInTime	Gibt den Zeitpunkt (ISO8601 Format) der Quelldatenbank an, die wiederhergestellt wird, um die neue Datenbank zu erstellen.	string
servicePrincipal	Dienstprinzipal der verwalteten Instanz.	ServicePrincipal
sourceManagedInstanceId	Der Ressourcenbezeichner der verwalteten Quellinstanz, die dem Erstellungsvorgang dieser Instanz zugeordnet ist.	string
storageIOps	Speicher-E/A. Mindestwert: 300. Maximalwert: 80000. Nur Inkremente von 1 IOps zulässig. Der Maximalwert hängt von der ausgewählten Hardwarefamilie und der Anzahl der vCores ab.	int
storageSizeInGB	Speichergröße in GB. Mindestwert: 32. Maximalwert: 32768. Nur Inkremente von 32 GB zulässig. Der Maximalwert hängt von der ausgewählten Hardwarefamilie und der Anzahl der vCores ab.	int
storageThroughputMBps	Der MBps-Parameter für den Speicherdurchsatz wird im Erstellungs-/Aktualisierungsvorgang der Instanz nicht unterstützt.	int
subnetId	Subnetzressourcen-ID für die verwaltete Instanz.	string
timezoneId	ID der Zeitzone. Erlaubte Werte sind von Windows unterstützte Zeitzonen. Windows speichert Details zu unterstützten Zeitzonen, einschließlich der ID, im Register unter KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Sie können diese Registrierungswerte über SQL Server erhalten, indem Sie NAME auswählen ALS timezone_id FROM sys.time_zone_info abfragen. Die Liste der IDs kann auch durch Ausführen von [System.TimeZoneInfo]::GetSystemTimeZones() in PowerShell abgerufen werden. Ein Beispiel für gültige Zeitzonen-ID ist "Pacific Standard Time" oder "W. Europas Standardzeit".	string
vCores	Die Anzahl der vCores. Zulässige Werte: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Die Anzahl der unterstützten virtuellen Kerne hängt von der ausgewählten Hardwarefamilie und der Dienstebene ab.	int
zoneRedundant	Gibt an, ob die Zonenredundanz aktiviert ist.	bool

ResourceIdentity

Name	Description	Value
type	Der Identitätstyp. Setzen Sie dies auf 'SystemAssigned', um automatisch einen Azure Active Directory-Principal für die Ressource zu erstellen und zuzuweisen.	'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned'
userAssignedIdentities	Die Ressourcen-IDs der vom Benutzer zugewiesenen Identitäten, die verwendet werden sollen	ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Name	Description	Value

ServicePrincipal

Name	Description	Value
type	Dienstprinzipaltyp.	'None' 'SystemAssigned'

Sku

Name	Description	Value
capacity	Kapazität der jeweiligen SKU.	int
family	Wenn der Dienst über unterschiedliche Hardwaregenerationen verfügt, kann dies für dieselbe SKU hier erfasst werden.	string
name	Der Name der SKU, in der Regel ein Buchstabe + Zahlencode, z. B. P3.	Zeichenfolge (erforderlich)
size	Größe der jeweiligen SKU	string
tier	Die Stufe oder Edition der jeweiligen SKU, z. B. Basic, Premium.	string

TrackedResourceTags

Name	Description	Value

UserIdentity

Name	Description	Value

Verwendungsbeispiele

Azure Verified Modules

Die folgenden Azure Verifizierte Module können verwendet werden, um diesen Ressourcentyp bereitzustellen.

Module	Description
SQL Managed Instance	AVM-Ressourcenmodul für SQL Managed Instance

Feedback

War diese Seite hilfreich?

Last updated on 2026-04-14

Freigeben über

Microsoft. SQL managedInstances

Bicep-Ressourcendefinition

Ressourcenformat

Eigenschaftswerte

Microsoft. SQL/managedInstances

ManagedInstanceExternalAdministrator

ManagedInstanceProperties

ResourceIdentity

ResourceIdentityUserAssignedIdentities

ServicePrincipal

Sku

TrackedResourceTags

UserIdentity

Verwendungsbeispiele

Azure Verified Modules

Azure Quickstart Samples

ARM-Vorlagenressourcendefinition

Ressourcenformat

Eigenschaftswerte

Microsoft. SQL/managedInstances

ManagedInstanceExternalAdministrator

ManagedInstanceProperties

ResourceIdentity

ResourceIdentityUserAssignedIdentities

ServicePrincipal

Sku

TrackedResourceTags

UserIdentity

Verwendungsbeispiele

Azure Quickstart Templates

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Ressourcenformat

Eigenschaftswerte

Microsoft. SQL/managedInstances

ManagedInstanceExternalAdministrator

ManagedInstanceProperties

ResourceIdentity

ResourceIdentityUserAssignedIdentities

ServicePrincipal

Sku

TrackedResourceTags

UserIdentity

Verwendungsbeispiele

Azure Verified Modules

Feedback

Zusätzliche Ressourcen