Replication Links - Update

リファレンス

Service:: SQL Database

API Version:: 2023-08-01-preview

レプリケーションリンクの種類を更新します。

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/replicationLinks/{linkId}?api-version=2023-08-01-preview

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 のバージョン。

要求本文

名前	型	説明
properties.linkType	ReplicationLinkType	リンクの種類 (GEO、名前付き、スタンバイ)。更新操作では NAMED はサポートされていません。

応答

名前	型	説明
200 OK	ReplicationLink	レプリケーションリンクが正常に更新されました。
202 Accepted		更新操作が進行中です。
Other Status Codes	ErrorResponse	エラー応答: *** 400 ReplicationLinksReplicationLinkNameIsInvalid - レプリケーションリンク名は有効な guid である必要があります。 400 GeoReplicationDatabaseNotSecondary - この操作では、データベースがレプリケーションターゲットであることが想定されます。 400 ReplicationLinksReplicationLinkTypeIsInvalid - LinkType が無効です。有効な値は STANDBY と GEO です。 400 ReplicationLinksCreateIsNotSupported - レプリケーションリンクの作成はサポートされていません。 400 LedgerNoDropLink - データベースで台帳ダイジェストアップロードが有効になっているため、geo レプリケーションを停止できません。台帳ダイジェストのアップロードを無効にして、操作を再試行します。 400 CannotUseTrailingWhitespacesInDatabaseName - データベース名の検証に失敗しました。 400 GeoReplicationDatabaseNotSecondary - この操作では、データベースがレプリケーションターゲットであることが想定されます。 400 VBSEnclaveNotSupportedForGeoReplicationWithDefaultEnclave - geo レプリケーションの構成は、preferredEnclaveType プロパティの異なる値を使用するデータベースではサポートされていません。 '{1}' サーバー上のプライマリ '{0}' データベースでは '{2}' preferredEnclaveType が使用されますが、'' サーバー上のセカンダリ '{3}' データベースに対して指定された preferredEnclaveType は '{4}{5}' です。 400 VBSEnclaveNotSupportedForPlannedFailoverBetweenDatabasesWithDifferentPreferredEnclaveTypes - preferredEnclaveType が異なるプライマリデータベースとセカンダリデータベース間の計画フェールオーバーは、仮想化ベースのセキュリティ (VBS) エンクレーブではサポートされていません。 400 CannotUseReservedDatabaseName - この操作で予約済みデータベース名を使用できません。 400 InvalidServerName - 無効なサーバー名が指定されています。 400 PlannedFailoverTimedOut - ユーザーが計画フェールオーバー呼び出し、パートナー管理サービスに問い合わせようとしているときにタイムアウトしました。 400 InvalidIdentifier - 識別子に NULL または無効な Unicode 文字が含まれています。 400 IncorrectReplicationLinkState - この操作では、データベースがレプリケーションリンクで予期された状態であることが想定されます。 404 OperationIdNotFound - Id を持つ操作が存在しません。 404 ResourceNotFound - 要求されたリソースが見つかりませんでした。 404 OperationIdNotFound - Id を持つ操作が存在しません。 404 DatabaseDoesNotExist - ユーザーがこのサーバーインスタンスに存在しないデータベース名を指定しました。 409 CannotCancelOperation - 管理操作が取り消すことができない状態です。 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

ErrorResponse

エラー応答: ***

