Distributed Availability Groups - List By Instance
インスタンス内の分散型可用性グループの一覧を取得します。
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/distributedAvailabilityGroups?api-version=2023-08-01
URI パラメーター
| 名前 | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
managed
|
path | True |
string |
マネージド インスタンスの名前。 |
|
resource
|
path | True |
string |
リソースを含むリソース グループの名前。 この値は、Azure Resource Manager API またはポータルから取得できます。 |
|
subscription
|
path | True |
string |
Azure サブスクリプションを識別するサブスクリプション ID。 |
|
api-version
|
query | True |
string |
要求に使用する API バージョン。 |
応答
| 名前 | 型 | 説明 |
|---|---|---|
| 200 OK |
分散型可用性グループの一覧が正常に取得されました。 |
|
| Other Status Codes |
エラー応答: ***
|
例
Lists all distributed availability groups in instance.
要求のサンプル
応答のサンプル
{
"value": [
{
"properties": {
"distributedAvailabilityGroupName": "dag",
"distributedAvailabilityGroupId": "c856cff5-a6fe-418e-8894-17799cc20f5d",
"replicationMode": "Async",
"partnerLinkRole": "Secondary",
"partnerAvailabilityGroupName": "BoxLocalAg1",
"partnerEndpoint": "TCP://SERVER:7022",
"instanceLinkRole": "Primary",
"instanceAvailabilityGroupName": "testcl",
"failoverMode": "None",
"seedingMode": "Automatic",
"databases": [
{
"databaseName": "testdb",
"instanceReplicaId": "4713ed91-1e8c-497d-9bd4-d8a3935ae49a",
"partnerReplicaId": "8ffa9723-a1ec-4323-b929-c4aedee3894b",
"replicaState": "Catchup",
"synchronizationHealth": "HEALTHY",
"connectedState": "CONNECTED",
"lastReceivedLsn": "71000009407900001",
"lastReceivedTime": "2023-08-01T00:00:00Z",
"lastCommitLsn": "71000009407900004",
"lastCommitTime": "2023-08-01T00:00:00Z",
"lastHardenedLsn": "71000009408100001",
"lastHardenedTime": "2023-08-01T00:00:00Z",
"lastBackupLsn": "71000009405700001",
"lastBackupTime": "2023-08-01T00:00:00Z",
"instanceSendReplicationLagSeconds": 1,
"instanceRedoReplicationLagSeconds": 1
}
]
},
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/distributedAvailabilityGroups/dag",
"name": "dag",
"type": "Microsoft.Sql/managedInstances/distributedAvailabilityGroups"
},
{
"properties": {
"distributedAvailabilityGroupName": "dag2",
"distributedAvailabilityGroupId": "8a52d869-c17e-4546-ab03-e038569e672a",
"replicationMode": "Async",
"partnerLinkRole": "Primary",
"partnerAvailabilityGroupName": "BoxLocalAg2",
"partnerEndpoint": "TCP://SERVER:7022",
"instanceLinkRole": "Secondary",
"instanceAvailabilityGroupName": "testcl2",
"databases": [
{
"databaseName": "testdb2",
"instanceReplicaId": "81608df4-0840-4219-b3ae-9cc46be9dae9",
"partnerReplicaId": "57bc3421-e77a-4fdc-8a62-af105c4b1e38",
"replicaState": "Seeding",
"seedingProgress": "80%",
"synchronizationHealth": "HEALTHY",
"connectedState": "CONNECTED",
"lastReceivedLsn": "71000009407900001",
"lastReceivedTime": "2023-08-01T00:00:00Z",
"lastCommitLsn": "71000009407900004",
"lastCommitTime": "2023-08-01T00:00:00Z",
"lastHardenedLsn": "71000009408100001",
"lastHardenedTime": "2023-08-01T00:00:00Z",
"lastBackupLsn": "71000009405700001",
"lastBackupTime": "2023-08-01T00:00:00Z"
}
]
},
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/distributedAvailabilityGroups/dag2",
"name": "dag2",
"type": "Microsoft.Sql/managedInstances/distributedAvailabilityGroups"
}
]
}
定義
| 名前 | 説明 |
|---|---|
|
Certificate |
証明書情報 |
|
Distributed |
Box と Sql Managed Instance の間の分散型可用性グループ。 |
|
Distributed |
データベース固有の情報 |
|
Distributed |
インスタンス内の分散型可用性グループの一覧。 |
|
Error |
リソース管理エラーの追加情報。 |
|
Error |
エラーの詳細。 |
|
Error |
エラー応答 |
|
Failover |
リンク フェールオーバー モードは、サポートされている SQL Server を使用した双方向フェールオーバーに使用する場合は手動、Azure への一方向フェールオーバーでは None にすることができます。 |
|
Link |
SQL サーバー側のリンクの役割 |
|
Replica |
リンク接続状態 |
|
Replica |
リンクの正常性状態 |
|
Replication |
リンクのレプリケーション モード |
|
Seeding |
データベース シードモード – サポートされているシナリオでは、自動 (既定)、または手動にすることができます。 |
CertificateInfo
証明書情報
| 名前 | 型 | 説明 |
|---|---|---|
| certificateName |
string |
証明書名 |
| expiryDate |
string (date-time) |
証明書の有効期限 |
DistributedAvailabilityGroup
Box と Sql Managed Instance の間の分散型可用性グループ。
| 名前 | 型 | 説明 |
|---|---|---|
| id |
string |
リソース ID。 |
| name |
string |
リソース名。 |
| properties.databases |
分散型可用性グループ内のデータベース |
|
| properties.distributedAvailabilityGroupId |
string (uuid) |
分散型可用性グループの ID |
| properties.distributedAvailabilityGroupName |
string |
分散型可用性グループの名前 |
| properties.failoverMode |
リンク フェールオーバー モードは、サポートされている SQL Server を使用した双方向フェールオーバーに使用する場合は手動、Azure への一方向フェールオーバーでは None にすることができます。 |
|
| properties.instanceAvailabilityGroupName |
string |
マネージド インスタンス側の可用性グループ名 |
| properties.instanceLinkRole |
マネージド インスタンス側のリンク ロール |
|
| properties.partnerAvailabilityGroupName |
string |
SQL サーバー側の可用性グループ名 |
| properties.partnerEndpoint |
string |
SQL サーバー側のエンドポイント - IP または DNS 解決可能な名前 |
| properties.partnerLinkRole |
SQL サーバー側のリンクの役割 |
|
| properties.replicationMode |
リンクのレプリケーション モード |
|
| properties.seedingMode |
データベース シードモード – サポートされているシナリオでは、自動 (既定)、または手動にすることができます。 |
|
| type |
string |
リソースの種類。 |
DistributedAvailabilityGroupDatabase
データベース固有の情報
| 名前 | 型 | 説明 |
|---|---|---|
| connectedState |
リンク接続状態 |
|
| databaseName |
string |
リンク内のデータベースの名前 |
| instanceRedoReplicationLagSeconds |
integer (int32) |
Managed Instance のリンク側がプライマリである場合の再実行ラグ |
| instanceReplicaId |
string (uuid) |
マネージド インスタンスのレプリカ ID |
| instanceSendReplicationLagSeconds |
integer (int32) |
Managed Instance のリンク側がプライマリの場合のレプリケーションのラグ |
| lastBackupLsn |
string |
最終バックアップ LSN |
| lastBackupTime |
string (date-time) |
最終バックアップ LSN 時刻 |
| lastCommitLsn |
string |
最後のコミット LSN |
| lastCommitTime |
string (date-time) |
最終コミット LSN 時刻 |
| lastHardenedLsn |
string |
最後に強化された LSN |
| lastHardenedTime |
string (date-time) |
最後に強化された LSN 時間 |
| lastReceivedLsn |
string |
最後に受信した LSN |
| lastReceivedTime |
string (date-time) |
最後に受信した LSN 時刻 |
| lastSentLsn |
string |
最後に送信された LSN |
| lastSentTime |
string (date-time) |
最後に送信された LSN 時刻 |
| mostRecentLinkError |
string |
最新のリンク接続エラーの説明 |
| partnerAuthCertValidity |
SQL Server 証明書の有効性 |
|
| partnerReplicaId |
string (uuid) |
SQL Server レプリカ ID |
| replicaState |
string |
現在のリンクの状態 |
| seedingProgress |
string |
シード処理の進行状況 |
| synchronizationHealth |
リンクの正常性状態 |
DistributedAvailabilityGroupsListResult
インスタンス内の分散型可用性グループの一覧。
| 名前 | 型 | 説明 |
|---|---|---|
| nextLink |
string |
結果の次のページを取得するためのリンク。 |
| value |
結果の配列。 |
ErrorAdditionalInfo
リソース管理エラーの追加情報。
| 名前 | 型 | 説明 |
|---|---|---|
| info |
object |
追加情報。 |
| type |
string |
追加情報の種類。 |
ErrorDetail
エラーの詳細。
| 名前 | 型 | 説明 |
|---|---|---|
| additionalInfo |
エラーの追加情報。 |
|
| code |
string |
エラー コード。 |
| details |
エラーの詳細。 |
|
| message |
string |
エラー メッセージ。 |
| target |
string |
エラーターゲット。 |
ErrorResponse
エラー応答
| 名前 | 型 | 説明 |
|---|---|---|
| error |
エラー オブジェクト。 |
FailoverModeType
リンク フェールオーバー モードは、サポートされている SQL Server を使用した双方向フェールオーバーに使用する場合は手動、Azure への一方向フェールオーバーでは None にすることができます。
| 値 | 説明 |
|---|---|
| None | |
| Manual |
LinkRole
SQL サーバー側のリンクの役割
| 値 | 説明 |
|---|---|
| Primary | |
| Secondary |
ReplicaConnectedState
リンク接続状態
| 値 | 説明 |
|---|---|
| DISCONNECTED | |
| CONNECTED |
ReplicaSynchronizationHealth
リンクの正常性状態
| 値 | 説明 |
|---|---|
| NOT_HEALTHY | |
| PARTIALLY_HEALTHY | |
| HEALTHY |
ReplicationModeType
リンクのレプリケーション モード
| 値 | 説明 |
|---|---|
| Async | |
| Sync |
SeedingModeType
データベース シードモード – サポートされているシナリオでは、自動 (既定)、または手動にすることができます。
| 値 | 説明 |
|---|---|
| Automatic | |
| Manual |