Items - List Restorable Deleted Databases
Ruft die Liste der wiederherstellbaren gelöschten Datenbanken im Arbeitsbereich ab.
Hinweis
PITR aus gelöschten Datenbanken befindet sich derzeit in der Vorschau (weitere Informationen).
Erlaubnisse
Der Aufrufer muss über eine Rolle des Viewer-Arbeitsbereichs verfügen.
Der Aufrufer muss Über Lese- und Schreibberechtigungen für die SQL-Datenbank verfügen.
Erforderliche delegierte Zugriffsbereiche
SQLDatabase.ReadWrite.All oder Item.ReadWrite.All
Von Microsoft Entra unterstützte Identitäten
Diese API unterstützt die in diesem Abschnitt aufgeführten Microsoft Identitäten.
| Identität | Support |
|---|---|
| Benutzer | Ja |
| Service Principal und Verwaltete Identitäten | Ja |
Schnittstelle
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-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
workspace
|
path | True |
string (uuid) |
Der Arbeitsbereichsbezeichner. |
|
recursive
|
query |
boolean |
Listet Elemente in einem Ordner und seinen geschachtelten Ordnern oder nur einen Ordner auf. True – Alle Elemente im Ordner und die zugehörigen geschachtelten Ordner werden aufgelistet, False – Nur Elemente im Ordner werden aufgelistet. Der Standardwert lautet „true“. |
|
|
root
|
query |
string (uuid) |
Mit diesem Parameter können Benutzer Elemente basierend auf einem bestimmten Stammordner filtern. Wenn nicht angegeben, wird der Arbeitsbereich als Stammordner verwendet. |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
Der Auftrag wurde erfolgreich abgeschlossen. |
|
| 429 Too Many Requests |
Der Dienstratenlimit wurde überschritten. Der Server gibt einen Header Retry-After: integer |
|
| Other Status Codes |
Häufige Fehlercodes:
|
Beispiele
Get restorable deleted databases example
Beispielanforderung
GET https://api.fabric.microsoft.com/v1/workspaces/f089354e-8366-4e18-aea3-4cb4a3a50b48/sqlDatabases/restorableDeletedDatabases
Beispiel für eine Antwort
{
"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"
}
}
]
}
Definitionen
| Name | Beschreibung |
|---|---|
|
Error |
Ein strukturierter Parameter, der zusätzlichen computerlesbaren Kontext zu einem Fehler bereitstellt. |
|
Error |
Das Objekt der fehlerbezogenen Ressourcendetails. |
|
Error |
Die Fehlerantwort. |
|
Error |
Die Fehlerantwortdetails. |
|
Restorable |
Ein wiederhergestelltes gelöschtes SQL-Datenbankobjekt. |
|
Restorable |
Die wiederhergestellten gelöschten SQL-Datenbankeigenschaften. |
|
Restorable |
Eine Liste der wiederherstellbaren gelöschten SQL-Datenbanken. |
ErrorParameter
Ein strukturierter Parameter, der zusätzlichen computerlesbaren Kontext zu einem Fehler bereitstellt.
| Name | Typ | Beschreibung |
|---|---|---|
| message |
string |
Eine lesbare Beschreibung der Bedeutung des Parameters. |
| name |
string |
Die Parameterkennung. |
| value |
string |
Der übergebene Wert |
ErrorRelatedResource
Das Objekt der fehlerbezogenen Ressourcendetails.
| Name | Typ | Beschreibung |
|---|---|---|
| resourceId |
string |
Die Ressourcen-ID, die an dem Fehler beteiligt ist. |
| resourceType |
string |
Der Typ der Ressource, die an dem Fehler beteiligt ist. |
ErrorResponse
Die Fehlerantwort.
| Name | Typ | Beschreibung |
|---|---|---|
| errorCode |
string |
Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht. |
| isRetriable |
boolean |
Wenn true, kann die Anforderung wiederholt werden. Verwenden Sie den |
| message |
string |
Eine menschenlesbare Darstellung des Fehlers. |
| moreDetails |
Liste der zusätzlichen Fehlerdetails. |
|
| parameters |
Strukturierte Parameter, die zusätzlichen maschinenlesbaren Kontext zu dem Fehler bereitstellen. |
|
| relatedResource |
Die fehlerbezogenen Ressourcendetails. |
|
| requestId |
string (uuid) |
ID der Anforderung, die dem Fehler zugeordnet ist. |
ErrorResponseDetails
Die Fehlerantwortdetails.
| Name | Typ | Beschreibung |
|---|---|---|
| errorCode |
string |
Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht. |
| message |
string |
Eine menschenlesbare Darstellung des Fehlers. |
| parameters |
Strukturierte Parameter, die zusätzlichen maschinenlesbaren Kontext zu dem Fehler bereitstellen. |
|
| relatedResource |
Die fehlerbezogenen Ressourcendetails. |
RestorableDeletedSQLDatabase
Ein wiederhergestelltes gelöschtes SQL-Datenbankobjekt.
| Name | Typ | Beschreibung |
|---|---|---|
| displayName |
string |
Der Fabric-Anzeigename der wiederhergestellten gelöschten SQL-Datenbank. |
| properties |
Die wiederhergestellten gelöschten SQL-Datenbankeigenschaften. |
RestorableDeletedSQLDatabaseProperties
Die wiederhergestellten gelöschten SQL-Datenbankeigenschaften.
| Name | Typ | Beschreibung |
|---|---|---|
| deletionTimestamp |
string |
ISO 8601-Zeitstempel für das Löschen der Datenbank in UTC (z. B. "2024-12-01T00:00:00Z"). |
| earliestRestorePoint |
string |
ISO 8601-Zeitstempel für den frühesten Wiederherstellungspunkt der Datenbank in UTC (z. B. "2024-12-01T00:00:00Z"). |
| latestRestorePoint |
string |
ISO 8601-Zeitstempel für den neuesten Wiederherstellungspunkt der Datenbank in UTC (z. B. "2024-12-02T00:00:00Z"). |
| restorableDeletedDatabaseName |
string |
Der Name der wiederherstellbaren gelöschten SQL-Datenbank. Dies ist der Name, der bei der Wiederherstellung aus dieser wiederherstellbaren gelöschten Datenbank in der Erstellungsnutzlast verwendet wird. |
RestorableDeletedSQLDatabases
Eine Liste der wiederherstellbaren gelöschten SQL-Datenbanken.
| Name | Typ | Beschreibung |
|---|---|---|
| continuationToken |
string |
Das Token für den nächsten Resultsetbatch. Wenn keine weiteren Datensätze vorhanden sind, wird sie aus der Antwort entfernt. |
| continuationUri |
string |
Der URI des nächsten Resultsetbatches. Wenn keine weiteren Datensätze vorhanden sind, wird sie aus der Antwort entfernt. |
| value |
Eigenschaften einer wiederherstellbaren gelöschten SQL-Datenbank. |