Microsoft.Sql managedInstances 2021-11-01-preview

發行項
12/19/2024

Bicep 資源定義

managedInstances 資源類型可以使用目標作業來部署：

資源群組 - 請參閱資源群組部署命令

如需每個 API 版本中已變更屬性的清單，請參閱變更記錄檔。

資源格式

若要建立 Microsoft.Sql/managedInstances 資源，請將下列 Bicep 新增至範本。

resource symbolicname 'Microsoft.Sql/managedInstances@2021-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'
    }
    collation: 'string'
    dnsZonePartner: 'string'
    instancePoolId: 'string'
    keyId: 'string'
    licenseType: 'string'
    maintenanceConfigurationId: 'string'
    managedInstanceCreateMode: 'string'
    minimalTlsVersion: 'string'
    primaryUserAssignedIdentityId: 'string'
    proxyOverride: 'string'
    publicDataEndpointEnabled: bool
    requestedBackupStorageRedundancy: 'string'
    restorePointInTime: 'string'
    servicePrincipal: {
      type: 'string'
    }
    sourceManagedInstanceId: 'string'
    storageSizeInGB: int
    subnetId: 'string'
    timezoneId: 'string'
    vCores: int
    zoneRedundant: bool
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

屬性值

ManagedInstanceExternalAdministrator

