Microsoft.Sql managedInstances 2022-11-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 folgendes zum Ziel haben:
- 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 Bicep hinzu.
resource symbolicname 'Microsoft.Sql/managedInstances@2022-11-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'
}
collation: 'string'
dnsZonePartner: 'string'
instancePoolId: 'string'
keyId: 'string'
licenseType: 'string'
maintenanceConfigurationId: 'string'
managedInstanceCreateMode: 'string'
minimalTlsVersion: 'string'
primaryUserAssignedIdentityId: 'string'
proxyOverride: 'string'
publicDataEndpointEnabled: bool
requestedBackupStorageRedundancy: 'string'
restorePointInTime: 'string'
servicePrincipal: {
type: 'string'
}
sourceManagedInstanceId: 'string'
storageSizeInGB: 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 |
collation | Sortierung der verwalteten instance. | Zeichenfolge |
dnsZonePartner | Die Ressourcen-ID eines anderen verwalteten instance dessen DNS-Zone von diesem verwalteten instance nach der Erstellung freigegeben wird. | Zeichenfolge |
instancePoolId | Die ID des instance Pools, zu dem dieser verwaltete Server gehört. | Zeichenfolge |
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 |
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 |
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 |
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" "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 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-Datenbank-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 |
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 |
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. |
Ressourcendefinition mit einer ARM-Vorlage
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 der Vorlage den folgenden JSON-Code hinzu.
{
"type": "Microsoft.Sql/managedInstances",
"apiVersion": "2022-11-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"
},
"collation": "string",
"dnsZonePartner": "string",
"instancePoolId": "string",
"keyId": "string",
"licenseType": "string",
"maintenanceConfigurationId": "string",
"managedInstanceCreateMode": "string",
"minimalTlsVersion": "string",
"primaryUserAssignedIdentityId": "string",
"proxyOverride": "string",
"publicDataEndpointEnabled": "bool",
"requestedBackupStorageRedundancy": "string",
"restorePointInTime": "string",
"servicePrincipal": {
"type": "string"
},
"sourceManagedInstanceId": "string",
"storageSizeInGB": "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 | "2022-11-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-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 |
collation | Sortierung der verwalteten instance. | Zeichenfolge |
dnsZonePartner | Die Ressourcen-ID eines anderen verwalteten instance dessen DNS-Zone dieser verwaltete instance nach der Erstellung freigegeben wird. | Zeichenfolge |
instancePoolId | Die ID des instance Pools, zu dem dieser verwaltete Server gehört. | Zeichenfolge |
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 |
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 |
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 |
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" "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 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@2022-11-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"
}
collation = "string"
dnsZonePartner = "string"
instancePoolId = "string"
keyId = "string"
licenseType = "string"
maintenanceConfigurationId = "string"
managedInstanceCreateMode = "string"
minimalTlsVersion = "string"
primaryUserAssignedIdentityId = "string"
proxyOverride = "string"
publicDataEndpointEnabled = bool
requestedBackupStorageRedundancy = "string"
restorePointInTime = "string"
servicePrincipal = {
type = "string"
}
sourceManagedInstanceId = "string"
storageSizeInGB = 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@2022-11-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 |
collation | Sortierung der verwalteten instance. | Zeichenfolge |
dnsZonePartner | Die Ressourcen-ID eines anderen verwalteten instance dessen DNS-Zone dieser verwaltete instance nach der Erstellung freigegeben wird. | Zeichenfolge |
instancePoolId | Die ID des instance Pools, zu dem dieser verwaltete Server gehört. | Zeichenfolge |
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. |
"Standard" "PointInTimeRestore" |
minimalTlsVersion | Minimale TLS-Version. Zulässige Werte: "None", "1.0", "1.1", "1.2" | Zeichenfolge |
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 |
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 |
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 |