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


Серверы Microsoft.DBforMySQL 2017-12-01

Замечания

Использование шаблона для создания сервера MySQL с значением реплики не является идемпотентным. Сервер успешно создается при первом создании. Однако развертывание шаблона, когда сервер реплики уже существует, возвращает ошибку.

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

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

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

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

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

resource symbolicname 'Microsoft.DBforMySQL/servers@2017-12-01' = {
  identity: {
    type: 'string'
  }
  location: 'string'
  name: 'string'
  properties: {
    infrastructureEncryption: 'string'
    minimalTlsVersion: 'string'
    publicNetworkAccess: 'string'
    sslEnforcement: 'string'
    storageProfile: {
      backupRetentionDays: int
      geoRedundantBackup: 'string'
      storageAutogrow: 'string'
      storageMB: int
    }
    version: 'string'
    createMode: 'string'
    // For remaining properties, see ServerPropertiesForCreateOrServerProperties objects
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Объекты ServerPropertiesForCreateOrServerProperties

Задайте свойство createMode, чтобы указать тип объекта.

Для по умолчаниюиспользуйте:

{
  administratorLogin: 'string'
  administratorLoginPassword: 'string'
  createMode: 'Default'
}

Для GeoRestoreиспользуйте:

{
  createMode: 'GeoRestore'
  sourceServerId: 'string'
}

Для PointInTimeRestoreиспользуйте:

{
  createMode: 'PointInTimeRestore'
  restorePointInTime: 'string'
  sourceServerId: 'string'
}

Для репликииспользуйте:

{
  createMode: 'Replica'
  sourceServerId: 'string'
}

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

Microsoft.DBforMySQL/servers;

Имя Описание Ценность
тождество Удостоверение Azure Active Directory сервера. ResourceIdentity
местоположение Расположение, в котором находится ресурс. строка (обязательно)
имя Имя ресурса строка (обязательно)
свойства Свойства сервера. ServerPropertiesForCreateOrServerProperties (обязательно)
SKU Номер SKU (ценовая категория) сервера. Sku
Теги Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах

ResourceIdentity

Имя Описание Ценность
тип Тип удостоверения. Установите для параметра SystemAssigned значение SystemAssigned, чтобы автоматически создать и назначить субъект Azure Active Directory для ресурса. SystemAssigned

ServerForCreateTags

Имя Описание Ценность

ServerPropertiesForCreateOrServerProperties

Имя Описание Ценность
createMode Установите значение Default для типа ServerPropertiesForDefaultCreate. Установите значение GeoRestore для типа ServerPropertiesForGeoRestore. Установите значение PointInTimeRestore для типа ServerPropertiesForRestore. Установите значение "Реплика" для типа ServerPropertiesForReplica. По умолчанию
"GeoRestore"
"PointInTimeRestore"
"Реплика" (обязательно)
инфраструктураEncryption Состояние, показывающее, включена ли шифрование инфраструктуры с поддержкой сервера. "Отключено"
"Включено"
minTlsVersion Примените минимальную версию TLS для сервера. "TLS1_0"
"TLS1_1"
"TLS1_2"
TLSEnforcementDisabled
publicNetworkAccess Разрешено ли для этого сервера доступ к общедоступной сети. Значение является необязательным, но при передаче в нее должно быть включено или отключено. "Отключено"
"Включено"
sslEnforcement Включите принудительное применение SSL или нет при подключении к серверу. "Отключено"
"Включено"
storageProfile Профиль хранения сервера. StorageProfile
Версия Версия сервера. '5.6'
'5.7'
'8.0'

ServerPropertiesForDefaultCreate

Имя Описание Ценность
administratorLogin Имя входа администратора сервера. Можно указать только при создании сервера (и требуется для создания). Имя входа необходимо при обновлении пароля. строка (обязательно)
administratorLoginPassword Пароль для входа администратора. струна

Ограничения целостности:
Конфиденциальное значение. Передайте в качестве безопасного параметра. (обязательно)
createMode Режим создания нового сервера. Default (обязательно)

ServerPropertiesForGeoRestore

Имя Описание Ценность
createMode Режим создания нового сервера. GeoRestore (обязательно)
sourceServerId Идентификатор исходного сервера для восстановления. строка (обязательно)

ServerPropertiesForReplica

Имя Описание Ценность
createMode Режим создания нового сервера. "Реплика" (обязательно)
sourceServerId Идентификатор главного сервера для создания реплики из. строка (обязательно)

ServerPropertiesForRestore

Имя Описание Ценность
createMode Режим создания нового сервера. PointInTimeRestore (обязательно)
restorePointInTime Время создания точки восстановления (ISO8601 формате), указывающее время восстановления. строка (обязательно)
sourceServerId Идентификатор исходного сервера для восстановления. строка (обязательно)

Sku

Имя Описание Ценность
способность Емкость увеличения и увеличения масштаба, представляющая вычислительные единицы сервера. int

Ограничения целостности:
Минимальное значение = 0
семья Семейство оборудования. струна
имя Имя SKU, как правило, уровня + семейства и ядер, например B_Gen4_1, GP_Gen5_8. строка (обязательно)
размер Код размера, интерпретируемый ресурсом соответствующим образом. струна
ярус Уровень конкретного номера SKU, например "Базовый". "Базовый"
"GeneralPurpose"
MemoryOptimized

StorageProfile

Имя Описание Ценность
backupRetentionDays Дни хранения резервных копий для сервера. int
geoRedundantBackup Включите геоизбыточное или не для резервного копирования сервера. "Отключено"
"Включено"
storageAutogrow Включить автоматическое увеличение хранилища. "Отключено"
"Включено"
storageMB Максимально допустимое хранилище для сервера. int

Примеры краткого руководства

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

Bicep-файл Описание
создание веб-приложения в Linux с базой данных Azure для MySQL Этот шаблон предоставляет способ развертывания веб-приложений в Linux с базой данных Azure для MySQL.
развертывание базы данных Azure для MySQL с помощью виртуальной сети Этот шаблон предоставляет способ развертывания базы данных Azure для MySQL с интеграцией виртуальной сети.
Развертывает 1 экземпляр PaaS MySQL и до 5 реплик только для чтения Этот шаблон развертывает экземпляр сервера PaaS MySQL и от 0 до 5 реплик только для чтения. Все они будут заданы в том же расположении, что и главный, и репликация будут автоматически настроены.
веб-приложение с базой данных Azure для MySQL Этот шаблон предоставляет простой способ развертывания веб-приложения в веб-приложениях службы приложений Azure с базой данных Azure для MySQL.

Определение ресурса шаблона ARM

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

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

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

Чтобы создать ресурс Microsoft.DBforMySQL/servers, добавьте следующий код JSON в шаблон.

{
  "type": "Microsoft.DBforMySQL/servers",
  "apiVersion": "2017-12-01",
  "name": "string",
  "identity": {
    "type": "string"
  },
  "location": "string",
  "properties": {
    "infrastructureEncryption": "string",
    "minimalTlsVersion": "string",
    "publicNetworkAccess": "string",
    "sslEnforcement": "string",
    "storageProfile": {
      "backupRetentionDays": "int",
      "geoRedundantBackup": "string",
      "storageAutogrow": "string",
      "storageMB": "int"
    },
    "version": "string",
    "createMode": "string"
    // For remaining properties, see ServerPropertiesForCreateOrServerProperties objects
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Объекты ServerPropertiesForCreateOrServerProperties

Задайте свойство createMode, чтобы указать тип объекта.

Для по умолчаниюиспользуйте:

{
  "administratorLogin": "string",
  "administratorLoginPassword": "string",
  "createMode": "Default"
}

Для GeoRestoreиспользуйте:

{
  "createMode": "GeoRestore",
  "sourceServerId": "string"
}

Для PointInTimeRestoreиспользуйте:

{
  "createMode": "PointInTimeRestore",
  "restorePointInTime": "string",
  "sourceServerId": "string"
}

Для репликииспользуйте:

{
  "createMode": "Replica",
  "sourceServerId": "string"
}

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

Microsoft.DBforMySQL/servers;

Имя Описание Ценность
apiVersion Версия API '2017-12-01'
тождество Удостоверение Azure Active Directory сервера. ResourceIdentity
местоположение Расположение, в котором находится ресурс. строка (обязательно)
имя Имя ресурса строка (обязательно)
свойства Свойства сервера. ServerPropertiesForCreateOrServerProperties (обязательно)
SKU Номер SKU (ценовая категория) сервера. Sku
Теги Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах
тип Тип ресурса "Microsoft.DBforMySQL/servers"

ResourceIdentity

Имя Описание Ценность
тип Тип удостоверения. Установите для параметра SystemAssigned значение SystemAssigned, чтобы автоматически создать и назначить субъект Azure Active Directory для ресурса. SystemAssigned

ServerForCreateTags

Имя Описание Ценность

ServerPropertiesForCreateOrServerProperties

Имя Описание Ценность
createMode Установите значение Default для типа ServerPropertiesForDefaultCreate. Установите значение GeoRestore для типа ServerPropertiesForGeoRestore. Установите значение PointInTimeRestore для типа ServerPropertiesForRestore. Установите значение "Реплика" для типа ServerPropertiesForReplica. По умолчанию
"GeoRestore"
"PointInTimeRestore"
"Реплика" (обязательно)
инфраструктураEncryption Состояние, показывающее, включена ли шифрование инфраструктуры с поддержкой сервера. "Отключено"
"Включено"
minTlsVersion Примените минимальную версию TLS для сервера. "TLS1_0"
"TLS1_1"
"TLS1_2"
TLSEnforcementDisabled
publicNetworkAccess Разрешено ли для этого сервера доступ к общедоступной сети. Значение является необязательным, но при передаче в нее должно быть включено или отключено. "Отключено"
"Включено"
sslEnforcement Включите принудительное применение SSL или нет при подключении к серверу. "Отключено"
"Включено"
storageProfile Профиль хранения сервера. StorageProfile
Версия Версия сервера. '5.6'
'5.7'
'8.0'

ServerPropertiesForDefaultCreate

Имя Описание Ценность
administratorLogin Имя входа администратора сервера. Можно указать только при создании сервера (и требуется для создания). Имя входа необходимо при обновлении пароля. строка (обязательно)
administratorLoginPassword Пароль для входа администратора. струна

Ограничения целостности:
Конфиденциальное значение. Передайте в качестве безопасного параметра. (обязательно)
createMode Режим создания нового сервера. Default (обязательно)

ServerPropertiesForGeoRestore

Имя Описание Ценность
createMode Режим создания нового сервера. GeoRestore (обязательно)
sourceServerId Идентификатор исходного сервера для восстановления. строка (обязательно)

ServerPropertiesForReplica

Имя Описание Ценность
createMode Режим создания нового сервера. "Реплика" (обязательно)
sourceServerId Идентификатор главного сервера для создания реплики из. строка (обязательно)

ServerPropertiesForRestore

Имя Описание Ценность
createMode Режим создания нового сервера. PointInTimeRestore (обязательно)
restorePointInTime Время создания точки восстановления (ISO8601 формате), указывающее время восстановления. строка (обязательно)
sourceServerId Идентификатор исходного сервера для восстановления. строка (обязательно)

Sku

Имя Описание Ценность
способность Емкость увеличения и увеличения масштаба, представляющая вычислительные единицы сервера. int

Ограничения целостности:
Минимальное значение = 0
семья Семейство оборудования. струна
имя Имя SKU, как правило, уровня + семейства и ядер, например B_Gen4_1, GP_Gen5_8. строка (обязательно)
размер Код размера, интерпретируемый ресурсом соответствующим образом. струна
ярус Уровень конкретного номера SKU, например "Базовый". "Базовый"
"GeneralPurpose"
MemoryOptimized

StorageProfile

Имя Описание Ценность
backupRetentionDays Дни хранения резервных копий для сервера. int
geoRedundantBackup Включите геоизбыточное или не для резервного копирования сервера. "Отключено"
"Включено"
storageAutogrow Включить автоматическое увеличение хранилища. "Отключено"
"Включено"
storageMB Максимально допустимое хранилище для сервера. int

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

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

Шаблон Описание
Шлюз приложений для веб-приложения с ограничением IP-адресов

развертывание в Azure
Этот шаблон создает шлюз приложений перед веб-приложением Azure с включенным ограничением IP-адресов в веб-приложении.
Веб-приложение Buffalo

развертывание в Azure
Начните работать с приложением Golang Buffalo в Azure быстро и дешево.
создание веб-приложения в Linux с базой данных Azure для MySQL

развертывание в Azure
Этот шаблон предоставляет способ развертывания веб-приложений в Linux с базой данных Azure для MySQL.
развертывание базы данных Azure для MySQL с помощью виртуальной сети

развертывание в Azure
Этот шаблон предоставляет способ развертывания базы данных Azure для MySQL с интеграцией виртуальной сети.
Развертывает 1 экземпляр PaaS MySQL и до 5 реплик только для чтения

развертывание в Azure
Этот шаблон развертывает экземпляр сервера PaaS MySQL и от 0 до 5 реплик только для чтения. Все они будут заданы в том же расположении, что и главный, и репликация будут автоматически настроены.
CI/CD Java с помощью Jenkins и веб-приложений Azure

развертывание в Azure
Это пример для CI/CD Java с помощью Jenkins и веб-приложений Azure.
Sonarqube Docker Web App в Linux с MySQL

развертывание в Azure
Этот шаблон позволяет легко развернуть образ Docker Sonarqube (альпийский тег) в веб-приложении Linux с базой данных Azure для MySQL.
веб-приложение с базой данных Azure для MySQL

развертывание в Azure
Этот шаблон предоставляет простой способ развертывания веб-приложения в веб-приложениях службы приложений Azure с базой данных Azure для MySQL.

Определение ресурса Terraform (поставщик AzAPI)

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

  • групп ресурсов

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

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

Чтобы создать ресурс Microsoft.DBforMySQL/servers, добавьте следующий объект Terraform в шаблон.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DBforMySQL/servers@2017-12-01"
  name = "string"
  identity = {
    type = "string"
  }
  location = "string"
  sku = {
    capacity = int
    family = "string"
    name = "string"
    size = "string"
    tier = "string"
  }
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      infrastructureEncryption = "string"
      minimalTlsVersion = "string"
      publicNetworkAccess = "string"
      sslEnforcement = "string"
      storageProfile = {
        backupRetentionDays = int
        geoRedundantBackup = "string"
        storageAutogrow = "string"
        storageMB = int
      }
      version = "string"
      createMode = "string"
      // For remaining properties, see ServerPropertiesForCreateOrServerProperties objects
    }
  })
}

