Microsoft.Sql managedInstances
- neueste
- 2024-05-01-Preview-
- 2023-08-01-Preview-
- 2023-05-01-Preview-
- 2023-02-01-Vorschau-
- 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-Vorschau-
- 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-05-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'
minimalTlsVersion: 'string'
pricingModel: 'string'
primaryUserAssignedIdentityId: 'string'
proxyOverride: 'string'
publicDataEndpointEnabled: bool
requestedBackupStorageRedundancy: 'string'
restorePointInTime: 'string'
servicePrincipal: {
type: 'string'
}
sourceManagedInstanceId: 'string'
storageIOps: int
storageSizeInGB: int
storageThroughputMBps: int
subnetId: 'string'
timezoneId: 'string'
totalMemoryMB: int
vCores: int
zoneRedundant: bool
}
sku: {
capacity: int
family: 'string'
name: 'string'
size: 'string'
tier: 'string'
}
tags: {
{customized property}: 'string'
}
}
Eigenschaftswerte
ManagedInstanceExternalAdministrator
| Name | Beschreibung | Wert |
|---|---|---|
| administratorType | Typ des Serveradministrators. | 'ActiveDirectory' |
| azureADOnlyAuthentication | Nur Azure Active Directory-Authentifizierung aktiviert. | Bool |
| einloggen | Anmeldename des Serveradministrators. | Schnur |
| principalType | Prinzipaltyp des Serveradministrators. | "Anwendung" "Gruppe" "Benutzer" |
| sid | SID (Objekt-ID) des Serveradministrators. | Schnur Zwänge: Min. Länge = 36 Maximale Länge = 36 Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| tenantId | Mandanten-ID des Administrators. | Schnur Zwänge: Min. Länge = 36 Maximale Länge = 36 Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
ManagedInstanceProperties
| Name | Beschreibung | Wert |
|---|---|---|
| administratorLogin | Administratorbenutzername für die verwaltete Instanz. Kann nur angegeben werden, wenn die verwaltete Instanz erstellt wird (und für die Erstellung erforderlich ist). | Schnur |
| administratorLoginPassword | Das Administratoranmeldungskennwort (erforderlich für die Erstellung verwalteter Instanzen). | Schnur Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter. |
| administratoren | Der Azure Active Directory-Administrator der Instanz. Dies kann nur zur Erstellungszeit der Instanz verwendet werden. Wenn sie z. B. aktualisiert wird, wird sie ignoriert oder führt zu einem Fehler. Für Updates müssen einzelne APIs verwendet werden. | ManagedInstanceExternalAdministrator- |
| authenticationMetadata | Nachschlagemodus für die Authentifizierungsmetadaten der verwalteten Instanz. | "AzureAD" "Gekoppelt" "Windows" |
| Vergleichung | Sortierung der verwalteten Instanz. | Schnur |
| databaseFormat | Gibt das interne Format von Instanzdatenbanken an, die für die SQL-Modulversion spezifisch sind. | 'AlwaysUpToDate' 'SQLServer2022' |
| dnsZonePartner | Die Ressourcen-ID einer anderen verwalteten Instanz, deren DNS-Zone diese verwaltete Instanz nach der Erstellung freigeben wird. | Schnur |
| hybridSecondaryUsage | Hybride sekundäre Nutzung. Mögliche Werte sind "Aktiv" (Standardwert) und "Passiv" (Kunde verwendet die sekundäre als passive DR). | "Aktiv" "Passiv" |
| instancePoolId | Die ID des Instanzpools, zu dem dieser verwaltete Server gehört. | Schnur |
| 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. | Schnur |
| 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. | Schnur |
| 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. |
'Standard' 'PointInTimeRestore' |
| minimalTlsVersion | Minimale TLS-Version. Zulässige Werte: 'None', '1.0', '1.1', '1.2' | Schnur |
| pricingModel | Preismodell der verwalteten Instanz. | "Freemium" "Normal" |
| primaryUserAssignedIdentityId | Die Ressourcen-ID einer vom Benutzer zugewiesenen Identität, die standardmäßig verwendet werden soll. | Schnur |
| proxyOverride | Verbindungstyp, der für die Verbindung mit der Instanz verwendet wird. | 'Standard' 'Proxy' 'Umleitung' |
| 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" "Lokal" "Zone" |
| restorePointInTime | Gibt den Zeitpunkt (ISO8601 Format) der Quelldatenbank an, die wiederhergestellt wird, um die neue Datenbank zu erstellen. | Schnur |
| servicePrincipal | Dienstprinzipal der verwalteten Instanz. | ServicePrincipal- |
| sourceManagedInstanceId | Der Ressourcenbezeichner der verwalteten Quellinstanz, die dem Erstellungsvorgang dieser Instanz zugeordnet ist. | Schnur |
| storageIOps | Speicher-IOps. 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: 16384. 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 |
| subnetz-ID | Subnetzressourcen-ID für die verwaltete Instanz. | Schnur |
| 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. Europe Standard Time". |
Schnur |
| totalMemoryMB | Gesamtspeicher in MB. Mindestwert: 7168. Maximalwert: 891328. Nur Inkremente von 1 MB zulässig. Der Maximalwert hängt von der ausgewählten Hardwarefamilie und der Anzahl der vCores ab. | Int |
| vCores | Die Anzahl der vCores. Zulässige Werte: 8, 16, 24, 32, 40, 64, 80. | Int |
| zoneRedundant | Gibt an, ob das Multi-Az aktiviert ist. | Bool |
Microsoft.Sql/managedInstances
| Name | Beschreibung | Wert |
|---|---|---|
| Identität | Die Azure Active Directory-Identität der verwalteten Instanz. | ResourceIdentity- |
| Ort | Ressourcenspeicherort. | Zeichenfolge (erforderlich) |
| Name | Der Ressourcenname | Zeichenfolge (erforderlich) |
| Eigenschaften | Ressourceneigenschaften. | ManagedInstanceProperties- |
| Sku | SKU der verwalteten Instanz. Zulässige Werte für sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH | Sku- |
| Schilder | Ressourcentags | Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen |
ResourceIdentity
| Name | Beschreibung | Wert |
|---|---|---|
| Art | 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 | Beschreibung | Wert |
|---|
ServicePrincipal
| Name | Beschreibung | Wert |
|---|---|---|
| Art | Dienstprinzipaltyp. | 'None' 'SystemAssigned' |
Sku
| Name | Beschreibung | Wert |
|---|---|---|
| Fassungsvermögen | Kapazität der jeweiligen SKU. | Int |
| Familie | Wenn der Dienst über unterschiedliche Hardwaregenerationen verfügt, kann dies für dieselbe SKU hier erfasst werden. | Schnur |
| Name | Der Name der SKU, in der Regel ein Buchstabe + Zahlencode, z. B. P3. | Zeichenfolge (erforderlich) |
| Größe | Größe der jeweiligen SKU | Schnur |
| Rang | Die Stufe oder Edition der jeweiligen SKU, z. B. Basic, Premium. | Schnur |
TrackedResourceTags
| Name | Beschreibung | Wert |
|---|
UserIdentity
| Name | Beschreibung | Wert |
|---|
Schnellstartbeispiele
Die folgenden Schnellstartbeispiele stellen diesen Ressourcentyp bereit.
| Bicep-Datei | Beschreibung |
|---|---|
| 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-05-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",
"minimalTlsVersion": "string",
"pricingModel": "string",
"primaryUserAssignedIdentityId": "string",
"proxyOverride": "string",
"publicDataEndpointEnabled": "bool",
"requestedBackupStorageRedundancy": "string",
"restorePointInTime": "string",
"servicePrincipal": {
"type": "string"
},
"sourceManagedInstanceId": "string",
"storageIOps": "int",
"storageSizeInGB": "int",
"storageThroughputMBps": "int",
"subnetId": "string",
"timezoneId": "string",
"totalMemoryMB": "int",
"vCores": "int",
"zoneRedundant": "bool"
},
"sku": {
"capacity": "int",
"family": "string",
"name": "string",
"size": "string",
"tier": "string"
},
"tags": {
"{customized property}": "string"
}
}
Eigenschaftswerte
ManagedInstanceExternalAdministrator
| Name | Beschreibung | Wert |
|---|---|---|
| administratorType | Typ des Serveradministrators. | 'ActiveDirectory' |
| azureADOnlyAuthentication | Nur Azure Active Directory-Authentifizierung aktiviert. | Bool |
| einloggen | Anmeldename des Serveradministrators. | Schnur |
| principalType | Prinzipaltyp des Serveradministrators. | "Anwendung" "Gruppe" "Benutzer" |
| sid | SID (Objekt-ID) des Serveradministrators. | Schnur Zwänge: Min. Länge = 36 Maximale Länge = 36 Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| tenantId | Mandanten-ID des Administrators. | Schnur Zwänge: Min. Länge = 36 Maximale Länge = 36 Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
ManagedInstanceProperties
| Name | Beschreibung | Wert |
|---|---|---|
| administratorLogin | Administratorbenutzername für die verwaltete Instanz. Kann nur angegeben werden, wenn die verwaltete Instanz erstellt wird (und für die Erstellung erforderlich ist). | Schnur |
| administratorLoginPassword | Das Administratoranmeldungskennwort (erforderlich für die Erstellung verwalteter Instanzen). | Schnur Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter. |
| administratoren | Der Azure Active Directory-Administrator der Instanz. Dies kann nur zur Erstellungszeit der Instanz verwendet werden. Wenn sie z. B. aktualisiert wird, wird sie ignoriert oder führt zu einem Fehler. Für Updates müssen einzelne APIs verwendet werden. | ManagedInstanceExternalAdministrator- |
| authenticationMetadata | Nachschlagemodus für die Authentifizierungsmetadaten der verwalteten Instanz. | "AzureAD" "Gekoppelt" "Windows" |
| Vergleichung | Sortierung der verwalteten Instanz. | Schnur |
| databaseFormat | Gibt das interne Format von Instanzdatenbanken an, die für die SQL-Modulversion spezifisch sind. | 'AlwaysUpToDate' 'SQLServer2022' |
| dnsZonePartner | Die Ressourcen-ID einer anderen verwalteten Instanz, deren DNS-Zone diese verwaltete Instanz nach der Erstellung freigeben wird. | Schnur |
| hybridSecondaryUsage | Hybride sekundäre Nutzung. Mögliche Werte sind "Aktiv" (Standardwert) und "Passiv" (Kunde verwendet die sekundäre als passive DR). | "Aktiv" "Passiv" |
| instancePoolId | Die ID des Instanzpools, zu dem dieser verwaltete Server gehört. | Schnur |
| 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. | Schnur |
| 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. | Schnur |
| 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. |
'Standard' 'PointInTimeRestore' |
| minimalTlsVersion | Minimale TLS-Version. Zulässige Werte: 'None', '1.0', '1.1', '1.2' | Schnur |
| pricingModel | Preismodell der verwalteten Instanz. | "Freemium" "Normal" |
| primaryUserAssignedIdentityId | Die Ressourcen-ID einer vom Benutzer zugewiesenen Identität, die standardmäßig verwendet werden soll. | Schnur |
| proxyOverride | Verbindungstyp, der für die Verbindung mit der Instanz verwendet wird. | 'Standard' 'Proxy' 'Umleitung' |
| 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" "Lokal" "Zone" |
| restorePointInTime | Gibt den Zeitpunkt (ISO8601 Format) der Quelldatenbank an, die wiederhergestellt wird, um die neue Datenbank zu erstellen. | Schnur |
| servicePrincipal | Dienstprinzipal der verwalteten Instanz. | ServicePrincipal- |
| sourceManagedInstanceId | Der Ressourcenbezeichner der verwalteten Quellinstanz, die dem Erstellungsvorgang dieser Instanz zugeordnet ist. | Schnur |
| storageIOps | Speicher-IOps. 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: 16384. 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 |
| subnetz-ID | Subnetzressourcen-ID für die verwaltete Instanz. | Schnur |
| 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. Europe Standard Time". |
Schnur |
| totalMemoryMB | Gesamtspeicher in MB. Mindestwert: 7168. Maximalwert: 891328. Nur Inkremente von 1 MB zulässig. Der Maximalwert hängt von der ausgewählten Hardwarefamilie und der Anzahl der vCores ab. | Int |
| vCores | Die Anzahl der vCores. Zulässige Werte: 8, 16, 24, 32, 40, 64, 80. | Int |
| zoneRedundant | Gibt an, ob das Multi-Az aktiviert ist. | Bool |
Microsoft.Sql/managedInstances
| Name | Beschreibung | Wert |
|---|---|---|
| apiVersion | Die API-Version | "2024-05-01-preview" |
| Identität | Die Azure Active Directory-Identität der verwalteten Instanz. | ResourceIdentity- |
| Ort | Ressourcenspeicherort. | Zeichenfolge (erforderlich) |
| Name | Der Ressourcenname | Zeichenfolge (erforderlich) |
| Eigenschaften | Ressourceneigenschaften. | ManagedInstanceProperties- |
| Sku | SKU der verwalteten Instanz. Zulässige Werte für sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH | Sku- |
| Schilder | Ressourcentags | Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen |
| Art | Der Ressourcentyp | 'Microsoft.Sql/managedInstances' |
ResourceIdentity
| Name | Beschreibung | Wert |
|---|---|---|
| Art | 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 | Beschreibung | Wert |
|---|
ServicePrincipal
| Name | Beschreibung | Wert |
|---|---|---|
| Art | Dienstprinzipaltyp. | 'None' 'SystemAssigned' |
Sku
| Name | Beschreibung | Wert |
|---|---|---|
| Fassungsvermögen | Kapazität der jeweiligen SKU. | Int |
| Familie | Wenn der Dienst über unterschiedliche Hardwaregenerationen verfügt, kann dies für dieselbe SKU hier erfasst werden. | Schnur |
| Name | Der Name der SKU, in der Regel ein Buchstabe + Zahlencode, z. B. P3. | Zeichenfolge (erforderlich) |
| Größe | Größe der jeweiligen SKU | Schnur |
| Rang | Die Stufe oder Edition der jeweiligen SKU, z. B. Basic, Premium. | Schnur |
TrackedResourceTags
| Name | Beschreibung | Wert |
|---|
UserIdentity
| Name | Beschreibung | Wert |
|---|
Schnellstartvorlagen
Die folgenden Schnellstartvorlagen stellen diesen Ressourcentyp bereit.
| Schablone | Beschreibung |
|---|---|
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-05-01-preview"
name = "string"
identity = {
type = "string"
userAssignedIdentities = {
{customized property} = {
}
}
}
location = "string"
sku = {
capacity = int
family = "string"
name = "string"
size = "string"
tier = "string"
}
tags = {
{customized property} = "string"
}
body = jsonencode({
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"
minimalTlsVersion = "string"
pricingModel = "string"
primaryUserAssignedIdentityId = "string"
proxyOverride = "string"
publicDataEndpointEnabled = bool
requestedBackupStorageRedundancy = "string"
restorePointInTime = "string"
servicePrincipal = {
type = "string"
}
sourceManagedInstanceId = "string"
storageIOps = int
storageSizeInGB = int
storageThroughputMBps = int
subnetId = "string"
timezoneId = "string"
totalMemoryMB = int
vCores = int
zoneRedundant = bool
}
})
}
Eigenschaftswerte
ManagedInstanceExternalAdministrator
| Name | Beschreibung | Wert |
|---|---|---|
| administratorType | Typ des Serveradministrators. | 'ActiveDirectory' |
| azureADOnlyAuthentication | Nur Azure Active Directory-Authentifizierung aktiviert. | Bool |
| einloggen | Anmeldename des Serveradministrators. | Schnur |
| principalType | Prinzipaltyp des Serveradministrators. | "Anwendung" "Gruppe" "Benutzer" |
| sid | SID (Objekt-ID) des Serveradministrators. | Schnur Zwänge: Min. Länge = 36 Maximale Länge = 36 Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| tenantId | Mandanten-ID des Administrators. | Schnur Zwänge: Min. Länge = 36 Maximale Länge = 36 Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
ManagedInstanceProperties
| Name | Beschreibung | Wert |
|---|---|---|
| administratorLogin | Administratorbenutzername für die verwaltete Instanz. Kann nur angegeben werden, wenn die verwaltete Instanz erstellt wird (und für die Erstellung erforderlich ist). | Schnur |
| administratorLoginPassword | Das Administratoranmeldungskennwort (erforderlich für die Erstellung verwalteter Instanzen). | Schnur Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter. |
| administratoren | Der Azure Active Directory-Administrator der Instanz. Dies kann nur zur Erstellungszeit der Instanz verwendet werden. Wenn sie z. B. aktualisiert wird, wird sie ignoriert oder führt zu einem Fehler. Für Updates müssen einzelne APIs verwendet werden. | ManagedInstanceExternalAdministrator- |
| authenticationMetadata | Nachschlagemodus für die Authentifizierungsmetadaten der verwalteten Instanz. | "AzureAD" "Gekoppelt" "Windows" |
| Vergleichung | Sortierung der verwalteten Instanz. | Schnur |
| databaseFormat | Gibt das interne Format von Instanzdatenbanken an, die für die SQL-Modulversion spezifisch sind. | 'AlwaysUpToDate' 'SQLServer2022' |
| dnsZonePartner | Die Ressourcen-ID einer anderen verwalteten Instanz, deren DNS-Zone diese verwaltete Instanz nach der Erstellung freigeben wird. | Schnur |
| hybridSecondaryUsage | Hybride sekundäre Nutzung. Mögliche Werte sind "Aktiv" (Standardwert) und "Passiv" (Kunde verwendet die sekundäre als passive DR). | "Aktiv" "Passiv" |
| instancePoolId | Die ID des Instanzpools, zu dem dieser verwaltete Server gehört. | Schnur |
| 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. | Schnur |
| 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. | Schnur |
| 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. |
'Standard' 'PointInTimeRestore' |
| minimalTlsVersion | Minimale TLS-Version. Zulässige Werte: 'None', '1.0', '1.1', '1.2' | Schnur |
| pricingModel | Preismodell der verwalteten Instanz. | "Freemium" "Normal" |
| primaryUserAssignedIdentityId | Die Ressourcen-ID einer vom Benutzer zugewiesenen Identität, die standardmäßig verwendet werden soll. | Schnur |
| proxyOverride | Verbindungstyp, der für die Verbindung mit der Instanz verwendet wird. | 'Standard' 'Proxy' 'Umleitung' |
| 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" "Lokal" "Zone" |
| restorePointInTime | Gibt den Zeitpunkt (ISO8601 Format) der Quelldatenbank an, die wiederhergestellt wird, um die neue Datenbank zu erstellen. | Schnur |
| servicePrincipal | Dienstprinzipal der verwalteten Instanz. | ServicePrincipal- |
| sourceManagedInstanceId | Der Ressourcenbezeichner der verwalteten Quellinstanz, die dem Erstellungsvorgang dieser Instanz zugeordnet ist. | Schnur |
| storageIOps | Speicher-IOps. 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: 16384. 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 |
| subnetz-ID | Subnetzressourcen-ID für die verwaltete Instanz. | Schnur |
| 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. Europe Standard Time". |
Schnur |
| totalMemoryMB | Gesamtspeicher in MB. Mindestwert: 7168. Maximalwert: 891328. Nur Inkremente von 1 MB zulässig. Der Maximalwert hängt von der ausgewählten Hardwarefamilie und der Anzahl der vCores ab. | Int |
| vCores | Die Anzahl der vCores. Zulässige Werte: 8, 16, 24, 32, 40, 64, 80. | Int |
| zoneRedundant | Gibt an, ob das Multi-Az aktiviert ist. | Bool |
Microsoft.Sql/managedInstances
| Name | Beschreibung | Wert |
|---|---|---|
| Identität | Die Azure Active Directory-Identität der verwalteten Instanz. | ResourceIdentity- |
| Ort | Ressourcenspeicherort. | Zeichenfolge (erforderlich) |
| Name | Der Ressourcenname | Zeichenfolge (erforderlich) |
| Eigenschaften | Ressourceneigenschaften. | ManagedInstanceProperties- |
| Sku | SKU der verwalteten Instanz. Zulässige Werte für sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH | Sku- |
| Schilder | Ressourcentags | Wörterbuch der Tagnamen und -werte. |
| Art | Der Ressourcentyp | "Microsoft.Sql/managedInstances@2024-05-01-preview" |
ResourceIdentity
| Name | Beschreibung | Wert |
|---|---|---|
| Art | 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 | Beschreibung | Wert |
|---|
ServicePrincipal
| Name | Beschreibung | Wert |
|---|---|---|
| Art | Dienstprinzipaltyp. | 'None' 'SystemAssigned' |
Sku
| Name | Beschreibung | Wert |
|---|---|---|
| Fassungsvermögen | Kapazität der jeweiligen SKU. | Int |
| Familie | Wenn der Dienst über unterschiedliche Hardwaregenerationen verfügt, kann dies für dieselbe SKU hier erfasst werden. | Schnur |
| Name | Der Name der SKU, in der Regel ein Buchstabe + Zahlencode, z. B. P3. | Zeichenfolge (erforderlich) |
| Größe | Größe der jeweiligen SKU | Schnur |
| Rang | Die Stufe oder Edition der jeweiligen SKU, z. B. Basic, Premium. | Schnur |
TrackedResourceTags
| Name | Beschreibung | Wert |
|---|
UserIdentity
| Name | Beschreibung | Wert |
|---|