Обновление driveProtectionUnit

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

Обновите свойства объекта driveProtectionUnit .

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

Разрешения

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

HTTP-запрос

PATCH /backupRestore/driveProtectionUnits/{driveProtectionUnitId}

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

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

Этот API поддерживает обновления только для свойства billingPolicyId и только для единиц защиты, удаленных из политик резервного копирования (policyId — это пустая строка "" или null).

В тексте запроса укажите представление следующего свойства в формате JSON.

Примечание: Если policyId имеет значение, блок защиты присоединяется к политике защиты, и billingPolicyId не может быть обновлен.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 200 OK и обновленный объект driveProtectionUnit в тексте отклика.

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

Примеры

Пример 1. Обновление политики выставления счетов, если блок защиты не подключен к политике защиты

В следующем примере показано, как обновить свойство billingPolicyId , если блок защиты не подключен к политике защиты.

Запрос

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

PATCH https://graph.microsoft.com/beta/backupRestore/driveProtectionUnits/MGRkM2E3MTYtNGQ0Yi00MTIzLWEyMDUtN2EyYTgxMTNjMzYzXzQ=
Content-Type: application/json

{
  "billingPolicyId": "fa3d95b5-2878-4de7-94f5-157f4b7607aa"
}

Отклик

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

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

{
  "@odata.type": "#microsoft.graph.driveProtectionUnit",
  "id": "MGRkM2E3MTYtNGQ0Yi00MTIzLWEyMDUtN2EyYTgxMTNjMzYzXzQ=",
  "directoryObjectId": "6b4a7195-59a5-4a31-ab17-1e73973d992e",
  "displayName": "Global Admin",
  "email": "gadmin@contoso.com",
  "policyId": "",
  "billingPolicyId": "fa3d95b5-2878-4de7-94f5-157f4b7607aa",
  "createdDateTime": "2026-03-05T11:07:57.7038797Z",
  "createdBy": {
    "user": {
      "identity": "6b4a7195-59a5-4a31-ab17-1e73973d992e"
    }
  },
  "status": "unprotected",
  "protectionSources": "none",
  "lastModifiedDateTime": "2026-03-09T05:46:56.8235422Z",
  "lastModifiedBy": {
    "user": {
      "identity": "6b4a7195-59a5-4a31-ab17-1e73973d992e"
    }
  },
  "offboardRequestedDateTime": "0001-01-01T00:00:00Z"
}

Пример 2. Обновление политики выставления счетов при подключении блока защиты к политике защиты

В следующем примере показан ответ, который вы получаете при попытке обновить свойство billingPolicyId при подключении блока защиты к политике защиты.

Запрос

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

PATCH https://graph.microsoft.com/beta/backupRestore/driveProtectionUnits/NmFmNTQ2NTUtNTkwYS00YWU2LThkMDQtODRmNDI0OGMwZjU0XzE=
Content-Type: application/json

{
  "billingPolicyId": "f65f082d-a073-4451-9a3b-2355956f2cd7"
}

Отклик

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

HTTP/1.1 403 Operation Not Allowed
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.publicError",
  "code": "OperationNotAllowed",
  "message": "Only protection units removed from backup policies are allowed for this API.",
  "target": "billingPolicyId",
  "details": [],
  "innerError": {
    "@odata.type": "#microsoft.graph.publicError",
    "code": "OperationNotAllowed",
    "message": "The protection unit is attached to a backup policy.",
    "target": "policyId",
    "details": [],
    "innerError": null
  }
}

Связанные материалы

• driveProtectionUnit