Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Namespace: microsoft.graph
Suchen Sie nach den restorePoint-Objekten , die einer protectionUnit zugeordnet sind. Sie können auch policyId angeben, um den Suchbereich auf eine Schutzrichtlinie zu begrenzen und zu überprüfen, ob die angegebenen Schutzeinheiten zu dieser Richtlinie gehören.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
| Weltweiter Service | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
Berechtigungen
Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
| Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
|---|---|---|
| Delegiert (Geschäfts-, Schul- oder Unikonto) | BackupRestore-Search.Read.All | Nicht verfügbar. |
| Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
| Application | BackupRestore-Search.Read.All | Nicht verfügbar. |
HTTP-Anforderung
POST /solutions/backupRestore/restorePoints/search
Anforderungsheader
| Name | Beschreibung |
|---|---|
| Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung. |
| Content-Type | application/json. Erforderlich. |
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung der folgenden Parameter an.
| Parameter | Typ | Beschreibung |
|---|---|---|
| artifactQuery | artifactQuery | Enthält einen Ausdruck, der die Kriterien für die Suche angibt. Optional. |
| policyId | Zeichenfolge | Der Bezeichner der Schutzrichtlinie, die die angegebenen Schutzeinheiten enthält. Optional. |
| protectionUnitIds | String collection | Die ID der Schutzeinheiten. Erforderlich. |
| protectionTimePeriod | timePeriod | Das Start- und Enddatum und die Uhrzeit des Schutzzeitraums. Erforderlich. |
| restorePointPreference | restorePointPreference | Gibt an, welcher Wiederherstellungspunkt zurückgegeben werden soll. Die möglichen Werte sind oldest, latest. Optional. |
| tags | restorePointTags | Der Typ des Wiederherstellungspunkts. Die möglichen Werte sind None, FastRestore, UnknownFutureValue. Optional. |
restorePointPreference-Werte
| Member | Beschreibung |
|---|---|
| Neuestes | Gibt den spätesten Wiederherstellungspunkt für einen angegebenen Schutzzeitraum zurück. |
| älteste | Gibt den ältesten Wiederherstellungspunkt für einen angegebenen Schutzzeitraum zurück. |
Antwort
Bei erfolgreicher Ausführung gibt diese Aktion einen 200 OK Antwortcode und ein restorePointSearchResponse-Objekt im Antworttext zurück.
Hinweis
- Aufrufe geben einen Wiederherstellungspunkt pro Schutzeinheit zurück.
- Sie können maximal 20 Schutzeinheiten in eine einzelne Anforderung aufnehmen, und die Antwort ist nicht paginiert.
- Wenn Sie einen Ausdruck für die artefaktQuery-Eigenschaft bereitstellen, dürfen Sie nur eine Schutzeinheits-ID in der protectionUnitIds-Eigenschaft angeben.
- Wenn Sie policyId angeben, überprüft der Dienst, ob jede Schutzeinheit zur angegebenen Richtlinie gehört.
Eine Liste möglicher Fehlerantworten finden Sie unter Backup Storage API-Fehlerantworten.
Beispiele
Beispiel 1: Suchanfrage
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
POST https://graph.microsoft.com/v1.0/solutions/backupRestore/restorePoints/search
Content-Type: application/json
{
"policyId": "9fec8e78-bce4-4aaf-ab1b-5451cc387264",
"protectionUnitIds": ["23014d8c-71fe-4d00-a01a-31850bc5b42a", "43014d8c-71fe-4d00-a01a-31850bc5b42b", "63014d8c-71fe-4d00-a01a-31850bc5b42c", "83014d8c-71fe-4d00-a01a-31850bc5b42d"],
"protectionTimePeriod": {
"startDateTime": "2021-01-01T00:00:00Z",
"endDateTime": "2021-01-08T00:00:00Z"
},
"restorePointPreference": "latest",
"tags": "fastRestore"
}
Antwort
- Aufrufe geben maximal fünf Wiederherstellungspunkte zurück.
- Sie können maximal 20 Schutzeinheiten in eine einzelne Anforderung aufnehmen, und die Antwort ist nicht paginiert.
Das folgende Beispiel zeigt die Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context":"/solutions/backupRestore/$metadata#restorePoints",
"searchResponseId": "M2UyZDAwMDAwMDMxMzkzYTMyNj",
"searchResults": [
{
"restorePoint": {
"@odata.type": "#microsoft.graph.restorePoint",
"id":"1f1fccc3-a642-4f61-bf49-f37b9a888279",
"protectionDateTime":"2023-01-04T00:00:00Z",
"expirationDateTime":"2024-01-04T00:00:00Z",
"protectionUnit":{
"@odata.type": "#microsoft.graph.siteProtectionUnit",
"id":"23014d8c-71fe-4d00-a01a-31850bc5b42a",
"siteId":"344d9337-d8f0-456e-92cd-00a3abdd2093",
"policyId":"9fec8e78-bce4-4aaf-ab1b-5451cc387264"
},
"tags": "fastRestore"
}
},
{
"restorePoint": {
"@odata.type": "#microsoft.graph.restorePoint",
"id":"cdf4a823-sfde-ki2s-kmsj-clu2nsdk43ga",
"protectionDateTime":"2023-01-03T00:00:00Z",
"expirationDateTime":"2024-01-03T00:00:00Z",
"protectionUnit":{
"@odata.type": "#microsoft.graph.siteProtectionUnit",
"id":"43014d8c-71fe-4d00-a01a-31850bc5b42b",
"siteId":"344d9337-d8f0-456e-92cd-00a3abdd2093",
"policyId":"9fec8e78-bce4-4aaf-ab1b-5451cc387264"
},
"tags": "fastRestore"
}
},
{
"restorePoint": {
"@odata.type": "#microsoft.graph.restorePoint",
"id":"1f1fccc3-a642-4f61-bf49-f37b9a888280",
"protectionDateTime":"2023-01-02T00:00:00Z",
"expirationDateTime":"2024-01-02T00:00:00Z",
"protectionUnit":{
"@odata.type": "#microsoft.graph.siteProtectionUnit",
"id":"83014d8c-71fe-4d00-a01a-31850bc5b42c",
"siteId":"344d9337-d8f0-456e-92cd-00a3abdd2093",
"policyId":"9fec8e78-bce4-4aaf-ab1b-5451cc387264"
},
"tags": "fastRestore"
}
}
],
"noResultProtectionUnitIds": ["63014d8c-71fe-4d00-a01a-31850bc5b42c"]
}
Beispiel 2: Suche mit artifactQuery-Ausdruck
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
POST https://graph.microsoft.com/v1.0/solutions/backupRestore/restorePoints/search
Content-Type: application/json
{
"artifactQuery": {
"queryExpression": "(Sender -eq 'abc@contoso.com') -and (Subject -like '*Check email*' -or Subject -like ' Important') -and (HasAttachment -eq 'true') -and (PitrDumpsterActionTriggeredTime -gt '{2024-09-21T08:20:00.0000000Z}')",
"artifactType": "message"
},
"protectionUnitIds": ["23014d8c-71fe-4d00-a01a-31850bc5b42a"],
"protectionTimePeriod": {
"startDateTime": "2021-01-01T00:00:00Z"
},
"restorePointPreference": "oldest"
}
Antwort
Das folgende Beispiel zeigt die Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "/solutions/backupRestore/$metadata#restorePoints",
"searchResponseId": "M2UyZDAwMDAwMDMxMzkzYTMyNj",
"searchResults": [
{
"artifactHitCount": 26,
"restorePoint": {
"@odata.type": "#microsoft.graph.restorePoint",
"id": "1f1fccc3-a642-4f61-bf49-f37b9a888279",
"protectionDateTime": "2023-01-04T00:00:00Z",
"expirationDateTime": "2024-01-04T00:00:00Z",
"protectionUnit": {
"@odata.type": "#microsoft.graph.siteProtectionUnit",
"id": "23014d8c-71fe-4d00-a01a-31850bc5b42a",
"siteId": "344d9337-d8f0-456e-92cd-00a3abdd2093",
"policyId": "9fec8e78-bce4-4aaf-ab1b-5451cc387264"
},
"tags": "fastRestore"
}
}
]
}