Microsoft. SQL managedInstances 2026-08-01-preview

Definicja zasobu Bicep

Typ zasobu managedInstances można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Przykłady użycia

Moduły zweryfikowane na platformie Azure

Następujące moduły zweryfikowane platformy Azure mogą służyć do wdrażania tego typu zasobu.

Moduł Description
SQL Managed Instance Moduł zasobów AVM dla SQL Managed Instance

Przykłady szybkiego startu platformy Azure

Poniższe szablony szybkiego startu platformy Azure zawierają przykłady Bicep na potrzeby wdrażania tego typu zasobu.

Plik Bicep Description
Tworzenie wystąpienia zarządzanego SQL w nowej sieci wirtualnej Wdróż wystąpienie zarządzane usługi Azure Sql Database (SQL MI) w nowej sieci wirtualnej.

Format zasobu

By stworzyć Microsoft. Zasoby Sql/ManagedInstances, dodaj następujący Bicep do swojego szablonu.

resource symbolicname 'Microsoft.Sql/managedInstances@2026-08-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'
  }
}

Wartości właściwości

Microsoft.Sql/managedInstances

Name Description Value
tożsamość Tożsamość usługi Azure Active Directory wystąpienia zarządzanego. ResourceIdentity
lokalizacja Lokalizacja geograficzna, w której znajduje się zasób ciąg znaków (wymagane)
nazwa Nazwa zasobu ciąg znaków (wymagane)
properties Właściwości zasobu. ManagedInstanceProperties
sku Jednostka SKU wystąpienia zarządzanego. Dopuszczalne wartości dla sku.name: GP_Gen5 (ogólnego przeznaczenia, seria standardowa); GP_G8IM (ogólnego przeznaczenia, seria Premium); GP_G8IH (ogólnego przeznaczenia, zoptymalizowana pod kątem pamięci serii Premium); BC_Gen5 (Krytyczne dla biznesu, Standard-Series); BC_G8IM (Krytyczne dla firmy, seria Premium); BC_G8IH (Krytyczne dla działania firmy, zoptymalizowane pod kątem pamięci serii Premium). Sku
tags Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach

ManagedInstanceExternalAdministrator

Name Description Value
administratorType Typ administratora serwera. "ActiveDirectory"
azureADOnlyAuthentication Włączono tylko uwierzytelnianie usługi Azure Active Directory. bool
login Nazwa logowania administratora serwera. ciąg
principalType Typ podmiotu zabezpieczeń administratora serwera. 'Application'
"Grupuj"
'User'
sid Identyfikator SID (identyfikator obiektu) administratora serwera. string

Ograniczenia:
Minimalna długość = 36
Maksymalna długość = 36
Wzorzec = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
tenantId Identyfikator dzierżawy administratora. string

Ograniczenia:
Minimalna długość = 36
Maksymalna długość = 36
Wzorzec = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$

ManagedInstanceProperties

Name Description Value
administratorZaloguj się Nazwa użytkownika administratora dla wystąpienia zarządzanego. Można określić tylko wtedy, gdy wystąpienie zarządzane jest tworzone (i jest wymagane do utworzenia). ciąg
hasłoLogowaniaAdministratora Hasło logowania administratora (wymagane do utworzenia wystąpienia zarządzanego). string

