Failover Groups - Create Or Update
Erstellt oder aktualisiert eine Failovergruppe.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/failoverGroups/{failoverGroupName}?api-version=2021-11-01
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
failover
|
path | True |
string |
Der Name der Failovergruppe. |
resource
|
path | True |
string |
Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden. |
server
|
path | True |
string |
Der Name des Servers, der die Failovergruppe enthält. |
subscription
|
path | True |
string |
Abonnement-ID für ein Azure-Abonnement. |
api-version
|
query | True |
string |
API-Version, die für die Anforderung verwendet werden soll. |
Anforderungstext
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
properties.partnerServers | True |
Liste der Partnerserverinformationen für die Failovergruppe. |
|
properties.readWriteEndpoint | True |
Lese-/Schreibendpunkt der Failovergruppe instance. |
|
properties.databases |
string[] |
Liste der Datenbanken in der Failovergruppe. |
|
properties.readOnlyEndpoint |
Schreibgeschützter Endpunkt der Failovergruppe instance. |
||
tags |
object |
Ressourcentags. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Die Failovergruppe wurde erfolgreich aktualisiert. |
|
201 Created |
Die Failovergruppe wurde erfolgreich erstellt. |
|
202 Accepted |
Akzeptiert |
|
Other Status Codes |
Fehlerantworten: ***
|
Beispiele
Create failover group
Beispielanforderung
PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3?api-version=2021-11-01
{
"properties": {
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 480
},
"readOnlyEndpoint": {
"failoverPolicy": "Disabled"
},
"partnerServers": [
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server"
}
],
"databases": [
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
]
}
}
Beispiel für eine Antwort
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3",
"name": "failover-group-test-3",
"type": "Microsoft.Sql/servers/failoverGroups",
"location": "Japan East",
"properties": {
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 480
},
"readOnlyEndpoint": {
"failoverPolicy": "Disabled"
},
"replicationRole": "Primary",
"replicationState": "CATCH_UP",
"partnerServers": [
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server",
"location": "Japan West",
"replicationRole": "Secondary"
}
],
"databases": [
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
]
}
}
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3",
"name": "failover-group-test-3",
"type": "Microsoft.Sql/servers/failoverGroups",
"location": "Japan East",
"properties": {
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 480
},
"readOnlyEndpoint": {
"failoverPolicy": "Disabled"
},
"replicationRole": "Primary",
"replicationState": "CATCH_UP",
"partnerServers": [
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server",
"location": "Japan West",
"replicationRole": "Secondary"
}
],
"databases": [
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
]
}
}
Definitionen
Name | Beschreibung |
---|---|
Failover |
Eine Failovergruppe. |
Failover |
Schreibgeschützter Endpunkt der Failovergruppe instance. |
Failover |
Lese-/Schreibendpunkt der Failovergruppe instance. |
Failover |
Lokale Replikationsrolle der Failovergruppe instance. |
Partner |
Partnerserverinformationen für die Failovergruppe. |
Read |
Failoverrichtlinie des schreibgeschützten Endpunkts für die Failovergruppe. |
Read |
Failoverrichtlinie des Lese-/Schreibendpunkts für die Failovergruppe. Wenn failoverPolicy Automatisch ist, ist failoverWithDataLossGracePeriodMinutes erforderlich. |
FailoverGroup
Eine Failovergruppe.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Ressourcen-ID |
location |
string |
Ressourcenspeicherort |
name |
string |
Name der Ressource. |
properties.databases |
string[] |
Liste der Datenbanken in der Failovergruppe. |
properties.partnerServers |
Liste der Partnerserverinformationen für die Failovergruppe. |
|
properties.readOnlyEndpoint |
Schreibgeschützter Endpunkt der Failovergruppe instance. |
|
properties.readWriteEndpoint |
Lese-/Schreibendpunkt der Failovergruppe instance. |
|
properties.replicationRole |
Lokale Replikationsrolle der Failovergruppe instance. |
|
properties.replicationState |
string |
Replikationsstatus der Failovergruppe instance. |
tags |
object |
Ressourcentags. |
type |
string |
Der Ressourcentyp. |
FailoverGroupReadOnlyEndpoint
Schreibgeschützter Endpunkt der Failovergruppe instance.
Name | Typ | Beschreibung |
---|---|---|
failoverPolicy |
Failoverrichtlinie des schreibgeschützten Endpunkts für die Failovergruppe. |
FailoverGroupReadWriteEndpoint
Lese-/Schreibendpunkt der Failovergruppe instance.
Name | Typ | Beschreibung |
---|---|---|
failoverPolicy |
Failoverrichtlinie des Lese-/Schreibendpunkts für die Failovergruppe. Wenn failoverPolicy Automatisch ist, ist failoverWithDataLossGracePeriodMinutes erforderlich. |
|
failoverWithDataLossGracePeriodMinutes |
integer |
Nachfrist, bevor ein Failover mit Datenverlust für den Lese-/Schreibendpunkt versucht wird. Wenn failoverPolicy Automatisch ist, ist failoverWithDataLossGracePeriodMinutes erforderlich. |
FailoverGroupReplicationRole
Lokale Replikationsrolle der Failovergruppe instance.
Name | Typ | Beschreibung |
---|---|---|
Primary |
string |
|
Secondary |
string |
PartnerInfo
Partnerserverinformationen für die Failovergruppe.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Ressourcenbezeichner des Partnerservers. |
location |
string |
Geostandort des Partnerservers. |
replicationRole |
Replikationsrolle des Partnerservers. |
ReadOnlyEndpointFailoverPolicy
Failoverrichtlinie des schreibgeschützten Endpunkts für die Failovergruppe.
Name | Typ | Beschreibung |
---|---|---|
Disabled |
string |
|
Enabled |
string |
ReadWriteEndpointFailoverPolicy
Failoverrichtlinie des Lese-/Schreibendpunkts für die Failovergruppe. Wenn failoverPolicy Automatisch ist, ist failoverWithDataLossGracePeriodMinutes erforderlich.
Name | Typ | Beschreibung |
---|---|---|
Automatic |
string |
|
Manual |
string |