Instance Failover Groups - Create Or Update
Crea o aggiorna un gruppo di failover.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/instanceFailoverGroups/{failoverGroupName}?api-version=2021-11-01
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
failover
|
path | True |
string |
Nome del gruppo di failover. |
location
|
path | True |
string |
Nome dell'area in cui si trova la risorsa. |
resource
|
path | True |
string |
Nome del gruppo di risorse contenente la risorsa. È possibile ottenere questo valore dall'API di Gestione risorse di Azure o dal portale. |
subscription
|
path | True |
string |
ID sottoscrizione che identifica una sottoscrizione di Azure. |
api-version
|
query | True |
string |
Versione dell'API da usare per la richiesta. |
Corpo della richiesta
Nome | Necessario | Tipo | Descrizione |
---|---|---|---|
properties.managedInstancePairs | True |
Elenco di coppie di istanze gestite nel gruppo di failover. |
|
properties.partnerRegions | True |
Informazioni sull'area del partner per il gruppo di failover. |
|
properties.readWriteEndpoint | True |
Endpoint di lettura/scrittura dell'istanza del gruppo di failover. |
|
properties.readOnlyEndpoint |
Endpoint di sola lettura dell'istanza del gruppo di failover. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Aggiornamento corretto del gruppo di failover. |
|
201 Created |
Creazione del gruppo di failover completata. |
|
202 Accepted |
Accettato |
|
Other Status Codes |
Risposte di errore:
|
Esempio
Create failover group
Esempio di richiesta
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"
}
]
}
}
Risposta di esempio
{
"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"
}
]
}
}
Definizioni
Nome | Descrizione |
---|---|
Instance |
Un gruppo di failover dell'istanza. |
Instance |
Endpoint di sola lettura dell'istanza del gruppo di failover. |
Instance |
Endpoint di lettura/scrittura dell'istanza del gruppo di failover. |
Instance |
Ruolo di replica locale dell'istanza del gruppo di failover. |
Managed |
Coppie di istanze gestite nel gruppo di failover. |
Partner |
Informazioni sull'area del partner per il gruppo di failover. |
Read |
Criteri di failover dell'endpoint di sola lettura per il gruppo di failover. |
Read |
Criteri di failover dell'endpoint di lettura/scrittura per il gruppo di failover. Se failoverPolicy è Automatico, è necessario eseguire il failoverWithDataLossGracePeriodMinutes. |
InstanceFailoverGroup
Un gruppo di failover dell'istanza.
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
ID risorsa. |
name |
string |
Nome risorsa. |
properties.managedInstancePairs |
Elenco di coppie di istanze gestite nel gruppo di failover. |
|
properties.partnerRegions |
Informazioni sull'area del partner per il gruppo di failover. |
|
properties.readOnlyEndpoint |
Endpoint di sola lettura dell'istanza del gruppo di failover. |
|
properties.readWriteEndpoint |
Endpoint di lettura/scrittura dell'istanza del gruppo di failover. |
|
properties.replicationRole |
Ruolo di replica locale dell'istanza del gruppo di failover. |
|
properties.replicationState |
string |
Stato di replica dell'istanza del gruppo di failover. |
type |
string |
Tipo di risorsa. |
InstanceFailoverGroupReadOnlyEndpoint
Endpoint di sola lettura dell'istanza del gruppo di failover.
Nome | Tipo | Descrizione |
---|---|---|
failoverPolicy |
Criteri di failover dell'endpoint di sola lettura per il gruppo di failover. |
InstanceFailoverGroupReadWriteEndpoint
Endpoint di lettura/scrittura dell'istanza del gruppo di failover.
Nome | Tipo | Descrizione |
---|---|---|
failoverPolicy |
Criteri di failover dell'endpoint di lettura/scrittura per il gruppo di failover. Se failoverPolicy è Automatico, è necessario eseguire il failoverWithDataLossGracePeriodMinutes. |
|
failoverWithDataLossGracePeriodMinutes |
integer |
Periodo di tolleranza prima del tentativo di failover con perdita di dati per l'endpoint di lettura/scrittura. Se failoverPolicy è Automatico, è necessario eseguire il failoverWithDataLossGracePeriodMinutes. |
InstanceFailoverGroupReplicationRole
Ruolo di replica locale dell'istanza del gruppo di failover.
Nome | Tipo | Descrizione |
---|---|---|
Primary |
string |
|
Secondary |
string |
ManagedInstancePairInfo
Coppie di istanze gestite nel gruppo di failover.
Nome | Tipo | Descrizione |
---|---|---|
partnerManagedInstanceId |
string |
ID del Istanza gestita partner in coppia. |
primaryManagedInstanceId |
string |
ID del Istanza gestita primario in coppia. |
PartnerRegionInfo
Informazioni sull'area del partner per il gruppo di failover.
Nome | Tipo | Descrizione |
---|---|---|
location |
string |
Posizione geografica delle istanze gestite dal partner. |
replicationRole |
Ruolo di replica delle istanze gestite dal partner. |
ReadOnlyEndpointFailoverPolicy
Criteri di failover dell'endpoint di sola lettura per il gruppo di failover.
Nome | Tipo | Descrizione |
---|---|---|
Disabled |
string |
|
Enabled |
string |
ReadWriteEndpointFailoverPolicy
Criteri di failover dell'endpoint di lettura/scrittura per il gruppo di failover. Se failoverPolicy è Automatico, è necessario eseguire il failoverWithDataLossGracePeriodMinutes.
Nome | Tipo | Descrizione |
---|---|---|
Automatic |
string |
|
Manual |
string |