你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Microsoft.Sql 托管实例

Bicep 资源定义

可以使用目标操作部署 managedInstances 资源类型：

资源组 - 请参阅资源组部署命令

有关每个 API 版本中已更改属性的列表，请参阅更改日志。

资源格式

若要创建 Microsoft.Sql/managedInstances 资源，请将以下 Bicep 添加到模板。

resource symbolicname 'Microsoft.Sql/managedInstances@2024-11-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
位置	资源位置。	string （必需）
name	资源名称	string （必需）
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 身份验证。	bool
login	服务器管理员的登录名。	字符串
principalType	服务器管理员的主体类型。	'Application' 'Group' 'User'
sid	服务器管理员的 SID （对象 ID）。	string Constraints: 最小长度 = 36 最大长度 = 36 图案 = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
tenantId	管理员的租户 ID。	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 区域的另一个托管实例的资源 ID。	字符串
hybridSecondaryUsage	混合辅助用途。可能的值是“主动”（默认值）和“被动”（客户使用辅助数据库作为被动 DR）。	'Active' 'Passive'
instancePoolId	此托管服务器的实例池的 ID。	字符串
isGeneralPurposeV2	这是否是常规用途版本的 GPv2 变体。	bool
keyId	要用于加密的密钥的 CMK URI。	字符串
licenseType	许可证类型。可能的值为“LicenseIncluded”（包括新 SQL 许可证的常规价格）和“BasePrice”（自带 SQL 许可证的折扣 AHB 价格）。	'BasePrice' 'LicenseIncluded'
maintenanceConfigurationId	指定要应用于此托管实例的维护配置 ID。	字符串
managedInstanceCreateMode	指定数据库创建模式。默认值：定期创建实例。还原：通过将一组备份还原到特定的时间点来创建实例。必须指定 RestorePointInTime 和 SourceManagedInstanceId。	'Default' 'PointInTimeRestore'
内存大小InGB	内存大小（以 GB 为单位）。最小值：28。最大值：870。最小值和最大值取决于 vCore 数和服务层级。阅读有关资源限制的更多信息： https://aka.ms/mi-resource-limits-api。	int
minimalTlsVersion	最低 TLS 版本。允许的值：“None”、“1.0”、“1.1”、“1.2”	字符串
pricingModel	托管实例的定价模型。	'Freemium' 'Regular'
primaryUserAssignedIdentityId	默认情况下要使用的用户分配标识的资源 ID。	字符串
proxyOverride	用于连接到实例的连接类型。	'Default' 'Proxy' 'Redirect'
publicDataEndpointEnabled	是否启用公共数据终结点。	bool
requestedBackupStorageRedundancy	用于存储此实例的备份的存储帐户类型。选项包括 Local （LocalRedundantStorage）、Zone （ZoneRedundantStorage）、Geo （GeoRedundantStorage）和 GeoZone（GeoZoneRedundantStorage）	'Geo' 'GeoZone' 'Local' 'Zone'
requestedLogicalAvailability区域	指定托管实例固定到的逻辑可用性区域。	'1' '2' '3' 'NoPreference'
restorePointInTime	指定将还原以创建新数据库的源数据库的时间点（ISO8601格式）。	字符串
servicePrincipal	托管实例的服务主体。	ServicePrincipal
sourceManagedInstanceId	与此实例的创建操作关联的源托管实例的资源标识符。	字符串
storageIOps	存储 IOps。最小值：300。最大值：80000。仅允许 1 个 IOps 的增量。最大值取决于所选硬件系列和 vCore 数。	int
storageSizeInGB	存储大小（以 GB 为单位）。最小值：32。最大值：32768。仅允许 32 GB 的增量。最大值取决于所选硬件系列和 vCore 数。	int
storageThroughputMBps	实例创建/更新作不支持存储吞吐量 MBps 参数。	int
subnetId	托管实例的子网资源 ID。	字符串
timezoneId	时区的 ID。允许的值是 Windows 支持的时区。 Windows 在注册表中保留有关支持的时区（包括 ID）的详细信息 KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\时区。可以通过 SQL Server 获取这些注册表值，方法是查询 SELECT 名称 AS timezone_id FROM sys.time_zone_info。还可以通过在 PowerShell 中执行 [System.TimeZoneInfo]：：GetSystemTimeZones（）来获取 ID 列表。有效时区 ID 的示例是“太平洋标准时间”或“W”。欧洲标准时间”。	字符串
vCores	vCore 数。允许的值：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	要使用的用户分配标识的资源 ID	ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Name	Description	Value

ServicePrincipal

Name	Description	Value
类型	服务主体类型。	'None' 'SystemAssigned'

