Instance Failover Groups - Get

サービス:: SQL Database

API バージョン:: 2023-08-01

フェールオーバーグループを取得します。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/instanceFailoverGroups/{failoverGroupName}?api-version=2023-08-01

URI パラメーター

名前	/	必須	型	説明
failoverGroupName	path	True	string	フェールオーバーグループの名前。
locationName	path	True	string	リソースが配置されているリージョンの名前。
resourceGroupName	path	True	string	リソースを含むリソースグループの名前。この値は、Azure Resource Manager API またはポータルから取得できます。
subscriptionId	path	True	string	Azure サブスクリプションを識別するサブスクリプション ID。
api-version	query	True	string	要求に使用する API バージョン。

応答

名前	型	説明
200 OK	InstanceFailoverGroup	指定したフェールオーバーグループが正常に取得されました。
Other Status Codes	ErrorResponse	エラー応答: *** 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPrimary - インスタンスの作成または更新のフェールオーバーグループ要求本文の指定されたプライマリフィールドが空または無効です。 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPartner - インスタンスの作成または更新のフェールオーバーグループ要求本文の指定されたパートナーフィールドが空または無効です。 400 InstanceFailoverGroupCreateOrUpdateRequestDuplicatePartner - 指定された 1 つ以上のパートナーサーバーが既にインスタンスフェールオーバーグループに含まれています。プライマリサーバーと指定されたすべてのパートナーサーバーが一意であることを確認してください。 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidManagedInstanceRegion - インスタンスフェールオーバーグループ要求本文に指定されたパートナーマネージドインスタンスリージョンが空または無効です。 400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount - サポートされているパートナーリージョンは 1 つだけです。 400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPairCount - 1 つのマネージドインスタンスペアのみがサポートされます。 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint - readWriteEndpoint フィールドは、要求の作成または更新に必要です。 400 InstanceFailoverGroupCreateOrUpdateRequestInvalid - インスタンスの作成または更新のフェールオーバーグループ要求本文が空または無効です。 400 InstanceFailoverGroupUpdateOrDeleteRequestOnSecondary - セカンダリサーバーでは、インスタンスフェールオーバーグループへの変更は許可されません。プライマリサーバーで要求を実行します。 400 InstanceFailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues - 読み取り/書き込みエンドポイントの猶予期間値は負でない必要があります。 400 InstanceFailoverGroupCreateOrUpdateRequestLessThanMinimumGracePeriodValues - インスタンスフェールオーバーグループの猶予期間の値は、'{0}' 分の最小猶予期間以上である必要があります 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields - フェールオーバーポリシー自動が読み取り/書き込みエンドポイントに対して選択されている場合は、プロパティ failoverWithDataLossGracePeriodMinutes を指定する必要があります。 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteFailoverPolicy - 作成または更新要求には、読み取り/書き込みエンドポイントの failoverPolicy フィールドが必要です。 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy - 読み取り/書き込みエンドポイントでフェールオーバーポリシーの手動が選択されている場合は、猶予期間値を指定しないでください。 400 InstanceFailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified - インスタンスの作成または更新のフェールオーバーグループ要求本文で、読み取り専用プロパティ '{0}' を変更しないでください。 400 InstanceFailoverGroupFailoverRequestOnPrimary - フェールオーバー要求は、インスタンスフェールオーバーグループのセカンダリサーバーで開始する必要があります。 400 InstanceFailoverGroupPartnerManagedInstanceFromDifferentSubscription - フェールオーバーグループのプライマリサーバーとパートナーサーバーは、異なるサブスクリプションから取得されます。フェールオーバーグループのサーバーのクロスサブスクリプションは許可されません。 400 InvalidAddSecondaryPermission - 指定されたサーバーにセカンダリを追加するための十分なアクセス許可がありません。 400 InvalidSku - ユーザーが無効な SKU を指定しました。 400 ServerNotFound - 要求されたサーバーが見つかりませんでした。 400 ServerEditionMismatch - エディションは、レプリカサーバーの作成時にプライマリサーバーと同じである必要があります。 400 FeatureDisabledOnSelectedEdition - ユーザーは、現在のデータベースエディションで無効になっている機能を使用しようとしました。 400 TokenTooLong - 指定されたトークンが長すぎます。 400 InvalidTargetSubregion - 読み取り不可能なセカンダリのターゲットサーバーが、DR ペアの Azure リージョンにありません。 400 ManagedInstanceStoppingOrStopped - インスタンスが停止/停止状態にある間に送信された操作の競合 400 ManagedInstanceStarting - インスタンスが開始状態の間に送信された操作の競合 400 IncorrectReplicationLinkState - この操作では、データベースがレプリケーションリンクで予期された状態であることが想定されます。 400 CloudLifterFogInaccessibleDbRoleMismatch - データベースがアクセスできない状態にある間にフェールオーバーグループのインスタンスロールが {0} から {1} に変更されたため、SQL Managed Instance {2} のデータベース {3} にアクセスできません。 geo フェールオーバーを実行して元のデータベースロールを復元してから、もう一度やり直してください。 400 CloudLifterGeodrBlocksDbActivate - 継続的な geodr 操作により、SQL Managed Instance 上のデータベース {0} にアクセス {1} できません。競合する操作が完了するまで待ってから、もう一度やり直してください。 400 AzureKeyVaultKeyDisabled - Azure Key Vault キーが無効になっているため、サーバーで操作を完了できませんでした。 400 AzureKeyVaultInvalidExpirationDate - Azure Key Vault キーの有効期限が無効であるため、操作を完了できませんでした。 400 SecurityAzureKeyVaultUrlNullOrEmpty - Azure Key Vault URI が null または空であるため、操作を完了できませんでした。 400 AzureKeyVaultNoServerIdentity - サーバー ID が正しく構成されていません。 400 AzureKeyVaultInvalidUri - Azure Key Vault からの無効な応答。有効な Azure Key Vault URI を使用してください。 400 AzureKeyVaultMissingPermissions - サーバーに Azure Key Vault に必要なアクセス許可がありません。 400 SecurityAzureKeyVaultInvalidKeyName - 無効なサーバーキー名のため、操作を完了できませんでした。 400 PlannedFailoverTimedOutForDatabase - ユーザーが計画されたフェールオーバーを呼び出し、タイムアウトし、特定のデータベースが非難されるように見えます。 400 PlannedFailoverTimedOut - ユーザーが計画されたフェールオーバーを呼び出し、パートナー管理サービスに問い合わせようとしているときにタイムアウトしました。 400 AdalGenericError - Azure Active Directory エラーが発生したため、操作を完了できませんでした。 400 AdalServicePrincipalNotFound - Azure Active Directory ライブラリのサービスプリンシパルが見つからないエラーが発生したため、操作を完了できませんでした。 400 AzureKeyVaultMalformedVaultUri - 指定された Key Vault URI が無効です。 400 CannotUseReservedDatabaseName - この操作で予約済みデータベース名を使用できません。 400 InvalidFailoverGroupRegion - インスタンスフェールオーバーグループで指定されたサーバーは、分離を提供するために異なるリージョンに存在する必要があります。 400 InstanceFailoverGroupDoesNotExist - フェールオーバーグループがサーバー上に存在しません。 400 InstanceFailoverGroupNotSecondary - インスタンスフェールオーバーグループ内のプライマリサーバーからフェールオーバーを開始できません。 400 ManagedInstanceGeoDRNotAllowedForInstancePool - インスタンスプール内にプロビジョニングされたマネージドインスタンスでは、自動フェールオーバーグループ (GeoDR) の作成はサポートされていません。自動フェールオーバーグループは、スタンドアロン Managed Instance に対してのみ作成できます。 400 InvalidServerName - 無効なサーバー名が指定されました。 400 ManagedInstanceEstablishingFailoverGroupGeoPrimaryWithNewerVersionEditionThanSecondary - プライマリインスタンスのデータベース形式がセカンダリインスタンスのデータベース形式と互換性がないため、フェールオーバーグループを作成できません。詳細については、https://go.microsoft.com/fwlink/?linkid=2251601 を参照してください。 400 ManagedInstanceFailoverInFailoverGroupInstancesWithDifferentVersionEditions - フェールオーバーグループ内のインスタンス間でデータベース形式が一致しないため、フェールオーバー操作を実行できません。プライマリインスタンスのデータベース形式をアップグレードするか、フェールオーバーグループを削除して現在のセカンダリインスタンスをスタンドアロンインスタンスに昇格することを検討してください。詳細については、https://go.microsoft.com/fwlink/?linkid=2251601 を参照してください。 400 SecurityAdalPrincipalCertExpiredError - Azure Key Vault プリンシパル証明書の有効期限が切れているため、操作を完了できませんでした。 400 ManagedInstanceNotAllowedInGeoDRSetupWhenFreemium - 無料の Azure SQL Managed Instance オファーでは、フェールオーバーグループのデプロイはサポートされていません。 400 InvalidIdentifier - 識別子に NULL または無効な Unicode 文字が含まれています。 400 SecurityInvalidAzureKeyVaultRecoveryLevel - 指定された Key Vault URI が無効です。 400 ManagedInstanceGeoFailoverCannotBeExecuted - 現時点では、Managed Instance geo フェールオーバーを実行できません。理由: '{0}'。 400 KeyMaterialNotFoundOnRemoteServer - リモートサーバーは、TDE 保護機能として使用されるキーマテリアルにアクセスできません。 400 SameKeyUriNotFoundOnRemoteServer - セカンダリサーバーには、キーの自動ローテーションが有効になっているプライマリサーバーの暗号化保護機能と同じキーコンテナーのキーマテリアルがありません。 400 AzureKeyVaultRsaKeyNotSupported - 提供されたキーコンテナーでは、サポートされていない RSA キーサイズまたはキーの種類が使用されます。サポートされている RSA キーサイズは 2048 または 3072 で、キーの種類は RSA または RSA-HSM です。 400 SameKeyMaterialNotFoundOnRemoteServer - セカンダリサーバーには、プライマリサーバーの暗号化保護機能のキーマテリアルがありません。 400 GeoReplicationDatabaseNotSecondary - この操作では、データベースがレプリケーションターゲットであることが想定されます。 400 ManagedInstanceUpdateSloOngoing - マネージドインスタンス '{0}' のサービスレベルの変更が進行中のため、操作を完了できませんでした。進行中の操作が完了するまで待ってから、もう一度やり直してください。 400 FailoverGroupRegionMismatch - フェールオーバーグループで指定されたパートナーリージョンは、指定されたパートナーマネージドインスタンスのリージョンと一致する必要があります。 400 DnsZoneMismatch - パートナーサーバーの DNSZone は、ソースサーバーの DNSZone とは異なります。これにより、InstanceFailoverGroup の機能が中断されます。 400 GeoDrInstanceSizeMismatch - プライマリマネージドインスタンスとパートナーマネージドインスタンスのストレージサイズが同じではありません。 400 UnableToResolveRemoteServer - 無効なサーバー名または DNS 接続の問題が原因で、リモートパートナーサーバー名を解決できませんでした。 400 GeoDrSecondaryInstanceNotEmpty - セカンダリマネージドインスタンスにはユーザーデータベースがあります。インスタンスフェールオーバーグループを作成するには、セカンダリマネージドインスタンスを空にする必要があります。 400 RemoteDatabaseCopyPermission - 指定されたサーバーにデータベースコピーを作成するための十分な権限がありません。 400 InstanceFailoverGroupIncorrectNetworkingConfiguration - ネットワーク構成が正しくありません。プライマリサーバーのレプリケーショントラフィックがセカンダリサーバーに到達できません。 404 ResourceNotFound - 要求されたリソースが見つかりませんでした。 404 ServerNotInSubscriptionResourceGroup - 指定されたサーバーが、指定されたリソースグループとサブスクリプションに存在しません。 404 ServerNotInSubscription - 指定されたサーバーが指定されたサブスクリプションに存在しません。 404 SourceDatabaseNotFound - ソースデータベースが存在しません。 405 UnsupportedReplicationOperation - サポートされていないレプリケーション操作がデータベースで開始されました。 409 ConflictingServerOperation - サーバーに対する操作が現在進行中です。 409 SubscriptionDisabled - サブスクリプションが無効になっています。 409 ConflictingSystemOperationInProgress - データベースでシステムメンテナンス操作が進行中であり、それ以上の操作が完了するまで待機する必要があります。 409 ManagedInstanceContainsInaccessibleDatabases - マネージドインスタンス '{0}' にアクセスできない状態のデータベースが含まれているため、操作を完了できませんでした。操作を再試行する前に、アクセスできないデータベースを削除するか、マネージドインスタンスのカスタマーマネージド TDE 保護機能キーへのアクセスに関する問題を修正してください。 https://go.microsoft.com/fwlink/?linkid=2111623 409 ManagedInstanceHasHybridLink - マネージドインスタンスにハイブリッドリンクが構成されている場合にサポートされていない操作を開始しようとしました。 409 GeoReplicationCannotBecomePrimaryDuringUndo - ユーザーが geo リンクをフェールオーバーまたは強制終了しようとしましたが、セカンダリが物理的に一貫性がないため、プライマリロールを入力できない状態です。 409 ServerKeyNameAlreadyExists - サーバー上にサーバーキーが既に存在します。 409 ServerKeyUriAlreadyExists - サーバー上にサーバーキー URI が既に存在します。 409 ServerKeyDoesNotExists - サーバーキーが存在しません。 409 UpdateSloInProgress - SLO 更新の進行中に、ユーザーが互換性のない操作を開始しようとしました。 409 AzureKeyVaultKeyNameNotFound - Azure Key Vault キー名が存在しないため、操作を完了できませんでした。 409 AzureKeyVaultKeyInUse - キーは現在サーバーによって使用されています。 409 InstanceFailoverGroupAlreadyExists - フェールオーバーグループは、特定のサーバーに既に存在します。 409 InstanceFailoverGroupBusy - インスタンスフェールオーバーグループが別の操作でビジー状態です。 409 InstanceFailoverGroupDnsRecordInUse - 要求されたエンドポイントに重複する DNS レコードが存在します。 409 InvalidFailoverGroupName - 無効なインスタンスフェールオーバーグループ名が指定されました。 409 InvalidOperationForDatabaseNotInReplicationRelationship - レプリケーション関係にないデータベースに対してレプリケーション操作が実行されました。 409 InvalidDatabaseStateForOperation - この操作は、現在のレプリケーション状態のデータベースでは許可されません。 409 DuplicateGeoDrRelation - データベースは既にレプリケーション関係にあります。これは重複する要求です。 409 RemoteDatabaseExists - コピー先のデータベース名は、既に移行先サーバーに存在します。 429 SubscriptionTooManyCreateUpdateRequests - 使用可能なリソースによって処理できる最大要求を超える要求。 429 SubscriptionTooManyRequests - 使用可能なリソースによって処理できる最大要求を超える要求。 503 TooManyRequests - 使用可能なリソースによって処理できる最大要求を超える要求。 503 AzureKeyVaultConnectionFailed - Azure Key Vault への接続が失敗したため、サーバーで操作を完了できませんでした 503 AzureKeyVaultGenericConnectionError - Key Vault 情報を取得しようとしたときにエラーが発生したため、操作を完了できませんでした。 504 RequestTimeout - サービス要求が許可されたタイムアウトを超えました。

