Instance Failover Groups - Failover
Failover dari instans terkelola utama saat ini ke instans terkelola ini.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/instanceFailoverGroups/{failoverGroupName}/failover?api-version=2023-08-01
Parameter URI
| Nama | Dalam | Diperlukan | Jenis | Deskripsi |
|---|---|---|---|---|
|
failover
|
path | True |
string |
Nama grup failover. |
|
location
|
path | True |
string |
Nama wilayah tempat sumber daya berada. |
|
resource
|
path | True |
string |
Nama grup sumber daya yang berisi sumber daya. Anda dapat memperoleh nilai ini dari API Azure Resource Manager atau portal. |
|
subscription
|
path | True |
string |
ID langganan yang mengidentifikasi langganan Azure. |
|
api-version
|
query | True |
string |
Versi API yang akan digunakan untuk permintaan tersebut. |
Respons
| Nama | Jenis | Deskripsi |
|---|---|---|
| 200 OK |
Berhasil gagal. |
|
| 202 Accepted |
Diterima Header Location: string |
|
| Other Status Codes |
Respons Kesalahan: ***
|
Contoh
Planned failover of a failover group
Permintaan sampel
POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/Japan West/instanceFailoverGroups/failover-group-test-3/failover?api-version=2023-08-01
Respon sampel
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/JapanWest/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 East",
"replicationRole": "Secondary"
}
],
"managedInstancePairs": [
{
"primaryManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-secondary-mngdInstance",
"partnerManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-primary-mngdInstance"
}
],
"secondaryType": "Geo"
}
}
Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/JapanWest/instanceFailoverGroupOperationResults/failover-group-test-3?api-version=2022-05-01-preview
Definisi
| Nama | Deskripsi |
|---|---|
|
Error |
Info tambahan kesalahan manajemen sumber daya. |
|
Error |
Detail kesalahan. |
|
Error |
Respons kesalahan |
|
Instance |
Grup failover instans. |
|
Instance |
Titik akhir baca-saja dari instans grup failover. |
|
Instance |
Titik akhir baca-tulis dari instans grup failover. |
|
Instance |
Peran replikasi lokal instans grup failover. |
|
Managed |
Pasangan Instans Terkelola dalam grup failover. |
|
Partner |
Informasi wilayah mitra untuk grup failover. |
|
Read |
Kebijakan failover dari titik akhir baca-saja untuk grup failover. |
|
Read |
Kebijakan failover dari titik akhir baca-tulis untuk grup failover. Jika failoverPolicy Adalah Otomatis, maka failoverWithDataLossGracePeriodMinutes diperlukan. |
|
Secondary |
Jenis instans geo-sekunder. Atur 'Siaga' jika instans hanya digunakan sebagai opsi DR. |
ErrorAdditionalInfo
Info tambahan kesalahan manajemen sumber daya.
| Nama | Jenis | Deskripsi |
|---|---|---|
| info |
object |
Info tambahan. |
| type |
string |
Jenis info tambahan. |
ErrorDetail
Detail kesalahan.
| Nama | Jenis | Deskripsi |
|---|---|---|
| additionalInfo |
Info tambahan kesalahan. |
|
| code |
string |
Kode kesalahan. |
| details |
Detail kesalahan. |
|
| message |
string |
Pesan kesalahan. |
| target |
string |
Target kesalahan. |
ErrorResponse
Respons kesalahan
| Nama | Jenis | Deskripsi |
|---|---|---|
| error |
Objek kesalahan. |
InstanceFailoverGroup
Grup failover instans.
| Nama | Jenis | Deskripsi |
|---|---|---|
| id |
string |
ID Sumber Daya. |
| name |
string |
Nama sumber daya. |
| properties.managedInstancePairs |
Daftar pasangan instans terkelola dalam grup failover. |
|
| properties.partnerRegions |
Informasi wilayah mitra untuk grup failover. |
|
| properties.readOnlyEndpoint |
Titik akhir baca-saja dari instans grup failover. |
|
| properties.readWriteEndpoint |
Titik akhir baca-tulis dari instans grup failover. |
|
| properties.replicationRole |
Peran replikasi lokal instans grup failover. |
|
| properties.replicationState |
string |
Status replikasi instans grup failover. |
| properties.secondaryType |
Jenis instans geo-sekunder. Atur 'Siaga' jika instans hanya digunakan sebagai opsi DR. |
|
| type |
string |
Jenis sumber daya. |
InstanceFailoverGroupReadOnlyEndpoint
Titik akhir baca-saja dari instans grup failover.
| Nama | Jenis | Deskripsi |
|---|---|---|
| failoverPolicy |
Kebijakan failover dari titik akhir baca-saja untuk grup failover. |
InstanceFailoverGroupReadWriteEndpoint
Titik akhir baca-tulis dari instans grup failover.
| Nama | Jenis | Deskripsi |
|---|---|---|
| failoverPolicy |
Kebijakan failover dari titik akhir baca-tulis untuk grup failover. Jika failoverPolicy Adalah Otomatis, maka failoverWithDataLossGracePeriodMinutes diperlukan. |
|
| failoverWithDataLossGracePeriodMinutes |
integer (int32) |
Masa tenggang sebelum failover dengan kehilangan data dicoba untuk titik akhir baca-tulis. Jika failoverPolicy Adalah Otomatis, maka failoverWithDataLossGracePeriodMinutes diperlukan. |
InstanceFailoverGroupReplicationRole
Peran replikasi lokal instans grup failover.
| Nilai | Deskripsi |
|---|---|
| Primary | |
| Secondary |
ManagedInstancePairInfo
Pasangan Instans Terkelola dalam grup failover.
| Nama | Jenis | Deskripsi |
|---|---|---|
| partnerManagedInstanceId |
string |
Id Instans Terkelola Mitra berpasangan. |
| primaryManagedInstanceId |
string |
Id Instans Terkelola Utama berpasangan. |
PartnerRegionInfo
Informasi wilayah mitra untuk grup failover.
| Nama | Jenis | Deskripsi |
|---|---|---|
| location |
string |
Lokasi geografis instans terkelola mitra. |
| replicationRole |
Peran replikasi instans terkelola mitra. |
ReadOnlyEndpointFailoverPolicy
Kebijakan failover dari titik akhir baca-saja untuk grup failover.
| Nilai | Deskripsi |
|---|---|
| Disabled | |
| Enabled |
ReadWriteEndpointFailoverPolicy
Kebijakan failover dari titik akhir baca-tulis untuk grup failover. Jika failoverPolicy Adalah Otomatis, maka failoverWithDataLossGracePeriodMinutes diperlukan.
| Nilai | Deskripsi |
|---|---|
| Manual | |
| Automatic |
SecondaryInstanceType
Jenis instans geo-sekunder. Atur 'Siaga' jika instans hanya digunakan sebagai opsi DR.
| Nilai | Deskripsi |
|---|---|
| Geo | |
| Standby |