Объекты ServerPropertiesForCreateOrServerProperties

Задайте свойство createMode, чтобы указать тип объекта.

Для по умолчаниюиспользуйте:

{
  administratorLogin = "string"
  administratorLoginPassword = "string"
  createMode = "Default"
}

Для GeoRestoreиспользуйте:

{
  createMode = "GeoRestore"
  sourceServerId = "string"
}

Для PointInTimeRestoreиспользуйте:

{
  createMode = "PointInTimeRestore"
  restorePointInTime = "string"
  sourceServerId = "string"
}

Для репликииспользуйте:

{
  createMode = "Replica"
  sourceServerId = "string"
}

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

Microsoft.DBforMySQL/servers;

Имя Описание Ценность
тождество Удостоверение Azure Active Directory сервера. ResourceIdentity
местоположение Расположение, в котором находится ресурс. строка (обязательно)
имя Имя ресурса строка (обязательно)
свойства Свойства сервера. ServerPropertiesForCreateOrServerProperties (обязательно)
SKU Номер SKU (ценовая категория) сервера. Sku
Теги Теги ресурсов Словарь имен и значений тегов.
тип Тип ресурса "Microsoft.DBforMySQL/servers@2017-12-01"

ResourceIdentity

Имя Описание Ценность
тип Тип удостоверения. Установите для параметра SystemAssigned значение SystemAssigned, чтобы автоматически создать и назначить субъект Azure Active Directory для ресурса. SystemAssigned