Ograniczenia:
Wartość wrażliwa. Przekaż jako bezpieczny parametr.
administrators Administrator Azure Active Directory może być używany podczas tworzenia instancji oraz aktualizacji instancji, z wyjątkiem właściwości azureADOnlyAuthentication. Aby zaktualizować właściwość azureADOnlyAuthentication, należy użyć indywidualnego interfejsu API. ManagedInstanceExternalAdministrator
authenticationMetadata Tryb wyszukiwania metadanych uwierzytelniania wystąpienia zarządzanego. 'AzureAD'
'Paired'
'Windows'
sortowanie Sortowanie wystąpienia zarządzanego. ciąg
databaseFormat Określa wewnętrzny format baz danych wystąpień specyficzny dla wersji aparatu SQL. 'AlwaysUpToDate'
'SQLServer2022'
'SQLServer2025' (SQLServer2025)
dnsZonePartner Identyfikator zasobu innego wystąpienia zarządzanego, którego strefa DNS będzie współużytkowała to wystąpienie zarządzane po utworzeniu. ciąg
hybridSecondaryUsage Użycie pomocnicze hybrydowe. Możliwe wartości to "Aktywne" (wartość domyślna) i "Pasywne" (klient używa pomocniczego jako pasywnego odzyskiwania po awarii). "Aktywne"
'Passive'
instancePoolId Identyfikator puli wystąpień, do którego należy ten serwer zarządzany. ciąg
isGeneralPurposeV2 Niezależnie od tego, czy jest to wariant GPv2 wersji Ogólnego przeznaczenia. bool
keyId (identyfikator klucza) Identyfikator URI klucza cmK do użycia na potrzeby szyfrowania. ciąg
licenseType Typ licencji. Możliwe wartości to "LicenseIncluded" (zwykła cena włącznie z nową licencją SQL) i "BasePrice" (obniżona cena AHB za wprowadzenie własnych licencji SQL). 'BasePrice'
"LicenseIncluded"
maintenanceConfigurationId Określa identyfikator konfiguracji konserwacji, który ma być stosowany do tego wystąpienia zarządzanego. ciąg
managedInstanceCreateMode Określa tryb tworzenia bazy danych.

Ustawienie domyślne: Regularne tworzenie wystąpienia.

Przywracanie: tworzy wystąpienie, przywracając zestaw kopii zapasowych do określonego punktu w czasie. Należy określić wartości RestorePointInTime i SourceManagedInstanceId.
'Default'
"PointInTimeRestore"
memorySizeInGB Rozmiar pamięci w GB. Wartość minimalna: 28. Wartość maksymalna: 870. Wartość minimalna i maksymalna zależy od liczby rdzeni wirtualnych i warstwy usługi. Więcej informacji na temat limitów zasobów można znaleźć tutaj: https://aka.ms/mi-resource-limits-api. int
minimalTlsVersion (wersja minimalTls) Minimalna wersja protokołu TLS. Dozwolone wartości: "None", "1.0", "1.1", "1.2" ciąg
pricingModel Model wyceny Managed Instance. 'Freemium'
'Regular'
primaryUserAssignedIdentityId Identyfikator zasobu tożsamości przypisanej przez użytkownika domyślnie używany. ciąg
proxyOverride Typ połączenia używany do nawiązywania połączenia z wystąpieniem. 'Default'
'Proxy'
'Redirect'
publicDataEndpointEnabled Określa, czy publiczny punkt końcowy danych jest włączony. bool
requestedBackupStorageRedundancy Typ konta magazynu, który ma być używany do przechowywania kopii zapasowych dla tego wystąpienia. Dostępne opcje to LocallyRedundantStorage, Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) i GeoZone(GeoZoneRedundantStorage) "Geo"
'GeoZone'
"Lokalny"
"Strefa"
requestedLogicalAvailabilityZone Określa logiczną strefę dostępności, do której przypięty jest Managed Instance. '1'
'2'
'3'
"NoPreference"
restorePointInTime Określa punkt w czasie (ISO8601 format) źródłowej bazy danych, która zostanie przywrócona w celu utworzenia nowej bazy danych. ciąg
servicePrincipal (jednostka usługi) Jednostka usługi wystąpienia zarządzanego. ServicePrincipal (jednostka usługi)
sourceManagedInstanceId Identyfikator zasobu źródłowego wystąpienia zarządzanego skojarzonego z operacją tworzenia tego wystąpienia. ciąg
storageIOps Operacje we/wy na sekundę magazynu. Wartość minimalna: 300. Wartość maksymalna: 80000. Liczba operacji we/wy na sekundę jest 1 dozwolona. Maksymalna wartość zależy od wybranej rodziny sprzętu i liczby rdzeni wirtualnych. int
storageSizeInGB Rozmiar magazynu w GB. Wartość minimalna: 32. Wartość maksymalna: 32768. Liczba dozwolonych przyrostów 32 GB. Maksymalna wartość zależy od wybranej rodziny sprzętu i liczby rdzeni wirtualnych. int
storageThroughputMBps Parametr MBps przepływności magazynu nie jest obsługiwany w operacji tworzenia/aktualizowania wystąpienia. int
subnetId Identyfikator zasobu podsieci dla wystąpienia zarządzanego. ciąg
timezoneId Identyfikator strefy czasowej. Dozwolone wartości to strefy czasowe obsługiwane przez system Windows.
Windows przechowuje szczegóły dotyczące obsługiwanych stref czasowych, w tym identyfikator, w rejestrze w sekcji
KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones.
Te wartości rejestru można uzyskać za pośrednictwem programu SQL Server, wykonując zapytanie SELECT name AS timezone_id FROM sys.time_zone_info.
Listę identyfikatorów można również uzyskać, wykonując polecenie [System.TimeZoneInfo]::GetSystemTimeZones() w programie PowerShell.
Przykładem prawidłowego identyfikatora strefy czasowej jest "Czas standardowy pacyficzny" lub "W. Europa (czas standardowy).
ciąg
vCores Liczba rdzeni wirtualnych. Dozwolone wartości: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Obsługiwane rdzenie wirtualne zależą od wybranej rodziny sprzętu i warstwy usług. int
zoneNadmiarowy Czy nadmiarowość strefy jest włączona. bool

