Aracılığıyla paylaş

Failover Groups - Failover

  • Başvuru
Hizmet:
SQL Database
API Sürümü:
2021-11-01

Geçerli birincil sunucudan bu sunucuya yük devreder.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/failoverGroups/{failoverGroupName}/failover?api-version=2021-11-01

URI Parametreleri

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

string

Yük devretme grubunun 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

Yük devretme grubunu içeren 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ü.

Yanıtlar

Name Tür Description
200 OK

FailoverGroup

Yük başarıyla devredildi.
202 Accepted

Kabul edildi
Other Status Codes

Hata Yanıtları: **

  • 400 FailoverGroupCreateOrUpdateRequestInvalidDatabases - Sağlanan veritabanı kimlikleri veritabanı kaynak kimlikleri düzgün oluşturulmuyor. Düzgün biçimlendirme örneği için bkz. https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate

  • 400 FailoverGroupCreateOrUpdateRequestInvalidPartner - Yük devretme grubu oluşturma veya güncelleştirme istek gövdesindeki verilen iş ortakları alanı boş veya geçersiz. Lütfen bu alanın geçerli bir değerini belirtin. Düzgün biçimlendirilmiş istek örnekleri için bkz. https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate

  • 400 FailoverGroupCreateOrUpdateRequestDuplicatePartner - Sağlanan iş ortağı sunucularından biri veya daha fazlası zaten yük devretme grubunun bir parçası. Birincil sunucunun ve verilen tüm iş ortağı sunucularının benzersiz olduğundan emin olun.

  • 400 FailoverGroupCreateOrUpdateRequestInvalidDatabaseServer - Sağlanan veritabanlarından biri veya daha fazlası yük devretme grubunun birincil sunucusunda yok. Lütfen tüm veritabanlarının birincil sunucuda bulunduğundan emin olun.

  • 400 FailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount - Yük Devretme Grubu için yalnızca bir iş ortağı sunucusu desteklenir. Lütfen isteğinizi uygun şekilde değiştirin. Geçerli istek örnekleri için bkz. https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate

  • 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint - Oluşturma veya güncelleştirme istekleri için readWriteEndpoint alanı gereklidir.

  • 400 FailoverGroupCreateOrUpdateRequestInvalid - Yük devretme grubu oluşturma veya güncelleştirme istek gövdesi boş veya geçersiz.

  • 400 FailoverGroupUpdateOrDeleteRequestOnSecondary - İkincil sunucuda yük devretme grubunda değişikliklere izin verilmez. İsteği birincil sunucuda yürütür.

  • 400 FailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues - Okuma-yazma uç noktası için yetkisiz kullanım süresi değeri negatif olmamalıdır.

  • 400 FailoverGroupCreateOrUpdateRequestLessThanMinimumGracePeriodValues - Yük devretme grubu için yetkisiz kullanım süresi değeri '{0}' dakika en düşük yetkisiz kullanım süresinden büyük veya buna eşit olmalıdır

  • 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields - Okuma-yazma uç noktası için otomatik yük devretme ilkesi seçildiğinde failoverWithDataLossGracePeriodMinutes özelliği sağlanmalıdır.

  • 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteFailoverPolicy - Oluşturma veya güncelleştirme istekleri için okuma-yazma uç noktasının failoverPolicy alanı gereklidir.

  • 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy - Okuma-yazma uç noktası için el ile yük devretme ilkesi seçildiğinde yetkisiz kullanım süresi değeri sağlanmamalıdır. Lütfen istekten kaldırın.

  • 400 FailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified - Yük devretme grubu oluşturma veya güncelleştirme istek gövdesi'{0}' salt okunur özelliğini değiştirmemelidir.

  • 400 FailoverGroupFailoverRequestOnPrimary - Yük devretme isteği yük devretme grubunun ikincil sunucusunda başlatılmalıdır.

  • 400 FailoverGroupPartnerServerFromDifferentSubscription - Birincil sunucu ve yük devretme grubunun iş ortağı sunucuları farklı aboneliklerdendir. Yük devretme grubu sunucuları için çapraz aboneliğe izin verilmez.

  • 400 InvalidAddSecondaryPermission - Kullanıcının belirtilen sunucuya ikincil eklemek için yeterli izni yok.

  • 400 InvalidSku - Kullanıcı geçersiz bir sku belirtti.

  • 400 ServerNotFound - İstenen sunucu bulunamadı.

  • 400 FeatureDisabledOnSelectedEdition - Kullanıcı geçerli veritabanı sürümünde devre dışı bırakılmış bir özelliği kullanmaya çalıştı.

  • 400 TokenTooLong - Sağlanan belirteç çok uzun.

  • 400 InvalidTargetSubregion - Okunamayan bir ikincil sunucunun hedef sunucusu DR ile eşleştirilmiş bir Azure bölgesinde değil.

  • 400 PartnerServerNotCompatible - Kullanıcı SAWA V1 sunucusundan Sterling sunucusuna veritabanı kopyalamaya çalışıyor veya tam tersi.

  • 400 IncorrectReplicationLinkState - İşlem, veritabanının çoğaltma bağlantısında beklenen bir durumda olmasını bekler.

  • 400 ResourcePoolNotFound - Belirtilen elastik havuz belirtilen mantıksal sunucuda yok.

  • 400 AzureKeyVaultKeyDisabled - Azure Key Vault anahtarı devre dışı bırakıldığından sunucuda işlem tamamlanamadı.

  • 400 AzureKeyVaultInvalidExpirationDate - Azure Key Vault anahtarı son kullanma tarihi geçersiz olduğundan işlem tamamlanamadı.

  • 400 SecurityAzureKeyVaultUrlNullOrEmpty - Azure Key Vault Uri null veya boş olduğundan işlem tamamlanamadı.

  • 400 AzureKeyVaultNoServerIdentity - Sunucu kimliği doğru yapılandırılmamış.

  • 400 AzureKeyVaultInvalidUri - Azure Key Vault geçersiz bir yanıt. Lütfen geçerli bir Azure Key Vault URI'si kullanın.

  • 400 AzureKeyVaultMissingPermissions - Sunucuda Azure Key Vault gerekli izinler eksik.

  • 400 SecurityAzureKeyVaultInvalidKeyName - Geçersiz bir Sunucu Anahtarı adı nedeniyle işlem tamamlanamadı.

  • 400 PlannedFailoverTimedOutForDatabase - Kullanıcı planlı yük devretme çağrıldı, zaman aşımına uğradı ve belirli bir veritabanı suçlanıyor gibi görünüyor.

  • 400 PlannedFailoverTimedOut - Kullanıcı planlı yük devretme'yi çağırmış ve iş ortağı yönetim hizmetiyle iletişim kurmaya çalışırken zaman aşımına uğradı.

  • 400 AdalGenericError - Azure Active Directory hatasıyla karşılaşıldığından işlem tamamlanamadı.

  • 400 AdalServicePrincipalNotFound - Azure Active Directory kitaplığı Hizmet Sorumlusu bulunamadı hatasıyla karşılaşıldığından işlem tamamlanamadı.

  • 400 AzureKeyVaultMalformedVaultUri - Sağlanan Key Vault uri geçerli değil.

  • 400 CannotUseReservedDatabaseName - Bu işlemde ayrılmış veritabanı adı kullanılamaz.

  • 400 InvalidFailoverGroupRegion - Bir Yük Devretme Grubunda belirtilen sunucuların yalıtım sağlamak için farklı bölgelerde bulunması gerekir.

  • 400 FailoverGroupDoesNotExist - Yük devretme grubu sunucuda yok.

  • 400 FailoverGroupNotSecondary - Yük Devretme Grubundaki birincil sunucudan yük devretme başlatılamaz.

  • 400 InvalidServerName - Geçersiz sunucu adı belirtildi.

  • 400 DatabaseInFailoverGroupNotPrimary - Veritabanının GeoDR bağlantısı zaten var, ancak rolü 'Birincil' değil veya sürekli kopyalama bağlantısı değil.

  • 400 SecurityAdalPrincipalCertExpiredError - Azure Key Vault asıl sertifikasının süresi dolduğundan işlem tamamlanamadı.

  • 400 UnableToCreateFailoverGroupDueToTableAuditing - Tablo denetiminin açık olduğu sunucu için Yük Devretme Grubu oluşturulamıyor.

  • 400 InvalidIdentifier - Tanımlayıcı NULL veya geçersiz bir unicode karakter içeriyor.

  • 400 UnableToAddDbWithTableAuditingToFailoverGroup - Tablo Denetimi etkinleştirilmiş veritabanı, Yük Devretme Grubu uç noktası üzerinden erişilemez.

  • 400 SecurityInvalidAzureKeyVaultRecoveryLevel - Sağlanan Key Vault uri geçerli değil.

  • 400 KeyMaterialNotFoundOnRemoteServer - Uzak sunucunun TDE koruyucusu olarak kullanılan anahtar malzemeye erişimi yok.

  • 400 LimitOfFailoverGroupsPerServerExceeded - Yeni Yük Devretme Grubu oluşturmak sunucu başına izin verilen Yük Devretme Grubu sayısını aşacaktır.

  • 400 SameKeyUriNotFoundOnRemoteServer - İkincil sunucu, birincil sunucunun şifreleme koruyucusuyla aynı anahtar kasasındaki anahtar malzemesine sahip değildir ve anahtar otomatik döndürme etkindir.

  • 400 AzureKeyVaultRsaKeyNotSupported - Sağlanan anahtar kasası desteklenmeyen RSA Anahtar Boyutu veya Anahtar Türü kullanıyor. Desteklenen RSA anahtar boyutu 2048 veya 3072, Anahtar Türü ise RSA veya RSA-HSM'dir.

  • 400 SameKeyMaterialNotFoundOnRemoteServer - İkincil sunucu birincil sunucunun şifreleme koruyucusunun anahtar malzemesine sahip değil.

  • 400 GeoReplicationDatabaseNotSecondary - İşlem veritabanının çoğaltma hedefi olmasını bekler.

  • 400 GeoReplicaLimitReached - Çoğaltma başına çoğaltma sınırına ulaşıldı.

  • 400 FailoverGroupWithVirtualNetworkRulesNotSupported - Otomatik yük devretme ilkesiyle yapılandırılmış yük devretme grupları şu anda sanal ağ güvenlik duvarı kurallarıyla yapılandırılmış sunucularda desteklenmemektedir. Lütfen yük devretme grubunu el ile yük devretme ilkesiyle yapılandırın.

  • 400 UnableToResolveRemoteServer - Uzak iş ortağı sunucu adı geçersiz bir sunucu adı veya DNS bağlantı sorunları nedeniyle çözümlenemedi.

  • 400 RemoteDatabaseCopyPermission - Kullanıcının belirtilen sunucuda veritabanı kopyası oluşturmak için yeterli izni yok.

  • 400 SecurityAzureKeyVaultGeoChainError - Azure Key Vault (BYOK) kullanarak Saydam Veri Şifrelemesi etkinleştirilirken ikincil (zincirleme olarak bilinen bir işlem) ikincil oluşturma desteklenmez.

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

  • 404 ResourceNotFound - İstenen kaynak bulunamadı.

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

  • 404 ServerNotInSubscriptionResourceGroup - Belirtilen sunucu belirtilen kaynak grubunda ve abonelikte yok.

  • 404 ServerNotInSubscription - Belirtilen sunucu belirtilen abonelikte yok.

  • 404 SourceDatabaseNotFound - Kaynak veritabanı yok.

  • 405 UnsupportedReplicationOperation - Veritabanında desteklenmeyen bir çoğaltma işlemi başlatıldı.

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

  • 409 İşlem Kesildi - Aynı kaynakta başka bir işlem tarafından kesintiye uğradığından kaynak üzerindeki işlem tamamlanamadı.

  • 409 ConflictingServerOperation - Sunucu için şu anda bir işlem devam ediyor.

  • 409 SubscriptionDisabled - Abonelik devre dışı bırakıldı.

  • 409 ConflictingSystemOperationInProgress - Veritabanında bir sistem bakım işlemi devam ediyor ve diğer işlemlerin tamamlanana kadar beklemesi gerekiyor.

  • 409 GeoReplicationCannotBecomePrimaryDuringUndo - İkincil fiziksel olarak tutarlı olmayabileceği ve bu nedenle birincil rolü giremediği bir durumdayken kullanıcı bir coğrafi bağlantıyı yük devretmeye veya zorlamayla sonlandırmaya çalıştı.

  • 409 ServerKeyNameAlreadyExists - Sunucu anahtarı sunucuda zaten var.

  • 409 ServerKeyUriAlreadyExists - Sunucu anahtarı URI'si sunucuda zaten var.

  • 409 ServerKeyDoesNotExists - Sunucu anahtarı yok.

  • 409 UpdateSloInProgress - Kullanıcı, bir SLO güncelleştirmesi devam ederken uyumsuz bir işlem başlatmaya çalıştı.

  • 409 AzureKeyVaultKeyNameNotFound - Azure Key Vault Anahtarı adı mevcut olmadığından işlem tamamlanamadı.

  • 409 AzureKeyVaultKeyInUse - Anahtar şu anda sunucu tarafından kullanılıyor.

  • 409 FailoverGroupAlreadyExists - Belirli bir sunucuda yük devretme grubu zaten var. Lütfen farklı Bir Yük Devretme Grubu adı kullanın.

  • 409 FailoverGroupBusy - Yük Devretme Grubu başka bir işlemle meşgul.

  • 409 DatabaseBelongsToOtherFailoverGroup - Veritabanı başka bir Yük Devretme Grubuna aittir ve bunun bir parçası olarak düşünülemez.

  • 409 DatabaseBeingAddedToFailoverGroup - Veritabanı şu anda Yük Devretme Grubuna ekleniyor, müşterinin kaldırma işleminin bitmesini beklemesi gerekiyor.

  • 409 DatabaseBeingRemovedFromFailoverGroup - Veritabanı şu anda yük devretme grubundan kaldırılıyor, müşterinin ekleme işleminin bitmesini beklemesi gerekiyor.

  • 409 FailoverGroupDnsRecordInUse - İstenen uç nokta için yinelenen bir DNS kaydı var.

  • 409 InvalidFailoverGroupName - Geçersiz Yük Devretme Grubu adı sağlandı.

  • 409 InvalidOperationForDatabaseNotInReplicationRelationship - Zaten çoğaltma ilişkisinde olan bir veritabanında çoğaltma çekirdek oluşturma işlemi gerçekleştirildi.

  • 409 InvalidDatabaseStateForOperation - Veritabanında geçerli çoğaltma durumunda işleme izin verilmiyor.

  • 409 DuplicateGeoDrRelation - Veritabanları zaten bir çoğaltma ilişkisinde. Bu yinelenen bir istektir.

  • 409 RemoteDatabaseExists - Hedef veritabanı adı hedef sunucuda zaten var.

  • 429 SubscriptionTooManyCreateUpdateRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum istekler dışında istekler.

  • 429 SubscriptionTooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum istekler dışında istekler.

  • 429 SubscriptionTooManyCreateUpdateRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum istekler dışında istekler.

  • 429 SubscriptionTooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum istekler dışında 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.

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

  • 503 AzureKeyVaultConnectionFailed - Azure Key Vault bağlanma girişimleri başarısız olduğundan sunucuda işlem tamamlanamadı

  • 503 AzureKeyVaultGenericConnectionError - Key Vault bilgileri alınmaya çalışılırken bir hatayla karşılaşıldığından işlem tamamlanamadı.

  • 503 DatabaseUnavailable - Veritabanı kullanılamadığından işlem başarısız oldu.

  • 504 RequestTimeout - Hizmet isteği izin verilen zaman aşımını aştı.

