Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
- Latest
- 2025-02-01-preview
- 1. 1. 2025
- 2024-11-01-preview
- 2024-05-01-preview
- 2023-08-01
- 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
Definice zdroje Bicep
Typ prostředku managedInstances je možné nasadit s operacemi, které cílí:
- skupiny prostředků – viz příkazy nasazení skupiny prostředků
Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.
Formát prostředku
Vytvořit Microsoft. Zdroj pro SQL/ManagedInstances, přidejte následující Bicep do své šablony.
resource symbolicname 'Microsoft.Sql/managedInstances@2025-02-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'
memorySizeInGB: int
minimalTlsVersion: 'string'
pricingModel: 'string'
primaryUserAssignedIdentityId: 'string'
proxyOverride: 'string'
publicDataEndpointEnabled: bool
requestedBackupStorageRedundancy: 'string'
requestedLogicalAvailabilityZone: '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'
}
tags: {
{customized property}: 'string'
}
}
Hodnoty vlastností
Microsoft. Sql/managedInstance
| Name | Description | Value |
|---|---|---|
| identita | Identita Azure Active Directory spravované instance. | ResourceIdentity |
| poloha | Geografické umístění, ve kterém se nachází zdroj | string (povinné) |
| name | Název prostředku | string (povinné) |
| properties | Vlastnosti prostředku. | ManagedInstanceProperties |
| sku | Skladová položka spravované instance Povolené hodnoty pro sku.name: GP_Gen5 (Pro obecné použití, řada Standard); GP_G8IM (pro všeobecné použití, řada Premium); GP_G8IH (pro všeobecné použití, optimalizováno pro paměť řady Premium); BC_Gen5 (Důležité obchodní informace, Standard-Series); BC_G8IM (Pro důležité obchodní informace, řada Premium); BC_G8IH (Pro důležité obchodní informace, optimalizováno pro paměť řady Premium). | Sku |
| tags | Štítky prostředků | Slovník názvů a hodnot značek Viz Značky v šablonách |
ManagedInstanceExternalAdministrator
| Name | Description | Value |
|---|---|---|
| administratorType | Typ správce serveru. | 'ActiveDirectory' |
| azureADOnlyAuthentication | Azure Active Directory pouze Authentication povolen. | bool |
| login | Přihlašovací jméno správce serveru. | řetězec |
| principalType | Hlavní typ správce serveru. | 'Application' 'Group' 'User' |
| sid | IDENTIFIKÁTOR SID (ID objektu) správce serveru. | string Constraints: Minimální délka = 36 Maximální délka = 36 Model = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| tenantId | ID tenanta správce. | string Constraints: Minimální délka = 36 Maximální délka = 36 Model = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
ManagedInstanceProperties
| Name | Description | Value |
|---|---|---|
| administratorLogin | Uživatelské jméno správce pro spravovanou instanci. Je možné zadat pouze při vytváření spravované instance (a vyžaduje se k vytvoření). | řetězec |
| administratorLoginPassword | Přihlašovací heslo správce (vyžaduje se k vytvoření spravované instance). | string Constraints: Citlivá hodnota. Předejte ho jako zabezpečený parametr. |
| administrators | Správce Azure Active Directory lze využít při vytváření instance a například při aktualizacích, kromě vlastnosti azureADOnlyAuthentication. Pokud chcete aktualizovat vlastnost azureADOnlyAuthentication, je nutné použít jednotlivé rozhraní API. | ManagedInstanceExternalAdministrator |
| authenticationMetadata | Režim vyhledávání metadat ověřování spravované instance. | 'AzureAD' 'Paired' 'Windows' |
| kolace | Kolace spravované instance | řetězec |
| databaseFormat | Určuje interní formát databází instancí specifických pro verzi modulu SQL. | 'AlwaysUpToDate' 'SQLServer2022' 'SQLServer2025' |
| dnsZonePartner | ID prostředku jiné spravované instance, jejíž zóna DNS bude tato spravovaná instance sdílet po vytvoření. | řetězec |
| hybridSecondaryUsage | Hybridní sekundární využití. Možné hodnoty jsou Aktivní (výchozí hodnota) a Pasivní (zákazník používá sekundární hodnotu jako pasivní zotavení po havárii). | 'Active' 'Passive' |
| instancePoolId | ID fondu instancí, do které tento spravovaný server patří. | řetězec |
| isGeneralPurposeV2 | Určuje, jestli se jedná o variantu GPv2 edice Pro obecné účely. | bool |
| keyId | Identifikátor URI klíče CMK, který se má použít k šifrování. | řetězec |
| licenseType | Typ licence. Možné hodnoty jsou LicenseIncluded (běžná cena včetně nové licence SQL) a BasePrice (zvýhodněná cena AHB za používání vlastních licencí SQL). | 'BasePrice' 'LicenseIncluded' |
| maintenanceConfigurationId | Určuje ID konfigurace údržby, které se má použít pro tuto spravovanou instanci. | řetězec |
| managedInstanceCreateMode | Určuje režim vytváření databáze. Výchozí hodnota: Vytvoření pravidelné instance. Obnovení: Vytvoří instanci obnovením sady záloh k určitému bodu v čase. Musí být zadány hodnoty RestorePointInTime a SourceManagedInstanceId. |
'Default' 'PointInTimeRestore' |
| memorySizeInGB | Velikost paměti v GB. Minimální hodnota: 28. Maximální hodnota: 870. Minimální a maximální hodnota závisí na počtu virtuálních jader a úrovni služby. Přečtěte si více o omezeních zdrojů: https://aka.ms/mi-resource-limits-api. | int |
| minimalTlsVersion | Minimální verze protokolu TLS. Povolené hodnoty: None, 1.0, 1.1, 1.2 | řetězec |
| pricingModel | Cenový model Managed Instance. | 'Freemium' 'Regular' |
| primaryUserAssignedIdentityId | ID prostředku identity přiřazené uživatelem, které se má použít ve výchozím nastavení. | řetězec |
| proxyOverride | Typ připojení použitý pro připojení k instanci. | 'Default' 'Proxy' 'Redirect' |
| publicDataEndpointEnabled | Určuje, jestli je povolený veřejný datový koncový bod nebo ne. | bool |
| requestedBackupStorageRedundancy | Typ účtu úložiště, který se má použít k ukládání záloh pro tuto instanci. Možnosti jsou Místní (MístněRedundantStorage), Zóna (ZoneRedundantStorage), Geo (GeoRedundantStorage) a GeoZone(GeoZoneRedundantStorage) | 'Geo' 'GeoZone' 'Local' 'Zone' |
| requestedLogicalAvailabilityZone | Specifikuje logickou dostupnost, ke které je Managed Instance připnut. | '1' '2' '3' 'NoPreference' |
| restorePointInTime | Určuje bod v čase (formát ISO8601) zdrojové databáze, která se obnoví a vytvoří novou databázi. | řetězec |
| servicePrincipal | Instanční objekt spravované instance. | ServicePrincipal |
| sourceManagedInstanceId | Identifikátorprostředkuho | řetězec |
| storageIOps | Úložiště IOps. Minimální hodnota: 300. Maximální hodnota: 80000. Přírůstky 1 vstupně-výstupních operací za sekundu jsou povolené jenom. Maximální hodnota závisí na vybrané skupině hardwaru a počtu virtuálních jader. | int |
| storageSizeInGB | Velikost úložiště v GB. Minimální hodnota: 32. Maximální hodnota: 32768. Jsou povoleny pouze přírůstky o 32 GB. Maximální hodnota závisí na vybrané skupině hardwaru a počtu virtuálních jader. | int |
| storageThroughputMBps | Parametr MBps propustnosti úložiště se v operaci vytvoření nebo aktualizace instance nepodporuje. | int |
| subnetId | ID prostředku podsítě pro spravovanou instanci. | řetězec |
| timezoneId | ID časového pásma. Povolené hodnoty jsou časová pásma podporovaná Windows. Windows uchovává podrobnosti o podporovaných časových pásmech, včetně ID, v registru v sekci KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Tyto hodnoty registru můžete získat přes SQL Server dotazem SELECT name AS timezone_id FROM sys.time_zone_info. Seznam ID lze získat také spuštěním příkazu [System.TimeZoneInfo]::GetSystemTimeZones() v PowerShellu. Příkladem platného ID časového pásma je Tichomoří (běžný čas) nebo W. Evropský standardní čas". |
řetězec |
| vCores | Počet virtuálních jader. Povolené hodnoty: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Podporovaná virtuální jádra závisí na vybrané rodině hardwaru a úrovni služby. | int |
| zoneRedundant | Zda je povolena zónová redundance. | bool |
ResourceIdentity
| Name | Description | Value |
|---|---|---|
| typ | Typ identity. Nastavte to na 'SystemAssigned', abyste automaticky vytvořili a přiřadili princip Azure Active Directory pro tento zdroj. | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' |
| userAssignedIdentities | ID prostředků identit přiřazených uživatelem, které se mají použít | ResourceIdentityUserAssignedIdentities |
ResourceIdentityUserAssignedIdentities
| Name | Description | Value |
|---|
ServicePrincipal
| Name | Description | Value |
|---|---|---|
| typ | Typ instančního objektu. | 'None' 'SystemAssigned' |
Sku
| Name | Description | Value |
|---|---|---|
| kapacita | Kapacita konkrétní skladové položky. | int |
| family | Pokud má služba různé generace hardwaru, pro stejnou skladovou položku, můžete ji zde zachytit. | řetězec |
| name | Název skladové položky, obvykle písmeno + číslo, např. P3. | string (povinné) |
| size | Velikost konkrétní skladové položky | řetězec |
| přesunout do jiné vrstvy | Úroveň nebo edice konkrétní skladové položky, např. Basic, Premium. | řetězec |
TrackedResourceTags
| Name | Description | Value |
|---|
UserIdentity
| Name | Description | Value |
|---|
Příklady použití
Ověřené moduly Azure
Následující Azure ověřené moduly lze použít k nasazení tohoto typu zdroje.
| Module | Description |
|---|---|
| SQL spravovaná instance | AVM Resource Module pro SQL Managed Instance |
Ukázky rychlého startu Azure
Následující šablony Azure Quickstart obsahují Bicep vzorky pro nasazení tohoto typu zdroje.
| Soubor Bicep | Description |
|---|---|
| Vytvořte SQL MI v nové virtuální síti | Nasadit Azure SQL Database Managed Instance (SQL MI) uvnitř nové Virtual Network. |
Definice prostředku šablony ARM
Typ prostředku managedInstances je možné nasadit s operacemi, které cílí:
- skupiny prostředků – viz příkazy nasazení skupiny prostředků
Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.
Formát prostředku
Vytvořit Microsoft. Zdroj Sql/ManagedInstances, přidejte následující JSON do své šablony.
{
"type": "Microsoft.Sql/managedInstances",
"apiVersion": "2025-02-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",
"memorySizeInGB": "int",
"minimalTlsVersion": "string",
"pricingModel": "string",
"primaryUserAssignedIdentityId": "string",
"proxyOverride": "string",
"publicDataEndpointEnabled": "bool",
"requestedBackupStorageRedundancy": "string",
"requestedLogicalAvailabilityZone": "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"
},
"tags": {
"{customized property}": "string"
}
}
Hodnoty vlastností
Microsoft. Sql/managedInstance
| Name | Description | Value |
|---|---|---|
| apiVersion | Verze rozhraní API | 2025-02-01-preview |
| identita | Identita Azure Active Directory spravované instance. | ResourceIdentity |
| poloha | Geografické umístění, ve kterém se nachází zdroj | string (povinné) |
| name | Název prostředku | string (povinné) |
| properties | Vlastnosti prostředku. | ManagedInstanceProperties |
| sku | Skladová položka spravované instance Povolené hodnoty pro sku.name: GP_Gen5 (Pro obecné použití, řada Standard); GP_G8IM (pro všeobecné použití, řada Premium); GP_G8IH (pro všeobecné použití, optimalizováno pro paměť řady Premium); BC_Gen5 (Důležité obchodní informace, Standard-Series); BC_G8IM (Pro důležité obchodní informace, řada Premium); BC_G8IH (Pro důležité obchodní informace, optimalizováno pro paměť řady Premium). | Sku |
| tags | Štítky prostředků | Slovník názvů a hodnot značek Viz Značky v šablonách |
| typ | Typ prostředku | 'Microsoft. Sql/managedInstances' |
ManagedInstanceExternalAdministrator
| Name | Description | Value |
|---|---|---|
| administratorType | Typ správce serveru. | 'ActiveDirectory' |
| azureADOnlyAuthentication | Azure Active Directory pouze Authentication povolen. | bool |
| login | Přihlašovací jméno správce serveru. | řetězec |
| principalType | Hlavní typ správce serveru. | 'Application' 'Group' 'User' |
| sid | IDENTIFIKÁTOR SID (ID objektu) správce serveru. | string Constraints: Minimální délka = 36 Maximální délka = 36 Model = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| tenantId | ID tenanta správce. | string Constraints: Minimální délka = 36 Maximální délka = 36 Model = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
ManagedInstanceProperties
| Name | Description | Value |
|---|---|---|
| administratorLogin | Uživatelské jméno správce pro spravovanou instanci. Je možné zadat pouze při vytváření spravované instance (a vyžaduje se k vytvoření). | řetězec |
| administratorLoginPassword | Přihlašovací heslo správce (vyžaduje se k vytvoření spravované instance). | string Constraints: Citlivá hodnota. Předejte ho jako zabezpečený parametr. |
| administrators | Správce Azure Active Directory lze využít při vytváření instance a například při aktualizacích, kromě vlastnosti azureADOnlyAuthentication. Pokud chcete aktualizovat vlastnost azureADOnlyAuthentication, je nutné použít jednotlivé rozhraní API. | ManagedInstanceExternalAdministrator |
| authenticationMetadata | Režim vyhledávání metadat ověřování spravované instance. | 'AzureAD' 'Paired' 'Windows' |
| kolace | Kolace spravované instance | řetězec |
| databaseFormat | Určuje interní formát databází instancí specifických pro verzi modulu SQL. | 'AlwaysUpToDate' 'SQLServer2022' 'SQLServer2025' |
| dnsZonePartner | ID prostředku jiné spravované instance, jejíž zóna DNS bude tato spravovaná instance sdílet po vytvoření. | řetězec |
| hybridSecondaryUsage | Hybridní sekundární využití. Možné hodnoty jsou Aktivní (výchozí hodnota) a Pasivní (zákazník používá sekundární hodnotu jako pasivní zotavení po havárii). | 'Active' 'Passive' |
| instancePoolId | ID fondu instancí, do které tento spravovaný server patří. | řetězec |
| isGeneralPurposeV2 | Určuje, jestli se jedná o variantu GPv2 edice Pro obecné účely. | bool |
| keyId | Identifikátor URI klíče CMK, který se má použít k šifrování. | řetězec |
| licenseType | Typ licence. Možné hodnoty jsou LicenseIncluded (běžná cena včetně nové licence SQL) a BasePrice (zvýhodněná cena AHB za používání vlastních licencí SQL). | 'BasePrice' 'LicenseIncluded' |
| maintenanceConfigurationId | Určuje ID konfigurace údržby, které se má použít pro tuto spravovanou instanci. | řetězec |
| managedInstanceCreateMode | Určuje režim vytváření databáze. Výchozí hodnota: Vytvoření pravidelné instance. Obnovení: Vytvoří instanci obnovením sady záloh k určitému bodu v čase. Musí být zadány hodnoty RestorePointInTime a SourceManagedInstanceId. |
'Default' 'PointInTimeRestore' |
| memorySizeInGB | Velikost paměti v GB. Minimální hodnota: 28. Maximální hodnota: 870. Minimální a maximální hodnota závisí na počtu virtuálních jader a úrovni služby. Přečtěte si více o omezeních zdrojů: https://aka.ms/mi-resource-limits-api. | int |
| minimalTlsVersion | Minimální verze protokolu TLS. Povolené hodnoty: None, 1.0, 1.1, 1.2 | řetězec |
| pricingModel | Cenový model Managed Instance. | 'Freemium' 'Regular' |
| primaryUserAssignedIdentityId | ID prostředku identity přiřazené uživatelem, které se má použít ve výchozím nastavení. | řetězec |
| proxyOverride | Typ připojení použitý pro připojení k instanci. | 'Default' 'Proxy' 'Redirect' |
| publicDataEndpointEnabled | Určuje, jestli je povolený veřejný datový koncový bod nebo ne. | bool |
| requestedBackupStorageRedundancy | Typ účtu úložiště, který se má použít k ukládání záloh pro tuto instanci. Možnosti jsou Místní (MístněRedundantStorage), Zóna (ZoneRedundantStorage), Geo (GeoRedundantStorage) a GeoZone(GeoZoneRedundantStorage) | 'Geo' 'GeoZone' 'Local' 'Zone' |
| requestedLogicalAvailabilityZone | Specifikuje logickou dostupnost, ke které je Managed Instance připnut. | '1' '2' '3' 'NoPreference' |
| restorePointInTime | Určuje bod v čase (formát ISO8601) zdrojové databáze, která se obnoví a vytvoří novou databázi. | řetězec |
| servicePrincipal | Instanční objekt spravované instance. | ServicePrincipal |
| sourceManagedInstanceId | Identifikátorprostředkuho | řetězec |
| storageIOps | Úložiště IOps. Minimální hodnota: 300. Maximální hodnota: 80000. Přírůstky 1 vstupně-výstupních operací za sekundu jsou povolené jenom. Maximální hodnota závisí na vybrané skupině hardwaru a počtu virtuálních jader. | int |
| storageSizeInGB | Velikost úložiště v GB. Minimální hodnota: 32. Maximální hodnota: 32768. Jsou povoleny pouze přírůstky o 32 GB. Maximální hodnota závisí na vybrané skupině hardwaru a počtu virtuálních jader. | int |
| storageThroughputMBps | Parametr MBps propustnosti úložiště se v operaci vytvoření nebo aktualizace instance nepodporuje. | int |
| subnetId | ID prostředku podsítě pro spravovanou instanci. | řetězec |
| timezoneId | ID časového pásma. Povolené hodnoty jsou časová pásma podporovaná Windows. Windows uchovává podrobnosti o podporovaných časových pásmech, včetně ID, v registru v sekci KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Tyto hodnoty registru můžete získat přes SQL Server dotazem SELECT name AS timezone_id FROM sys.time_zone_info. Seznam ID lze získat také spuštěním příkazu [System.TimeZoneInfo]::GetSystemTimeZones() v PowerShellu. Příkladem platného ID časového pásma je Tichomoří (běžný čas) nebo W. Evropský standardní čas". |
řetězec |
| vCores | Počet virtuálních jader. Povolené hodnoty: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Podporovaná virtuální jádra závisí na vybrané rodině hardwaru a úrovni služby. | int |
| zoneRedundant | Zda je povolena zónová redundance. | bool |
ResourceIdentity
| Name | Description | Value |
|---|---|---|
| typ | Typ identity. Nastavte to na 'SystemAssigned', abyste automaticky vytvořili a přiřadili princip Azure Active Directory pro tento zdroj. | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' |
| userAssignedIdentities | ID prostředků identit přiřazených uživatelem, které se mají použít | ResourceIdentityUserAssignedIdentities |
ResourceIdentityUserAssignedIdentities
| Name | Description | Value |
|---|
ServicePrincipal
| Name | Description | Value |
|---|---|---|
| typ | Typ instančního objektu. | 'None' 'SystemAssigned' |
Sku
| Name | Description | Value |
|---|---|---|
| kapacita | Kapacita konkrétní skladové položky. | int |
| family | Pokud má služba různé generace hardwaru, pro stejnou skladovou položku, můžete ji zde zachytit. | řetězec |
| name | Název skladové položky, obvykle písmeno + číslo, např. P3. | string (povinné) |
| size | Velikost konkrétní skladové položky | řetězec |
| přesunout do jiné vrstvy | Úroveň nebo edice konkrétní skladové položky, např. Basic, Premium. | řetězec |
TrackedResourceTags
| Name | Description | Value |
|---|
UserIdentity
| Name | Description | Value |
|---|
Příklady použití
šablony pro rychlý start pro Azure
Následující Azure Šablony Quickstart nasazují tento typ zdroje.
| Template | Description |
|---|---|
|
Vytvořte SQL MI v nové virtuální síti |
Nasadit Azure SQL Database Managed Instance (SQL MI) uvnitř nové Virtual Network. |
|
Vytvořte SQL MI s konfigurovaným odesíláním logů a metrik |
Tato šablona umožňuje nasadit SQL MI a další prostředky používané k ukládání protokolů a metrik (diagnostický pracovní prostor, účet úložiště, centrum událostí). |
|
Vytvořte SQL MI pomocí jumpboxu uvnitř nové virtuální sítě |
Nasazujte Azure SQL Database Managed Instance (SQL MI) a JumpBox se SSMS v nové Virtual Network. |
|
Create SQL MI s point-to-site connection configured |
Nasazujte Azure SQL Database Managed Instance (SQL MI) a virtuální síťovou bránu nakonfigurovanou pro point-to-site připojení v nové virtuální síti. |
|
Nasadit SQL Managed Instance pomocí Networking |
Nasadit UDR a NSG pro podporu Azure SQL Managed Instance a nasadit Managed Instance |
Definice prostředku Terraformu (poskytovatel AzAPI)
Typ prostředku managedInstances je možné nasadit s operacemi, které cílí:
- skupiny prostředků
Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.
Formát prostředku
Vytvořit Microsoft. Zdroj Sql/ManagedInstances, přidejte následující Terraform do své šablony.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Sql/managedInstances@2025-02-01-preview"
name = "string"
parent_id = "string"
identity {
type = "string"
identity_ids = [
"string"
]
}
location = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
administratorLogin = "string"
administratorLoginPassword = "string"
administrators = {
administratorType = "string"
azureADOnlyAuthentication = bool
login = "string"
principalType = "string"
sid = "string"
tenantId = "string"
}
authenticationMetadata = "string"
collation = "string"
databaseFormat = "string"
dnsZonePartner = "string"
hybridSecondaryUsage = "string"
instancePoolId = "string"
isGeneralPurposeV2 = bool
keyId = "string"
licenseType = "string"
maintenanceConfigurationId = "string"
managedInstanceCreateMode = "string"
memorySizeInGB = int
minimalTlsVersion = "string"
pricingModel = "string"
primaryUserAssignedIdentityId = "string"
proxyOverride = "string"
publicDataEndpointEnabled = bool
requestedBackupStorageRedundancy = "string"
requestedLogicalAvailabilityZone = "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"
}
}
}
Hodnoty vlastností
Microsoft. Sql/managedInstance
| Name | Description | Value |
|---|---|---|
| identita | Identita Azure Active Directory spravované instance. | ResourceIdentity |
| poloha | Geografické umístění, ve kterém se nachází zdroj | string (povinné) |
| name | Název prostředku | string (povinné) |
| properties | Vlastnosti prostředku. | ManagedInstanceProperties |
| sku | Skladová položka spravované instance Povolené hodnoty pro sku.name: GP_Gen5 (Pro obecné použití, řada Standard); GP_G8IM (pro všeobecné použití, řada Premium); GP_G8IH (pro všeobecné použití, optimalizováno pro paměť řady Premium); BC_Gen5 (Důležité obchodní informace, Standard-Series); BC_G8IM (Pro důležité obchodní informace, řada Premium); BC_G8IH (Pro důležité obchodní informace, optimalizováno pro paměť řady Premium). | Sku |
| tags | Štítky prostředků | Slovník názvů a hodnot značek |
| typ | Typ prostředku | "Microsoft. Sql/managedInstances@2025-02-01-preview" |
ManagedInstanceExternalAdministrator
| Name | Description | Value |
|---|---|---|
| administratorType | Typ správce serveru. | 'ActiveDirectory' |
| azureADOnlyAuthentication | Azure Active Directory pouze Authentication povolen. | bool |
| login | Přihlašovací jméno správce serveru. | řetězec |
| principalType | Hlavní typ správce serveru. | 'Application' 'Group' 'User' |
| sid | IDENTIFIKÁTOR SID (ID objektu) správce serveru. | string Constraints: Minimální délka = 36 Maximální délka = 36 Model = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| tenantId | ID tenanta správce. | string Constraints: Minimální délka = 36 Maximální délka = 36 Model = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
ManagedInstanceProperties
| Name | Description | Value |
|---|---|---|
| administratorLogin | Uživatelské jméno správce pro spravovanou instanci. Je možné zadat pouze při vytváření spravované instance (a vyžaduje se k vytvoření). | řetězec |
| administratorLoginPassword | Přihlašovací heslo správce (vyžaduje se k vytvoření spravované instance). | string Constraints: Citlivá hodnota. Předejte ho jako zabezpečený parametr. |
| administrators | Správce Azure Active Directory lze využít při vytváření instance a například při aktualizacích, kromě vlastnosti azureADOnlyAuthentication. Pokud chcete aktualizovat vlastnost azureADOnlyAuthentication, je nutné použít jednotlivé rozhraní API. | ManagedInstanceExternalAdministrator |
| authenticationMetadata | Režim vyhledávání metadat ověřování spravované instance. | 'AzureAD' 'Paired' 'Windows' |
| kolace | Kolace spravované instance | řetězec |
| databaseFormat | Určuje interní formát databází instancí specifických pro verzi modulu SQL. | 'AlwaysUpToDate' 'SQLServer2022' 'SQLServer2025' |
| dnsZonePartner | ID prostředku jiné spravované instance, jejíž zóna DNS bude tato spravovaná instance sdílet po vytvoření. | řetězec |
| hybridSecondaryUsage | Hybridní sekundární využití. Možné hodnoty jsou Aktivní (výchozí hodnota) a Pasivní (zákazník používá sekundární hodnotu jako pasivní zotavení po havárii). | 'Active' 'Passive' |
| instancePoolId | ID fondu instancí, do které tento spravovaný server patří. | řetězec |
| isGeneralPurposeV2 | Určuje, jestli se jedná o variantu GPv2 edice Pro obecné účely. | bool |
| keyId | Identifikátor URI klíče CMK, který se má použít k šifrování. | řetězec |
| licenseType | Typ licence. Možné hodnoty jsou LicenseIncluded (běžná cena včetně nové licence SQL) a BasePrice (zvýhodněná cena AHB za používání vlastních licencí SQL). | 'BasePrice' 'LicenseIncluded' |
| maintenanceConfigurationId | Určuje ID konfigurace údržby, které se má použít pro tuto spravovanou instanci. | řetězec |
| managedInstanceCreateMode | Určuje režim vytváření databáze. Výchozí hodnota: Vytvoření pravidelné instance. Obnovení: Vytvoří instanci obnovením sady záloh k určitému bodu v čase. Musí být zadány hodnoty RestorePointInTime a SourceManagedInstanceId. |
'Default' 'PointInTimeRestore' |
| memorySizeInGB | Velikost paměti v GB. Minimální hodnota: 28. Maximální hodnota: 870. Minimální a maximální hodnota závisí na počtu virtuálních jader a úrovni služby. Přečtěte si více o omezeních zdrojů: https://aka.ms/mi-resource-limits-api. | int |
| minimalTlsVersion | Minimální verze protokolu TLS. Povolené hodnoty: None, 1.0, 1.1, 1.2 | řetězec |
| pricingModel | Cenový model Managed Instance. | 'Freemium' 'Regular' |
| primaryUserAssignedIdentityId | ID prostředku identity přiřazené uživatelem, které se má použít ve výchozím nastavení. | řetězec |
| proxyOverride | Typ připojení použitý pro připojení k instanci. | 'Default' 'Proxy' 'Redirect' |
| publicDataEndpointEnabled | Určuje, jestli je povolený veřejný datový koncový bod nebo ne. | bool |
| requestedBackupStorageRedundancy | Typ účtu úložiště, který se má použít k ukládání záloh pro tuto instanci. Možnosti jsou Místní (MístněRedundantStorage), Zóna (ZoneRedundantStorage), Geo (GeoRedundantStorage) a GeoZone(GeoZoneRedundantStorage) | 'Geo' 'GeoZone' 'Local' 'Zone' |
| requestedLogicalAvailabilityZone | Specifikuje logickou dostupnost, ke které je Managed Instance připnut. | '1' '2' '3' 'NoPreference' |
| restorePointInTime | Určuje bod v čase (formát ISO8601) zdrojové databáze, která se obnoví a vytvoří novou databázi. | řetězec |
| servicePrincipal | Instanční objekt spravované instance. | ServicePrincipal |
| sourceManagedInstanceId | Identifikátorprostředkuho | řetězec |
| storageIOps | Úložiště IOps. Minimální hodnota: 300. Maximální hodnota: 80000. Přírůstky 1 vstupně-výstupních operací za sekundu jsou povolené jenom. Maximální hodnota závisí na vybrané skupině hardwaru a počtu virtuálních jader. | int |
| storageSizeInGB | Velikost úložiště v GB. Minimální hodnota: 32. Maximální hodnota: 32768. Jsou povoleny pouze přírůstky o 32 GB. Maximální hodnota závisí na vybrané skupině hardwaru a počtu virtuálních jader. | int |
| storageThroughputMBps | Parametr MBps propustnosti úložiště se v operaci vytvoření nebo aktualizace instance nepodporuje. | int |
| subnetId | ID prostředku podsítě pro spravovanou instanci. | řetězec |
| timezoneId | ID časového pásma. Povolené hodnoty jsou časová pásma podporovaná Windows. Windows uchovává podrobnosti o podporovaných časových pásmech, včetně ID, v registru v sekci KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Tyto hodnoty registru můžete získat přes SQL Server dotazem SELECT name AS timezone_id FROM sys.time_zone_info. Seznam ID lze získat také spuštěním příkazu [System.TimeZoneInfo]::GetSystemTimeZones() v PowerShellu. Příkladem platného ID časového pásma je Tichomoří (běžný čas) nebo W. Evropský standardní čas". |
řetězec |
| vCores | Počet virtuálních jader. Povolené hodnoty: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Podporovaná virtuální jádra závisí na vybrané rodině hardwaru a úrovni služby. | int |
| zoneRedundant | Zda je povolena zónová redundance. | bool |
ResourceIdentity
| Name | Description | Value |
|---|---|---|
| typ | Typ identity. Nastavte to na 'SystemAssigned', abyste automaticky vytvořili a přiřadili princip Azure Active Directory pro tento zdroj. | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' |
| userAssignedIdentities | ID prostředků identit přiřazených uživatelem, které se mají použít | ResourceIdentityUserAssignedIdentities |
ResourceIdentityUserAssignedIdentities
| Name | Description | Value |
|---|
ServicePrincipal
| Name | Description | Value |
|---|---|---|
| typ | Typ instančního objektu. | 'None' 'SystemAssigned' |
Sku
| Name | Description | Value |
|---|---|---|
| kapacita | Kapacita konkrétní skladové položky. | int |
| family | Pokud má služba různé generace hardwaru, pro stejnou skladovou položku, můžete ji zde zachytit. | řetězec |
| name | Název skladové položky, obvykle písmeno + číslo, např. P3. | string (povinné) |
| size | Velikost konkrétní skladové položky | řetězec |
| přesunout do jiné vrstvy | Úroveň nebo edice konkrétní skladové položky, např. Basic, Premium. | řetězec |
TrackedResourceTags
| Name | Description | Value |
|---|
UserIdentity
| Name | Description | Value |
|---|
Příklady použití
Ověřené moduly Azure
Následující Azure ověřené moduly lze použít k nasazení tohoto typu zdroje.
| Module | Description |
|---|---|
| SQL spravovaná instance | AVM Resource Module pro SQL Managed Instance |