Microsoft. SQL managedInstances

Bicep-resourcedefinitie

Het resourcetype managedInstances kan worden geïmplementeerd met bewerkingen die zijn gericht op:

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@2025-02-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'
    memorySizeInGB: int
    minimalTlsVersion: 'string'
    pricingModel: 'string'
    primaryUserAssignedIdentityId: 'string'
    proxyOverride: 'string'
    publicDataEndpointEnabled: bool
    requestedBackupStorageRedundancy: 'string'
    requestedLogicalAvailabilityZone: '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'
  }
  tags: {
    {customized property}: 'string'
  }
}

Eigenschapswaarden

Microsoft. Sql/managedInstances

Name Description Value
identity De Azure Active Directory-identiteit van de beheerde instantie. ResourceIdentity
location De geografische locatie waar de resource zich bevindt tekenreeks (vereist)
name De resourcenaam tekenreeks (vereist)
properties Resource-eigenschappen. ManagedInstanceProperties
sku Beheerde exemplaar-SKU. Toegestane waarden voor sku.name: GP_Gen5 (General Purpose, Standard-serie); GP_G8IM (Algemeen gebruik, Premium-serie); GP_G8IH (voor algemeen gebruik, geoptimaliseerd voor geheugen uit de Premium-serie); BC_Gen5 (Bedrijfskritisch, Standard-Series); BC_G8IM (Bedrijfskritisch, Premium-serie); BC_G8IH (bedrijfskritisch, geoptimaliseerd voor geheugen uit de Premium-serie). 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 kan worden gebruikt tijdens het aanmaken van een instantie en voor updates van instanties, behalve voor de eigenschap azureADOnlyAuthentication. Als u de eigenschap azureADOnlyAuthentication wilt bijwerken, moet een afzonderlijke API 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'
'SQLServer2025'
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'
geheugenGrootteInGB Geheugengrootte in GB. Minimale waarde: 28. Maximale waarde: 870. De minimum- en maximumwaarde zijn afhankelijk van het aantal vCores en de servicelaag. Lees meer over resourcelimieten: https://aka.ms/mi-resource-limits-api. int
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'
requestedLogicalAvailabilityZone Specificeert de logische beschikbaarheidszone waaraan Managed Instance is vastgezet. '1'
'2'
'3'
'NoPreference'
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. Maximale waarde: 32768. 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
vCores Het aantal vCores. Toegestane waarden: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Ondersteunde vCores is afhankelijk van de geselecteerde hardwarefamilie en servicelaag. int
zoneRedundant Of de zone-redundantie al dan 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

Geverifieerde Azure-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.

Bicepsbestand 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:

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": "2025-02-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",
    "memorySizeInGB": "int",
    "minimalTlsVersion": "string",
    "pricingModel": "string",
    "primaryUserAssignedIdentityId": "string",
    "proxyOverride": "string",
    "publicDataEndpointEnabled": "bool",
    "requestedBackupStorageRedundancy": "string",
    "requestedLogicalAvailabilityZone": "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"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Eigenschapswaarden

Microsoft. Sql/managedInstances

