Microsoft.Sql managedInstances
- Najnowsza
- 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ć 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-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 |
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 (SQL MI) w nowej Virtual Network. |
| Tworzenie wystąpienia zarządzanego SQL przy użyciu skonfigurowanego wysyłania dzienników i metryk |
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óż 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óż 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:
- 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-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 |
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-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 |