Örnekler

Planned failover of a failover group

Örnek isteği

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server/failoverGroups/failover-group-test-3/failover?api-version=2021-11-01

Örnek yanıt

Durum kodu:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server/failoverGroups/failover-group-test-3",
  "name": "failover-group-test-3",
  "type": "Microsoft.Sql/servers/failoverGroups",
  "location": "Japan West",
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 120
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Disabled"
    },
    "replicationRole": "Primary",
    "replicationState": "CATCH_UP",
    "partnerServers": [
      {
        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server",
        "location": "Japan East",
        "replicationRole": "Secondary"
      }
    ],
    "databases": [
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server/databases/testdb-1",
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server/databases/testdb-2"
    ]
  }
}
Durum kodu:
202

Tanımlar

Name Description
FailoverGroup

Yük devretme grubu.
FailoverGroupReadOnlyEndpoint

Yük devretme grubu örneğinin salt okunur uç noktası.
FailoverGroupReadWriteEndpoint

Yük devretme grubu örneğinin okuma-yazma uç noktası.
FailoverGroupReplicationRole

Yük devretme grubu örneğinin yerel çoğaltma rolü.
PartnerInfo

Yük devretme grubu için iş ortağı sunucu bilgileri.
ReadOnlyEndpointFailoverPolicy