Name Description Value
apiVersion De API-versie '2025-02-01-voorbeschouwing'
identity De Azure Active Directory-identiteit van de beheerde instantie. ResourceIdentity
location De geografische locatie waar de resource zich bevindt tekenreeks (vereist)
name De resourcenaam tekenreeks (vereist)
properties Resource-eigenschappen. ManagedInstanceProperties
sku Beheerde exemplaar-SKU. Toegestane waarden voor sku.name: GP_Gen5 (General Purpose, Standard-serie); GP_G8IM (Algemeen gebruik, Premium-serie); GP_G8IH (voor algemeen gebruik, geoptimaliseerd voor geheugen uit de Premium-serie); BC_Gen5 (Bedrijfskritisch, Standard-Series); BC_G8IM (Bedrijfskritisch, Premium-serie); BC_G8IH (bedrijfskritisch, geoptimaliseerd voor geheugen uit de Premium-serie). 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 kan worden gebruikt tijdens het aanmaken van een instantie en voor updates van instanties, behalve voor de eigenschap azureADOnlyAuthentication. Als u de eigenschap azureADOnlyAuthentication wilt bijwerken, moet een afzonderlijke API 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'
'SQLServer2025'
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'
geheugenGrootteInGB Geheugengrootte in GB. Minimale waarde: 28. Maximale waarde: 870. De minimum- en maximumwaarde zijn afhankelijk van het aantal vCores en de servicelaag. Lees meer over resourcelimieten: https://aka.ms/mi-resource-limits-api. int
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'
requestedLogicalAvailabilityZone Specificeert de logische beschikbaarheidszone waaraan Managed Instance is vastgezet. '1'
'2'
'3'
'NoPreference'
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. Maximale waarde: 32768. 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
vCores Het aantal vCores. Toegestane waarden: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Ondersteunde vCores is afhankelijk van de geselecteerde hardwarefamilie en servicelaag. int
zoneRedundant Of de zone-redundantie al dan 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

Snelstartsjablonen voor Azure

De volgende Azure Quickstart-sjablonen deployen dit resourcetype.

Template Description
Create SQL MI binnen het nieuwe virtuele netwerk

Deploy naar Azure
Deploy Azure SQL Database Managed Instance (SQL MI) binnen het nieuwe Virtual Network.
Create SQL MI met geconfigureerde verzending van logs en metrics

Deploy naar Azure
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 naar Azure
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 naar Azure
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 naar Azure
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@2025-02-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"
      memorySizeInGB = int
      minimalTlsVersion = "string"
      pricingModel = "string"
      primaryUserAssignedIdentityId = "string"
      proxyOverride = "string"
      publicDataEndpointEnabled = bool
      requestedBackupStorageRedundancy = "string"
      requestedLogicalAvailabilityZone = "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

Microsoft. Sql/managedInstances

Name Description Value
identity De Azure Active Directory-identiteit van de beheerde instantie. ResourceIdentity
location De geografische locatie waar de resource zich bevindt tekenreeks (vereist)
name De resourcenaam tekenreeks (vereist)
properties Resource-eigenschappen. ManagedInstanceProperties
sku Beheerde exemplaar-SKU. Toegestane waarden voor sku.name: GP_Gen5 (General Purpose, Standard-serie); GP_G8IM (Algemeen gebruik, Premium-serie); GP_G8IH (voor algemeen gebruik, geoptimaliseerd voor geheugen uit de Premium-serie); BC_Gen5 (Bedrijfskritisch, Standard-Series); BC_G8IM (Bedrijfskritisch, Premium-serie); BC_G8IH (bedrijfskritisch, geoptimaliseerd voor geheugen uit de Premium-serie). Sku
tags Resourcetags Woordenlijst met tagnamen en -waarden.
type Het brontype "Microsoft. Sql/managedInstances@2025-02-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 kan worden gebruikt tijdens het aanmaken van een instantie en voor updates van instanties, behalve voor de eigenschap azureADOnlyAuthentication. Als u de eigenschap azureADOnlyAuthentication wilt bijwerken, moet een afzonderlijke API 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'
'SQLServer2025'
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'
geheugenGrootteInGB Geheugengrootte in GB. Minimale waarde: 28. Maximale waarde: 870. De minimum- en maximumwaarde zijn afhankelijk van het aantal vCores en de servicelaag. Lees meer over resourcelimieten: https://aka.ms/mi-resource-limits-api. int
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'
requestedLogicalAvailabilityZone Specificeert de logische beschikbaarheidszone waaraan Managed Instance is vastgezet. '1'
'2'
'3'
'NoPreference'
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. Maximale waarde: 32768. 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
vCores Het aantal vCores. Toegestane waarden: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Ondersteunde vCores is afhankelijk van de geselecteerde hardwarefamilie en servicelaag. int
zoneRedundant Of de zone-redundantie al dan 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

Geverifieerde Azure-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