名前

型

説明

200 OK

InstanceFailoverGroup

指定したフェールオーバーグループが正常に取得されました。

Other Status Codes

ErrorResponse

エラー応答: ***

400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPrimary - インスタンスの作成または更新のフェールオーバーグループ要求本文の指定されたプライマリフィールドが空または無効です。
400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPartner - インスタンスの作成または更新のフェールオーバーグループ要求本文の指定されたパートナーフィールドが空または無効です。
400 InstanceFailoverGroupCreateOrUpdateRequestDuplicatePartner - 指定された 1 つ以上のパートナーサーバーが既にインスタンスフェールオーバーグループに含まれています。プライマリサーバーと指定されたすべてのパートナーサーバーが一意であることを確認してください。
400 InstanceFailoverGroupCreateOrUpdateRequestInvalidManagedInstanceRegion - インスタンスフェールオーバーグループ要求本文に指定されたパートナーマネージドインスタンスリージョンが空または無効です。
400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount - サポートされているパートナーリージョンは 1 つだけです。
400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPairCount - 1 つのマネージドインスタンスペアのみがサポートされます。
400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint - readWriteEndpoint フィールドは、要求の作成または更新に必要です。
400 InstanceFailoverGroupCreateOrUpdateRequestInvalid - インスタンスの作成または更新のフェールオーバーグループ要求本文が空または無効です。
400 InstanceFailoverGroupUpdateOrDeleteRequestOnSecondary - セカンダリサーバーでは、インスタンスフェールオーバーグループへの変更は許可されません。プライマリサーバーで要求を実行します。
400 InstanceFailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues - 読み取り/書き込みエンドポイントの猶予期間値は負でない必要があります。
400 InstanceFailoverGroupCreateOrUpdateRequestLessThanMinimumGracePeriodValues - インスタンスフェールオーバーグループの猶予期間の値は、'{0}' 分の最小猶予期間以上である必要があります
400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields - フェールオーバーポリシー自動が読み取り/書き込みエンドポイントに対して選択されている場合は、プロパティ failoverWithDataLossGracePeriodMinutes を指定する必要があります。
400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteFailoverPolicy - 作成または更新要求には、読み取り/書き込みエンドポイントの failoverPolicy フィールドが必要です。
400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy - 読み取り/書き込みエンドポイントでフェールオーバーポリシーの手動が選択されている場合は、猶予期間値を指定しないでください。
400 InstanceFailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified - インスタンスの作成または更新のフェールオーバーグループ要求本文で、読み取り専用プロパティ '{0}' を変更しないでください。
400 InstanceFailoverGroupFailoverRequestOnPrimary - フェールオーバー要求は、インスタンスフェールオーバーグループのセカンダリサーバーで開始する必要があります。
400 InstanceFailoverGroupPartnerManagedInstanceFromDifferentSubscription - フェールオーバーグループのプライマリサーバーとパートナーサーバーは、異なるサブスクリプションから取得されます。フェールオーバーグループのサーバーのクロスサブスクリプションは許可されません。
400 InvalidAddSecondaryPermission - 指定されたサーバーにセカンダリを追加するための十分なアクセス許可がありません。
400 InvalidSku - ユーザーが無効な SKU を指定しました。
400 ServerNotFound - 要求されたサーバーが見つかりませんでした。
400 ServerEditionMismatch - エディションは、レプリカサーバーの作成時にプライマリサーバーと同じである必要があります。
400 FeatureDisabledOnSelectedEdition - ユーザーは、現在のデータベースエディションで無効になっている機能を使用しようとしました。
400 TokenTooLong - 指定されたトークンが長すぎます。
400 InvalidTargetSubregion - 読み取り不可能なセカンダリのターゲットサーバーが、DR ペアの Azure リージョンにありません。
400 ManagedInstanceStoppingOrStopped - インスタンスが停止/停止状態にある間に送信された操作の競合
400 ManagedInstanceStarting - インスタンスが開始状態の間に送信された操作の競合
400 IncorrectReplicationLinkState - この操作では、データベースがレプリケーションリンクで予期された状態であることが想定されます。
400 CloudLifterFogInaccessibleDbRoleMismatch - データベースがアクセスできない状態にある間にフェールオーバーグループのインスタンスロールが {0} から {1} に変更されたため、SQL Managed Instance {2} のデータベース {3} にアクセスできません。 geo フェールオーバーを実行して元のデータベースロールを復元してから、もう一度やり直してください。
400 CloudLifterGeodrBlocksDbActivate - 継続的な geodr 操作により、SQL Managed Instance 上のデータベース {0} にアクセス {1} できません。競合する操作が完了するまで待ってから、もう一度やり直してください。
400 AzureKeyVaultKeyDisabled - Azure Key Vault キーが無効になっているため、サーバーで操作を完了できませんでした。
400 AzureKeyVaultInvalidExpirationDate - Azure Key Vault キーの有効期限が無効であるため、操作を完了できませんでした。
400 SecurityAzureKeyVaultUrlNullOrEmpty - Azure Key Vault URI が null または空であるため、操作を完了できませんでした。
400 AzureKeyVaultNoServerIdentity - サーバー ID が正しく構成されていません。
400 AzureKeyVaultInvalidUri - Azure Key Vault からの無効な応答。有効な Azure Key Vault URI を使用してください。
400 AzureKeyVaultMissingPermissions - サーバーに Azure Key Vault に必要なアクセス許可がありません。
400 SecurityAzureKeyVaultInvalidKeyName - 無効なサーバーキー名のため、操作を完了できませんでした。
400 PlannedFailoverTimedOutForDatabase - ユーザーが計画されたフェールオーバーを呼び出し、タイムアウトし、特定のデータベースが非難されるように見えます。
400 PlannedFailoverTimedOut - ユーザーが計画されたフェールオーバーを呼び出し、パートナー管理サービスに問い合わせようとしているときにタイムアウトしました。
400 AdalGenericError - Azure Active Directory エラーが発生したため、操作を完了できませんでした。
400 AdalServicePrincipalNotFound - Azure Active Directory ライブラリのサービスプリンシパルが見つからないエラーが発生したため、操作を完了できませんでした。
400 AzureKeyVaultMalformedVaultUri - 指定された Key Vault URI が無効です。
400 CannotUseReservedDatabaseName - この操作で予約済みデータベース名を使用できません。
400 InvalidFailoverGroupRegion - インスタンスフェールオーバーグループで指定されたサーバーは、分離を提供するために異なるリージョンに存在する必要があります。
400 InstanceFailoverGroupDoesNotExist - フェールオーバーグループがサーバー上に存在しません。
400 InstanceFailoverGroupNotSecondary - インスタンスフェールオーバーグループ内のプライマリサーバーからフェールオーバーを開始できません。
400 ManagedInstanceGeoDRNotAllowedForInstancePool - インスタンスプール内にプロビジョニングされたマネージドインスタンスでは、自動フェールオーバーグループ (GeoDR) の作成はサポートされていません。自動フェールオーバーグループは、スタンドアロン Managed Instance に対してのみ作成できます。
400 InvalidServerName - 無効なサーバー名が指定されました。
400 ManagedInstanceEstablishingFailoverGroupGeoPrimaryWithNewerVersionEditionThanSecondary - プライマリインスタンスのデータベース形式がセカンダリインスタンスのデータベース形式と互換性がないため、フェールオーバーグループを作成できません。詳細については、https://go.microsoft.com/fwlink/?linkid=2251601 を参照してください。
400 ManagedInstanceFailoverInFailoverGroupInstancesWithDifferentVersionEditions - フェールオーバーグループ内のインスタンス間でデータベース形式が一致しないため、フェールオーバー操作を実行できません。プライマリインスタンスのデータベース形式をアップグレードするか、フェールオーバーグループを削除して現在のセカンダリインスタンスをスタンドアロンインスタンスに昇格することを検討してください。詳細については、https://go.microsoft.com/fwlink/?linkid=2251601 を参照してください。
400 SecurityAdalPrincipalCertExpiredError - Azure Key Vault プリンシパル証明書の有効期限が切れているため、操作を完了できませんでした。
400 ManagedInstanceNotAllowedInGeoDRSetupWhenFreemium - 無料の Azure SQL Managed Instance オファーでは、フェールオーバーグループのデプロイはサポートされていません。
400 InvalidIdentifier - 識別子に NULL または無効な Unicode 文字が含まれています。
400 SecurityInvalidAzureKeyVaultRecoveryLevel - 指定された Key Vault URI が無効です。
400 ManagedInstanceGeoFailoverCannotBeExecuted - 現時点では、Managed Instance geo フェールオーバーを実行できません。理由: '{0}'。
400 KeyMaterialNotFoundOnRemoteServer - リモートサーバーは、TDE 保護機能として使用されるキーマテリアルにアクセスできません。
400 SameKeyUriNotFoundOnRemoteServer - セカンダリサーバーには、キーの自動ローテーションが有効になっているプライマリサーバーの暗号化保護機能と同じキーコンテナーのキーマテリアルがありません。
400 AzureKeyVaultRsaKeyNotSupported - 提供されたキーコンテナーでは、サポートされていない RSA キーサイズまたはキーの種類が使用されます。サポートされている RSA キーサイズは 2048 または 3072 で、キーの種類は RSA または RSA-HSM です。
400 SameKeyMaterialNotFoundOnRemoteServer - セカンダリサーバーには、プライマリサーバーの暗号化保護機能のキーマテリアルがありません。
400 GeoReplicationDatabaseNotSecondary - この操作では、データベースがレプリケーションターゲットであることが想定されます。
400 ManagedInstanceUpdateSloOngoing - マネージドインスタンス '{0}' のサービスレベルの変更が進行中のため、操作を完了できませんでした。進行中の操作が完了するまで待ってから、もう一度やり直してください。
400 FailoverGroupRegionMismatch - フェールオーバーグループで指定されたパートナーリージョンは、指定されたパートナーマネージドインスタンスのリージョンと一致する必要があります。
400 DnsZoneMismatch - パートナーサーバーの DNSZone は、ソースサーバーの DNSZone とは異なります。これにより、InstanceFailoverGroup の機能が中断されます。
400 GeoDrInstanceSizeMismatch - プライマリマネージドインスタンスとパートナーマネージドインスタンスのストレージサイズが同じではありません。
400 UnableToResolveRemoteServer - 無効なサーバー名または DNS 接続の問題が原因で、リモートパートナーサーバー名を解決できませんでした。
400 GeoDrSecondaryInstanceNotEmpty - セカンダリマネージドインスタンスにはユーザーデータベースがあります。インスタンスフェールオーバーグループを作成するには、セカンダリマネージドインスタンスを空にする必要があります。
400 RemoteDatabaseCopyPermission - 指定されたサーバーにデータベースコピーを作成するための十分な権限がありません。
400 InstanceFailoverGroupIncorrectNetworkingConfiguration - ネットワーク構成が正しくありません。プライマリサーバーのレプリケーショントラフィックがセカンダリサーバーに到達できません。
404 ResourceNotFound - 要求されたリソースが見つかりませんでした。
404 ServerNotInSubscriptionResourceGroup - 指定されたサーバーが、指定されたリソースグループとサブスクリプションに存在しません。
404 ServerNotInSubscription - 指定されたサーバーが指定されたサブスクリプションに存在しません。
404 SourceDatabaseNotFound - ソースデータベースが存在しません。
405 UnsupportedReplicationOperation - サポートされていないレプリケーション操作がデータベースで開始されました。
409 ConflictingServerOperation - サーバーに対する操作が現在進行中です。
409 SubscriptionDisabled - サブスクリプションが無効になっています。
409 ConflictingSystemOperationInProgress - データベースでシステムメンテナンス操作が進行中であり、それ以上の操作が完了するまで待機する必要があります。
409 ManagedInstanceContainsInaccessibleDatabases - マネージドインスタンス '{0}' にアクセスできない状態のデータベースが含まれているため、操作を完了できませんでした。操作を再試行する前に、アクセスできないデータベースを削除するか、マネージドインスタンスのカスタマーマネージド TDE 保護機能キーへのアクセスに関する問題を修正してください。 https://go.microsoft.com/fwlink/?linkid=2111623
409 ManagedInstanceHasHybridLink - マネージドインスタンスにハイブリッドリンクが構成されている場合にサポートされていない操作を開始しようとしました。
409 GeoReplicationCannotBecomePrimaryDuringUndo - ユーザーが geo リンクをフェールオーバーまたは強制終了しようとしましたが、セカンダリが物理的に一貫性がないため、プライマリロールを入力できない状態です。
409 ServerKeyNameAlreadyExists - サーバー上にサーバーキーが既に存在します。
409 ServerKeyUriAlreadyExists - サーバー上にサーバーキー URI が既に存在します。
409 ServerKeyDoesNotExists - サーバーキーが存在しません。
409 UpdateSloInProgress - SLO 更新の進行中に、ユーザーが互換性のない操作を開始しようとしました。
409 AzureKeyVaultKeyNameNotFound - Azure Key Vault キー名が存在しないため、操作を完了できませんでした。
409 AzureKeyVaultKeyInUse - キーは現在サーバーによって使用されています。
409 InstanceFailoverGroupAlreadyExists - フェールオーバーグループは、特定のサーバーに既に存在します。
409 InstanceFailoverGroupBusy - インスタンスフェールオーバーグループが別の操作でビジー状態です。
409 InstanceFailoverGroupDnsRecordInUse - 要求されたエンドポイントに重複する DNS レコードが存在します。
409 InvalidFailoverGroupName - 無効なインスタンスフェールオーバーグループ名が指定されました。
409 InvalidOperationForDatabaseNotInReplicationRelationship - レプリケーション関係にないデータベースに対してレプリケーション操作が実行されました。
409 InvalidDatabaseStateForOperation - この操作は、現在のレプリケーション状態のデータベースでは許可されません。
409 DuplicateGeoDrRelation - データベースは既にレプリケーション関係にあります。これは重複する要求です。
409 RemoteDatabaseExists - コピー先のデータベース名は、既に移行先サーバーに存在します。
429 SubscriptionTooManyCreateUpdateRequests - 使用可能なリソースによって処理できる最大要求を超える要求。
429 SubscriptionTooManyRequests - 使用可能なリソースによって処理できる最大要求を超える要求。
503 TooManyRequests - 使用可能なリソースによって処理できる最大要求を超える要求。
503 AzureKeyVaultConnectionFailed - Azure Key Vault への接続が失敗したため、サーバーで操作を完了できませんでした
503 AzureKeyVaultGenericConnectionError - Key Vault 情報を取得しようとしたときにエラーが発生したため、操作を完了できませんでした。
504 RequestTimeout - サービス要求が許可されたタイムアウトを超えました。