Identyfikator zasobu

Name Description Value
typ Typ tożsamości. Ustaw wartość "SystemAssigned", aby automatycznie utworzyć i przypisać jednostkę usługi Azure Active Directory dla zasobu. "Brak"
"SystemAssigned"
"SystemAssigned,UserAssigned"
'UserAssigned'
userAssignedIdentities Identyfikatory zasobów tożsamości przypisanych przez użytkownika do użycia ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Name Description Value

ServicePrincipal

Name Description Value
typ Typ jednostki usługi. "Brak"
"SystemAssigned"

Sku

Name Description Value
dyspozycyjność Pojemność określonej jednostki SKU. int
family Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj. ciąg
nazwa Nazwa jednostki SKU, zazwyczaj, litera + kod liczbowy, np. P3. ciąg znaków (wymagane)
size Rozmiar konkretnej jednostki SKU ciąg
warstwa Warstwa lub wersja konkretnej jednostki SKU, np. Podstawowa, Premium. ciąg

Śledzone tagi zasobów

Name Description Value

UserIdentity

Name Description Value

Definicja zasobu szablonu usługi ARM

Typ zasobu managedInstances można wdrożyć przy użyciu operacji docelowych:

Przykłady użycia

Szablony szybkiego startu platformy Azure

Następujące szablony szybkiego startu platformy Azure wdrożyć ten typ zasobu.

Template Description
Tworzenie wystąpienia zarządzanego SQL w nowej sieci wirtualnej

Wdrażanie na platformie Azure
Wdróż wystąpienie zarządzane usługi Azure Sql Database (SQL MI) w nowej sieci wirtualnej.
Tworzenie wystąpienia zarządzanego SQL ze skonfigurowanym wysyłaniem dzienników i metryk

Wdrażanie na platformie Azure
Ten szablon umożliwia wdrożenie wystąpienia zarządzanego SQL i dodatkowych zasobów używanych do przechowywania dzienników i metryk (obszar roboczy diagnostyczny, konto magazynu, centrum zdarzeń).
Tworzenie wystąpienia zarządzanego SQL za pomocą serwera przesiadkowego w nowej sieci wirtualnej

Wdrażanie na platformie Azure
Wdrażanie wystąpienia zarządzanego usługi Azure Sql Database (SQL MI) i serwera JumpBox za pomocą programu SSMS w nowej sieci wirtualnej.
tworzenie wystąpienia zarządzanego SQL przy użyciu połączenia punkt-lokacja skonfigurowanego

Wdrażanie na platformie Azure
Wdróż wystąpienie zarządzane usługi Azure Sql Database (SQL MI) i bramę sieci wirtualnej skonfigurowaną na potrzeby połączenia punkt-lokacja w nowej sieci wirtualnej.
Wdrażaj SQL Managed Instance z Networking

