Managed Databases - List Inaccessible By Instance

マネージド インスタンス内のアクセスできないマネージド データベースの一覧を取得します

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/inaccessibleManagedDatabases?api-version=2025-01-01

URI パラメーター

名前 / 必須 型 説明
managedInstanceName
path True

string

マネージド インスタンスの名前。

resourceGroupName
path True

string

minLength: 1
maxLength: 90

リソース グループの名前。 名前の大文字と小文字は区別されません。

subscriptionId
path True

string (uuid)

ターゲット サブスクリプションの ID。 値は UUID である必要があります。

api-version
query True

string

minLength: 1

この操作に使用する API バージョン。

応答

名前 型 説明
200 OK

ManagedDatabaseListResult

Azureの運用は無事に完了しました。

Other Status Codes

ErrorResponse

予期しないエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 Flow.

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前 説明
user_impersonation ユーザー アカウントを偽装する

例

List inaccessible managed databases by managed instances

要求のサンプル

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/inaccessibleManagedDatabases?api-version=2025-01-01

応答のサンプル

{
  "value": [
    {
      "name": "testdb1",
      "type": "Microsoft.Sql/managedInstances/databases",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/databases/testdb1",
      "location": "southeastasia",
      "properties": {
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "creationDate": "2017-08-04T15:00:17.73Z",
        "defaultSecondaryLocation": "North Europe",
        "extendedAccessibilityInfo": {
          "inaccessibilityReasonDescription": "Root cause explanation and mitigation action.",
          "inaccessibilityReasonErrorCode": "1",
          "inaccessibilityReasonKind": "TransparentDataEncryption",
          "inaccessibilityReasonTdeKeyUri": "https://someVault.vault.azure.net/keys/someKey/01234567890123456789012345678901"
        },
        "status": "Inaccessible"
      }
    },
    {
      "name": "testdb2",
      "type": "Microsoft.Sql/managedInstances/databases",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/databases/testdb2",
      "location": "southeastasia",
      "properties": {
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "creationDate": "2017-08-04T15:00:17.73Z",
        "defaultSecondaryLocation": "North Europe",
        "extendedAccessibilityInfo": {
          "inaccessibilityReasonDescription": "Root cause explanation and mitigation action.",
          "inaccessibilityReasonErrorCode": "2",
          "inaccessibilityReasonKind": "DatabaseReplication"
        },
        "status": "Inaccessible"
      }
    }
  ]
}

定義

名前 説明
CatalogCollationType

メタデータ カタログの照合順序。

createdByType

リソースを作成した ID の種類。

ErrorAdditionalInfo

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

ErrorDetail

エラーの詳細。

ErrorResponse

エラー応答

InaccessibilityReason

根本原因の種類。 使用できる値は、"TransparentDataEncryption"、"DatabaseReplication"、および "Unknown" です。

ManagedDatabase

マネージド データベース リソース。

ManagedDatabaseCreateMode

マネージド データベース作成モード。 PointInTimeRestore: 既存のデータベースの特定の時点のバックアップを復元してデータベースを作成します。 SourceDatabaseName、SourceManagedInstanceName、PointInTime を指定する必要があります。 RestoreExternalBackup: 外部バックアップ ファイルから復元してデータベースを作成します。 照合順序、StorageContainerUri、StorageContainerSasToken を指定する必要があります。 復旧: geo レプリケートされたバックアップを復元してデータベースを作成します。 RecoverableDatabaseId は、復元する回復可能なデータベース リソース ID として指定する必要があります。 RestoreLongTermRetentionBackup: 長期保有バックアップから復元してデータベースを作成します (longTermRetentionBackupResourceId が必要)。

ManagedDatabaseExtendedAccessibilityInfo

管理対象データベースの拡張アクセシビリティ情報

ManagedDatabaseListResult

ManagedDatabaseのリスト操作の応答。

ManagedDatabaseStatus

データベースの状態。

systemData

リソースの作成と最後の変更に関連するメタデータ。

CatalogCollationType

メタデータ カタログの照合順序。

値 説明
DATABASE_DEFAULT

DATABASE_DEFAULT