例

Get failover group

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/Japan East/instanceFailoverGroups/failover-group-test?api-version=2023-08-01

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/InstanceFailoverGroupGet.json
// this example is just showing the usage of "InstanceFailoverGroups_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this InstanceFailoverGroupResource created on azure
// for more information of creating InstanceFailoverGroupResource, please refer to the document of InstanceFailoverGroupResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "Default";
AzureLocation locationName = new AzureLocation("Japan East");
string failoverGroupName = "failover-group-test";
ResourceIdentifier instanceFailoverGroupResourceId = InstanceFailoverGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, locationName, failoverGroupName);
InstanceFailoverGroupResource instanceFailoverGroup = client.GetInstanceFailoverGroupResource(instanceFailoverGroupResourceId);

// invoke the operation
InstanceFailoverGroupResource result = await instanceFailoverGroup.GetAsync();

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
InstanceFailoverGroupData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/JapanEast/instanceFailoverGroups/failover-group-test-3",
  "name": "failover-group-test-3",
  "type": "Microsoft.Sql/locations/instanceFailoverGroups",
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 480
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Disabled"
    },
    "replicationRole": "Primary",
    "replicationState": "CATCH_UP",
    "partnerRegions": [
      {
        "location": "Japan West",
        "replicationRole": "Secondary"
      }
    ],
    "managedInstancePairs": [
      {
        "primaryManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-primary-mngdInstance",
        "partnerManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-secondary-mngdInstance"
      }
    ],
    "secondaryType": "Geo"
  }
}