Sku

Name	Description	Value
产能	特定 SKU 的容量。	int
family	如果服务具有不同代的硬件（对于同一 SKU，则可以在此处捕获）。	字符串
name	SKU 的名称，通常为字母 + 数字代码，例如 P3。	string （必需）
size	特定 SKU 的大小	字符串
分层	特定 SKU 的层或版本，例如基本 SKU、高级版。	字符串

TrackedResourceTags

Name	Description	Value

UserIdentity

Name	Description	Value

用法示例

Azure 验证模块

以下 Azure 验证模块可用于部署此资源类型。

Module	Description
SQL 托管实例	SQL 托管实例的 AVM 资源模块

Azure 快速入门示例

以下 Azure 快速入门模板包含用于部署此资源类型的 Bicep 示例。

Bicep 文件	Description
在新虚拟网络中创建 SQL MI	在新虚拟网络中部署 Azure Sql 数据库托管实例（SQL MI）。

ARM 模板资源定义

可以使用目标操作部署 managedInstances 资源类型：

资源组 - 请参阅资源组部署命令

有关每个 API 版本中已更改属性的列表，请参阅更改日志。

资源格式

若要创建 Microsoft.Sql/managedInstances 资源，请将以下 JSON 添加到模板。

{
  "type": "Microsoft.Sql/managedInstances",
  "apiVersion": "2024-11-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 版本	'2024-11-01-preview'
标识	托管实例的 Azure Active Directory 标识。	ResourceIdentity
位置	资源位置。	string （必需）
name	资源名称	string （必需）
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 身份验证。	bool
login	服务器管理员的登录名。	字符串
principalType	服务器管理员的主体类型。	'Application' 'Group' 'User'
sid	服务器管理员的 SID （对象 ID）。	string Constraints: 最小长度 = 36 最大长度 = 36 图案 = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
tenantId	管理员的租户 ID。	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 区域的另一个托管实例的资源 ID。	字符串
hybridSecondaryUsage	混合辅助用途。可能的值是“主动”（默认值）和“被动”（客户使用辅助数据库作为被动 DR）。	'Active' 'Passive'
instancePoolId	此托管服务器的实例池的 ID。	字符串
isGeneralPurposeV2	这是否是常规用途版本的 GPv2 变体。	bool
keyId	要用于加密的密钥的 CMK URI。	字符串
licenseType	许可证类型。可能的值为“LicenseIncluded”（包括新 SQL 许可证的常规价格）和“BasePrice”（自带 SQL 许可证的折扣 AHB 价格）。	'BasePrice' 'LicenseIncluded'
maintenanceConfigurationId	指定要应用于此托管实例的维护配置 ID。	字符串
managedInstanceCreateMode	指定数据库创建模式。默认值：定期创建实例。还原：通过将一组备份还原到特定的时间点来创建实例。必须指定 RestorePointInTime 和 SourceManagedInstanceId。	'Default' 'PointInTimeRestore'
内存大小InGB	内存大小（以 GB 为单位）。最小值：28。最大值：870。最小值和最大值取决于 vCore 数和服务层级。阅读有关资源限制的更多信息： https://aka.ms/mi-resource-limits-api。	int
minimalTlsVersion	最低 TLS 版本。允许的值：“None”、“1.0”、“1.1”、“1.2”	字符串
pricingModel	托管实例的定价模型。	'Freemium' 'Regular'
primaryUserAssignedIdentityId	默认情况下要使用的用户分配标识的资源 ID。	字符串
proxyOverride	用于连接到实例的连接类型。	'Default' 'Proxy' 'Redirect'
publicDataEndpointEnabled	是否启用公共数据终结点。	bool
requestedBackupStorageRedundancy	用于存储此实例的备份的存储帐户类型。选项包括 Local （LocalRedundantStorage）、Zone （ZoneRedundantStorage）、Geo （GeoRedundantStorage）和 GeoZone（GeoZoneRedundantStorage）	'Geo' 'GeoZone' 'Local' 'Zone'
requestedLogicalAvailability区域	指定托管实例固定到的逻辑可用性区域。	'1' '2' '3' 'NoPreference'
restorePointInTime	指定将还原以创建新数据库的源数据库的时间点（ISO8601格式）。	字符串
servicePrincipal	托管实例的服务主体。	ServicePrincipal
sourceManagedInstanceId	与此实例的创建操作关联的源托管实例的资源标识符。	字符串
storageIOps	存储 IOps。最小值：300。最大值：80000。仅允许 1 个 IOps 的增量。最大值取决于所选硬件系列和 vCore 数。	int
storageSizeInGB	存储大小（以 GB 为单位）。最小值：32。最大值：32768。仅允许 32 GB 的增量。最大值取决于所选硬件系列和 vCore 数。	int
storageThroughputMBps	实例创建/更新作不支持存储吞吐量 MBps 参数。	int
subnetId	托管实例的子网资源 ID。	字符串
timezoneId	时区的 ID。允许的值是 Windows 支持的时区。 Windows 在注册表中保留有关支持的时区（包括 ID）的详细信息 KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\时区。可以通过 SQL Server 获取这些注册表值，方法是查询 SELECT 名称 AS timezone_id FROM sys.time_zone_info。还可以通过在 PowerShell 中执行 [System.TimeZoneInfo]：：GetSystemTimeZones（）来获取 ID 列表。有效时区 ID 的示例是“太平洋标准时间”或“W”。欧洲标准时间”。	字符串
vCores	vCore 数。允许的值：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	要使用的用户分配标识的资源 ID	ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Name	Description	Value

ServicePrincipal

Name	Description	Value
类型	服务主体类型。	'None' 'SystemAssigned'

Sku

Name	Description	Value
产能	特定 SKU 的容量。	int
family	如果服务具有不同代的硬件（对于同一 SKU，则可以在此处捕获）。	字符串
name	SKU 的名称，通常为字母 + 数字代码，例如 P3。	string （必需）
size	特定 SKU 的大小	字符串
分层	特定 SKU 的层或版本，例如基本 SKU、高级版。	字符串

TrackedResourceTags

Name	Description	Value

UserIdentity

Name	Description	Value

用法示例

Azure 快速入门模板

以下 Azure 快速入门模板部署此资源类型。

Template	Description
在新虚拟网络中创建 SQL MI	在新虚拟网络中部署 Azure Sql 数据库托管实例（SQL MI）。
创建配置了日志和指标发送的 SQL MI	使用此模板可以部署用于存储日志和指标的 SQL MI 和其他资源（诊断工作区、存储帐户、事件中心）。
在新虚拟网络中创建包含 jumpbox 的 SQL MI	在新虚拟网络中使用 SSMS 部署 Azure Sql 数据库托管实例（SQL MI）和 JumpBox。
创建配置了点到站点连接的 SQL MI	部署为新虚拟网络中的点到站点连接配置的 Azure Sql 数据库托管实例（SQL MI）和虚拟网络网关。
使用网络部署 SQL 托管实例	部署 UDR 和 NSG 以支持 Azure SQL 托管实例并部署托管实例

Terraform （AzAPI 提供程序）资源定义

可以使用目标操作部署 managedInstances 资源类型：

资源组

有关每个 API 版本中已更改属性的列表，请参阅更改日志。

资源格式

若要创建 Microsoft.Sql/managedInstances 资源，请将以下 Terraform 添加到模板。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/managedInstances@2024-11-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
位置	资源位置。	string （必需）
name	资源名称	string （必需）
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@2024-11-01-preview”

ManagedInstanceExternalAdministrator

Name	Description	Value
administratorType	服务器管理员的类型。	'ActiveDirectory'
azureADOnlyAuthentication	仅启用 Azure Active Directory 身份验证。	bool
login	服务器管理员的登录名。	字符串
principalType	服务器管理员的主体类型。	'Application' 'Group' 'User'
sid	服务器管理员的 SID （对象 ID）。	string Constraints: 最小长度 = 36 最大长度 = 36 图案 = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
tenantId	管理员的租户 ID。	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 区域的另一个托管实例的资源 ID。	字符串
hybridSecondaryUsage	混合辅助用途。可能的值是“主动”（默认值）和“被动”（客户使用辅助数据库作为被动 DR）。	'Active' 'Passive'
instancePoolId	此托管服务器的实例池的 ID。	字符串
isGeneralPurposeV2	这是否是常规用途版本的 GPv2 变体。	bool
keyId	要用于加密的密钥的 CMK URI。	字符串
licenseType	许可证类型。可能的值为“LicenseIncluded”（包括新 SQL 许可证的常规价格）和“BasePrice”（自带 SQL 许可证的折扣 AHB 价格）。	'BasePrice' 'LicenseIncluded'
maintenanceConfigurationId	指定要应用于此托管实例的维护配置 ID。	字符串
managedInstanceCreateMode	指定数据库创建模式。默认值：定期创建实例。还原：通过将一组备份还原到特定的时间点来创建实例。必须指定 RestorePointInTime 和 SourceManagedInstanceId。	'Default' 'PointInTimeRestore'
内存大小InGB	内存大小（以 GB 为单位）。最小值：28。最大值：870。最小值和最大值取决于 vCore 数和服务层级。阅读有关资源限制的更多信息： https://aka.ms/mi-resource-limits-api。	int
minimalTlsVersion	最低 TLS 版本。允许的值：“None”、“1.0”、“1.1”、“1.2”	字符串
pricingModel	托管实例的定价模型。	'Freemium' 'Regular'
primaryUserAssignedIdentityId	默认情况下要使用的用户分配标识的资源 ID。	字符串
proxyOverride	用于连接到实例的连接类型。	'Default' 'Proxy' 'Redirect'
publicDataEndpointEnabled	是否启用公共数据终结点。	bool
requestedBackupStorageRedundancy	用于存储此实例的备份的存储帐户类型。选项包括 Local （LocalRedundantStorage）、Zone （ZoneRedundantStorage）、Geo （GeoRedundantStorage）和 GeoZone（GeoZoneRedundantStorage）	'Geo' 'GeoZone' 'Local' 'Zone'
requestedLogicalAvailability区域	指定托管实例固定到的逻辑可用性区域。	'1' '2' '3' 'NoPreference'
restorePointInTime	指定将还原以创建新数据库的源数据库的时间点（ISO8601格式）。	字符串
servicePrincipal	托管实例的服务主体。	ServicePrincipal
sourceManagedInstanceId	与此实例的创建操作关联的源托管实例的资源标识符。	字符串
storageIOps	存储 IOps。最小值：300。最大值：80000。仅允许 1 个 IOps 的增量。最大值取决于所选硬件系列和 vCore 数。	int
storageSizeInGB	存储大小（以 GB 为单位）。最小值：32。最大值：32768。仅允许 32 GB 的增量。最大值取决于所选硬件系列和 vCore 数。	int
storageThroughputMBps	实例创建/更新作不支持存储吞吐量 MBps 参数。	int
subnetId	托管实例的子网资源 ID。	字符串
timezoneId	时区的 ID。允许的值是 Windows 支持的时区。 Windows 在注册表中保留有关支持的时区（包括 ID）的详细信息 KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\时区。可以通过 SQL Server 获取这些注册表值，方法是查询 SELECT 名称 AS timezone_id FROM sys.time_zone_info。还可以通过在 PowerShell 中执行 [System.TimeZoneInfo]：：GetSystemTimeZones（）来获取 ID 列表。有效时区 ID 的示例是“太平洋标准时间”或“W”。欧洲标准时间”。	字符串
vCores	vCore 数。允许的值：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	要使用的用户分配标识的资源 ID	ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Name	Description	Value

ServicePrincipal

Name	Description	Value
类型	服务主体类型。	'None' 'SystemAssigned'

Sku

Name	Description	Value
产能	特定 SKU 的容量。	int
family	如果服务具有不同代的硬件（对于同一 SKU，则可以在此处捕获）。	字符串
name	SKU 的名称，通常为字母 + 数字代码，例如 P3。	string （必需）
size	特定 SKU 的大小	字符串
分层	特定 SKU 的层或版本，例如基本 SKU、高级版。	字符串

TrackedResourceTags

Name	Description	Value

UserIdentity

Name	Description	Value

用法示例

Azure 验证模块

以下 Azure 验证模块可用于部署此资源类型。

Module	Description
SQL 托管实例	SQL 托管实例的 AVM 资源模块

反馈

此页面是否有帮助？

Last updated on 2025-09-17

通过

Microsoft.Sql 托管实例

Bicep 资源定义

资源格式

属性值

Microsoft.Sql/managedInstances

ManagedInstanceExternalAdministrator

ManagedInstanceProperties

ResourceIdentity

ResourceIdentityUserAssignedIdentities

ServicePrincipal

Sku

TrackedResourceTags

UserIdentity

用法示例

Azure 验证模块

Azure 快速入门示例

ARM 模板资源定义

资源格式

属性值

Microsoft.Sql/managedInstances

ManagedInstanceExternalAdministrator

ManagedInstanceProperties

ResourceIdentity

ResourceIdentityUserAssignedIdentities

ServicePrincipal

Sku

TrackedResourceTags

UserIdentity

用法示例

Azure 快速入门模板

Terraform （AzAPI 提供程序）资源定义

资源格式

属性值

Microsoft.Sql/managedInstances

ManagedInstanceExternalAdministrator

ManagedInstanceProperties

ResourceIdentity

ResourceIdentityUserAssignedIdentities

ServicePrincipal

Sku

TrackedResourceTags

UserIdentity

用法示例

Azure 验证模块

反馈

其他资源