Microsoft.Sql managedInstances 2023-05-01-preview
- Laatste
- 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-01-preview
- 2021-08-01-preview
- 2021-05-01-preview
- 2021-02-01-preview
- 2020-11-01-01-preview
- 2020-08-01-preview
- 2020-02-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 resourcegroepimplementatie
Zie wijzigingenlogboek voor een lijst met gewijzigde eigenschappen in elke API-versie.
Resource-indeling
Als u een Microsoft.Sql/managedInstances-resource wilt maken, voegt u de volgende Bicep toe aan uw sjabloon.
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
}
}
Eigenschapswaarden
managedInstances
Naam | Description | Waarde |
---|---|---|
naam | De resourcenaam | tekenreeks (vereist) Tekenlimiet: 1-63 Geldige tekens: Kleine letters, cijfers en afbreekstreepjes. Kan niet beginnen of eindigen met afbreekstreepje. De resourcenaam moet uniek zijn in Azure. |
location | Resourcelocatie. | tekenreeks (vereist) |
tags | Resourcetags. | Woordenlijst met tagnamen en -waarden. Tags in sjablonen bekijken |
sku | Beheerde exemplaar-SKU. Toegestane waarden voor sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH | SKU |
identity | De Azure Active Directory-identiteit van het beheerde exemplaar. | ResourceIdentity |
properties | Resource-eigenschappen. | ManagedInstanceProperties |
ResourceIdentity
Naam | Description | Waarde |
---|---|---|
type | Het identiteitstype. Stel dit in op 'SystemAssigned' om automatisch een Azure Active Directory-principal voor de resource te maken en toe te wijzen. | 'Geen' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' |
userAssignedIdentities | De resource-id's van de door de gebruiker toegewezen identiteiten die moeten worden gebruikt | ResourceIdentityUserAssignedId-entiteiten |
ResourceIdentityUserAssignedId-entiteiten
Naam | Description | Waarde |
---|---|---|
{aangepaste eigenschap} | UserIdentity |
UserIdentity
Dit object bevat geen eigenschappen die tijdens de implementatie moeten worden ingesteld. Alle eigenschappen zijn Alleen-lezen.
ManagedInstanceProperties
Naam | Description | Waarde |
---|---|---|
administratorLogin | Gebruikersnaam van beheerder voor het beheerde exemplaar. Kan alleen worden opgegeven wanneer het beheerde exemplaar wordt gemaakt (en is vereist voor het maken). | tekenreeks |
administratorLoginPassword | Het aanmeldingswachtwoord voor de beheerder (vereist voor het maken van een beheerd exemplaar). | tekenreeks Beperkingen: Gevoelige waarde. Doorgeven als een beveiligde parameter. |
Beheerders | De Azure Active Directory-beheerder van het exemplaar. Dit kan alleen worden gebruikt tijdens het maken van het exemplaar. Als deze wordt gebruikt voor het bijwerken van een exemplaar, wordt deze genegeerd of resulteert dit in een fout. Voor updates moeten afzonderlijke API's worden gebruikt. | ManagedInstanceExternalAdministrator |
authenticationMetadata | De verificatiemodus voor het opzoeken van metagegevens van het beheerde exemplaar. | 'AzureAD' 'Gekoppeld' 'Windows' |
Sortering | Sortering van het beheerde exemplaar. | tekenreeks |
databaseFormat | Hiermee geeft u de interne indeling op van exemplaardatabases 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. | tekenreeks |
hybridSecondaryUsage | Hybride secundair gebruik. Mogelijke waarden zijn 'Actief' (standaardwaarde) en 'Passief' (klant gebruikt de secundaire waarde als Passieve HERSTEL NA). | 'Actief' 'Passief' |
instancePoolId | De id van de exemplaargroep waartoe deze beheerde server behoort. | tekenreeks |
isGeneralPurposeV2 | Of dit een GPv2-variant van Algemeen editie is. | booleaans |
keyId | Een CMK-URI van de sleutel die moet worden gebruikt voor versleuteling. | tekenreeks |
licenseType | Het licentietype. Mogelijke waarden zijn 'LicenseIncluded' (normale prijs inclusief een nieuwe SQL-licentie) en 'BasePrice' (korting op AHB-prijs voor het meenemen van uw eigen SQL-licenties). | 'Basisprijs' 'LicenseIncluded' |
maintenanceConfigurationId | Hiermee geeft u de onderhoudsconfiguratie-id op die moet worden toegepast op dit beheerde exemplaar. | tekenreeks |
managedInstanceCreateMode | Hiermee geeft u de modus voor het maken van de database op. Standaardinstelling: 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. |
'Standaard' 'PointInTimeRestore' |
minimalTlsVersion | Minimale TLS-versie. Toegestane waarden: 'None', '1.0', '1.1', '1.2' | tekenreeks |
pricingModel | Het wel of niet het beheerde exemplaar is freemium. | 'Freemium' 'Normaal' |
primaryUserAssignedIdentityId | De resource-id van een door de gebruiker toegewezen identiteit die standaard moet worden gebruikt. | tekenreeks |
proxyOverride | Verbindingstype dat wordt gebruikt om verbinding te maken met het exemplaar. | 'Standaard' 'Proxy' 'Omleiden' |
publicDataEndpointEnabled | Of het eindpunt voor openbare gegevens is ingeschakeld. | booleaans |
requestedBackupStorageRedundancy | Het opslagaccounttype dat moet worden gebruikt voor het opslaan van back-ups voor dit exemplaar. De opties zijn Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) en GeoZone(GeoZoneRedundantStorage) | 'Geo' 'GeoZone' 'Lokaal' 'Zone' |
restorePointInTime | Hiermee geeft u het tijdstip (ISO8601 indeling) op van de brondatabase die wordt hersteld om de nieuwe database te maken. | tekenreeks |
servicePrincipal | De service-principal van het beheerde exemplaar. | ServicePrincipal |
sourceManagedInstanceId | De resource-id van het beheerde bronexemplaar dat is gekoppeld aan de maakbewerking van dit exemplaar. | tekenreeks |
storageIOps | Opslag-IOps. Minimale waarde: 120. Maximale waarde: 120000. Stappen van 1 IOps zijn alleen toegestaan. De maximale waarde is afhankelijk van de geselecteerde hardwarefamilie en het aantal vCores. | int |
storageSizeInGB | Opslaggrootte in GB. Minimale waarde: 32. Maximale waarde: 16384. Stappen van 32 GB zijn alleen toegestaan. De maximale waarde is afhankelijk van de geselecteerde hardwarefamilie en het aantal vCores. | int |
storageThroughputMBps | Opslagdoorvoer in MBps. Minimale waarde: 25. Maximale waarde: 4000. Stappen van 1 MBps zijn alleen toegestaan. De maximale waarde is afhankelijk van de geselecteerde hardwarefamilie en het aantal vCores. | int |
subnetId | Subnetresource-id voor het beheerde exemplaar. | tekenreeks |
timezoneId | Id van de tijdzone. Toegestane waarden zijn tijdzones die worden ondersteund door Windows. Windows bewaart details over ondersteunde tijdzones, inclusief de id, in het register onder KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Tijdzones. U kunt deze registerwaarden ophalen via SQL Server door een query uit te voeren op SELECT-naam AS timezone_id FROM sys.time_zone_info. Een 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). |
tekenreeks |
vCores | Het aantal vCores. Toegestane waarden: 8, 16, 24, 32, 40, 64, 80. | int |
zoneRedundant | Of de multi-az is ingeschakeld of niet. | booleaans |
ManagedInstanceExternalAdministrator
Naam | Description | Waarde |
---|---|---|
administratorType | Type van de serverbeheerder. | 'ActiveDirectory' |
azureADOnlyAuthentication | Alleen Azure Active Directory-verificatie ingeschakeld. | booleaans |
aanmelding | Aanmeldingsnaam van de serverbeheerder. | tekenreeks |
principalType | Principal Type van de serverbeheerder. | 'Toepassing' 'Groep' 'Gebruiker' |
sid | SID (object-id) van de serverbeheerder. | tekenreeks Beperkingen: 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. | tekenreeks Beperkingen: Minimale lengte = 36 Maximale lengte = 36 Patroon = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
ServicePrincipal
Naam | Description | Waarde |
---|---|---|
type | Type service-principal. | 'Geen' 'SystemAssigned' |
Sku
Naam | Description | Waarde |
---|---|---|
capacity | Capaciteit van de specifieke SKU. | int |
gezin | Als de service verschillende generaties hardware voor dezelfde SKU heeft, kan die hier worden vastgelegd. | tekenreeks |
naam | De naam van de SKU, meestal een letter + cijfercode, bijvoorbeeld P3. | tekenreeks (vereist) |
grootte | Grootte van de specifieke SKU | tekenreeks |
laag | De laag of editie van de specifieke SKU, bijvoorbeeld Basic, Premium. | tekenreeks |
Snelstartsjablonen
Met de volgende quickstart-sjablonen wordt dit resourcetype geïmplementeerd.
Template | Beschrijving |
---|---|
SQL Managed Instance implementeren met netwerken |
UDR en NSG implementeren ter ondersteuning van Azure SQL Managed Instance en het beheerde exemplaar implementeren |
SQL MI maken in het nieuwe virtuele netwerk |
Implementeer Azure SQL Database Managed Instance (SQL MI) in nieuwe Virtual Network. |
SQL MI maken met geconfigureerde verzending van logboeken en metrische gegevens |
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). |
SQL MI maken met jumpbox in een nieuw virtueel netwerk |
Implementeer Azure Sql Database Managed Instance (SQL MI) en JumpBox met SSMS in nieuwe Virtual Network. |
SQL MI maken met een geconfigureerde punt-naar-site-verbinding |
Implementeer Azure Sql Database Managed Instance (SQL MI) en virtuele netwerkgateway die zijn geconfigureerd voor punt-naar-site-verbinding in het nieuwe virtuele netwerk. |
Resourcedefinitie van ARM-sjabloon
Het resourcetype managedInstances kan worden geïmplementeerd met bewerkingen die zijn gericht op:
- Resourcegroepen - Zie opdrachten voor resourcegroepimplementatie
Zie wijzigingenlogboek voor een lijst met gewijzigde eigenschappen in elke API-versie.
Resource-indeling
Als u een Microsoft.Sql/managedInstances-resource wilt maken, voegt u de volgende JSON toe aan uw sjabloon.
{
"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"
}
}
Eigenschapswaarden
managedInstances
Naam | Description | Waarde |
---|---|---|
type | Het resourcetype | 'Microsoft.Sql/managedInstances' |
apiVersion | De resource-API-versie | '2023-05-01-preview' |
naam | De resourcenaam | tekenreeks (vereist) Tekenlimiet: 1-63 Geldige tekens: Kleine letters, cijfers en afbreekstreepjes. Kan niet beginnen of eindigen met afbreekstreepje. De resourcenaam moet uniek zijn in Azure. |
location | Resourcelocatie. | tekenreeks (vereist) |
tags | Resourcetags. | Woordenlijst met tagnamen en -waarden. Tags in sjablonen bekijken |
sku | Beheerde exemplaar-SKU. Toegestane waarden voor sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH | SKU |
identity | De Azure Active Directory-identiteit van het beheerde exemplaar. | ResourceIdentity |
properties | Resource-eigenschappen. | ManagedInstanceProperties |
ResourceIdentity
Naam | Description | Waarde |
---|---|---|
type | Het identiteitstype. Stel dit in op SystemAssigned om automatisch een Azure Active Directory-principal voor de resource te maken en toe te wijzen. | 'Geen' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' |
userAssignedIdentities | De resource-id's van de door de gebruiker toegewezen identiteiten die moeten worden gebruikt | Entiteiten ResourceIdentityUserAssignedId |
Entiteiten ResourceIdentityUserAssignedId
Naam | Description | Waarde |
---|---|---|
{aangepaste eigenschap} | UserIdentity |
UserIdentity
Dit object bevat geen eigenschappen die tijdens de implementatie moeten worden ingesteld. Alle eigenschappen zijn ReadOnly.
ManagedInstanceProperties
Naam | Description | Waarde |
---|---|---|
administratorAanlogen | Gebruikersnaam van beheerder voor het beheerde exemplaar. Kan alleen worden opgegeven wanneer het beheerde exemplaar wordt gemaakt (en is vereist voor het maken). | tekenreeks |
administratorLoginPassword | Het aanmeldingswachtwoord van de beheerder (vereist voor het maken van een beheerd exemplaar). | tekenreeks Beperkingen: Gevoelige waarde. Doorgeven als een beveiligde parameter. |
Beheerders | De Azure Active Directory-beheerder van het exemplaar. Dit kan alleen worden gebruikt tijdens het maken van het exemplaar. Als u bijvoorbeeld een update gebruikt, wordt deze genegeerd of resulteert dit in een fout. Voor updates moeten afzonderlijke API's worden gebruikt. | ManagedInstanceExternalAdministrator |
authenticationMetadata | De opzoekmodus voor verificatiemetagegevens van het beheerde exemplaar. | 'AzureAD' 'Gekoppeld' 'Windows' |
Sortering | Sortering van het beheerde exemplaar. | tekenreeks |
databaseFormat | Hiermee geeft u de interne indeling van exemplaardatabases 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. | tekenreeks |
hybridSecondaryUsage | Hybride secundair gebruik. Mogelijke waarden zijn 'Actief' (standaardwaarde) en 'Passief' (de klant gebruikt de secundaire waarde als passieve herstel na noodgeval). | 'Actief' 'Passief' |
instancePoolId | De id van de exemplaargroep waartoe deze beheerde server behoort. | tekenreeks |
isGeneralPurposeV2 | Of dit een GPv2-variant van Algemeen editie is. | booleaans |
keyId | Een CMK-URI van de sleutel die moet worden gebruikt voor versleuteling. | tekenreeks |
licenseType | Het licentietype. Mogelijke waarden zijn 'LicenseIncluded' (normale prijs inclusief een nieuwe SQL-licentie) en 'BasePrice' (korting op AHB-prijs voor het meenemen van uw eigen SQL-licenties). | 'Basisprijs' 'LicenseIncluded' |
maintenanceConfigurationId | Hiermee geeft u de onderhoudsconfiguratie-id op die moet worden toegepast op dit beheerde exemplaar. | tekenreeks |
managedInstanceCreateMode | Hiermee geeft u de modus voor het maken van de database op. Standaardinstelling: 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. |
'Standaard' 'PointInTimeRestore' |
minimalTlsVersion | Minimale TLS-versie. Toegestane waarden: 'None', '1.0', '1.1', '1.2' | tekenreeks |
pricingModel | Weer of niet beheerd exemplaar is freemium. | 'Freemium' 'Normaal' |
primaryUserAssignedIdentityId | De resource-id van een door de gebruiker toegewezen identiteit die standaard moet worden gebruikt. | tekenreeks |
proxyOverride | Verbindingstype dat wordt gebruikt om verbinding te maken met het exemplaar. | 'Standaard' Proxy 'Omleiden' |
publicDataEndpointEnabled | Of het eindpunt voor openbare gegevens is ingeschakeld. | booleaans |
requestedBackupStorageRedundancy | Het type opslagaccount dat moet worden gebruikt voor het opslaan van back-ups voor dit exemplaar. De opties zijn Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) en GeoZone(GeoZoneRedundantStorage) | 'Geo' 'GeoZone' 'Lokaal' Zone |
restorePointInTime | Hiermee geeft u het tijdstip (ISO8601 indeling) op van de brondatabase die wordt hersteld om de nieuwe database te maken. | tekenreeks |
servicePrincipal | De service-principal van het beheerde exemplaar. | ServicePrincipal |
sourceManagedInstanceId | De resource-id van het beheerde bronexemplaren die is gekoppeld aan de maakbewerking van dit exemplaar. | tekenreeks |
storageIOps | Opslag-IOps. Minimale waarde: 120. Maximale waarde: 120000. Stappen van 1 IOps zijn alleen toegestaan. De maximale waarde is afhankelijk van de geselecteerde hardwarefamilie en het aantal vCores. | int |
storageSizeInGB | Opslaggrootte in GB. Minimale waarde: 32. Maximale waarde: 16384. Stappen van 32 GB zijn alleen toegestaan. De maximale waarde is afhankelijk van de geselecteerde hardwarefamilie en het aantal vCores. | int |
storageThroughputMBps | Opslagdoorvoer in MBps. Minimale waarde: 25. Maximale waarde: 4000. Stappen van 1 MBps zijn alleen toegestaan. De maximale waarde is afhankelijk van de geselecteerde hardwarefamilie en het aantal vCores. | int |
subnetId | Subnetresource-id voor het beheerde exemplaar. | tekenreeks |
timezoneId | Id van de tijdzone. Toegestane waarden zijn tijdzones die worden ondersteund door Windows. Windows bewaart details over ondersteunde tijdzones, inclusief de id, in het register onder KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Tijdzones. U kunt deze registerwaarden ophalen via SQL Server door een query uit te voeren op SELECT-naam AS timezone_id FROM sys.time_zone_info. Een 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). |
tekenreeks |
vCores | Het aantal vCores. Toegestane waarden: 8, 16, 24, 32, 40, 64, 80. | int |
zoneRedundant | Of de multi-az is ingeschakeld of niet. | booleaans |
ManagedInstanceExternalAdministrator
Naam | Description | Waarde |
---|---|---|
administratorType | Type van de serverbeheerder. | 'ActiveDirectory' |
azureADOnlyAuthentication | Alleen Azure Active Directory-verificatie ingeschakeld. | booleaans |
aanmelding | Aanmeldingsnaam van de serverbeheerder. | tekenreeks |
principalType | Principal Type van de serverbeheerder. | 'Toepassing' 'Groep' 'Gebruiker' |
sid | SID (object-id) van de serverbeheerder. | tekenreeks Beperkingen: 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. | tekenreeks Beperkingen: Minimale lengte = 36 Maximale lengte = 36 Patroon = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
ServicePrincipal
Naam | Description | Waarde |
---|---|---|
type | Type service-principal. | 'Geen' 'SystemAssigned' |
Sku
Naam | Description | Waarde |
---|---|---|
capacity | Capaciteit van de specifieke SKU. | int |
gezin | Als de service verschillende generaties hardware voor dezelfde SKU heeft, kan die hier worden vastgelegd. | tekenreeks |
naam | De naam van de SKU, meestal een letter + cijfercode, bijvoorbeeld P3. | tekenreeks (vereist) |
grootte | Grootte van de specifieke SKU | tekenreeks |
laag | De laag of editie van de specifieke SKU, bijvoorbeeld Basic, Premium. | tekenreeks |
Snelstartsjablonen
Met de volgende quickstart-sjablonen wordt dit resourcetype geïmplementeerd.
Template | Beschrijving |
---|---|
SQL Managed Instance implementeren met netwerken |
UDR en NSG implementeren ter ondersteuning van Azure SQL Managed Instance en het beheerde exemplaar implementeren |
SQL MI maken in het nieuwe virtuele netwerk |
Implementeer Azure SQL Database Managed Instance (SQL MI) in nieuwe Virtual Network. |
SQL MI maken met geconfigureerde verzending van logboeken en metrische gegevens |
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). |
SQL MI maken met jumpbox in een nieuw virtueel netwerk |
Implementeer Azure Sql Database Managed Instance (SQL MI) en JumpBox met SSMS in nieuwe Virtual Network. |
SQL MI maken met een geconfigureerde punt-naar-site-verbinding |
Implementeer Azure Sql Database Managed Instance (SQL MI) en virtuele netwerkgateway die zijn geconfigureerd voor punt-naar-site-verbinding in het nieuwe virtuele netwerk. |
Resourcedefinitie van Terraform (AzAPI-provider)
Het resourcetype managedInstances kan worden geïmplementeerd met bewerkingen die zijn gericht op:
- Resourcegroepen
Zie wijzigingenlogboek voor een lijst met gewijzigde eigenschappen in elke API-versie.
Resource-indeling
Als u een Microsoft.Sql/managedInstances-resource wilt maken, voegt u de volgende Terraform toe aan uw sjabloon.
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"
}
})
}
Eigenschapswaarden
managedInstances
Naam | Description | Waarde |
---|---|---|
type | Het resourcetype | "Microsoft.Sql/managedInstances@2023-05-01-preview" |
naam | De resourcenaam | tekenreeks (vereist) Tekenlimiet: 1-63 Geldige tekens: Kleine letters, cijfers en afbreekstreepjes. Kan niet beginnen of eindigen met afbreekstreepje. De resourcenaam moet uniek zijn in Azure. |
location | Resourcelocatie. | tekenreeks (vereist) |
parent_id | Als u wilt implementeren in een resourcegroep, gebruikt u de id van die resourcegroep. | tekenreeks (vereist) |
tags | Resourcetags. | Woordenlijst met tagnamen en -waarden. |
sku | Beheerde exemplaar-SKU. Toegestane waarden voor sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH | SKU |
identity | De Azure Active Directory-identiteit van het beheerde exemplaar. | ResourceIdentity |
properties | Resource-eigenschappen. | ManagedInstanceProperties |
ResourceIdentity
Naam | Description | Waarde |
---|---|---|
type | Het identiteitstype. Stel dit in op 'SystemAssigned' om automatisch een Azure Active Directory-principal voor de resource te maken en toe te wijzen. | "SystemAssigned" "SystemAssigned,UserAssigned" "UserAssigned" |
identity_ids | De resource-id's van de door de gebruiker toegewezen identiteiten die moeten worden gebruikt | Matrix met gebruikersidentiteits-id's. |
ResourceIdentityUserAssignedId-entiteiten
Naam | Description | Waarde |
---|---|---|
{aangepaste eigenschap} | UserIdentity |
UserIdentity
Dit object bevat geen eigenschappen die tijdens de implementatie moeten worden ingesteld. Alle eigenschappen zijn Alleen-lezen.
ManagedInstanceProperties
Naam | Description | Waarde |
---|---|---|
administratorLogin | Gebruikersnaam van beheerder voor het beheerde exemplaar. Kan alleen worden opgegeven wanneer het beheerde exemplaar wordt gemaakt (en is vereist voor het maken). | tekenreeks |
administratorLoginPassword | Het aanmeldingswachtwoord voor de beheerder (vereist voor het maken van een beheerd exemplaar). | tekenreeks Beperkingen: Gevoelige waarde. Doorgeven als een beveiligde parameter. |
Beheerders | De Azure Active Directory-beheerder van het exemplaar. Dit kan alleen worden gebruikt tijdens het maken van het exemplaar. Als deze wordt gebruikt voor het bijwerken van een exemplaar, wordt deze genegeerd of resulteert dit in een fout. Voor updates moeten afzonderlijke API's worden gebruikt. | ManagedInstanceExternalAdministrator |
authenticationMetadata | De verificatiemodus voor het opzoeken van metagegevens van het beheerde exemplaar. | "AzureAD" "Gekoppeld" "Windows" |
Sortering | Sortering van het beheerde exemplaar. | tekenreeks |
databaseFormat | Hiermee geeft u de interne indeling op van exemplaardatabases 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. | tekenreeks |
hybridSecondaryUsage | Hybride secundair gebruik. Mogelijke waarden zijn 'Actief' (standaardwaarde) en 'Passief' (klant gebruikt de secundaire waarde als Passieve HERSTEL NA). | "Actief" "Passief" |
instancePoolId | De id van de exemplaargroep waartoe deze beheerde server behoort. | tekenreeks |
isGeneralPurposeV2 | Of dit een GPv2-variant van Algemeen editie is. | booleaans |
keyId | Een CMK-URI van de sleutel die moet worden gebruikt voor versleuteling. | tekenreeks |
licenseType | Het licentietype. Mogelijke waarden zijn 'LicenseIncluded' (normale prijs inclusief een nieuwe SQL-licentie) en 'BasePrice' (korting op AHB-prijs voor het meenemen van uw eigen SQL-licenties). | "Basisprijs" "LicenseIncluded" |
maintenanceConfigurationId | Hiermee geeft u de onderhoudsconfiguratie-id op die moet worden toegepast op dit beheerde exemplaar. | tekenreeks |
managedInstanceCreateMode | Hiermee geeft u de modus voor het maken van de database op. Standaardinstelling: 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. |
"Standaard" "PointInTimeRestore" |
minimalTlsVersion | Minimale TLS-versie. Toegestane waarden: 'None', '1.0', '1.1', '1.2' | tekenreeks |
pricingModel | Weer of niet beheerd exemplaar is freemium. | "Freemium" "Normaal" |
primaryUserAssignedIdentityId | De resource-id van een door de gebruiker toegewezen identiteit die standaard moet worden gebruikt. | tekenreeks |
proxyOverride | Verbindingstype dat wordt gebruikt om verbinding te maken met het exemplaar. | "Standaard" "Proxy" "Omleiden" |
publicDataEndpointEnabled | Of het eindpunt voor openbare gegevens is ingeschakeld. | booleaans |
requestedBackupStorageRedundancy | Het type opslagaccount dat moet worden gebruikt voor het opslaan van back-ups voor dit exemplaar. De opties zijn Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) en GeoZone(GeoZoneRedundantStorage) | "Geo" "GeoZone" "Lokaal" "Zone" |
restorePointInTime | Hiermee geeft u het tijdstip (ISO8601 indeling) op van de brondatabase die wordt hersteld om de nieuwe database te maken. | tekenreeks |
servicePrincipal | De service-principal van het beheerde exemplaar. | ServicePrincipal |
sourceManagedInstanceId | De resource-id van het beheerde bronexemplaren die is gekoppeld aan de maakbewerking van dit exemplaar. | tekenreeks |
storageIOps | Opslag-IOps. Minimale waarde: 120. Maximale waarde: 120000. Stappen van 1 IOps zijn alleen toegestaan. De maximale waarde is afhankelijk van de geselecteerde hardwarefamilie en het aantal vCores. | int |
storageSizeInGB | Opslaggrootte in GB. Minimale waarde: 32. Maximale waarde: 16384. Stappen van 32 GB zijn alleen toegestaan. De maximale waarde is afhankelijk van de geselecteerde hardwarefamilie en het aantal vCores. | int |
storageThroughputMBps | Opslagdoorvoer in MBps. Minimale waarde: 25. Maximale waarde: 4000. Stappen van 1 MBps zijn alleen toegestaan. De maximale waarde is afhankelijk van de geselecteerde hardwarefamilie en het aantal vCores. | int |
subnetId | Subnetresource-id voor het beheerde exemplaar. | tekenreeks |
timezoneId | Id van de tijdzone. Toegestane waarden zijn tijdzones die worden ondersteund door Windows. Windows bewaart details over ondersteunde tijdzones, inclusief de id, in het register onder KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Tijdzones. U kunt deze registerwaarden ophalen via SQL Server door een query uit te voeren op SELECT-naam AS timezone_id FROM sys.time_zone_info. Een 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). |
tekenreeks |
vCores | Het aantal vCores. Toegestane waarden: 8, 16, 24, 32, 40, 64, 80. | int |
zoneRedundant | Of de multi-az is ingeschakeld of niet. | booleaans |
ManagedInstanceExternalAdministrator
Naam | Description | Waarde |
---|---|---|
administratorType | Type van de serverbeheerder. | "ActiveDirectory" |
azureADOnlyAuthentication | Alleen Azure Active Directory-verificatie ingeschakeld. | booleaans |
aanmelding | Aanmeldingsnaam van de serverbeheerder. | tekenreeks |
principalType | Principal Type van de serverbeheerder. | "Toepassing" "Groep" "Gebruiker" |
sid | SID (object-id) van de serverbeheerder. | tekenreeks Beperkingen: 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. | tekenreeks Beperkingen: Minimale lengte = 36 Maximale lengte = 36 Patroon = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
ServicePrincipal
Naam | Description | Waarde |
---|---|---|
type | Type service-principal. | "Geen" "SystemAssigned" |
Sku
Naam | Description | Waarde |
---|---|---|
capacity | Capaciteit van de specifieke SKU. | int |
gezin | Als de service verschillende generaties hardware voor dezelfde SKU heeft, kan die hier worden vastgelegd. | tekenreeks |
naam | De naam van de SKU, meestal een letter + cijfercode, bijvoorbeeld P3. | tekenreeks (vereist) |
grootte | Grootte van de specifieke SKU | tekenreeks |
laag | De laag of editie van de specifieke SKU, bijvoorbeeld Basic, Premium. | tekenreeks |