名字	描述	價值
administratorType	伺服器管理員的類型。	'ActiveDirectory'
azureADOnlyAuthentication	僅啟用 Azure Active Directory 驗證。	bool
登錄	伺服器管理員的登入名稱。	字串
principalType	伺服器管理員的主體類型。	'Application' 'Group' 'User'
sid	伺服器管理員的 SID （物件識別符）。	字串約束：最小長度 = 36 最大長度 = 36 Pattern = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
tenantId	系統管理員的租用戶標識碼。	字串約束：最小長度 = 36 最大長度 = 36 Pattern = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`

ManagedInstanceProperties

名字	描述	價值
administratorLogin	受控實例的系統管理員用戶名稱。只有在建立受控實例時才能指定（而且是建立的必要專案）。	字串
administratorLoginPassword	系統管理員登入密碼（建立受控實例所需的密碼）。	字串約束：敏感性值。以安全參數的形式傳入。
管理員	伺服器的 Azure Active Directory 系統管理員。	ManagedInstanceExternalAdministrator
整理	受控實例的定序。	字串
dnsZonePartner	另一個受控實例的資源標識符，此受控實例會在建立後共用其 DNS 區域。	字串
instancePoolId	這個受控伺服器所屬之實例集區的標識碼。	字串
keyId	要用於加密之金鑰的 CMK URI。	字串
licenseType	授權類型。可能的值為 'LicenseIncluded' （包含新 SQL 授權的一般價格）和 'BasePrice' （為攜帶您自己的 SQL 授權而折扣 AHB 價格）。	'BasePrice' 'LicenseIncluded'
maintenanceConfigurationId	指定要套用至這個受控實例的維護組態標識碼。	字串
managedInstanceCreateMode	指定資料庫建立模式。默認值：定期建立實例。還原：藉由將一組備份還原至特定時間點來建立實例。必須指定 RestorePointInTime 和 SourceManagedInstanceId。	'Default' 'PointInTimeRestore'
minimalTlsVersion	最低 TLS 版本。允許的值：'None'、'1.0'、'1.1'、'1.2'	字串
primaryUserAssignedIdentityId	預設會使用之使用者指派身分識別的資源標識碼。	字串
proxyOverride	用於連接到實例的連接類型。	'Default' 'Proxy' 'Redirect'
publicDataEndpointEnabled	是否啟用公用資料端點。	bool
requestedBackupStorageRedundancy	要用來儲存此實例備份的記憶體帳戶類型。選項為 Local （LocalRedundantStorage）、Zone （ZoneRedundantStorage）、Geo （GeoRedundantStorage）和 GeoZone（GeoZoneRedundantStorage）	'Geo' 'GeoZone' 'Local' 'Zone'
restorePointInTime	指定要還原以建立新資料庫的源資料庫的時間點（ISO8601格式）。	字串
servicePrincipal	受控實例的服務主體。	ServicePrincipal
sourceManagedInstanceId	與這個實例建立作業相關聯的來源受控實例資源標識符。	字串
storageSizeInGB	以 GB 為單位的記憶體大小。最小值：32。最大值：8192。僅允許 32 GB 的增量。	int
subnetId	受控實例的子網資源標識碼。	字串
timezoneId	時區的標識碼。允許的值是 Windows 支援的時區。 Windows 會在登錄底下保留支援時區的詳細數據，包括標識碼 KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones。您可以透過 SQL Server 取得這些登錄值，方法是查詢 SELECT 名稱 AS timezone_id FROM sys.time_zone_info。您也可以在 PowerShell 中執行 [System.TimeZoneInfo]：：GetSystemTimeZones（）來取得標識符清單。有效的時區標識符範例是「Pacific Standard Time」或「W」。。歐洲標準時間“。	字串
虛擬核心	虛擬核心數目。允許的值：8、16、24、32、40、64、80。	int
zoneRedundant	是否啟用 multi-az。	bool

Microsoft.Sql/managedInstances

名字	描述	價值
身份	受控實例的 Azure Active Directory 身分識別。	ResourceIdentity
位置	資源位置。	字串（必要）
名字	資源名稱	字串（必要）
性能	資源屬性。	ManagedInstanceProperties
sku	受控實例 SKU。 sku.name 允許的值：GP_Gen4、GP_Gen5、BC_Gen4、BC_Gen5	Sku
標籤	資源標籤	標記名稱和值的字典。請參閱範本中的標籤

ResourceIdentity

名字	描述	價值
類型	識別類型。將此設定為『SystemAssigned』，以自動建立和指派資源的 Azure Active Directory 主體。	'None' 'SystemAssigned' 'SystemAssigned，UserAssigned' 'UserAssigned'
userAssignedIdentities	要使用的使用者指派身分識別的資源標識碼	ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

名字	描述	價值

ServicePrincipal

名字	描述	價值
類型	服務主體類型。	'None' 'SystemAssigned'

Sku

名字	描述	價值
能力	特定 SKU 的容量。	int
家庭	如果服務有不同世代的硬體，針對相同的 SKU，則可以在這裡擷取。	字串
名字	SKU 的名稱，通常是字母 + 數位碼，例如 P3。	字串（必要）
大小	特定 SKU 的大小	字串
層	特定 SKU 的階層或版本，例如基本、進階。	字串

TrackedResourceTags

名字	描述	價值

UserIdentity

名字	描述	價值

快速入門範例

下列快速入門範例會部署此資源類型。

Bicep 檔案	描述
在新的虛擬網路內建立 SQL MI	在新的虛擬網路內部署 Azure Sql Database 受控實例（SQL MI）。

ARM 樣本資源定義

managedInstances 資源類型可以使用目標作業來部署：

資源群組 - 請參閱資源群組部署命令

如需每個 API 版本中已變更屬性的清單，請參閱變更記錄檔。

資源格式

若要建立 Microsoft.Sql/managedInstances 資源，請將下列 JSON 新增至範本。

{
  "type": "Microsoft.Sql/managedInstances",
  "apiVersion": "2021-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"
    },
    "collation": "string",
    "dnsZonePartner": "string",
    "instancePoolId": "string",
    "keyId": "string",
    "licenseType": "string",
    "maintenanceConfigurationId": "string",
    "managedInstanceCreateMode": "string",
    "minimalTlsVersion": "string",
    "primaryUserAssignedIdentityId": "string",
    "proxyOverride": "string",
    "publicDataEndpointEnabled": "bool",
    "requestedBackupStorageRedundancy": "string",
    "restorePointInTime": "string",
    "servicePrincipal": {
      "type": "string"
    },
    "sourceManagedInstanceId": "string",
    "storageSizeInGB": "int",
    "subnetId": "string",
    "timezoneId": "string",
    "vCores": "int",
    "zoneRedundant": "bool"
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

屬性值

ManagedInstanceExternalAdministrator

名字	描述	價值
administratorType	伺服器管理員的類型。	'ActiveDirectory'
azureADOnlyAuthentication	僅啟用 Azure Active Directory 驗證。	bool
登錄	伺服器管理員的登入名稱。	字串
principalType	伺服器管理員的主體類型。	'Application' 'Group' 'User'
sid	伺服器管理員的 SID （物件識別符）。	字串約束：最小長度 = 36 最大長度 = 36 Pattern = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
tenantId	系統管理員的租用戶標識碼。	字串約束：最小長度 = 36 最大長度 = 36 Pattern = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`

ManagedInstanceProperties

