Replication Links - Failover

Service:

SQL Database

API Version:

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}/databases/{databaseName}/replicationLinks/{linkId}/failover?api-version=2021-11-01

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
databaseName	path	True	string	Veritabanının adı.
linkId	path	True	string	Çoğaltma bağlantısı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ü.

Yanıtlar

Name	Tür	Description
200 OK	ReplicationLink	Yük başarıyla devredildi.
202 Accepted		Yük devretme işlemi devam ediyor.
Other Status Codes		Hata Yanıtları: ** 400 ReplicationLinksReplicationLinkNameIsInvalid - Çoğaltma bağlantı adı geçerli bir guid olmalıdır. 400 GeoReplicationDatabaseNotSecondary - İşlem veritabanının çoğaltma hedefi olmasını bekler. 400 LedgerNoDropLink - Veritabanında Genel Muhasebe Özet Yüklemeleri etkinleştirildiğinden coğrafi çoğaltma durdurulamıyor. Genel Muhasebe Özet Yüklemelerini devre dışı bırakın ve işlemi yeniden deneyin. 400 CannotUseTrailingWhitespacesInDatabaseName - Veritabanı adı doğrulaması başarısız oldu. 400 GeoReplicationDatabaseNotSecondary - İşlem veritabanının çoğaltma hedefi olmasını bekler. 400 CannotUseReservedDatabaseName - Bu işlemde ayrılmış veritabanı adı kullanılamaz. 400 InvalidServerName - Geçersiz sunucu adı belirtildi. 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 InvalidIdentifier - Tanımlayıcı NULL veya geçersiz bir unicode karakter içeriyor. 400 IncorrectReplicationLinkState - İşlem, veritabanının çoğaltma bağlantısında beklenen bir durumda olmasını bekler. 404 OperationIdNotFound - Kimliği olan işlem yok. 404 ResourceNotFound - İstenen kaynak bulunamadı. 404 SubscriptionDoesNotHaveServer - İstenen sunucu bulunamadı 404 ServerNotInSubscriptionResourceGroup - Belirtilen sunucu belirtilen kaynak grubunda ve abonelikte yok. 404 OperationIdNotFound - Kimliği olan işlem yok. 404 DatabaseDoesNotExist - Kullanıcı bu sunucu örneğinde bulunmayan bir veritabanı adı belirtti. 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 InvalidOperationForDatabaseNotInReplicationRelationship - Zaten çoğaltma ilişkisinde olan bir veritabanında çoğaltma çekirdek oluşturma işlemi gerçekleştirildi. 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 DuplicateGeoDrRelation - Veritabanları zaten bir çoğaltma ilişkisinde. Bu yinelenen bir istektir. 409 UpdateSloInProgress - Kullanıcı, bir SLO güncelleştirmesi devam ederken uyumsuz bir işlem başlatmaya çalıştı. 409 ManagementServiceDatabaseBusy - '{0}' veritabanı başka bir işlemle meşgul. Lütfen işleminizi daha sonra deneyin. 409 ConflictingSystemOperationInProgress - Veritabanında bir sistem bakım işlemi devam ediyor ve diğer işlemlerin tamamlanana kadar beklemesi gerekiyor. 409 FailoverGroupAlreadySetup - Coğrafi çoğaltma bağlantısı bir Yük Devretme Grubunun parçası olduğundan işlem gerçekleştirilemiyor. Veritabanını tek tek sonlandırmak veya yük devretmek için gruptan kaldırmanız gerekir. 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.

Örnekler

Planned failover of a replication link

Sample Request

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

Java

import com.azure.core.util.Context;

/** Samples for ReplicationLinks Failover. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ReplicationLinkFailover.json
     */
    /**
     * Sample code: Planned failover of a replication link.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void plannedFailoverOfAReplicationLink(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getReplicationLinks().failover("Default", "sourcesvr", "gamma-db",
            "4891ca10-ebd0-47d7-9182-c722651780fb", Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

{
  "properties": {
    "partnerServer": "testsvr",
    "partnerDatabase": "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"
}

Status code:

202

Tanımlar

Name	Description
ReplicationLink	Çoğaltma bağlantısı.
ReplicationLinkType	Bağlantı türü (GEO, NAMED, STANDBY).
ReplicationRole	Yerel çoğaltma rolü.
ReplicationState	Çoğaltma durumu (BEKLEMEDE, ÇEKIRDEK OLUŞTURMA, YAKALAMA, ASKıDA).

ReplicationLink

Çoğaltma bağlantısı.

Name	Tür	Description
id	string	Kaynak Kimliği.
name	string	Kaynak adı.
properties.isTerminationAllowed	boolean	Kullanıcının şu anda bağlantıyı sonlandırmasına izin verilip verilmeyeceği.
properties.linkType	ReplicationLinkType	Bağlantı türü (GEO, NAMED, STANDBY).
properties.partnerDatabase	string	Kaynak iş ortağı veritabanı.
properties.partnerLocation	string	Kaynak iş ortağı konumu.
properties.partnerRole	ReplicationRole	İş ortağı çoğaltma rolü.
properties.partnerServer	string	Kaynak iş ortağı sunucusu.
properties.percentComplete	integer	Bağlantı için tamamlanma yüzdesinin dağıtılması.
properties.replicationMode	string	Çoğaltma modu.
properties.replicationState	ReplicationState	Çoğaltma durumu (BEKLEMEDE, ÇEKIRDEK OLUŞTURMA, YAKALAMA, ASKıDA).
properties.role	ReplicationRole	Yerel çoğaltma rolü.
properties.startTime	string	Bağlantının oluşturulduğu saat.
type	string	Kaynak türü.

ReplicationLinkType

Bağlantı türü (GEO, NAMED, STANDBY).

Name	Tür	Description
GEO	string
NAMED	string
STANDBY	string

ReplicationRole

Yerel çoğaltma rolü.

Name	Tür	Description
Copy	string
NonReadableSecondary	string
Primary	string
Secondary	string
Source	string

ReplicationState

Çoğaltma durumu (BEKLEMEDE, ÇEKIRDEK OLUŞTURMA, YAKALAMA, ASKıDA).

Name	Tür	Description
CATCH_UP	string
PENDING	string
SEEDING	string
SUSPENDED	string