Wdrażanie na platformie Azure
Wdroż UDR i NSG do obsługi Azure SQL Managed Instance oraz wdroż Managed Instance

Format zasobu

By stworzyć Microsoft. Zasoby Sql/ManagedInstances, dodaj do szablonu następujący JSON.

{
  "type": "Microsoft.Sql/managedInstances",
  "apiVersion": "2026-08-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"
  }
}

Wartości właściwości

Microsoft.Sql/managedInstances

Name Description Value
apiVersion (wersja interfejsu api) Wersja interfejsu API 'Zapowiedź 2026-08-01'
tożsamość Tożsamość usługi Azure Active Directory wystąpienia zarządzanego. ResourceIdentity
lokalizacja Lokalizacja geograficzna, w której znajduje się zasób ciąg znaków (wymagane)
nazwa Nazwa zasobu ciąg znaków (wymagane)
properties Właściwości zasobu. ManagedInstanceProperties
sku Jednostka SKU wystąpienia zarządzanego. Dopuszczalne wartości dla sku.name: GP_Gen5 (ogólnego przeznaczenia, seria standardowa); GP_G8IM (ogólnego przeznaczenia, seria Premium); GP_G8IH (ogólnego przeznaczenia, zoptymalizowana pod kątem pamięci serii Premium); BC_Gen5 (Krytyczne dla biznesu, Standard-Series); BC_G8IM (Krytyczne dla firmy, seria Premium); BC_G8IH (Krytyczne dla działania firmy, zoptymalizowane pod kątem pamięci serii Premium). Sku
tags Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach
typ Typ zasobu 'Microsoft. Sql/managedInstances'

ManagedInstanceExternalAdministrator

Name Description Value
administratorType Typ administratora serwera. "ActiveDirectory"
azureADOnlyAuthentication Włączono tylko uwierzytelnianie usługi Azure Active Directory. bool
login Nazwa logowania administratora serwera. ciąg
principalType Typ podmiotu zabezpieczeń administratora serwera. 'Application'
"Grupuj"
'User'
sid Identyfikator SID (identyfikator obiektu) administratora serwera. string

Ograniczenia:
Minimalna długość = 36
Maksymalna długość = 36
Wzorzec = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
tenantId Identyfikator dzierżawy administratora. string

Ograniczenia:
Minimalna długość = 36
Maksymalna długość = 36
Wzorzec = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$

ManagedInstanceProperties

Name Description Value
administratorZaloguj się Nazwa użytkownika administratora dla wystąpienia zarządzanego. Można określić tylko wtedy, gdy wystąpienie zarządzane jest tworzone (i jest wymagane do utworzenia). ciąg
hasłoLogowaniaAdministratora Hasło logowania administratora (wymagane do utworzenia wystąpienia zarządzanego). string

Ograniczenia:
Wartość wrażliwa. Przekaż jako bezpieczny parametr.
administrators Administrator Azure Active Directory może być używany podczas tworzenia instancji oraz aktualizacji instancji, z wyjątkiem właściwości azureADOnlyAuthentication. Aby zaktualizować właściwość azureADOnlyAuthentication, należy użyć indywidualnego interfejsu API. ManagedInstanceExternalAdministrator
authenticationMetadata Tryb wyszukiwania metadanych uwierzytelniania wystąpienia zarządzanego. 'AzureAD'
'Paired'
'Windows'
sortowanie Sortowanie wystąpienia zarządzanego. ciąg
databaseFormat Określa wewnętrzny format baz danych wystąpień specyficzny dla wersji aparatu SQL. 'AlwaysUpToDate'
'SQLServer2022'
'SQLServer2025' (SQLServer2025)
dnsZonePartner Identyfikator zasobu innego wystąpienia zarządzanego, którego strefa DNS będzie współużytkowała to wystąpienie zarządzane po utworzeniu. ciąg
hybridSecondaryUsage Użycie pomocnicze hybrydowe. Możliwe wartości to "Aktywne" (wartość domyślna) i "Pasywne" (klient używa pomocniczego jako pasywnego odzyskiwania po awarii). "Aktywne"
'Passive'
instancePoolId Identyfikator puli wystąpień, do którego należy ten serwer zarządzany. ciąg
isGeneralPurposeV2 Niezależnie od tego, czy jest to wariant GPv2 wersji Ogólnego przeznaczenia. bool
keyId (identyfikator klucza) Identyfikator URI klucza cmK do użycia na potrzeby szyfrowania. ciąg
licenseType Typ licencji. Możliwe wartości to "LicenseIncluded" (zwykła cena włącznie z nową licencją SQL) i "BasePrice" (obniżona cena AHB za wprowadzenie własnych licencji SQL). 'BasePrice'
"LicenseIncluded"
maintenanceConfigurationId Określa identyfikator konfiguracji konserwacji, który ma być stosowany do tego wystąpienia zarządzanego. ciąg
managedInstanceCreateMode Określa tryb tworzenia bazy danych.