名字	描述	價值
administratorLogin	受控實例的系統管理員用戶名稱。只有在建立受控實例時才能指定（而且是建立的必要專案）。	字串
administratorLoginPassword	系統管理員登入密碼（建立受控實例所需的密碼）。	字串約束：敏感性值。以安全參數的形式傳入。
管理員	伺服器的 Azure Active Directory 系統管理員。	ManagedInstanceExternalAdministrator
整理	受控實例的定序。	字串
dnsZonePartner	另一個受控實例的資源標識符，此受控實例會在建立後共用其 DNS 區域。	字串
instancePoolId	這個受控伺服器所屬之實例集區的標識碼。	字串
keyId	要用於加密之金鑰的 CMK URI。	字串
licenseType	授權類型。可能的值為 'LicenseIncluded' （包含新 SQL 授權的一般價格）和 'BasePrice' （為攜帶您自己的 SQL 授權而折扣 AHB 價格）。	'BasePrice' 'LicenseIncluded'
maintenanceConfigurationId	指定要套用至這個受控實例的維護組態標識碼。	字串
managedInstanceCreateMode	指定資料庫建立模式。默認值：定期建立實例。還原：藉由將一組備份還原至特定時間點來建立實例。必須指定 RestorePointInTime 和 SourceManagedInstanceId。	'Default' 'PointInTimeRestore'
minimalTlsVersion	最低 TLS 版本。允許的值：'None'、'1.0'、'1.1'、'1.2'	字串
primaryUserAssignedIdentityId	預設會使用之使用者指派身分識別的資源標識碼。	字串
proxyOverride	用於連接到實例的連接類型。	'Default' 'Proxy' 'Redirect'
publicDataEndpointEnabled	是否啟用公用資料端點。	bool
requestedBackupStorageRedundancy	要用來儲存此實例備份的記憶體帳戶類型。選項為 Local （LocalRedundantStorage）、Zone （ZoneRedundantStorage）、Geo （GeoRedundantStorage）和 GeoZone（GeoZoneRedundantStorage）	'Geo' 'GeoZone' 'Local' 'Zone'
restorePointInTime	指定要還原以建立新資料庫的源資料庫的時間點（ISO8601格式）。	字串
servicePrincipal	受控實例的服務主體。	ServicePrincipal
sourceManagedInstanceId	與這個實例建立作業相關聯的來源受控實例資源標識符。	字串
storageSizeInGB	以 GB 為單位的記憶體大小。最小值：32。最大值：8192。僅允許 32 GB 的增量。	int
subnetId	受控實例的子網資源標識碼。	字串
timezoneId	時區的標識碼。允許的值是 Windows 支援的時區。 Windows 會在登錄底下保留支援時區的詳細數據，包括標識碼 KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones。您可以透過 SQL Server 取得這些登錄值，方法是查詢 SELECT 名稱 AS timezone_id FROM sys.time_zone_info。您也可以在 PowerShell 中執行 [System.TimeZoneInfo]：：GetSystemTimeZones（）來取得標識符清單。有效的時區標識符範例是「Pacific Standard Time」或「W」。。歐洲標準時間“。	字串
虛擬核心	虛擬核心數目。允許的值：8、16、24、32、40、64、80。	int
zoneRedundant	是否啟用 multi-az。	bool

Microsoft.Sql/managedInstances

名字	描述	價值
apiVersion	API 版本	'2021-11-01-preview'
身份	受控實例的 Azure Active Directory 身分識別。	ResourceIdentity
位置	資源位置。	字串（必要）
名字	資源名稱	字串（必要）
性能	資源屬性。	ManagedInstanceProperties
sku	受控實例 SKU。 sku.name 允許的值：GP_Gen4、GP_Gen5、BC_Gen4、BC_Gen5	Sku
標籤	資源標籤	標記名稱和值的字典。請參閱範本中的標籤
類型	資源類型	'Microsoft.Sql/managedInstances'

ResourceIdentity

名字	描述	價值
類型	識別類型。將此設定為『SystemAssigned』，以自動建立和指派資源的 Azure Active Directory 主體。	'None' 'SystemAssigned' 'SystemAssigned，UserAssigned' 'UserAssigned'
userAssignedIdentities	要使用的使用者指派身分識別的資源標識碼	ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

名字	描述	價值

ServicePrincipal

名字	描述	價值
類型	服務主體類型。	'None' 'SystemAssigned'

Sku

名字	描述	價值
能力	特定 SKU 的容量。	int
家庭	如果服務有不同世代的硬體，針對相同的 SKU，則可以在這裡擷取。	字串
名字	SKU 的名稱，通常是字母 + 數位碼，例如 P3。	字串（必要）
大小	特定 SKU 的大小	字串
層	特定 SKU 的階層或版本，例如基本、進階。	字串

TrackedResourceTags

