Compartir a través de

protectionRuleBase: deleteAndUnprotect

Espacio de nombres: microsoft.graph

Elimine y desproteja todos los artefactos protegidos por una regla dinámica. Esta acción solo se aplica a las reglas dinámicas.

Los siguientes puntos se aplican al eliminar una regla dinámica y desproteger todos los artefactos que protege.

  • La regla se mueve al deleteRequested estado cuando esta acción se realiza en una regla dinámica.
  • La desprotección de artefactos y la eliminación de reglas son operaciones asincrónicas y es posible que no se completen inmediatamente.
  • Esta acción restablece el origen de dynamicRule protección. Si el artefacto también está protegido por otro origen de protección, solo lo protegerá posteriormente.
  • No se permite ninguna operación en una regla dinámica una vez que una regla está en el deleteRequested estado .

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) BackupRestore-Configuration.ReadWrite.All No disponible.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación BackupRestore-Configuration.ReadWrite.All No disponible.

Solicitud HTTP

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

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.

Cuerpo de la solicitud

No proporcione un cuerpo de solicitud para este método.

Respuesta

Si se ejecuta correctamente, esta acción devuelve un 202 Accepted código de respuesta y un objeto protectionRuleBase en el cuerpo de la respuesta.

Ejemplos

Ejemplo 1: Eliminación y desprotección de una unidadInclusionRule asociada a una directiva de protección onedriveForBusiness

En el ejemplo siguiente se muestra cómo eliminar una unidadInclusionRule asociada a onedriveForBusinessProtectionPolicy y desproteger las unidades que protege.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

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

Ejemplo 2: Eliminación y desprotección de un buzónInclusionRule asociado a una directiva de protección de Exchange

En el ejemplo siguiente se muestra cómo eliminar un mailboxInclusionRule asociado a exchangeProtectionPolicy.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

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