Bagikan melalui


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=2021-11-01

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
failoverGroupName
path True

string

Nama grup failover.

locationName
path True

string

Nama wilayah tempat sumber daya berada.

resourceGroupName
path True

string

Nama grup sumber daya yang berisi sumber daya. Anda dapat memperoleh nilai ini dari Azure Resource Manager API atau portal.

subscriptionId
path True

string

ID langganan yang mengidentifikasi langganan Azure.

api-version
query True

string

Versi API yang digunakan untuk permintaan.

Respons

Nama Jenis Deskripsi
200 OK

InstanceFailoverGroup

Berhasil di-failover.

202 Accepted

Diterima

Other Status Codes

Respons Kesalahan: ***

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPrimary - Bidang utama yang diberikan dalam membuat atau memperbarui isi permintaan grup failover instans kosong atau tidak valid.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPartner - Bidang mitra yang diberikan dalam membuat atau memperbarui isi permintaan grup failover instans kosong atau tidak valid.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestDuplicatePartner - Satu atau beberapa server mitra yang disediakan sudah menjadi bagian dari grup failover instans. Pastikan server utama dan semua server mitra yang diberikan unik.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidManagedInstanceRegion - Wilayah instans terkelola mitra yang disediakan dalam isi permintaan grup failover instans kosong atau tidak valid.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount - Hanya satu wilayah mitra yang didukung.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPairCount - Hanya satu pasangan instans terkelola yang didukung.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint - Bidang readWriteEndpoint diperlukan untuk membuat atau memperbarui permintaan.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalid - Isi permintaan grup failover instans buat atau perbarui kosong atau tidak valid.

  • 400 InstanceFailoverGroupUpdateOrDeleteRequestOnSecondary - Modifikasi pada grup failover instans tidak diizinkan di server sekunder. Jalankan permintaan di server utama.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues - Nilai masa tenggang untuk titik akhir baca-tulis harus non-negatif.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestLessThanMinimumGracePeriodValues - Nilai masa tenggang untuk grup failover instans harus lebih besar dari atau sama dengan masa tenggang minimum '{0}' menit

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields - Properti failoverWithDataLossGracePeriodMinutes harus disediakan ketika kebijakan failover Otomatis dipilih untuk titik akhir baca-tulis.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteFailoverPolicy - Bidang failoverPolicy untuk titik akhir baca-tulis diperlukan untuk membuat atau memperbarui permintaan.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy - Nilai masa tenggang tidak boleh disediakan saat kebijakan failover Manual dipilih untuk titik akhir baca-tulis.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified - Isi permintaan grup failover instans buat atau perbarui tidak boleh memodifikasi properti baca-saja '{0}'.

  • 400 InstanceFailoverGroupFailoverRequestOnPrimary - Permintaan failover harus dimulai pada server sekunder grup failover instans.

  • 400 InstanceFailoverGroupPartnerManagedInstanceFromDifferentSubscription - Server utama dan server mitra grup failover berasal dari langganan yang berbeda. Langganan silang untuk server grup failover tidak diperbolehkan.

  • 400 FailoverGroupRegionMismatch - Wilayah mitra yang ditentukan dalam Grup Failover harus sesuai dengan wilayah instans terkelola mitra yang ditunjukkan.

  • 400 ServerEditionMismatch - Edisi harus sama dengan server utama saat membuat server replika.

  • 400 DnsZoneMismatch - DNSZone di server mitra berbeda dari DNSZone di server sumber. Ini memutus fungsionalitas InstanceFailoverGroup.

  • 400 InvalidTargetSubregion - Server target sekunder yang tidak dapat dibaca tidak berada di wilayah Azure yang dipasangkan DR.

  • 400 GeoDrInstanceSizeMismatch - Instans terkelola utama dan instans terkelola mitra tidak memiliki ukuran penyimpanan yang sama.

  • 400 SecurityAdalPrincipalCertExpiredError - Operasi tidak dapat diselesaikan karena sertifikat utama Azure Key Vault telah kedaluwarsa.

  • 400 GeoDrSecondaryInstanceNotEmpty - Instans terkelola sekunder memiliki database pengguna. Untuk membuat grup failover instans, instans terkelola sekunder harus kosong.

  • 400 InstanceFailoverGroupIncorrectNetworkingConfiguration - Konfigurasi jaringan salah. Lalu lintas replikasi server utama tidak dapat mencapai server sekunder.

  • 400 IncorrectReplicationLinkState - Operasi mengharapkan database berada dalam status yang diharapkan pada tautan replikasi.

  • 400 SecurityInvalidAzureKeyVaultRecoveryLevel - Uri Key Vault yang disediakan tidak valid.

  • 400 KeyMaterialNotFoundOnRemoteServer - Server jarak jauh tidak memiliki akses ke materi kunci yang digunakan sebagai pelindung TDE.

  • 400 AzureKeyVaultRsaKeyNotSupported - Brankas kunci yang disediakan menggunakan Ukuran Kunci RSA atau Jenis Kunci yang tidak didukung. Ukuran kunci RSA yang didukung adalah 2048 atau 3072 dan Jenis Kunci adalah RSA atau RSA-HSM.

  • 400 UnableToResolveRemoteServer - Nama server mitra jarak jauh tidak dapat diselesaikan karena nama server atau masalah konektivitas DNS yang tidak valid.

  • 400 SameKeyUriNotFoundOnRemoteServer - Server sekunder tidak memiliki materi kunci dari brankas kunci yang sama dengan pelindung enkripsi server utama dengan rotasi otomatis kunci diaktifkan.

  • 400 RemoteDatabaseCopyPermission - Pengguna tidak memiliki izin yang memadai untuk membuat salinan database di server yang ditentukan.

  • 400 SameKeyMaterialNotFoundOnRemoteServer - Server sekunder tidak memiliki materi kunci pelindung enkripsi server utama.

  • 400 CannotUseReservedDatabaseName - Tidak dapat menggunakan nama database yang dipesan dalam operasi ini.

  • 400 InvalidFailoverGroupRegion - Server yang ditentukan dalam Grup Failover Instans harus berada di wilayah yang berbeda untuk memberikan isolasi.

  • 400 InstanceFailoverGroupDoesNotExist - Grup failover tidak ada di server.

  • 400 InstanceFailoverGroupNotSecondary - Failover tidak dapat dimulai dari server utama dalam grup failover instans.

  • 400 InvalidServerName - Nama server yang ditentukan tidak valid.

  • 400 InvalidIdentifier - Pengidentifikasi berisi NULL atau karakter unicode yang tidak valid.

  • 400 TokenTooLong - Token yang disediakan terlalu panjang.

  • 400 AzureKeyVaultKeyDisabled - Operasi tidak dapat diselesaikan di server karena kunci Azure Key Vault dinonaktifkan.

  • 400 AzureKeyVaultInvalidExpirationDate - Operasi tidak dapat diselesaikan karena tanggal kedaluwarsa kunci Azure Key Vault tidak valid.

  • 400 SecurityAzureKeyVaultUrlNullOrEmpty - Operasi tidak dapat diselesaikan karena Azure Key Vault Uri null atau kosong.

  • 400 InvalidSku - Pengguna menentukan sku yang tidak valid.

  • 400 InvalidAddSecondaryPermission - Pengguna tidak memiliki izin yang memadai untuk menambahkan sekunder pada server yang ditentukan.

  • 400 ServerNotFound - Server yang diminta tidak ditemukan.

  • 400 AzureKeyVaultNoServerIdentity - Identitas server tidak dikonfigurasi dengan benar.

  • 400 AzureKeyVaultInvalidUri - Respons yang tidak valid dari Azure Key Vault. Silakan gunakan Azure Key Vault URI yang valid.

  • 400 AzureKeyVaultMissingPermissions - Server kehilangan izin yang diperlukan di Azure Key Vault.

  • 400 SecurityAzureKeyVaultInvalidKeyName - Operasi tidak dapat diselesaikan karena nama Kunci Server yang tidak valid.

  • 400 PlannedFailoverTimedOutForDatabase - Pengguna memanggil penyelamatan kegagalan yang terjadwal, waktu habis, dan database tertentu tampaknya disalahkan.

  • 400 PlannedFailoverTimedOut - Pengguna memanggil penyelamatan kegagalan yang terjadwal, dan waktunya habis saat mencoba menghubungi layanan manajemen mitra.

  • 400 AdalGenericError - Operasi tidak dapat diselesaikan karena terjadi kesalahan Azure Active Directory.

  • 400 GeoReplicationDatabaseNotSecondary - Operasi mengharapkan database menjadi target replikasi.

  • 400 AdalServicePrincipalNotFound - Operasi tidak dapat diselesaikan karena Perwakilan Layanan pustaka Azure Active Directory tidak menemukan kesalahan.

  • 400 AzureKeyVaultMalformedVaultUri - uri Key Vault yang disediakan tidak valid.

  • 400 FeatureDisabledOnSelectedEdition - Pengguna mencoba menggunakan fitur yang dinonaktifkan pada edisi database saat ini.

  • 404 OperationIdNotFound - Operasi dengan Id tidak ada.

  • 404 ResourceNotFound - Sumber daya yang diminta tidak ditemukan.

  • 404 OperationIdNotFound - Operasi dengan Id tidak ada.

  • 404 SourceDatabaseNotFound - Database sumber tidak ada.

  • 404 ServerNotInSubscription - Server yang ditentukan tidak ada pada langganan yang ditentukan.

  • 404 ServerNotInSubscriptionResourceGroup - Server yang ditentukan tidak ada di grup sumber daya dan langganan yang ditentukan.

  • 405 UnsupportedReplicationOperation - Operasi replikasi yang tidak didukung dimulai pada database.

  • 409 OperationCancelled - Operasi telah dibatalkan oleh pengguna.

  • 409 OperationInterrupted - Operasi pada sumber daya tidak dapat diselesaikan karena terganggu oleh operasi lain pada sumber daya yang sama.

  • 409 ManagedInstanceHasHybridLink - Pengguna mencoba memulai operasi yang tidak didukung ketika instans terkelola memiliki tautan hibrid yang dikonfigurasi.

  • 409 RemoteDatabaseExists - Nama database tujuan sudah ada di server tujuan.

  • 409 ConflictingServerOperation - Operasi saat ini sedang berlangsung untuk server.

  • 409 SubscriptionDisabled - Langganan dinonaktifkan.

  • 409 InstanceFailoverGroupAlreadyExists - Grup failover sudah ada di server tertentu.

  • 409 InstanceFailoverGroupBusy - Grup failover instans sibuk dengan operasi lain.

  • 409 GeoReplicationCannotBecomePrimaryDuringUndo - Pengguna mencoba melakukan failover atau menghentikan paksa geo-link saat sekunder berada dalam keadaan di mana mungkin tidak konsisten secara fisik sehingga tidak dapat memasukkan peran utama.

  • 409 InstanceFailoverGroupDnsRecordInUse - Ada catatan DNS duplikat untuk titik akhir yang diminta.

  • 409 ServerKeyNameAlreadyExists - Kunci server sudah ada di server.

  • 409 ServerKeyUriAlreadyExists - URI kunci server sudah ada di server.

  • 409 ServerKeyDoesNotExists - Kunci server tidak ada.

  • 409 InvalidFailoverGroupName - Nama Grup Failover Instans Tidak Valid disediakan.

  • 409 UpdateSloInProgress - Pengguna mencoba memulai operasi yang tidak kompatibel saat pembaruan SLO sedang berlangsung.

  • 409 AzureKeyVaultKeyNameNotFound - Operasi tidak dapat diselesaikan karena nama Azure Key Vault Key tidak ada.

  • 409 AzureKeyVaultKeyInUse - Kunci saat ini sedang digunakan oleh server.

  • 409 ConflictingSystemOperationInProgress - Operasi pemeliharaan sistem sedang berlangsung pada database dan operasi lebih lanjut perlu menunggu sampai selesai.

  • 409 InvalidOperationForDatabaseNotInReplicationRelationship - Operasi penyemaian replikasi dilakukan pada database yang sudah berada dalam hubungan replikasi.

  • 409 InvalidDatabaseStateForOperation - Operasi tidak diizinkan pada database dalam status replikasi saat ini.

  • 409 DuplicateGeoDrRelation - Database sudah berada dalam relasi replikasi. Ini adalah permintaan duplikat.

  • 429 SubscriptionTooManyCreateUpdateRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia.

  • 429 SubscriptionTooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia.

  • 429 SubscriptionTooManyCreateUpdateRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia.

  • 429 SubscriptionTooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia.

  • 500 OperationTimedOut - Waktu operasi habis dan secara otomatis digulung balik. Coba lagi operasi ini.

  • 503 TooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia.

  • 503 TooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia.

  • 503 AzureKeyVaultConnectionFailed - Operasi tidak dapat diselesaikan di server karena upaya untuk menyambungkan ke Azure Key Vault gagal

  • 503 AzureKeyVaultGenericConnectionError - Operasi tidak dapat diselesaikan karena terjadi kesalahan saat mencoba mengambil informasi Key Vault .

  • 504 RequestTimeout - Permintaan layanan melebihi batas waktu yang diizinkan.

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=2021-11-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"
      }
    ]
  }
}

