次の方法で共有


Replication Links - Failover

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

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 - 使用可能なリソースによって処理できる最大要求数を超える要求。

要求のサンプル

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

応答のサンプル

{
  "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"
}

定義

名前 説明
ReplicationLink

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

ReplicationLinkType

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

ReplicationRole

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

ReplicationState

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

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

名前 説明
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