Replication Links - Failover Allow Data Loss

Service:

SQL Database

API Version:

2021-11-01

Failover dari server utama saat ini ke server ini yang memungkinkan kehilangan data.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/replicationLinks/{linkId}/forceFailoverAllowDataLoss?api-version=2021-11-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 Azure Resource Manager API 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 digunakan untuk permintaan.

Respons

Nama	Jenis	Deskripsi
200 OK	ReplicationLink	Berhasil di-failover.
202 Accepted		Operasi failover sedang berlangsung.
Other Status Codes		Respons Kesalahan: *** 400 ReplicationLinksReplicationLinkNameIsInvalid - Nama tautan replikasi harus berupa guid yang valid. 400 GeoReplicationDatabaseNotSecondary - Operasi mengharapkan database menjadi target replikasi. 400 LedgerNoDropLink - Replikasi geografis tidak dapat dihentikan karena database mengaktifkan Unggahan Hash Ledger. Nonaktifkan Ledger Digest Uploads dan coba lagi operasi. 400 CannotUseTrailingWhitespacesInDatabaseName - Validasi nama database gagal. 400 GeoReplicationDatabaseNotSecondary - Operasi mengharapkan database menjadi target replikasi. 400 CannotUseReservedDatabaseName - Tidak dapat menggunakan nama database yang dipesan dalam operasi ini. 400 InvalidServerName - Nama server yang ditentukan tidak valid. 400 PlannedFailoverTimedOut - Pengguna memanggil penyelamatan kegagalan yang terjadwal, dan waktunya habis saat mencoba menghubungi layanan manajemen mitra. 400 InvalidIdentifier - Pengidentifikasi berisi NULL atau karakter unicode yang tidak valid. 400 IncorrectReplicationLinkState - Operasi mengharapkan database berada dalam status yang diharapkan pada tautan replikasi. 404 OperationIdNotFound - Operasi dengan Id tidak ada. 404 ResourceNotFound - Sumber daya yang diminta tidak ditemukan. 404 SubscriptionDoesNotHaveServer - Server yang diminta tidak ditemukan 404 ServerNotInSubscriptionResourceGroup - Server yang ditentukan tidak ada di grup sumber daya dan langganan yang ditentukan. 404 OperationIdNotFound - Operasi dengan Id tidak ada. 404 DatabaseDoesNotExist - Pengguna telah menentukan nama database yang tidak ada pada instans server ini. 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 InvalidOperationForDatabaseNotInReplicationRelationship - Operasi seeding replikasi dilakukan pada database yang sudah berada dalam hubungan replikasi. 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 memasuki peran utama. 409 DuplikatGeoDrRelation - Database sudah berada dalam hubungan replikasi. Ini adalah permintaan duplikat. 409 UpdateSloInProgress - Pengguna mencoba memulai operasi yang tidak kompatibel saat pembaruan SLO sedang berlangsung. 409 ManagementServiceDatabaseBusy - Database '{0}' sibuk dengan operasi lain. Silakan coba operasi Anda nanti. 409 ConflictingSystemOperationInProgress - Operasi pemeliharaan sistem sedang berlangsung pada database dan operasi lebih lanjut perlu menunggu hingga selesai. 409 FailoverGroupAlreadySetup - Operasi tidak dapat dilakukan karena tautan replikasi geografis adalah bagian dari Grup Failover. Anda harus menghapus database dari grup untuk mengakhiri atau melakukan failover secara individual. 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

Forced 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/forceFailoverAllowDataLoss?api-version=2021-11-01

Java

import com.azure.core.util.Context;

/** Samples for ReplicationLinks FailoverAllowDataLoss. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ReplicationLinkFailoverAllowDataLoss.
     * json
     */
    /**
     * Sample code: Forced failover of a replication link.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void forcedFailoverOfAReplicationLink(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getReplicationLinks().failoverAllowDataLoss("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

Definisi

Nama	Deskripsi
ReplicationLink	Tautan replikasi.
ReplicationLinkType	Jenis tautan (GEO, NAMED, STANDBY).
ReplicationRole	Peran replikasi lokal.
ReplicationState	Status replikasi (TERTUNDA, PENYEMAIAN, CATCHUP, SUSPENDED).

ReplicationLink

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).
properties.partnerDatabase	string	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	Persentase penyelesaian penyelesaian penyemaian untuk tautan.
properties.replicationMode	string	Mode replikasi.
properties.replicationState	ReplicationState	Status replikasi (TERTUNDA, PENYEMAIAN, CATCHUP, SUSPENDED).
properties.role	ReplicationRole	Peran replikasi lokal.
properties.startTime	string	Waktu saat tautan dibuat.
type	string	Jenis sumber daya

ReplicationLinkType

Jenis tautan (GEO, NAMED, STANDBY).

Nama	Jenis	Deskripsi
GEO	string
NAMED	string
STANDBY	string

ReplicationRole

Peran replikasi lokal.

Nama	Jenis	Deskripsi
Copy	string
NonReadableSecondary	string
Primary	string
Secondary	string
Source	string

ReplicationState

Status replikasi (TERTUNDA, PENYEMAIAN, CATCHUP, SUSPENDED).

Nama	Jenis	Deskripsi
CATCH_UP	string
PENDING	string
SEEDING	string
SUSPENDED	string