Replication Links - Create Or Update

リファレンス

Service:: SQL Database

API Version:: 2023-08-01-preview

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

PUT 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 - preferredEnclaveType プロパティの異なる値を使用するデータベースでは、geo レプリケーションの構成はサポートされていません。 '{1}' サーバー上のプライマリ '{0}' データベースは '{2}' preferredEnclaveType を使用しますが、'' サーバー上のセカンダリ '{3}' データベースに{4}指定された preferredEnclaveType は '{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 - preferredEnclaveType プロパティの異なる値を使用するデータベースでは、geo レプリケーションの構成はサポートされていません。 '{1}' サーバー上のプライマリ '{0}' データベースは '{2}' preferredEnclaveType を使用しますが、'' サーバー上のセカンダリ '{3}' データベースに{4}指定された preferredEnclaveType は '{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 - 使用可能なリソースによって処理できる最大要求数を超える要求。

例

Updates Replication Link

Sample Request

HTTP

PUT 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 をサポートしていません。
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

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 - Create Or Update

URI パラメーター

要求本文

応答

例

Updates Replication Link

Sample Request

Sample Response

定義

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ReplicationLink

ReplicationLinkType

ReplicationRole

ReplicationState

その他のリソース