Microsoft.Sql ManagedInstances
- najnowsze
- 2024-05-01-preview
-
2023-08-01-preview - 2023-05-01-preview
- 2023-02-01-preview
- 2022-11-01-preview
- 2022-08-01-preview
- 2022-05-01-preview
- 2022-02-01-preview
- 2021-11-01
- 2021-11-01-preview
- 2021-08-01-preview
-
2021-05-01-preview - 2021-02-01-preview
- 2020-11-01-preview
- 2020-08-01-preview
- 2020-02-02-preview
- 2018-06-01-preview
- 2015-05-01-preview
Definicja zasobu Bicep
Typ zasobu managedInstances można wdrożyć przy użyciu operacji docelowych:
- grupy zasobów — zobacz polecenia wdrażania grupy zasobów
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.
Format zasobu
Aby utworzyć zasób Microsoft.Sql/managedInstances, dodaj następujący kod Bicep do szablonu.
resource symbolicname 'Microsoft.Sql/managedInstances@2024-05-01-preview' = {
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
location: 'string'
name: 'string'
properties: {
administratorLogin: 'string'
administratorLoginPassword: 'string'
administrators: {
administratorType: 'string'
azureADOnlyAuthentication: bool
login: 'string'
principalType: 'string'
sid: 'string'
tenantId: 'string'
}
authenticationMetadata: 'string'
collation: 'string'
databaseFormat: 'string'
dnsZonePartner: 'string'
hybridSecondaryUsage: 'string'
instancePoolId: 'string'
isGeneralPurposeV2: bool
keyId: 'string'
licenseType: 'string'
maintenanceConfigurationId: 'string'
managedInstanceCreateMode: 'string'
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
ManagedInstanceExternalAdministrator
| Nazwa | Opis | Wartość |
|---|---|---|
| administratorType | Typ administratora serwera. | "ActiveDirectory" |
| azureADOnlyAuthentication | Włączono tylko uwierzytelnianie usługi Azure Active Directory. | Bool |
| login | Nazwa logowania administratora serwera. | struna |
| principalType | Typ podmiotu zabezpieczeń administratora serwera. | "Aplikacja" "Grupuj" "Użytkownik" |
| Sid | Identyfikator SID (identyfikator obiektu) administratora serwera. | struna 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. | struna Ograniczenia: Minimalna długość = 36 Maksymalna długość = 36 Wzorzec = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
ManagedInstanceProperties
| 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). | struna |
| administratorLoginPassword | Hasło logowania administratora (wymagane do utworzenia wystąpienia zarządzanego). | struna 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 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. | struna |
| 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. | struna |
| hybridSecondaryUsage | Użycie pomocnicze hybrydowe. Możliwe wartości to "Aktywne" (wartość domyślna) i "Pasywne" (klient używa pomocniczego jako pasywnego odzyskiwania po awarii). | "Aktywne" "Pasywny" |
| instancePoolId | Identyfikator puli wystąpień, do którego należy ten serwer zarządzany. | struna |
| 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. | struna |
| 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. | struna |
| 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" | struna |
| pricingModel | Model cen wystąpienia zarządzanego. | "Freemium" "Zwykły" |
| primaryUserAssignedIdentityId | Identyfikator zasobu tożsamości przypisanej przez użytkownika domyślnie używany. | struna |
| 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. Dostępne opcje to LocallyRedundantStorage, Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) i GeoZone(GeoZoneRedundantStorage) | "Geo" "GeoZone" "Lokalny" "Strefa" |
| restorePointInTime | Określa punkt w czasie (ISO8601 format) źródłowej bazy danych, która zostanie przywrócona w celu utworzenia nowej bazy danych. | struna |
| 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. | struna |
| storageIOps | Operacje we/wy na sekundę magazynu. Wartość minimalna: 300. Wartość maksymalna: 80000. Liczba operacji we/wy na sekundę jest 1 dozwolona. Maksymalna wartość zależy od wybranej rodziny sprzętu i liczby rdzeni wirtualnych. | Int |
| storageSizeInGB | Rozmiar magazynu w GB. Wartość minimalna: 32. Wartość maksymalna: 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. | struna |
| 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 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). |
struna |
| 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 |
| Rdzenie wirtualne | Liczba rdzeni wirtualnych. Dozwolone wartości: 8, 16, 24, 32, 40, 64, 80. | Int |
| zoneRedundant | Określa, czy włączono funkcję multi-az. | Bool |
Microsoft.Sql/managedInstances
| Nazwa | Opis | Wartość |
|---|---|---|
| tożsamość | Tożsamość usługi Azure Active Directory wystąpienia zarządzanego. | ResourceIdentity |
| lokalizacja | Lokalizacja zasobu. | ciąg (wymagany) |
| nazwa | Nazwa zasobu | ciąg (wymagany) |
| Właściwości | Właściwości zasobu. | ManagedInstanceProperties |
| Numer jednostki magazynowej | Jednostka SKU wystąpienia zarządzanego. Dozwolone wartości sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH | sku |
| Tagi | Tagi zasobów | Słownik nazw tagów i wartości. Zobacz tagi w szablonach |
Identyfikator zasobu
| Nazwa | Opis | Wartość |
|---|---|---|
| typ | Typ tożsamości. Ustaw wartość "SystemAssigned", aby automatycznie utworzyć i przypisać jednostkę usługi Azure Active Directory dla zasobu. | "Brak" "SystemAssigned" "SystemAssigned,UserAssigned" "UserAssigned" |
| userAssignedIdentities | Identyfikatory zasobów tożsamości przypisanych przez użytkownika do użycia | ResourceIdentityUserAssignedIdentities |
ResourceIdentityUserAssignedIdentities
| Nazwa | Opis | Wartość |
|---|
ServicePrincipal
| Nazwa | Opis | Wartość |
|---|---|---|
| typ | Typ jednostki usługi. | "Brak" "SystemAssigned" |
Numer jednostki magazynowej
| Nazwa | Opis | Wartość |
|---|---|---|
| pojemność | 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. | struna |
| nazwa | Nazwa jednostki SKU, zazwyczaj, litera + kod liczbowy, np. P3. | ciąg (wymagany) |
| rozmiar | Rozmiar konkretnej jednostki SKU | struna |
| kondygnacja | Warstwa lub wersja konkretnej jednostki SKU, np. Podstawowa, Premium. | struna |
TrackedResourceTags
| Nazwa | Opis | Wartość |
|---|
Identyfikator użytkownika
| Nazwa | Opis | Wartość |
|---|
Przykłady z przewodnika Szybki start
W poniższych przykładach szybkiego startu wdrożono ten typ zasobu.
| Plik Bicep | Opis |
|---|---|
| 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:
- grupy zasobów — zobacz polecenia wdrażania grupy zasobów
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.
Format zasobu
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
ManagedInstanceExternalAdministrator
| Nazwa | Opis | Wartość |
|---|---|---|
| administratorType | Typ administratora serwera. | "ActiveDirectory" |
| azureADOnlyAuthentication | Włączono tylko uwierzytelnianie usługi Azure Active Directory. | Bool |
| login | Nazwa logowania administratora serwera. | struna |
| principalType | Typ podmiotu zabezpieczeń administratora serwera. | "Aplikacja" "Grupuj" "Użytkownik" |
| Sid | Identyfikator SID (identyfikator obiektu) administratora serwera. | struna 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. | struna Ograniczenia: Minimalna długość = 36 Maksymalna długość = 36 Wzorzec = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
ManagedInstanceProperties
| 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). | struna |
| administratorLoginPassword | Hasło logowania administratora (wymagane do utworzenia wystąpienia zarządzanego). | struna 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 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. | struna |
| 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. | struna |
| hybridSecondaryUsage | Użycie pomocnicze hybrydowe. Możliwe wartości to "Aktywne" (wartość domyślna) i "Pasywne" (klient używa pomocniczego jako pasywnego odzyskiwania po awarii). | "Aktywne" "Pasywny" |
| instancePoolId | Identyfikator puli wystąpień, do którego należy ten serwer zarządzany. | struna |
| 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. | struna |
| 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. | struna |
| 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" | struna |
| pricingModel | Model cen wystąpienia zarządzanego. | "Freemium" "Zwykły" |
| primaryUserAssignedIdentityId | Identyfikator zasobu tożsamości przypisanej przez użytkownika domyślnie używany. | struna |
| 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. Dostępne opcje to LocallyRedundantStorage, Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) i GeoZone(GeoZoneRedundantStorage) | "Geo" "GeoZone" "Lokalny" "Strefa" |
| restorePointInTime | Określa punkt w czasie (ISO8601 format) źródłowej bazy danych, która zostanie przywrócona w celu utworzenia nowej bazy danych. | struna |
| 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. | struna |
| storageIOps | Operacje we/wy na sekundę magazynu. Wartość minimalna: 300. Wartość maksymalna: 80000. Liczba operacji we/wy na sekundę jest 1 dozwolona. Maksymalna wartość zależy od wybranej rodziny sprzętu i liczby rdzeni wirtualnych. | Int |
| storageSizeInGB | Rozmiar magazynu w GB. Wartość minimalna: 32. Wartość maksymalna: 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. | struna |
| 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 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). |
struna |
| 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 |
| Rdzenie wirtualne | Liczba rdzeni wirtualnych. Dozwolone wartości: 8, 16, 24, 32, 40, 64, 80. | Int |
| zoneRedundant | Określa, czy włączono funkcję multi-az. | Bool |
Microsoft.Sql/managedInstances
| Nazwa | Opis | Wartość |
|---|---|---|
| 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) |
| nazwa | Nazwa zasobu | ciąg (wymagany) |
| Właściwości | Właściwości zasobu. | ManagedInstanceProperties |
| Numer jednostki magazynowej | Jednostka SKU wystąpienia zarządzanego. Dozwolone wartości sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH | sku |
| Tagi | Tagi zasobów | Słownik nazw tagów i wartości. Zobacz tagi w szablonach |
| typ | Typ zasobu | "Microsoft.Sql/managedInstances" |
Identyfikator zasobu
| Nazwa | Opis | Wartość |
|---|---|---|
| typ | Typ tożsamości. Ustaw wartość "SystemAssigned", aby automatycznie utworzyć i przypisać jednostkę usługi Azure Active Directory dla zasobu. | "Brak" "SystemAssigned" "SystemAssigned,UserAssigned" "UserAssigned" |
| userAssignedIdentities | Identyfikatory zasobów tożsamości przypisanych przez użytkownika do użycia | ResourceIdentityUserAssignedIdentities |
ResourceIdentityUserAssignedIdentities
| Nazwa | Opis | Wartość |
|---|
ServicePrincipal
| Nazwa | Opis | Wartość |
|---|---|---|
| typ | Typ jednostki usługi. | "Brak" "SystemAssigned" |
Numer jednostki magazynowej
| Nazwa | Opis | Wartość |
|---|---|---|
| pojemność | 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. | struna |
| nazwa | Nazwa jednostki SKU, zazwyczaj, litera + kod liczbowy, np. P3. | ciąg (wymagany) |
| rozmiar | Rozmiar konkretnej jednostki SKU | struna |
| kondygnacja | Warstwa lub wersja konkretnej jednostki SKU, np. Podstawowa, Premium. | struna |
TrackedResourceTags
| Nazwa | Opis | Wartość |
|---|
Identyfikator użytkownika
| Nazwa | Opis | Wartość |
|---|
Szablony szybkiego startu
Następujące szablony szybkiego startu wdrażają ten typ zasobu.
| Szablon | Opis |
|---|---|
|
Tworzenie wystąpienia zarządzanego SQL w nowej sieci wirtualnej wdrażanie  |
Wdróż wystąpienie zarządzane usługi Azure Sql Database (SQL MI) w nowej sieci wirtualnej. |
|
Tworzenie wystąpienia zarządzanego SQL ze skonfigurowanym wysyłaniem dzienników i metryk wdrażanie |
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 |
Wdrażanie wystąpienia zarządzanego usługi Azure Sql Database (SQL MI) i serwera JumpBox za pomocą programu SSMS w nowej sieci wirtualnej. |
|
tworzenie wystąpienia zarządzanego SQL przy użyciu połączenia punkt-lokacja skonfigurowanego wdrażanie |
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 |
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:
- grupy zasobów
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"
identity = {
type = "string"
userAssignedIdentities = {
{customized property} = {
}
}
}
location = "string"
sku = {
capacity = int
family = "string"
name = "string"
size = "string"
tier = "string"
}
tags = {
{customized property} = "string"
}
body = jsonencode({
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
}
})
}
Wartości właściwości
ManagedInstanceExternalAdministrator
| Nazwa | Opis | Wartość |
|---|---|---|
| administratorType | Typ administratora serwera. | "ActiveDirectory" |
| azureADOnlyAuthentication | Włączono tylko uwierzytelnianie usługi Azure Active Directory. | Bool |
| login | Nazwa logowania administratora serwera. | struna |
| principalType | Typ podmiotu zabezpieczeń administratora serwera. | "Aplikacja" "Grupuj" "Użytkownik" |
| Sid | Identyfikator SID (identyfikator obiektu) administratora serwera. | struna 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. | struna Ograniczenia: Minimalna długość = 36 Maksymalna długość = 36 Wzorzec = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
ManagedInstanceProperties
| 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). | struna |
| administratorLoginPassword | Hasło logowania administratora (wymagane do utworzenia wystąpienia zarządzanego). | struna 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 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. | struna |
| 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. | struna |
| hybridSecondaryUsage | Użycie pomocnicze hybrydowe. Możliwe wartości to "Aktywne" (wartość domyślna) i "Pasywne" (klient używa pomocniczego jako pasywnego odzyskiwania po awarii). | "Aktywne" "Pasywny" |
| instancePoolId | Identyfikator puli wystąpień, do którego należy ten serwer zarządzany. | struna |
| 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. | struna |
| 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. | struna |
| 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" | struna |
| pricingModel | Model cen wystąpienia zarządzanego. | "Freemium" "Zwykły" |
| primaryUserAssignedIdentityId | Identyfikator zasobu tożsamości przypisanej przez użytkownika domyślnie używany. | struna |
| 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. Dostępne opcje to LocallyRedundantStorage, Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) i GeoZone(GeoZoneRedundantStorage) | "Geo" "GeoZone" "Lokalny" "Strefa" |
| restorePointInTime | Określa punkt w czasie (ISO8601 format) źródłowej bazy danych, która zostanie przywrócona w celu utworzenia nowej bazy danych. | struna |
| 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. | struna |
| storageIOps | Operacje we/wy na sekundę magazynu. Wartość minimalna: 300. Wartość maksymalna: 80000. Liczba operacji we/wy na sekundę jest 1 dozwolona. Maksymalna wartość zależy od wybranej rodziny sprzętu i liczby rdzeni wirtualnych. | Int |
| storageSizeInGB | Rozmiar magazynu w GB. Wartość minimalna: 32. Wartość maksymalna: 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. | struna |
| 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 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). |
struna |
| 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 |
| Rdzenie wirtualne | Liczba rdzeni wirtualnych. Dozwolone wartości: 8, 16, 24, 32, 40, 64, 80. | Int |
| zoneRedundant | Określa, czy włączono funkcję multi-az. | Bool |
Microsoft.Sql/managedInstances
| Nazwa | Opis | Wartość |
|---|---|---|
| tożsamość | Tożsamość usługi Azure Active Directory wystąpienia zarządzanego. | ResourceIdentity |
| lokalizacja | Lokalizacja zasobu. | ciąg (wymagany) |
| nazwa | Nazwa zasobu | ciąg (wymagany) |
| Właściwości | Właściwości zasobu. | ManagedInstanceProperties |
| Numer jednostki magazynowej | Jednostka SKU wystąpienia zarządzanego. Dozwolone wartości sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH | sku |
| Tagi | Tagi zasobów | Słownik nazw tagów i wartości. |
| typ | Typ zasobu | "Microsoft.Sql/managedInstances@2024-05-01-preview" |
Identyfikator zasobu
| Nazwa | Opis | Wartość |
|---|---|---|
| typ | Typ tożsamości. Ustaw wartość "SystemAssigned", aby automatycznie utworzyć i przypisać jednostkę usługi Azure Active Directory dla zasobu. | "Brak" "SystemAssigned" "SystemAssigned,UserAssigned" "UserAssigned" |
| userAssignedIdentities | Identyfikatory zasobów tożsamości przypisanych przez użytkownika do użycia | ResourceIdentityUserAssignedIdentities |
ResourceIdentityUserAssignedIdentities
| Nazwa | Opis | Wartość |
|---|
ServicePrincipal
| Nazwa | Opis | Wartość |
|---|---|---|
| typ | Typ jednostki usługi. | "Brak" "SystemAssigned" |
Numer jednostki magazynowej
| Nazwa | Opis | Wartość |
|---|---|---|
| pojemność | 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. | struna |
| nazwa | Nazwa jednostki SKU, zazwyczaj, litera + kod liczbowy, np. P3. | ciąg (wymagany) |
| rozmiar | Rozmiar konkretnej jednostki SKU | struna |
| kondygnacja | Warstwa lub wersja konkretnej jednostki SKU, np. Podstawowa, Premium. | struna |
TrackedResourceTags
| Nazwa | Opis | Wartość |
|---|
Identyfikator użytkownika
| Nazwa | Opis | Wartość |
|---|