Replication Links - Failover

Layanan:: SQL Database

Versi API:: 2023-08-01

Failover dari server utama saat ini ke server ini.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/replicationLinks/{linkId}/failover?api-version=2023-08-01

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
databaseName	path	True	string	Nama database.
linkId	path	True	string	Nama tautan replikasi.
resourceGroupName	path	True	string	Nama grup sumber daya yang berisi sumber daya. Anda dapat memperoleh nilai ini dari API Azure Resource Manager atau portal.
serverName	path	True	string	Nama server.
subscriptionId	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	ReplicationLink	Berhasil gagal.
202 Accepted		Operasi failover sedang berlangsung. Header Location: string
Other Status Codes	ErrorResponse	Respons Kesalahan: *** 400 ReplicationLinksReplicationLinkNameIsInvalid - Nama tautan replikasi harus berupa guid yang valid. 400 GeoReplicationDatabaseNotSecondary - Operasi mengharapkan database menjadi target replikasi. 400 ReplicationLinksReplicationLinkTypeIsInvalid - LinkType tidak valid. Nilai yang valid adalah SIAGA dan GEO. 400 ReplicationLinksCreateIsNotSupported - Pembuatan Tautan Replikasi tidak didukung. 400 LedgerNoDropLink - Replikasi geografis tidak dapat dihentikan karena database mengaktifkan Unggahan Ledger Digest. Nonaktifkan Ledger Digest Uploads dan coba lagi operasi. 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 ManagedInstanceStoppingOrStopped - Operasi yang bertentangan dikirimkan saat instans dalam status berhenti/dihentikan 400 ManagedInstanceStarting - Operasi bertentangan yang dikirimkan saat instans dalam status mulai 400 InvalidServerName - Nama server yang ditentukan tidak valid. 400 GeoReplicationDatabaseNotSecondary - Operasi mengharapkan database menjadi target replikasi. 400 CannotUseTrailingWhitespacesInDatabaseName - Validasi nama database gagal. 400 IncorrectReplicationLinkState - Operasi mengharapkan database berada dalam status yang diharapkan pada tautan replikasi. 400 PlannedFailoverTimedOut - Pengguna memanggil failover yang direncanakan, dan waktunya habis saat mencoba menghubungi layanan manajemen mitra. 400 VBSEnclaveNotSupportedForGeoReplicationWithDefaultEnclave - Mengonfigurasi geo-replikasi tidak didukung untuk database menggunakan nilai yang berbeda dari properti preferredEnclaveType. Database '{0}' utama di server '{1}' menggunakan '{2}' preferredEnclaveType, sedangkan preferredEnclaveType yang ditentukan untuk database '{3}' sekunder pada server '{4}' adalah '{5}'. 400 VBSEnclaveNotSupportedForPlannedFailoverBetweenDatabasesWithDifferentPreferredEnclaveTypes - Failover terencana antara database primer dan sekunder dengan preferredEnclaveType yang berbeda tidak didukung untuk enklave keamanan berbasis Virtualisasi (VBS). 400 CannotUseReservedDatabaseName - Tidak dapat menggunakan nama database yang dipesan dalam operasi ini. 400 InvalidIdentifier - Pengidentifikasi berisi NULL atau karakter unicode yang tidak valid. 404 OperationIdNotFound - Operasi dengan Id tidak ada. 404 ResourceNotFound - Sumber daya yang diminta tidak ditemukan. 404 ServerNotInSubscriptionResourceGroup - Server yang ditentukan tidak ada di grup sumber daya dan langganan yang ditentukan. 404 SubscriptionDoesNotHaveServer - Server yang diminta tidak ditemukan 404 OperationIdNotFound - Operasi dengan Id tidak ada. 404 DatabaseDoesNotExist - Pengguna telah menentukan nama database yang tidak ada pada instans server ini. 409 CannotCancelOperation - Operasi manajemen dalam keadaan yang tidak dapat dibatalkan. 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 UpdateSloInProgress - Pengguna mencoba memulai operasi yang tidak kompatibel saat pembaruan SLO sedang berlangsung. 409 InvalidOperationForDatabaseNotInReplicationRelationship - Operasi replikasi dilakukan pada database yang tidak berada dalam hubungan replikasi. 409 ConflictingSystemOperationInProgress - Operasi pemeliharaan sistem sedang berlangsung pada database dan operasi lebih lanjut perlu menunggu hingga selesai. 409 DuplikatGeoDrRelation - Database sudah berada dalam relasi replikasi. Ini adalah permintaan duplikat. 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 ManagementServiceDatabaseBusy - Database '{0}' sibuk dengan operasi lain. Silakan coba operasi Anda nanti. 409 FailoverGroupAlreadySetup - Operasi tidak dapat dilakukan karena tautan replikasi geografis adalah bagian dari Grup Failover. Anda harus menghapus database dari grup untuk menghentikan atau failover satu per satu. 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. Silakan coba lagi operasi ini. 503 TooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia.