SQL_Latin1_General_CP1_CI_AS

SQL_Latin1_General_CP1_CI_AS

createdByType

リソースを作成した ID の種類。

値 説明
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

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

名前 型 説明
info

object

追加情報。

type

string

追加情報の種類。

ErrorDetail

エラーの詳細。

名前 型 説明
additionalInfo

ErrorAdditionalInfo[]

エラーの追加情報。

code

string

エラー コード。

details

ErrorDetail[]

エラーの詳細。

message

string

エラー メッセージ。

target

string

エラーターゲット。

ErrorResponse

エラー応答

名前 型 説明
error

ErrorDetail

エラー オブジェクト。

InaccessibilityReason

根本原因の種類。 使用できる値は、"TransparentDataEncryption"、"DatabaseReplication"、および "Unknown" です。

値 説明
Unknown

Unknown

TransparentDataEncryption

トランスペアレントデータ暗号化

DatabaseReplication

データベースレプリケーション

ManagedDatabase

マネージド データベース リソース。

名前 型 説明
id

string (arm-id)

リソースの完全修飾リソース ID。 例: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

location

string

リソースが存在する地理的な場所

name

string

リソースの名前

properties.autoCompleteRestore

boolean

このマネージド データベースの復元を自動的に完了するかどうか。

properties.catalogCollation

CatalogCollationType

メタデータ カタログの照合順序。

properties.collation

string

マネージド データベースの照合順序。

properties.createMode

ManagedDatabaseCreateMode

マネージド データベース作成モード。 PointInTimeRestore: 既存のデータベースの特定の時点のバックアップを復元してデータベースを作成します。 SourceDatabaseName、SourceManagedInstanceName、PointInTime を指定する必要があります。 RestoreExternalBackup: 外部バックアップ ファイルから復元してデータベースを作成します。 照合順序、StorageContainerUri、StorageContainerSasToken を指定する必要があります。 復旧: geo レプリケートされたバックアップを復元してデータベースを作成します。 RecoverableDatabaseId は、復元する回復可能なデータベース リソース ID として指定する必要があります。 RestoreLongTermRetentionBackup: 長期保有バックアップから復元してデータベースを作成します (longTermRetentionBackupResourceId が必要)。

properties.creationDate

string (date-time)

データベースの作成日。

properties.crossSubscriptionRestorableDroppedDatabaseId

string

復元可能なサブスクリプション間で、このデータベースの作成時に復元するデータベース リソース ID が削除されました。

properties.crossSubscriptionSourceDatabaseId

string

このデータベースの作成操作に関連付けられているサブスクリプション間ソース データベースのリソース識別子。

properties.crossSubscriptionTargetManagedInstanceId

string

サブスクリプション間の復元で使用されるターゲット マネージド インスタンス ID。

properties.defaultSecondaryLocation

string

geo ペアのリージョン。

properties.earliestRestorePoint

string (date-time)

ポイントインタイム リストアの最も早い復元ポイントインタイム。

properties.extendedAccessibilityInfo

ManagedDatabaseExtendedAccessibilityInfo

「アクセス不能」状態のデータベースに関する追加の可観測性とトラブルシューティング情報。

properties.failoverGroupId

string

このマネージド データベースが属するインスタンス フェールオーバー グループリソース識別子。

properties.isLedgerOn

boolean

このデータベースが台帳データベースであるかどうかは、データベース内のすべてのテーブルが台帳テーブルであることを意味します。 注: このプロパティの値は、データベースの作成後は変更できません。

properties.lastBackupName

string

このマネージド データベースを復元するための最後のバックアップ ファイル名。

properties.longTermRetentionBackupResourceId

string

このマネージド データベースの復元に使用する長期保有バックアップの名前。

properties.recoverableDatabaseId

string

このデータベースの作成操作に関連付けられている回復可能なデータベースのリソース識別子。

properties.restorableDroppedDatabaseId

string

このデータベースの作成時に復元する、復元可能な削除されたデータベース リソース ID。

properties.restorePointInTime

string (date-time)

