Freigeben über

Aktualisieren von mailboxProtectionUnit

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Aktualisieren sie die Eigenschaften eines mailboxProtectionUnit-Objekts .

Hinweis

Diese API ist derzeit nur über das Microsoft Graph PowerShell SDK verfügbar.

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-Configuration.ReadWrite.All Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Application Nicht unterstützt Nicht unterstützt

HTTP-Anforderung

PATCH /backupRestore/mailboxProtectionUnits/{mailboxProtectionUnitId}

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Diese API unterstützt nur Updates für die billingPolicyId-Eigenschaft und nur für Schutzeinheiten, die aus Sicherungsrichtlinien entfernt wurden (policyId ist eine leere Zeichenfolge "" oder null).

Geben Sie im Anforderungstext eine JSON-Darstellung der folgenden Eigenschaft an.

Eigenschaft Typ Beschreibung
billingPolicyId Zeichenfolge Optional. Der eindeutige Bezeichner der Abrechnungsrichtlinie, die der Schutzeinheit zugewiesen ist. Sie können diese Eigenschaft nur aktualisieren, wenn policyId oder eine leere Zeichenfolge ("") istnull.

Hinweis: Wenn policyId über einen Wert verfügt, wird die Schutzeinheit an eine Schutzrichtlinie angefügt, und billingPolicyId kann nicht aktualisiert werden.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 200 OK Antwortcode und ein aktualisiertes mailboxProtectionUnit-Objekt im Antworttext zurück.

Eine Liste der möglichen Fehlerantworten finden Sie unter Fehlerantworten der Backup Storage-API.

Beispiele

Beispiel 1: Aktualisieren der Abrechnungsrichtlinie, wenn die Schutzeinheit nicht an eine Schutzrichtlinie angefügt ist

Das folgende Beispiel zeigt, wie die billingPolicyId-Eigenschaft aktualisiert wird, wenn die Schutzeinheit nicht an eine Schutzrichtlinie angefügt ist.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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

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

Antwort

Das folgende Beispiel zeigt die Antwort.

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"
}

Beispiel 2: Aktualisieren der Abrechnungsrichtlinie, wenn die Schutzeinheit an eine Schutzrichtlinie angefügt ist

Das folgende Beispiel zeigt die Antwort, die Sie erhalten, wenn Sie versuchen, die billingPolicyId-Eigenschaft zu aktualisieren, wenn die Schutzeinheit an eine Schutzrichtlinie angefügt ist.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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

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

Antwort

Das folgende Beispiel zeigt die Antwort.

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
  }
}

Verwandte Inhalte

  • Last updated on