Definisi

Nama Deskripsi
InstanceFailoverGroup

Grup failover instans.

InstanceFailoverGroupReadOnlyEndpoint

Titik akhir baca-saja dari instans grup failover.

InstanceFailoverGroupReadWriteEndpoint

Titik akhir baca-tulis instans grup failover.

InstanceFailoverGroupReplicationRole

Peran replikasi lokal instans grup failover.

ManagedInstancePairInfo

Pasangan Instans Terkelola dalam grup failover.

PartnerRegionInfo

Informasi wilayah mitra untuk grup failover.

ReadOnlyEndpointFailoverPolicy

Kebijakan failover dari titik akhir baca-saja untuk grup failover.

ReadWriteEndpointFailoverPolicy

Kebijakan failover dari titik akhir baca-tulis untuk grup failover. Jika failoverPolicy Otomatis, maka failoverWithDataLossGracePeriodMinutes diperlukan.

InstanceFailoverGroup

Grup failover instans.

Nama Jenis Deskripsi
id

string

ID Sumber Daya.

name

string

Nama sumber daya.

properties.managedInstancePairs

ManagedInstancePairInfo[]

Daftar pasangan instans terkelola dalam grup failover.

properties.partnerRegions

PartnerRegionInfo[]

Informasi wilayah mitra untuk grup failover.