定義

名前	説明
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
InstanceFailoverGroup	インスタンスフェールオーバーグループ。
InstanceFailoverGroupReadOnlyEndpoint	フェールオーバーグループインスタンスの読み取り専用エンドポイント。
InstanceFailoverGroupReadWriteEndpoint	フェールオーバーグループインスタンスの読み取り/書き込みエンドポイント。
InstanceFailoverGroupReplicationRole	フェールオーバーグループインスタンスのローカルレプリケーションロール。
ManagedInstancePairInfo	フェールオーバーグループ内のマネージドインスタンスのペア。
PartnerRegionInfo	フェールオーバーグループのパートナーリージョン情報。
ReadOnlyEndpointFailoverPolicy	フェールオーバーグループの読み取り専用エンドポイントのフェールオーバーポリシー。
ReadWriteEndpointFailoverPolicy	フェールオーバーグループの読み取り/書き込みエンドポイントのフェールオーバーポリシー。 failoverPolicy が自動の場合、failoverWithDataLossGracePeriodMinutes が必要です。
SecondaryInstanceType	geo セカンダリインスタンスの種類。インスタンスが DR オプションとしてのみ使用されている場合は、"スタンバイ" を設定します。

ErrorAdditionalInfo

Object

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

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

ErrorDetail

Object

