Microsoft. Sql managedInstances

Definicja zasobu Bicepsa

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

grupy zasobów — zobacz polecenia wdrażania grupy zasobów

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

Format zasobu

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

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'
  }
}

Wartości właściwości

Microsoft. Sql/managedInstances

Name	Description	Value
tożsamość	Tożsamość Azure Active Directory zarządzanej instancji.	ResourceIdentity
lokalizacja	Lokalizacja geograficzna, w której znajduje się zasób	ciąg (wymagany)
name	Nazwa zasobu	ciąg (wymagany)
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	Azure Active Directory tylko uwierzytelnianie włączone.	bool
login	Nazwa logowania administratora serwera.	ciąg
principalType	Typ podmiotu zabezpieczeń administratora serwera.	'Application' 'Group' 'User'
sid	Identyfikator SID (identyfikator obiektu) administratora serwera.	string Constraints: 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 Constraints: 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
administratorLogin	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
administratorLoginPassword	Hasło logowania administratora (wymagane do utworzenia wystąpienia zarządzanego).	string Constraints: 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).	'Active' '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 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	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' 'Local' 'Zone'
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 wystąpienia zarządzanego.	ServicePrincipal
sourceManagedInstanceId	Identyfikator zasobu źródłowego wystąpienia zarządzanego skojarzonego z operacją tworzenia tego wystąpienia.	ciąg
storageIOps	Operacje we/wy pamięci masowej. 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 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. Wartości rejestru można uzyskać przez SQL Server, zapytując 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
zoneRedundant	Czy nadmiarowość strefy jest włączona.	bool

ResourceIdentity

Name	Description	Value
typ	Typ tożsamości. Ustaw to na 'SystemAssigned', aby automatycznie utworzyć i przypisać zasadę Azure Active Directory dla zasobu.	'None' '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.	'None' '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
name	Nazwa jednostki SKU, zazwyczaj, litera + kod liczbowy, np. P3.	ciąg (wymagany)
size	Rozmiar konkretnej jednostki SKU	ciąg
warstwa	Warstwa lub wersja konkretnej jednostki SKU, np. Podstawowa, Premium.	ciąg

TrackedResourceTags

Name	Description	Value

UserIdentity

Name	Description	Value

Przykłady użycia

Moduły zweryfikowane na platformie Azure

Następujące Azure Zweryfikowane moduły mogą być użyte do wdrażania tego typu zasobu.

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

Przykłady szybkiego startu platformy Azure

Następujące szablony szybkiego startu Azure Quickstart zawierają Bicep przykłady do wdrażania tego typu zasobu.

Plik Bicep	Description
Stwórz SQL MI w nowej sieci wirtualnej	Wdrażaj Azure Sql Database Managed Instance (SQL MI) w nowej Virtual Network.

Definicja zasobu szablonu usługi ARM

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

grupy zasobów — zobacz polecenia wdrażania grupy zasobów

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

Format zasobu

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

{
  "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"
  }
}

Wartości właściwości

Microsoft. Sql/managedInstances

Name	Description	Value
apiVersion	Wersja interfejsu API	"2025-02-01-preview"
tożsamość	Tożsamość Azure Active Directory zarządzanej instancji.	ResourceIdentity
lokalizacja	Lokalizacja geograficzna, w której znajduje się zasób	ciąg (wymagany)
name	Nazwa zasobu	ciąg (wymagany)
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	Azure Active Directory tylko uwierzytelnianie włączone.	bool
login	Nazwa logowania administratora serwera.	ciąg
principalType	Typ podmiotu zabezpieczeń administratora serwera.	'Application' 'Group' 'User'
sid	Identyfikator SID (identyfikator obiektu) administratora serwera.	string Constraints: 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 Constraints: 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
administratorLogin	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
administratorLoginPassword	Hasło logowania administratora (wymagane do utworzenia wystąpienia zarządzanego).	string Constraints: 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).	'Active' '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 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	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' 'Local' 'Zone'
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 wystąpienia zarządzanego.	ServicePrincipal
sourceManagedInstanceId	Identyfikator zasobu źródłowego wystąpienia zarządzanego skojarzonego z operacją tworzenia tego wystąpienia.	ciąg
storageIOps	Operacje we/wy pamięci masowej. 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 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. Wartości rejestru można uzyskać przez SQL Server, zapytując 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
zoneRedundant	Czy nadmiarowość strefy jest włączona.	bool

ResourceIdentity

Name	Description	Value
typ	Typ tożsamości. Ustaw to na 'SystemAssigned', aby automatycznie utworzyć i przypisać zasadę Azure Active Directory dla zasobu.	'None' '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.	'None' '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
name	Nazwa jednostki SKU, zazwyczaj, litera + kod liczbowy, np. P3.	ciąg (wymagany)
size	Rozmiar konkretnej jednostki SKU	ciąg
warstwa	Warstwa lub wersja konkretnej jednostki SKU, np. Podstawowa, Premium.	ciąg

TrackedResourceTags

Name	Description	Value

