Microsoft.Sql managedInstances 2023-02-01-preview

Artykuł
03/05/2024

Definicja zasobu Bicep

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

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 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-02-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'
    }
    collation: '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
Sortowanie	Sortowanie wystąpienia zarządzanego.	ciąg
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 "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

Szablony szybkiego startu

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

Template	Opis
Wdrażanie SQL Managed Instance za pomocą sieci	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óż 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	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óż 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óż 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 szablonu usługi ARM

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

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 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-02-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"
    },
    "collation": "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-02-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 "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
Sortowanie	Sortowanie wystąpienia zarządzanego.	ciąg
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 "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

Szablony szybkiego startu

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

Template	Opis
Wdrażanie SQL Managed Instance za pomocą sieci	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óż 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	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óż 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óż 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-02-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"
      }
      collation = "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-02-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 przeprowadzić wdrożenie 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
Sortowanie	Sortowanie wystąpienia zarządzanego.	ciąg
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" "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ść 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

Udostępnij za pośrednictwem

Microsoft.Sql managedInstances 2023-02-01-preview

Definicja zasobu Bicep

Format zasobu

Wartości właściwości

managedInstances

Identyfikator zasobu

ResourceIdentityUserAssignedIdentities

UserIdentity

ManagedInstanceProperties

ManagedInstanceExternalAdministrator

ServicePrincipal

SKU

Szablony szybkiego startu

Definicja zasobu szablonu usługi ARM

Format zasobu

Wartości właściwości

managedInstances

Identyfikator zasobu

ResourceIdentityUserAssignedIdentities

UserIdentity

ManagedInstanceProperties

ManagedInstanceExternalAdministrator

ServicePrincipal

SKU

Szablony szybkiego startu

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Format zasobu

Wartości właściwości

managedInstances

Identyfikator zasobu

ResourceIdentityUserAssignedIdentities

UserIdentity

ManagedInstanceProperties

ManagedInstanceExternalAdministrator

ServicePrincipal

SKU

Opinia

Dodatkowe zasoby