エラーの詳細。

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

ErrorResponse

Object

エラー応答

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

InstanceFailoverGroup

Object

インスタンスフェールオーバーグループ。

名前	型	説明
id	string	リソース ID。
name	string	リソース名。
properties.managedInstancePairs	ManagedInstancePairInfo[]	フェールオーバーグループ内のマネージドインスタンスペアの一覧。
properties.partnerRegions	PartnerRegionInfo[]	フェールオーバーグループのパートナーリージョン情報。
properties.readOnlyEndpoint	InstanceFailoverGroupReadOnlyEndpoint	フェールオーバーグループインスタンスの読み取り専用エンドポイント。
properties.readWriteEndpoint	InstanceFailoverGroupReadWriteEndpoint	フェールオーバーグループインスタンスの読み取り/書き込みエンドポイント。
properties.replicationRole	InstanceFailoverGroupReplicationRole	フェールオーバーグループインスタンスのローカルレプリケーションロール。
properties.replicationState	string	フェールオーバーグループインスタンスのレプリケーション状態。
properties.secondaryType	SecondaryInstanceType	geo セカンダリインスタンスの種類。インスタンスが DR オプションとしてのみ使用されている場合は、"スタンバイ" を設定します。
type	string	リソースの種類。

InstanceFailoverGroupReadOnlyEndpoint

