Aracılığıyla paylaş

Databases - Failover

Hizmet:
SQL Database
API Sürümü:
2023-08-01

Veritabanının yük devretmesi.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/failover?api-version=2023-08-01
İsteğe bağlı parametrelerle: 
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/failover?replicaType={replicaType}&api-version=2023-08-01

URI Parametreleri

Name İçinde Gerekli Tür Description
databaseName
 path True

string

Yük devretme için veritabanının adı.
resourceGroupName
 path True

string

Kaynağı içeren kaynak grubunun adı. Bu değeri Azure Resource Manager API'sinden veya portaldan alabilirsiniz.
serverName
 path True

string

Sunucunun adı.
subscriptionId
 path True

string

Azure aboneliğini tanımlayan abonelik kimliği.
api-version
 query True

string

İstek için kullanılacak API sürümü.
replicaType
 query

ReplicaType

Yük devredilecek çoğaltma türü.

Yanıtlar

Name Tür Description
200 OK

Veritabanı yük devretmesi başarıyla tamamlandı.
202 Accepted

Veritabanı yük devretme işlemi devam ediyor.

Üst Bilgiler

Location: string
Other Status Codes

ErrorResponse

Hata Yanıtları: ***

  • 400 DatabaseFailoverNotSupportedOnSKU - Müşteri tarafından başlatılan bu yük devretme türü verilen SKU'da desteklenmez.

  • 400 DatabaseFailoverThrottled - Veritabanı bir elastik havuza aitse veritabanında veya havuzda yeni bir yük devretme oldu.

  • 400 ManagementServiceFeatureDisabled - Kullanıcı devre dışı bırakılmış bir özelliği kullanmaya çalıştı.

  • 404 OperationIdNotFound - Kimliği olan işlem yok.

  • 409 DatabaseNotInStateToFailover - Veritabanı şu anda yük devretmenin yapılamayacağı bir durumda.

  • 409 ManagementServiceDatabaseBusy - '{0}' veritabanı başka bir işlemle meşgul. Lütfen işleminizi daha sonra deneyin.

  • 409 CannotCancelOperation - Yönetim işlemi iptal edilemeyen bir durumda.

  • 409 OperationCancelled - İşlem kullanıcı tarafından iptal edildi.

  • 409 İşlem Kesildi - Kaynak üzerindeki işlem, aynı kaynak üzerindeki başka bir işlem tarafından kesildiği için tamamlanamadı.

  • 429 SubscriptionTooManyCreateUpdateRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteğin ötesindeki istekler.

  • 429 SubscriptionTooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteğin ötesindeki istekler.

  • 500 OperationTimedOut - İşlem zaman aşımına uğradı ve otomatik olarak geri alındı. Lütfen işlemi yeniden deneyin.

  • 503 TooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteğin ötesindeki istekler.

Örnekler

Failover an database

Örnek isteği

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

Örnek yanıt

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

Tanımlar

Name Description
ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.
ErrorDetail

Hata ayrıntısı.
ErrorResponse

Hata yanıtı
ReplicaType

Yük devredilecek çoğaltma türü.

ErrorAdditionalInfo

Nesne

Kaynak yönetimi hatası ek bilgileri.

Name Tür Description
info

object

Ek bilgiler.
type

string

Ek bilgi türü.

ErrorDetail

Nesne

Hata ayrıntısı.

Name Tür Description
additionalInfo

ErrorAdditionalInfo[]

Hata ek bilgileri.
code

string

Hata kodu.
details

ErrorDetail[]

Hata ayrıntıları.
message

string

Hata iletisi.
target

string

Hata hedefi.

ErrorResponse

Nesne

Hata yanıtı

Name Tür Description
error

ErrorDetail

Hata nesnesi.

ReplicaType

Numaralandırma

Yük devredilecek çoğaltma türü.

Değer Description
Primary
ReadableSecondary