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


Microsoft.SQL managedInstances 2020-11-01-preview

Определение ресурсов Bicep

Тип ресурса managedInstances можно развернуть с помощью операций, целевых:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Sql/managedInstances, добавьте следующий Bicep в шаблон.

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

Значения свойств

Microsoft.Sql/managedInstances

Name Description Value
identity Удостоверение Azure Active Directory управляемого экземпляра. ResourceIdentity
location Расположение ресурса. строка (обязательно)
name имя ресурса. строка (обязательно)
properties Свойства ресурса. ManagedInstanceProperties
sku SKU управляемого экземпляра. Допустимые значения для sku.name: GP_Gen4, GP_Gen5, BC_Gen4, BC_Gen5 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
administrators Администратор Azure Active Directory сервера. ManagedInstanceExternalAdministrator
collation Параметры сортировки управляемого экземпляра. string
dnsZonePartner Идентификатор ресурса другого управляемого экземпляра, зона DNS которого будет совместно использовать этот управляемый экземпляр после создания. string
instancePoolId Идентификатор пула экземпляров, к которому принадлежит управляемый сервер. string
keyId Универсальный код ресурса (URI) ключа для шифрования. string
licenseType Тип лицензии. Возможные значения: LicenseIncluded (обычная цена включительно с новой лицензией SQL) и BasePrice (скидка на AHB для привлечения собственных лицензий SQL). 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId Указывает идентификатор конфигурации обслуживания для применения к этому управляемому экземпляру. string
managedInstanceCreateMode Задает режим создания базы данных.

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

Восстановление. Создание экземпляра путем восстановления набора резервных копий в определенный момент времени. Необходимо указать RestorePointInTime и SourceManagedInstanceId.
'Default'
'PointInTimeRestore'
minimalTlsVersion Минимальная версия TLS. Допустимые значения: "Нет", "1.0", "1.1", "1.2" string
primaryUserAssignedIdentityId Идентификатор ресурса назначаемого пользователем удостоверения, используемого по умолчанию. string
proxyOverride Тип подключения, используемый для подключения к экземпляру. 'Default'
'Proxy'
'Redirect'
publicDataEndpointEnabled Включена ли общедоступная конечная точка данных. bool
restorePointInTime Указывает точку во времени (ISO8601 формате) исходной базы данных, которая будет восстановлена для создания новой базы данных. string
sourceManagedInstanceId Идентификатор ресурса исходного управляемого экземпляра, связанного с операцией создания этого экземпляра. string
storageAccountType Тип учетной записи хранения, используемый для хранения резервных копий для этого экземпляра. Параметры: LRS (LocallyRedundantStorage), ZRS (ZoneRedundantStorage) и GRS (GeoRedundantStorage) 'GRS'
'LRS'
'ZRS'
storageSizeInGB Размер хранилища в ГБ. Минимальное значение: 32. Максимальное значение: 8192. Приращение только в 32 ГБ разрешено. 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 Количество виртуальных ядер. Допустимые значения: 8, 16, 24, 32, 40, 64, 80. int
zoneRedundant Включена ли функция multi-az. bool

ResourceIdentity

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

ResourceIdentityUserAssignedIdentities

Name Description Value

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": "2020-11-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "administratorLogin": "string",
    "administratorLoginPassword": "string",
    "administrators": {
      "administratorType": "string",
      "azureADOnlyAuthentication": "bool",
      "login": "string",
      "principalType": "string",
      "sid": "string",
      "tenantId": "string"
    },
    "collation": "string",
    "dnsZonePartner": "string",
    "instancePoolId": "string",
    "keyId": "string",
    "licenseType": "string",
    "maintenanceConfigurationId": "string",
    "managedInstanceCreateMode": "string",
    "minimalTlsVersion": "string",
    "primaryUserAssignedIdentityId": "string",
    "proxyOverride": "string",
    "publicDataEndpointEnabled": "bool",
    "restorePointInTime": "string",
    "sourceManagedInstanceId": "string",
    "storageAccountType": "string",
    "storageSizeInGB": "int",
    "subnetId": "string",
    "timezoneId": "string",
    "vCores": "int",
    "zoneRedundant": "bool"
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Значения свойств

Microsoft.Sql/managedInstances

Name Description Value
apiVersion Версия API '2020-11-01-preview'
identity Удостоверение Azure Active Directory управляемого экземпляра. ResourceIdentity
location Расположение ресурса. строка (обязательно)
name имя ресурса. строка (обязательно)
properties Свойства ресурса. ManagedInstanceProperties
sku SKU управляемого экземпляра. Допустимые значения для sku.name: GP_Gen4, GP_Gen5, BC_Gen4, BC_Gen5 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
administrators Администратор Azure Active Directory сервера. ManagedInstanceExternalAdministrator
collation Параметры сортировки управляемого экземпляра. string
dnsZonePartner Идентификатор ресурса другого управляемого экземпляра, зона DNS которого будет совместно использовать этот управляемый экземпляр после создания. string
instancePoolId Идентификатор пула экземпляров, к которому принадлежит управляемый сервер. string
keyId Универсальный код ресурса (URI) ключа для шифрования. string
licenseType Тип лицензии. Возможные значения: LicenseIncluded (обычная цена включительно с новой лицензией SQL) и BasePrice (скидка на AHB для привлечения собственных лицензий SQL). 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId Указывает идентификатор конфигурации обслуживания для применения к этому управляемому экземпляру. string
managedInstanceCreateMode Задает режим создания базы данных.

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

