Share via

Microsoft.Sql managedInstances

  • Artykuł

Definicja zasobu Bicep

Typ zasobu managedInstances można wdrożyć z operacjami docelowymi:

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

Format zasobu

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

resource symbolicname 'Microsoft.Sql/managedInstances@2023-05-01-preview' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  properties: {
    administratorLogin: 'string'
    administratorLoginPassword: 'string'
    administrators: {
      administratorType: 'ActiveDirectory'
      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'
    vCores: int
    zoneRedundant: bool
  }
}

Wartości właściwości

managedInstances

Nazwa Opis Wartość
name Nazwa zasobu ciąg (wymagany)

Limit znaków: 1–63

Prawidłowe znaki:
Wyłącznie małe litery, cyfry i łączniki.

Nie można rozpocząć ani zakończyć łącznikiem.

Nazwa zasobu musi być unikatowa na platformie Azure.
location Lokalizacja zasobu. ciąg (wymagany)
tags Tagi zasobów. Słownik nazw tagów i wartości. Zobacz Tagi w szablonach
sku Jednostka SKU wystąpienia zarządzanego. Dozwolone wartości sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH Numer jednostki magazynowej
identity Tożsamość usługi Azure Active Directory wystąpienia zarządzanego. Identyfikator zasobu
properties Właściwości zasobu. ManagedInstanceProperties

Identyfikator zasobu

Nazwa Opis Wartość
typ Typ tożsamości. Ustaw tę wartość na "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

Nazwa Opis Wartość
{niestandardowa właściwość} UserIdentity

UserIdentity

Ten obiekt nie zawiera żadnych właściwości do ustawienia podczas wdrażania. Wszystkie właściwości to ReadOnly.

ManagedInstanceProperties

Nazwa Opis Wartość
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). ciąg

Ograniczenia:
Wartość wrażliwa. Przekaż jako bezpieczny parametr.
Administratorzy Administrator wystąpienia usługi Azure Active Directory. Można go używać tylko w czasie tworzenia wystąpienia. Jeśli jest używana na potrzeby aktualizacji wystąpienia, zostanie ona zignorowana lub spowoduje błąd. W przypadku aktualizacji poszczególnych interfejsów API należy użyć. ManagedInstanceExternalAdministrator
authenticationMetadata Tryb wyszukiwania metadanych uwierzytelniania wystąpienia zarządzanego. "AzureAD"
"Sparowane"
"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 zostanie udostępniona po utworzeniu tego wystąpienia zarządzanego. ciąg
hybridSecondaryUsage Użycie hybrydowe pomocnicze. Możliwe wartości to "Active" (wartość domyślna) i "Pasywne" (klient używa pomocniczego jako pasywnego odzyskiwania po awarii). "Aktywny"
"Pasywny"
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 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 usługi AHB za korzystanie z 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.		 "Wartość domyślna"
"PointInTimeRestore"
minimalTlsVersion Minimalna wersja protokołu TLS. Dozwolone wartości: "None", "1.0", "1.1", "1.2" ciąg
pricingModel Pogoda lub nie wystąpienie zarządzane jest freemium. "Freemium"
"Zwykły"
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. "Wartość domyślna"
"Serwer proxy"
"Przekierowanie"
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. Opcje to Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) i GeoZone(GeoZoneRedundantStorage) "Geo"
"GeoZone"
"Lokalne"
"Strefa"
restorePointInTime Określa punkt w czasie (format ISO8601) ź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 magazynu. Wartość minimalna: 120. Wartość maksymalna: 120000. Liczba operacji we/wy na sekundę jest 1 dozwolona. Wartość maksymalna 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. Wartość maksymalna zależy od wybranej rodziny sprzętu i liczby rdzeni wirtualnych. int
storageThroughputMBps Przepływność magazynu w MB/s. Wartość minimalna: 25. Wartość maksymalna: 4000. Tylko przyrosty 1 MB/s dozwolone. Wartość maksymalna zależy od wybranej rodziny sprzętu i liczby rdzeni wirtualnych. 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\Time Zones.
Te wartości rejestru można uzyskać za pośrednictwem SQL Server, wysyłając zapytanie o nazwę SELECT 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 "Pacyficzny czas standardowy" lub "W. Europa (czas standardowy).		 ciąg
Rdzenie wirtualne Liczba rdzeni wirtualnych. Dozwolone wartości: 8, 16, 24, 32, 40, 64, 80. int
zoneRedundant Bez względu na to, czy włączono funkcję multi-az. bool

