Поделиться через


Microsoft.SQL managedInstances

Определение ресурсов 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
identity Удостоверение Azure Active Directory управляемого экземпляра. ResourceIdentity
location Расположение ресурса. строка (обязательно)
name имя ресурса. строка (обязательно)
properties Свойства ресурса. ManagedInstanceProperties
sku SKU управляемого экземпляра. Допустимые значения для sku.name: GP_Gen5 (General Purpose, Standard-series); GP_G8IM (Общего назначения, Премиум-серия); GP_G8IH (Общего назначения, Премиум-серия с оптимизацией памяти); BC_Gen5 (Критически важный для бизнеса, Standard-Series); BC_G8IM (Business Critical, Premium-серия); BC_G8IH (критически важный для бизнеса, оптимизированный для памяти серии Premium). Sku
tags Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах

ManagedInstanceExternalAdministrator

Name Description Value
administratorType Тип администратора развера. 'ActiveDirectory'
azureADOnlyAuthentication Включена только проверка подлинности Azure Active Directory. bool
login Имя входа администратора сервера. string
principalType Тип субъекта-администратора. 'Application'
'Group'
'User'
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 Имя администратора для управляемого экземпляра. Можно указать только при создании управляемого экземпляра (и требуется для создания). string
administratorLoginPassword Пароль для входа администратора (требуется для создания управляемого экземпляра). string

Constraints:
Конфиденциальное значение. Передайте в качестве безопасного параметра.
administrators Администратора Azure Active Directory можно использовать во время создания экземпляра и обновления экземпляра, за исключением свойства azureADOnlyAuthentication. Чтобы обновить свойство azureADOnlyAuthentication, необходимо использовать отдельный API. ManagedInstanceExternalAdministrator
authenticationMetadata Режим поиска метаданных метаданных управляемого экземпляра. 'AzureAD'
'Paired'
'Windows'
collation Параметры сортировки управляемого экземпляра. string
databaseFormat Задает внутренний формат баз данных экземпляров, относящихся к версии ядра SQL. 'AlwaysUpToDate'
'SQLServer2022'
«SQLServer2025»
dnsZonePartner Идентификатор ресурса другого управляемого экземпляра, зона DNS которого будет совместно использовать этот управляемый экземпляр после создания. string
hybridSecondaryUsage Гибридное вторичное использование. Возможные значения: "Активный" (значение по умолчанию) и "Пассивный" (клиент использует вторичную функцию в качестве пассивного аварийного восстановления). 'Active'
'Passive'
instancePoolId Идентификатор пула экземпляров, к которому принадлежит управляемый сервер. string
isGeneralPurposeV2 Независимо от того, является ли это вариантом GPv2 выпуска общего назначения. bool
keyId Универсальный код ресурса (URI) ключа для шифрования. string
licenseType Тип лицензии. Возможные значения: LicenseIncluded (обычная цена включительно с новой лицензией SQL) и BasePrice (скидка на AHB для привлечения собственных лицензий SQL). 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId Указывает идентификатор конфигурации обслуживания для применения к этому управляемому экземпляру. string
managedInstanceCreateMode Задает режим создания базы данных.

По умолчанию: создание регулярного экземпляра.