Восстановление. Создание экземпляра путем восстановления набора резервных копий в определенный момент времени. Необходимо указать RestorePointInTime и SourceManagedInstanceId.
'Default'
'PointInTimeRestore'
minimalTlsVersion Минимальная версия TLS. Допустимые значения: "Нет", "1.0", "1.1", "1.2" string
primaryUserAssignedIdentityId Идентификатор ресурса назначаемого пользователем удостоверения, используемого по умолчанию. string
proxyOverride Тип подключения, используемый для подключения к экземпляру. 'Default'
'Proxy'
'Redirect'
publicDataEndpointEnabled Включена ли общедоступная конечная точка данных. bool
restorePointInTime Указывает точку во времени (ISO8601 формате) исходной базы данных, которая будет восстановлена для создания новой базы данных. string
sourceManagedInstanceId Идентификатор ресурса исходного управляемого экземпляра, связанного с операцией создания этого экземпляра. string
storageAccountType Тип учетной записи хранения, используемый для хранения резервных копий для этого экземпляра. Параметры: LRS (LocallyRedundantStorage), ZRS (ZoneRedundantStorage) и GRS (GeoRedundantStorage) 'GRS'
'LRS'
'ZRS'
storageSizeInGB Размер хранилища в ГБ. Минимальное значение: 32. Максимальное значение: 8192. Приращение только в 32 ГБ разрешено. 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 Количество виртуальных ядер. Допустимые значения: 8, 16, 24, 32, 40, 64, 80. int
zoneRedundant Включена ли функция multi-az. bool

ResourceIdentity

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

ResourceIdentityUserAssignedIdentities

Name Description Value

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@2020-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"
      }
      collation = "string"
      dnsZonePartner = "string"
      instancePoolId = "string"
      keyId = "string"
      licenseType = "string"
      maintenanceConfigurationId = "string"
      managedInstanceCreateMode = "string"
      minimalTlsVersion = "string"
      primaryUserAssignedIdentityId = "string"
      proxyOverride = "string"
      publicDataEndpointEnabled = bool
      restorePointInTime = "string"
      sourceManagedInstanceId = "string"
      storageAccountType = "string"
      storageSizeInGB = 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_Gen4, GP_Gen5, BC_Gen4, BC_Gen5 Sku
tags Теги ресурсов Словарь имен и значений тегов.
type Тип ресурса "Microsoft.Sql/managedInstances@2020-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
administrators Администратор Azure Active Directory сервера. ManagedInstanceExternalAdministrator
collation Параметры сортировки управляемого экземпляра. string
dnsZonePartner Идентификатор ресурса другого управляемого экземпляра, зона DNS которого будет совместно использовать этот управляемый экземпляр после создания. string
instancePoolId Идентификатор пула экземпляров, к которому принадлежит управляемый сервер. string
keyId Универсальный код ресурса (URI) ключа для шифрования. string
licenseType Тип лицензии. Возможные значения: LicenseIncluded (обычная цена включительно с новой лицензией SQL) и BasePrice (скидка на AHB для привлечения собственных лицензий SQL). 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId Указывает идентификатор конфигурации обслуживания для применения к этому управляемому экземпляру. string
managedInstanceCreateMode Задает режим создания базы данных.

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

Восстановление. Создание экземпляра путем восстановления набора резервных копий в определенный момент времени. Необходимо указать RestorePointInTime и SourceManagedInstanceId.
'Default'
'PointInTimeRestore'
minimalTlsVersion Минимальная версия TLS. Допустимые значения: "Нет", "1.0", "1.1", "1.2" string
primaryUserAssignedIdentityId Идентификатор ресурса назначаемого пользователем удостоверения, используемого по умолчанию. string
proxyOverride Тип подключения, используемый для подключения к экземпляру. 'Default'
'Proxy'
'Redirect'
publicDataEndpointEnabled Включена ли общедоступная конечная точка данных. bool
restorePointInTime Указывает точку во времени (ISO8601 формате) исходной базы данных, которая будет восстановлена для создания новой базы данных. string
sourceManagedInstanceId Идентификатор ресурса исходного управляемого экземпляра, связанного с операцией создания этого экземпляра. string
storageAccountType Тип учетной записи хранения, используемый для хранения резервных копий для этого экземпляра. Параметры: LRS (LocallyRedundantStorage), ZRS (ZoneRedundantStorage) и GRS (GeoRedundantStorage) 'GRS'
'LRS'
'ZRS'
storageSizeInGB Размер хранилища в ГБ. Минимальное значение: 32. Максимальное значение: 8192. Приращение только в 32 ГБ разрешено. 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 Количество виртуальных ядер. Допустимые значения: 8, 16, 24, 32, 40, 64, 80. int
zoneRedundant Включена ли функция multi-az. bool

ResourceIdentity

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

ResourceIdentityUserAssignedIdentities

Name Description Value

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