Not
Åtkomst till denna sida kräver auktorisation. Du kan prova att logga in eller byta katalog.
Åtkomst till denna sida kräver auktorisation. Du kan prova att byta katalog.
- Latest
- 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-resursdefinition
Resurstypen managedInstances kan distribueras med åtgärder som mål:
- Resursgrupper – Se resursgruppsdistributionskommandon
En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.
Resursformat
Om du vill skapa en Microsoft.Sql/managedInstances-resurs lägger du till följande Bicep i mallen.
resource symbolicname 'Microsoft.Sql/managedInstances@2024-11-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'
}
}
Egenskapsvärden
Microsoft.Sql/managedInstances
| Name | Description | Value |
|---|---|---|
| identity | Azure Active Directory-identiteten för den hanterade instansen. | ResourceIdentity |
| location | Resursplats. | sträng (krävs) |
| name | Resursnamnet | sträng (krävs) |
| properties | Resursegenskaper. | ManagedInstanceProperties |
| sku | SKU för hanterad instans. Tillåtna värden för sku.name: GP_Gen5 (Generell användning, Standard-serien); GP_G8IM (Generell användning, Premium-serien); GP_G8IH (Generell användning, Premium-seriens minne optimerat); BC_Gen5 (Affärskritisk, Standard-Series); BC_G8IM (Affärskritisk, Premium-serien); BC_G8IH (Affärskritisk, minnesoptimerad i Premium-serien). | Sku |
| tags | Resursetiketter | Ordlista med taggnamn och värden. Se taggar i mallar |
ManagedInstanceExternalAdministrator
| Name | Description | Value |
|---|---|---|
| administratorType | Typ av administratör för serverservern. | 'ActiveDirectory' |
| azureADOnlyAuthentication | Endast Azure Active Directory-autentisering aktiverat. | bool |
| login | Serveradministratörens inloggningsnamn. | string |
| principalType | Huvudtyp för sever-administratören. | 'Application' 'Group' 'User' |
| sid | SID (objekt-ID) för serveradministratören. | string Constraints: Min längd = 36 Maximal längd = 36 Mönster = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| tenantId | Administratörens klientorganisations-ID. | string Constraints: Min längd = 36 Maximal längd = 36 Mönster = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
ManagedInstanceProperties
| Name | Description | Value |
|---|---|---|
| administratorLogin | Administratörsanvändarnamn för den hanterade instansen. Kan bara anges när den hanterade instansen skapas (och krävs för att skapa). | string |
| administratorLoginPassword | Administratörens inloggningslösenord (krävs för att skapa en hanterad instans). | string Constraints: Känsligt värde. Skicka in som en säker parameter. |
| administrators | Azure Active Directory-administratören kan användas när instansen skapas och för instansuppdateringar, förutom azureADOnlyAuthentication egenskapen. Om du vill uppdatera egenskapen azureADOnlyAuthentication måste ett enskilt API användas. | ManagedInstanceExternalAdministrator |
| authenticationMetadata | Den hanterade instansens uppslagsläge för autentiseringsmetadata. | 'AzureAD' 'Paired' 'Windows' |
| collation | Sortering av den hanterade instansen. | string |
| databaseFormat | Anger det interna formatet för instansdatabaser som är specifika för SQL-motorversionen. | 'AlwaysUpToDate' 'SQLServer2022' "SQLServer2025" |
| dnsZonePartner | Resurs-ID för en annan hanterad instans vars DNS-zon den här hanterade instansen kommer att dela när den har skapats. | string |
| hybridSecondaryUsage | Sekundär hybridanvändning. Möjliga värden är "Aktiv" (standardvärde) och "Passiv" (kunden använder den sekundära som passiv DR). | 'Active' 'Passive' |
| instancePoolId | ID:t för instanspoolen som den hanterade servern tillhör. | string |
| isGeneralPurposeV2 | Om det här är en GPv2-variant av General Purpose Edition eller inte. | bool |
| keyId | En CMK-URI för nyckeln som ska användas för kryptering. | string |
| licenseType | Licenstypen. Möjliga värden är "LicenseIncluded" (vanligt pris inklusive en ny SQL-licens) och "BasePrice" (rabatterat AHB-pris för att ta med egna SQL-licenser). | 'BasePrice' 'LicenseIncluded' |
| maintenanceConfigurationId | Anger underhållskonfigurations-ID som ska tillämpas på den här hanterade instansen. | string |
| managedInstanceCreateMode | Anger läget för att skapa databasen. Standard: Skapande av vanlig instans. Återställning: Skapar en instans genom att återställa en uppsättning säkerhetskopior till en viss tidpunkt. RestorePointInTime och SourceManagedInstanceId måste anges. |
'Default' 'PointInTimeRestore' |
| memorySizeInGB | Minnesstorlek i GB. Minsta värde: 28. Maximalt värde: 870. Det lägsta och högsta värdet beror på antalet virtuella kärnor och tjänstnivån. Läs mer om resursgränser: https://aka.ms/mi-resource-limits-api. | int |
| minimalTlsVersion | Minimal TLS-version. Tillåtna värden: "Ingen", "1.0", "1.1", "1.2" | string |
| pricingModel | Prismodell för Hanterad instans. | 'Freemium' 'Regular' |
| primaryUserAssignedIdentityId | Resurs-ID för en användartilldelad identitet som ska användas som standard. | string |
| proxyOverride | Anslutningstyp som används för att ansluta till instansen. | 'Default' 'Proxy' 'Redirect' |
| publicDataEndpointEnabled | Om slutpunkten för offentliga data är aktiverad eller inte. | bool |
| requestedBackupStorageRedundancy | Den lagringskontotyp som ska användas för att lagra säkerhetskopior för den här instansen. Alternativen är Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) och GeoZone(GeoZoneRedundantStorage) | 'Geo' 'GeoZone' 'Local' 'Zone' |
| requestedLogicalAvailabilityZone | Anger den logiska tillgänglighetszon som den hanterade instansen är fäst på. | '1' '2' '3' 'NoPreference' |
| restorePointInTime | Anger tidpunkten (ISO8601 format) för källdatabasen som ska återställas för att skapa den nya databasen. | string |
| servicePrincipal | Den hanterade instansens huvudnamn för tjänsten. | ServicePrincipal |
| sourceManagedInstanceId | Resursidentifieraren för den källhanterade instans som är associerad med skapa-åtgärden för den här instansen. | string |
| storageIOps | IOps för lagring. Minsta värde: 300. Maximalt värde: 80000. Steg om endast 1 IOps tillåts. Maximalt värde beror på den valda maskinvarufamiljen och antalet virtuella kärnor. | int |
| storageSizeInGB | Lagringsstorlek i GB. Minsta värde: 32. Maximalt värde: 32768. Steg på endast 32 GB tillåts. Maximalt värde beror på den valda maskinvarufamiljen och antalet virtuella kärnor. | int |
| storageThroughputMBps | Mbit/s-parametern för lagringsdataflöde stöds inte i instansens create/update-åtgärd. | int |
| subnetId | Resurs-ID för undernätet för den hanterade instansen. | string |
| timezoneId | ID för tidszonen. Tillåtna värden är tidszoner som stöds av Windows. Windows behåller information om tidszoner som stöds, inklusive ID:t, i registret under KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Tidszoner. Du kan hämta dessa registervärden via SQL Server genom att fråga SELECT name AS timezone_id FROM sys.time_zone_info. Du kan också hämta en lista över ID:er genom att köra [System.TimeZoneInfo]::GetSystemTimeZones() i PowerShell. Ett exempel på giltigt tidszons-ID är "Pacific Standard Time" eller "W. Europa, standardtid". |
string |
| vCores | Antalet virtuella kärnor. Tillåtna värden: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Vilka virtuella kärnor som stöds beror på den valda maskinvarufamiljen och tjänstnivån. | int |
| zoneRedundant | Om zonredundansen är aktiverad eller inte. | bool |
ResourceIdentity
| Name | Description | Value |
|---|---|---|
| type | Identitetstypen. Ställ in detta på "SystemAssigned" för att automatiskt skapa och tilldela ett Azure Active Directory-huvudnamn för resursen. | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' |
| userAssignedIdentities | Resurs-ID:n för de användartilldelade identiteter som ska användas | ResourceIdentityUserAssignedIdentities |
ResourceIdentityUserAssignedIdentities
| Name | Description | Value |
|---|
ServicePrincipal
| Name | Description | Value |
|---|---|---|
| type | Tjänstens huvudnamnstyp. | 'None' 'SystemAssigned' |
Sku
| Name | Description | Value |
|---|---|---|
| capacity | Kapacitet för den specifika SKU:n. | int |
| family | Om tjänsten har olika generationer av maskinvara, för samma SKU, kan den samlas in här. | string |
| name | Namnet på SKU:n, vanligtvis en bokstav + nummerkod, t.ex. P3. | sträng (krävs) |
| size | Storleken på den specifika SKU:n | string |
| tier | Nivån eller utgåvan av den specifika SKU:n, t.ex. Basic, Premium. | string |
TrackedResourceTags
| Name | Description | Value |
|---|
UserIdentity
| Name | Description | Value |
|---|
Användningsexempel
Azure-verifierade moduler
Följande Azure-verifierade moduler kan användas för att distribuera den här resurstypen.
| Module | Description |
|---|---|
| SQL-hanterad instans | AVM-resursmodul för SQL Managed Instance |
Azure-snabbstartsexempel
Följande Azure-snabbstartsmallar innehålla Bicep-exempel för distribution av den här resurstypen.
| Bicep-fil | Description |
|---|---|
| Skapa SQL MI i det nya virtuella nätverket | Distribuera Azure Sql Database Managed Instance (SQL MI) i det nya virtuella nätverket. |
Resursdefinition för ARM-mall
Resurstypen managedInstances kan distribueras med åtgärder som mål:
- Resursgrupper – Se resursgruppsdistributionskommandon
En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.
Resursformat
Om du vill skapa en Microsoft.Sql/managedInstances-resurs lägger du till följande JSON i mallen.
{
"type": "Microsoft.Sql/managedInstances",
"apiVersion": "2024-11-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"
}
}
Egenskapsvärden
Microsoft.Sql/managedInstances
| Name | Description | Value |
|---|---|---|
| apiVersion | API-versionen | '2024-11-01-preview' |
| identity | Azure Active Directory-identiteten för den hanterade instansen. | ResourceIdentity |
| location | Resursplats. | sträng (krävs) |
| name | Resursnamnet | sträng (krävs) |
| properties | Resursegenskaper. | ManagedInstanceProperties |
| sku | SKU för hanterad instans. Tillåtna värden för sku.name: GP_Gen5 (Generell användning, Standard-serien); GP_G8IM (Generell användning, Premium-serien); GP_G8IH (Generell användning, Premium-seriens minne optimerat); BC_Gen5 (Affärskritisk, Standard-Series); BC_G8IM (Affärskritisk, Premium-serien); BC_G8IH (Affärskritisk, minnesoptimerad i Premium-serien). | Sku |
| tags | Resursetiketter | Ordlista med taggnamn och värden. Se taggar i mallar |
| type | Resurstypen | 'Microsoft.Sql/managedInstances' |
ManagedInstanceExternalAdministrator
| Name | Description | Value |
|---|---|---|
| administratorType | Typ av administratör för serverservern. | 'ActiveDirectory' |
| azureADOnlyAuthentication | Endast Azure Active Directory-autentisering aktiverat. | bool |
| login | Serveradministratörens inloggningsnamn. | string |
| principalType | Huvudtyp för sever-administratören. | 'Application' 'Group' 'User' |
| sid | SID (objekt-ID) för serveradministratören. | string Constraints: Min längd = 36 Maximal längd = 36 Mönster = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| tenantId | Administratörens klientorganisations-ID. | string Constraints: Min längd = 36 Maximal längd = 36 Mönster = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
ManagedInstanceProperties
| Name | Description | Value |
|---|---|---|
| administratorLogin | Administratörsanvändarnamn för den hanterade instansen. Kan bara anges när den hanterade instansen skapas (och krävs för att skapa). | string |
| administratorLoginPassword | Administratörens inloggningslösenord (krävs för att skapa en hanterad instans). | string Constraints: Känsligt värde. Skicka in som en säker parameter. |
| administrators | Azure Active Directory-administratören kan användas när instansen skapas och för instansuppdateringar, förutom azureADOnlyAuthentication egenskapen. Om du vill uppdatera egenskapen azureADOnlyAuthentication måste ett enskilt API användas. | ManagedInstanceExternalAdministrator |
| authenticationMetadata | Den hanterade instansens uppslagsläge för autentiseringsmetadata. | 'AzureAD' 'Paired' 'Windows' |
| collation | Sortering av den hanterade instansen. | string |
| databaseFormat | Anger det interna formatet för instansdatabaser som är specifika för SQL-motorversionen. | 'AlwaysUpToDate' 'SQLServer2022' "SQLServer2025" |
| dnsZonePartner | Resurs-ID för en annan hanterad instans vars DNS-zon den här hanterade instansen kommer att dela när den har skapats. | string |
| hybridSecondaryUsage | Sekundär hybridanvändning. Möjliga värden är "Aktiv" (standardvärde) och "Passiv" (kunden använder den sekundära som passiv DR). | 'Active' 'Passive' |
| instancePoolId | ID:t för instanspoolen som den hanterade servern tillhör. | string |
| isGeneralPurposeV2 | Om det här är en GPv2-variant av General Purpose Edition eller inte. | bool |
| keyId | En CMK-URI för nyckeln som ska användas för kryptering. | string |
| licenseType | Licenstypen. Möjliga värden är "LicenseIncluded" (vanligt pris inklusive en ny SQL-licens) och "BasePrice" (rabatterat AHB-pris för att ta med egna SQL-licenser). | 'BasePrice' 'LicenseIncluded' |
| maintenanceConfigurationId | Anger underhållskonfigurations-ID som ska tillämpas på den här hanterade instansen. | string |
| managedInstanceCreateMode | Anger läget för att skapa databasen. Standard: Skapande av vanlig instans. Återställning: Skapar en instans genom att återställa en uppsättning säkerhetskopior till en viss tidpunkt. RestorePointInTime och SourceManagedInstanceId måste anges. |
'Default' 'PointInTimeRestore' |
| memorySizeInGB | Minnesstorlek i GB. Minsta värde: 28. Maximalt värde: 870. Det lägsta och högsta värdet beror på antalet virtuella kärnor och tjänstnivån. Läs mer om resursgränser: https://aka.ms/mi-resource-limits-api. | int |
| minimalTlsVersion | Minimal TLS-version. Tillåtna värden: "Ingen", "1.0", "1.1", "1.2" | string |
| pricingModel | Prismodell för Hanterad instans. | 'Freemium' 'Regular' |
| primaryUserAssignedIdentityId | Resurs-ID för en användartilldelad identitet som ska användas som standard. | string |
| proxyOverride | Anslutningstyp som används för att ansluta till instansen. | 'Default' 'Proxy' 'Redirect' |
| publicDataEndpointEnabled | Om slutpunkten för offentliga data är aktiverad eller inte. | bool |
| requestedBackupStorageRedundancy | Den lagringskontotyp som ska användas för att lagra säkerhetskopior för den här instansen. Alternativen är Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) och GeoZone(GeoZoneRedundantStorage) | 'Geo' 'GeoZone' 'Local' 'Zone' |
| requestedLogicalAvailabilityZone | Anger den logiska tillgänglighetszon som den hanterade instansen är fäst på. | '1' '2' '3' 'NoPreference' |
| restorePointInTime | Anger tidpunkten (ISO8601 format) för källdatabasen som ska återställas för att skapa den nya databasen. | string |
| servicePrincipal | Den hanterade instansens huvudnamn för tjänsten. | ServicePrincipal |
| sourceManagedInstanceId | Resursidentifieraren för den källhanterade instans som är associerad med skapa-åtgärden för den här instansen. | string |
| storageIOps | IOps för lagring. Minsta värde: 300. Maximalt värde: 80000. Steg om endast 1 IOps tillåts. Maximalt värde beror på den valda maskinvarufamiljen och antalet virtuella kärnor. | int |
| storageSizeInGB | Lagringsstorlek i GB. Minsta värde: 32. Maximalt värde: 32768. Steg på endast 32 GB tillåts. Maximalt värde beror på den valda maskinvarufamiljen och antalet virtuella kärnor. | int |
| storageThroughputMBps | Mbit/s-parametern för lagringsdataflöde stöds inte i instansens create/update-åtgärd. | int |
| subnetId | Resurs-ID för undernätet för den hanterade instansen. | string |
| timezoneId | ID för tidszonen. Tillåtna värden är tidszoner som stöds av Windows. Windows behåller information om tidszoner som stöds, inklusive ID:t, i registret under KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Tidszoner. Du kan hämta dessa registervärden via SQL Server genom att fråga SELECT name AS timezone_id FROM sys.time_zone_info. Du kan också hämta en lista över ID:er genom att köra [System.TimeZoneInfo]::GetSystemTimeZones() i PowerShell. Ett exempel på giltigt tidszons-ID är "Pacific Standard Time" eller "W. Europa, standardtid". |
string |
| vCores | Antalet virtuella kärnor. Tillåtna värden: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Vilka virtuella kärnor som stöds beror på den valda maskinvarufamiljen och tjänstnivån. | int |
| zoneRedundant | Om zonredundansen är aktiverad eller inte. | bool |
ResourceIdentity
| Name | Description | Value |
|---|---|---|
| type | Identitetstypen. Ställ in detta på "SystemAssigned" för att automatiskt skapa och tilldela ett Azure Active Directory-huvudnamn för resursen. | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' |
| userAssignedIdentities | Resurs-ID:n för de användartilldelade identiteter som ska användas | ResourceIdentityUserAssignedIdentities |
ResourceIdentityUserAssignedIdentities
| Name | Description | Value |
|---|
ServicePrincipal
| Name | Description | Value |
|---|---|---|
| type | Tjänstens huvudnamnstyp. | 'None' 'SystemAssigned' |
Sku
| Name | Description | Value |
|---|---|---|
| capacity | Kapacitet för den specifika SKU:n. | int |
| family | Om tjänsten har olika generationer av maskinvara, för samma SKU, kan den samlas in här. | string |
| name | Namnet på SKU:n, vanligtvis en bokstav + nummerkod, t.ex. P3. | sträng (krävs) |
| size | Storleken på den specifika SKU:n | string |
| tier | Nivån eller utgåvan av den specifika SKU:n, t.ex. Basic, Premium. | string |
TrackedResourceTags
| Name | Description | Value |
|---|
UserIdentity
| Name | Description | Value |
|---|
Användningsexempel
Azure-snabbstartsmallar
Följande Azure-snabbstartsmallar distribuera den här resurstypen.
| Template | Description |
|---|---|
|
Skapa SQL MI i det nya virtuella nätverket |
Distribuera Azure Sql Database Managed Instance (SQL MI) i det nya virtuella nätverket. |
|
Skapa SQL MI med konfigurerad sändning av loggar och mått |
Med den här mallen kan du distribuera SQL MI och ytterligare resurser som används för att lagra loggar och mått (diagnostikarbetsyta, lagringskonto, händelsehubb). |
|
Skapa SQL MI med jumpbox i det nya virtuella nätverket |
Distribuera Azure Sql Database Managed Instance (SQL MI) och JumpBox med SSMS i det nya virtuella nätverket. |
|
Skapa SQL MI med punkt-till-plats-anslutning konfigurerad |
Distribuera Azure Sql Database Managed Instance (SQL MI) och virtuell nätverksgateway som konfigurerats för punkt-till-plats-anslutning i det nya virtuella nätverket. |
|
Distribuera SQL Managed Instance med nätverk |
Distribuera UDR och NSG för att stödja Azure SQL Managed Instance och distribuera den hanterade instansen |
Resursdefinition för Terraform (AzAPI-provider)
Resurstypen managedInstances kan distribueras med åtgärder som mål:
- Resursgrupper
En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.
Resursformat
Om du vill skapa en Microsoft.Sql/managedInstances-resurs lägger du till följande Terraform i mallen.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Sql/managedInstances@2024-11-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"
}
}
}
Egenskapsvärden
Microsoft.Sql/managedInstances
| Name | Description | Value |
|---|---|---|
| identity | Azure Active Directory-identiteten för den hanterade instansen. | ResourceIdentity |
| location | Resursplats. | sträng (krävs) |
| name | Resursnamnet | sträng (krävs) |
| properties | Resursegenskaper. | ManagedInstanceProperties |
| sku | SKU för hanterad instans. Tillåtna värden för sku.name: GP_Gen5 (Generell användning, Standard-serien); GP_G8IM (Generell användning, Premium-serien); GP_G8IH (Generell användning, Premium-seriens minne optimerat); BC_Gen5 (Affärskritisk, Standard-Series); BC_G8IM (Affärskritisk, Premium-serien); BC_G8IH (Affärskritisk, minnesoptimerad i Premium-serien). | Sku |
| tags | Resursetiketter | Ordlista med taggnamn och värden. |
| type | Resurstypen | "Microsoft.Sql/managedInstances@2024-11-01-preview" |
ManagedInstanceExternalAdministrator
| Name | Description | Value |
|---|---|---|
| administratorType | Typ av administratör för serverservern. | 'ActiveDirectory' |
| azureADOnlyAuthentication | Endast Azure Active Directory-autentisering aktiverat. | bool |
| login | Serveradministratörens inloggningsnamn. | string |
| principalType | Huvudtyp för sever-administratören. | 'Application' 'Group' 'User' |
| sid | SID (objekt-ID) för serveradministratören. | string Constraints: Min längd = 36 Maximal längd = 36 Mönster = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| tenantId | Administratörens klientorganisations-ID. | string Constraints: Min längd = 36 Maximal längd = 36 Mönster = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
ManagedInstanceProperties
| Name | Description | Value |
|---|---|---|
| administratorLogin | Administratörsanvändarnamn för den hanterade instansen. Kan bara anges när den hanterade instansen skapas (och krävs för att skapa). | string |
| administratorLoginPassword | Administratörens inloggningslösenord (krävs för att skapa en hanterad instans). | string Constraints: Känsligt värde. Skicka in som en säker parameter. |
| administrators | Azure Active Directory-administratören kan användas när instansen skapas och för instansuppdateringar, förutom azureADOnlyAuthentication egenskapen. Om du vill uppdatera egenskapen azureADOnlyAuthentication måste ett enskilt API användas. | ManagedInstanceExternalAdministrator |
| authenticationMetadata | Den hanterade instansens uppslagsläge för autentiseringsmetadata. | 'AzureAD' 'Paired' 'Windows' |
| collation | Sortering av den hanterade instansen. | string |
| databaseFormat | Anger det interna formatet för instansdatabaser som är specifika för SQL-motorversionen. | 'AlwaysUpToDate' 'SQLServer2022' "SQLServer2025" |
| dnsZonePartner | Resurs-ID för en annan hanterad instans vars DNS-zon den här hanterade instansen kommer att dela när den har skapats. | string |
| hybridSecondaryUsage | Sekundär hybridanvändning. Möjliga värden är "Aktiv" (standardvärde) och "Passiv" (kunden använder den sekundära som passiv DR). | 'Active' 'Passive' |
| instancePoolId | ID:t för instanspoolen som den hanterade servern tillhör. | string |
| isGeneralPurposeV2 | Om det här är en GPv2-variant av General Purpose Edition eller inte. | bool |
| keyId | En CMK-URI för nyckeln som ska användas för kryptering. | string |
| licenseType | Licenstypen. Möjliga värden är "LicenseIncluded" (vanligt pris inklusive en ny SQL-licens) och "BasePrice" (rabatterat AHB-pris för att ta med egna SQL-licenser). | 'BasePrice' 'LicenseIncluded' |
| maintenanceConfigurationId | Anger underhållskonfigurations-ID som ska tillämpas på den här hanterade instansen. | string |
| managedInstanceCreateMode | Anger läget för att skapa databasen. Standard: Skapande av vanlig instans. Återställning: Skapar en instans genom att återställa en uppsättning säkerhetskopior till en viss tidpunkt. RestorePointInTime och SourceManagedInstanceId måste anges. |
'Default' 'PointInTimeRestore' |
| memorySizeInGB | Minnesstorlek i GB. Minsta värde: 28. Maximalt värde: 870. Det lägsta och högsta värdet beror på antalet virtuella kärnor och tjänstnivån. Läs mer om resursgränser: https://aka.ms/mi-resource-limits-api. | int |
| minimalTlsVersion | Minimal TLS-version. Tillåtna värden: "Ingen", "1.0", "1.1", "1.2" | string |
| pricingModel | Prismodell för Hanterad instans. | 'Freemium' 'Regular' |
| primaryUserAssignedIdentityId | Resurs-ID för en användartilldelad identitet som ska användas som standard. | string |
| proxyOverride | Anslutningstyp som används för att ansluta till instansen. | 'Default' 'Proxy' 'Redirect' |
| publicDataEndpointEnabled | Om slutpunkten för offentliga data är aktiverad eller inte. | bool |
| requestedBackupStorageRedundancy | Den lagringskontotyp som ska användas för att lagra säkerhetskopior för den här instansen. Alternativen är Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) och GeoZone(GeoZoneRedundantStorage) | 'Geo' 'GeoZone' 'Local' 'Zone' |
| requestedLogicalAvailabilityZone | Anger den logiska tillgänglighetszon som den hanterade instansen är fäst på. | '1' '2' '3' 'NoPreference' |
| restorePointInTime | Anger tidpunkten (ISO8601 format) för källdatabasen som ska återställas för att skapa den nya databasen. | string |
| servicePrincipal | Den hanterade instansens huvudnamn för tjänsten. | ServicePrincipal |
| sourceManagedInstanceId | Resursidentifieraren för den källhanterade instans som är associerad med skapa-åtgärden för den här instansen. | string |
| storageIOps | IOps för lagring. Minsta värde: 300. Maximalt värde: 80000. Steg om endast 1 IOps tillåts. Maximalt värde beror på den valda maskinvarufamiljen och antalet virtuella kärnor. | int |
| storageSizeInGB | Lagringsstorlek i GB. Minsta värde: 32. Maximalt värde: 32768. Steg på endast 32 GB tillåts. Maximalt värde beror på den valda maskinvarufamiljen och antalet virtuella kärnor. | int |
| storageThroughputMBps | Mbit/s-parametern för lagringsdataflöde stöds inte i instansens create/update-åtgärd. | int |
| subnetId | Resurs-ID för undernätet för den hanterade instansen. | string |
| timezoneId | ID för tidszonen. Tillåtna värden är tidszoner som stöds av Windows. Windows behåller information om tidszoner som stöds, inklusive ID:t, i registret under KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Tidszoner. Du kan hämta dessa registervärden via SQL Server genom att fråga SELECT name AS timezone_id FROM sys.time_zone_info. Du kan också hämta en lista över ID:er genom att köra [System.TimeZoneInfo]::GetSystemTimeZones() i PowerShell. Ett exempel på giltigt tidszons-ID är "Pacific Standard Time" eller "W. Europa, standardtid". |
string |
| vCores | Antalet virtuella kärnor. Tillåtna värden: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Vilka virtuella kärnor som stöds beror på den valda maskinvarufamiljen och tjänstnivån. | int |
| zoneRedundant | Om zonredundansen är aktiverad eller inte. | bool |
ResourceIdentity
| Name | Description | Value |
|---|---|---|
| type | Identitetstypen. Ställ in detta på "SystemAssigned" för att automatiskt skapa och tilldela ett Azure Active Directory-huvudnamn för resursen. | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' |
| userAssignedIdentities | Resurs-ID:n för de användartilldelade identiteter som ska användas | ResourceIdentityUserAssignedIdentities |
ResourceIdentityUserAssignedIdentities
| Name | Description | Value |
|---|
ServicePrincipal
| Name | Description | Value |
|---|---|---|
| type | Tjänstens huvudnamnstyp. | 'None' 'SystemAssigned' |
Sku
| Name | Description | Value |
|---|---|---|
| capacity | Kapacitet för den specifika SKU:n. | int |
| family | Om tjänsten har olika generationer av maskinvara, för samma SKU, kan den samlas in här. | string |
| name | Namnet på SKU:n, vanligtvis en bokstav + nummerkod, t.ex. P3. | sträng (krävs) |
| size | Storleken på den specifika SKU:n | string |
| tier | Nivån eller utgåvan av den specifika SKU:n, t.ex. Basic, Premium. | string |
TrackedResourceTags
| Name | Description | Value |
|---|
UserIdentity
| Name | Description | Value |
|---|
Användningsexempel
Azure-verifierade moduler
Följande Azure-verifierade moduler kan användas för att distribuera den här resurstypen.
| Module | Description |
|---|---|
| SQL-hanterad instans | AVM-resursmodul för SQL Managed Instance |