Ustawienie domyślne: Regularne tworzenie wystąpienia.

Przywracanie: tworzy wystąpienie, przywracając zestaw kopii zapasowych do określonego punktu w czasie. Należy określić wartości RestorePointInTime i SourceManagedInstanceId.
'Default'
"PointInTimeRestore"
memorySizeInGB Rozmiar pamięci w GB. Wartość minimalna: 28. Wartość maksymalna: 870. Wartość minimalna i maksymalna zależy od liczby rdzeni wirtualnych i warstwy usługi. Więcej informacji na temat limitów zasobów można znaleźć tutaj: https://aka.ms/mi-resource-limits-api. int
minimalTlsVersion (wersja minimalTls) Minimalna wersja protokołu TLS. Dozwolone wartości: "None", "1.0", "1.1", "1.2" ciąg
pricingModel Model wyceny Managed Instance. 'Freemium'
'Regular'
primaryUserAssignedIdentityId Identyfikator zasobu tożsamości przypisanej przez użytkownika domyślnie używany. ciąg
proxyOverride Typ połączenia używany do nawiązywania połączenia z wystąpieniem. 'Default'
'Proxy'
'Redirect'
publicDataEndpointEnabled Określa, czy publiczny punkt końcowy danych jest włączony. bool
requestedBackupStorageRedundancy Typ konta magazynu, który ma być używany do przechowywania kopii zapasowych dla tego wystąpienia. Dostępne opcje to LocallyRedundantStorage, Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) i GeoZone(GeoZoneRedundantStorage) "Geo"
'GeoZone'
"Lokalny"
"Strefa"
requestedLogicalAvailabilityZone Określa logiczną strefę dostępności, do której przypięty jest Managed Instance. '1'
'2'
'3'
"NoPreference"
restorePointInTime Określa punkt w czasie (ISO8601 format) źródłowej bazy danych, która zostanie przywrócona w celu utworzenia nowej bazy danych. ciąg
servicePrincipal (jednostka usługi) Jednostka usługi wystąpienia zarządzanego. ServicePrincipal (jednostka usługi)
sourceManagedInstanceId Identyfikator zasobu źródłowego wystąpienia zarządzanego skojarzonego z operacją tworzenia tego wystąpienia. ciąg
storageIOps Operacje we/wy na sekundę magazynu. Wartość minimalna: 300. Wartość maksymalna: 80000. Liczba operacji we/wy na sekundę jest 1 dozwolona. Maksymalna wartość zależy od wybranej rodziny sprzętu i liczby rdzeni wirtualnych. int
storageSizeInGB Rozmiar magazynu w GB. Wartość minimalna: 32. Wartość maksymalna: 32768. Liczba dozwolonych przyrostów 32 GB. Maksymalna wartość zależy od wybranej rodziny sprzętu i liczby rdzeni wirtualnych. int
storageThroughputMBps Parametr MBps przepływności magazynu nie jest obsługiwany w operacji tworzenia/aktualizowania wystąpienia. int
subnetId Identyfikator zasobu podsieci dla wystąpienia zarządzanego. ciąg
timezoneId Identyfikator strefy czasowej. Dozwolone wartości to strefy czasowe obsługiwane przez system Windows.
Windows przechowuje szczegóły dotyczące obsługiwanych stref czasowych, w tym identyfikator, w rejestrze w sekcji
KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones.
Te wartości rejestru można uzyskać za pośrednictwem programu SQL Server, wykonując zapytanie SELECT name AS timezone_id FROM sys.time_zone_info.
Listę identyfikatorów można również uzyskać, wykonując polecenie [System.TimeZoneInfo]::GetSystemTimeZones() w programie PowerShell.
Przykładem prawidłowego identyfikatora strefy czasowej jest "Czas standardowy pacyficzny" lub "W. Europa (czas standardowy).
ciąg
vCores Liczba rdzeni wirtualnych. Dozwolone wartości: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Obsługiwane rdzenie wirtualne zależą od wybranej rodziny sprzętu i warstwy usług. int
zoneNadmiarowy Czy nadmiarowość strefy jest włączona. bool

