Майкрософт. SQL servers/failoverGroups 2021-08-01-preview

Определение ресурса Bicep

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

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

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

Создать Майкрософт. Ресурс sql/servers/failoverGroups, добавьте следующий Bicep в ваш шаблон.

resource symbolicname 'Microsoft.Sql/servers/failoverGroups@2021-08-01-preview' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    databases: [
      'string'
    ]
    partnerServers: [
      {
        id: 'string'
      }
    ]
    readOnlyEndpoint: {
      failoverPolicy: 'string'
    }
    readWriteEndpoint: {
      failoverPolicy: 'string'
      failoverWithDataLossGracePeriodMinutes: int
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

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

Майкрософт. Sql/servers/failoverGroups

Name Description Value
name имя ресурса. строка (обязательно)
parent В Bicep можно указать родительский ресурс для дочернего ресурса. Это свойство необходимо добавить, только если дочерний ресурс объявлен за пределами родительского ресурса.

Дополнительные сведения см. в разделе Дочерний ресурс за пределами родительского ресурса.
Символьное имя ресурса типа: серверы
properties Свойства ресурса. FailoverGroupProperties
tags Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах

FailoverGroupProperties

Name Description Value
databases Список баз данных в группе отработки отказа. string[]
partnerServers Список сведений о сервере партнера для группы отработки отказа. PartnerInfo[] (обязательно)
readOnlyEndpoint Конечная точка группы отработки отказа только для чтения. FailoverGroupReadOnlyEndpoint
readWriteEndpoint Конечная точка чтения и записи экземпляра группы отработки отказа. FailoverGroupReadWriteEndpoint (обязательно)

FailoverGroupReadOnlyEndpoint

Name Description Value
failoverPolicy Политика отработки отказа конечной точки только для чтения для группы отработки отказа. 'Disabled'
'Enabled'

FailoverGroupReadWriteEndpoint

Name Description Value
failoverPolicy Политика отработки отказа конечной точки чтения и записи для группы отработки отказа. Если отработка отказа является автоматической, требуется отработка отказаWithDataLossGracePeriodMinutes. 'Automatic'
«Вручную» (обязательно)
failoverWithDataLossGracePeriodMinutes Льготный период перед отработкой отказа с потерей данных пытается выполнить для конечной точки чтения и записи. Если отработка отказа является автоматической, требуется отработка отказаWithDataLossGracePeriodMinutes. int

FailoverGroupTags

Name Description Value

PartnerInfo

Name Description Value
id Идентификатор ресурса сервера партнера. строка (обязательно)

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

Bicep Samples

Базовый пример развертывания Microsoft Azure SQL Failover Group.

param resourceName string = 'acctest0001'
param location string = 'westus'
param secondaryLocation string = 'eastus'
@secure()
@description('The administrator login password for the SQL server')
param administratorLoginPassword string

resource server 'Microsoft.Sql/servers@2023-08-01-preview' = {
  name: '${resourceName}-primary'
  location: location
  properties: {
    administratorLogin: 'mradministrator'
    administratorLoginPassword: administratorLoginPassword
    minimalTlsVersion: '1.2'
    publicNetworkAccess: 'Enabled'
    restrictOutboundNetworkAccess: 'Disabled'
    version: '12.0'
  }
}

resource failoverGroup 'Microsoft.Sql/servers/failoverGroups@2023-08-01-preview' = {
  name: '${resourceName}-fg'
  parent: server
  properties: {
    databases: [
      database.id
    ]
    partnerServers: [
      {
        id: server1.id
      }
    ]
    readOnlyEndpoint: {
      failoverPolicy: 'Disabled'
    }
    readWriteEndpoint: {
      failoverPolicy: 'Automatic'
      failoverWithDataLossGracePeriodMinutes: 60
    }
  }
}

resource server1 'Microsoft.Sql/servers@2023-08-01-preview' = {
  name: '${resourceName}-secondary'
  location: secondaryLocation
  properties: {
    administratorLogin: 'mradministrator'
    administratorLoginPassword: administratorLoginPassword
    minimalTlsVersion: '1.2'
    publicNetworkAccess: 'Enabled'
    restrictOutboundNetworkAccess: 'Disabled'
    version: '12.0'
  }
}

resource database 'Microsoft.Sql/servers/databases@2023-08-01-preview' = {
  name: '${resourceName}-db'
  location: location
  parent: server
  sku: {
    name: 'S1'
  }
  properties: {
    autoPauseDelay: 0
    collation: 'SQL_Latin1_General_CP1_CI_AS'
    createMode: 'Default'
    elasticPoolId: ''
    encryptionProtectorAutoRotation: false
    highAvailabilityReplicaCount: 0
    isLedgerOn: false
    licenseType: ''
    maxSizeBytes: 214748364800
    minCapacity: 0
    readScale: 'Disabled'
    requestedBackupStorageRedundancy: 'Geo'
    sampleName: ''
    secondaryType: ''
    zoneRedundant: false
  }
}

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

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

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

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

Создать Майкрософт. Ресурс sql/servers/failoverGroups — добавьте следующий JSON в ваш шаблон.

{
  "type": "Microsoft.Sql/servers/failoverGroups",
  "apiVersion": "2021-08-01-preview",
  "name": "string",
  "properties": {
    "databases": [ "string" ],
    "partnerServers": [
      {
        "id": "string"
      }
    ],
    "readOnlyEndpoint": {
      "failoverPolicy": "string"
    },
    "readWriteEndpoint": {
      "failoverPolicy": "string",
      "failoverWithDataLossGracePeriodMinutes": "int"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

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

Майкрософт. Sql/servers/failoverGroups

Name Description Value
apiVersion Версия API '2021-08-01-preview'
name имя ресурса. строка (обязательно)
properties Свойства ресурса. FailoverGroupProperties
tags Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах
type Тип ресурса 'Майкрософт. Sql/servers/failoverGroups'

FailoverGroupProperties

Name Description Value
databases Список баз данных в группе отработки отказа. string[]
partnerServers Список сведений о сервере партнера для группы отработки отказа. PartnerInfo[] (обязательно)
readOnlyEndpoint Конечная точка группы отработки отказа только для чтения. FailoverGroupReadOnlyEndpoint
readWriteEndpoint Конечная точка чтения и записи экземпляра группы отработки отказа. FailoverGroupReadWriteEndpoint (обязательно)

FailoverGroupReadOnlyEndpoint

Name Description Value
failoverPolicy Политика отработки отказа конечной точки только для чтения для группы отработки отказа. 'Disabled'
'Enabled'

FailoverGroupReadWriteEndpoint

Name Description Value
failoverPolicy Политика отработки отказа конечной точки чтения и записи для группы отработки отказа. Если отработка отказа является автоматической, требуется отработка отказаWithDataLossGracePeriodMinutes. 'Automatic'
«Вручную» (обязательно)
failoverWithDataLossGracePeriodMinutes Льготный период перед отработкой отказа с потерей данных пытается выполнить для конечной точки чтения и записи. Если отработка отказа является автоматической, требуется отработка отказаWithDataLossGracePeriodMinutes. int

FailoverGroupTags

Name Description Value

PartnerInfo

Name Description Value
id Идентификатор ресурса сервера партнера. строка (обязательно)

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

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

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

  • Группы ресурсов

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

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

Создать Майкрософт. Ресурс sql/servers/failoverGroups — добавьте следующий Terraform в ваш шаблон.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/servers/failoverGroups@2021-08-01-preview"
  name = "string"
  parent_id = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      databases = [
        "string"
      ]
      partnerServers = [
        {
          id = "string"
        }
      ]
      readOnlyEndpoint = {
        failoverPolicy = "string"
      }
      readWriteEndpoint = {
        failoverPolicy = "string"
        failoverWithDataLossGracePeriodMinutes = int
      }
    }
  }
}

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

Майкрософт. Sql/servers/failoverGroups

Name Description Value
name имя ресурса. строка (обязательно)
parent_id Идентификатор ресурса, который является родительским для этого ресурса. Идентификатор ресурса типа: серверы
properties Свойства ресурса. FailoverGroupProperties
tags Теги ресурсов Словарь имен и значений тегов.
type Тип ресурса «Майкрософт. Sql/servers/failoverGroups@2021-08-01-preview"

FailoverGroupProperties

Name Description Value
databases Список баз данных в группе отработки отказа. string[]
partnerServers Список сведений о сервере партнера для группы отработки отказа. PartnerInfo[] (обязательно)
readOnlyEndpoint Конечная точка группы отработки отказа только для чтения. FailoverGroupReadOnlyEndpoint
readWriteEndpoint Конечная точка чтения и записи экземпляра группы отработки отказа. FailoverGroupReadWriteEndpoint (обязательно)

FailoverGroupReadOnlyEndpoint

Name Description Value
failoverPolicy Политика отработки отказа конечной точки только для чтения для группы отработки отказа. 'Disabled'
'Enabled'

FailoverGroupReadWriteEndpoint

Name Description Value
failoverPolicy Политика отработки отказа конечной точки чтения и записи для группы отработки отказа. Если отработка отказа является автоматической, требуется отработка отказаWithDataLossGracePeriodMinutes. 'Automatic'
«Вручную» (обязательно)
failoverWithDataLossGracePeriodMinutes Льготный период перед отработкой отказа с потерей данных пытается выполнить для конечной точки чтения и записи. Если отработка отказа является автоматической, требуется отработка отказаWithDataLossGracePeriodMinutes. int

FailoverGroupTags

Name Description Value

PartnerInfo

Name Description Value
id Идентификатор ресурса сервера партнера. строка (обязательно)

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

Примеры Terraform

Базовый пример развертывания Microsoft Azure SQL Failover Group.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

data "azapi_client_config" "current" {}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westus"
}

