Microsoft.Sql ManagedInstances 2024-05-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.

Format zasobu

Aby utworzyć zasób Microsoft.Sql/managedInstances, dodaj następujący kod Bicep do szablonu.

resource symbolicname 'Microsoft.Sql/managedInstances@2024-05-01-preview' = {
  scope: resourceSymbolicName or scope
  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'
    minimalTlsVersion: 'string'
    pricingModel: 'string'
    primaryUserAssignedIdentityId: 'string'
    proxyOverride: 'string'
    publicDataEndpointEnabled: bool
    requestedBackupStorageRedundancy: 'string'
    restorePointInTime: 'string'
    servicePrincipal: {
      type: 'string'
    }
    sourceManagedInstanceId: 'string'
    storageIOps: int
    storageSizeInGB: int
    storageThroughputMBps: int
    subnetId: 'string'
    timezoneId: 'string'
    totalMemoryMB: int
    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 zasobu.	ciąg (wymagany)
name	Nazwa zasobu	ciąg (wymagany)
properties	Właściwości zasobu.	ManagedInstanceProperties
zakres	Użyj polecenia podczas tworzenia zasobu w zakresie innym niż zakres wdrożenia.	Ustaw tę właściwość na symboliczną nazwę zasobu, aby zastosować zasób rozszerzenia.
sku	Jednostka SKU wystąpienia zarządzanego. Dozwolone wartości sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH	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' '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 wystąpienia usługi Azure Active Directory. Można go używać tylko w czasie tworzenia wystąpienia. Jeśli jest używana do aktualizacji wystąpienia, zostanie ona zignorowana lub spowoduje błąd. W przypadku aktualizacji należy użyć poszczególnych interfejsów 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'
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'
minimalTlsVersion	Minimalna wersja protokołu TLS. Dozwolone wartości: "None", "1.0", "1.1", "1.2"	ciąg
pricingModel	Model cen wystąpienia zarządzanego.	'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'
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: 16384. 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. System Windows przechowuje szczegółowe informacje na temat obsługiwanych stref czasowych, w tym identyfikatora, w rejestrze w obszarze KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Strefy czasowe. 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
totalMemoryMB	Łączna ilość pamięci w MB. Wartość minimalna: 7168. Wartość maksymalna: 891328. Liczba dozwolonych przyrostów wynoszących tylko 1 MB. Maksymalna wartość zależy od wybranej rodziny sprzętu i liczby rdzeni wirtualnych.	int
vCores	Liczba rdzeni wirtualnych. Dozwolone wartości: 8, 16, 24, 32, 40, 64, 80.	int
zoneRedundant	Określa, czy włączono funkcję multi-az.	bool

ResourceIdentity

Name	Description	Value
typ	Typ tożsamości. Ustaw wartość "SystemAssigned", aby automatycznie utworzyć i przypisać jednostkę usługi 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 moduły zweryfikowane platformy Azure mogą służyć do wdrażania tego typu zasobu.

Module	Description
Zarządzana instancja SQL	Moduł zasobów AVM dla usługi 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.

Definicja zasobu szablonu usługi ARM

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.

Format zasobu

Aby utworzyć zasób Microsoft.Sql/managedInstances, dodaj następujący kod JSON do szablonu.

{
  "type": "Microsoft.Sql/managedInstances",
  "apiVersion": "2024-05-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",
    "minimalTlsVersion": "string",
    "pricingModel": "string",
    "primaryUserAssignedIdentityId": "string",
    "proxyOverride": "string",
    "publicDataEndpointEnabled": "bool",
    "requestedBackupStorageRedundancy": "string",
    "restorePointInTime": "string",
    "servicePrincipal": {
      "type": "string"
    },
    "sourceManagedInstanceId": "string",
    "storageIOps": "int",
    "storageSizeInGB": "int",
    "storageThroughputMBps": "int",
    "subnetId": "string",
    "timezoneId": "string",
    "totalMemoryMB": "int",
    "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	'2024-05-01-preview'
tożsamość	Tożsamość usługi Azure Active Directory wystąpienia zarządzanego.	ResourceIdentity
lokalizacja	Lokalizacja zasobu.	ciąg (wymagany)
name	Nazwa zasobu	ciąg (wymagany)
properties	Właściwości zasobu.	ManagedInstanceProperties
sku	Jednostka SKU wystąpienia zarządzanego. Dozwolone wartości sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH	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' '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 wystąpienia usługi Azure Active Directory. Można go używać tylko w czasie tworzenia wystąpienia. Jeśli jest używana do aktualizacji wystąpienia, zostanie ona zignorowana lub spowoduje błąd. W przypadku aktualizacji należy użyć poszczególnych interfejsów 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'
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'
minimalTlsVersion	Minimalna wersja protokołu TLS. Dozwolone wartości: "None", "1.0", "1.1", "1.2"	ciąg
pricingModel	Model cen wystąpienia zarządzanego.	'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'
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: 16384. 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. System Windows przechowuje szczegółowe informacje na temat obsługiwanych stref czasowych, w tym identyfikatora, w rejestrze w obszarze KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Strefy czasowe. 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
totalMemoryMB	Łączna ilość pamięci w MB. Wartość minimalna: 7168. Wartość maksymalna: 891328. Liczba dozwolonych przyrostów wynoszących tylko 1 MB. Maksymalna wartość zależy od wybranej rodziny sprzętu i liczby rdzeni wirtualnych.	int
vCores	Liczba rdzeni wirtualnych. Dozwolone wartości: 8, 16, 24, 32, 40, 64, 80.	int
zoneRedundant	Określa, czy włączono funkcję multi-az.	bool

ResourceIdentity

Name	Description	Value
typ	Typ tożsamości. Ustaw wartość "SystemAssigned", aby automatycznie utworzyć i przypisać jednostkę usługi 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 szablony szybkiego startu platformy Azure wdrożyć ten typ zasobu.

Template	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.
Tworzenie wystąpienia zarządzanego SQL ze skonfigurowanym wysyłaniem dziennikó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ń).
Tworzenie wystąpienia zarządzanego SQL za pomocą serwera przesiadkowego w nowej sieci wirtualnej	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	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żanie wystąpienia zarządzanego SQL przy użyciu sieci	Wdrażanie trasy zdefiniowanej przez użytkownika i sieciowej grupy zabezpieczeń w celu obsługi usługi Azure SQL Managed Instance i wdrażania wystąpienia zarządzanego

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

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.

Format zasobu

Aby utworzyć zasób Microsoft.Sql/managedInstances, dodaj następujący program Terraform do szablonu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/managedInstances@2024-05-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"
      minimalTlsVersion = "string"
      pricingModel = "string"
      primaryUserAssignedIdentityId = "string"
      proxyOverride = "string"
      publicDataEndpointEnabled = bool
      requestedBackupStorageRedundancy = "string"
      restorePointInTime = "string"
      servicePrincipal = {
        type = "string"
      }
      sourceManagedInstanceId = "string"
      storageIOps = int
      storageSizeInGB = int
      storageThroughputMBps = int
      subnetId = "string"
      timezoneId = "string"
      totalMemoryMB = int
      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 zasobu.	ciąg (wymagany)
name	Nazwa zasobu	ciąg (wymagany)
parent_id	Identyfikator zasobu, do który ma być stosowany ten zasób rozszerzenia.	ciąg (wymagany)
properties	Właściwości zasobu.	ManagedInstanceProperties
sku	Jednostka SKU wystąpienia zarządzanego. Dozwolone wartości sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH	Sku
tags	Tagi zasobów	Słownik nazw tagów i wartości.
typ	Typ zasobu	"Microsoft.Sql/managedInstances@2024-05-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' '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 wystąpienia usługi Azure Active Directory. Można go używać tylko w czasie tworzenia wystąpienia. Jeśli jest używana do aktualizacji wystąpienia, zostanie ona zignorowana lub spowoduje błąd. W przypadku aktualizacji należy użyć poszczególnych interfejsów 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'
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'
minimalTlsVersion	Minimalna wersja protokołu TLS. Dozwolone wartości: "None", "1.0", "1.1", "1.2"	ciąg
pricingModel	Model cen wystąpienia zarządzanego.	'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'
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: 16384. 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. System Windows przechowuje szczegółowe informacje na temat obsługiwanych stref czasowych, w tym identyfikatora, w rejestrze w obszarze KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Strefy czasowe. 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
totalMemoryMB	Łączna ilość pamięci w MB. Wartość minimalna: 7168. Wartość maksymalna: 891328. Liczba dozwolonych przyrostów wynoszących tylko 1 MB. Maksymalna wartość zależy od wybranej rodziny sprzętu i liczby rdzeni wirtualnych.	int
vCores	Liczba rdzeni wirtualnych. Dozwolone wartości: 8, 16, 24, 32, 40, 64, 80.	int
zoneRedundant	Określa, czy włączono funkcję multi-az.	bool

ResourceIdentity

Name	Description	Value
typ	Typ tożsamości. Ustaw wartość "SystemAssigned", aby automatycznie utworzyć i przypisać jednostkę usługi 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 moduły zweryfikowane platformy Azure mogą służyć do wdrażania tego typu zasobu.

Module	Description
Zarządzana instancja SQL	Moduł zasobów AVM dla usługi SQL Managed Instance

Sprzężenie zwrotne

Czy ta strona była pomocna?

Last updated on 2025-09-17

Udostępnij przez

Microsoft.Sql ManagedInstances 2024-05-01-preview

Definicja zasobu Bicep

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

Sprzężenie zwrotne

Dodatkowe źródła