ServerForCreateTags

Имя Описание Ценность

ServerPropertiesForCreateOrServerProperties

Имя Описание Ценность
createMode Установите значение Default для типа ServerPropertiesForDefaultCreate. Установите значение GeoRestore для типа ServerPropertiesForGeoRestore. Установите значение PointInTimeRestore для типа ServerPropertiesForRestore. Установите значение "Реплика" для типа ServerPropertiesForReplica. По умолчанию
"GeoRestore"
"PointInTimeRestore"
"Реплика" (обязательно)
инфраструктураEncryption Состояние, показывающее, включена ли шифрование инфраструктуры с поддержкой сервера. "Отключено"
"Включено"
minTlsVersion Примените минимальную версию TLS для сервера. "TLS1_0"
"TLS1_1"
"TLS1_2"
TLSEnforcementDisabled
publicNetworkAccess Разрешено ли для этого сервера доступ к общедоступной сети. Значение является необязательным, но при передаче в нее должно быть включено или отключено. "Отключено"
"Включено"
sslEnforcement Включите принудительное применение SSL или нет при подключении к серверу. "Отключено"
"Включено"
storageProfile Профиль хранения сервера. StorageProfile
Версия Версия сервера. '5.6'
'5.7'
'8.0'

ServerPropertiesForDefaultCreate

