List restorePoints

Пространство имен: microsoft.graph

Получение списка объектов restorePoint и их свойств.

Примечание. Этот API возвращает максимум пять объектов restorePoint . Если этот параметр не включен, orderBy возвращаются пять последних точек восстановления.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальное обслуживание Правительство США L4 Правительство США L5 (DOD) Китай, обслуживаемый 21Vianet
✅ ❌ ❌ ❌

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более высокий уровень привилегий или разрешений, только если это требуется вашему приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в статье Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшим объемом привилегий Разрешения с более высоким уровнем привилегий
Делегированные (рабочая или учебная учетная запись) BackupRestore-Search.Read.All Недоступно.
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Приложение BackupRestore-Search.Read.All Недоступно.

HTTP-запрос

Чтобы отфильтровать точки восстановления по идентификатору защитного блока, выполните следующие действия.

GET /solutions/backupRestore/restorePoints?$expand=protectionUnit($filter=id eq '{ProtectionUnitID}')&$filter=protectionDateTime lt YYYY-MM-DDTHH:mm:ssZ

Чтобы отфильтровать точки восстановления по идентификатору блока защиты и идентификатору политики:

GET /solutions/backupRestore/restorePoints?$expand=protectionUnit&$filter=protectionDateTime lt YYYY-MM-DDTHH:mm:ssZ and protectionUnit/id eq '{protectionUnitId}' and protectionUnit/policyId eq '{policyId}'

Необязательные параметры запросов

Этот метод поддерживает параметры запросов $expand, $filterи orderByOData, как показано в примере далее в этой статье.

Параметры $expand запроса and являются обязательными $filter .

Для фильтрации по идентификатору блока защиты используйте $filter команду "с eqидентификатором$expand" внутри выражения для protectionUnit. Также можно использовать $filter с eq on protectionUnit/id. Чтобы отфильтровать по идентификатору политики, используйте eq в выражении верхнего уровня $filterзначения protectionUnit/policyId. Выражения фильтра верхнего уровня можно комбинировать с оператором and .

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения об аутентификации и авторизации.

Текст запроса

Не указывайте текст запроса для этого метода.

Отклик

В случае успеха этот метод возвращает 200 OK код отклика и коллекцию объектов restorePoint в тексте ответа.

Список возможных ответов на ошибки см. в статье Отклики на ошибки API хранилища резервных копий.

Примеры

Запрос

Ниже показан пример запроса.

GET https://graph.microsoft.com/v1.0/solutions/backupRestore/restorePoints?$expand=protectionUnit&$filter=protectionDateTime lt 2024-05-12T10:01:00Z and protectionUnit/id eq 'd234cf54-e0fb-49b7-9c8a-5bcd1439e853' and protectionUnit/policyId eq '9fec8e78-bce4-4aaf-ab1b-5451cc387264'

Отклик

Ниже показан пример отклика.

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "/solutions/backupRestore/restorePoints",
  "@odata.nextLink": "https://graph.microsoft.com/v1.0/solutions/backupRestore/restorePoints?$skiptoken=M2UyZDAwMDAwMDMxMzkzYTMyNjQ2MTM0NjMzMjM5NjYzNjY0k2NDUwOTgzMg%3d%3d",
  "value": [
    {
      "@odata.type": "#microsoft.graph.restorePoint",
      "id": "cdf4a823-sfde-ki2s-kmsj-clu2nsdkk2as",
      "protectionDateTime": "2023-01-01T00:00:00Z",
      "expirationDateTime": "2024-01-01T00:00:00Z",
      "protectionUnit": {
        "@odata.type": "#microsoft.graph.siteProtectionUnit",
        "id": "32514d8c-71fe-4d00-a01a-31850bc5b32c",
        "siteId": "contoso-jpn.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,0271110f-634f-4300-a841-3a8a2e851852",
        "policyId": "9fec8e78-bce4-4aaf-ab1b-5451cc387264"
      },
      "tags": "fastRestore" // Newly Added
    },
    {
      "@odata.type": "#microsoft.graph.restorePoint",
      "id": "cdf4a823-sfde-ki2s-kmsj-clu2nsdk43as",
      "protectionDateTime": "2023-01-01T00:00:00Z",
      "expirationDateTime": "2024-01-01T00:00:00Z",
      "protectionUnit": {
        "@odata.type": "#microsoft.graph.siteProtectionUnit",
        "id": "17014d8c-71fe-4d00-a01a-31850bc5b32c",
        "siteId": "contoso-jpn.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,0271110f-634f-4300-a841-3a8a2e851861",
        "policyId": "9fec8e78-bce4-4aaf-ab1b-5451cc387264"
      },
      "tags": "fastRestore" // Newly Added
    },
    {
      "@odata.type": "#microsoft.graph.restorePoint",
      "id": "cdf4a823-sfde-ki2s-kmsj-clu2nsdk43ga",
      "protectionDateTime": "2023-01-07T00:00:00Z",
      "expirationDateTime": "2024-01-07T00:00:00Z",
      "protectionUnit": {
        "@odata.type": "#microsoft.graph.siteProtectionUnit",
        "id": "23014d8c-71fe-4d00-a01a-31850bc5b42a",
        "siteId": "contoso-jpn.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,0271110f-634f-4300-a841-3a8a2e857893",
        "policyId": "9fec8e78-bce4-4aaf-ab1b-5451cc387264"
      },
      "tags": "fastRestore" // Newly Added
    }
  ]
}
  • Последнее обновление: