Microsoft.Sql managedInstances 2023-05-01-preview
- Neueste
- 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 Bereitstellungsbefehle für Ressourcengruppen
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie im Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.Sql/managedInstances-Ressource zu erstellen, fügen Sie ihrer Vorlage den folgenden Bicep hinzu.
resource symbolicname 'Microsoft.Sql/managedInstances@2023-05-01-preview' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
sku: {
capacity: int
family: 'string'
name: 'string'
size: 'string'
tier: 'string'
}
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
properties: {
administratorLogin: 'string'
administratorLoginPassword: 'string'
administrators: {
administratorType: 'ActiveDirectory'
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'
vCores: int
zoneRedundant: bool
}
}
Eigenschaftswerte
managedInstances
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| name | Der Ressourcenname | Zeichenfolge (erforderlich) Zeichenlimit: 1-63 Gültige Zeichen: Kleinbuchstaben, Zahlen und Bindestriche. Darf nicht mit einem Bindestrich beginnen oder enden. Der Ressourcenname muss in Azure eindeutig sein. |
| location | Ressourcenspeicherort | Zeichenfolge (erforderlich) |
| tags | Ressourcentags. | Wörterbuch der Tagnamen und -werte. Weitere Informationen finden Sie unter Tags in Vorlagen. |
| sku | Verwaltete instance SKU. Zulässige Werte für sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH | sku |
| Identität | Die Azure Active Directory-Identität des verwalteten instance. | ResourceIdentity |
| properties | Ressourceneigenschaften. | ManagedInstanceProperties |
ResourceIdentity
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| 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. | "Keine" "SystemAssigned" 'SystemAssigned,UserAssigned' "UserAssigned" |
| userAssignedIdentities | Die Ressourcen-IDs der vom Benutzer zugewiesenen Identitäten, die verwendet werden sollen | ResourceIdentityUserAssignedIdentities |
ResourceIdentityUserAssignedIdentities
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| {angepasste Eigenschaft} | UserIdentity |
UserIdentity
Dieses Objekt enthält keine Eigenschaften, die während der Bereitstellung festgelegt werden sollen. Alle Eigenschaften sind ReadOnly.
ManagedInstanceProperties
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| administratorLogin | Administratorbenutzername für die verwaltete instance. Kann nur angegeben werden, wenn die verwaltete instance erstellt wird (und für die Erstellung erforderlich ist). | Zeichenfolge |
| administratorLoginPassword | Das Administratoranmeldekennwort (erforderlich für die Erstellung von verwalteten instance). | Zeichenfolge Einschränkungen: Vertraulicher Wert. Übergeben Sie als sicheren Parameter. |
| Administratoren | Der Azure Active Directory-Administrator des instance. Dies kann nur zum Zeitpunkt der Erstellung instance verwendet werden. Wenn sie für instance Update verwendet wird, wird es ignoriert oder führt zu einem Fehler. Für Updates müssen einzelne APIs verwendet werden. | ManagedInstanceExternalAdministrator |
| authenticationMetadata | Der Suchmodus für Authentifizierungsmetadaten des verwalteten instance. | "AzureAD" "Gekoppelt" "Windows" |
| collation | Sortierung der verwalteten instance. | Zeichenfolge |
| databaseFormat | Gibt das interne Format von instance Datenbanken an, die für die SQL-Engine-Version spezifisch sind. | "AlwaysUpToDate" "SQLServer2022" |
| dnsZonePartner | Die Ressourcen-ID eines anderen verwalteten instance dessen DNS-Zone von diesem verwalteten instance nach der Erstellung freigegeben wird. | Zeichenfolge |
| hybridSecondaryUsage | Sekundäre Hybridnutzung. Mögliche Werte sind "Active" (Standardwert) und "Passiv" (der Kunde verwendet die sekundäre Notfallwiederherstellung als passive Notfallwiederherstellung). | "Aktiv" "Passiv" |
| instancePoolId | Die ID des instance Pools, zu dem dieser verwaltete Server gehört. | Zeichenfolge |
| isGeneralPurposeV2 | Gibt an, ob dies eine GPv2-Variante von Universell Edition ist oder nicht. | bool |
| keyId | Ein CMK-URI des Schlüssels, der für die Verschlüsselung verwendet werden soll. | Zeichenfolge |
| licenseType | Der Lizenztyp. Mögliche Werte sind "LicenseIncluded" (regulärer Preis inklusive einer neuen SQL-Lizenz) und "BasePrice" (ermäßigter AHB-Preis für das Mitbringen Eigener SQL-Lizenzen). | "Basispreis" "LicenseIncluded" |
| maintenanceConfigurationId | Gibt die Id der Wartungskonfiguration an, die auf diese verwaltete instance angewendet werden soll. | Zeichenfolge |
| managedInstanceCreateMode | Gibt den Modus der Datenbankerstellung an. Standard: Reguläre instance Erstellung. Wiederherstellen: Erstellt eine instance, indem eine Reihe von Sicherungen auf einen bestimmten Zeitpunkt wiederhergestellt werden. RestorePointInTime und SourceManagedInstanceId müssen angegeben werden. |
'Standardwert' 'PointInTimeRestore' |
| minimalTlsVersion | Minimale TLS-Version. Zulässige Werte: "None", "1.0", "1.1", "1.2" | Zeichenfolge |
| pricingModel | Wetter oder nicht verwaltete Instanz ist Freemium. | "Freemium" "Normal" |
| primaryUserAssignedIdentityId | Die Ressourcen-ID einer benutzerseitig zugewiesenen Identität, die standardmäßig verwendet werden soll. | Zeichenfolge |
| proxyOverride | Verbindungstyp, der zum Herstellen einer Verbindung mit dem instance verwendet wird. | 'Standardwert' "Proxy" "Umleitung" |
| publicDataEndpointEnabled | Gibt an, ob der öffentliche Datenendpunkt aktiviert ist. | bool |
| requestedBackupStorageRedundancy | Der Speicherkontotyp, der zum Speichern von Sicherungen für diese instance verwendet werden soll. Die Optionen sind Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) und GeoZone(GeoZoneRedundantStorage). | "Geo" 'GeoZone' "Lokal" "Zone" |
| restorePointInTime | Gibt den Zeitpunkt (ISO8601 Format) der Quelldatenbank an, die zum Erstellen der neuen Datenbank wiederhergestellt wird. | Zeichenfolge |
| servicePrincipal | Der Dienstprinzipal des verwalteten instance. | ServicePrincipal |
| sourceManagedInstanceId | Der Ressourcenbezeichner der verwalteten quellseitig verwalteten instance, die dem Erstellungsvorgang dieses instance zugeordnet ist. | Zeichenfolge |
| storageIOps | Speicher-IOps. Mindestwert: 120. Maximaler Wert: 120000. Nur Inkremente von 1 IOps zulässig. Der Maximalwert hängt von der ausgewählten Hardwarefamilie und der Anzahl der virtuellen Kerne ab. | INT |
| storageSizeInGB | Speichergröße in GB. Mindestwert: 32. Maximaler Wert: 16384. Nur Inkremente von 32 GB zulässig. Der Maximalwert hängt von der ausgewählten Hardwarefamilie und der Anzahl der virtuellen Kerne ab. | INT |
| storageThroughputMBITPS | Speicherdurchsatz in MBit/s. Mindestwert: 25. Maximaler Wert: 4000. Nur Inkremente von 1 MBit/s sind zulässig. Der Maximalwert hängt von der ausgewählten Hardwarefamilie und der Anzahl der virtuellen Kerne ab. | INT |
| subnetId | Subnetzressourcen-ID für die verwaltete instance. | Zeichenfolge |
| timezoneId | Id der Zeitzone. Zulässige Werte sind von Windows unterstützte Zeitzonen. Windows speichert Details zu unterstützten Zeitzonen, einschließlich der ID, in der Registrierung unter KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. 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 abgerufen werden, indem Sie [System.TimeZoneInfo]::GetSystemTimeZones() in PowerShell ausführen. Ein Beispiel für eine gültige Zeitzonen-ID ist "Pacific Standard Time" oder "W. Europa Standardzeit". |
Zeichenfolge |
| V-Kerne | Die Anzahl der virtuellen Kerne. Zulässige Werte: 8, 16, 24, 32, 40, 64, 80. | INT |
| zoneRedundant | Gibt an, ob multi-az aktiviert ist. | bool |
ManagedInstanceExternalAdministrator
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| administratorType | Typ des Serveradministrators. | 'ActiveDirectory' |
| azureADOnlyAuthentication | Nur Azure Active Directory-Authentifizierung aktiviert. | bool |
| login | Anmeldename des Serveradministrators. | Zeichenfolge |
| principalType | Prinzipaltyp des Serveradministrators. | "Anwendung" "Gruppe" "Benutzer" |
| sid | SID (Objekt-ID) des Serveradministrators. | Zeichenfolge Einschränkungen: 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. | Zeichenfolge Einschränkungen: 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}$ |
ServicePrincipal
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| type | Dienstprinzipaltyp. | "Keine" "SystemAssigned" |
Sku
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| Kapazität | Kapazität der jeweiligen SKU. | INT |
| family | Wenn der Dienst über unterschiedliche Hardwaregenerationen für dieselbe SKU verfügt, kann dies hier erfasst werden. | Zeichenfolge |
| name | Der Name der SKU, in der Regel ein Buchstabe + Zahlencode, z. B. P3. | Zeichenfolge (erforderlich) |
| size | Größe der jeweiligen SKU | Zeichenfolge |
| Ebene | Der Tarif oder die Edition der jeweiligen SKU, z. B. Basic, Premium. | Zeichenfolge |
Schnellstartvorlagen
Diesen Ressourcentyp werden in den folgenden Schnellstartvorlagen bereitgestellt.
| Vorlage | BESCHREIBUNG |
|---|---|
Bereitstellen von SQL Managed Instance mit Netzwerk |
Bereitstellen von UDR und NSG zur Unterstützung Azure SQL Managed Instance und Bereitstellen der verwaltete Instanz |
| Erstellen von SQL MI im neuen virtuellen Netzwerk |
Bereitstellen von Azure Sql Database verwaltete Instanz (SQL MI) in neuen Virtual Network. |
| Erstellen von SQL MI mit konfiguriertem Senden 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 in einem neuen virtuellen Netzwerk |
Bereitstellen von Azure Sql Database verwaltete Instanz (SQL MI) und JumpBox mit SSMS in neuen Virtual Network. |
| Erstellen von SQL MI mit konfigurierter Point-to-Site-Verbindung |
Stellen Sie Azure Sql Database verwaltete Instanz (SQL MI) und das Gateway für virtuelle Netzwerke bereit, das für die Point-to-Site-Verbindung innerhalb des neuen virtuellen Netzwerks konfiguriert ist. |
Ressourcendefinition mit einer ARM-Vorlage
Der ressourcentyp managedInstances kann mit Vorgängen bereitgestellt werden, die folgendes zum Ziel haben:
- Ressourcengruppen – Siehe Bereitstellungsbefehle für Ressourcengruppen
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie im Ä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": "2023-05-01-preview",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"sku": {
"capacity": "int",
"family": "string",
"name": "string",
"size": "string",
"tier": "string"
},
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {}
}
},
"properties": {
"administratorLogin": "string",
"administratorLoginPassword": "string",
"administrators": {
"administratorType": "ActiveDirectory",
"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",
"vCores": "int",
"zoneRedundant": "bool"
}
}
Eigenschaftswerte
managedInstances
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| type | Der Ressourcentyp | "Microsoft.Sql/managedInstances" |
| apiVersion | Die Version der Ressourcen-API | "2023-05-01-preview" |
| name | Der Ressourcenname | Zeichenfolge (erforderlich) Zeichenlimit: 1-63 Gültige Zeichen: Kleinbuchstaben, Zahlen und Bindestriche. Darf nicht mit einem Bindestrich beginnen oder enden. Der Ressourcenname muss in Azure eindeutig sein. |
| location | Ressourcenspeicherort | Zeichenfolge (erforderlich) |
| tags | Ressourcentags. | Wörterbuch der Tagnamen und -werte. Weitere Informationen finden Sie unter Tags in Vorlagen. |
| sku | Verwaltete instance SKU. Zulässige Werte für sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH | sku |
| Identität | Die Azure Active Directory-Identität des verwalteten instance. | ResourceIdentity |
| properties | Ressourceneigenschaften. | ManagedInstanceProperties |
ResourceIdentity
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| 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. | "Keine" "SystemAssigned" 'SystemAssigned,UserAssigned' "UserAssigned" |
| userAssignedIdentities | Die Ressourcen-IDs der vom Benutzer zugewiesenen Identitäten, die verwendet werden sollen | ResourceIdentityUserAssignedIdentities |
ResourceIdentityUserAssignedIdentities
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| {angepasste Eigenschaft} | UserIdentity |
UserIdentity
Dieses Objekt enthält keine Eigenschaften, die während der Bereitstellung festgelegt werden sollen. Alle Eigenschaften sind ReadOnly.
ManagedInstanceProperties
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| administratorLogin | Administratorbenutzername für die verwaltete instance. Kann nur angegeben werden, wenn die verwaltete instance erstellt wird (und für die Erstellung erforderlich ist). | Zeichenfolge |
| administratorLoginPassword | Das Administratoranmeldekennwort (erforderlich für die Erstellung von verwalteten instance). | Zeichenfolge Einschränkungen: Vertraulicher Wert. Übergeben Sie als sicheren Parameter. |
| Administratoren | Der Azure Active Directory-Administrator des instance. Dies kann nur zum Zeitpunkt der Erstellung instance verwendet werden. Wenn sie für instance Update verwendet wird, wird es ignoriert oder führt zu einem Fehler. Für Updates müssen einzelne APIs verwendet werden. | ManagedInstanceExternalAdministrator |
| authenticationMetadata | Der Suchmodus für Authentifizierungsmetadaten des verwalteten instance. | "AzureAD" "Gekoppelt" "Windows" |
| collation | Sortierung der verwalteten instance. | Zeichenfolge |
| databaseFormat | Gibt das interne Format von instance Datenbanken an, die für die SQL-Engine-Version spezifisch sind. | "AlwaysUpToDate" "SQLServer2022" |
| dnsZonePartner | Die Ressourcen-ID eines anderen verwalteten instance dessen DNS-Zone von diesem verwalteten instance nach der Erstellung freigegeben wird. | Zeichenfolge |
| hybridSecondaryUsage | Sekundäre Hybridnutzung. Mögliche Werte sind "Active" (Standardwert) und "Passiv" (der Kunde verwendet das sekundäre Als Passive DR). | "Aktiv" "Passiv" |
| instancePoolId | Die ID des instance Pools, zu dem dieser verwaltete Server gehört. | Zeichenfolge |
| isGeneralPurposeV2 | Gibt an, ob dies eine GPv2-Variante von Universell Edition ist oder nicht. | bool |
| keyId | Ein CMK-URI des Schlüssels, der für die Verschlüsselung verwendet werden soll. | Zeichenfolge |
| licenseType | Der Lizenztyp. Mögliche Werte sind "LicenseIncluded" (regulärer Preis inklusive einer neuen SQL-Lizenz) und "BasePrice" (ermäßigter AHB-Preis für die Bereitstellung Ihrer eigenen SQL-Lizenzen). | "BasePrice" "LicenseIncluded" |
| maintenanceConfigurationId | Gibt die Wartungskonfigurations-ID an, die auf diese verwaltete instance angewendet werden soll. | Zeichenfolge |
| managedInstanceCreateMode | Gibt den Modus der Datenbankerstellung an. Standard: Reguläre instance Erstellung. Wiederherstellung: Erstellt eine instance, indem eine Reihe von Sicherungen auf einen bestimmten Zeitpunkt wiederhergestellt wird. RestorePointInTime und SourceManagedInstanceId müssen angegeben werden. |
'Standardwert' 'PointInTimeRestore' |
| minimalTlsVersion | Minimale TLS-Version. Zulässige Werte: "None", "1.0", "1.1", "1.2" | Zeichenfolge |
| pricingModel | Wetter oder nicht verwaltete Instanz ist Freemium. | 'Freemium' "Normal" |
| primaryUserAssignedIdentityId | Die Ressourcen-ID einer benutzerseitig zugewiesenen Identität, die standardmäßig verwendet werden soll. | Zeichenfolge |
| proxyOverride | Verbindungstyp, der zum Herstellen einer Verbindung mit dem instance verwendet wird. | 'Standardwert' "Proxy" "Umleitung" |
| publicDataEndpointEnabled | Gibt an, ob der öffentliche Datenendpunkt aktiviert ist. | bool |
| requestedBackupStorageRedundancy | Der Speicherkontotyp, der zum Speichern von Sicherungen für diese instance verwendet werden soll. Die Optionen sind Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) und GeoZone(GeoZoneRedundantStorage). | "Geo" 'GeoZone' "Lokal" "Zone" |
| restorePointInTime | Gibt den Zeitpunkt (ISO8601 Format) der Quelldatenbank an, die zum Erstellen der neuen Datenbank wiederhergestellt wird. | Zeichenfolge |
| servicePrincipal | Der Dienstprinzipal des verwalteten instance. | ServicePrincipal |
| sourceManagedInstanceId | Der Ressourcenbezeichner der verwalteten Quelle instance dem Erstellungsvorgang dieses instance zugeordnet. | Zeichenfolge |
| storageIOps | Speicher-IOps. Mindestwert: 120. Maximaler Wert: 120000. Nur Inkremente von 1 IOps zulässig. Der maximale Wert hängt von der ausgewählten Hardwarefamilie und der Anzahl der virtuellen Kerne ab. | INT |
| storageSizeInGB | Speichergröße in GB. Mindestwert: 32. Maximalwert: 16384. Nur Inkremente von 32 GB zulässig. Der maximale Wert hängt von der ausgewählten Hardwarefamilie und der Anzahl der virtuellen Kerne ab. | INT |
| storageThroughputMBps | Speicherdurchsatz in MBps. Mindestwert: 25. Maximaler Wert: 4000. Nur Inkremente von 1 MBit/s sind zulässig. Der maximale Wert hängt von der ausgewählten Hardwarefamilie und der Anzahl der virtuellen Kerne ab. | INT |
| subnetId | Subnetzressourcen-ID für die verwaltete instance. | Zeichenfolge |
| timezoneId | Id der Zeitzone. Zulässige Werte sind von Windows unterstützte Zeitzonen. Windows speichert Details zu unterstützten Zeitzonen, einschließlich der ID, in der Registrierung unter KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. 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 abgerufen werden, indem Sie [System.TimeZoneInfo]::GetSystemTimeZones() in PowerShell ausführen. Ein Beispiel für eine gültige Zeitzonen-ID ist "Pacific Standard Time" oder "W. Europa Standardzeit". |
Zeichenfolge |
| V-Kerne | Die Anzahl der virtuellen Kerne. Zulässige Werte: 8, 16, 24, 32, 40, 64, 80. | INT |
| zoneRedundant | Gibt an, ob multi-az aktiviert ist. | bool |
ManagedInstanceExternalAdministrator
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| administratorType | Typ des Serveradministrators. | 'ActiveDirectory' |
| azureADOnlyAuthentication | Nur Azure Active Directory-Authentifizierung aktiviert. | bool |
| login | Anmeldename des Serveradministrators. | Zeichenfolge |
| principalType | Prinzipaltyp des Serveradministrators. | "Anwendung" "Gruppe" "Benutzer" |
| sid | SID (Objekt-ID) des Serveradministrators. | Zeichenfolge Einschränkungen: 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. | Zeichenfolge Einschränkungen: 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}$ |
ServicePrincipal
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| type | Dienstprinzipaltyp. | "Keine" "SystemAssigned" |
Sku
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| Kapazität | Kapazität der jeweiligen SKU. | INT |
| family | Wenn der Dienst über unterschiedliche Hardwaregenerationen für dieselbe SKU verfügt, kann dies hier erfasst werden. | Zeichenfolge |
| name | Der Name der SKU, in der Regel ein Buchstabe + Zahlencode, z. B. P3. | Zeichenfolge (erforderlich) |
| size | Größe der jeweiligen SKU | Zeichenfolge |
| Ebene | Der Tarif oder die Edition der jeweiligen SKU, z. B. Basic, Premium. | Zeichenfolge |
Schnellstartvorlagen
Diesen Ressourcentyp werden in den folgenden Schnellstartvorlagen bereitgestellt.
| Vorlage | BESCHREIBUNG |
|---|---|
| Bereitstellen von SQL Managed Instance mit Netzwerk |
Bereitstellen von UDR und NSG zur Unterstützung Azure SQL Managed Instance und Bereitstellen der verwaltete Instanz |
| Erstellen von SQL MI im neuen virtuellen Netzwerk |
Bereitstellen von Azure Sql Database verwaltete Instanz (SQL MI) in neuen Virtual Network. |
| Erstellen von SQL MI mit konfiguriertem Senden 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 in einem neuen virtuellen Netzwerk |
Bereitstellen von Azure Sql Database verwaltete Instanz (SQL MI) und JumpBox mit SSMS in neuen Virtual Network. |
| Erstellen von SQL MI mit konfigurierter Point-to-Site-Verbindung |
Stellen Sie Azure Sql Database verwaltete Instanz (SQL MI) und das Gateway für virtuelle Netzwerke bereit, das für die Point-to-Site-Verbindung innerhalb des neuen virtuellen Netzwerks konfiguriert ist. |
Terraform (AzAPI-Anbieter) Ressourcendefinition
Der ressourcentyp managedInstances kann mit Vorgängen bereitgestellt werden, die folgendes zum Ziel haben:
- 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 Der Vorlage die folgende Terraform-Ressource hinzu.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Sql/managedInstances@2023-05-01-preview"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
identity {
type = "string"
identity_ids = []
}
body = jsonencode({
properties = {
administratorLogin = "string"
administratorLoginPassword = "string"
administrators = {
administratorType = "ActiveDirectory"
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"
vCores = int
zoneRedundant = bool
}
sku = {
capacity = int
family = "string"
name = "string"
size = "string"
tier = "string"
}
})
}
Eigenschaftswerte
managedInstances
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| type | Ressourcentyp | "Microsoft.Sql/managedInstances@2023-05-01-preview" |
| name | Der Ressourcenname | Zeichenfolge (erforderlich) Zeichenlimit: 1-63 Gültige Zeichen: Kleinbuchstaben, Zahlen und Bindestriche. Darf nicht mit einem Bindestrich beginnen oder enden. Der Ressourcenname muss in Azure eindeutig sein. |
| location | Ressourcenspeicherort | Zeichenfolge (erforderlich) |
| parent_id | Verwenden Sie zum Bereitstellen in einer Ressourcengruppe die ID dieser Ressourcengruppe. | Zeichenfolge (erforderlich) |
| tags | Ressourcentags. | Wörterbuch der Tagnamen und -werte. |
| sku | Verwaltete instance-SKU. Zulässige Werte für sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH | sku |
| Identität | Die Azure Active Directory-Identität des verwalteten instance. | ResourceIdentity |
| properties | Ressourceneigenschaften. | ManagedInstanceProperties |
ResourceIdentity
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| 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. | "SystemAssigned" "SystemAssigned,UserAssigned" "UserAssigned" |
| identity_ids | Die Ressourcen-ID der zu verwendenden benutzerseitig zugewiesenen Identitäten | Array von Benutzeridentitäts-IDs. |
ResourceIdentityUserAssignedIdentities
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| {angepasste Eigenschaft} | UserIdentity |
UserIdentity
Dieses Objekt enthält keine Eigenschaften, die während der Bereitstellung festgelegt werden sollen. Alle Eigenschaften sind ReadOnly.
ManagedInstanceProperties
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| administratorLogin | Administratorbenutzername für die verwaltete instance. Kann nur angegeben werden, wenn die verwaltete instance erstellt wird (und für die Erstellung erforderlich ist). | Zeichenfolge |
| administratorLoginPassword | Das Administratorkennwort (erforderlich für die Erstellung von verwalteten instance). | Zeichenfolge Einschränkungen: Vertraulicher Wert. Übergeben Sie als sicheren Parameter. |
| Administratoren | Der Azure Active Directory-Administrator des instance. Dies kann nur instance Erstellungszeit verwendet werden. Wenn sie für instance Update verwendet wird, wird dies ignoriert oder führt zu einem Fehler. Für Updates müssen einzelne APIs verwendet werden. | ManagedInstanceExternalAdministrator |
| authenticationMetadata | Der Nachschlagemodus für Authentifizierungsmetadaten des verwalteten instance. | "AzureAD" "Gekoppelt" "Windows" |
| collation | Sortierung der verwalteten instance. | Zeichenfolge |
| databaseFormat | Gibt das interne Format instance Datenbanken an, die für die SQL-Engine-Version spezifisch sind. | "AlwaysUpToDate" "SQLServer2022" |
| dnsZonePartner | Die Ressourcen-ID eines anderen verwalteten instance dessen DNS-Zone dieser verwaltete instance nach der Erstellung freigegeben wird. | Zeichenfolge |
| hybridSecondaryUsage | Sekundäre Hybridnutzung. Mögliche Werte sind "Active" (Standardwert) und "Passiv" (der Kunde verwendet das sekundäre Als Passive DR). | "Aktiv" "Passiv" |
| instancePoolId | Die ID des instance Pools, zu dem dieser verwaltete Server gehört. | Zeichenfolge |
| isGeneralPurposeV2 | Gibt an, ob dies eine GPv2-Variante von Universell Edition ist oder nicht. | bool |
| keyId | Ein CMK-URI des Schlüssels, der für die Verschlüsselung verwendet werden soll. | Zeichenfolge |
| licenseType | Der Lizenztyp. Mögliche Werte sind "LicenseIncluded" (regulärer Preis inklusive einer neuen SQL-Lizenz) und "BasePrice" (ermäßigter AHB-Preis für die Bereitstellung Ihrer eigenen SQL-Lizenzen). | "BasePrice" "LicenseIncluded" |
| maintenanceConfigurationId | Gibt die Wartungskonfigurations-ID an, die auf diese verwaltete instance angewendet werden soll. | Zeichenfolge |
| managedInstanceCreateMode | Gibt den Modus der Datenbankerstellung an. Standard: Reguläre instance Erstellung. Wiederherstellen: Erstellt eine instance, indem eine Reihe von Sicherungen auf einen bestimmten Zeitpunkt wiederhergestellt werden. RestorePointInTime und SourceManagedInstanceId müssen angegeben werden. |
"Standard" "PointInTimeRestore" |
| minimalTlsVersion | Minimale TLS-Version. Zulässige Werte: "None", "1.0", "1.1", "1.2" | Zeichenfolge |
| pricingModel | Wetter oder nicht verwaltete Instanz ist Freemium. | "Freemium" "Normal" |
| primaryUserAssignedIdentityId | Die Ressourcen-ID einer benutzerseitig zugewiesenen Identität, die standardmäßig verwendet werden soll. | Zeichenfolge |
| proxyOverride | Verbindungstyp, der zum Herstellen einer Verbindung mit dem instance 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 instance verwendet werden soll. Die Optionen sind Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) und GeoZone(GeoZoneRedundantStorage). | "Geo" "GeoZone" "Lokal" "Zone" |
| restorePointInTime | Gibt den Zeitpunkt (ISO8601 Format) der Quelldatenbank an, die zum Erstellen der neuen Datenbank wiederhergestellt wird. | Zeichenfolge |
| servicePrincipal | Der Dienstprinzipal des verwalteten instance. | ServicePrincipal |
| sourceManagedInstanceId | Der Ressourcenbezeichner der verwalteten quellseitig verwalteten instance, die dem Erstellungsvorgang dieses instance zugeordnet ist. | Zeichenfolge |
| storageIOps | Speicher-IOps. Mindestwert: 120. Maximaler Wert: 120000. Nur Inkremente von 1 IOps zulässig. Der Maximalwert hängt von der ausgewählten Hardwarefamilie und der Anzahl der virtuellen Kerne ab. | INT |
| storageSizeInGB | Speichergröße in GB. Mindestwert: 32. Maximaler Wert: 16384. Nur Inkremente von 32 GB zulässig. Der Maximalwert hängt von der ausgewählten Hardwarefamilie und der Anzahl der virtuellen Kerne ab. | INT |
| storageThroughputMBITPS | Speicherdurchsatz in MBit/s. Mindestwert: 25. Maximaler Wert: 4000. Nur Inkremente von 1 MBit/s sind zulässig. Der Maximalwert hängt von der ausgewählten Hardwarefamilie und der Anzahl der virtuellen Kerne ab. | INT |
| subnetId | Subnetzressourcen-ID für die verwaltete instance. | Zeichenfolge |
| timezoneId | ID der Zeitzone. Zulässige Werte sind Zeitzonen, die von Windows unterstützt werden. Windows speichert Details zu unterstützten Zeitzonen, einschließlich der ID, in der Registrierung unter KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. 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 abgerufen werden, indem Sie [System.TimeZoneInfo]::GetSystemTimeZones() in PowerShell ausführen. Ein Beispiel für eine gültige Zeitzonen-ID ist "Pacific Standard Time" oder "W. Europa Normalzeit". |
Zeichenfolge |
| V-Kerne | Die Anzahl der virtuellen Kerne. Zulässige Werte: 8, 16, 24, 32, 40, 64, 80. | INT |
| zoneRedundant | Gibt an, ob multi-az aktiviert ist. | bool |
ManagedInstanceExternalAdministrator
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| administratorType | Typ des Serveradministrators. | "ActiveDirectory" |
| azureADOnlyAuthentication | Nur Azure Active Directory-Authentifizierung aktiviert. | bool |
| login | Anmeldename des Serveradministrators. | Zeichenfolge |
| principalType | Prinzipaltyp des Serveradministrators. | "Anwendung" "Gruppe" User |
| sid | SID (Objekt-ID) des Serveradministrators. | Zeichenfolge Einschränkungen: 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. | Zeichenfolge Einschränkungen: 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}$ |
ServicePrincipal
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| type | Dienstprinzipaltyp. | "None" "SystemAssigned" |
Sku
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| Kapazität | Kapazität der jeweiligen SKU. | INT |
| family | Wenn der Dienst über unterschiedliche Hardwaregenerationen für dieselbe SKU verfügt, kann dies hier erfasst werden. | Zeichenfolge |
| name | Der Name der SKU, in der Regel ein Buchstabe + Zahlencode, z. B. P3. | Zeichenfolge (erforderlich) |
| size | Größe der jeweiligen SKU | Zeichenfolge |
| Ebene | Der Tarif oder die Edition der jeweiligen SKU, z. B. Basic, Premium. | Zeichenfolge |