Instance Failover Groups - Create Or Update
Erstellt oder aktualisiert eine Failovergruppe.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/instanceFailoverGroups/{failoverGroupName}?api-version=2021-11-01
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
failover
|
path | True |
string |
Der Name der Failovergruppe. |
location
|
path | True |
string |
Der Name der Region, in der sich die Ressource befindet. |
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. |
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.managedInstancePairs | True |
Liste der verwalteten instance-Paare in der Failovergruppe. |
|
properties.partnerRegions | True |
Partnerregionsinformationen für die Failovergruppe. |
|
properties.readWriteEndpoint | True |
Lese-/Schreibendpunkt der Failovergruppe instance. |
|
properties.readOnlyEndpoint |
Schreibgeschützter Endpunkt der Failovergruppe instance. |
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/locations/Japan East/instanceFailoverGroups/failover-group-test-3?api-version=2021-11-01
{
"properties": {
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 480
},
"readOnlyEndpoint": {
"failoverPolicy": "Disabled"
},
"partnerRegions": [
{
"location": "Japan West"
}
],
"managedInstancePairs": [
{
"primaryManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-primary-mngdInstance",
"partnerManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-secondary-mngdInstance"
}
]
}
}
Beispiel für eine Antwort
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/JapanEast/instanceFailoverGroups/failover-group-test-3",
"name": "failover-group-test-3",
"type": "Microsoft.Sql/locations/instanceFailoverGroups",
"properties": {
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 480
},
"readOnlyEndpoint": {
"failoverPolicy": "Disabled"
},
"replicationRole": "Primary",
"replicationState": "CATCH_UP",
"partnerRegions": [
{
"location": "Japan West",
"replicationRole": "Secondary"
}
],
"managedInstancePairs": [
{
"primaryManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-primary-mngdInstance",
"partnerManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-secondary-mngdInstance"
}
]
}
}
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/JapanEast/instanceFailoverGroups/failover-group-test-3",
"name": "failover-group-test-3",
"type": "Microsoft.Sql/locations/instanceFailoverGroups",
"properties": {
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 480
},
"readOnlyEndpoint": {
"failoverPolicy": "Disabled"
},
"replicationRole": "Primary",
"replicationState": "CATCH_UP",
"partnerRegions": [
{
"location": "Japan West",
"replicationRole": "Secondary"
}
],
"managedInstancePairs": [
{
"primaryManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-primary-mngdInstance",
"partnerManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-secondary-mngdInstance"
}
]
}
}
Definitionen
Name | Beschreibung |
---|---|
Instance |
Eine instance-Failovergruppe. |
Instance |
Schreibgeschützter Endpunkt der Failovergruppe instance. |
Instance |
Lese-/Schreibendpunkt der Failovergruppe instance. |
Instance |
Lokale Replikationsrolle der Failovergruppe instance. |
Managed |
Paare von verwalteten Instanzen in der Failovergruppe. |
Partner |
Partnerregionsinformationen 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 den Wert Automatic hat, ist failoverWithDataLossGracePeriodMinutes erforderlich. |
InstanceFailoverGroup
Eine instance-Failovergruppe.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Ressourcen-ID |
name |
string |
Name der Ressource. |
properties.managedInstancePairs |
Liste der verwalteten instance-Paare in der Failovergruppe. |
|
properties.partnerRegions |
Partnerregionsinformationen 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. |
type |
string |
Der Ressourcentyp. |
InstanceFailoverGroupReadOnlyEndpoint
Schreibgeschützter Endpunkt der Failovergruppe instance.
Name | Typ | Beschreibung |
---|---|---|
failoverPolicy |
Failoverrichtlinie des schreibgeschützten Endpunkts für die Failovergruppe. |
InstanceFailoverGroupReadWriteEndpoint
Lese-/Schreibendpunkt der Failovergruppe instance.
Name | Typ | Beschreibung |
---|---|---|
failoverPolicy |
Failoverrichtlinie des Lese-/Schreibendpunkts für die Failovergruppe. Wenn failoverPolicy den Wert Automatic hat, ist failoverWithDataLossGracePeriodMinutes erforderlich. |
|
failoverWithDataLossGracePeriodMinutes |
integer |
Karenzzeit, bevor ein Failover mit Datenverlust für den Endpunkt mit Lese-/Schreibzugriff versucht wird. Wenn failoverPolicy den Wert Automatic hat, ist failoverWithDataLossGracePeriodMinutes erforderlich. |
InstanceFailoverGroupReplicationRole
Lokale Replikationsrolle der Failovergruppe instance.
Name | Typ | Beschreibung |
---|---|---|
Primary |
string |
|
Secondary |
string |
ManagedInstancePairInfo
Paare von verwalteten Instanzen in der Failovergruppe.
Name | Typ | Beschreibung |
---|---|---|
partnerManagedInstanceId |
string |
Id des Partner-verwaltete Instanz paarweise. |
primaryManagedInstanceId |
string |
Id der primären verwaltete Instanz paarweise. |
PartnerRegionInfo
Partnerregionsinformationen für die Failovergruppe.
Name | Typ | Beschreibung |
---|---|---|
location |
string |
Geografischer Standort der vom Partner verwalteten Instanzen. |
replicationRole |
Replikationsrolle der vom Partner verwalteten Instanzen. |
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 den Wert Automatic hat, ist failoverWithDataLossGracePeriodMinutes erforderlich.
Name | Typ | Beschreibung |
---|---|---|
Automatic |
string |
|
Manual |
string |