Replication Links - Failover

リファレンス

サービス:: SQL Database

API バージョン:: 2021-11-01

現在のプライマリサーバーからこのサーバーにフェールオーバーします。

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 パラメーター

名前	/	必須	型	説明
databaseName	path	True	string	データベースの名前。
linkId	path	True	string	レプリケーションリンクの名前。
resourceGroupName	path	True	string	リソースが含まれているリソースグループの名前。この値は、Azure リソースマネージャー API またはポータルから取得できます。
serverName	path	True	string	サーバーの名前。
subscriptionId	path	True	string	Azure サブスクリプションを識別するサブスクリプション ID。
api-version	query	True	string	要求で使用する API のバージョン。

応答

名前	型	説明
200 OK	ReplicationLink	正常にフェールオーバーされました。
202 Accepted		フェールオーバー操作が進行中です。
Other Status Codes		エラー応答: *** 400 ReplicationLinksReplicationLinkNameIsInvalid - レプリケーションリンク名は有効な guid にする必要があります。 400 GeoReplicationDatabaseNotSecondary - この操作では、データベースがレプリケーションターゲットであることが想定されます。 400 LedgerNoDropLink - データベースで台帳ダイジェストアップロードが有効になっているため、geo レプリケーションを停止できません。台帳ダイジェストのアップロードを無効にして、操作を再試行します。 400 CannotUseTrailingWhitespacesInDatabaseName - データベース名の検証に失敗しました。 400 GeoReplicationDatabaseNotSecondary - この操作では、データベースがレプリケーションターゲットであることが想定されます。 400 CannotUseReservedDatabaseName - この操作では予約データベース名を使用できません。 400 InvalidServerName - 指定されたサーバー名が無効です。 400 PlannedFailoverTimedOut - ユーザーが計画フェールオーバー呼び出し、パートナー管理サービスに連絡しようとしたときにタイムアウトしました。 400 InvalidIdentifier - 識別子に NULL または無効な Unicode 文字が含まれています。 400 IncorrectReplicationLinkState - この操作では、データベースがレプリケーションリンクで予期された状態であることが想定されます。 404 OperationIdNotFound - Id を持つ操作が存在しません。 404 ResourceNotFound - 要求されたリソースが見つかりませんでした。 404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした 404 ServerNotInSubscriptionResourceGroup - 指定されたサーバーが、指定されたリソースグループとサブスクリプションに存在しません。 404 OperationIdNotFound - Id を持つ操作が存在しません。 404 DatabaseDoesNotExist - ユーザーがこのサーバーインスタンスに存在しないデータベース名を指定しました。 409 OperationCancelled - 操作がユーザーによって取り消されました。 409 OperationInterrupted - 同じリソースに対する別の操作によって中断されたため、リソースに対する操作を完了できませんでした。 409 InvalidOperationForDatabaseNotInReplicationRelationship - レプリケーションのシード処理操作が、既にレプリケーション関係にあるデータベースで実行されました。 409 GeoReplicationCannotBecomePrimaryDuringUndo - セカンダリが物理的に一貫性がないため、プライマリロールを入力できない状態にあるときに、geo リンクをフェールオーバーまたは強制終了しようとしました。 409 DuplicateGeoDrRelation - データベースは既にレプリケーション関係にあります。これは重複する要求です。 409 UpdateSloInProgress - SLO 更新の進行中に、ユーザーが互換性のない操作を開始しようとしました。 409 ManagementServiceDatabaseBusy - データベース '{0}' は別の操作でビジー状態です。後で操作を試してください。 409 ConflictingSystemOperationInProgress - データベースでシステムメンテナンス操作が進行中であり、完了するまでそれ以上の操作を待機する必要があります。 409 FailoverGroupAlreadySetup - geo レプリケーションリンクはフェールオーバーグループの一部であるため、操作を実行できません。個別に終了またはフェールオーバーするには、グループからデータベースを削除する必要があります。 429 SubscriptionTooManyCreateUpdateRequests - 使用可能なリソースによって処理できる最大要求数を超える要求。 429 SubscriptionTooManyRequests - 使用可能なリソースによって処理できる最大要求を超える要求。 500 OperationTimedOut - 操作がタイムアウトし、自動的にロールバックされました。操作をやり直してください。 503 TooManyRequests - 使用可能なリソースによって処理できる最大要求数を超える要求。

名前

型

説明

200 OK

ReplicationLink

正常にフェールオーバーされました。

202 Accepted

フェールオーバー操作が進行中です。

Other Status Codes

エラー応答: ***

