Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
- 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
Bicep-Ressourcendefinition
Der Ressourcentyp "Servers/failoverGroups" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
- Ressourcengruppen – Siehe Ressourcengruppenbereitstellungsbefehle
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um ein Microsoft zu schaffen. SQL/servers/failoverGroups, füge den folgenden Bicep deiner Vorlage hinzu.
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'
}
}
Eigenschaftswerte
Microsoft. SQL/servers/failoverGroups
| Name | Description | Value |
|---|---|---|
| name | Der Ressourcenname | Zeichenfolge (erforderlich) |
| parent | In Bicep kann man die Elternressource für eine Kindressource angeben. Sie müssen diese Eigenschaft nur hinzufügen, wenn die untergeordnete Ressource außerhalb der übergeordneten Ressource deklariert wird. Weitere Informationen finden Sie unter Untergeordnete Ressource außerhalb der übergeordneten Ressource. |
Symbolischer Name für Ressource vom Typ: Server |
| properties | Ressourceneigenschaften. | FailoverGroupProperties |
| tags | Ressourcenetiketten | Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen |
FailoverGroupProperties
| Name | Description | Value |
|---|---|---|
| databases | Liste der Datenbanken in der Failovergruppe. | string[] |
| partnerServers | Liste der Partnerserverinformationen für die Failovergruppe. | PartnerInfo[] (erforderlich) |
| readOnlyEndpoint | Schreibgeschützter Endpunkt der Failovergruppeninstanz. | FailoverGroupReadOnlyEndpoint |
| readWriteEndpoint | Lese-/Schreibzugriffsendpunkt der Failovergruppeninstanz. | FailoverGroupReadWriteEndpoint (erforderlich) |
| secondaryType | Sekundärer Datenbanktyp auf Partnerserver. | 'Geo' 'Standby' |
FailoverGroupReadOnlyEndpoint
| Name | Description | Value |
|---|---|---|
| failoverPolicy | Failoverrichtlinie des schreibgeschützten Endpunkts für die Failovergruppe. | 'Disabled' 'Enabled' |
| targetServer | Der Zielpartnerserver, auf den der schreibgeschützte Endpunkt verweist. | string |
FailoverGroupReadWriteEndpoint
| Name | Description | Value |
|---|---|---|
| failoverPolicy | Failoverrichtlinie des Lese-/Schreibzugriffsendpunkts für die Failovergruppe. Wenn failoverPolicy automatisch ist, ist failoverWithDataLossGracePeriodMinutes erforderlich. | 'Automatic' 'Manuell' (erforderlich) |
| failoverWithDataLossGracePeriodMinutes | Die Karenzzeit vor dem Failover mit Datenverlust wird für den Endpunkt mit Lese-/Schreibzugriff versucht. Wenn failoverPolicy automatisch ist, ist failoverWithDataLossGracePeriodMinutes erforderlich. | int |
FailoverGroupTags
| Name | Description | Value |
|---|
PartnerInfo
| Name | Description | Value |
|---|---|---|
| id | Ressourcenbezeichner des Partnerservers. | Zeichenfolge (erforderlich) |
Verwendungsbeispiele
Bicep-Proben
Ein grundlegendes Beispiel für die Bereitstellung der 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: null
minimalTlsVersion: '1.2'
publicNetworkAccess: 'Enabled'
restrictOutboundNetworkAccess: 'Disabled'
version: '12.0'
}
}
resource server1 'Microsoft.Sql/servers@2023-08-01-preview' = {
name: '${resourceName}-secondary'
properties: {
administratorLogin: 'mradministrator'
administratorLoginPassword: null
minimalTlsVersion: '1.2'
publicNetworkAccess: 'Enabled'
restrictOutboundNetworkAccess: 'Disabled'
version: '12.0'
}
}
resource database 'Microsoft.Sql/servers/databases@2023-08-01-preview' = {
parent: server
name: '${resourceName}-db'
location: location
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 failoverGroup 'Microsoft.Sql/servers/failoverGroups@2023-08-01-preview' = {
parent: server
name: '${resourceName}-fg'
properties: {
databases: [
database.id
]
partnerServers: [
{
id: server1.id
}
]
readOnlyEndpoint: {
failoverPolicy: 'Disabled'
}
readWriteEndpoint: {
failoverPolicy: 'Automatic'
failoverWithDataLossGracePeriodMinutes: 60
}
}
}
ARM-Vorlagenressourcendefinition
Der Ressourcentyp "Servers/failoverGroups" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
- Ressourcengruppen – Siehe Ressourcengruppenbereitstellungsbefehle
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um ein Microsoft zu schaffen. SQL/server/failoverGroups-Resource, fügen Sie das folgende JSON zu Ihrer Vorlage hinzu.
{
"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"
}
}
Eigenschaftswerte
Microsoft. SQL/servers/failoverGroups
| Name | Description | Value |
|---|---|---|
| apiVersion | Die API-Version | "2025-02-01-preview" |
| name | Der Ressourcenname | Zeichenfolge (erforderlich) |
| properties | Ressourceneigenschaften. | FailoverGroupProperties |
| tags | Ressourcenetiketten | Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen |
| type | Der Ressourcentyp | 'Microsoft. SQL/servers/failoverGroups' |
FailoverGroupProperties
| Name | Description | Value |
|---|---|---|
| databases | Liste der Datenbanken in der Failovergruppe. | string[] |
| partnerServers | Liste der Partnerserverinformationen für die Failovergruppe. | PartnerInfo[] (erforderlich) |
| readOnlyEndpoint | Schreibgeschützter Endpunkt der Failovergruppeninstanz. | FailoverGroupReadOnlyEndpoint |
| readWriteEndpoint | Lese-/Schreibzugriffsendpunkt der Failovergruppeninstanz. | FailoverGroupReadWriteEndpoint (erforderlich) |
| secondaryType | Sekundärer Datenbanktyp auf Partnerserver. | 'Geo' 'Standby' |
FailoverGroupReadOnlyEndpoint
| Name | Description | Value |
|---|---|---|
| failoverPolicy | Failoverrichtlinie des schreibgeschützten Endpunkts für die Failovergruppe. | 'Disabled' 'Enabled' |
| targetServer | Der Zielpartnerserver, auf den der schreibgeschützte Endpunkt verweist. | string |
FailoverGroupReadWriteEndpoint
| Name | Description | Value |
|---|---|---|
| failoverPolicy | Failoverrichtlinie des Lese-/Schreibzugriffsendpunkts für die Failovergruppe. Wenn failoverPolicy automatisch ist, ist failoverWithDataLossGracePeriodMinutes erforderlich. | 'Automatic' 'Manuell' (erforderlich) |
| failoverWithDataLossGracePeriodMinutes | Die Karenzzeit vor dem Failover mit Datenverlust wird für den Endpunkt mit Lese-/Schreibzugriff versucht. Wenn failoverPolicy automatisch ist, ist failoverWithDataLossGracePeriodMinutes erforderlich. | int |
FailoverGroupTags
| Name | Description | Value |
|---|
PartnerInfo
| Name | Description | Value |
|---|---|---|
| id | Ressourcenbezeichner des Partnerservers. | Zeichenfolge (erforderlich) |
Verwendungsbeispiele
Terraform -Ressourcendefinition (AzAPI-Anbieter)
Der Ressourcentyp "Servers/failoverGroups" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
- Ressourcengruppen
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um ein Microsoft zu schaffen. Sql/server/failoverGroups-Resource, fügen Sie folgendes Terraform Ihrer Vorlage hinzu.
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"
}
}
}
Eigenschaftswerte
Microsoft. SQL/servers/failoverGroups
| Name | Description | Value |
|---|---|---|
| name | Der Ressourcenname | Zeichenfolge (erforderlich) |
| parent_id | Die ID der Ressource, die das übergeordnete Element für diese Ressource ist. | ID für Ressource des Typs: Server |
| properties | Ressourceneigenschaften. | FailoverGroupProperties |
| tags | Ressourcenetiketten | Wörterbuch der Tagnamen und -werte. |
| type | Der Ressourcentyp | "Microsoft. sql/servers/failoverGroups@2025-02-01-preview" |
FailoverGroupProperties
| Name | Description | Value |
|---|---|---|
| databases | Liste der Datenbanken in der Failovergruppe. | string[] |
| partnerServers | Liste der Partnerserverinformationen für die Failovergruppe. | PartnerInfo[] (erforderlich) |
| readOnlyEndpoint | Schreibgeschützter Endpunkt der Failovergruppeninstanz. | FailoverGroupReadOnlyEndpoint |
| readWriteEndpoint | Lese-/Schreibzugriffsendpunkt der Failovergruppeninstanz. | FailoverGroupReadWriteEndpoint (erforderlich) |
| secondaryType | Sekundärer Datenbanktyp auf Partnerserver. | 'Geo' 'Standby' |
FailoverGroupReadOnlyEndpoint
| Name | Description | Value |
|---|---|---|
| failoverPolicy | Failoverrichtlinie des schreibgeschützten Endpunkts für die Failovergruppe. | 'Disabled' 'Enabled' |
| targetServer | Der Zielpartnerserver, auf den der schreibgeschützte Endpunkt verweist. | string |
FailoverGroupReadWriteEndpoint
| Name | Description | Value |
|---|---|---|
| failoverPolicy | Failoverrichtlinie des Lese-/Schreibzugriffsendpunkts für die Failovergruppe. Wenn failoverPolicy automatisch ist, ist failoverWithDataLossGracePeriodMinutes erforderlich. | 'Automatic' 'Manuell' (erforderlich) |
| failoverWithDataLossGracePeriodMinutes | Die Karenzzeit vor dem Failover mit Datenverlust wird für den Endpunkt mit Lese-/Schreibzugriff versucht. Wenn failoverPolicy automatisch ist, ist failoverWithDataLossGracePeriodMinutes erforderlich. | int |
FailoverGroupTags
| Name | Description | Value |
|---|
PartnerInfo
| Name | Description | Value |
|---|---|---|
| id | Ressourcenbezeichner des Partnerservers. | Zeichenfolge (erforderlich) |
Verwendungsbeispiele
Terraform-Beispiele
Ein grundlegendes Beispiel für die Bereitstellung der 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
}
}
}
}