Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
- 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 см. в журнала изменений.
Формат ресурса
Создать Майкрософт. Ресурс 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'
}
}
Значения свойств
Майкрософт. 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 only Authentication включена. | 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\Майкрософт\Windows NT\Текущая версия\Часовые пояса. Вы можете получить эти значения реестра через SQL Server, запросив SELECT имя AS timezone_id ИЗ 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', чтобы автоматически создать и назначить принципал 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 Verified Modules
Следующие Azure Проверенные модули могут использоваться для развертывания этого типа ресурсов.
| Module | Description |
|---|---|
| Управляемый экземпляр SQL | Модуль ресурсов AVM для Управляемый экземпляр SQL |
Azure Quickstart Samples
Следующие шаблоны Azure Quickstart содержат Bicep образцов для развертывания этого типа ресурсов.
| Bicep File | Description |
|---|---|
| Создать SQL MI внутри новой виртуальной сети | Развернуть Azure SQL Database Управляемый экземпляр (SQL MI) внутри новой виртуальная сеть. |
Определение ресурса шаблона ARM
Тип ресурса managedInstances можно развернуть с помощью операций, целевых:
- группы ресурсов . См. команды развертывания группы ресурсов
Список измененных свойств в каждой версии API см. в журнала изменений.
Формат ресурса
Создать Майкрософт. Ресурс 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"
}
}
Значения свойств
Майкрософт. Sql/managedInstances
| Name | Description | Value |
|---|---|---|
| apiVersion | Версия API | «2025-02-01-превью» |
| 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 | Тип ресурса | 'Майкрософт. Sql/managedInstances' |
ManagedInstanceExternalAdministrator
| Name | Description | Value |
|---|---|---|
| administratorType | Тип администратора развера. | 'ActiveDirectory' |
| azureADOnlyAuthentication | Azure Active Directory only Authentication включена. | 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\Майкрософт\Windows NT\Текущая версия\Часовые пояса. Вы можете получить эти значения реестра через SQL Server, запросив SELECT имя AS timezone_id ИЗ 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', чтобы автоматически создать и назначить принципал 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 Quickstart Templates
Следующие Azure шаблоны быстрого запуска развёртают этот тип ресурса.
| Template | Description |
|---|---|
|
Создать SQL MI внутри новой виртуальной сети |
Развернуть Azure SQL Database Управляемый экземпляр (SQL MI) внутри новой виртуальная сеть. |
|
Создать SQL MI с настроенной отправкой логов и метрик |
Этот шаблон позволяет развернуть SQL MI и дополнительные ресурсы, используемые для хранения журналов и метрик (рабочая область диагностики, учетная запись хранения, концентратор событий). |
|
Создать SQL MI с прыжком внутри новой виртуальной сети |
Развернуть Azure SQL Database Управляемый экземпляр (SQL MI) и JumpBox с SSMS внутри новой виртуальная сеть. |
|
Create SQL MI с конфигурированным соединением point-to-site |
Развернуть Azure SQL Database Управляемый экземпляр (SQL MI) и виртуальный сетевой шлюз, настроенный для соединения точка-сайт внутри новой виртуальной сети. |
|
Развернуть Управляемый экземпляр SQL с сетевыми |
Развернуть UDR и NSG для поддержки Управляемый экземпляр SQL Azure и развернуть Управляемый экземпляр |
Определение ресурса Terraform (поставщик AzAPI)
Тип ресурса managedInstances можно развернуть с помощью операций, целевых:
- Группы ресурсов
Список измененных свойств в каждой версии API см. в журнала изменений.
Формат ресурса
Создать Майкрософт. Ресурс 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"
}
}
}
Значения свойств
Майкрософт. 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 | Тип ресурса | «Майкрософт. Sql/managedInstances@2025-02-01-preview" |
ManagedInstanceExternalAdministrator
| Name | Description | Value |
|---|---|---|
| administratorType | Тип администратора развера. | 'ActiveDirectory' |
| azureADOnlyAuthentication | Azure Active Directory only Authentication включена. | 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\Майкрософт\Windows NT\Текущая версия\Часовые пояса. Вы можете получить эти значения реестра через SQL Server, запросив SELECT имя AS timezone_id ИЗ 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', чтобы автоматически создать и назначить принципал 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 Verified Modules
Следующие Azure Проверенные модули могут использоваться для развертывания этого типа ресурсов.
| Module | Description |
|---|---|
| Управляемый экземпляр SQL | Модуль ресурсов AVM для Управляемый экземпляр SQL |