Bagikan melalui

Databases - Failover

  • Referensi
Layanan:
SQL Database
Versi API:
2023-08-01

Failover database.

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

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
databaseName
 path True

string

Nama database yang akan di-failover.
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.
replicaType
 query

ReplicaType

Jenis replika yang akan di-failover.

Respons

Nama Jenis Deskripsi
200 OK

Berhasil menyelesaikan failover database.
202 Accepted

Kegagalan database sedang berlangsung.

Header

Location: string
Other Status Codes

ErrorResponse

Respons Kesalahan: ***

  • 400 DatabaseFailoverNotSupportedOnSKU - Jenis failover yang dimulai pelanggan ini tidak didukung pada SKU yang diberikan.

  • 400 DatabaseFailoverThrottled - Ada failover terbaru pada database atau kumpulan jika database berada dalam kumpulan elastis.

  • 400 ManagementServiceFeatureDisabled - Pengguna mencoba menggunakan fitur yang dinonaktifkan.

  • 404 OperationIdNotFound - Operasi dengan Id tidak ada.

  • 409 DatabaseNotInStateToFailover - Database saat ini dalam keadaan sedih sehingga failover tidak dapat dikeluarkan.

  • 409 ManagementServiceDatabaseBusy - Database '{0}' sibuk dengan operasi lain. Silakan coba operasi Anda nanti.

  • 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.

  • 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

Failover an database

Permintaan sampel

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/testServer/databases/testDatabase/failover?replicaType=Primary&api-version=2023-08-01

Respon sampel

Kode status:
200
Kode status:
202 
Location: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/group1/providers/Microsoft.Sql/locations/japaneast/databaseOperationResults/00000000-0000-0000-0000-000000000000

Definisi

Nama Deskripsi
ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.
ErrorDetail

Detail kesalahan.
ErrorResponse

Respons kesalahan
ReplicaType

Jenis replika yang akan di-failover.

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.

ReplicaType

Enumeration

Jenis replika yang akan di-failover.

Nilai Deskripsi
Primary
ReadableSecondary