名字	描述	價值

UserIdentity

名字	描述	價值

快速入門範本

下列快速入門範本會部署此資源類型。

範本	描述
在新的虛擬網路內建立 SQL MI	在新的虛擬網路內部署 Azure Sql Database 受控實例（SQL MI）。
建立已設定傳送記錄和計量的 SQL MI	此範本可讓您部署用於儲存記錄和計量的 SQL MI 和其他資源（診斷工作區、記憶體帳戶、事件中樞）。
在新的虛擬網路內建立具有 jumpbox 的 SQL MI	在新的虛擬網路內部署具有 SSMS 的 Azure Sql Database 受控實例（SQL MI）和 JumpBox。
建立已設定點對站連線的 SQL MI	部署針對新虛擬網路內點對站連線所設定的 Azure Sql Database 受控實例（SQL MI）和虛擬網路網關。
使用網路部署 SQL 受控實例	部署 UDR 和 NSG 以支援 Azure SQL 受控實例並部署受控實例

Terraform （AzAPI 提供者）資源定義

managedInstances 資源類型可以使用目標作業來部署：

資源群組

如需每個 API 版本中已變更屬性的清單，請參閱變更記錄檔。

資源格式

若要建立 Microsoft.Sql/managedInstances 資源，請將下列 Terraform 新增至範本。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/managedInstances@2021-11-01-preview"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  sku = {
    capacity = int
    family = "string"
    name = "string"
    size = "string"
    tier = "string"
  }
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      administratorLogin = "string"
      administratorLoginPassword = "string"
      administrators = {
        administratorType = "string"
        azureADOnlyAuthentication = bool
        login = "string"
        principalType = "string"
        sid = "string"
        tenantId = "string"
      }
      collation = "string"
      dnsZonePartner = "string"
      instancePoolId = "string"
      keyId = "string"
      licenseType = "string"
      maintenanceConfigurationId = "string"
      managedInstanceCreateMode = "string"
      minimalTlsVersion = "string"
      primaryUserAssignedIdentityId = "string"
      proxyOverride = "string"
      publicDataEndpointEnabled = bool
      requestedBackupStorageRedundancy = "string"
      restorePointInTime = "string"
      servicePrincipal = {
        type = "string"
      }
      sourceManagedInstanceId = "string"
      storageSizeInGB = int
      subnetId = "string"
      timezoneId = "string"
      vCores = int
      zoneRedundant = bool
    }
  })
}

屬性值

ManagedInstanceExternalAdministrator