Yük devretme grubu için salt okunur uç noktanın yük devretme ilkesi.
ReadWriteEndpointFailoverPolicy

Yük devretme grubu için okuma-yazma uç noktasının yük devretme ilkesi. failoverPolicy Otomatik ise failoverWithDataLossGracePeriodMinutes gereklidir.

FailoverGroup

Yük devretme grubu.

Name Tür Description
id

string

Kaynak Kimliği.
location

string

Kaynak konumu.
name

string

Kaynak adı.
properties.databases

string[]

Yük devretme grubundaki veritabanlarının listesi.
properties.partnerServers

PartnerInfo[]

Yük devretme grubu için iş ortağı sunucu bilgilerinin listesi.
properties.readOnlyEndpoint

FailoverGroupReadOnlyEndpoint

Yük devretme grubu örneğinin salt okunur uç noktası.
properties.readWriteEndpoint

FailoverGroupReadWriteEndpoint

Yük devretme grubu örneğinin okuma-yazma uç noktası.
properties.replicationRole

FailoverGroupReplicationRole

Yük devretme grubu örneğinin yerel çoğaltma rolü.
properties.replicationState

string

Yük devretme grubu örneğinin çoğaltma durumu.
tags

object

Kaynak etiketleri.
type

string

Kaynak türü.