ManagedInstanceExternalAdministrator

Nazwa Opis Wartość
administratorType Typ administratora serwera. "ActiveDirectory"
azureADOnlyAuthentication Włączono tylko uwierzytelnianie usługi Azure Active Directory. bool
logowanie Nazwa logowania administratora serwera. ciąg
principalType Typ podmiotu zabezpieczeń administratora serwera. "Aplikacja"
"Grupuj"
"Użytkownik"
Sid Identyfikator SID (identyfikator obiektu) administratora serwera. ciąg

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. ciąg

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

ServicePrincipal

Nazwa Opis Wartość
typ Typ jednostki usługi. "Brak"
"SystemAssigned"

SKU

Nazwa Opis Wartość
capacity Pojemność określonej jednostki SKU. int
rodzina 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 określonej jednostki SKU ciąg
tier Warstwa lub wersja określonej jednostki SKU, np. Podstawowa, Premium. ciąg

Szablony szybkiego startu

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

Template Opis
Wdrażanie SQL Managed Instance za pomocą sieci

Wdróż na platformie Azure		 Wdrażanie trasy zdefiniowanej przez użytkownika i sieciowej grupy zabezpieczeń w celu obsługi Azure SQL Managed Instance i wdrażania wystąpienia zarządzanego
Tworzenie wystąpienia zarządzanego SQL w nowej sieci wirtualnej

Wdróż na platformie Azure		 Wdróż wystąpienie zarządzane usługi Azure Sql Database (SQL MI) w nowej Virtual Network.
Tworzenie wystąpienia zarządzanego SQL przy użyciu skonfigurowanego wysyłania dzienników i metryk

Wdróż na platformie Azure		 Ten szablon umożliwia wdrożenie programu SQL MI 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

Wdróż na platformie Azure		 Wdróż wystąpienie zarządzane usługi Azure Sql Database (SQL MI) i aplikację JumpBox za pomocą programu SSMS w nowej Virtual Network.
Tworzenie wystąpienia zarządzanego SQL przy użyciu skonfigurowanego połączenia punkt-lokacja

Wdróż 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.

Definicja zasobu szablonu usługi ARM

Typ zasobu managedInstances można wdrożyć za pomocą operacji docelowych:

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

Format zasobu

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

{
  "type": "Microsoft.Sql/managedInstances",
  "apiVersion": "2023-05-01-preview",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "properties": {
    "administratorLogin": "string",
    "administratorLoginPassword": "string",
    "administrators": {
      "administratorType": "ActiveDirectory",
      "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",
    "vCores": "int",
    "zoneRedundant": "bool"
  }
}

Wartości właściwości

ManagedInstances

Nazwa Opis Wartość
typ Typ zasobu "Microsoft.Sql/managedInstances"
apiVersion Wersja interfejsu API zasobów "2023-05-01-preview"
name Nazwa zasobu ciąg (wymagany)

Limit znaków: 1–63

Prawidłowe znaki:
Wyłącznie małe litery, cyfry i łączniki.

Nie można rozpocząć ani zakończyć łącznikiem.

Nazwa zasobu musi być unikatowa na platformie Azure.
location Lokalizacja zasobu. ciąg (wymagany)
tags Tagi zasobów. Słownik nazw tagów i wartości. Zobacz Tagi w szablonach
sku Jednostka SKU wystąpienia zarządzanego. Dozwolone wartości sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH Numer jednostki magazynowej
identity Tożsamość usługi Azure Active Directory wystąpienia zarządzanego. Identyfikator zasobu
properties Właściwości zasobu. ManagedInstanceProperties

Identyfikator zasobu

Nazwa Opis Wartość
typ Typ tożsamości. Ustaw tę wartość na 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

Nazwa Opis Wartość
{niestandardowa właściwość} UserIdentity

UserIdentity

Ten obiekt nie zawiera żadnych właściwości do ustawienia podczas wdrażania. Wszystkie właściwości to ReadOnly.

ManagedInstanceProperties

Nazwa Opis Wartość
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). ciąg