Восстановление. Создание экземпляра путем восстановления набора резервных копий в определенный момент времени. Необходимо указать RestorePointInTime и SourceManagedInstanceId.
'Default'
'PointInTimeRestore'
memorySizeInGB Объем памяти в ГБ. Минимальное значение: 28. Максимальное значение: 870. Минимальное и максимальное значение зависят от количества виртуальных ядер и уровня служб. Подробнее об ограничениях ресурсов: https://aka.ms/mi-resource-limits-api. int
minimalTlsVersion Минимальная версия TLS. Допустимые значения: "Нет", "1.0", "1.1", "1.2" string
pricingModel Модель ценообразования управляемого экземпляра. 'Freemium'
'Regular'
primaryUserAssignedIdentityId Идентификатор ресурса назначаемого пользователем удостоверения, используемого по умолчанию. string
proxyOverride Тип подключения, используемый для подключения к экземпляру. 'Default'
'Proxy'
'Redirect'
publicDataEndpointEnabled Включена ли общедоступная конечная точка данных. bool
requestedBackupStorageRedundancy Тип учетной записи хранения, используемый для хранения резервных копий для этого экземпляра. Параметры: Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) и GeoZone(GeoZoneRedundantStorage) 'Geo'
'GeoZone'
'Local'
'Zone'
requestedLogicalAvailabilityZone Указывает логическую зону доступности, к которой прикреплен управляемый экземпляр. '1'
'2'
'3'
'NoPreference'
restorePointInTime Указывает точку во времени (ISO8601 формате) исходной базы данных, которая будет восстановлена для создания новой базы данных. string
servicePrincipal Субъект-служба управляемого экземпляра. ServicePrincipal
sourceManagedInstanceId Идентификатор ресурса исходного управляемого экземпляра, связанного с операцией создания этого экземпляра. string
storageIOps Хранение операций ввода-вывода в секунду. Минимальное значение: 300. Максимальное значение: 80000. Приращение 1 IOps разрешено только. Максимальное значение зависит от выбранного семейства оборудования и количества виртуальных ядер. int
storageSizeInGB Размер хранилища в ГБ. Минимальное значение: 32. Максимальное значение: 32768. Приращение только в 32 ГБ разрешено. Максимальное значение зависит от выбранного семейства оборудования и количества виртуальных ядер. int
storageThroughputMBps Параметр MBps пропускной способности хранилища не поддерживается в операции создания и обновления экземпляра. int
subnetId Идентификатор ресурса подсети для управляемого экземпляра. string
timezoneId Идентификатор часового пояса. Допустимые значения — это часовые пояса, поддерживаемые Windows.
Windows хранит сведения о поддерживаемых часовых поясах, включая идентификатор, в реестре в разделе
KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Часовой пояс.
Эти значения реестра можно получить с помощью SQL Server, запросив имя SELECT AS timezone_id FROM sys.time_zone_info.
Список идентификаторов также можно получить путем выполнения [System.TimeZoneInfo]::GetSystemTimeZones() в PowerShell.
Пример допустимого идентификатора часового пояса — "Тихоокеанское стандартное время" или "W". Стандартное время в Европе.
string
vCores Количество виртуальных ядер. Допустимые значения: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Поддерживаемые виртуальные ядра зависят от выбранного семейства оборудования и уровня служб. int
zoneRedundant Включена ли избыточность между зонами. bool

ResourceIdentity

Name Description Value
type Тип удостоверения. Установите для параметра SystemAssigned значение SystemAssigned, чтобы автоматически создать и назначить субъект Azure Active Directory для ресурса. 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'
userAssignedIdentities Идентификаторы ресурса назначенных пользователем удостоверений для использования ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Name Description Value

ServicePrincipal

Name Description Value
type Тип субъекта-службы. 'None'
'SystemAssigned'

Sku

Name Description Value
capacity Емкость конкретного номера SKU. int
family Если служба имеет разные поколения оборудования для одного номера SKU, это можно записать здесь. string
name Имя номера SKU, как правило, буква + код номера, например P3. строка (обязательно)
size Размер конкретного номера SKU string
tier Уровень или выпуск конкретного номера SKU, например "Базовый", "Премиум". string

TrackedResourceTags

Name Description Value

UserIdentity

Name Description Value

Примеры использования

Проверенные модули Azure

Следующие проверенные модули Azure можно использовать для развертывания этого типа ресурсов.

Module Description
Управляемый экземпляр SQL Модуль ресурсов AVM для управляемого экземпляра SQL

Примеры быстрого запуска Azure

Следующие шаблоны быстрого запуска Azure содержат примеры Bicep для развертывания этого типа ресурса.