Identyfikator zasobu

Name Description Value
typ Typ tożsamości. Ustaw wartość "SystemAssigned", aby automatycznie utworzyć i przypisać jednostkę usługi Azure Active Directory dla zasobu. "Brak"
"SystemAssigned"
"SystemAssigned,UserAssigned"
'UserAssigned'
userAssignedIdentities Identyfikatory zasobów tożsamości przypisanych przez użytkownika do użycia ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Name Description Value

ServicePrincipal

Name Description Value
typ Typ jednostki usługi. "Brak"
"SystemAssigned"

Sku

Name Description Value
dyspozycyjność Pojemność określonej jednostki SKU. int
family Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj. ciąg
nazwa Nazwa jednostki SKU, zazwyczaj, litera + kod liczbowy, np. P3. ciąg znaków (wymagane)
size Rozmiar konkretnej jednostki SKU ciąg
warstwa Warstwa lub wersja konkretnej jednostki SKU, np. Podstawowa, Premium. ciąg

Śledzone tagi zasobów

Name Description Value

UserIdentity

Name Description Value

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu managedInstances można wdrożyć przy użyciu operacji docelowych:

  • Grupy zasobów Listę zmienionych właściwości w każdej wersji API można znaleźć w dzienniku zmian.

Przykłady użycia

Moduły zweryfikowane na platformie Azure

Następujące moduły zweryfikowane platformy Azure mogą służyć do wdrażania tego typu zasobu.

Moduł Description
SQL Managed Instance Moduł zasobów AVM dla SQL Managed Instance

Format zasobu

By stworzyć Microsoft. Zasoby Sql/managedInstances, dodaj następujący Terraform do swojego szablonu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/managedInstances@2026-08-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"
    }
  }
}

Wartości właściwości

Microsoft.Sql/managedInstances

Name Description Value
tożsamość Tożsamość usługi Azure Active Directory wystąpienia zarządzanego. ResourceIdentity
lokalizacja Lokalizacja geograficzna, w której znajduje się zasób ciąg znaków (wymagane)
nazwa Nazwa zasobu ciąg znaków (wymagane)
properties Właściwości zasobu. ManagedInstanceProperties
sku Jednostka SKU wystąpienia zarządzanego. Dopuszczalne wartości dla sku.name: GP_Gen5 (ogólnego przeznaczenia, seria standardowa); GP_G8IM (ogólnego przeznaczenia, seria Premium); GP_G8IH (ogólnego przeznaczenia, zoptymalizowana pod kątem pamięci serii Premium); BC_Gen5 (Krytyczne dla biznesu, Standard-Series); BC_G8IM (Krytyczne dla firmy, seria Premium); BC_G8IH (Krytyczne dla działania firmy, zoptymalizowane pod kątem pamięci serii Premium). Sku
tags Tagi zasobów Słownik nazw tagów i wartości.
typ Typ zasobu "Microsoft. Sql/managedInstances@2026-08-01-preview"

ManagedInstanceExternalAdministrator

Name Description Value
administratorType Typ administratora serwera. "ActiveDirectory"
azureADOnlyAuthentication Włączono tylko uwierzytelnianie usługi Azure Active Directory. bool
login Nazwa logowania administratora serwera. ciąg
principalType Typ podmiotu zabezpieczeń administratora serwera. 'Application'
"Grupuj"
'User'
sid Identyfikator SID (identyfikator obiektu) administratora serwera. string

