Microsoft. SQL sunucuları/failoverGroups

Bicep kaynak tanımı

Sunucular/failoverGroups kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

  • kaynak grupları - Bkz. kaynak grubu dağıtım komutları

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kullanım Örnekleri

Bicep Örnekleri

Microsoft Azure SQL Failover Group'un dağıtılmasına temel bir örnek.

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
  }
}

Kaynak biçimi

Bir Microsoft yaratmak için. Sql/servers/failoverGroups kaynağı, aşağıdaki Bicep'i şablonunuza ekleyin.

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

Özellik Değerleri

Microsoft. Sql/servers/failoverGroups

Name Description Value
name Kaynak adı dize (gerekli)
parent Bicep'te, bir çocuk kaynağın ana kaynağını belirtebilirsiniz. Bu özelliği yalnızca alt kaynak üst kaynağın dışında bildirildiğinde eklemeniz gerekir.

Daha fazla bilgi için bkz. Alt kaynaküst kaynak dışında.
Kaynak türü için sembolik ad: sunucuları
properties Kaynak özellikleri. FailoverGroupProperties
tags Kaynak etiketleri Etiket adları ve değerleri sözlüğü. Bkz. şablonlardaki Etiketleri

FailoverGroupProperties

Name Description Value
databases Yük devretme grubundaki veritabanlarının listesi. string[]
partnerServers Yük devretme grubu için iş ortağı sunucu bilgilerinin listesi. PartnerInfo[] (gerekli)
readOnlyEndpoint Yük devretme grubu örneğinin salt okunur uç noktası. FailoverGroupReadOnlyEndpoint
readWriteEndpoint Yük devretme grubu örneğinin okuma-yazma uç noktası. FailoverGroupReadWriteEndpoint (gerekli)
secondaryType İş ortağı sunucusunda veritabanları ikincil türü. 'Geo'
'Standby'

FailoverGroupReadOnlyEndpoint

Name Description Value
failoverPolicy Yük devretme grubu için salt okunur uç noktanın yük devretme ilkesi. 'Disabled'
'Enabled'
targetServer Salt okunur uç noktanın işaret ettiği hedef iş ortağı sunucusu. string

FailoverGroupReadWriteEndpoint

Name Description Value
failoverPolicy Yük devretme grubu için okuma-yazma uç noktasının yük devretme ilkesi. FailoverPolicy Otomatik ise failoverWithDataLossGracePeriodMinutes gereklidir. 'Automatic'
'Manuel' (gerekli)
failoverWithDataLossGracePeriodMinutes Okuma-yazma uç noktası için veri kaybıyla yük devretmeden önce yetkisiz kullanım süresi denendi. FailoverPolicy Otomatik ise failoverWithDataLossGracePeriodMinutes gereklidir. int

FailoverGroupTags

Name Description Value

PartnerInfo

Name Description Value
id İş ortağı sunucusunun kaynak tanımlayıcısı. dize (gerekli)

ARM şablonu kaynak tanımı

Sunucular/failoverGroups kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

Kullanım Örnekleri

Kaynak biçimi

Bir Microsoft yaratmak için. Sql/servers/failoverGroups kaynağı için aşağıdaki JSON'u şablonunuza ekleyin.

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

Özellik Değerleri

Microsoft. Sql/servers/failoverGroups

Name Description Value
apiVersion API sürümü '2025-02-01-önizleme'
name Kaynak adı dize (gerekli)
properties Kaynak özellikleri. FailoverGroupProperties
tags Kaynak etiketleri Etiket adları ve değerleri sözlüğü. Bkz. şablonlardaki Etiketleri
type Kaynak türü 'Microsoft. Sql/servers/failoverGroups'

FailoverGroupProperties

Name Description Value
databases Yük devretme grubundaki veritabanlarının listesi. string[]
partnerServers Yük devretme grubu için iş ortağı sunucu bilgilerinin listesi. PartnerInfo[] (gerekli)
readOnlyEndpoint Yük devretme grubu örneğinin salt okunur uç noktası. FailoverGroupReadOnlyEndpoint
readWriteEndpoint Yük devretme grubu örneğinin okuma-yazma uç noktası. FailoverGroupReadWriteEndpoint (gerekli)
secondaryType İş ortağı sunucusunda veritabanları ikincil türü. 'Geo'
'Standby'