400 ReplicationLinksReplicationLinkNameIsInvalid - レプリケーションリンク名は有効な guid である必要があります。
400 GeoReplicationDatabaseNotSecondary - この操作では、データベースがレプリケーションターゲットであることが想定されます。
400 ReplicationLinksReplicationLinkTypeIsInvalid - LinkType が無効です。有効な値は STANDBY と GEO です。
400 ReplicationLinksCreateIsNotSupported - レプリケーションリンクの作成はサポートされていません。
400 LedgerNoDropLink - データベースで台帳ダイジェストアップロードが有効になっているため、geo レプリケーションを停止できません。台帳ダイジェストのアップロードを無効にして、操作を再試行します。
400 CannotUseTrailingWhitespacesInDatabaseName - データベース名の検証に失敗しました。
400 GeoReplicationDatabaseNotSecondary - この操作では、データベースがレプリケーションターゲットであることが想定されます。
400 VBSEnclaveNotSupportedForGeoReplicationWithDefaultEnclave - geo レプリケーションの構成は、preferredEnclaveType プロパティの異なる値を使用するデータベースではサポートされていません。 '{1}' サーバー上のプライマリ '{0}' データベースでは '{2}' preferredEnclaveType が使用されますが、'' サーバー上のセカンダリ '{3}' データベースに対して指定された preferredEnclaveType は '{4}{5}' です。
400 VBSEnclaveNotSupportedForPlannedFailoverBetweenDatabasesWithDifferentPreferredEnclaveTypes - preferredEnclaveType が異なるプライマリデータベースとセカンダリデータベース間の計画フェールオーバーは、仮想化ベースのセキュリティ (VBS) エンクレーブではサポートされていません。
400 CannotUseReservedDatabaseName - この操作で予約済みデータベース名を使用できません。
400 InvalidServerName - 無効なサーバー名が指定されています。
400 PlannedFailoverTimedOut - ユーザーが計画フェールオーバー呼び出し、パートナー管理サービスに問い合わせようとしているときにタイムアウトしました。
400 InvalidIdentifier - 識別子に NULL または無効な Unicode 文字が含まれています。
400 IncorrectReplicationLinkState - この操作では、データベースがレプリケーションリンクで予期された状態であることが想定されます。
404 OperationIdNotFound - Id を持つ操作が存在しません。
404 ResourceNotFound - 要求されたリソースが見つかりませんでした。
404 OperationIdNotFound - Id を持つ操作が存在しません。
404 DatabaseDoesNotExist - ユーザーがこのサーバーインスタンスに存在しないデータベース名を指定しました。
409 CannotCancelOperation - 管理操作が取り消すことができない状態です。
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 - 使用可能なリソースで処理できる最大要求を超える要求。

例

Update Replication Link

Sample Request

HTTP

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/sourcesvr/databases/gamma-db/replicationLinks/00000000-1111-2222-3333-666666666666?api-version=2023-08-01-preview

{
  "properties": {
    "linkType": "STANDBY"
  }
}

Sample Response

Status code:: 200

{
  "properties": {
    "partnerServer": "testsvr",
    "partnerDatabase": "gamma-db",
    "partnerDatabaseId": "/subscriptions/00000000-1111-2222-3333-555555555555/resourceGroups/Second-Default/providers/Microsoft.Sql/servers/testsvr/databases/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": "STANDBY"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/sourcesvr/databases/gamma-db/replicationLinks/4891ca10-ebd0-47d7-9182-c722651780fb",
  "name": "00000000-1111-2222-3333-666666666666"
}

Status code:: 202

Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/japaneast/replicationLinksOperationResults/11111111-1111-1111-1111-111111111111

定義

名前	説明
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
ReplicationLink	レプリケーションリンク。
ReplicationLinkType	リンクの種類 (GEO、名前付き、スタンバイ)。更新操作では NAMED はサポートされていません。
ReplicationLinkUpdate	レプリケーションリンクの更新要求。
ReplicationRole	ローカルレプリケーションロール。
ReplicationState	レプリケーションの状態 (保留中、シード処理、キャッチアップ、中断)。

ErrorAdditionalInfo

リソース管理エラーの追加情報。

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

ErrorDetail

エラーの詳細。

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
code	string	エラーコード。
details	ErrorDetail[]	エラーの詳細です。
message	string	エラーメッセージ。
target	string	エラーのターゲット。

ErrorResponse

エラー応答

名前	型	説明
error	ErrorDetail	error オブジェクト。

ReplicationLink

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

名前	型	説明
id	string	リソースの ID
name	string	リソース名。
properties.isTerminationAllowed	boolean	ユーザーが現在リンクの終了を許可されているかどうか。
properties.linkType	ReplicationLinkType	リンクの種類 (GEO、名前付き、スタンバイ)。更新操作では NAMED はサポートされていません。
properties.partnerDatabase	string	リソースパートナーデータベース。
properties.partnerDatabaseId	string	リソースパートナーデータベース ID。
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、名前付き、スタンバイ)。更新操作では NAMED はサポートされていません。

名前	型	説明
GEO	string
NAMED	string
STANDBY	string

ReplicationLinkUpdate

レプリケーションリンクの更新要求。

名前	型	説明
id	string	リソースの ID
name	string	リソース名。
properties.linkType	ReplicationLinkType	リンクの種類 (GEO、名前付き、スタンバイ)。更新操作では NAMED はサポートされていません。
type	string	リソースの種類。

ReplicationRole

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

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

ReplicationState

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

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

Share via

Replication Links - Update

URI パラメーター

要求本文

応答

例

Update Replication Link

Sample Request

Sample Response

定義

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ReplicationLink

ReplicationLinkType

ReplicationLinkUpdate

ReplicationRole

ReplicationState

その他のリソース