Items - List Restorable Deleted Databases

ワークスペース内の復元可能な削除済みデータベースの一覧を取得します。

注

削除されたデータベースからの PITR は現在プレビュー段階です (詳細については、こちらを参照してください)。

アクセス許可

呼び出し元には ビューアー ワークスペース ロールが必要です。

呼び出し元には、SQL データベースの 読み取りと書き込みの アクセス許可が必要です。

必要な委任スコープ

SQLDatabase.ReadWrite.All または Item.ReadWrite.All

Microsoft Entra でサポートされている ID

この API では、このセクションに記載されている Microsoft ID がサポートされています。

アイデンティティ サポート
User はい
サービス プリンシパルとマネージド ID はい

インターフェイス

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/sqlDatabases/restorableDeletedDatabases
GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/sqlDatabases/restorableDeletedDatabases?recursive={recursive}&rootFolderId={rootFolderId}

URI パラメーター

Name / 必須 型 説明
workspaceId
path True

string (uuid)

ワークスペース識別子。

recursive
query

boolean

フォルダー内のアイテムとその入れ子になったフォルダー、または単なるフォルダーのみを一覧表示します。 True - フォルダーとその入れ子になったフォルダー内のすべてのアイテムが一覧表示され、False - フォルダー内の項目のみが一覧表示されます。 既定値は、true です。

rootFolderId
query

string (uuid)

このパラメーターを使用すると、ユーザーは特定のルート フォルダーに基づいてアイテムをフィルター処理できます。 指定しない場合、ワークスペースはルート フォルダーとして使用されます。

応答

Name 型 説明
200 OK

RestorableDeletedSQLDatabases

要求は正常に完了しました。

429 Too Many Requests

ErrorResponse

サービス レートの制限を超えました。 サーバーは、クライアントが追加の要求を送信するまでに待機する必要がある時間を秒単位で示す Retry-After ヘッダーを返します。

ヘッダー

Retry-After: integer

Other Status Codes

ErrorResponse

一般的なエラー コード:

  • ItemNotFound - 要求された項目が見つかりませんでした。

例

Get restorable deleted databases example

要求のサンプル

GET https://api.fabric.microsoft.com/v1/workspaces/f089354e-8366-4e18-aea3-4cb4a3a50b48/sqlDatabases/restorableDeletedDatabases

応答のサンプル

{
  "value": [
    {
      "displayName": "SQLDatabase1",
      "properties": {
        "restorableDeletedDatabaseName": "SQLDatabase1,134140258788170000",
        "earliestRestorePoint": "2024-12-01T00:00:00.000Z",
        "latestRestorePoint": "2024-12-02T00:00:00.000Z",
        "deletionTimestamp": "2024-12-01T00:00:00.000Z"
      }
    },
    {
      "displayName": "SQLDatabase2",
      "properties": {
        "restorableDeletedDatabaseName": "SQLDatabase2,134140258788470000",
        "earliestRestorePoint": "2024-12-01T00:00:00.000Z",
        "latestRestorePoint": "2024-12-02T00:00:00.000Z",
        "deletionTimestamp": "2024-12-01T00:00:00.000Z"
      }
    }
  ]
}

定義

Name 説明
ErrorParameter

エラーに関する追加のコンピューター読み取り可能なコンテキストを提供する構造化パラメーター。

ErrorRelatedResource

エラー関連のリソース詳細オブジェクト。

ErrorResponse

エラー応答。

ErrorResponseDetails

エラー応答の詳細。

RestorableDeletedSQLDatabase

復元可能な削除済み SQL データベース オブジェクト。

RestorableDeletedSQLDatabaseProperties

復元可能な削除済み SQL データベースのプロパティ。

RestorableDeletedSQLDatabases

復元可能な削除済み SQL データベースの一覧。

ErrorParameter

エラーに関する追加のコンピューター読み取り可能なコンテキストを提供する構造化パラメーター。

Name 型 説明
message

string

パラメーターの意味を人間が判読できる説明。

name

string

パラメータ識別子です。

value

string

パラメーターの値を指定します。

ErrorRelatedResource

エラー関連のリソース詳細オブジェクト。

Name 型 説明
resourceId

string

エラーに関係するリソース ID。

resourceType

string

エラーに関係するリソースの種類。

ErrorResponse

エラー応答。

Name 型 説明
errorCode

string

エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。

isRetriable

boolean

true の場合、要求を再試行できます。 Retry-After応答ヘッダーを使用して、遅延 (使用可能な場合) を決定します。

message

string

エラーの人間が理解可能な表現。

moreDetails

ErrorResponseDetails[]

その他のエラーの詳細の一覧。

parameters

ErrorParameter[]

エラーに関する追加のコンピューター読み取り可能なコンテキストを提供する構造化パラメーター。

relatedResource

ErrorRelatedResource

エラー関連のリソースの詳細。

requestId

string (uuid)

エラーに関連付けられている要求の ID。

ErrorResponseDetails

エラー応答の詳細。

Name 型 説明
errorCode

string

エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。

message

string

エラーの人間が理解可能な表現。

parameters

ErrorParameter[]

エラーに関する追加のコンピューター読み取り可能なコンテキストを提供する構造化パラメーター。

relatedResource

ErrorRelatedResource

エラー関連のリソースの詳細。

RestorableDeletedSQLDatabase

復元可能な削除済み SQL データベース オブジェクト。

Name 型 説明
displayName

string

復元可能な削除済み SQL データベースのファブリック表示名。

properties

RestorableDeletedSQLDatabaseProperties

復元可能な削除済み SQL データベースのプロパティ。

RestorableDeletedSQLDatabaseProperties

復元可能な削除済み SQL データベースのプロパティ。

Name 型 説明
deletionTimestamp

string

データベースを UTC で削除するための ISO 8601 タイムスタンプ (例: '2024-12-01T00:00:00Z')。

earliestRestorePoint

string

データベースの最も古い復元ポイントの ISO 8601 タイムスタンプ (例: '2024-12-01T00:00:00Z')。

latestRestorePoint

string

データベースの最新の復元ポイントの ISO 8601 タイムスタンプ (例: '2024-12-02T00:00:00Z')。

restorableDeletedDatabaseName

string

復元可能な削除済み SQL データベースの名前。 これは、この復元可能な削除されたデータベースから復元するときに作成ペイロードで使用される名前です。

RestorableDeletedSQLDatabases

復元可能な削除済み SQL データベースの一覧。

Name 型 説明
continuationToken

string

次の結果セット バッチのトークン。 これ以上レコードがない場合は、応答から削除されます。

continuationUri

string

次の結果セット バッチの URI。 これ以上レコードがない場合は、応答から削除されます。

value

RestorableDeletedSQLDatabase[]

復元可能な削除済み SQL データベースのプロパティ。