Nama

Jenis

Deskripsi

200 OK

ReplicationLink

Berhasil gagal.

202 Accepted

Operasi failover sedang berlangsung.

Header

Location: string

Other Status Codes

ErrorResponse

Respons Kesalahan: ***

400 ReplicationLinksReplicationLinkNameIsInvalid - Nama tautan replikasi harus berupa guid yang valid.
400 GeoReplicationDatabaseNotSecondary - Operasi mengharapkan database menjadi target replikasi.
400 ReplicationLinksReplicationLinkTypeIsInvalid - LinkType tidak valid. Nilai yang valid adalah SIAGA dan GEO.
400 ReplicationLinksCreateIsNotSupported - Pembuatan Tautan Replikasi tidak didukung.
400 LedgerNoDropLink - Replikasi geografis tidak dapat dihentikan karena database mengaktifkan Unggahan Ledger Digest. Nonaktifkan Ledger Digest Uploads dan coba lagi operasi.
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 ManagedInstanceStoppingOrStopped - Operasi yang bertentangan dikirimkan saat instans dalam status berhenti/dihentikan
400 ManagedInstanceStarting - Operasi bertentangan yang dikirimkan saat instans dalam status mulai
400 InvalidServerName - Nama server yang ditentukan tidak valid.
400 GeoReplicationDatabaseNotSecondary - Operasi mengharapkan database menjadi target replikasi.
400 CannotUseTrailingWhitespacesInDatabaseName - Validasi nama database gagal.
400 IncorrectReplicationLinkState - Operasi mengharapkan database berada dalam status yang diharapkan pada tautan replikasi.
400 PlannedFailoverTimedOut - Pengguna memanggil failover yang direncanakan, dan waktunya habis saat mencoba menghubungi layanan manajemen mitra.
400 VBSEnclaveNotSupportedForGeoReplicationWithDefaultEnclave - Mengonfigurasi geo-replikasi tidak didukung untuk database menggunakan nilai yang berbeda dari properti preferredEnclaveType. Database '{0}' utama di server '{1}' menggunakan '{2}' preferredEnclaveType, sedangkan preferredEnclaveType yang ditentukan untuk database '{3}' sekunder pada server '{4}' adalah '{5}'.
400 VBSEnclaveNotSupportedForPlannedFailoverBetweenDatabasesWithDifferentPreferredEnclaveTypes - Failover terencana antara database primer dan sekunder dengan preferredEnclaveType yang berbeda tidak didukung untuk enklave keamanan berbasis Virtualisasi (VBS).
400 CannotUseReservedDatabaseName - Tidak dapat menggunakan nama database yang dipesan dalam operasi ini.
400 InvalidIdentifier - Pengidentifikasi berisi NULL atau karakter unicode yang tidak valid.
404 OperationIdNotFound - Operasi dengan Id tidak ada.
404 ResourceNotFound - Sumber daya yang diminta tidak ditemukan.
404 ServerNotInSubscriptionResourceGroup - Server yang ditentukan tidak ada di grup sumber daya dan langganan yang ditentukan.
404 SubscriptionDoesNotHaveServer - Server yang diminta tidak ditemukan
404 OperationIdNotFound - Operasi dengan Id tidak ada.
404 DatabaseDoesNotExist - Pengguna telah menentukan nama database yang tidak ada pada instans server ini.
409 CannotCancelOperation - Operasi manajemen dalam keadaan yang tidak dapat dibatalkan.
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 UpdateSloInProgress - Pengguna mencoba memulai operasi yang tidak kompatibel saat pembaruan SLO sedang berlangsung.
409 InvalidOperationForDatabaseNotInReplicationRelationship - Operasi replikasi dilakukan pada database yang tidak berada dalam hubungan replikasi.
409 ConflictingSystemOperationInProgress - Operasi pemeliharaan sistem sedang berlangsung pada database dan operasi lebih lanjut perlu menunggu hingga selesai.
409 DuplikatGeoDrRelation - Database sudah berada dalam relasi replikasi. Ini adalah permintaan duplikat.
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 ManagementServiceDatabaseBusy - Database '{0}' sibuk dengan operasi lain. Silakan coba operasi Anda nanti.
409 FailoverGroupAlreadySetup - Operasi tidak dapat dilakukan karena tautan replikasi geografis adalah bagian dari Grup Failover. Anda harus menghapus database dari grup untuk menghentikan atau failover satu per satu.
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. Silakan coba lagi operasi ini.
503 TooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia.