Object

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

名前	型	説明
failoverPolicy	ReadOnlyEndpointFailoverPolicy	フェールオーバーグループの読み取り専用エンドポイントのフェールオーバーポリシー。

InstanceFailoverGroupReadWriteEndpoint

Object

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

名前	型	説明
failoverPolicy	ReadWriteEndpointFailoverPolicy	フェールオーバーグループの読み取り/書き込みエンドポイントのフェールオーバーポリシー。 failoverPolicy が自動の場合、failoverWithDataLossGracePeriodMinutes が必要です。
failoverWithDataLossGracePeriodMinutes	integer (int32)	読み取り/書き込みエンドポイントに対して、データ損失によるフェールオーバー前の猶予期間が試行されます。 failoverPolicy が自動の場合、failoverWithDataLossGracePeriodMinutes が必要です。

InstanceFailoverGroupReplicationRole

列挙

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

値	説明
Primary
Secondary

ManagedInstancePairInfo

Object

フェールオーバーグループ内のマネージドインスタンスのペア。

名前	型	説明
partnerManagedInstanceId	string	ペアのパートナーマネージドインスタンスの ID。
primaryManagedInstanceId	string	ペアのプライマリマネージドインスタンスの ID。

PartnerRegionInfo

Object

フェールオーバーグループのパートナーリージョン情報。