FailoverGroupReadOnlyEndpoint

Yük devretme grubu örneğinin salt okunur uç noktası.

Name Tür Description
failoverPolicy

ReadOnlyEndpointFailoverPolicy

Yük devretme grubu için salt okunur uç noktanın yük devretme ilkesi.

FailoverGroupReadWriteEndpoint

Yük devretme grubu örneğinin okuma-yazma uç noktası.

Name Tür Description
failoverPolicy

ReadWriteEndpointFailoverPolicy

Yük devretme grubu için okuma-yazma uç noktasının yük devretme ilkesi. failoverPolicy Otomatik ise failoverWithDataLossGracePeriodMinutes gereklidir.
failoverWithDataLossGracePeriodMinutes

integer

Okuma-yazma uç noktası için veri kaybıyla yük devretme denenmeden önce yetkisiz kullanım süresi. failoverPolicy Otomatik ise failoverWithDataLossGracePeriodMinutes gereklidir.

FailoverGroupReplicationRole

Yük devretme grubu örneğinin yerel çoğaltma rolü.

Name Tür Description
Primary

string

Secondary

string

PartnerInfo

Yük devretme grubu için iş ortağı sunucu bilgileri.

Name Tür Description
id

string

İş ortağı sunucusunun kaynak tanımlayıcısı.
location

string

İş ortağı sunucusunun coğrafi konumu.
replicationRole

FailoverGroupReplicationRole

İş ortağı sunucusunun çoğaltma rolü.

ReadOnlyEndpointFailoverPolicy

Yük devretme grubu için salt okunur uç noktanın yük devretme ilkesi.

Name Tür Description
Disabled

string

Enabled

string

ReadWriteEndpointFailoverPolicy

Yük devretme grubu için okuma-yazma uç noktasının yük devretme ilkesi. failoverPolicy Otomatik ise failoverWithDataLossGracePeriodMinutes gereklidir.

Name Tür Description
Automatic

string

Manual

string