Contoh

Planned failover of a replication link

Permintaan sampel

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/sourcesvr/databases/gamma-db/replicationLinks/4891ca10-ebd0-47d7-9182-c722651780fb/failover?api-version=2023-08-01

Respon sampel

Kode status:: 200

{
  "properties": {
    "partnerServer": "testsvr",
    "partnerDatabase": "gamma-db",
    "partnerDatabaseId": "/subscriptions/00000000-1111-2222-3333-555555555555/resourceGroups/Second-Default/providers/Microsoft.Sql/servers/testsvr/databases/gamma-db",
    "partnerLocation": "Japan East",
    "role": "Primary",
    "partnerRole": "Secondary",
    "replicationMode": "ASYNC",
    "startTime": "2018-06-21T08:12:43.783Z",
    "percentComplete": 100,
    "replicationState": "CATCH_UP",
    "isTerminationAllowed": true,
    "linkType": "GEO"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/sourcesvr/databases/gamma-db/replicationLinks/4891ca10-ebd0-47d7-9182-c722651780fb",
  "name": "4891ca10-ebd0-47d7-9182-c722651780fb"
}

Kode status:: 202

Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/JapanWest/replicationLinksOperationResults/replicationlink-group-test-3?api-version=2022-05-01-preview

Definisi

Nama	Deskripsi
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Respons kesalahan
ReplicationLink	Tautan replikasi.
ReplicationLinkType	Jenis tautan (GEO, NAMED, STANDBY). Operasi pembaruan tidak mendukung NAMED.
ReplicationRole	Peran replikasi lokal.
ReplicationState	Status replikasi (PENDING, SEEDING, CATCHUP, SUSPENDED).

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorResponse

Objek

Respons kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

ReplicationLink

Objek

Tautan replikasi.

Nama	Jenis	Deskripsi
id	string	ID Sumber Daya.
name	string	Nama sumber daya.
properties.isTerminationAllowed	boolean	Apakah pengguna saat ini diizinkan untuk mengakhiri tautan.
properties.linkType	ReplicationLinkType	Jenis tautan (GEO, NAMED, STANDBY). Operasi pembaruan tidak mendukung NAMED.
properties.partnerDatabase	string	Database mitra sumber daya.
properties.partnerDatabaseId	string	Id database mitra sumber daya.
properties.partnerLocation	string	Lokasi mitra sumber daya.
properties.partnerRole	ReplicationRole	Peran replikasi mitra.
properties.partnerServer	string	Server mitra sumber daya.
properties.percentComplete	integer (int32)	Persentase penyelesaian penyelesaian penyemaian untuk tautan.
properties.replicationMode	string	Mode replikasi.
properties.replicationState	ReplicationState	Status replikasi (PENDING, SEEDING, CATCHUP, SUSPENDED).
properties.role	ReplicationRole	Peran replikasi lokal.
properties.startTime	string (date-time)	Waktu saat tautan dibuat.
type	string	Jenis sumber daya.

ReplicationLinkType

Enumerasi

Jenis tautan (GEO, NAMED, STANDBY). Operasi pembaruan tidak mendukung NAMED.

Nilai	Deskripsi
GEO
NAMED
STANDBY

ReplicationRole

Enumerasi

Peran replikasi lokal.

Nilai	Deskripsi
Primary
Secondary
NonReadableSecondary
Source
Copy

ReplicationState

Enumerasi

Status replikasi (PENDING, SEEDING, CATCHUP, SUSPENDED).

Nilai	Deskripsi
PENDING
SEEDING
CATCH_UP
SUSPENDED

Bagikan melalui

Replication Links - Failover

Parameter URI

Respons

Contoh

Planned failover of a replication link

Permintaan sampel

Respon sampel

Definisi

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ReplicationLink

ReplicationLinkType

ReplicationRole

ReplicationState