Файл Bicep Description
создание SQL MI в новой виртуальной сети Разверните управляемый экземпляр Базы данных SQL Azure (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'
identity Удостоверение Azure Active Directory управляемого экземпляра. ResourceIdentity
location Расположение ресурса. строка (обязательно)
name имя ресурса. строка (обязательно)
properties Свойства ресурса. ManagedInstanceProperties
sku SKU управляемого экземпляра. Допустимые значения для sku.name: GP_Gen5 (General Purpose, Standard-series); GP_G8IM (Общего назначения, Премиум-серия); GP_G8IH (Общего назначения, Премиум-серия с оптимизацией памяти); BC_Gen5 (Критически важный для бизнеса, Standard-Series); BC_G8IM (Business Critical, Premium-серия); BC_G8IH (критически важный для бизнеса, оптимизированный для памяти серии Premium). Sku
tags Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах
type Тип ресурса 'Microsoft.Sql/managedInstances'

ManagedInstanceExternalAdministrator

Name Description Value
administratorType Тип администратора развера. 'ActiveDirectory'
azureADOnlyAuthentication Включена только проверка подлинности Azure Active Directory. bool
login Имя входа администратора сервера. string
principalType Тип субъекта-администратора. 'Application'
'Group'
'User'
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 Имя администратора для управляемого экземпляра. Можно указать только при создании управляемого экземпляра (и требуется для создания). string
administratorLoginPassword Пароль для входа администратора (требуется для создания управляемого экземпляра). string

Constraints:
Конфиденциальное значение. Передайте в качестве безопасного параметра.
administrators Администратора Azure Active Directory можно использовать во время создания экземпляра и обновления экземпляра, за исключением свойства azureADOnlyAuthentication. Чтобы обновить свойство azureADOnlyAuthentication, необходимо использовать отдельный API. ManagedInstanceExternalAdministrator
authenticationMetadata Режим поиска метаданных метаданных управляемого экземпляра. 'AzureAD'
'Paired'
'Windows'
collation Параметры сортировки управляемого экземпляра. string
databaseFormat Задает внутренний формат баз данных экземпляров, относящихся к версии ядра SQL. 'AlwaysUpToDate'
'SQLServer2022'
«SQLServer2025»
dnsZonePartner Идентификатор ресурса другого управляемого экземпляра, зона DNS которого будет совместно использовать этот управляемый экземпляр после создания. string
hybridSecondaryUsage Гибридное вторичное использование. Возможные значения: "Активный" (значение по умолчанию) и "Пассивный" (клиент использует вторичную функцию в качестве пассивного аварийного восстановления). 'Active'
'Passive'
instancePoolId Идентификатор пула экземпляров, к которому принадлежит управляемый сервер. string
isGeneralPurposeV2 Независимо от того, является ли это вариантом GPv2 выпуска общего назначения. bool
keyId Универсальный код ресурса (URI) ключа для шифрования. string
licenseType Тип лицензии. Возможные значения: LicenseIncluded (обычная цена включительно с новой лицензией SQL) и BasePrice (скидка на AHB для привлечения собственных лицензий SQL). 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId Указывает идентификатор конфигурации обслуживания для применения к этому управляемому экземпляру. string
managedInstanceCreateMode Задает режим создания базы данных.

По умолчанию: создание регулярного экземпляра.

Восстановление. Создание экземпляра путем восстановления набора резервных копий в определенный момент времени. Необходимо указать RestorePointInTime и SourceManagedInstanceId.
'Default'
'PointInTimeRestore'
memorySizeInGB Объем памяти в ГБ. Минимальное значение: 28. Максимальное значение: 870. Минимальное и максимальное значение зависят от количества виртуальных ядер и уровня служб. Подробнее об ограничениях ресурсов: https://aka.ms/mi-resource-limits-api. int
minimalTlsVersion Минимальная версия TLS. Допустимые значения: "Нет", "1.0", "1.1", "1.2" string
pricingModel Модель ценообразования управляемого экземпляра. 'Freemium'
'Regular'
primaryUserAssignedIdentityId Идентификатор ресурса назначаемого пользователем удостоверения, используемого по умолчанию. string
proxyOverride Тип подключения, используемый для подключения к экземпляру. 'Default'
'Proxy'
'Redirect'
publicDataEndpointEnabled Включена ли общедоступная конечная точка данных. bool
requestedBackupStorageRedundancy Тип учетной записи хранения, используемый для хранения резервных копий для этого экземпляра. Параметры: Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) и GeoZone(GeoZoneRedundantStorage) 'Geo'
'GeoZone'
'Local'
'Zone'
requestedLogicalAvailabilityZone Указывает логическую зону доступности, к которой прикреплен управляемый экземпляр. '1'
'2'
'3'
'NoPreference'
restorePointInTime Указывает точку во времени (ISO8601 формате) исходной базы данных, которая будет восстановлена для создания новой базы данных. string
servicePrincipal Субъект-служба управляемого экземпляра. ServicePrincipal
sourceManagedInstanceId Идентификатор ресурса исходного управляемого экземпляра, связанного с операцией создания этого экземпляра. string
storageIOps Хранение операций ввода-вывода в секунду. Минимальное значение: 300. Максимальное значение: 80000. Приращение 1 IOps разрешено только. Максимальное значение зависит от выбранного семейства оборудования и количества виртуальных ядер. int
storageSizeInGB Размер хранилища в ГБ. Минимальное значение: 32. Максимальное значение: 32768. Приращение только в 32 ГБ разрешено. Максимальное значение зависит от выбранного семейства оборудования и количества виртуальных ядер. int
storageThroughputMBps Параметр MBps пропускной способности хранилища не поддерживается в операции создания и обновления экземпляра. int
subnetId Идентификатор ресурса подсети для управляемого экземпляра. string
timezoneId Идентификатор часового пояса. Допустимые значения — это часовые пояса, поддерживаемые Windows.
Windows хранит сведения о поддерживаемых часовых поясах, включая идентификатор, в реестре в разделе
KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Часовой пояс.
Эти значения реестра можно получить с помощью SQL Server, запросив имя SELECT AS timezone_id FROM sys.time_zone_info.
Список идентификаторов также можно получить путем выполнения [System.TimeZoneInfo]::GetSystemTimeZones() в PowerShell.
Пример допустимого идентификатора часового пояса — "Тихоокеанское стандартное время" или "W". Стандартное время в Европе.
string
vCores Количество виртуальных ядер. Допустимые значения: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Поддерживаемые виртуальные ядра зависят от выбранного семейства оборудования и уровня служб. int
zoneRedundant Включена ли избыточность между зонами. bool