Conditional. createMode が PointInTimeRestore の場合、この値は必須です。 新しいデータベースを作成するために復元されるソース データベースの時点 (ISO8601形式) を指定します。

properties.sourceDatabaseId

string

このデータベースの作成操作に関連付けられているソース データベースのリソース識別子。

properties.status

ManagedDatabaseStatus

データベースの状態。

properties.storageContainerIdentity

string

Conditional. createMode が RestoreExternalBackup の場合、この値が使用されます。 ストレージ コンテナー認証に使用される ID を指定します。 'SharedAccessSignature' または 'ManagedIdentity' を指定できます。'SharedAccessSignature' が指定されていない場合は、"SharedAccessSignature" と見なされます。

properties.storageContainerSasToken

string

Conditional. createMode が RestoreExternalBackup で、storageContainerIdentity が ManagedIdentity でない場合、この値は必須です。 ストレージ コンテナーの SAS トークンを指定します。

properties.storageContainerUri

string

Conditional. createMode が RestoreExternalBackup の場合、この値は必須です。 この復元のバックアップが格納されるストレージ コンテナーの URI を指定します。

systemData

systemData

create By と modifiedBy の情報を含む Azure Resource Manager メタデータ。

tags

object

リソース タグ。

type

string

リソースの型。 例えば「Microsoft。Compute/virtualMachines」または「Microsoft」などです。ストレージ/ストレージアカウント」

ManagedDatabaseCreateMode

マネージド データベース作成モード。 PointInTimeRestore: 既存のデータベースの特定の時点のバックアップを復元してデータベースを作成します。 SourceDatabaseName、SourceManagedInstanceName、PointInTime を指定する必要があります。 RestoreExternalBackup: 外部バックアップ ファイルから復元してデータベースを作成します。 照合順序、StorageContainerUri、StorageContainerSasToken を指定する必要があります。 復旧: geo レプリケートされたバックアップを復元してデータベースを作成します。 RecoverableDatabaseId は、復元する回復可能なデータベース リソース ID として指定する必要があります。 RestoreLongTermRetentionBackup: 長期保有バックアップから復元してデータベースを作成します (longTermRetentionBackupResourceId が必要)。

値 説明
Default

デフォルト

RestoreExternalBackup

RestoreExternalBackup

PointInTimeRestore

PointInTimeRestore

Recovery

復元

RestoreLongTermRetentionBackup

RestoreLongTermRetentionBackup

ManagedDatabaseExtendedAccessibilityInfo

管理対象データベースの拡張アクセシビリティ情報

名前 型 説明
inaccessibilityReasonDescription

string

根本原因の説明と軽減策。

inaccessibilityReasonErrorCode

string

SQL Serverのエラーコードがアクセス不能の根本原因に関連しています。

inaccessibilityReasonKind

InaccessibilityReason

根本原因の種類。 使用できる値は、"TransparentDataEncryption"、"DatabaseReplication"、および "Unknown" です。

inaccessibilityReasonTdeKeyUri

string

根本原因の種類 "TransparentDataEncryption" の場合、CMK URI。

ManagedDatabaseListResult

ManagedDatabaseのリスト操作の応答。

名前 型 説明
nextLink

string (uri)

項目の次のページへのリンク

value

ManagedDatabase[]

このページのManagedDatabase項目

ManagedDatabaseStatus

データベースの状態。

値 説明
Online

オンライン

Offline

オフライン

Shutdown

シャットダウン

Creating

作成

Inaccessible

アクセス

Restoring

復元

Updating

更新中

Stopping

停車

Stopped

停止済み

Starting

開始中

DbMoving

DbMoving

DbCopying

DbCopying

systemData

リソースの作成と最後の変更に関連するメタデータ。

名前 型 説明
createdAt

string (date-time)

リソース作成のタイムスタンプ (UTC)。

createdBy

string

リソースを作成した ID。

createdByType

createdByType

リソースを作成した ID の種類。

lastModifiedAt

string (date-time)

リソースの最終変更のタイムスタンプ (UTC)

lastModifiedBy

string

リソースを最後に変更した ID。

lastModifiedByType

createdByType

リソースを最後に変更した ID の種類。