Partager via

protectionRuleBase : deleteAndUnprotect

Espace de noms: microsoft.graph

Supprimez et supprimez la protection de tous les artefacts protégés par une règle dynamique. Cette action s’applique uniquement aux règles dynamiques.

Les points suivants s’appliquent lorsque vous supprimez une règle dynamique et supprimez la protection de tous les artefacts qu’elle protège.

  • La règle passe à la deleteRequested status lorsque cette action est effectuée sur une règle dynamique.
  • La suppression des artefacts et la suppression des règles sont des opérations asynchrones qui peuvent ne pas se terminer immédiatement.
  • Cette action réinitialise la source de dynamicRule protection. Si l’artefact est également protégé par une autre source de protection, il est uniquement protégé par cette source par la suite.
  • Aucune opération n’est autorisée sur une règle dynamique une fois qu’une règle est dans l’état deleteRequested .

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.

Type d’autorisation Autorisations avec privilèges minimum Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire) BackupRestore-Configuration.ReadWrite.All Non disponible.
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application BackupRestore-Configuration.ReadWrite.All Non disponible.

Requête HTTP

POST /solutions/backupRestore/oneDriveForBusinessProtectionPolicies/{oneDriveForBusinessProtectionPolicyId}/driveInclusionRules/{driveProtectionRuleId}/deleteAndUnprotect
POST /solutions/backupRestore/exchangeProtectionPolicies/{exchangeProtectionPolicyId}/mailboxInclusionRules/{mailboxProtectionRuleId}/deleteAndUnprotect

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.

Corps de la demande

N’indiquez pas le corps de la demande pour cette méthode.

Réponse

Si elle réussit, cette action renvoie un 202 Accepted code de réponse et un objet protectionRuleBase dans le corps de la réponse.

Exemples

Exemple 1 : Supprimer et supprimer la protection d’un driveInclusionRule associé à une stratégie de protection onedriveForBusiness

L’exemple suivant montre comment supprimer un driveInclusionRule associé à un onedriveForBusinessProtectionPolicy et annuler la protection des unités qu’il protège.

Demande

L’exemple suivant illustre une demande.

POST https://graph.microsoft.com/v1.0/solutions/backupRestore/oneDriveForBusinessProtectionPolicies/71633878-8321-4950-bfaf-ed285bdd1461/driveInclusionRules/61633878-8321-4950-bfaf-ed285bdd1461/deleteAndUnprotect

Réponse

L’exemple suivant illustre la réponse.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 202 Accepted
Content-Type: application/json

{
  "value": {
    "@odata.type": "https://graph.microsoft.com/v1.0/$metadata#microsoft.graph.protectionRuleBase",
    "id": "61633878-8321-4950-bfaf-ed285bdd1461",
    "status": "deleteRequested",
    "createdDateTime": "2025-01-15T15:07:44.3043505Z",
    "lastModifiedDateTime": "2025-01-15T14:42:12.6779064Z",
    "isAutoApplyEnabled": true,
    "driveExpression": "(memberOf -any (group.id -in ['4e8e9b15-bfc8-40a2-aed0-3f65a22e2bd4']))",
    "createdBy": {
      "user": {
        "identity": "8aaaaec3-5dcb-4b47-9ef9-0dda3e95b9f4"
      }
    },
    "lastModifiedBy": {}
  }
}

Exemple 2 : Supprimer et supprimer la protection d’une boîte aux lettresInclusionRule associée à une stratégie de protection Exchange

L’exemple suivant montre comment supprimer un objet mailboxInclusionRule associé à un objet exchangeProtectionPolicy.

Demande

L’exemple suivant illustre une demande.

POST https://graph.microsoft.com/v1.0/solutions/backupRestore/exchangeProtectionPolicies/6b0991b9-e7d4-4794-86fa-2a3f2a4e3177/mailboxInclusionRules/52147fb9-2682-47bc-a8f6-6c38c1ff498d/deleteAndUnprotect

Réponse

L’exemple suivant illustre la réponse.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 202 Accepted
Content-Type: application/json

{
  "value": {
    "@odata.type": "https://graph.microsoft.com/v1.0/$metadata#microsoft.graph.protectionRuleBase",
    "id": "52147fb9-2682-47bc-a8f6-6c38c1ff498d",
    "status": "deleteRequested",
    "createdDateTime": "2025-01-15T15:07:44.3043505Z",
    "lastModifiedDateTime": "2025-01-15T14:42:12.6779064Z",
    "isAutoApplyEnabled": true,
    "mailboxExpression": "(memberOf -any (group.id -in ['4e8e9b15-bfc8-40a2-aed0-3f65a22e2bd4']))",
    "createdBy": {
        "user": {
            "identity": "8aaaaec3-5dcb-4b47-9ef9-0dda3e95b9f4"
        }
    },
    "lastModifiedBy": {},
    "error": {}
  }
}
  • Last updated on