Ograniczenia:
Minimalna długość = 36
Maksymalna długość = 36
Wzorzec = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
tenantId Identyfikator dzierżawy administratora. string

Ograniczenia:
Minimalna długość = 36
Maksymalna długość = 36
Wzorzec = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$

ManagedInstanceProperties

Name Description Value
administratorZaloguj się Nazwa użytkownika administratora dla wystąpienia zarządzanego. Można określić tylko wtedy, gdy wystąpienie zarządzane jest tworzone (i jest wymagane do utworzenia). ciąg
hasłoLogowaniaAdministratora Hasło logowania administratora (wymagane do utworzenia wystąpienia zarządzanego). string

Ograniczenia:
Wartość wrażliwa. Przekaż jako bezpieczny parametr.
administrators Administrator Azure Active Directory może być używany podczas tworzenia instancji oraz aktualizacji instancji, z wyjątkiem właściwości azureADOnlyAuthentication. Aby zaktualizować właściwość azureADOnlyAuthentication, należy użyć indywidualnego interfejsu API. ManagedInstanceExternalAdministrator
authenticationMetadata Tryb wyszukiwania metadanych uwierzytelniania wystąpienia zarządzanego. 'AzureAD'
'Paired'
'Windows'
sortowanie Sortowanie wystąpienia zarządzanego. ciąg
databaseFormat Określa wewnętrzny format baz danych wystąpień specyficzny dla wersji aparatu SQL. 'AlwaysUpToDate'
'SQLServer2022'
'SQLServer2025' (SQLServer2025)
dnsZonePartner Identyfikator zasobu innego wystąpienia zarządzanego, którego strefa DNS będzie współużytkowała to wystąpienie zarządzane po utworzeniu. ciąg
hybridSecondaryUsage Użycie pomocnicze hybrydowe. Możliwe wartości to "Aktywne" (wartość domyślna) i "Pasywne" (klient używa pomocniczego jako pasywnego odzyskiwania po awarii). "Aktywne"
'Passive'
instancePoolId Identyfikator puli wystąpień, do którego należy ten serwer zarządzany. ciąg
isGeneralPurposeV2 Niezależnie od tego, czy jest to wariant GPv2 wersji Ogólnego przeznaczenia. bool
keyId (identyfikator klucza) Identyfikator URI klucza cmK do użycia na potrzeby szyfrowania. ciąg
licenseType Typ licencji. Możliwe wartości to "LicenseIncluded" (zwykła cena włącznie z nową licencją SQL) i "BasePrice" (obniżona cena AHB za wprowadzenie własnych licencji SQL). 'BasePrice'
"LicenseIncluded"
maintenanceConfigurationId Określa identyfikator konfiguracji konserwacji, który ma być stosowany do tego wystąpienia zarządzanego. ciąg
managedInstanceCreateMode Określa tryb tworzenia bazy danych.

Ustawienie domyślne: Regularne tworzenie wystąpienia.

