Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
- Latest
- 2025-02-01-preview
- 2025-01-01
- 2024-11-01-preview
- 2024-05-01-preview
- 2023-08-01
- 2023-08-01-preview
- 2023-05-01-preview
- 2023-02-01-preview
- 2022-11-01-preview
- 2022-08-01-preview
- 2022-05-01-preview
- 2022-02-01-preview
- 2021-11-01
- 2021-11-01-preview
- 2021-08-01-preview
- 2021-05-01-preview
- 2021-02-01-preview
- 2020-11-01-preview
- 2020-08-01-preview
- 2020-02-02-preview
- 2018-06-01-preview
- 2015-05-01-preview
Bicep-resourcedefinitie
Het resourcetype managedInstances kan worden geïmplementeerd met bewerkingen die zijn gericht op:
- Resourcegroepen - Zie opdrachten voor de implementatie van resourcegroepen
Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.
Resource-indeling
Om een Microsoft te creëren. Sql/managedInstances-resource, voeg de volgende Bicep toe aan je template.
resource symbolicname 'Microsoft.Sql/managedInstances@2024-05-01-preview' = {
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
location: 'string'
name: 'string'
properties: {
administratorLogin: 'string'
administratorLoginPassword: 'string'
administrators: {
administratorType: 'string'
azureADOnlyAuthentication: bool
login: 'string'
principalType: 'string'
sid: 'string'
tenantId: 'string'
}
authenticationMetadata: 'string'
collation: 'string'
databaseFormat: 'string'
dnsZonePartner: 'string'
hybridSecondaryUsage: 'string'
instancePoolId: 'string'
isGeneralPurposeV2: bool
keyId: 'string'
licenseType: 'string'
maintenanceConfigurationId: 'string'
managedInstanceCreateMode: 'string'
minimalTlsVersion: 'string'
pricingModel: 'string'
primaryUserAssignedIdentityId: 'string'
proxyOverride: 'string'
publicDataEndpointEnabled: bool
requestedBackupStorageRedundancy: 'string'
restorePointInTime: 'string'
servicePrincipal: {
type: 'string'
}
sourceManagedInstanceId: 'string'
storageIOps: int
storageSizeInGB: int
storageThroughputMBps: int
subnetId: 'string'
timezoneId: 'string'
totalMemoryMB: int
vCores: int
zoneRedundant: bool
}
sku: {
capacity: int
family: 'string'
name: 'string'
size: 'string'
tier: 'string'
}
tags: {
{customized property}: 'string'
}
}
Eigenschapswaarden
Microsoft. Sql/managedInstances
| Name | Description | Value |
|---|---|---|
| identity | De Azure Active Directory-identiteit van de beheerde instantie. | ResourceIdentity |
| location | Resourcelocatie. | tekenreeks (vereist) |
| name | De resourcenaam | tekenreeks (vereist) |
| properties | Resource-eigenschappen. | ManagedInstanceProperties |
| sku | Beheerde exemplaar-SKU. Toegestane waarden voor sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH | Sku |
| tags | Resourcetags | Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen |
ManagedInstanceExternalAdministrator
| Name | Description | Value |
|---|---|---|
| administratorType | Type van de serverbeheerder. | 'ActiveDirectory' |
| azureADOnlyAuthentication | Azure Active Directory alleen authenticatie ingeschakeld. | bool |
| login | Aanmeldingsnaam van de serverbeheerder. | string |
| principalType | Principal-type van de serverbeheerder. | 'Application' 'Group' 'User' |
| sid | SID (object-id) van de serverbeheerder. | string Constraints: Minimale lengte = 36 Maximale lengte = 36 Patroon = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| tenantId | Tenant-id van de beheerder. | string Constraints: Minimale lengte = 36 Maximale lengte = 36 Patroon = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
ManagedInstanceProperties
| Name | Description | Value |
|---|---|---|
| administratorLogin | Gebruikersnaam van beheerder voor het beheerde exemplaar. Kan alleen worden opgegeven wanneer het beheerde exemplaar wordt gemaakt (en vereist is voor het maken). | string |
| administratorLoginPassword | Het aanmeldingswachtwoord van de beheerder (vereist voor het maken van een beheerd exemplaar). | string Constraints: Gevoelige waarde. Doorgeven als een beveiligde parameter. |
| administrators | De Azure Active Directory-beheerder van de instantie. Dit kan alleen worden gebruikt tijdens het maken van exemplaren. Als deze wordt gebruikt voor bijvoorbeeld bijwerken, wordt deze genegeerd of resulteert dit in een fout. Voor updates moeten afzonderlijke API's worden gebruikt. | ManagedInstanceExternalAdministrator |
| authenticationMetadata | De zoekmodus voor verificatiemetagegevens van het beheerde exemplaar. | 'AzureAD' 'Paired' 'Windows' |
| collation | Sortering van het beheerde exemplaar. | string |
| databaseFormat | Hiermee geeft u de interne indeling van exemplaardatabases op die specifiek zijn voor de versie van de SQL-engine. | 'AlwaysUpToDate' 'SQLServer2022' |
| dnsZonePartner | De resource-id van een ander beheerd exemplaar waarvan de DNS-zone dit beheerde exemplaar deelt na het maken. | string |
| hybridSecondaryUsage | Hybride secundair gebruik. Mogelijke waarden zijn 'Actief' (standaardwaarde) en 'Passief' (klant gebruikt de secundaire als passieve dr). | 'Active' 'Passive' |
| instancePoolId | De id van de exemplaargroep waartoe deze beheerde server behoort. | string |
| isGeneralPurposeV2 | Of dit nu een GPv2-variant van de editie Algemeen gebruik is. | bool |
| keyId | Een CMK-URI van de sleutel die moet worden gebruikt voor versleuteling. | string |
| licenseType | Het licentietype. Mogelijke waarden zijn LicenseIncluded (reguliere prijs inclusief een nieuwe SQL-licentie) en BasePrice (korting op AHB-prijs voor het meenemen van uw eigen SQL-licenties). | 'BasePrice' 'LicenseIncluded' |
| maintenanceConfigurationId | Hiermee geeft u de onderhoudsconfiguratie-id op die moet worden toegepast op dit beheerde exemplaar. | string |
| managedInstanceCreateMode | Hiermee geeft u de modus voor het maken van de database op. Standaard: het maken van een normaal exemplaar. Herstellen: Hiermee maakt u een exemplaar door een set back-ups te herstellen naar een bepaald tijdstip. RestorePointInTime en SourceManagedInstanceId moeten worden opgegeven. |
'Default' 'PointInTimeRestore' |
| minimalTlsVersion | Minimale TLS-versie. Toegestane waarden: 'None', '1.0', '1.1', '1.2' | string |
| pricingModel | Prijsmodel van Managed Instance. | 'Freemium' 'Regular' |
| primaryUserAssignedIdentityId | De resource-id van een door de gebruiker toegewezen identiteit die standaard moet worden gebruikt. | string |
| proxyOverride | Verbindingstype dat wordt gebruikt om verbinding te maken met het exemplaar. | 'Default' 'Proxy' 'Redirect' |
| publicDataEndpointEnabled | Of het openbare gegevenseindpunt al dan niet is ingeschakeld. | bool |
| requestedBackupStorageRedundancy | Het type opslagaccount dat moet worden gebruikt voor het opslaan van back-ups voor dit exemplaar. De opties zijn Lokaal (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) en GeoZone(GeoZoneRedundantStorage) | 'Geo' 'GeoZone' 'Local' 'Zone' |
| restorePointInTime | Hiermee geeft u het tijdstip (ISO8601-indeling) van de brondatabase op die wordt hersteld om de nieuwe database te maken. | string |
| servicePrincipal | De service-principal van het beheerde exemplaar. | ServicePrincipal |
| sourceManagedInstanceId | De resource-id van het bronbeheerexemplaar dat is gekoppeld aan het maken van de bewerking van dit exemplaar. | string |
| storageIOps | Opslag IOps. Minimumwaarde: 300. Maximumwaarde: 80000. Verhogingen van 1 IOps zijn alleen toegestaan. De maximumwaarde is afhankelijk van de geselecteerde hardwarefamilie en het aantal vCores. | int |
| storageSizeInGB | Opslaggrootte in GB. Minimumwaarde: 32. Maximumwaarde: 16384. Verhogingen van 32 GB zijn alleen toegestaan. De maximumwaarde is afhankelijk van de geselecteerde hardwarefamilie en het aantal vCores. | int |
| storageThroughputMBps | De MBps-parameter voor opslagdoorvoer wordt niet ondersteund in de bewerking voor het maken/bijwerken van exemplaren. | int |
| subnetId | Subnetresource-id voor het beheerde exemplaar. | string |
| timezoneId | Id van de tijdzone. Toegestane waarden zijn tijdzones die door Windows worden ondersteund. Windows houdt details over ondersteunde tijdzones, inclusief het id, bij in het register onder KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Je kunt die registerwaarden via SQL Server krijgen door SELECT naam AS timezone_id FROM sys.time_zone_info te zoeken. Lijst met id's kan ook worden verkregen door [System.TimeZoneInfo]::GetSystemTimeZones() uit te voeren in PowerShell. Een voorbeeld van een geldige tijdzone-id is Pacific Standard Time of W. Europa Standaardtijd". |
string |
| totalMemoryMB | Totaal geheugen in MB. Minimumwaarde: 7168. Maximumwaarde: 891328. Verhogingen van 1 MB zijn alleen toegestaan. De maximumwaarde is afhankelijk van de geselecteerde hardwarefamilie en het aantal vCores. | int |
| vCores | Het aantal vCores. Toegestane waarden: 8, 16, 24, 32, 40, 64, 80. | int |
| zoneRedundant | Of de multi-az wel of niet is ingeschakeld. | bool |
ResourceIdentity
| Name | Description | Value |
|---|---|---|
| type | Het identiteitstype. Stel dit in op 'SystemAssigned' om automatisch een Azure Active Directory-principal voor de resource aan te maken en toe te wijzen. | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' |
| userAssignedIdentities | De resource-id's van de door de gebruiker toegewezen identiteiten die moeten worden gebruikt | ResourceIdentityUserAssignedIdentities |
ResourceIdentityUserAssignedIdentities
| Name | Description | Value |
|---|
ServicePrincipal
| Name | Description | Value |
|---|---|---|
| type | Type service-principal. | 'None' 'SystemAssigned' |
Sku
| Name | Description | Value |
|---|---|---|
| capacity | Capaciteit van de specifieke SKU. | int |
| family | Als de service verschillende generaties hardware heeft, voor dezelfde SKU, kan die hier worden vastgelegd. | string |
| name | De naam van de SKU, meestal een letter + cijfercode, bijvoorbeeld P3. | tekenreeks (vereist) |
| size | Grootte van de specifieke SKU | string |
| tier | De laag of editie van de specifieke SKU, bijvoorbeeld Basic, Premium. | string |
TrackedResourceTags
| Name | Description | Value |
|---|
UserIdentity
| Name | Description | Value |
|---|
Gebruiksvoorbeelden
Azure Verified Modules
De volgende Azure Geverifieerde modules kunnen worden gebruikt om dit resourcetype uit te voeren.
| Module | Description |
|---|---|
| SQL Managed Instance | AVM Resource Module voor SQL Managed Instance |
Azure Quickstart Samples
De volgende Azure Quickstart-sjablonen bevatten Bicep voorbeelden voor het uitrollen van dit resourcetype.
| Bicep File | Description |
|---|---|
| Create SQL MI binnen het nieuwe virtuele netwerk | Deploy Azure SQL Database Managed Instance (SQL MI) binnen het nieuwe Virtual Network. |
Resourcedefinitie van ARM-sjabloon
Het resourcetype managedInstances kan worden geïmplementeerd met bewerkingen die zijn gericht op:
- Resourcegroepen - Zie opdrachten voor de implementatie van resourcegroepen
Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.
Resource-indeling
Om een Microsoft te creëren. Sql/managedInstances-resource, voeg de volgende JSON toe aan je template.
{
"type": "Microsoft.Sql/managedInstances",
"apiVersion": "2024-05-01-preview",
"name": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
}
}
},
"location": "string",
"properties": {
"administratorLogin": "string",
"administratorLoginPassword": "string",
"administrators": {
"administratorType": "string",
"azureADOnlyAuthentication": "bool",
"login": "string",
"principalType": "string",
"sid": "string",
"tenantId": "string"
},
"authenticationMetadata": "string",
"collation": "string",
"databaseFormat": "string",
"dnsZonePartner": "string",
"hybridSecondaryUsage": "string",
"instancePoolId": "string",
"isGeneralPurposeV2": "bool",
"keyId": "string",
"licenseType": "string",
"maintenanceConfigurationId": "string",
"managedInstanceCreateMode": "string",
"minimalTlsVersion": "string",
"pricingModel": "string",
"primaryUserAssignedIdentityId": "string",
"proxyOverride": "string",
"publicDataEndpointEnabled": "bool",
"requestedBackupStorageRedundancy": "string",
"restorePointInTime": "string",
"servicePrincipal": {
"type": "string"
},
"sourceManagedInstanceId": "string",
"storageIOps": "int",
"storageSizeInGB": "int",
"storageThroughputMBps": "int",
"subnetId": "string",
"timezoneId": "string",
"totalMemoryMB": "int",
"vCores": "int",
"zoneRedundant": "bool"
},
"sku": {
"capacity": "int",
"family": "string",
"name": "string",
"size": "string",
"tier": "string"
},
"tags": {
"{customized property}": "string"
}
}
Eigenschapswaarden
Microsoft. Sql/managedInstances
| Name | Description | Value |
|---|---|---|
| apiVersion | De API-versie | '2024-05-01-preview' |
| identity | De Azure Active Directory-identiteit van de beheerde instantie. | ResourceIdentity |
| location | Resourcelocatie. | tekenreeks (vereist) |
| name | De resourcenaam | tekenreeks (vereist) |
| properties | Resource-eigenschappen. | ManagedInstanceProperties |
| sku | Beheerde exemplaar-SKU. Toegestane waarden voor sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH | Sku |
| tags | Resourcetags | Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen |
| type | Het brontype | 'Microsoft. Sql/managedInstances' |
ManagedInstanceExternalAdministrator
| Name | Description | Value |
|---|---|---|
| administratorType | Type van de serverbeheerder. | 'ActiveDirectory' |
| azureADOnlyAuthentication | Azure Active Directory alleen authenticatie ingeschakeld. | bool |
| login | Aanmeldingsnaam van de serverbeheerder. | string |
| principalType | Principal-type van de serverbeheerder. | 'Application' 'Group' 'User' |
| sid | SID (object-id) van de serverbeheerder. | string Constraints: Minimale lengte = 36 Maximale lengte = 36 Patroon = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| tenantId | Tenant-id van de beheerder. | string Constraints: Minimale lengte = 36 Maximale lengte = 36 Patroon = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
ManagedInstanceProperties
| Name | Description | Value |
|---|---|---|
| administratorLogin | Gebruikersnaam van beheerder voor het beheerde exemplaar. Kan alleen worden opgegeven wanneer het beheerde exemplaar wordt gemaakt (en vereist is voor het maken). | string |
| administratorLoginPassword | Het aanmeldingswachtwoord van de beheerder (vereist voor het maken van een beheerd exemplaar). | string Constraints: Gevoelige waarde. Doorgeven als een beveiligde parameter. |
| administrators | De Azure Active Directory-beheerder van de instantie. Dit kan alleen worden gebruikt tijdens het maken van exemplaren. Als deze wordt gebruikt voor bijvoorbeeld bijwerken, wordt deze genegeerd of resulteert dit in een fout. Voor updates moeten afzonderlijke API's worden gebruikt. | ManagedInstanceExternalAdministrator |
| authenticationMetadata | De zoekmodus voor verificatiemetagegevens van het beheerde exemplaar. | 'AzureAD' 'Paired' 'Windows' |
| collation | Sortering van het beheerde exemplaar. | string |
| databaseFormat | Hiermee geeft u de interne indeling van exemplaardatabases op die specifiek zijn voor de versie van de SQL-engine. | 'AlwaysUpToDate' 'SQLServer2022' |
| dnsZonePartner | De resource-id van een ander beheerd exemplaar waarvan de DNS-zone dit beheerde exemplaar deelt na het maken. | string |
| hybridSecondaryUsage | Hybride secundair gebruik. Mogelijke waarden zijn 'Actief' (standaardwaarde) en 'Passief' (klant gebruikt de secundaire als passieve dr). | 'Active' 'Passive' |
| instancePoolId | De id van de exemplaargroep waartoe deze beheerde server behoort. | string |
| isGeneralPurposeV2 | Of dit nu een GPv2-variant van de editie Algemeen gebruik is. | bool |
| keyId | Een CMK-URI van de sleutel die moet worden gebruikt voor versleuteling. | string |
| licenseType | Het licentietype. Mogelijke waarden zijn LicenseIncluded (reguliere prijs inclusief een nieuwe SQL-licentie) en BasePrice (korting op AHB-prijs voor het meenemen van uw eigen SQL-licenties). | 'BasePrice' 'LicenseIncluded' |
| maintenanceConfigurationId | Hiermee geeft u de onderhoudsconfiguratie-id op die moet worden toegepast op dit beheerde exemplaar. | string |
| managedInstanceCreateMode | Hiermee geeft u de modus voor het maken van de database op. Standaard: het maken van een normaal exemplaar. Herstellen: Hiermee maakt u een exemplaar door een set back-ups te herstellen naar een bepaald tijdstip. RestorePointInTime en SourceManagedInstanceId moeten worden opgegeven. |
'Default' 'PointInTimeRestore' |
| minimalTlsVersion | Minimale TLS-versie. Toegestane waarden: 'None', '1.0', '1.1', '1.2' | string |
| pricingModel | Prijsmodel van Managed Instance. | 'Freemium' 'Regular' |
| primaryUserAssignedIdentityId | De resource-id van een door de gebruiker toegewezen identiteit die standaard moet worden gebruikt. | string |
| proxyOverride | Verbindingstype dat wordt gebruikt om verbinding te maken met het exemplaar. | 'Default' 'Proxy' 'Redirect' |
| publicDataEndpointEnabled | Of het openbare gegevenseindpunt al dan niet is ingeschakeld. | bool |
| requestedBackupStorageRedundancy | Het type opslagaccount dat moet worden gebruikt voor het opslaan van back-ups voor dit exemplaar. De opties zijn Lokaal (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) en GeoZone(GeoZoneRedundantStorage) | 'Geo' 'GeoZone' 'Local' 'Zone' |
| restorePointInTime | Hiermee geeft u het tijdstip (ISO8601-indeling) van de brondatabase op die wordt hersteld om de nieuwe database te maken. | string |
| servicePrincipal | De service-principal van het beheerde exemplaar. | ServicePrincipal |
| sourceManagedInstanceId | De resource-id van het bronbeheerexemplaar dat is gekoppeld aan het maken van de bewerking van dit exemplaar. | string |
| storageIOps | Opslag IOps. Minimumwaarde: 300. Maximumwaarde: 80000. Verhogingen van 1 IOps zijn alleen toegestaan. De maximumwaarde is afhankelijk van de geselecteerde hardwarefamilie en het aantal vCores. | int |
| storageSizeInGB | Opslaggrootte in GB. Minimumwaarde: 32. Maximumwaarde: 16384. Verhogingen van 32 GB zijn alleen toegestaan. De maximumwaarde is afhankelijk van de geselecteerde hardwarefamilie en het aantal vCores. | int |
| storageThroughputMBps | De MBps-parameter voor opslagdoorvoer wordt niet ondersteund in de bewerking voor het maken/bijwerken van exemplaren. | int |
| subnetId | Subnetresource-id voor het beheerde exemplaar. | string |
| timezoneId | Id van de tijdzone. Toegestane waarden zijn tijdzones die door Windows worden ondersteund. Windows houdt details over ondersteunde tijdzones, inclusief het id, bij in het register onder KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Je kunt die registerwaarden via SQL Server krijgen door SELECT naam AS timezone_id FROM sys.time_zone_info te zoeken. Lijst met id's kan ook worden verkregen door [System.TimeZoneInfo]::GetSystemTimeZones() uit te voeren in PowerShell. Een voorbeeld van een geldige tijdzone-id is Pacific Standard Time of W. Europa Standaardtijd". |
string |
| totalMemoryMB | Totaal geheugen in MB. Minimumwaarde: 7168. Maximumwaarde: 891328. Verhogingen van 1 MB zijn alleen toegestaan. De maximumwaarde is afhankelijk van de geselecteerde hardwarefamilie en het aantal vCores. | int |
| vCores | Het aantal vCores. Toegestane waarden: 8, 16, 24, 32, 40, 64, 80. | int |
| zoneRedundant | Of de multi-az wel of niet is ingeschakeld. | bool |
ResourceIdentity
| Name | Description | Value |
|---|---|---|
| type | Het identiteitstype. Stel dit in op 'SystemAssigned' om automatisch een Azure Active Directory-principal voor de resource aan te maken en toe te wijzen. | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' |
| userAssignedIdentities | De resource-id's van de door de gebruiker toegewezen identiteiten die moeten worden gebruikt | ResourceIdentityUserAssignedIdentities |
ResourceIdentityUserAssignedIdentities
| Name | Description | Value |
|---|
ServicePrincipal
| Name | Description | Value |
|---|---|---|
| type | Type service-principal. | 'None' 'SystemAssigned' |
Sku
| Name | Description | Value |
|---|---|---|
| capacity | Capaciteit van de specifieke SKU. | int |
| family | Als de service verschillende generaties hardware heeft, voor dezelfde SKU, kan die hier worden vastgelegd. | string |
| name | De naam van de SKU, meestal een letter + cijfercode, bijvoorbeeld P3. | tekenreeks (vereist) |
| size | Grootte van de specifieke SKU | string |
| tier | De laag of editie van de specifieke SKU, bijvoorbeeld Basic, Premium. | string |
TrackedResourceTags
| Name | Description | Value |
|---|
UserIdentity
| Name | Description | Value |
|---|
Gebruiksvoorbeelden
Azure Quickstart Templates
De volgende Azure Quickstart-sjablonen deployen dit resourcetype.
| Template | Description |
|---|---|
|
Create SQL MI binnen het nieuwe virtuele netwerk |
Deploy Azure SQL Database Managed Instance (SQL MI) binnen het nieuwe Virtual Network. |
|
Create SQL MI met geconfigureerde verzending van logs en metrics |
Met deze sjabloon kunt u SQL MI en aanvullende resources implementeren die worden gebruikt voor het opslaan van logboeken en metrische gegevens (diagnostische werkruimte, opslagaccount, Event Hub). |
|
Create SQL MI met jumpbox binnen het nieuwe virtuele netwerk |
Deploy Azure SQL Database Managed Instance (SQL MI) en JumpBox met SSMS binnen het nieuwe Virtual Network. |
|
Create SQL MI met point-to-site verbinding geconfigureerd |
Deploy Azure SQL Database Managed Instance (SQL MI) en Virtual Network Gateway die zijn geconfigureerd voor point-to-site verbinding binnen het nieuwe virtuele netwerk. |
|
Deploy SQL Managed Instance met Netwerk |
Deploy UDR en NSG ter ondersteuning van Azure SQL Managed Instance en deploy de Managed Instance |
Resourcedefinitie van Terraform (AzAPI-provider)
Het resourcetype managedInstances kan worden geïmplementeerd met bewerkingen die zijn gericht op:
- Resourcegroepen
Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.
Resource-indeling
Om een Microsoft te creëren. Sql/managedInstances-resource, voeg de volgende Terraform toe aan je template.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Sql/managedInstances@2024-05-01-preview"
name = "string"
parent_id = "string"
identity {
type = "string"
identity_ids = [
"string"
]
}
location = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
administratorLogin = "string"
administratorLoginPassword = "string"
administrators = {
administratorType = "string"
azureADOnlyAuthentication = bool
login = "string"
principalType = "string"
sid = "string"
tenantId = "string"
}
authenticationMetadata = "string"
collation = "string"
databaseFormat = "string"
dnsZonePartner = "string"
hybridSecondaryUsage = "string"
instancePoolId = "string"
isGeneralPurposeV2 = bool
keyId = "string"
licenseType = "string"
maintenanceConfigurationId = "string"
managedInstanceCreateMode = "string"
minimalTlsVersion = "string"
pricingModel = "string"
primaryUserAssignedIdentityId = "string"
proxyOverride = "string"
publicDataEndpointEnabled = bool
requestedBackupStorageRedundancy = "string"
restorePointInTime = "string"
servicePrincipal = {
type = "string"
}
sourceManagedInstanceId = "string"
storageIOps = int
storageSizeInGB = int
storageThroughputMBps = int
subnetId = "string"
timezoneId = "string"
totalMemoryMB = int
vCores = int
zoneRedundant = bool
}
sku = {
capacity = int
family = "string"
name = "string"
size = "string"
tier = "string"
}
}
}
Eigenschapswaarden
Microsoft. Sql/managedInstances
| Name | Description | Value |
|---|---|---|
| identity | De Azure Active Directory-identiteit van de beheerde instantie. | ResourceIdentity |
| location | Resourcelocatie. | tekenreeks (vereist) |
| name | De resourcenaam | tekenreeks (vereist) |
| properties | Resource-eigenschappen. | ManagedInstanceProperties |
| sku | Beheerde exemplaar-SKU. Toegestane waarden voor sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH | Sku |
| tags | Resourcetags | Woordenlijst met tagnamen en -waarden. |
| type | Het brontype | "Microsoft. Sql/managedInstances@2024-05-01-preview" |
ManagedInstanceExternalAdministrator
| Name | Description | Value |
|---|---|---|
| administratorType | Type van de serverbeheerder. | 'ActiveDirectory' |
| azureADOnlyAuthentication | Azure Active Directory alleen authenticatie ingeschakeld. | bool |
| login | Aanmeldingsnaam van de serverbeheerder. | string |
| principalType | Principal-type van de serverbeheerder. | 'Application' 'Group' 'User' |
| sid | SID (object-id) van de serverbeheerder. | string Constraints: Minimale lengte = 36 Maximale lengte = 36 Patroon = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| tenantId | Tenant-id van de beheerder. | string Constraints: Minimale lengte = 36 Maximale lengte = 36 Patroon = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
ManagedInstanceProperties
| Name | Description | Value |
|---|---|---|
| administratorLogin | Gebruikersnaam van beheerder voor het beheerde exemplaar. Kan alleen worden opgegeven wanneer het beheerde exemplaar wordt gemaakt (en vereist is voor het maken). | string |
| administratorLoginPassword | Het aanmeldingswachtwoord van de beheerder (vereist voor het maken van een beheerd exemplaar). | string Constraints: Gevoelige waarde. Doorgeven als een beveiligde parameter. |
| administrators | De Azure Active Directory-beheerder van de instantie. Dit kan alleen worden gebruikt tijdens het maken van exemplaren. Als deze wordt gebruikt voor bijvoorbeeld bijwerken, wordt deze genegeerd of resulteert dit in een fout. Voor updates moeten afzonderlijke API's worden gebruikt. | ManagedInstanceExternalAdministrator |
| authenticationMetadata | De zoekmodus voor verificatiemetagegevens van het beheerde exemplaar. | 'AzureAD' 'Paired' 'Windows' |
| collation | Sortering van het beheerde exemplaar. | string |
| databaseFormat | Hiermee geeft u de interne indeling van exemplaardatabases op die specifiek zijn voor de versie van de SQL-engine. | 'AlwaysUpToDate' 'SQLServer2022' |
| dnsZonePartner | De resource-id van een ander beheerd exemplaar waarvan de DNS-zone dit beheerde exemplaar deelt na het maken. | string |
| hybridSecondaryUsage | Hybride secundair gebruik. Mogelijke waarden zijn 'Actief' (standaardwaarde) en 'Passief' (klant gebruikt de secundaire als passieve dr). | 'Active' 'Passive' |
| instancePoolId | De id van de exemplaargroep waartoe deze beheerde server behoort. | string |
| isGeneralPurposeV2 | Of dit nu een GPv2-variant van de editie Algemeen gebruik is. | bool |
| keyId | Een CMK-URI van de sleutel die moet worden gebruikt voor versleuteling. | string |
| licenseType | Het licentietype. Mogelijke waarden zijn LicenseIncluded (reguliere prijs inclusief een nieuwe SQL-licentie) en BasePrice (korting op AHB-prijs voor het meenemen van uw eigen SQL-licenties). | 'BasePrice' 'LicenseIncluded' |
| maintenanceConfigurationId | Hiermee geeft u de onderhoudsconfiguratie-id op die moet worden toegepast op dit beheerde exemplaar. | string |
| managedInstanceCreateMode | Hiermee geeft u de modus voor het maken van de database op. Standaard: het maken van een normaal exemplaar. Herstellen: Hiermee maakt u een exemplaar door een set back-ups te herstellen naar een bepaald tijdstip. RestorePointInTime en SourceManagedInstanceId moeten worden opgegeven. |
'Default' 'PointInTimeRestore' |
| minimalTlsVersion | Minimale TLS-versie. Toegestane waarden: 'None', '1.0', '1.1', '1.2' | string |
| pricingModel | Prijsmodel van Managed Instance. | 'Freemium' 'Regular' |
| primaryUserAssignedIdentityId | De resource-id van een door de gebruiker toegewezen identiteit die standaard moet worden gebruikt. | string |
| proxyOverride | Verbindingstype dat wordt gebruikt om verbinding te maken met het exemplaar. | 'Default' 'Proxy' 'Redirect' |
| publicDataEndpointEnabled | Of het openbare gegevenseindpunt al dan niet is ingeschakeld. | bool |
| requestedBackupStorageRedundancy | Het type opslagaccount dat moet worden gebruikt voor het opslaan van back-ups voor dit exemplaar. De opties zijn Lokaal (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) en GeoZone(GeoZoneRedundantStorage) | 'Geo' 'GeoZone' 'Local' 'Zone' |
| restorePointInTime | Hiermee geeft u het tijdstip (ISO8601-indeling) van de brondatabase op die wordt hersteld om de nieuwe database te maken. | string |
| servicePrincipal | De service-principal van het beheerde exemplaar. | ServicePrincipal |
| sourceManagedInstanceId | De resource-id van het bronbeheerexemplaar dat is gekoppeld aan het maken van de bewerking van dit exemplaar. | string |
| storageIOps | Opslag IOps. Minimumwaarde: 300. Maximumwaarde: 80000. Verhogingen van 1 IOps zijn alleen toegestaan. De maximumwaarde is afhankelijk van de geselecteerde hardwarefamilie en het aantal vCores. | int |
| storageSizeInGB | Opslaggrootte in GB. Minimumwaarde: 32. Maximumwaarde: 16384. Verhogingen van 32 GB zijn alleen toegestaan. De maximumwaarde is afhankelijk van de geselecteerde hardwarefamilie en het aantal vCores. | int |
| storageThroughputMBps | De MBps-parameter voor opslagdoorvoer wordt niet ondersteund in de bewerking voor het maken/bijwerken van exemplaren. | int |
| subnetId | Subnetresource-id voor het beheerde exemplaar. | string |
| timezoneId | Id van de tijdzone. Toegestane waarden zijn tijdzones die door Windows worden ondersteund. Windows houdt details over ondersteunde tijdzones, inclusief het id, bij in het register onder KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Je kunt die registerwaarden via SQL Server krijgen door SELECT naam AS timezone_id FROM sys.time_zone_info te zoeken. Lijst met id's kan ook worden verkregen door [System.TimeZoneInfo]::GetSystemTimeZones() uit te voeren in PowerShell. Een voorbeeld van een geldige tijdzone-id is Pacific Standard Time of W. Europa Standaardtijd". |
string |
| totalMemoryMB | Totaal geheugen in MB. Minimumwaarde: 7168. Maximumwaarde: 891328. Verhogingen van 1 MB zijn alleen toegestaan. De maximumwaarde is afhankelijk van de geselecteerde hardwarefamilie en het aantal vCores. | int |
| vCores | Het aantal vCores. Toegestane waarden: 8, 16, 24, 32, 40, 64, 80. | int |
| zoneRedundant | Of de multi-az wel of niet is ingeschakeld. | bool |
ResourceIdentity
| Name | Description | Value |
|---|---|---|
| type | Het identiteitstype. Stel dit in op 'SystemAssigned' om automatisch een Azure Active Directory-principal voor de resource aan te maken en toe te wijzen. | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' |
| userAssignedIdentities | De resource-id's van de door de gebruiker toegewezen identiteiten die moeten worden gebruikt | ResourceIdentityUserAssignedIdentities |
ResourceIdentityUserAssignedIdentities
| Name | Description | Value |
|---|
ServicePrincipal
| Name | Description | Value |
|---|---|---|
| type | Type service-principal. | 'None' 'SystemAssigned' |
Sku
| Name | Description | Value |
|---|---|---|
| capacity | Capaciteit van de specifieke SKU. | int |
| family | Als de service verschillende generaties hardware heeft, voor dezelfde SKU, kan die hier worden vastgelegd. | string |
| name | De naam van de SKU, meestal een letter + cijfercode, bijvoorbeeld P3. | tekenreeks (vereist) |
| size | Grootte van de specifieke SKU | string |
| tier | De laag of editie van de specifieke SKU, bijvoorbeeld Basic, Premium. | string |
TrackedResourceTags
| Name | Description | Value |
|---|
UserIdentity
| Name | Description | Value |
|---|
Gebruiksvoorbeelden
Azure Verified Modules
De volgende Azure Geverifieerde modules kunnen worden gebruikt om dit resourcetype uit te voeren.
| Module | Description |
|---|---|
| SQL Managed Instance | AVM Resource Module voor SQL Managed Instance |