Failover Groups - List By Server

サーバーにフェールオーバー グループが表示されます。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/failoverGroups?api-version=2015-05-01-preview

URI パラメーター

Name In Required Type Description
resourceGroupName
path True
  • string

リソースが含まれているリソース グループの名前。 この値は、Azure リソース マネージャー API またはポータルから取得できます。

serverName
path True
  • string

フェールオーバー グループを含むサーバーの名前。

subscriptionId
path True
  • string

Azure サブスクリプションを識別するサブスクリプション ID。

api-version
query True
  • string

要求で使用する API のバージョン。

応答

Name Type Description
200 OK

フェールオーバー グループを正常に取得しました。

Other Status Codes

エラー応答: ***

  • 400 フェールオーバー グループ作成または更新要求無効データベース - 要求内の指定されたデータベースは有効なデータベース リソース ID ではありません。

  • 400 フェールオーバー グループの作成または更新要求無効パートナー - フェールオーバー グループ要求の本文の作成または更新の指定されたパートナー フィールドが空であるか、無効です。

  • 400 フェールオーバー グループ作成または更新リクエストパートナー - 提供された 1 つ以上のパートナー サーバーが既にフェールオーバー グループの一部です。 プライマリ サーバーと、指定されたすべてのパートナー サーバーが一意であることを確認してください。

  • 400 フェールオーバー グループの作成または更新要求InvalidDatabaseServer - 指定されたデータベースの 1 つ以上がフェールオーバー グループのプライマリ サーバーに存在しません。 すべてのデータベースがプライマリ サーバーに存在することを確認してください。

  • 400 フェールオーバー グループの作成または更新要求サポートされていないパートナー数 - 1 つのパートナー サーバーのみがサポートされます。

  • 400 フェールオーバー グループの作成または更新要求無効読み書きエンドポイント - 作成または更新要求には読み書きエンドポイント フィールドが必要です。

  • 400 フェールオーバー グループ作成または更新要求無効 - フェールオーバー グループ要求の作成または更新の本文が空または無効です。

  • 400 フェールオーバー グループ更新または削除要求オンセカンダリ - フェールオーバー グループへの変更はセカンダリ サーバーでは許可されていません。 プライマリ サーバーで要求を実行します。

  • 400 フェールオーバー グループ作成または更新要求ネガティブ猶予期間値 - 読み取り/書き込みエンドポイントの猶予期間値は負でない必要があります。

  • 400 フェールオーバー グループの作成または更新要求InvalidReadWriteエンドポイントフィールド - 読み取り/書き込みエンドポイントに対してフェールオーバー ポリシー自動が選択されている場合は、プロパティ フェールオーバーを指定する必要があります。

  • 400 フェールオーバー グループの作成または更新要求無効読み書き込みフェールオーバー ポリシー - 読み取り/書き込みエンドポイントのフェールオーバー ポリシー フィールドは、作成または更新要求に必要です。

  • 400 フェールオーバー グループの作成または更新要求InvalidReadWriteEndpointFieldsForManualPolicy - 読み取り/書き込みエンドポイントに対してフェールオーバー ポリシーの [手動] が選択されている場合は、猶予期間値を指定しないでください。

  • 400 フェールオーバー グループの作成または更新の読み取り専用プロパティの本文を変更{0}する必要があります。

  • 400 フェールオーバー グループ フェールオーバー要求オンプライマリ - フェールオーバー要求は、フェールオーバー グループのセカンダリ サーバーで開始する必要があります。

  • 400 フェールオーバー グループパートナーサーバーFromDifferentDifferentサブスクリプション - プライマリ サーバーとフェールオーバー グループのパートナー サーバーは、異なるサブスクリプションから取得されています。 フェールオーバー グループのサーバーのクロス サブスクリプションは許可されていません。

  • 400 ができませんが解決します。

  • 400 RemoteDatabaseCopyPermission - ユーザーには、指定されたサーバー上にデータベース コピーを作成するための十分なアクセス許可がありません。

  • 400 InvalidFailoverGroupRegion - フェールオーバー グループで指定されたサーバーは、分離を提供するために異なるリージョンに存在する必要があります。

  • 400 ServerNotFound - 要求されたサーバーが見つかりませんでした。

  • 400 フェールオーバーグループは存在しません - フェールオーバー グループがサーバーに存在しません。

  • 400 フェールオーバー グループNotセカンダリ - フェールオーバー グループのプライマリ サーバーからフェールオーバーを開始できません。

  • 400 計画FailoverTimedOutForデータベース - ユーザーは計画されたフェールオーバーを呼び出し、タイムアウトし、特定のデータベースが原因であるように見えます。

  • 400 PlannedFailoverTimedOut - ユーザーは計画的なフェールオーバーを呼び出し、パートナー管理サービスに接続中にタイムアウトしました。

  • 400 データベースInFailoverGroupNotPrimary - データベースの GeoDR リンクは既に存在しますが、そのロールが 「プライマリ」ではないか、連続コピー リンクではありません。

  • 400 無効なAddSecondaryアクセス許可 - ユーザーが指定されたサーバーにセカンダリを追加するのに十分なアクセス許可を持っていません。

  • 400 無効な識別子 - 識別子に NULL または無効な Unicode 文字が含まれています。

  • 400 無効なSku - ユーザーが無効な SKU を指定しました。

  • 400 TokenTooLong - 指定されたトークンが長すぎます。

  • 400 FeatureDisabledOnSelectedEdition - ユーザーは、現在のデータベース エディションで無効になっている機能を使用しようとしました。

  • 400 は使用できません予約データベース名 - この操作で予約データベース名を使用できません。

  • 400 無効なサーバー名 - 無効なサーバー名が指定されました。

  • 400 InvalidTargetSubRegion - 読み取り不可能なセカンダリのターゲット サーバーが、DR ペアの Azure リージョンにありません。

  • 400 パートナーサーバー非互換 - ユーザーが、データベースを SAWA V1 サーバーから Sterling サーバーにコピーしようとしています。

  • 400 不正レプリケーションリンクステート - 操作は、データベースがレプリケーション リンク上で予期された状態であることを予期します。

  • 400 ResourcePoolNotFound - 指定されたエラスティック プールが指定された論理サーバーに存在しません。

  • 400 GeoReplicationDatabaseNotセカンダリ - 操作はデータベースがレプリケーション ターゲットであることを予期します。

  • 400 GeoReplicaLimit到達 - レプリカごとのレプリケーションの制限に達しました。

  • 404 リソースが見つかりません - 要求されたリソースが見つかりませんでした。

  • 404 サーバー NotIn サブスクリプションリソース グループ - 指定されたサーバーが、指定されたリソース グループとサブスクリプションに存在しません。

  • 404 ソース データベースが見つかりません - ソース データベースが存在しません。

  • 404 ServerNotInSubscription - 指定されたサーバーが指定されたサブスクリプションに存在しません。

  • 405 サポートされていないレプリケーション操作 - サポートされていないレプリケーション操作がデータベースで開始されました。

  • 409 UpdateSloInProgress - SLO 更新の実行中に、ユーザーが互換性のない操作を開始しようとしました。

  • 409 リモート データベースが存在します - 移動先のサーバーに、移動先データベース名が既に存在します。

  • 409 フェールオーバーグループがすでに存在する - フェールオーバー グループは、指定されたサーバーに既に存在します。

  • 409 フェールオーバー グループビジー - フェールオーバー グループは、別の操作でビジーです。

  • 409 データベースは他のフェールオーバーグループに属し、このフェールオーバー グループの一部を考慮することはできません。

  • 409 DatabaseBeingAddedToFailoverGroup - データベースは現在フェールオーバーグループに追加されていますが、お客様はこの操作が終了して削除を発行するのを待つ必要があります。

  • 409 DatabaseBeingRemovedFromFailoverGroup - データベースは現在フェールオーバー グループから削除されていますが、お客様はこの操作が完了するまで待つ必要があります。

  • 409 フェールオーバーグループDnsレコードInUse - 要求されたエンドポイントに対して重複する DNS レコードが存在します。

  • 409 無効なフェールオーバー グループ名 - 無効なフェールオーバー グループ名が指定されました。

  • 409 サブスクリプション無効 - サブスクリプションが無効です。

  • 409 競合するシステム操作InProgress - データベースでシステムメンテナンス操作が進行中であり、さらに操作が完了するまで待機する必要があります。

  • 409 無効な操作データベースNotInレプリケーションリレーションシップ - レプリケーション リレーションシップに既に存在するデータベースに対してレプリケーションシード操作が実行されました。

  • 409 無効データベース状態の操作 - 現在のレプリケーション状態のデータベースでは操作が許可されていません。

  • 409 重複GeoDrRelation - データベースは既にレプリケーション関係にあります。 これは重複した要求です。

  • 409 GeoReplicationNotToPrimaryの間に元に戻す - セカンダリが物理的に一貫性がなく、プライマリ ロールに入ることができない状態にある間、ユーザーはジオリンクのフェールオーバーまたは強制終了を試みました。

  • 429 サブスクリプションTooManyRequests - 利用可能なリソースで処理できる最大要求を超える要求。

  • 429 競合サーバー操作 - サーバーの操作が現在進行中です。

  • 429 TooManyRequests - 利用可能なリソースで処理できる最大要求を超える要求。

  • 429 サブスクリプション TooManyCreateUpdateRequests - 利用可能なリソースによって処理できる最大要求を超える要求。

  • 504 要求タイムアウト - サービス要求が許可されたタイムアウトを超えました。

