Partilhar via

Servidores Microsoft.Sql/failoverGroups

Definição de recursos do bíceps

O tipo de recurso servers/failoverGroups pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.Sql/servers/failoverGroups, adicione o seguinte Bicep ao seu modelo.

resource symbolicname 'Microsoft.Sql/servers/failoverGroups@2024-11-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'
  }
}

Valores de propriedade

Microsoft.Sql/servers/failoverGroups

Name Description Value
name O nome do recurso string (obrigatório)
elemento principal No Bicep, você pode especificar o recurso pai para um recurso filho. Você só precisa adicionar essa propriedade quando o recurso filho é declarado fora do recurso pai.

Para obter mais informações, consulte recurso filho fora do recurso pai.		 Nome simbólico para recurso do tipo: servidores
properties Propriedades do recurso. FailoverGroupProperties
tags Etiquetas de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos

FailoverGroupProperties

Name Description Value
databases Lista de bancos de dados no grupo de failover. string[]
partnerServers Lista de informações do servidor parceiro para o grupo de failover. PartnerInfo[] (obrigatório)
readOnlyEndpoint Ponto de extremidade somente leitura da instância do grupo de failover. FailoverGroupReadOnlyEndpoint
readWriteEndpoint Ponto de extremidade de leitura-gravação da instância do grupo de failover. FailoverGroupReadWriteEndpoint (obrigatório)
secondaryType Tipo secundário de bancos de dados no servidor parceiro. 'Geo'
'Standby'

FailoverGroupReadOnlyEndpoint

Name Description Value
failoverPolicy Política de failover do ponto de extremidade somente leitura para o grupo de failover. 'Disabled'
'Enabled'
targetServer O servidor de parceiro de destino para o qual o ponto de extremidade somente leitura aponta. cadeia (de caracteres)

FailoverGroupReadWriteEndpoint

Name Description Value
failoverPolicy Política de failover do ponto de extremidade de leitura-gravação para o grupo de failover. Se failoverPolicy for Automatic então failoverWithDataLossGracePeriodMinutes será necessário. 'Automatic'
'Manual' (obrigatório)
failoverWithDataLossGracePeriodMinutes O período de carência antes do failover com perda de dados é tentado para o ponto de extremidade de leitura-gravação. Se failoverPolicy for Automatic então failoverWithDataLossGracePeriodMinutes será necessário. int

FailoverGroupTags

Name Description Value

PartnerInfo

Name Description Value
id Identificador de recurso do servidor parceiro. string (obrigatório)

Definição de recurso de modelo ARM

O tipo de recurso servers/failoverGroups pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.Sql/servers/failoverGroups, adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.Sql/servers/failoverGroups",
  "apiVersion": "2024-11-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"
  }
}

Valores de propriedade

Microsoft.Sql/servers/failoverGroups

Name Description Value
apiVersion A versão api '2024-11-01-preview'
name O nome do recurso string (obrigatório)
properties Propriedades do recurso. FailoverGroupProperties
tags Etiquetas de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos
tipo O tipo de recurso 'Microsoft.Sql/servers/failoverGroups'

FailoverGroupProperties

Name Description Value
databases Lista de bancos de dados no grupo de failover. string[]
partnerServers Lista de informações do servidor parceiro para o grupo de failover. PartnerInfo[] (obrigatório)
readOnlyEndpoint Ponto de extremidade somente leitura da instância do grupo de failover. FailoverGroupReadOnlyEndpoint
readWriteEndpoint Ponto de extremidade de leitura-gravação da instância do grupo de failover. FailoverGroupReadWriteEndpoint (obrigatório)
secondaryType Tipo secundário de bancos de dados no servidor parceiro. 'Geo'
'Standby'

FailoverGroupReadOnlyEndpoint

Name Description Value
failoverPolicy Política de failover do ponto de extremidade somente leitura para o grupo de failover. 'Disabled'
'Enabled'
targetServer O servidor de parceiro de destino para o qual o ponto de extremidade somente leitura aponta. cadeia (de caracteres)

FailoverGroupReadWriteEndpoint

Name Description Value
failoverPolicy Política de failover do ponto de extremidade de leitura-gravação para o grupo de failover. Se failoverPolicy for Automatic então failoverWithDataLossGracePeriodMinutes será necessário. 'Automatic'
'Manual' (obrigatório)
failoverWithDataLossGracePeriodMinutes O período de carência antes do failover com perda de dados é tentado para o ponto de extremidade de leitura-gravação. Se failoverPolicy for Automatic então failoverWithDataLossGracePeriodMinutes será necessário. int

FailoverGroupTags

Name Description Value

PartnerInfo

Name Description Value
id Identificador de recurso do servidor parceiro. string (obrigatório)

Exemplos de uso

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso servers/failoverGroups pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.Sql/servers/failoverGroups, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/servers/failoverGroups@2024-11-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"
    }
  }
}

Valores de propriedade

Microsoft.Sql/servers/failoverGroups

Name Description Value
name O nome do recurso string (obrigatório)
parent_id A ID do recurso que é o pai para este recurso. ID para recurso do tipo: servidores
properties Propriedades do recurso. FailoverGroupProperties
tags Etiquetas de recursos Dicionário de nomes e valores de tags.
tipo O tipo de recurso "Microsoft.Sql/servers/failoverGroups@2024-11-01-preview"

FailoverGroupProperties

Name Description Value
databases Lista de bancos de dados no grupo de failover. string[]
partnerServers Lista de informações do servidor parceiro para o grupo de failover. PartnerInfo[] (obrigatório)
readOnlyEndpoint Ponto de extremidade somente leitura da instância do grupo de failover. FailoverGroupReadOnlyEndpoint
readWriteEndpoint Ponto de extremidade de leitura-gravação da instância do grupo de failover. FailoverGroupReadWriteEndpoint (obrigatório)
secondaryType Tipo secundário de bancos de dados no servidor parceiro. 'Geo'
'Standby'

FailoverGroupReadOnlyEndpoint

Name Description Value
failoverPolicy Política de failover do ponto de extremidade somente leitura para o grupo de failover. 'Disabled'
'Enabled'
targetServer O servidor de parceiro de destino para o qual o ponto de extremidade somente leitura aponta. cadeia (de caracteres)

FailoverGroupReadWriteEndpoint

Name Description Value
failoverPolicy Política de failover do ponto de extremidade de leitura-gravação para o grupo de failover. Se failoverPolicy for Automatic então failoverWithDataLossGracePeriodMinutes será necessário. 'Automatic'
'Manual' (obrigatório)
failoverWithDataLossGracePeriodMinutes O período de carência antes do failover com perda de dados é tentado para o ponto de extremidade de leitura-gravação. Se failoverPolicy for Automatic então failoverWithDataLossGracePeriodMinutes será necessário. int

FailoverGroupTags

Name Description Value

PartnerInfo

Name Description Value
id Identificador de recurso do servidor parceiro. string (obrigatório)

Exemplos de uso

Amostras Terraform

Um exemplo básico de implantação do Grupo de Failover do SQL do Microsoft Azure.

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
      }
    }
  }
}
  • Last updated on