Обновление mailboxProtectionUnit

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

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

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

Разрешения

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

HTTP-запрос

PATCH /backupRestore/mailboxProtectionUnits/{mailboxProtectionUnitId}

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

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

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

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

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

Отклик

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

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

Примеры

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

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

Запрос

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

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

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

Отклик

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

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

{
  "@odata.type": "#microsoft.graph.mailboxProtectionUnit",
  "id": "MjUyZTc3ZDEtM2IyYS00ZGMwLTkzYTMtMjkxZDI3NWZlY2YzXzM=",
  "directoryObjectId": "bb1b5307-d650-49cf-88cf-05eaf1b3bb33",
  "displayName": "Exo admin",
  "email": "exoadmin@contoso.com",
  "mailboxType": "user",
  "policyId": "",
  "billingPolicyId": "fa3d95b5-2878-4de7-94f5-157f4b7607aa",
  "createdDateTime": "2026-02-04T06:24:19.5736657Z",
  "createdBy": {
    "user": {
      "identity": "6294dedc-d456-4c78-9b2f-b4bae765fb09"
    }
  },
  "status": "unprotected",
  "protectionSources": "none",
  "lastModifiedDateTime": "2026-02-24T06:44:53.6014453Z",
  "lastModifiedBy": {
    "user": {
      "identity": "6294dedc-d456-4c78-9b2f-b4bae765fb09"
    }
  },
  "offboardRequestedDateTime": "0001-01-01T00:00:00Z"
}

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

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

Запрос

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

PATCH https://graph.microsoft.com/beta/backupRestore/mailboxProtectionUnits/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
  }
}

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

• mailboxProtectionUnit