Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
- Latest
- 2024-11-01-preview
- 2024-05-01-preview
- 2023-08-01
- 2023-08-01-preview
- 2023-05-01-preview
- 2023-02-01-preview
- 2022-11-01-preview
- 2022-08-01-preview
- 2022-05-01-preview
- 2022-02-01-preview
- 2021-11-01
- 2021-11-01-preview
- 2021-08-01-preview
- 2021-05-01-preview
- 2021-02-01-preview
- 2020-11-01-preview
- 2020-08-01-preview
- 2020-02-02-preview
- 2018-06-01-preview
- 2015-05-01-preview
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 eine Microsoft.Sql/managedInstances-Ressource zu erstellen, fügen Sie der Vorlage die folgende Bicep hinzu.
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'
}
}
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 | Nur Azure Active Directory-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 azureADOnlyAuthentication-Eigenschaft. 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 verwalteten 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 | Gibt die logische Verfügbarkeitszone an, an die die verwaltete Instanz angeheftet 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. Zulässige Werte sind Zeitzonen, die von Windows unterstützt werden. Windows behält Details zu unterstützten Zeitzonen, einschließlich der ID, in der Registrierung unter KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Zeitzonen. Sie können diese Registrierungswerte über SQL Server abrufen, indem Sie SELECT-Name AS 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. Legen Sie dies auf "SystemAssigned" fest, um automatisch einen Azure Active Directory-Prinzipal 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
Von Azure verifizierte Module
Die folgenden Azure Verified Modules können verwendet werden, um diesen Ressourcentyp bereitzustellen.
| Module | Description |
|---|---|
| Verwaltete SQL-Instanz | AVM-Ressourcenmodul für verwaltete SQL-Instanz |
Azure-Schnellstartbeispiele
Die folgenden Azure-Schnellstartvorlagen Bicep-Beispiele für die Bereitstellung dieses Ressourcentyps enthalten.
| Bicep-Datei | Description |
|---|---|
| Erstellen von SQL MI innerhalb des neuen virtuellen Netzwerks | Stellen Sie azure Sql Database Managed Instance (SQL MI) in einem neuen virtuellen Netzwerk bereit. |
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 eine Microsoft.Sql/managedInstances-Ressource zu erstellen, fügen Sie der Vorlage den folgenden JSON-Code hinzu.
{
"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"
}
}
Eigenschaftswerte
Microsoft.Sql/managedInstances
| Name | Description | Value |
|---|---|---|
| apiVersion | Die API-Version | '2024-11-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 | Nur Azure Active Directory-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 azureADOnlyAuthentication-Eigenschaft. 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 verwalteten 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 | Gibt die logische Verfügbarkeitszone an, an die die verwaltete Instanz angeheftet 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. Zulässige Werte sind Zeitzonen, die von Windows unterstützt werden. Windows behält Details zu unterstützten Zeitzonen, einschließlich der ID, in der Registrierung unter KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Zeitzonen. Sie können diese Registrierungswerte über SQL Server abrufen, indem Sie SELECT-Name AS 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. Legen Sie dies auf "SystemAssigned" fest, um automatisch einen Azure Active Directory-Prinzipal 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-Schnellstartvorlagen
Die folgenden Azure-Schnellstartvorlagen diesen Ressourcentyp bereitstellen.
| Template | Description |
|---|---|
Erstellen von SQL MI innerhalb des neuen virtuellen Netzwerks
|
Stellen Sie azure Sql Database Managed Instance (SQL MI) in einem neuen virtuellen Netzwerk bereit. |
|
Erstellen von SQL MI mit konfigurierter Übermittlung von Protokollen 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. |
|
Erstellen von SQL MI mit Jumpbox innerhalb eines neuen virtuellen Netzwerks
|
Stellen Sie azure Sql Database Managed Instance (SQL MI) und JumpBox mit SSMS in einem neuen virtuellen Netzwerk bereit. |
|
Erstellen von SQL MI mit konfigurierter Point-to-Site-Verbindung
|
Stellen Sie azure Sql Database Managed Instance (SQL MI) und das virtuelle Netzwerkgateway bereit, das für die Point-to-Site-Verbindung innerhalb des neuen virtuellen Netzwerks konfiguriert ist. |
|
Bereitstellen der verwalteten SQL-Instanz mit Netzwerk
|
Bereitstellen von UDR und NSG zur Unterstützung von Azure SQL Managed Instance und Bereitstellen der verwalteten Instanz |
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 eine Microsoft.Sql/managedInstances-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.
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"
}
}
}
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@2024-11-01-preview" |
ManagedInstanceExternalAdministrator
| Name | Description | Value |
|---|---|---|
| administratorType | Typ des Serveradministrators. | 'ActiveDirectory' |
| azureADOnlyAuthentication | Nur Azure Active Directory-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 azureADOnlyAuthentication-Eigenschaft. 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 verwalteten 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 | Gibt die logische Verfügbarkeitszone an, an die die verwaltete Instanz angeheftet 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. Zulässige Werte sind Zeitzonen, die von Windows unterstützt werden. Windows behält Details zu unterstützten Zeitzonen, einschließlich der ID, in der Registrierung unter KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Zeitzonen. Sie können diese Registrierungswerte über SQL Server abrufen, indem Sie SELECT-Name AS 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. Legen Sie dies auf "SystemAssigned" fest, um automatisch einen Azure Active Directory-Prinzipal 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
Von Azure verifizierte Module
Die folgenden Azure Verified Modules können verwendet werden, um diesen Ressourcentyp bereitzustellen.
| Module | Description |
|---|---|
| Verwaltete SQL-Instanz | AVM-Ressourcenmodul für verwaltete SQL-Instanz |