Freigeben über

Microsoft.Sql managedInstances

  • Artikel

Bicep-Ressourcendefinition

Der ressourcentyp managedInstances kann mit Vorgängen bereitgestellt werden, die folgendes zum Ziel haben:

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 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. Siehe 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-ID der zu verwendenden benutzerseitig zugewiesenen Identitäten 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 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 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 in Azure		 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 in Azure		 Bereitstellen von Azure Sql Database verwaltete Instanz (SQL MI) in neuen Virtual Network.
Erstellen von SQL MI mit konfiguriertem Senden von Protokollen und Metriken

Bereitstellen in Azure		 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 in Azure		 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

Bereitstellen in Azure		 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:

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": "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 Ressourcentyp "Microsoft.Sql/managedInstances"
apiVersion Die Ressourcen-API-Version '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. Siehe 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-ID der zu verwendenden benutzerseitig zugewiesenen Identitäten 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 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.

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

In den folgenden Schnellstartvorlagen wird dieser Ressourcentyp bereitgestellt.

Vorlage BESCHREIBUNG
Bereitstellen von SQL Managed Instance mit Netzwerk

Bereitstellen in Azure		 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 in Azure		 Bereitstellen von Azure Sql-Datenbank-verwaltete Instanz (SQL MI) in neuen Virtual Network.
Erstellen von SQL MI mit konfiguriertem Senden von Protokollen und Metriken

Bereitstellen in Azure		 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 in Azure		 Stellen Sie Azure Sql Database verwaltete Instanz (SQL MI) und JumpBox mit SSMS in neuen Virtual Network bereit.
Erstellen von SQL MI mit konfigurierter Point-to-Site-Verbindung

Bereitstellen in Azure		 Stellen Sie Azure Sql-Datenbank-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-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 im Ä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 Der 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