共用方式為


Microsoft.Sql managedInstances 2022-05-01-preview

Bicep 資源定義

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

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

資源格式

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

resource symbolicname 'Microsoft.Sql/managedInstances@2022-05-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 系統管理員。 這隻能在實例建立時間使用。 如果用於實例更新,則會予以忽略,否則會導致錯誤。 若要更新個別 API,則必須使用。 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。 最大值:16384。 僅允許 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_Gen5、GP_G8IM、GP_G8IH、BC_Gen5、BC_G8IM、BC_G8IH 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": "2022-05-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 系統管理員。 這隻能在實例建立時間使用。 如果用於實例更新,則會予以忽略,否則會導致錯誤。 若要更新個別 API,則必須使用。 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。 最大值:16384。 僅允許 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 版本 '2022-05-01-preview'
身份 受控實例的 Azure Active Directory 身分識別。 ResourceIdentity
位置 資源位置。 字串 (必要)
名字 資源名稱 字串 (必要)
性能 資源屬性。 ManagedInstanceProperties
sku 受控實例 SKU。 sku.name 允許的值:GP_Gen5、GP_G8IM、GP_G8IH、BC_Gen5、BC_G8IM、BC_G8IH 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
在新的虛擬網路內部署 Azure Sql Database 受控實例 (SQL MI)。
建立已設定傳送記錄和計量的 SQL MI

部署至 Azure
此範本可讓您部署用於儲存記錄和計量的 SQL MI 和其他資源(診斷工作區、記憶體帳戶、事件中樞)。
在新的虛擬網路內建立具有 jumpbox 的 SQL MI

部署至 Azure
在新的虛擬網路內部署具有 SSMS 的 Azure Sql Database 受控實例 (SQL MI) 和 JumpBox。
建立已設定點對站連線的 SQL MI

部署至 Azure
部署針對新虛擬網路內點對站連線所設定的 Azure Sql Database 受控實例 (SQL MI) 和虛擬網路網關。
使用網路 部署 SQL 受控實例

部署至 Azure
部署 UDR 和 NSG 以支援 Azure SQL 受控實例並部署受控實例

Terraform (AzAPI 提供者) 資源定義

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

  • 資源群組

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

資源格式

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/managedInstances@2022-05-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 系統管理員。 這隻能在實例建立時間使用。 如果用於實例更新,則會予以忽略,否則會導致錯誤。 若要更新個別 API,則必須使用。 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。 最大值:16384。 僅允許 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_Gen5、GP_G8IM、GP_G8IH、BC_Gen5、BC_G8IM、BC_G8IH Sku
標籤 資源標籤 標記名稱和值的字典。
類型 資源類型 “Microsoft.Sql/managedInstances@2022-05-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

名字 描述 價值