Managed Databases - List By Instance
マネージド データベースの一覧を取得します。
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases?api-version=2025-01-01
URI パラメーター
| 名前 | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
managed
|
path | True |
string |
マネージド インスタンスの名前。 |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
リソース グループの名前。 名前の大文字と小文字は区別されません。 |
|
subscription
|
path | True |
string (uuid) |
ターゲット サブスクリプションの ID。 値は UUID である必要があります。 |
|
api-version
|
query | True |
string minLength: 1 |
この操作に使用する API バージョン。 |
応答
| 名前 | 型 | 説明 |
|---|---|---|
| 200 OK |
Azureの運用は無事に完了しました。 |
|
| Other Status Codes |
予期しないエラー応答。 |
セキュリティ
azure_auth
Azure Active Directory OAuth2 Flow.
型:
oauth2
フロー:
implicit
Authorization URL (承認 URL):
https://login.microsoftonline.com/common/oauth2/authorize
スコープ
| 名前 | 説明 |
|---|---|
| user_impersonation | ユーザー アカウントを偽装する |
例
List databases by managed instances
要求のサンプル
GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/managedInstance/databases?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",
"isLedgerOn": false,
"status": "Online"
}
},
{
"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",
"isLedgerOn": false,
"status": "Online"
}
},
{
"name": "testdb3",
"type": "Microsoft.Sql/managedInstances/databases",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/databases/testdb3",
"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"
}
}
]
}
定義
| 名前 | 説明 |
|---|---|
|
Catalog |
メタデータ カタログの照合順序。 |
|
created |
リソースを作成した ID の種類。 |
|
Error |
リソース管理エラーの追加情報。 |
|
Error |
エラーの詳細。 |
|
Error |
エラー応答 |
|
Inaccessibility |
根本原因の種類。 使用できる値は、"TransparentDataEncryption"、"DatabaseReplication"、および "Unknown" です。 |
|
Managed |
マネージド データベース リソース。 |
|
Managed |
マネージド データベース作成モード。 PointInTimeRestore: 既存のデータベースの特定の時点のバックアップを復元してデータベースを作成します。 SourceDatabaseName、SourceManagedInstanceName、PointInTime を指定する必要があります。 RestoreExternalBackup: 外部バックアップ ファイルから復元してデータベースを作成します。 照合順序、StorageContainerUri、StorageContainerSasToken を指定する必要があります。 復旧: geo レプリケートされたバックアップを復元してデータベースを作成します。 RecoverableDatabaseId は、復元する回復可能なデータベース リソース ID として指定する必要があります。 RestoreLongTermRetentionBackup: 長期保有バックアップから復元してデータベースを作成します (longTermRetentionBackupResourceId が必要)。 |
|
Managed |
管理対象データベースの拡張アクセシビリティ情報 |
|
Managed |
ManagedDatabaseのリスト操作の応答。 |
|
Managed |
データベースの状態。 |
|
system |
リソースの作成と最後の変更に関連するメタデータ。 |
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 |
エラーの追加情報。 |
|
| code |
string |
エラー コード。 |
| details |
エラーの詳細。 |
|
| message |
string |
エラー メッセージ。 |
| target |
string |
エラーターゲット。 |
ErrorResponse
エラー応答
| 名前 | 型 | 説明 |
|---|---|---|
| error |
エラー オブジェクト。 |
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 |
メタデータ カタログの照合順序。 |
|
| properties.collation |
string |
マネージド データベースの照合順序。 |
| properties.createMode |
マネージド データベース作成モード。 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 |
「アクセス不能」状態のデータベースに関する追加の可観測性とトラブルシューティング情報。 |
|
| 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 |
データベースの状態。 |
|
| 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 |
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 |
根本原因の種類。 使用できる値は、"TransparentDataEncryption"、"DatabaseReplication"、および "Unknown" です。 |
|
| inaccessibilityReasonTdeKeyUri |
string |
根本原因の種類 "TransparentDataEncryption" の場合、CMK URI。 |
ManagedDatabaseListResult
ManagedDatabaseのリスト操作の応答。
| 名前 | 型 | 説明 |
|---|---|---|
| nextLink |
string (uri) |
項目の次のページへのリンク |
| value |
このページの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 |
リソースを作成した ID の種類。 |
|
| lastModifiedAt |
string (date-time) |
リソースの最終変更のタイムスタンプ (UTC) |
| lastModifiedBy |
string |
リソースを最後に変更した ID。 |
| lastModifiedByType |
リソースを最後に変更した ID の種類。 |