properties.readOnlyEndpoint

InstanceFailoverGroupReadOnlyEndpoint

Titik akhir baca-saja dari instans grup failover.

properties.readWriteEndpoint

InstanceFailoverGroupReadWriteEndpoint

Titik akhir baca-tulis instans grup failover.

properties.replicationRole

InstanceFailoverGroupReplicationRole

Peran replikasi lokal instans grup failover.

properties.replicationState

string

Status replikasi instans grup failover.

type

string

Jenis sumber daya

InstanceFailoverGroupReadOnlyEndpoint

Titik akhir baca-saja dari instans grup failover.

Nama Jenis Deskripsi
failoverPolicy

ReadOnlyEndpointFailoverPolicy

Kebijakan failover dari titik akhir baca-saja untuk grup failover.

InstanceFailoverGroupReadWriteEndpoint

Titik akhir baca-tulis instans grup failover.

Nama Jenis Deskripsi
failoverPolicy

ReadWriteEndpointFailoverPolicy

Kebijakan failover dari titik akhir baca-tulis untuk grup failover. Jika failoverPolicy Otomatis, maka failoverWithDataLossGracePeriodMinutes diperlukan.

failoverWithDataLossGracePeriodMinutes

integer

Masa tenggang sebelum failover dengan kehilangan data dicoba untuk titik akhir baca-tulis. Jika failoverPolicy Otomatis, maka failoverWithDataLossGracePeriodMinutes diperlukan.

InstanceFailoverGroupReplicationRole

Peran replikasi lokal instans grup failover.

Nama Jenis Deskripsi
Primary

string

Secondary

string

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

InstanceFailoverGroupReplicationRole

Peran replikasi instans terkelola mitra.

ReadOnlyEndpointFailoverPolicy

Kebijakan failover dari titik akhir baca-saja untuk grup failover.

Nama Jenis Deskripsi
Disabled

string

Enabled

string

ReadWriteEndpointFailoverPolicy

Kebijakan failover dari titik akhir baca-tulis untuk grup failover. Jika failoverPolicy Otomatis, maka failoverWithDataLossGracePeriodMinutes diperlukan.

Nama Jenis Deskripsi
Automatic

string

Manual

string