ResourceIdentity

Name Description Value
type Тип удостоверения. Установите для параметра SystemAssigned значение SystemAssigned, чтобы автоматически создать и назначить субъект Azure Active Directory для ресурса. 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'
userAssignedIdentities Идентификаторы ресурса назначенных пользователем удостоверений для использования ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Name Description Value

ServicePrincipal

Name Description Value
type Тип субъекта-службы. 'None'
'SystemAssigned'

Sku

Name Description Value
capacity Емкость конкретного номера SKU. int
family Если служба имеет разные поколения оборудования для одного номера SKU, это можно записать здесь. string
name Имя номера SKU, как правило, буква + код номера, например P3. строка (обязательно)
size Размер конкретного номера SKU string
tier Уровень или выпуск конкретного номера SKU, например "Базовый", "Премиум". string

TrackedResourceTags

Name Description Value

UserIdentity

Name Description Value

Примеры использования

Шаблоны быстрого запуска Azure

Следующие шаблоны быстрого запуска Azure развернуть этот тип ресурса.

Template Description
создание SQL MI в новой виртуальной сети

Развертывание в Azure
Разверните управляемый экземпляр Базы данных SQL Azure (SQL MI) в новой виртуальной сети.
Создание SQL MI с настройкой отправки журналов и метрик

Развертывание в Azure
Этот шаблон позволяет развернуть SQL MI и дополнительные ресурсы, используемые для хранения журналов и метрик (рабочая область диагностики, учетная запись хранения, концентратор событий).
Создание SQL MI с переходом в новой виртуальной сети

Развертывание в Azure
Разверните управляемый экземпляр Базы данных SQL Azure (SQL MI) и JumpBox с помощью SSMS в новой виртуальной сети.
Создание SQL MI с настроенным подключением типа "точка — сеть"

