Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
- Latest
- 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 см. в журнала изменений.
Формат ресурса
Чтобы создать ресурс 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 в новой виртуальной сети |
Разверните управляемый экземпляр Базы данных SQL Azure (SQL MI) в новой виртуальной сети. |
|
Создание SQL MI с настройкой отправки журналов и метрик |
Этот шаблон позволяет развернуть SQL MI и дополнительные ресурсы, используемые для хранения журналов и метрик (рабочая область диагностики, учетная запись хранения, концентратор событий). |
|
Создание SQL MI с переходом в новой виртуальной сети |
Разверните управляемый экземпляр Базы данных SQL Azure (SQL MI) и JumpBox с помощью SSMS в новой виртуальной сети. |
|
Создание SQL MI с настроенным подключением типа "точка — сеть" |
Разверните управляемый экземпляр Базы данных SQL Azure (SQL MI) и шлюз виртуальной сети, настроенный для подключения типа "точка — сеть" в новой виртуальной сети. |
|
Развертывание управляемого экземпляра SQL с помощью сети |
Развертывание 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 |