List failover group

Sample Request

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups?api-version=2015-05-01-preview

Sample Response

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test",
      "name": "failover-group-test",
      "type": "Microsoft.Sql/servers/failoverGroups",
      "location": "Japan East",
      "properties": {
        "readWriteEndpoint": {
          "failoverPolicy": "Automatic",
          "failoverWithDataLossGracePeriodMinutes": 480
        },
        "readOnlyEndpoint": {
          "failoverPolicy": "Disabled"
        },
        "replicationRole": "Primary",
        "replicationState": "CATCH_UP",
        "partnerServers": [
          {
            "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server",
            "location": "Japan West",
            "replicationRole": "Secondary"
          }
        ],
        "databases": []
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-2",
      "name": "failover-group-test-2",
      "type": "Microsoft.Sql/servers/failoverGroups",
      "location": "Japan East",
      "properties": {
        "readWriteEndpoint": {
          "failoverPolicy": "Automatic",
          "failoverWithDataLossGracePeriodMinutes": 480
        },
        "readOnlyEndpoint": {
          "failoverPolicy": "Disabled"
        },
        "replicationRole": "Primary",
        "replicationState": "CATCH_UP",
        "partnerServers": [
          {
            "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server",
            "location": "Japan West",
            "replicationRole": "Secondary"
          }
        ],
        "databases": []
      }
    }
  ]
}

