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
workspaceId
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“.

rootFolderId
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

RestorableDeletedSQLDatabases

Der Auftrag wurde erfolgreich abgeschlossen.

429 Too Many Requests

ErrorResponse

Der Dienstratenlimit wurde überschritten. Der Server gibt einen Retry-After Header zurück, der in Sekunden angibt, wie lange der Client warten muss, bevor zusätzliche Anforderungen gesendet werden.

Header

Retry-After: integer

Other Status Codes

ErrorResponse

Häufige Fehlercodes:

  • ItemNotFound – Das angeforderte Element wurde nicht gefunden.

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
ErrorParameter

Ein strukturierter Parameter, der zusätzlichen computerlesbaren Kontext zu einem Fehler bereitstellt.

ErrorRelatedResource

Das Objekt der fehlerbezogenen Ressourcendetails.

ErrorResponse

Die Fehlerantwort.

ErrorResponseDetails

Die Fehlerantwortdetails.

RestorableDeletedSQLDatabase

Ein wiederhergestelltes gelöschtes SQL-Datenbankobjekt.

RestorableDeletedSQLDatabaseProperties

Die wiederhergestellten gelöschten SQL-Datenbankeigenschaften.

RestorableDeletedSQLDatabases

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 Retry-After Antwortheader, um die Verzögerung zu ermitteln, falls verfügbar.

message

string

Eine menschenlesbare Darstellung des Fehlers.

moreDetails

ErrorResponseDetails[]

Liste der zusätzlichen Fehlerdetails.

parameters

ErrorParameter[]

Strukturierte Parameter, die zusätzlichen maschinenlesbaren Kontext zu dem Fehler bereitstellen.

relatedResource

ErrorRelatedResource

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

ErrorParameter[]

Strukturierte Parameter, die zusätzlichen maschinenlesbaren Kontext zu dem Fehler bereitstellen.

relatedResource

ErrorRelatedResource

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

RestorableDeletedSQLDatabaseProperties

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

RestorableDeletedSQLDatabase[]

Eigenschaften einer wiederherstellbaren gelöschten SQL-Datenbank.