FailoverGroupReadOnlyEndpoint

Name Description Value
failoverPolicy Yük devretme grubu için salt okunur uç noktanın yük devretme ilkesi. 'Disabled'
'Enabled'
targetServer Salt okunur uç noktanın işaret ettiği hedef iş ortağı sunucusu. string

FailoverGroupReadWriteEndpoint

Name Description Value
failoverPolicy Yük devretme grubu için okuma-yazma uç noktasının yük devretme ilkesi. FailoverPolicy Otomatik ise failoverWithDataLossGracePeriodMinutes gereklidir. 'Automatic'
'Manuel' (gerekli)
failoverWithDataLossGracePeriodMinutes Okuma-yazma uç noktası için veri kaybıyla yük devretmeden önce yetkisiz kullanım süresi denendi. FailoverPolicy Otomatik ise failoverWithDataLossGracePeriodMinutes gereklidir. int

FailoverGroupTags

Name Description Value

PartnerInfo

Name Description Value
id İş ortağı sunucusunun kaynak tanımlayıcısı. dize (gerekli)

Terraform (AzAPI sağlayıcısı) kaynak tanımı

Sunucular/failoverGroups kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

Kullanım Örnekleri

Terraform Örnekleri

Microsoft Azure SQL Failover Group'un dağıtılmasına temel bir örnek.

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
      }
    }
  }
}

Kaynak biçimi

Bir Microsoft yaratmak için. Sql/servers/failoverGroups kaynağı için aşağıdaki Terraform'u şablonunuza ekleyin.

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

Özellik Değerleri

Microsoft. Sql/servers/failoverGroups

Name Description Value
name Kaynak adı dize (gerekli)
parent_id Bu kaynağın üst öğesi olan kaynağın kimliği. Tür kaynağı kimliği: sunucuları
properties Kaynak özellikleri. FailoverGroupProperties
tags Kaynak etiketleri Etiket adları ve değerleri sözlüğü.
type Kaynak türü "Microsoft. Sql/servers/failoverGroups@2025-02-01-preview"

FailoverGroupProperties

Name Description Value
databases Yük devretme grubundaki veritabanlarının listesi. string[]
partnerServers Yük devretme grubu için iş ortağı sunucu bilgilerinin listesi. PartnerInfo[] (gerekli)
readOnlyEndpoint Yük devretme grubu örneğinin salt okunur uç noktası. FailoverGroupReadOnlyEndpoint
readWriteEndpoint Yük devretme grubu örneğinin okuma-yazma uç noktası. FailoverGroupReadWriteEndpoint (gerekli)
secondaryType İş ortağı sunucusunda veritabanları ikincil türü. 'Geo'
'Standby'

FailoverGroupReadOnlyEndpoint

Name Description Value
failoverPolicy Yük devretme grubu için salt okunur uç noktanın yük devretme ilkesi. 'Disabled'
'Enabled'
targetServer Salt okunur uç noktanın işaret ettiği hedef iş ortağı sunucusu. string

FailoverGroupReadWriteEndpoint

Name Description Value
failoverPolicy Yük devretme grubu için okuma-yazma uç noktasının yük devretme ilkesi. FailoverPolicy Otomatik ise failoverWithDataLossGracePeriodMinutes gereklidir. 'Automatic'
'Manuel' (gerekli)
failoverWithDataLossGracePeriodMinutes Okuma-yazma uç noktası için veri kaybıyla yük devretmeden önce yetkisiz kullanım süresi denendi. FailoverPolicy Otomatik ise failoverWithDataLossGracePeriodMinutes gereklidir. int

FailoverGroupTags

Name Description Value

PartnerInfo

Name Description Value
id İş ortağı sunucusunun kaynak tanımlayıcısı. dize (gerekli)