Przywracanie: tworzy wystąpienie, przywracając zestaw kopii zapasowych do określonego punktu w czasie. Należy określić wartości RestorePointInTime i SourceManagedInstanceId.
'Default'
"PointInTimeRestore"
memorySizeInGB Rozmiar pamięci w GB. Wartość minimalna: 28. Wartość maksymalna: 870. Wartość minimalna i maksymalna zależy od liczby rdzeni wirtualnych i warstwy usługi. Więcej informacji na temat limitów zasobów można znaleźć tutaj: https://aka.ms/mi-resource-limits-api. int
minimalTlsVersion (wersja minimalTls) Minimalna wersja protokołu TLS. Dozwolone wartości: "None", "1.0", "1.1", "1.2" ciąg
pricingModel Model wyceny Managed Instance. 'Freemium'
'Regular'
primaryUserAssignedIdentityId Identyfikator zasobu tożsamości przypisanej przez użytkownika domyślnie używany. ciąg
proxyOverride Typ połączenia używany do nawiązywania połączenia z wystąpieniem. 'Default'
'Proxy'
'Redirect'
publicDataEndpointEnabled Określa, czy publiczny punkt końcowy danych jest włączony. bool
requestedBackupStorageRedundancy Typ konta magazynu, który ma być używany do przechowywania kopii zapasowych dla tego wystąpienia. Dostępne opcje to LocallyRedundantStorage, Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) i GeoZone(GeoZoneRedundantStorage) "Geo"
'GeoZone'
"Lokalny"
"Strefa"
requestedLogicalAvailabilityZone Określa logiczną strefę dostępności, do której przypięty jest Managed Instance. '1'
'2'
'3'
"NoPreference"
restorePointInTime Określa punkt w czasie (ISO8601 format) źródłowej bazy danych, która zostanie przywrócona w celu utworzenia nowej bazy danych. ciąg
servicePrincipal (jednostka usługi) Jednostka usługi wystąpienia zarządzanego. ServicePrincipal (jednostka usługi)
sourceManagedInstanceId Identyfikator zasobu źródłowego wystąpienia zarządzanego skojarzonego z operacją tworzenia tego wystąpienia. ciąg
storageIOps Operacje we/wy na sekundę magazynu. Wartość minimalna: 300. Wartość maksymalna: 80000. Liczba operacji we/wy na sekundę jest 1 dozwolona. Maksymalna wartość zależy od wybranej rodziny sprzętu i liczby rdzeni wirtualnych. int
storageSizeInGB Rozmiar magazynu w GB. Wartość minimalna: 32. Wartość maksymalna: 32768. Liczba dozwolonych przyrostów 32 GB. Maksymalna wartość zależy od wybranej rodziny sprzętu i liczby rdzeni wirtualnych. int
storageThroughputMBps Parametr MBps przepływności magazynu nie jest obsługiwany w operacji tworzenia/aktualizowania wystąpienia. int
subnetId Identyfikator zasobu podsieci dla wystąpienia zarządzanego. ciąg
timezoneId Identyfikator strefy czasowej. Dozwolone wartości to strefy czasowe obsługiwane przez system Windows.
Windows przechowuje szczegóły dotyczące obsługiwanych stref czasowych, w tym identyfikator, w rejestrze w sekcji
KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones.
Te wartości rejestru można uzyskać za pośrednictwem programu SQL Server, wykonując zapytanie SELECT name AS timezone_id FROM sys.time_zone_info.
Listę identyfikatorów można również uzyskać, wykonując polecenie [System.TimeZoneInfo]::GetSystemTimeZones() w programie PowerShell.
Przykładem prawidłowego identyfikatora strefy czasowej jest "Czas standardowy pacyficzny" lub "W. Europa (czas standardowy).
ciąg
vCores Liczba rdzeni wirtualnych. Dozwolone wartości: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Obsługiwane rdzenie wirtualne zależą od wybranej rodziny sprzętu i warstwy usług. int
zoneNadmiarowy Czy nadmiarowość strefy jest włączona. bool

Identyfikator zasobu

Name Description Value
typ Typ tożsamości. Ustaw wartość "SystemAssigned", aby automatycznie utworzyć i przypisać jednostkę usługi Azure Active Directory dla zasobu. "Brak"
"SystemAssigned"
"SystemAssigned,UserAssigned"
'UserAssigned'
userAssignedIdentities Identyfikatory zasobów tożsamości przypisanych przez użytkownika do użycia ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Name Description Value

ServicePrincipal

Name Description Value
typ Typ jednostki usługi. "Brak"
"SystemAssigned"

Sku

Name Description Value
dyspozycyjność Pojemność określonej jednostki SKU. int
family Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj. ciąg
nazwa Nazwa jednostki SKU, zazwyczaj, litera + kod liczbowy, np. P3. ciąg znaków (wymagane)
size Rozmiar konkretnej jednostki SKU ciąg
warstwa Warstwa lub wersja konkretnej jednostki SKU, np. Podstawowa, Premium. ciąg

Śledzone tagi zasobów

Name Description Value

UserIdentity

Name Description Value