UserIdentity

Name	Description	Value

Przykłady użycia

Szablony szybkiego startu platformy Azure

Następujące Azure szablony szybkiego startu wdrażają ten typ zasobu.

Template	Description
Stwórz SQL MI w nowej sieci wirtualnej	Wdrażaj Azure Sql Database Managed Instance (SQL MI) w nowej Virtual Network.
Stwórz SQL MI z skonfigurowanym wysyłaniem logów i metryk	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ń).
Stwórz SQL MI za pomocą jumpboxa w nowej sieci wirtualnej	Wdrożenie Azure SQL Database Managed Instance (SQL MI) oraz JumpBox z SSMS w nowej Virtual Network.
Create SQL MI z konfiguracją połączenia punkt-to-site	Wdroż Azure SQL Database Managed Instance (SQL MI) oraz bramę sieci wirtualnej, skonfigurowane do połączenia punkt-miejsce w nowej sieci wirtualnej.
Wdrażaj SQL Managed Instance z Networking	Wdroż UDR i NSG do obsługi Azure SQL Managed Instance oraz wdroż Managed Instance

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

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

Grupy zasobów

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

Format zasobu

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

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"
    }
  }
}

Wartości właściwości

Microsoft. Sql/managedInstances

Name	Description	Value
tożsamość	Tożsamość Azure Active Directory zarządzanej instancji.	ResourceIdentity
lokalizacja	Lokalizacja geograficzna, w której znajduje się zasób	ciąg (wymagany)
name	Nazwa zasobu	ciąg (wymagany)
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@2025-02-01-preview"

ManagedInstanceExternalAdministrator

Name	Description	Value
administratorType	Typ administratora serwera.	'ActiveDirectory'
azureADOnlyAuthentication	Azure Active Directory tylko uwierzytelnianie włączone.	bool
login	Nazwa logowania administratora serwera.	ciąg
principalType	Typ podmiotu zabezpieczeń administratora serwera.	'Application' 'Group' 'User'
sid	Identyfikator SID (identyfikator obiektu) administratora serwera.	string Constraints: 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 Constraints: 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
administratorLogin	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
administratorLoginPassword	Hasło logowania administratora (wymagane do utworzenia wystąpienia zarządzanego).	string Constraints: 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).	'Active' '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 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	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' 'Local' 'Zone'
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 wystąpienia zarządzanego.	ServicePrincipal
sourceManagedInstanceId	Identyfikator zasobu źródłowego wystąpienia zarządzanego skojarzonego z operacją tworzenia tego wystąpienia.	ciąg
storageIOps	Operacje we/wy pamięci masowej. 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 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. Wartości rejestru można uzyskać przez SQL Server, zapytując 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
zoneRedundant	Czy nadmiarowość strefy jest włączona.	bool

ResourceIdentity

Name	Description	Value
typ	Typ tożsamości. Ustaw to na 'SystemAssigned', aby automatycznie utworzyć i przypisać zasadę Azure Active Directory dla zasobu.	'None' '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.	'None' '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
name	Nazwa jednostki SKU, zazwyczaj, litera + kod liczbowy, np. P3.	ciąg (wymagany)
size	Rozmiar konkretnej jednostki SKU	ciąg
warstwa	Warstwa lub wersja konkretnej jednostki SKU, np. Podstawowa, Premium.	ciąg

TrackedResourceTags

Name	Description	Value

UserIdentity

Name	Description	Value

Przykłady użycia

Moduły zweryfikowane na platformie Azure

Następujące Azure Zweryfikowane moduły mogą być użyte do wdrażania tego typu zasobu.

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

Opinia

Czy ta strona była pomocna?

Last updated on 2026-04-14

Microsoft. Sql managedInstances

Definicja zasobu Bicepsa

Format zasobu

Wartości właściwości

Microsoft. Sql/managedInstances

ManagedInstanceExternalAdministrator

ManagedInstanceProperties

ResourceIdentity

ResourceIdentityUserAssignedIdentities

ServicePrincipal

Sku

TrackedResourceTags

UserIdentity

Przykłady użycia

Moduły zweryfikowane na platformie Azure

Przykłady szybkiego startu platformy Azure

Definicja zasobu szablonu usługi ARM

Format zasobu

Wartości właściwości

Microsoft. Sql/managedInstances

ManagedInstanceExternalAdministrator

ManagedInstanceProperties

ResourceIdentity

ResourceIdentityUserAssignedIdentities

ServicePrincipal

Sku

TrackedResourceTags

UserIdentity

Przykłady użycia

Szablony szybkiego startu platformy Azure

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Format zasobu

Wartości właściwości

Microsoft. Sql/managedInstances

ManagedInstanceExternalAdministrator

ManagedInstanceProperties

ResourceIdentity

ResourceIdentityUserAssignedIdentities

ServicePrincipal

Sku

TrackedResourceTags

UserIdentity

Przykłady użycia

Moduły zweryfikowane na platformie Azure

Opinia

Dodatkowe zasoby