名前	型	説明
location	string	パートナーマネージドインスタンスの地理的な場所。
replicationRole	InstanceFailoverGroupReplicationRole	パートナーマネージドインスタンスのレプリケーションロール。

ReadOnlyEndpointFailoverPolicy

列挙

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

値	説明
Disabled
Enabled

ReadWriteEndpointFailoverPolicy

列挙

フェールオーバーグループの読み取り/書き込みエンドポイントのフェールオーバーポリシー。 failoverPolicy が自動の場合、failoverWithDataLossGracePeriodMinutes が必要です。

値	説明
Manual
Automatic

SecondaryInstanceType

列挙

geo セカンダリインスタンスの種類。インスタンスが DR オプションとしてのみ使用されている場合は、"スタンバイ" を設定します。

値	説明
Geo
Standby

次の方法で共有

Instance Failover Groups - Get

URI パラメーター

応答

例

Get failover group

要求のサンプル

応答のサンプル

定義

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

InstanceFailoverGroup

InstanceFailoverGroupReadOnlyEndpoint

InstanceFailoverGroupReadWriteEndpoint

InstanceFailoverGroupReplicationRole

ManagedInstancePairInfo

PartnerRegionInfo

ReadOnlyEndpointFailoverPolicy

ReadWriteEndpointFailoverPolicy

SecondaryInstanceType