Failover Groups - Get
Ottiene un gruppo di failover.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/failoverGroups/{failoverGroupName}?api-version=2023-08-01
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
failover
|
path | True |
string |
Nome del gruppo di failover. |
resource
|
path | True |
string |
Nome del gruppo di risorse che contiene la risorsa. È possibile ottenere questo valore dall'API di Azure Resource Manager o dal portale. |
server
|
path | True |
string |
Nome del server contenente il gruppo di failover. |
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. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
È stato recuperato correttamente il gruppo di failover specificato. |
|
Other Status Codes |
Risposte di errore:
|
Esempio
Get failover group
Esempio di richiesta
GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failovergroupprimaryserver/failoverGroups/failovergrouptest3?api-version=2023-08-01
Risposta di esempio
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failovergroupprimaryserver/failoverGroups/failovergrouptest3",
"name": "failovergrouptest3",
"type": "Microsoft.Sql/servers/failoverGroups",
"location": "Japan West",
"properties": {
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 120
},
"readOnlyEndpoint": {
"failoverPolicy": "Enabled",
"targetServer": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failovergroupsecondaryserver"
},
"replicationRole": "Primary",
"replicationState": "CATCH_UP",
"partnerServers": [
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failovergroupsecondaryserver",
"location": "Japan East",
"replicationRole": "Secondary"
}
],
"databases": [
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failovergroupprimaryserver/databases/testdb1",
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failovergroupprimaryserver/databases/testdb2"
]
}
}
Definizioni
Nome | Descrizione |
---|---|
Error |
Informazioni aggiuntive sull'errore di gestione delle risorse. |
Error |
Dettagli dell'errore. |
Error |
Risposta di errore |
Failover |
Un gruppo di failover. |
Failover |
Tipo secondario di database nel server partner. |
Failover |
Endpoint di sola lettura dell'istanza del gruppo di failover. |
Failover |
Endpoint di lettura/scrittura dell'istanza del gruppo di failover. |
Failover |
Ruolo di replica locale dell'istanza del gruppo di failover. |
Partner |
Informazioni sul server 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 failoverWithDataLossGracePeriodMinutes. |
ErrorAdditionalInfo
Informazioni aggiuntive sull'errore di gestione delle risorse.
Nome | Tipo | Descrizione |
---|---|---|
info |
object |
Informazioni aggiuntive. |
type |
string |
Tipo di informazioni aggiuntive. |
ErrorDetail
Dettagli dell'errore.
Nome | Tipo | Descrizione |
---|---|---|
additionalInfo |
Informazioni aggiuntive sull'errore. |
|
code |
string |
Codice di errore. |
details |
Dettagli dell'errore. |
|
message |
string |
Messaggio di errore. |
target |
string |
Destinazione dell'errore. |
ErrorResponse
Risposta di errore
Nome | Tipo | Descrizione |
---|---|---|
error |
Oggetto error. |
FailoverGroup
Un gruppo di failover.
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
ID risorsa. |
location |
string |
Percorso della risorsa. |
name |
string |
Nome risorsa. |
properties.databases |
string[] (arm-id) |
Elenco di database nel gruppo di failover. |
properties.partnerServers |
Elenco delle informazioni sul server 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. |
properties.secondaryType |
Tipo secondario di database nel server partner. |
|
tags |
object |
Tag di risorsa. |
type |
string |
Tipo di risorsa. |
FailoverGroupDatabasesSecondaryType
Tipo secondario di database nel server partner.
Valore | Descrizione |
---|---|
Geo | |
Standby |
FailoverGroupReadOnlyEndpoint
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. |
|
targetServer |
string (arm-id) |
Server partner di destinazione in cui punta l'endpoint di sola lettura. |
FailoverGroupReadWriteEndpoint
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 failoverWithDataLossGracePeriodMinutes. |
|
failoverWithDataLossGracePeriodMinutes |
integer (int32) |
Periodo di tolleranza prima del tentativo di failover con perdita di dati per l'endpoint di lettura/scrittura. Se failoverPolicy è Automatico, è necessario failoverWithDataLossGracePeriodMinutes. |
FailoverGroupReplicationRole
Ruolo di replica locale dell'istanza del gruppo di failover.
Valore | Descrizione |
---|---|
Primary | |
Secondary |
PartnerInfo
Informazioni sul server partner per il gruppo di failover.
Nome | Tipo | Descrizione |
---|---|---|
id |
string (arm-id) |
Identificatore della risorsa del server partner. |
location |
string |
Posizione geografica del server partner. |
replicationRole |
Ruolo di replica del server partner. |
ReadOnlyEndpointFailoverPolicy
Criteri di failover dell'endpoint di sola lettura per il gruppo di failover.
Valore | Descrizione |
---|---|
Disabled | |
Enabled |
ReadWriteEndpointFailoverPolicy
Criteri di failover dell'endpoint di lettura/scrittura per il gruppo di failover. Se failoverPolicy è Automatico, è necessario failoverWithDataLossGracePeriodMinutes.
Valore | Descrizione |
---|---|
Automatic | |
Manual |