Имя Описание Ценность
administratorLogin Имя входа администратора сервера. Можно указать только при создании сервера (и требуется для создания). Имя входа необходимо при обновлении пароля. строка (обязательно)
administratorLoginPassword Пароль для входа администратора. струна

Ограничения целостности:
Конфиденциальное значение. Передайте в качестве безопасного параметра. (обязательно)
createMode Режим создания нового сервера. Default (обязательно)

ServerPropertiesForGeoRestore

Имя Описание Ценность
createMode Режим создания нового сервера. GeoRestore (обязательно)
sourceServerId Идентификатор исходного сервера для восстановления. строка (обязательно)

ServerPropertiesForReplica

Имя Описание Ценность
createMode Режим создания нового сервера. "Реплика" (обязательно)
sourceServerId Идентификатор главного сервера для создания реплики из. строка (обязательно)

ServerPropertiesForRestore

Имя Описание Ценность
createMode Режим создания нового сервера. PointInTimeRestore (обязательно)
restorePointInTime Время создания точки восстановления (ISO8601 формате), указывающее время восстановления. строка (обязательно)
sourceServerId Идентификатор исходного сервера для восстановления. строка (обязательно)

Sku

Имя Описание Ценность
способность Емкость увеличения и увеличения масштаба, представляющая вычислительные единицы сервера. int

Ограничения целостности:
Минимальное значение = 0
семья Семейство оборудования. струна
имя Имя SKU, как правило, уровня + семейства и ядер, например B_Gen4_1, GP_Gen5_8. строка (обязательно)
размер Код размера, интерпретируемый ресурсом соответствующим образом. струна
ярус Уровень конкретного номера SKU, например "Базовый". "Базовый"
"GeneralPurpose"
MemoryOptimized

StorageProfile

Имя Описание Ценность
backupRetentionDays Дни хранения резервных копий для сервера. int
geoRedundantBackup Включите геоизбыточное или не для резервного копирования сервера. "Отключено"
"Включено"
storageAutogrow Включить автоматическое увеличение хранилища. "Отключено"
"Включено"
storageMB Максимально допустимое хранилище для сервера. int