Развертывание в Azure
Разверните управляемый экземпляр Базы данных SQL Azure (SQL MI) и шлюз виртуальной сети, настроенный для подключения типа "точка — сеть" в новой виртуальной сети.
Развертывание управляемого экземпляра SQL с помощью сети

Развертывание в Azure
Развертывание UDR и NSG для поддержки Управляемого экземпляра SQL Azure и развертывания управляемого экземпляра

Определение ресурса 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
identity Удостоверение Azure Active Directory управляемого экземпляра. ResourceIdentity
location Расположение ресурса. строка (обязательно)
name имя ресурса. строка (обязательно)
properties Свойства ресурса. ManagedInstanceProperties
sku SKU управляемого экземпляра. Допустимые значения для sku.name: GP_Gen5 (General Purpose, Standard-series); GP_G8IM (Общего назначения, Премиум-серия); GP_G8IH (Общего назначения, Премиум-серия с оптимизацией памяти); BC_Gen5 (Критически важный для бизнеса, Standard-Series); BC_G8IM (Business Critical, Premium-серия); BC_G8IH (критически важный для бизнеса, оптимизированный для памяти серии Premium). Sku
tags Теги ресурсов Словарь имен и значений тегов.
type Тип ресурса "Microsoft.Sql/managedInstances@2024-11-01-preview"

ManagedInstanceExternalAdministrator

Name Description Value
administratorType Тип администратора развера. 'ActiveDirectory'
azureADOnlyAuthentication Включена только проверка подлинности Azure Active Directory. bool
login Имя входа администратора сервера. string
principalType Тип субъекта-администратора. 'Application'
'Group'
'User'
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 Имя администратора для управляемого экземпляра. Можно указать только при создании управляемого экземпляра (и требуется для создания). string
administratorLoginPassword Пароль для входа администратора (требуется для создания управляемого экземпляра). string

Constraints:
Конфиденциальное значение. Передайте в качестве безопасного параметра.
administrators Администратора Azure Active Directory можно использовать во время создания экземпляра и обновления экземпляра, за исключением свойства azureADOnlyAuthentication. Чтобы обновить свойство azureADOnlyAuthentication, необходимо использовать отдельный API. ManagedInstanceExternalAdministrator
authenticationMetadata Режим поиска метаданных метаданных управляемого экземпляра. 'AzureAD'
'Paired'
'Windows'
collation Параметры сортировки управляемого экземпляра. string
databaseFormat Задает внутренний формат баз данных экземпляров, относящихся к версии ядра SQL. 'AlwaysUpToDate'
'SQLServer2022'
«SQLServer2025»
dnsZonePartner Идентификатор ресурса другого управляемого экземпляра, зона DNS которого будет совместно использовать этот управляемый экземпляр после создания. string
hybridSecondaryUsage Гибридное вторичное использование. Возможные значения: "Активный" (значение по умолчанию) и "Пассивный" (клиент использует вторичную функцию в качестве пассивного аварийного восстановления). 'Active'
'Passive'
instancePoolId Идентификатор пула экземпляров, к которому принадлежит управляемый сервер. string
isGeneralPurposeV2 Независимо от того, является ли это вариантом GPv2 выпуска общего назначения. bool
keyId Универсальный код ресурса (URI) ключа для шифрования. string
licenseType Тип лицензии. Возможные значения: LicenseIncluded (обычная цена включительно с новой лицензией SQL) и BasePrice (скидка на AHB для привлечения собственных лицензий SQL). 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId Указывает идентификатор конфигурации обслуживания для применения к этому управляемому экземпляру. string
managedInstanceCreateMode Задает режим создания базы данных.

По умолчанию: создание регулярного экземпляра.

