Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
- Latest
- 2025-02-01-preview
- 2025-01-01
- 2024-11-01-preview
- 2024-05-01-preview
- 2023-08-01
- 2023-08-01-preview
- 2023-05-01-preview
- 2023-02-01-preview
- 2022-11-01-preview
- 2022-08-01-preview
- 2022-05-01-preview
- 2022-02-01-preview
- 2021-11-01
- 2021-11-01-preview
- 2021-08-01-preview
- 2021-05-01-preview
- 2021-02-01-preview
- 2020-11-01-preview
- 2020-08-01-preview
- 2020-02-02-preview
- 2015-05-01-preview
Definición de recurso Bicep
El tipo de recurso servers/failoverGroups se puede implementar con operaciones destinadas a:
- grupos de recursos: consulte comandos de implementación de grupos de recursos
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Ejemplos de uso
Muestras de Bicep
Un ejemplo básico de cómo desplegar 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
}
}
Formato de recurso
Para crear un Microsoft. Recurso Sql/servers/FailoverGroups, añade el siguiente Bicep a tu plantilla.
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'
}
}
Valores de propiedad
Microsoft. Sql/servidores/Grupos de conmutación por error
| Name | Description | Value |
|---|---|---|
| name | El nombre del recurso | string (obligatorio) |
| parent | En Bicep, puedes especificar el recurso padre para un recurso hijo. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario. Para obtener más información, consulte recurso secundario fuera del recurso primario. |
Nombre simbólico del recurso de tipo: servidores |
| properties | Propiedades de recursos. | FailoverGroupProperties |
| tags | Etiquetas de recursos | Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas |
FailoverGroupProperties
| Name | Description | Value |
|---|---|---|
| databases | Lista de bases de datos del grupo de conmutación por error. | string[] |
| partnerServers | Lista de información del servidor asociado para el grupo de conmutación por error. | PartnerInfo[] (obligatorio) |
| readOnlyEndpoint | Punto de conexión de solo lectura de la instancia del grupo de conmutación por error. | FailoverGroupReadOnlyEndpoint |
| readWriteEndpoint | Punto de conexión de lectura y escritura de la instancia del grupo de conmutación por error. | FailoverGroupReadWriteEndpoint (obligatorio) |
| secondaryType | Tipo secundario de bases de datos en el servidor asociado. | 'Geo' 'Standby' |
FailoverGroupReadOnlyEndpoint
| Name | Description | Value |
|---|---|---|
| failoverPolicy | Directiva de conmutación por error del punto de conexión de solo lectura para el grupo de conmutación por error. | 'Disabled' 'Enabled' |
| targetServer | Servidor asociado de destino al que apunta el punto de conexión de solo lectura. | string |
FailoverGroupReadWriteEndpoint
| Name | Description | Value |
|---|---|---|
| failoverPolicy | Directiva de conmutación por error del punto de conexión de lectura y escritura para el grupo de conmutación por error. Si failoverPolicy es Automático, se requiere conmutación por errorWithDataLossGracePeriodMinutes. | 'Automatic' 'Manual' (obligatorio) |
| failoverWithDataLossGracePeriodMinutes | Período de gracia antes de la conmutación por error con pérdida de datos se intenta para el punto de conexión de lectura y escritura. Si failoverPolicy es Automático, se requiere conmutación por errorWithDataLossGracePeriodMinutes. | int |
FailoverGroupTags
| Name | Description | Value |
|---|
PartnerInfo
| Name | Description | Value |
|---|---|---|
| id | Identificador de recursos del servidor asociado. | string (obligatorio) |
Definición de recursos de plantilla de ARM
El tipo de recurso servers/failoverGroups se puede implementar con operaciones destinadas a:
- Grupos de recursos - Véase comandos de despliegue de grupos de recursos Para una lista de propiedades modificadas en cada versión de la API, consulte registro de cambios.
Ejemplos de uso
Formato de recurso
Para crear un Microsoft. Recurso Sql/servers/FailoverGroups, añade el siguiente JSON a tu plantilla.
{
"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"
}
}
Valores de propiedad
Microsoft. Sql/servidores/Grupos de conmutación por error
| Name | Description | Value |
|---|---|---|
| apiVersion | La versión de api | '2025-02-01-preestreno' |
| name | El nombre del recurso | string (obligatorio) |
| properties | Propiedades de recursos. | FailoverGroupProperties |
| tags | Etiquetas de recursos | Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas |
| type | El tipo de recurso | 'Microsoft. Sql/servidores/Grupos de failover' |
FailoverGroupProperties
| Name | Description | Value |
|---|---|---|
| databases | Lista de bases de datos del grupo de conmutación por error. | string[] |
| partnerServers | Lista de información del servidor asociado para el grupo de conmutación por error. | PartnerInfo[] (obligatorio) |
| readOnlyEndpoint | Punto de conexión de solo lectura de la instancia del grupo de conmutación por error. | FailoverGroupReadOnlyEndpoint |
| readWriteEndpoint | Punto de conexión de lectura y escritura de la instancia del grupo de conmutación por error. | FailoverGroupReadWriteEndpoint (obligatorio) |
| secondaryType | Tipo secundario de bases de datos en el servidor asociado. | 'Geo' 'Standby' |
FailoverGroupReadOnlyEndpoint
| Name | Description | Value |
|---|---|---|
| failoverPolicy | Directiva de conmutación por error del punto de conexión de solo lectura para el grupo de conmutación por error. | 'Disabled' 'Enabled' |
| targetServer | Servidor asociado de destino al que apunta el punto de conexión de solo lectura. | string |
FailoverGroupReadWriteEndpoint
| Name | Description | Value |
|---|---|---|
| failoverPolicy | Directiva de conmutación por error del punto de conexión de lectura y escritura para el grupo de conmutación por error. Si failoverPolicy es Automático, se requiere conmutación por errorWithDataLossGracePeriodMinutes. | 'Automatic' 'Manual' (obligatorio) |
| failoverWithDataLossGracePeriodMinutes | Período de gracia antes de la conmutación por error con pérdida de datos se intenta para el punto de conexión de lectura y escritura. Si failoverPolicy es Automático, se requiere conmutación por errorWithDataLossGracePeriodMinutes. | int |
FailoverGroupTags
| Name | Description | Value |
|---|
PartnerInfo
| Name | Description | Value |
|---|---|---|
| id | Identificador de recursos del servidor asociado. | string (obligatorio) |
Definición de recursos de Terraform (proveedor AzAPI)
El tipo de recurso servers/failoverGroups se puede implementar con operaciones destinadas a:
- Grupos de recursos Para una lista de propiedades modificadas en cada versión de la API, consulte registro de cambios.
Ejemplos de uso
Ejemplos de Terraform
Un ejemplo básico de cómo desplegar 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
}
}
}
}
Formato de recurso
Para crear un Microsoft. Recurso SQL/servers/FailoverGroups, añade la siguiente Terraform a tu plantilla.
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"
}
}
}
Valores de propiedad
Microsoft. Sql/servidores/Grupos de conmutación por error
| Name | Description | Value |
|---|---|---|
| name | El nombre del recurso | string (obligatorio) |
| parent_id | Identificador del recurso que es el elemento primario de este recurso. | Identificador del recurso de tipo: servidores |
| properties | Propiedades de recursos. | FailoverGroupProperties |
| tags | Etiquetas de recursos | Diccionario de nombres y valores de etiqueta. |
| type | El tipo de recurso | "Microsoft. Sql/servers/failoverGroups@2025-02-01-preview" |
FailoverGroupProperties
| Name | Description | Value |
|---|---|---|
| databases | Lista de bases de datos del grupo de conmutación por error. | string[] |
| partnerServers | Lista de información del servidor asociado para el grupo de conmutación por error. | PartnerInfo[] (obligatorio) |
| readOnlyEndpoint | Punto de conexión de solo lectura de la instancia del grupo de conmutación por error. | FailoverGroupReadOnlyEndpoint |
| readWriteEndpoint | Punto de conexión de lectura y escritura de la instancia del grupo de conmutación por error. | FailoverGroupReadWriteEndpoint (obligatorio) |
| secondaryType | Tipo secundario de bases de datos en el servidor asociado. | 'Geo' 'Standby' |
FailoverGroupReadOnlyEndpoint
| Name | Description | Value |
|---|---|---|
| failoverPolicy | Directiva de conmutación por error del punto de conexión de solo lectura para el grupo de conmutación por error. | 'Disabled' 'Enabled' |
| targetServer | Servidor asociado de destino al que apunta el punto de conexión de solo lectura. | string |
FailoverGroupReadWriteEndpoint
| Name | Description | Value |
|---|---|---|
| failoverPolicy | Directiva de conmutación por error del punto de conexión de lectura y escritura para el grupo de conmutación por error. Si failoverPolicy es Automático, se requiere conmutación por errorWithDataLossGracePeriodMinutes. | 'Automatic' 'Manual' (obligatorio) |
| failoverWithDataLossGracePeriodMinutes | Período de gracia antes de la conmutación por error con pérdida de datos se intenta para el punto de conexión de lectura y escritura. Si failoverPolicy es Automático, se requiere conmutación por errorWithDataLossGracePeriodMinutes. | int |
FailoverGroupTags
| Name | Description | Value |
|---|
PartnerInfo
| Name | Description | Value |
|---|---|---|
| id | Identificador de recursos del servidor asociado. | string (obligatorio) |