名字	描述	價值
administratorType	伺服器管理員的類型。	'ActiveDirectory'
azureADOnlyAuthentication	僅啟用 Azure Active Directory 驗證。	bool
登錄	伺服器管理員的登入名稱。	字串
principalType	伺服器管理員的主體類型。	'Application' 'Group' 'User'
sid	伺服器管理員的 SID （物件識別符）。	字串約束：最小長度 = 36 最大長度 = 36 Pattern = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
tenantId	系統管理員的租用戶標識碼。	字串約束：最小長度 = 36 最大長度 = 36 Pattern = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`

ManagedInstanceProperties

名字	描述	價值
administratorLogin	受控實例的系統管理員用戶名稱。只有在建立受控實例時才能指定（而且是建立的必要專案）。	字串
administratorLoginPassword	系統管理員登入密碼（建立受控實例所需的密碼）。	字串約束：敏感性值。以安全參數的形式傳入。
管理員	伺服器的 Azure Active Directory 系統管理員。	ManagedInstanceExternalAdministrator
整理	受控實例的定序。	字串
dnsZonePartner	另一個受控實例的資源標識符，此受控實例會在建立後共用其 DNS 區域。	字串
instancePoolId	這個受控伺服器所屬之實例集區的標識碼。	字串
keyId	要用於加密之金鑰的 CMK URI。	字串
licenseType	授權類型。可能的值為 'LicenseIncluded' （包含新 SQL 授權的一般價格）和 'BasePrice' （為攜帶您自己的 SQL 授權而折扣 AHB 價格）。	'BasePrice' 'LicenseIncluded'
maintenanceConfigurationId	指定要套用至這個受控實例的維護組態標識碼。	字串
managedInstanceCreateMode	指定資料庫建立模式。默認值：定期建立實例。還原：藉由將一組備份還原至特定時間點來建立實例。必須指定 RestorePointInTime 和 SourceManagedInstanceId。	'Default' 'PointInTimeRestore'
minimalTlsVersion	最低 TLS 版本。允許的值：'None'、'1.0'、'1.1'、'1.2'	字串
primaryUserAssignedIdentityId	預設會使用之使用者指派身分識別的資源標識碼。	字串
proxyOverride	用於連接到實例的連接類型。	'Default' 'Proxy' 'Redirect'
publicDataEndpointEnabled	是否啟用公用資料端點。	bool
requestedBackupStorageRedundancy	要用來儲存此實例備份的記憶體帳戶類型。選項為 Local （LocalRedundantStorage）、Zone （ZoneRedundantStorage）、Geo （GeoRedundantStorage）和 GeoZone（GeoZoneRedundantStorage）	'Geo' 'GeoZone' 'Local' 'Zone'
restorePointInTime	指定要還原以建立新資料庫的源資料庫的時間點（ISO8601格式）。	字串
servicePrincipal	受控實例的服務主體。	ServicePrincipal
sourceManagedInstanceId	與這個實例建立作業相關聯的來源受控實例資源標識符。	字串
storageSizeInGB	以 GB 為單位的記憶體大小。最小值：32。最大值：8192。僅允許 32 GB 的增量。	int
subnetId	受控實例的子網資源標識碼。	字串
timezoneId	時區的標識碼。允許的值是 Windows 支援的時區。 Windows 會在登錄底下保留支援時區的詳細數據，包括標識碼 KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones。您可以透過 SQL Server 取得這些登錄值，方法是查詢 SELECT 名稱 AS timezone_id FROM sys.time_zone_info。您也可以在 PowerShell 中執行 [System.TimeZoneInfo]：：GetSystemTimeZones（）來取得標識符清單。有效的時區標識符範例是「Pacific Standard Time」或「W」。。歐洲標準時間“。	字串
虛擬核心	虛擬核心數目。允許的值：8、16、24、32、40、64、80。	int
zoneRedundant	是否啟用 multi-az。	bool

Microsoft.Sql/managedInstances

名字	描述	價值
身份	受控實例的 Azure Active Directory 身分識別。	ResourceIdentity
位置	資源位置。	字串（必要）
名字	資源名稱	字串（必要）
性能	資源屬性。	ManagedInstanceProperties
sku	受控實例 SKU。 sku.name 允許的值：GP_Gen4、GP_Gen5、BC_Gen4、BC_Gen5	Sku
標籤	資源標籤	標記名稱和值的字典。
類型	資源類型	“Microsoft.Sql/managedInstances@2021-11-01-preview”

ResourceIdentity

名字	描述	價值
類型	識別類型。將此設定為『SystemAssigned』，以自動建立和指派資源的 Azure Active Directory 主體。	'None' 'SystemAssigned' 'SystemAssigned，UserAssigned' 'UserAssigned'
userAssignedIdentities	要使用的使用者指派身分識別的資源標識碼	ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

名字	描述	價值

ServicePrincipal

名字	描述	價值
類型	服務主體類型。	'None' 'SystemAssigned'

Sku

名字	描述	價值
能力	特定 SKU 的容量。	int
家庭	如果服務有不同世代的硬體，針對相同的 SKU，則可以在這裡擷取。	字串
名字	SKU 的名稱，通常是字母 + 數位碼，例如 P3。	字串（必要）
大小	特定 SKU 的大小	字串
層	特定 SKU 的階層或版本，例如基本、進階。	字串

TrackedResourceTags

名字	描述	價值

UserIdentity

名字	描述	價值

共用方式為

Microsoft.Sql managedInstances 2021-11-01-preview

Bicep 資源定義

資源格式

屬性值

ManagedInstanceExternalAdministrator

ManagedInstanceProperties

Microsoft.Sql/managedInstances

ResourceIdentity

ResourceIdentityUserAssignedIdentities

ServicePrincipal

Sku

TrackedResourceTags

UserIdentity

快速入門範例

ARM 樣本資源定義

資源格式

屬性值

ManagedInstanceExternalAdministrator

ManagedInstanceProperties

Microsoft.Sql/managedInstances

ResourceIdentity

ResourceIdentityUserAssignedIdentities

ServicePrincipal

Sku

TrackedResourceTags

UserIdentity

快速入門範本

Terraform （AzAPI 提供者） 資源定義

資源格式

屬性值

ManagedInstanceExternalAdministrator

ManagedInstanceProperties

Microsoft.Sql/managedInstances

ResourceIdentity

ResourceIdentityUserAssignedIdentities

ServicePrincipal

Sku

TrackedResourceTags

UserIdentity

意見反應

其他資源

Terraform （AzAPI 提供者）資源定義