Ograniczenia:
Wartość wrażliwa. Przekaż jako bezpieczny parametr.
Administratorzy Administrator usługi Azure Active Directory wystąpienia. Może to być używane 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"
"Sparowane"
"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). "Aktywny"
"Pasywne"
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 w wersji Ogólnego przeznaczenia. bool
keyId Identyfikator URI klucza 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.		 "Wartość domyślna"
"PointInTimeRestore"
minimalTlsVersion Minimalna wersja protokołu TLS. Dozwolone wartości: "None", "1.0", "1.1", "1.2" ciąg
pricingModel Pogoda lub nie wystąpienie zarządzane jest freemium. "Freemium"
"Regularne"
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. "Wartość domyślna"
"Serwer proxy"
"Przekierowanie"
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. Opcje to Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) i GeoZone(GeoZoneRedundantStorage) "Geo"
"Strefa geograficzna"
"Lokalne"
"Strefa"
restorePointInTime Określa punkt w czasie (format ISO8601) ź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 na sekundę magazynu. Wartość minimalna: 120. Wartość maksymalna: 120000. Liczba operacji we/wy na sekundę jest dozwolona tylko dla 1 operacji we/wy na sekundę. 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. Dozwolone są tylko przyrosty o rozmiarze 32 GB. Maksymalna wartość zależy od wybranej rodziny sprzętu i liczby rdzeni wirtualnych. int
storageThroughputMBps Przepływność magazynu w mb/s. Wartość minimalna: 25. Maksymalna wartość: 4000. Dozwolone są tylko przyrosty 1 MB/s. Maksymalna wartość zależy od wybranej rodziny sprzętu i liczby rdzeni wirtualnych. 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\Time Zones.
Te wartości rejestru można uzyskać za pośrednictwem SQL Server, wysyłając zapytanie o nazwę SELECT 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 "Pacyficzny czas standardowy" lub "W. Europa (czas standardowy).		 ciąg
Rdzenie wirtualne Liczba rdzeni wirtualnych. Dozwolone wartości: 8, 16, 24, 32, 40, 64, 80. int
zoneRedundant Określa, czy funkcja multi-az jest włączona. bool

ManagedInstanceExternalAdministrator

Nazwa Opis Wartość
administratorType Typ administratora serwera. "ActiveDirectory"
azureADOnlyAuthentication Włączono tylko uwierzytelnianie usługi Azure Active Directory. bool
logowanie Nazwa logowania administratora serwera. ciąg
principalType Typ podmiotu zabezpieczeń administratora serwera. "Aplikacja"
"Grupa"
"Użytkownik"
Sid Identyfikator SID (identyfikator obiektu) administratora serwera. ciąg

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. ciąg

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

ServicePrincipal

Nazwa Opis Wartość
typ Typ jednostki usługi. "Brak"
"SystemAssigned"

SKU

Nazwa Opis Wartość
capacity Pojemność konkretnej jednostki SKU. int
rodzina 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 numeryczny, np. P3. ciąg (wymagany)
size Rozmiar konkretnej jednostki SKU ciąg
tier Warstwa lub wersja konkretnej jednostki SKU, np. Podstawowa, Premium. ciąg

Szablony szybkiego startu

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

Template Opis
Wdrażanie SQL Managed Instance za pomocą sieci

Wdróż na platformie Azure		 Wdrażanie trasy zdefiniowanej przez użytkownika i sieciowej grupy zabezpieczeń w celu obsługi Azure SQL Managed Instance i wdrażania wystąpienia zarządzanego
Tworzenie wystąpienia zarządzanego SQL w nowej sieci wirtualnej

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

Wdróż 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

Wdróż na platformie Azure		 Wdróż wystąpienie zarządzane usługi Azure Sql Database (SQL MI) i serwer JumpBox przy użyciu programu SSMS w nowym Virtual Network.
Tworzenie wystąpienia zarządzanego SQL ze skonfigurowanym połączeniem punkt-lokacja

Wdróż na platformie Azure		 Wdróż wystąpienie zarządzane usługi Azure Sql Database (SQL MI) i bramę sieci wirtualnej skonfigurowaną dla połączenia punkt-lokacja wewnątrz nowej sieci wirtualnej.

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu managedInstances można wdrożyć z operacjami docelowymi:

  • Grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik 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@2023-05-01-preview"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "string"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      administratorLogin = "string"
      administratorLoginPassword = "string"
      administrators = {
        administratorType = "ActiveDirectory"
        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"
      vCores = int
      zoneRedundant = bool
    }
    sku = {
      capacity = int
      family = "string"
      name = "string"
      size = "string"
      tier = "string"
    }
  })
}

Wartości właściwości

managedInstances

Nazwa Opis Wartość
typ Typ zasobu "Microsoft.Sql/managedInstances@2023-05-01-preview"
name Nazwa zasobu ciąg (wymagany)

Limit znaków: 1–63

Prawidłowe znaki:
Wyłącznie małe litery, cyfry i łączniki.

