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 | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
workspace
|
path | True |
string (uuid) |
ワークスペース識別子。 |
|
recursive
|
query |
boolean |
フォルダー内のアイテムとその入れ子になったフォルダー、または単なるフォルダーのみを一覧表示します。 True - フォルダーとその入れ子になったフォルダー内のすべてのアイテムが一覧表示され、False - フォルダー内の項目のみが一覧表示されます。 既定値は、true です。 |
|
|
root
|
query |
string (uuid) |
このパラメーターを使用すると、ユーザーは特定のルート フォルダーに基づいてアイテムをフィルター処理できます。 指定しない場合、ワークスペースはルート フォルダーとして使用されます。 |
応答
| Name | 型 | 説明 |
|---|---|---|
| 200 OK |
要求は正常に完了しました。 |
|
| 429 Too Many Requests |
サービス レートの制限を超えました。 サーバーは、クライアントが追加の要求を送信するまでに待機する必要がある時間を秒単位で示す ヘッダー Retry-After: integer |
|
| Other Status Codes |
一般的なエラー コード:
|
例
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 | 説明 |
|---|---|
|
Error |
エラーに関する追加のコンピューター読み取り可能なコンテキストを提供する構造化パラメーター。 |
|
Error |
エラー関連のリソース詳細オブジェクト。 |
|
Error |
エラー応答。 |
|
Error |
エラー応答の詳細。 |
|
Restorable |
復元可能な削除済み SQL データベース オブジェクト。 |
|
Restorable |
復元可能な削除済み SQL データベースのプロパティ。 |
|
Restorable |
復元可能な削除済み SQL データベースの一覧。 |
ErrorParameter
エラーに関する追加のコンピューター読み取り可能なコンテキストを提供する構造化パラメーター。
| Name | 型 | 説明 |
|---|---|---|
| message |
string |
パラメーターの意味を人間が判読できる説明。 |
| name |
string |
パラメータ識別子です。 |
| value |
string |
パラメーターの値を指定します。 |
ErrorRelatedResource
エラー関連のリソース詳細オブジェクト。
| Name | 型 | 説明 |
|---|---|---|
| resourceId |
string |
エラーに関係するリソース ID。 |
| resourceType |
string |
エラーに関係するリソースの種類。 |
ErrorResponse
エラー応答。
| Name | 型 | 説明 |
|---|---|---|
| errorCode |
string |
エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。 |
| isRetriable |
boolean |
true の場合、要求を再試行できます。
|
| message |
string |
エラーの人間が理解可能な表現。 |
| moreDetails |
その他のエラーの詳細の一覧。 |
|
| parameters |
エラーに関する追加のコンピューター読み取り可能なコンテキストを提供する構造化パラメーター。 |
|
| relatedResource |
エラー関連のリソースの詳細。 |
|
| requestId |
string (uuid) |
エラーに関連付けられている要求の ID。 |
ErrorResponseDetails
エラー応答の詳細。
| Name | 型 | 説明 |
|---|---|---|
| errorCode |
string |
エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。 |
| message |
string |
エラーの人間が理解可能な表現。 |
| parameters |
エラーに関する追加のコンピューター読み取り可能なコンテキストを提供する構造化パラメーター。 |
|
| relatedResource |
エラー関連のリソースの詳細。 |
RestorableDeletedSQLDatabase
復元可能な削除済み SQL データベース オブジェクト。
| Name | 型 | 説明 |
|---|---|---|
| displayName |
string |
復元可能な削除済み SQL データベースのファブリック表示名。 |
| properties |
復元可能な削除済み 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 |
復元可能な削除済み SQL データベースのプロパティ。 |