Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
- najnowsze
- 2026-08-01-preview
- 2025-08-01-preview
- 2025-02-01-podgląd
- 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-podgląd
- 2022-11-01-podgląd
- 2022-08-01-podgląd
- 2022-05-01-podgląd
- 2022-02-01-podgląd
- 2021-11-01
- 2021-11-01-podgląd
- 2021-08-01-podgląd
- 2021-05-01-preview
- 2021-02-01-preview
- 2020-11-01-preview
- 2020-08-01-preview
- 2020-02-02-preview
- 2015-05-01-podgląd
Definicja zasobu Bicepsa
Typ zasobu serwery/grupy trybu failover można wdrożyć przy użyciu operacji docelowych:
- Resource groups - Zobacz resource group deployment commands
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.
Przykłady użycia
Próbki Bicepsa
Podstawowy przykład wdrażania 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
}
}
Moduły zweryfikowane na platformie Azure
Następujące moduły zweryfikowane platformy Azure mogą służyć do wdrażania tego typu zasobu.
| Module | Opis |
|---|---|
| Azure SQL Server - Grupa Failover | AVM Child Module for Azure SQL Server - Failover Group |
Format zasobu
By stworzyć Microsoft. Zasoby SQL/serwery/failoverGroups, dodaj następujący Bicep do swojego szablonu.
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'
}
}
Wartości właściwości
Microsoft. Sql/serwery/grupy failoverGroups
| Nazwa | Opis | Wartość |
|---|---|---|
| nazwa | Nazwa zasobu | ciąg (wymagany) |
| nadrzędny | W Bicep możesz określić zasób nadrzędny dla zasobu potomnego. Tę właściwość należy dodać tylko wtedy, gdy zasób podrzędny jest zadeklarowany poza zasobem nadrzędnym. Więcej informacji można znaleźć w Child resource outside parent resource. |
Nazwa symboliczna zasobu typu: serwery |
| properties | Właściwości zasobu. | FailoverGroupProperties |
| tags | Tagi zasobów | Słownik nazw tagów i wartości. Zobacz tagi w szablonach |
FailoverGroupProperties
| Nazwa | Opis | Wartość |
|---|---|---|
| Baz danych | Lista baz danych w grupie trybu failover. | string[] |
| partnerServers | Lista informacji o serwerze partnerskim dla grupy trybu failover. | PartnerInfo[] (wymagane) |
| readOnlyEndpoint | Punkt końcowy grupy trybu failover tylko do odczytu. | FailoverGroupReadOnlyEndpoint |
| readWriteEndpoint | Punkt końcowy odczytu i zapisu wystąpienia grupy trybu failover. | FailoverGroupReadWriteEndpoint (wymagane) |
| secondaryType | Typ pomocniczy baz danych na serwerze partnerskim. | 'Geo' 'Standby' |
FailoverGroupReadOnlyEndpoint
| Nazwa | Opis | Wartość |
|---|---|---|
| failoverPolicy | Zasady trybu failover punktu końcowego tylko do odczytu dla grupy trybu failover. | 'Disabled' 'Enabled' |
| targetServer | Docelowy serwer partnera, na którym wskazuje punkt końcowy tylko do odczytu. | ciąg |
FailoverGroupReadWriteEndpoint
| Nazwa | Opis | Wartość |
|---|---|---|
| failoverPolicy | Zasady trybu failover punktu końcowego odczytu i zapisu dla grupy trybu failover. Jeśli tryb failoverPolicy jest automatyczny, wymagany jest tryb failoverWithDataLossGracePeriodMinutes. | 'Automatic' "Ręczne" (wymagane) |
| failoverWithDataLossGracePeriodMinutes | Okres prolongaty przed próbą przejścia w tryb failover z utratą danych dla punktu końcowego odczytu i zapisu. Jeśli tryb failoverPolicy jest automatyczny, wymagany jest tryb failoverWithDataLossGracePeriodMinutes. | int |
FailoverGroupTags
| Nazwa | Opis | Wartość |
|---|
Informacje o partnerze
| Nazwa | Opis | Wartość |
|---|---|---|
| id | Identyfikator zasobu serwera partnerskiego. | ciąg (wymagany) |
Definicja zasobu szablonu usługi ARM
Typ zasobu serwery/grupy trybu failover można wdrożyć przy użyciu operacji docelowych:
- Grupy zasobów – Zobacz polecenia wdrożenia grup zasobów Aby uzyskać listę zmienionych właściwości w każdej wersji API, zobacz log zmian.
Przykłady użycia
Format zasobu
By stworzyć Microsoft. Zasoby SQL/serwery/failoverGroups, dodaj do szablonu następujący JSON.
{
"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"
}
}
Wartości właściwości
Microsoft. Sql/serwery/grupy failoverGroups
| Nazwa | Opis | Wartość |
|---|---|---|
| apiVersion | Wersja interfejsu API | "2025-02-01-preview" |
| nazwa | Nazwa zasobu | ciąg (wymagany) |
| properties | Właściwości zasobu. | FailoverGroupProperties |
| tags | Tagi zasobów | Słownik nazw tagów i wartości. Zobacz tagi w szablonach |
| typ | Typ zasobu | 'Microsoft. Sql/serwery/failoverGroups' |
FailoverGroupProperties
| Nazwa | Opis | Wartość |
|---|---|---|
| Baz danych | Lista baz danych w grupie trybu failover. | string[] |
| partnerServers | Lista informacji o serwerze partnerskim dla grupy trybu failover. | PartnerInfo[] (wymagane) |
| readOnlyEndpoint | Punkt końcowy grupy trybu failover tylko do odczytu. | FailoverGroupReadOnlyEndpoint |
| readWriteEndpoint | Punkt końcowy odczytu i zapisu wystąpienia grupy trybu failover. | FailoverGroupReadWriteEndpoint (wymagane) |
| secondaryType | Typ pomocniczy baz danych na serwerze partnerskim. | 'Geo' 'Standby' |
FailoverGroupReadOnlyEndpoint
| Nazwa | Opis | Wartość |
|---|---|---|
| failoverPolicy | Zasady trybu failover punktu końcowego tylko do odczytu dla grupy trybu failover. | 'Disabled' 'Enabled' |
| targetServer | Docelowy serwer partnera, na którym wskazuje punkt końcowy tylko do odczytu. | ciąg |
FailoverGroupReadWriteEndpoint
| Nazwa | Opis | Wartość |
|---|---|---|
| failoverPolicy | Zasady trybu failover punktu końcowego odczytu i zapisu dla grupy trybu failover. Jeśli tryb failoverPolicy jest automatyczny, wymagany jest tryb failoverWithDataLossGracePeriodMinutes. | 'Automatic' "Ręczne" (wymagane) |
| failoverWithDataLossGracePeriodMinutes | Okres prolongaty przed próbą przejścia w tryb failover z utratą danych dla punktu końcowego odczytu i zapisu. Jeśli tryb failoverPolicy jest automatyczny, wymagany jest tryb failoverWithDataLossGracePeriodMinutes. | int |
FailoverGroupTags
| Nazwa | Opis | Wartość |
|---|
Informacje o partnerze
| Nazwa | Opis | Wartość |
|---|---|---|
| id | Identyfikator zasobu serwera partnerskiego. | ciąg (wymagany) |
Definicja zasobu narzędzia Terraform (dostawcy AzAPI)
Typ zasobu serwery/grupy trybu failover można wdrożyć przy użyciu operacji docelowych:
- Grupy zasobów Listę zmienionych właściwości w każdej wersji API można znaleźć w dzienniku zmian.
Przykłady użycia
Przykłady programu Terraform
Podstawowy przykład wdrażania 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
}
}
}
}
Format zasobu
By stworzyć Microsoft. Zasoby sql/serwery/failoverGroups, dodaj następujący Terraform do swojego szablonu.
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"
}
}
}
Wartości właściwości
Microsoft. Sql/serwery/grupy failoverGroups
| Nazwa | Opis | Wartość |
|---|---|---|
| nazwa | Nazwa zasobu | ciąg (wymagany) |
| parent_id | Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu. | Identyfikator zasobu typu: serwerów |
| properties | Właściwości zasobu. | FailoverGroupProperties |
| tags | Tagi zasobów | Słownik nazw tagów i wartości. |
| typ | Typ zasobu | "Microsoft. Sql/servers/failoverGroups@2025-02-01-preview" |
FailoverGroupProperties
| Nazwa | Opis | Wartość |
|---|---|---|
| Baz danych | Lista baz danych w grupie trybu failover. | string[] |
| partnerServers | Lista informacji o serwerze partnerskim dla grupy trybu failover. | PartnerInfo[] (wymagane) |
| readOnlyEndpoint | Punkt końcowy grupy trybu failover tylko do odczytu. | FailoverGroupReadOnlyEndpoint |
| readWriteEndpoint | Punkt końcowy odczytu i zapisu wystąpienia grupy trybu failover. | FailoverGroupReadWriteEndpoint (wymagane) |
| secondaryType | Typ pomocniczy baz danych na serwerze partnerskim. | 'Geo' 'Standby' |
FailoverGroupReadOnlyEndpoint
| Nazwa | Opis | Wartość |
|---|---|---|
| failoverPolicy | Zasady trybu failover punktu końcowego tylko do odczytu dla grupy trybu failover. | 'Disabled' 'Enabled' |
| targetServer | Docelowy serwer partnera, na którym wskazuje punkt końcowy tylko do odczytu. | ciąg |
FailoverGroupReadWriteEndpoint
| Nazwa | Opis | Wartość |
|---|---|---|
| failoverPolicy | Zasady trybu failover punktu końcowego odczytu i zapisu dla grupy trybu failover. Jeśli tryb failoverPolicy jest automatyczny, wymagany jest tryb failoverWithDataLossGracePeriodMinutes. | 'Automatic' "Ręczne" (wymagane) |
| failoverWithDataLossGracePeriodMinutes | Okres prolongaty przed próbą przejścia w tryb failover z utratą danych dla punktu końcowego odczytu i zapisu. Jeśli tryb failoverPolicy jest automatyczny, wymagany jest tryb failoverWithDataLossGracePeriodMinutes. | int |
FailoverGroupTags
| Nazwa | Opis | Wartość |
|---|
Informacje o partnerze
| Nazwa | Opis | Wartość |
|---|---|---|
| id | Identyfikator zasobu serwera partnerskiego. | ciąg (wymagany) |