定義

FailoverGroup

フェールオーバー グループ。

FailoverGroupListResult

フェールオーバー グループの一覧。

FailoverGroupReadOnlyEndpoint

フェールオーバー グループ インスタンスの読み取り専用エンドポイント。

FailoverGroupReadWriteEndpoint

フェールオーバー グループ インスタンスの読み取り/書き込みエンドポイント。

FailoverGroupReplicationRole

フェールオーバー グループ インスタンスのローカル レプリケーションの役割。

PartnerInfo

フェールオーバー グループのパートナー サーバー情報。

ReadOnlyEndpointFailoverPolicy

フェールオーバー グループの読み取り専用エンドポイントのフェールオーバー ポリシー。

ReadWriteEndpointFailoverPolicy

フェールオーバー グループの読み取り/書き込みエンドポイントのフェールオーバー ポリシー。 フェールオーバーポリシーが自動の場合は、フェールオーバーウィズデータロスグレース期間分が必要です。

FailoverGroup

フェールオーバー グループ。

Name Type Description
id
  • string

リソースの ID

location
  • string

リソースの場所。

name
  • string

リソース名。

properties.databases
  • string[]

フェールオーバー グループ内のデータベースの一覧。

properties.partnerServers

フェールオーバー グループのパートナー サーバー情報の一覧。

properties.readOnlyEndpoint

フェールオーバー グループ インスタンスの読み取り専用エンドポイント。

properties.readWriteEndpoint

フェールオーバー グループ インスタンスの読み取り/書き込みエンドポイント。

properties.replicationRole

フェールオーバー グループ インスタンスのローカル レプリケーションの役割。

properties.replicationState
  • string

フェールオーバー グループ インスタンスのレプリケーション状態。

tags
  • object

リソース タグ。

type
  • string

リソースの種類。

FailoverGroupListResult

フェールオーバー グループの一覧。

Name Type Description
nextLink
  • string

結果の次のページを取得するためのリンク。

value

結果の配列。

FailoverGroupReadOnlyEndpoint

フェールオーバー グループ インスタンスの読み取り専用エンドポイント。

Name Type Description
failoverPolicy

フェールオーバー グループの読み取り専用エンドポイントのフェールオーバー ポリシー。

FailoverGroupReadWriteEndpoint

フェールオーバー グループ インスタンスの読み取り/書き込みエンドポイント。

Name Type Description
failoverPolicy

フェールオーバー グループの読み取り/書き込みエンドポイントのフェールオーバー ポリシー。 フェールオーバーポリシーが自動の場合は、フェールオーバーウィズデータロスグレース期間分が必要です。

failoverWithDataLossGracePeriodMinutes
  • integer

データ損失によるフェールオーバーが行われる前の猶予期間は、読み取り/書き込みエンドポイントに対して試行されます。 フェールオーバーポリシーが自動の場合は、フェールオーバーウィズデータロスグレース期間分が必要です。

FailoverGroupReplicationRole

フェールオーバー グループ インスタンスのローカル レプリケーションの役割。

Name Type Description
Primary
  • string
Secondary
  • string

PartnerInfo

フェールオーバー グループのパートナー サーバー情報。

Name Type Description
id
  • string

パートナー サーバーのリソース識別子。

location
  • string

パートナー サーバーの地理的な場所。

replicationRole

パートナー サーバーのレプリケーションの役割。

ReadOnlyEndpointFailoverPolicy

フェールオーバー グループの読み取り専用エンドポイントのフェールオーバー ポリシー。

Name Type Description
Disabled
  • string
Enabled
  • string

ReadWriteEndpointFailoverPolicy

フェールオーバー グループの読み取り/書き込みエンドポイントのフェールオーバー ポリシー。 フェールオーバーポリシーが自動の場合は、フェールオーバーウィズデータロスグレース期間分が必要です。

Name Type Description
Automatic
  • string
Manual
  • string