Восстановление. Создание экземпляра путем восстановления набора резервных копий в определенный момент времени. Необходимо указать RestorePointInTime и SourceManagedInstanceId.
'Default'
'PointInTimeRestore'
memorySizeInGB Объем памяти в ГБ. Минимальное значение: 28. Максимальное значение: 870. Минимальное и максимальное значение зависят от количества виртуальных ядер и уровня служб. Подробнее об ограничениях ресурсов: https://aka.ms/mi-resource-limits-api. int
minimalTlsVersion Минимальная версия TLS. Допустимые значения: "Нет", "1.0", "1.1", "1.2" string
pricingModel Модель ценообразования управляемого экземпляра. 'Freemium'
'Regular'
primaryUserAssignedIdentityId Идентификатор ресурса назначаемого пользователем удостоверения, используемого по умолчанию. string
proxyOverride Тип подключения, используемый для подключения к экземпляру. 'Default'
'Proxy'
'Redirect'
publicDataEndpointEnabled Включена ли общедоступная конечная точка данных. bool
requestedBackupStorageRedundancy Тип учетной записи хранения, используемый для хранения резервных копий для этого экземпляра. Параметры: Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) и GeoZone(GeoZoneRedundantStorage) 'Geo'
'GeoZone'
'Local'
'Zone'
requestedLogicalAvailabilityZone Указывает логическую зону доступности, к которой прикреплен управляемый экземпляр. '1'
'2'
'3'
'NoPreference'
restorePointInTime Указывает точку во времени (ISO8601 формате) исходной базы данных, которая будет восстановлена для создания новой базы данных. string
servicePrincipal Субъект-служба управляемого экземпляра. ServicePrincipal
sourceManagedInstanceId Идентификатор ресурса исходного управляемого экземпляра, связанного с операцией создания этого экземпляра. string
storageIOps Хранение операций ввода-вывода в секунду. Минимальное значение: 300. Максимальное значение: 80000. Приращение 1 IOps разрешено только. Максимальное значение зависит от выбранного семейства оборудования и количества виртуальных ядер. int
storageSizeInGB Размер хранилища в ГБ. Минимальное значение: 32. Максимальное значение: 32768. Приращение только в 32 ГБ разрешено. Максимальное значение зависит от выбранного семейства оборудования и количества виртуальных ядер. int
storageThroughputMBps Параметр MBps пропускной способности хранилища не поддерживается в операции создания и обновления экземпляра. int
subnetId Идентификатор ресурса подсети для управляемого экземпляра. string
timezoneId Идентификатор часового пояса. Допустимые значения — это часовые пояса, поддерживаемые Windows.
Windows хранит сведения о поддерживаемых часовых поясах, включая идентификатор, в реестре в разделе
KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Часовой пояс.
Эти значения реестра можно получить с помощью SQL Server, запросив имя SELECT AS timezone_id FROM sys.time_zone_info.
Список идентификаторов также можно получить путем выполнения [System.TimeZoneInfo]::GetSystemTimeZones() в PowerShell.
Пример допустимого идентификатора часового пояса — "Тихоокеанское стандартное время" или "W". Стандартное время в Европе.
string
vCores Количество виртуальных ядер. Допустимые значения: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Поддерживаемые виртуальные ядра зависят от выбранного семейства оборудования и уровня служб. int
zoneRedundant Включена ли избыточность между зонами. bool

ResourceIdentity

Name Description Value
type Тип удостоверения. Установите для параметра SystemAssigned значение SystemAssigned, чтобы автоматически создать и назначить субъект Azure Active Directory для ресурса. 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'
userAssignedIdentities Идентификаторы ресурса назначенных пользователем удостоверений для использования ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Name Description Value

ServicePrincipal

Name Description Value
type Тип субъекта-службы. 'None'
'SystemAssigned'

Sku

Name Description Value
capacity Емкость конкретного номера SKU. int
family Если служба имеет разные поколения оборудования для одного номера SKU, это можно записать здесь. string
name Имя номера SKU, как правило, буква + код номера, например P3. строка (обязательно)
size Размер конкретного номера SKU string
tier Уровень или выпуск конкретного номера SKU, например "Базовый", "Премиум". string

TrackedResourceTags

Name Description Value

UserIdentity

Name Description Value

Примеры использования

Проверенные модули Azure

Следующие проверенные модули Azure можно использовать для развертывания этого типа ресурсов.

Module Description
Управляемый экземпляр SQL Модуль ресурсов AVM для управляемого экземпляра SQL