Nie można rozpocząć ani zakończyć łącznikiem.

Nazwa zasobu musi być unikatowa na platformie Azure.
location Lokalizacja zasobu. ciąg (wymagany)
parent_id Aby wdrożyć w grupie zasobów, użyj identyfikatora tej grupy zasobów. ciąg (wymagany)
tags Tagi zasobów. Słownik nazw tagów i wartości.
sku Jednostka SKU wystąpienia zarządzanego. Dozwolone wartości sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH Numer jednostki magazynowej
identity Tożsamość usługi Azure Active Directory wystąpienia zarządzanego. Identyfikator zasobu
properties Właściwości zasobu. ManagedInstanceProperties

Identyfikator zasobu

Nazwa Opis Wartość
typ Typ tożsamości. Ustaw tę wartość na wartość "SystemAssigned", aby automatycznie utworzyć i przypisać jednostkę usługi Azure Active Directory dla zasobu. "SystemAssigned"
"SystemAssigned,UserAssigned"
"UserAssigned"
identity_ids Identyfikatory zasobów tożsamości przypisanych przez użytkownika do użycia Tablica identyfikatorów tożsamości użytkownika.

ResourceIdentityUserAssignedIdentities

Nazwa Opis Wartość
{niestandardowa właściwość} UserIdentity

UserIdentity

Ten obiekt nie zawiera żadnych właściwości do ustawienia podczas wdrażania. Wszystkie właściwości to ReadOnly.

ManagedInstanceProperties

Nazwa Opis Wartość
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). ciąg

Ograniczenia:
Wartość wrażliwa. Przekaż jako bezpieczny parametr.
Administratorzy Administrator usługi Azure Active Directory wystąpienia. Może to być używane 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"
"Sparowane"
"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). "Aktywny"
"Pasywne"
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 w wersji Ogólnego przeznaczenia. bool
keyId Identyfikator URI klucza 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.		 "Wartość domyślna"
"PointInTimeRestore"
minimalTlsVersion Minimalna wersja protokołu TLS. Dozwolone wartości: "None", "1.0", "1.1", "1.2" ciąg
pricingModel Pogoda lub nie wystąpienie zarządzane jest freemium. "Freemium"
"Zwykły"
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. "Wartość domyślna"
"Serwer proxy"
"Przekierowanie"
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. Opcje to Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) i GeoZone(GeoZoneRedundantStorage) "Geo"
"GeoZone"
"Lokalne"
"Strefa"
restorePointInTime Określa punkt w czasie (format ISO8601) ź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 magazynu. Wartość minimalna: 120. Wartość maksymalna: 120000. Liczba operacji we/wy na sekundę jest 1 dozwolona. Wartość maksymalna 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. Wartość maksymalna zależy od wybranej rodziny sprzętu i liczby rdzeni wirtualnych. int
storageThroughputMBps Przepływność magazynu w MB/s. Wartość minimalna: 25. Wartość maksymalna: 4000. Tylko przyrosty 1 MB/s dozwolone. Wartość maksymalna zależy od wybranej rodziny sprzętu i liczby rdzeni wirtualnych. 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\Time Zones.
Te wartości rejestru można uzyskać za pośrednictwem SQL Server, wysyłając zapytanie o nazwę SELECT 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
Rdzenie wirtualne Liczba rdzeni wirtualnych. Dozwolone wartości: 8, 16, 24, 32, 40, 64, 80. int
zoneRedundant Określa, czy funkcja multi-az jest włączona. bool

ManagedInstanceExternalAdministrator

Nazwa Opis Wartość
administratorType Typ administratora serwera. "ActiveDirectory"
azureADOnlyAuthentication Włączono tylko uwierzytelnianie usługi Azure Active Directory. bool
logowanie Nazwa logowania administratora serwera. ciąg
principalType Typ podmiotu zabezpieczeń administratora serwera. "Aplikacja"
"Grupa"
"Użytkownik"
Sid Identyfikator SID (identyfikator obiektu) administratora serwera. ciąg

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. ciąg

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

ServicePrincipal

Nazwa Opis Wartość
typ Typ jednostki usługi. "Brak"
"SystemAssigned"

SKU

Nazwa Opis Wartość
capacity Pojemność konkretnej jednostki SKU. int
rodzina 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 numeryczny, np. P3. ciąg (wymagany)
size Rozmiar konkretnej jednostki SKU ciąg
tier Warstwa lub wersja konkretnej jednostki SKU, np. Podstawowa, Premium. ciąg