400 ReplicationLinksReplicationLinkNameIsInvalid - レプリケーションリンク名は有効な guid にする必要があります。
400 GeoReplicationDatabaseNotSecondary - この操作では、データベースがレプリケーションターゲットであることが想定されます。
400 LedgerNoDropLink - データベースで台帳ダイジェストアップロードが有効になっているため、geo レプリケーションを停止できません。台帳ダイジェストのアップロードを無効にして、操作を再試行します。
400 CannotUseTrailingWhitespacesInDatabaseName - データベース名の検証に失敗しました。
400 GeoReplicationDatabaseNotSecondary - この操作では、データベースがレプリケーションターゲットであることが想定されます。
400 CannotUseReservedDatabaseName - この操作では予約データベース名を使用できません。
400 InvalidServerName - 指定されたサーバー名が無効です。
400 PlannedFailoverTimedOut - ユーザーが計画フェールオーバー呼び出し、パートナー管理サービスに連絡しようとしたときにタイムアウトしました。
400 InvalidIdentifier - 識別子に NULL または無効な Unicode 文字が含まれています。
400 IncorrectReplicationLinkState - この操作では、データベースがレプリケーションリンクで予期された状態であることが想定されます。
404 OperationIdNotFound - Id を持つ操作が存在しません。
404 ResourceNotFound - 要求されたリソースが見つかりませんでした。
404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした
404 ServerNotInSubscriptionResourceGroup - 指定されたサーバーが、指定されたリソースグループとサブスクリプションに存在しません。
404 OperationIdNotFound - Id を持つ操作が存在しません。
404 DatabaseDoesNotExist - ユーザーがこのサーバーインスタンスに存在しないデータベース名を指定しました。
409 OperationCancelled - 操作がユーザーによって取り消されました。
409 OperationInterrupted - 同じリソースに対する別の操作によって中断されたため、リソースに対する操作を完了できませんでした。
409 InvalidOperationForDatabaseNotInReplicationRelationship - レプリケーションのシード処理操作が、既にレプリケーション関係にあるデータベースで実行されました。
409 GeoReplicationCannotBecomePrimaryDuringUndo - セカンダリが物理的に一貫性がないため、プライマリロールを入力できない状態にあるときに、geo リンクをフェールオーバーまたは強制終了しようとしました。
409 DuplicateGeoDrRelation - データベースは既にレプリケーション関係にあります。これは重複する要求です。
409 UpdateSloInProgress - SLO 更新の進行中に、ユーザーが互換性のない操作を開始しようとしました。
409 ManagementServiceDatabaseBusy - データベース '{0}' は別の操作でビジー状態です。後で操作を試してください。
409 ConflictingSystemOperationInProgress - データベースでシステムメンテナンス操作が進行中であり、完了するまでそれ以上の操作を待機する必要があります。
409 FailoverGroupAlreadySetup - geo レプリケーションリンクはフェールオーバーグループの一部であるため、操作を実行できません。個別に終了またはフェールオーバーするには、グループからデータベースを削除する必要があります。
429 SubscriptionTooManyCreateUpdateRequests - 使用可能なリソースによって処理できる最大要求数を超える要求。
429 SubscriptionTooManyRequests - 使用可能なリソースによって処理できる最大要求を超える要求。
500 OperationTimedOut - 操作がタイムアウトし、自動的にロールバックされました。操作をやり直してください。
503 TooManyRequests - 使用可能なリソースによって処理できる最大要求数を超える要求。

例

Planned failover of a replication link

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


/**
 * 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", com.azure.core.util.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

応答のサンプル

状態コード:: 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"
}

状態コード:: 202

定義

名前	説明
ReplicationLink	レプリケーションリンク。
ReplicationLinkType	リンクの種類 (GEO、名前付き、スタンバイ)。
ReplicationRole	ローカルレプリケーションロール。
ReplicationState	レプリケーションの状態 (保留中、シード処理、キャッチアップ、中断)。

ReplicationLink

レプリケーションリンク。

名前	型	説明
id	string	リソースの ID
name	string	リソース名。
properties.isTerminationAllowed	boolean	ユーザーが現在、リンクの終了を許可されているかどうか。
properties.linkType	ReplicationLinkType	リンクの種類 (GEO、名前付き、スタンバイ)。
properties.partnerDatabase	string	リソースパートナーデータベース。
properties.partnerLocation	string	リソースパートナーの場所。
properties.partnerRole	ReplicationRole	パートナーレプリケーションロール。
properties.partnerServer	string	リソースパートナーサーバー。
properties.percentComplete	integer	リンクのシード処理完了率。
properties.replicationMode	string	レプリケーションモード。
properties.replicationState	ReplicationState	レプリケーションの状態 (保留中、シード処理、キャッチアップ、中断)。
properties.role	ReplicationRole	ローカルレプリケーションロール。
properties.startTime	string	リンクが作成された時刻。
type	string	リソースの種類。

ReplicationLinkType

リンクの種類 (GEO、名前付き、スタンバイ)。

名前	型	説明
GEO	string
NAMED	string
STANDBY	string

ReplicationRole

ローカルレプリケーションロール。

名前	型	説明
Copy	string
NonReadableSecondary	string
Primary	string
Secondary	string
Source	string

ReplicationState

レプリケーションの状態 (保留中、シード処理、キャッチアップ、中断)。

名前	型	説明
CATCH_UP	string
PENDING	string
SEEDING	string
SUSPENDED	string

次の方法で共有

Replication Links - Failover

URI パラメーター

応答

例

Planned failover of a replication link

要求のサンプル

応答のサンプル

定義

ReplicationLink

ReplicationLinkType

ReplicationRole

ReplicationState

その他のリソース