variable "secondary_location" {
  type    = string
  default = "eastus"
}

variable "administrator_login_password" {
  type        = string
  sensitive   = true
  description = "The administrator login password for the SQL server"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "server" {
  type      = "Microsoft.Sql/servers@2023-08-01-preview"
  parent_id = azapi_resource.resourceGroup.id
  name      = "${var.resource_name}-primary"
  location  = var.location
  body = {
    properties = {
      administratorLogin            = "mradministrator"
      administratorLoginPassword    = var.administrator_login_password
      minimalTlsVersion             = "1.2"
      publicNetworkAccess           = "Enabled"
      restrictOutboundNetworkAccess = "Disabled"
      version                       = "12.0"
    }
  }
}

resource "azapi_resource" "server_1" {
  type      = "Microsoft.Sql/servers@2023-08-01-preview"
  parent_id = azapi_resource.resourceGroup.id
  name      = "${var.resource_name}-secondary"
  location  = var.secondary_location
  body = {
    properties = {
      administratorLogin            = "mradministrator"
      administratorLoginPassword    = var.administrator_login_password
      minimalTlsVersion             = "1.2"
      publicNetworkAccess           = "Enabled"
      restrictOutboundNetworkAccess = "Disabled"
      version                       = "12.0"
    }
  }
}

resource "azapi_resource" "database" {
  type      = "Microsoft.Sql/servers/databases@2023-08-01-preview"
  parent_id = azapi_resource.server.id
  name      = "${var.resource_name}-db"
  location  = var.location
  body = {
    properties = {
      autoPauseDelay                   = 0
      collation                        = "SQL_Latin1_General_CP1_CI_AS"
      createMode                       = "Default"
      elasticPoolId                    = ""
      encryptionProtectorAutoRotation  = false
      highAvailabilityReplicaCount     = 0
      isLedgerOn                       = false
      licenseType                      = ""
      maxSizeBytes                     = 214748364800
      minCapacity                      = 0
      readScale                        = "Disabled"
      requestedBackupStorageRedundancy = "Geo"
      sampleName                       = ""
      secondaryType                    = ""
      zoneRedundant                    = false
    }
    sku = {
      name = "S1"
    }
  }
}

resource "azapi_resource" "failoverGroup" {
  type      = "Microsoft.Sql/servers/failoverGroups@2023-08-01-preview"
  parent_id = azapi_resource.server.id
  name      = "${var.resource_name}-fg"
  body = {
    properties = {
      databases = [azapi_resource.database.id]
      partnerServers = [{
        id = azapi_resource.server_1.id
      }]
      readOnlyEndpoint = {
        failoverPolicy = "Disabled"
      }
      readWriteEndpoint = {
        failoverPolicy                         = "Automatic"
        failoverWithDataLossGracePeriodMinutes = 60
      }
    }
  }
}