- Latest
- 2025-02-01-preview
- 2025-01-01
- 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
Bicep 資源定義
managedInstances 資源類型可以使用目標作業來部署：
- 資源群組 - 請參閱 資源群組部署命令
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
資源格式
創造一個 Microsoft。Sql/managedInstances 資源，請將以下 Bicep 加入你的範本。
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'
}
}
屬性值
Microsoft。Sql/managedInstances
| Name | Description | Value |
|---|---|---|
| 身分識別 | 管理實例的 Azure Active Directory 身份。 | ResourceIdentity |
| 位置 | 資源所在的地理位置 | 字串 （必要） |
| name | 資源名稱 | 字串 （必要） |
| properties | 資源屬性。 | ManagedInstanceProperties |
| sku | 受控實例 SKU。 sku.name 允許的值：GP_Gen5（通用，標準系列）;GP_G8IM（通用，高級系列）;GP_G8IH（通用，高級系列記憶體優化）;BC_Gen5（關鍵業務，Standard-Series）;BC_G8IM（關鍵業務，高級系列）;BC_G8IH（業務關鍵型，高級系列記憶體優化）。 | Sku |
| tags | 資源標籤 | 標記名稱和值的字典。 請參閱範本中的 標籤 |
ManagedInstanceExternalAdministrator
| Name | Description | Value |
|---|---|---|
| administratorType | 伺服器管理員的類型。 | 'ActiveDirectory' |
| azureADOnlyAuthentication | Azure Active Directory only authentication enabled. | bool |
| login | 伺服器管理員的登入名稱。 | 字串 |
| principalType | 伺服器管理員的主體類型。 | 'Application' 'Group' 'User' |
| sid | 伺服器管理員的 SID （物件識別符）。 | string Constraints: 最小長度 = 36 最大長度 = 36 圖案 = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| tenantId | 系統管理員的租用戶標識碼。 | string Constraints: 最小長度 = 36 最大長度 = 36 圖案 = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
ManagedInstanceProperties
| Name | Description | Value |
|---|---|---|
| administratorLogin | 受控實例的系統管理員用戶名稱。 只有在建立受控實例時才能指定 （而且是建立的必要專案）。 | 字串 |
| administratorLoginPassword | 系統管理員登入密碼（建立受控實例所需的密碼）。 | string Constraints: 敏感性值。 以安全參數的形式傳入。 |
| administrators | Azure Active Directory 管理員可在實例建立及實例更新時使用，但 azureADOnlyAuthentication 屬性除外。 若要更新 azureADOnlyAuthentication 屬性，必須使用單個 API。 | ManagedInstanceExternalAdministrator |
| authenticationMetadata | 受控實例的驗證元數據查閱模式。 | 'AzureAD' 'Paired' 「Windows」 |
| 定序 | 受控實例的定序。 | 字串 |
| databaseFormat | 指定 SQL 引擎版本專屬實例資料庫的內部格式。 | 'AlwaysUpToDate' 'SQLServer2022' “SQLServer2025” |
| dnsZonePartner | 另一個受控實例的資源標識符，此受控實例會在建立後共用其 DNS 區域。 | 字串 |
| hybridSecondaryUsage | 混合式次要使用量。 可能的值為 「主動」（預設值）和「被動」（客戶使用次要做為被動DR）。 | 'Active' 'Passive' |
| instancePoolId | 這個受控伺服器所屬之實例集區的標識碼。 | 字串 |
| isGeneralPurposeV2 | 這是否為一般用途版本的 GPv2 變體。 | bool |
| keyId | 要用於加密之金鑰的 CMK URI。 | 字串 |
| licenseType | 授權類型。 可能的值為 'LicenseIncluded' （包含新 SQL 授權的一般價格） 和 'BasePrice' （為攜帶您自己的 SQL 授權而折扣 AHB 價格）。 | 'BasePrice' 'LicenseIncluded' |
| maintenanceConfigurationId | 指定要套用至這個受控實例的維護組態標識碼。 | 字串 |
| managedInstanceCreateMode | 指定資料庫建立模式。 默認值：定期建立實例。 還原：藉由將一組備份還原至特定時間點來建立實例。 必須指定 RestorePointInTime 和 SourceManagedInstanceId。 |
'Default' 'PointInTimeRestore' |
| 記憶體大小以GB | 記憶體大小（以 GB 為單位）。 最小值：28。 最大值：870。 最小值和最大值取決於 vCore 數和服務層級。 閱讀有關資源限制的更多資訊： https://aka.ms/mi-resource-limits-api。 | int |
| minimalTlsVersion | 最低 TLS 版本。 允許的值：'None'、'1.0'、'1.1'、'1.2' | 字串 |
| pricingModel | Managed Instance 的定價模式。 | 'Freemium' 'Regular' |
| primaryUserAssignedIdentityId | 預設會使用之使用者指派身分識別的資源標識碼。 | 字串 |
| proxyOverride | 用於連接到實例的連接類型。 | 'Default' 'Proxy' 'Redirect' |
| publicDataEndpointEnabled | 是否啟用公用資料端點。 | bool |
| requestedBackupStorageRedundancy | 要用來儲存此實例備份的記憶體帳戶類型。 選項為 Local （LocalRedundantStorage）、Zone （ZoneRedundantStorage）、Geo （GeoRedundantStorage） 和 GeoZone（GeoZoneRedundantStorage） | 'Geo' 'GeoZone' 'Local' 'Zone' |
| requestedLogicalAvailability區域 | 指定 Managed Instance 釘選的邏輯可用性區域。 | '1' '2' '3' 'NoPreference' |
| restorePointInTime | 指定要還原以建立新資料庫的源資料庫的時間點（ISO8601格式）。 | 字串 |
| servicePrincipal | 受控實例的服務主體。 | ServicePrincipal |
| sourceManagedInstanceId | 與這個實例建立作業相關聯的來源受控實例資源標識符。 | 字串 |
| storageIOps | 儲存體 IOps。 最小值：300。 最大值：80000。 僅允許 1 個 IOps 的增量。 最大值取決於選取的硬體系列和虛擬核心數目。 | int |
| storageSizeInGB | 以 GB 為單位的記憶體大小。 最小值：32。 最大值：32768。 僅允許 32 GB 的增量。 最大值取決於選取的硬體系列和虛擬核心數目。 | int |
| storageThroughputMBps | 實例建立/更新作業不支持記憶體輸送量 MBps 參數。 | int |
| subnetId | 受控實例的子網資源標識碼。 | 字串 |
| timezoneId | 時區的標識碼。 允許的值是指 Windows 支援的時區。 Windows 會在登錄檔中保存支援時區的詳細資訊，包括 ID，這些資訊都在登錄檔中 KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones。 你可以透過查詢 SELECT 名稱作為 timezone_id FROM sys.time_zone_info，取得這些登錄檔值SQL Server。 您也可以在 PowerShell 中執行 [System.TimeZoneInfo]：：GetSystemTimeZones（） 來取得標識符清單。 有效的時區標識符範例是 「Pacific Standard Time」 或 「W」。。 歐洲標準時間“。 |
字串 |
| vCores | 虛擬核心數目。 允許的值：4、6、8、10、12、16、20、24、32、40、48、56、64、80、96、128。 支援的 vCore 取決於所選的硬體系列和服務層級。 | int |
| zoneRedundant | 是否啟用區域冗餘。 | bool |
ResourceIdentity
| Name | Description | Value |
|---|---|---|
| 型別 | 識別類型。 請將此設定為「SystemAssigned」，以自動建立並指派該資源的 Azure Active Directory 主體。 | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' |
| userAssignedIdentities | 要使用的使用者指派身分識別的資源標識碼 | ResourceIdentityUserAssignedIdentities |
ResourceIdentityUserAssignedIdentities
| Name | Description | Value |
|---|
ServicePrincipal
| Name | Description | Value |
|---|---|---|
| 型別 | 服務主體類型。 | 'None' 'SystemAssigned' |
Sku
| Name | Description | Value |
|---|---|---|
| 容量 | 特定 SKU 的容量。 | int |
| family | 如果服務有不同世代的硬體，針對相同的 SKU，則可以在這裡擷取。 | 字串 |
| name | SKU 的名稱，通常是字母 + 數位碼，例如 P3。 | 字串 （必要） |
| size | 特定 SKU 的大小 | 字串 |
| 分層 | 特定 SKU 的階層或版本，例如基本、進階。 | 字串 |
TrackedResourceTags
| Name | Description | Value |
|---|
UserIdentity
| Name | Description | Value |
|---|
使用範例
Azure 已驗證的模組
以下的 Azure 已驗證模組 可用於部署此資源類型。
| Module | Description |
|---|---|
| SQL 受控執行個體 | SQL Managed Instance 的 AVM 資源模組 |
Azure Quickstart Samples
以下的 Azure 快速啟動範本包含部署此資源類型的Bicep範例。
| Bicep檔案 | Description |
|---|---|
| 在新 Virtual Network 中部署 Azure SQL Database Managed Instance （SQL MI）。 |
ARM 樣本資源定義
managedInstances 資源類型可以使用目標作業來部署：
- 資源群組 - 請參閱 資源群組部署命令
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
資源格式
創造一個 Microsoft。Sql/managedInstances 資源，將以下 JSON 加入你的範本。
{
"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"
}
}
屬性值
Microsoft。Sql/managedInstances
| Name | Description | Value |
|---|---|---|
| apiVersion | API 版本 | “2025-02-01-預覽” |
| 身分識別 | 管理實例的 Azure Active Directory 身份。 | ResourceIdentity |
| 位置 | 資源所在的地理位置 | 字串 （必要） |
| name | 資源名稱 | 字串 （必要） |
| properties | 資源屬性。 | ManagedInstanceProperties |
| sku | 受控實例 SKU。 sku.name 允許的值：GP_Gen5（通用，標準系列）;GP_G8IM（通用，高級系列）;GP_G8IH（通用，高級系列記憶體優化）;BC_Gen5（關鍵業務，Standard-Series）;BC_G8IM（關鍵業務，高級系列）;BC_G8IH（業務關鍵型，高級系列記憶體優化）。 | Sku |
| tags | 資源標籤 | 標記名稱和值的字典。 請參閱範本中的 標籤 |
| 型別 | 資源類型 | 「Microsoft。Sql/managedInstances' |
ManagedInstanceExternalAdministrator
| Name | Description | Value |
|---|---|---|
| administratorType | 伺服器管理員的類型。 | 'ActiveDirectory' |
| azureADOnlyAuthentication | Azure Active Directory only authentication enabled. | bool |
| login | 伺服器管理員的登入名稱。 | 字串 |
| principalType | 伺服器管理員的主體類型。 | 'Application' 'Group' 'User' |
| sid | 伺服器管理員的 SID （物件識別符）。 | string Constraints: 最小長度 = 36 最大長度 = 36 圖案 = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| tenantId | 系統管理員的租用戶標識碼。 | string Constraints: 最小長度 = 36 最大長度 = 36 圖案 = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
ManagedInstanceProperties
| Name | Description | Value |
|---|---|---|
| administratorLogin | 受控實例的系統管理員用戶名稱。 只有在建立受控實例時才能指定 （而且是建立的必要專案）。 | 字串 |
| administratorLoginPassword | 系統管理員登入密碼（建立受控實例所需的密碼）。 | string Constraints: 敏感性值。 以安全參數的形式傳入。 |
| administrators | Azure Active Directory 管理員可在實例建立及實例更新時使用，但 azureADOnlyAuthentication 屬性除外。 若要更新 azureADOnlyAuthentication 屬性，必須使用單個 API。 | ManagedInstanceExternalAdministrator |
| authenticationMetadata | 受控實例的驗證元數據查閱模式。 | 'AzureAD' 'Paired' 「Windows」 |
| 定序 | 受控實例的定序。 | 字串 |
| databaseFormat | 指定 SQL 引擎版本專屬實例資料庫的內部格式。 | 'AlwaysUpToDate' 'SQLServer2022' “SQLServer2025” |
| dnsZonePartner | 另一個受控實例的資源標識符，此受控實例會在建立後共用其 DNS 區域。 | 字串 |
| hybridSecondaryUsage | 混合式次要使用量。 可能的值為 「主動」（預設值）和「被動」（客戶使用次要做為被動DR）。 | 'Active' 'Passive' |
| instancePoolId | 這個受控伺服器所屬之實例集區的標識碼。 | 字串 |
| isGeneralPurposeV2 | 這是否為一般用途版本的 GPv2 變體。 | bool |
| keyId | 要用於加密之金鑰的 CMK URI。 | 字串 |
| licenseType | 授權類型。 可能的值為 'LicenseIncluded' （包含新 SQL 授權的一般價格） 和 'BasePrice' （為攜帶您自己的 SQL 授權而折扣 AHB 價格）。 | 'BasePrice' 'LicenseIncluded' |
| maintenanceConfigurationId | 指定要套用至這個受控實例的維護組態標識碼。 | 字串 |
| managedInstanceCreateMode | 指定資料庫建立模式。 默認值：定期建立實例。 還原：藉由將一組備份還原至特定時間點來建立實例。 必須指定 RestorePointInTime 和 SourceManagedInstanceId。 |
'Default' 'PointInTimeRestore' |
| 記憶體大小以GB | 記憶體大小（以 GB 為單位）。 最小值：28。 最大值：870。 最小值和最大值取決於 vCore 數和服務層級。 閱讀有關資源限制的更多資訊： https://aka.ms/mi-resource-limits-api。 | int |
| minimalTlsVersion | 最低 TLS 版本。 允許的值：'None'、'1.0'、'1.1'、'1.2' | 字串 |
| pricingModel | Managed Instance 的定價模式。 | 'Freemium' 'Regular' |
| primaryUserAssignedIdentityId | 預設會使用之使用者指派身分識別的資源標識碼。 | 字串 |
| proxyOverride | 用於連接到實例的連接類型。 | 'Default' 'Proxy' 'Redirect' |
| publicDataEndpointEnabled | 是否啟用公用資料端點。 | bool |
| requestedBackupStorageRedundancy | 要用來儲存此實例備份的記憶體帳戶類型。 選項為 Local （LocalRedundantStorage）、Zone （ZoneRedundantStorage）、Geo （GeoRedundantStorage） 和 GeoZone（GeoZoneRedundantStorage） | 'Geo' 'GeoZone' 'Local' 'Zone' |
| requestedLogicalAvailability區域 | 指定 Managed Instance 釘選的邏輯可用性區域。 | '1' '2' '3' 'NoPreference' |
| restorePointInTime | 指定要還原以建立新資料庫的源資料庫的時間點（ISO8601格式）。 | 字串 |
| servicePrincipal | 受控實例的服務主體。 | ServicePrincipal |
| sourceManagedInstanceId | 與這個實例建立作業相關聯的來源受控實例資源標識符。 | 字串 |
| storageIOps | 儲存體 IOps。 最小值：300。 最大值：80000。 僅允許 1 個 IOps 的增量。 最大值取決於選取的硬體系列和虛擬核心數目。 | int |
| storageSizeInGB | 以 GB 為單位的記憶體大小。 最小值：32。 最大值：32768。 僅允許 32 GB 的增量。 最大值取決於選取的硬體系列和虛擬核心數目。 | int |
| storageThroughputMBps | 實例建立/更新作業不支持記憶體輸送量 MBps 參數。 | int |
| subnetId | 受控實例的子網資源標識碼。 | 字串 |
| timezoneId | 時區的標識碼。 允許的值是指 Windows 支援的時區。 Windows 會在登錄檔中保存支援時區的詳細資訊，包括 ID，這些資訊都在登錄檔中 KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones。 你可以透過查詢 SELECT 名稱作為 timezone_id FROM sys.time_zone_info，取得這些登錄檔值SQL Server。 您也可以在 PowerShell 中執行 [System.TimeZoneInfo]：：GetSystemTimeZones（） 來取得標識符清單。 有效的時區標識符範例是 「Pacific Standard Time」 或 「W」。。 歐洲標準時間“。 |
字串 |
| vCores | 虛擬核心數目。 允許的值：4、6、8、10、12、16、20、24、32、40、48、56、64、80、96、128。 支援的 vCore 取決於所選的硬體系列和服務層級。 | int |
| zoneRedundant | 是否啟用區域冗餘。 | bool |
ResourceIdentity
| Name | Description | Value |
|---|---|---|
| 型別 | 識別類型。 請將此設定為「SystemAssigned」，以自動建立並指派該資源的 Azure Active Directory 主體。 | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' |
| userAssignedIdentities | 要使用的使用者指派身分識別的資源標識碼 | ResourceIdentityUserAssignedIdentities |
ResourceIdentityUserAssignedIdentities
| Name | Description | Value |
|---|
ServicePrincipal
| Name | Description | Value |
|---|---|---|
| 型別 | 服務主體類型。 | 'None' 'SystemAssigned' |
Sku
| Name | Description | Value |
|---|---|---|
| 容量 | 特定 SKU 的容量。 | int |
| family | 如果服務有不同世代的硬體，針對相同的 SKU，則可以在這裡擷取。 | 字串 |
| name | SKU 的名稱，通常是字母 + 數位碼，例如 P3。 | 字串 （必要） |
| size | 特定 SKU 的大小 | 字串 |
| 分層 | 特定 SKU 的階層或版本，例如基本、進階。 | 字串 |
TrackedResourceTags
| Name | Description | Value |
|---|
UserIdentity
| Name | Description | Value |
|---|
使用範例
Azure Quickstart templates
以下的 Azure 快速起始範本部署此資源類型。
| Template | Description |
|---|---|
|
在新 Virtual Network 中部署 Azure SQL Database Managed Instance （SQL MI）。 |
|
建立 SQL MI，並設定日誌與指標的傳送
|
此範本可讓您部署用於儲存記錄和計量的 SQL MI 和其他資源（診斷工作區、記憶體帳戶、事件中樞）。 |
|
|
在新的 Virtual Network 中部署 Azure SQL Database Managed Instance（SQL MI）和 JumpBox，並搭配 SSMS。 |
|
建立設定點對站連線的 SQL MI
|
部署 Azure SQL Database Managed Instance（SQL MI）及虛擬網路閘道，並設定為點對點連線，位於新的虛擬網路內。 |
|
部署 SQL Managed Instance 與 Networking
|
部署 UDR 和 NSG 以支援 Azure SQL Managed Instance 並部署 Managed Instance |
Terraform （AzAPI 提供者） 資源定義
managedInstances 資源類型可以使用目標作業來部署：
- 資源群組
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
資源格式
創造一個 Microsoft。Sql/managedInstances 資源，將以下 Terraform 加入你的範本。
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"
}
}
}
屬性值
Microsoft。Sql/managedInstances
| Name | Description | Value |
|---|---|---|
| 身分識別 | 管理實例的 Azure Active Directory 身份。 | ResourceIdentity |
| 位置 | 資源所在的地理位置 | 字串 （必要） |
| name | 資源名稱 | 字串 （必要） |
| properties | 資源屬性。 | ManagedInstanceProperties |
| sku | 受控實例 SKU。 sku.name 允許的值：GP_Gen5（通用，標準系列）;GP_G8IM（通用，高級系列）;GP_G8IH（通用，高級系列記憶體優化）;BC_Gen5（關鍵業務，Standard-Series）;BC_G8IM（關鍵業務，高級系列）;BC_G8IH（業務關鍵型，高級系列記憶體優化）。 | Sku |
| tags | 資源標籤 | 標記名稱和值的字典。 |
| 型別 | 資源類型 | 「Microsoft。Sql/managedInstances@2025-02-01-preview” |
ManagedInstanceExternalAdministrator
| Name | Description | Value |
|---|---|---|
| administratorType | 伺服器管理員的類型。 | 'ActiveDirectory' |
| azureADOnlyAuthentication | Azure Active Directory only authentication enabled. | bool |
| login | 伺服器管理員的登入名稱。 | 字串 |
| principalType | 伺服器管理員的主體類型。 | 'Application' 'Group' 'User' |
| sid | 伺服器管理員的 SID （物件識別符）。 | string Constraints: 最小長度 = 36 最大長度 = 36 圖案 = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| tenantId | 系統管理員的租用戶標識碼。 | string Constraints: 最小長度 = 36 最大長度 = 36 圖案 = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
ManagedInstanceProperties
| Name | Description | Value |
|---|---|---|
| administratorLogin | 受控實例的系統管理員用戶名稱。 只有在建立受控實例時才能指定 （而且是建立的必要專案）。 | 字串 |
| administratorLoginPassword | 系統管理員登入密碼（建立受控實例所需的密碼）。 | string Constraints: 敏感性值。 以安全參數的形式傳入。 |
| administrators | Azure Active Directory 管理員可在實例建立及實例更新時使用，但 azureADOnlyAuthentication 屬性除外。 若要更新 azureADOnlyAuthentication 屬性，必須使用單個 API。 | ManagedInstanceExternalAdministrator |
| authenticationMetadata | 受控實例的驗證元數據查閱模式。 | 'AzureAD' 'Paired' 「Windows」 |
| 定序 | 受控實例的定序。 | 字串 |
| databaseFormat | 指定 SQL 引擎版本專屬實例資料庫的內部格式。 | 'AlwaysUpToDate' 'SQLServer2022' “SQLServer2025” |
| dnsZonePartner | 另一個受控實例的資源標識符，此受控實例會在建立後共用其 DNS 區域。 | 字串 |
| hybridSecondaryUsage | 混合式次要使用量。 可能的值為 「主動」（預設值）和「被動」（客戶使用次要做為被動DR）。 | 'Active' 'Passive' |
| instancePoolId | 這個受控伺服器所屬之實例集區的標識碼。 | 字串 |
| isGeneralPurposeV2 | 這是否為一般用途版本的 GPv2 變體。 | bool |
| keyId | 要用於加密之金鑰的 CMK URI。 | 字串 |
| licenseType | 授權類型。 可能的值為 'LicenseIncluded' （包含新 SQL 授權的一般價格） 和 'BasePrice' （為攜帶您自己的 SQL 授權而折扣 AHB 價格）。 | 'BasePrice' 'LicenseIncluded' |
| maintenanceConfigurationId | 指定要套用至這個受控實例的維護組態標識碼。 | 字串 |
| managedInstanceCreateMode | 指定資料庫建立模式。 默認值：定期建立實例。 還原：藉由將一組備份還原至特定時間點來建立實例。 必須指定 RestorePointInTime 和 SourceManagedInstanceId。 |
'Default' 'PointInTimeRestore' |
| 記憶體大小以GB | 記憶體大小（以 GB 為單位）。 最小值：28。 最大值：870。 最小值和最大值取決於 vCore 數和服務層級。 閱讀有關資源限制的更多資訊： https://aka.ms/mi-resource-limits-api。 | int |
| minimalTlsVersion | 最低 TLS 版本。 允許的值：'None'、'1.0'、'1.1'、'1.2' | 字串 |
| pricingModel | Managed Instance 的定價模式。 | 'Freemium' 'Regular' |
| primaryUserAssignedIdentityId | 預設會使用之使用者指派身分識別的資源標識碼。 | 字串 |
| proxyOverride | 用於連接到實例的連接類型。 | 'Default' 'Proxy' 'Redirect' |
| publicDataEndpointEnabled | 是否啟用公用資料端點。 | bool |
| requestedBackupStorageRedundancy | 要用來儲存此實例備份的記憶體帳戶類型。 選項為 Local （LocalRedundantStorage）、Zone （ZoneRedundantStorage）、Geo （GeoRedundantStorage） 和 GeoZone（GeoZoneRedundantStorage） | 'Geo' 'GeoZone' 'Local' 'Zone' |
| requestedLogicalAvailability區域 | 指定 Managed Instance 釘選的邏輯可用性區域。 | '1' '2' '3' 'NoPreference' |
| restorePointInTime | 指定要還原以建立新資料庫的源資料庫的時間點（ISO8601格式）。 | 字串 |
| servicePrincipal | 受控實例的服務主體。 | ServicePrincipal |
| sourceManagedInstanceId | 與這個實例建立作業相關聯的來源受控實例資源標識符。 | 字串 |
| storageIOps | 儲存體 IOps。 最小值：300。 最大值：80000。 僅允許 1 個 IOps 的增量。 最大值取決於選取的硬體系列和虛擬核心數目。 | int |
| storageSizeInGB | 以 GB 為單位的記憶體大小。 最小值：32。 最大值：32768。 僅允許 32 GB 的增量。 最大值取決於選取的硬體系列和虛擬核心數目。 | int |
| storageThroughputMBps | 實例建立/更新作業不支持記憶體輸送量 MBps 參數。 | int |
| subnetId | 受控實例的子網資源標識碼。 | 字串 |
| timezoneId | 時區的標識碼。 允許的值是指 Windows 支援的時區。 Windows 會在登錄檔中保存支援時區的詳細資訊，包括 ID，這些資訊都在登錄檔中 KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones。 你可以透過查詢 SELECT 名稱作為 timezone_id FROM sys.time_zone_info，取得這些登錄檔值SQL Server。 您也可以在 PowerShell 中執行 [System.TimeZoneInfo]：：GetSystemTimeZones（） 來取得標識符清單。 有效的時區標識符範例是 「Pacific Standard Time」 或 「W」。。 歐洲標準時間“。 |
字串 |
| vCores | 虛擬核心數目。 允許的值：4、6、8、10、12、16、20、24、32、40、48、56、64、80、96、128。 支援的 vCore 取決於所選的硬體系列和服務層級。 | int |
| zoneRedundant | 是否啟用區域冗餘。 | bool |
ResourceIdentity
| Name | Description | Value |
|---|---|---|
| 型別 | 識別類型。 請將此設定為「SystemAssigned」，以自動建立並指派該資源的 Azure Active Directory 主體。 | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' |
| userAssignedIdentities | 要使用的使用者指派身分識別的資源標識碼 | ResourceIdentityUserAssignedIdentities |
ResourceIdentityUserAssignedIdentities
| Name | Description | Value |
|---|
ServicePrincipal
| Name | Description | Value |
|---|---|---|
| 型別 | 服務主體類型。 | 'None' 'SystemAssigned' |
Sku
| Name | Description | Value |
|---|---|---|
| 容量 | 特定 SKU 的容量。 | int |
| family | 如果服務有不同世代的硬體，針對相同的 SKU，則可以在這裡擷取。 | 字串 |
| name | SKU 的名稱，通常是字母 + 數位碼，例如 P3。 | 字串 （必要） |
| size | 特定 SKU 的大小 | 字串 |
| 分層 | 特定 SKU 的階層或版本，例如基本、進階。 | 字串 |
TrackedResourceTags
| Name | Description | Value |
|---|
UserIdentity
| Name | Description | Value |
|---|
使用範例
Azure 已驗證的模組
以下的 Azure 已驗證模組 可用於部署此資源類型。
| Module | Description |
|---|---|
| SQL 受控執行個體 | SQL Managed Instance 的 AVM 資源模組 |