Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
- 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
Definizione della risorsa Bicep
Il tipo di risorsa servers/failoverGroups può essere distribuito con operazioni destinate a:
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.
Esempi di utilizzo
Campioni di Bicep
Un esempio base di distribuzione del 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 risorsa
Per creare un Microsoft. Risorsa Sql/servers/FailoverGroups, aggiungi il seguente Bicep al tuo template.
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'
}
}
Valori delle proprietà
Microsoft. Sql/server/Gruppi di failover
| Name | Description | Value |
|---|---|---|
| name | Nome della risorsa | stringa (obbligatorio) |
| parent | In Bicep, puoi specificare la risorsa genitore per una risorsa figlia. È necessario aggiungere questa proprietà solo quando la risorsa figlio viene dichiarata all'esterno della risorsa padre. Per altre informazioni, vedere risorsa figlio all'esterno della risorsa padre. |
Nome simbolico per la risorsa di tipo: server |
| properties | Proprietà delle risorse. | FailoverGroupProperties |
| tags | Tag delle risorse | Dizionario di nomi e valori di tag. Vedere tag nei modelli |
FailoverGroupProperties
| Name | Description | Value |
|---|---|---|
| databases | Elenco di database nel gruppo di failover. | string[] |
| partnerServers | Elenco delle informazioni sul server partner per il gruppo di failover. | PartnerInfo[] (obbligatorio) |
| readOnlyEndpoint | Endpoint di sola lettura dell'istanza del gruppo di failover. | FailoverGroupReadOnlyEndpoint |
| readWriteEndpoint | Endpoint di lettura/scrittura dell'istanza del gruppo di failover. | FailoverGroupReadWriteEndpoint (obbligatorio) |
| secondaryType | Tipo secondario di database nel server partner. | 'Geo' 'Standby' |
FailoverGroupReadOnlyEndpoint
| Name | Description | Value |
|---|---|---|
| failoverPolicy | Criteri di failover dell'endpoint di sola lettura per il gruppo di failover. | 'Disabled' 'Enabled' |
| targetServer | Server partner di destinazione in cui punta l'endpoint di sola lettura. | string |
FailoverGroupReadWriteEndpoint
| Name | Description | Value |
|---|---|---|
| failoverPolicy | Criteri di failover dell'endpoint di lettura/scrittura per il gruppo di failover. Se failoverPolicy è Automatico, è necessario failoverWithDataLossGracePeriodMinutes. | 'Automatic' 'Manuale' (obbligatorio) |
| failoverWithDataLossGracePeriodMinutes | Periodo di tolleranza prima del tentativo di failover con perdita di dati per l'endpoint di lettura/scrittura. Se failoverPolicy è Automatico, è necessario failoverWithDataLossGracePeriodMinutes. | int |
FailoverGroupTags
| Name | Description | Value |
|---|
PartnerInfo
| Name | Description | Value |
|---|---|---|
| id | Identificatore della risorsa del server partner. | stringa (obbligatorio) |
Definizione di risorsa del modello di Resource Manager
Il tipo di risorsa servers/failoverGroups può essere distribuito con operazioni destinate a:
- Gruppi di risorse - Vedi comandi di distribuzione dei gruppi di risorse Per un elenco delle proprietà modificate in ciascuna versione API, vedi registro delle modifiche.
Esempi di utilizzo
Formato risorsa
Per creare un Microsoft. Risorsa sql/servers/failoverGroups, aggiungi il seguente JSON al tuo template.
{
"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"
}
}
Valori delle proprietà
Microsoft. Sql/server/Gruppi di failover
| Name | Description | Value |
|---|---|---|
| apiVersion | Versione dell'API | '2025-02-01-anteprima' |
| name | Nome della risorsa | stringa (obbligatorio) |
| properties | Proprietà delle risorse. | FailoverGroupProperties |
| tags | Tag delle risorse | Dizionario di nomi e valori di tag. Vedere tag nei modelli |
| type | Tipo di risorsa | 'Microsoft. Sql/server/Gruppi di failover' |
FailoverGroupProperties
| Name | Description | Value |
|---|---|---|
| databases | Elenco di database nel gruppo di failover. | string[] |
| partnerServers | Elenco delle informazioni sul server partner per il gruppo di failover. | PartnerInfo[] (obbligatorio) |
| readOnlyEndpoint | Endpoint di sola lettura dell'istanza del gruppo di failover. | FailoverGroupReadOnlyEndpoint |
| readWriteEndpoint | Endpoint di lettura/scrittura dell'istanza del gruppo di failover. | FailoverGroupReadWriteEndpoint (obbligatorio) |
| secondaryType | Tipo secondario di database nel server partner. | 'Geo' 'Standby' |
FailoverGroupReadOnlyEndpoint
| Name | Description | Value |
|---|---|---|
| failoverPolicy | Criteri di failover dell'endpoint di sola lettura per il gruppo di failover. | 'Disabled' 'Enabled' |
| targetServer | Server partner di destinazione in cui punta l'endpoint di sola lettura. | string |
FailoverGroupReadWriteEndpoint
| Name | Description | Value |
|---|---|---|
| failoverPolicy | Criteri di failover dell'endpoint di lettura/scrittura per il gruppo di failover. Se failoverPolicy è Automatico, è necessario failoverWithDataLossGracePeriodMinutes. | 'Automatic' 'Manuale' (obbligatorio) |
| failoverWithDataLossGracePeriodMinutes | Periodo di tolleranza prima del tentativo di failover con perdita di dati per l'endpoint di lettura/scrittura. Se failoverPolicy è Automatico, è necessario failoverWithDataLossGracePeriodMinutes. | int |
FailoverGroupTags
| Name | Description | Value |
|---|
PartnerInfo
| Name | Description | Value |
|---|---|---|
| id | Identificatore della risorsa del server partner. | stringa (obbligatorio) |
Definizione di risorsa Terraform (provider AzAPI)
Il tipo di risorsa servers/failoverGroups può essere distribuito con operazioni destinate a:
- Gruppi di risorse Per un elenco delle proprietà modificate in ogni versione dell'API, vedi il registro modifiche.
Esempi di utilizzo
Esempi di Terraform
Un esempio base di distribuzione del 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 risorsa
Per creare un Microsoft. Risorsa SQL/servers/FailoverGroups, aggiungi il seguente Terraform al tuo template.
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"
}
}
}
Valori delle proprietà
Microsoft. Sql/server/Gruppi di failover
| Name | Description | Value |
|---|---|---|
| name | Nome della risorsa | stringa (obbligatorio) |
| parent_id | ID della risorsa padre per questa risorsa. | ID per la risorsa di tipo: server |
| properties | Proprietà delle risorse. | FailoverGroupProperties |
| tags | Tag delle risorse | Dizionario di nomi e valori di tag. |
| type | Tipo di risorsa | "Microsoft. Sql/servers/failoverGroups@2025-02-01-anteprima" |
FailoverGroupProperties
| Name | Description | Value |
|---|---|---|
| databases | Elenco di database nel gruppo di failover. | string[] |
| partnerServers | Elenco delle informazioni sul server partner per il gruppo di failover. | PartnerInfo[] (obbligatorio) |
| readOnlyEndpoint | Endpoint di sola lettura dell'istanza del gruppo di failover. | FailoverGroupReadOnlyEndpoint |
| readWriteEndpoint | Endpoint di lettura/scrittura dell'istanza del gruppo di failover. | FailoverGroupReadWriteEndpoint (obbligatorio) |
| secondaryType | Tipo secondario di database nel server partner. | 'Geo' 'Standby' |
FailoverGroupReadOnlyEndpoint
| Name | Description | Value |
|---|---|---|
| failoverPolicy | Criteri di failover dell'endpoint di sola lettura per il gruppo di failover. | 'Disabled' 'Enabled' |
| targetServer | Server partner di destinazione in cui punta l'endpoint di sola lettura. | string |
FailoverGroupReadWriteEndpoint
| Name | Description | Value |
|---|---|---|
| failoverPolicy | Criteri di failover dell'endpoint di lettura/scrittura per il gruppo di failover. Se failoverPolicy è Automatico, è necessario failoverWithDataLossGracePeriodMinutes. | 'Automatic' 'Manuale' (obbligatorio) |
| failoverWithDataLossGracePeriodMinutes | Periodo di tolleranza prima del tentativo di failover con perdita di dati per l'endpoint di lettura/scrittura. Se failoverPolicy è Automatico, è necessario failoverWithDataLossGracePeriodMinutes. | int |
FailoverGroupTags
| Name | Description | Value |
|---|
PartnerInfo
| Name | Description | Value |
|---|---|---|
| id | Identificatore della risorsa del server partner. | stringa (obbligatorio) |