Compartilhar via

protectionRuleBase: deleteAndUnprotect

Namespace: microsoft.graph

Elimine e desproteja todos os artefactos protegidos por uma regra dinâmica. Esta ação só é aplicável a regras dinâmicas.

Os seguintes pontos aplicam-se quando elimina uma regra dinâmica e desproteger todos os artefactos que protege.

  • A regra muda para o deleteRequested status quando esta ação é executada numa regra dinâmica.
  • Desproteger artefactos e eliminar regras são operações assíncronas e podem não ser concluídas imediatamente.
  • Esta ação repõe a origem de dynamicRule proteção. Se o artefacto também estiver protegido por outra origem de proteção, só será protegido por essa origem posteriormente.
  • Não é permitida nenhuma operação numa regra dinâmica quando uma regra está no deleteRequested estado.

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante) BackupRestore-Configuration.ReadWrite.All Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application BackupRestore-Configuration.ReadWrite.All Indisponível.

Solicitação HTTP

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

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.

Corpo da solicitação

Não forneça um corpo de solicitação para esse método.

Resposta

Se for bem-sucedida, esta ação devolve um 202 Accepted código de resposta e um objeto protectionRuleBase no corpo da resposta.

Exemplos

Exemplo 1: Eliminar e desproteger uma unidadeInclusionRule associada a uma política de proteção onedriveForBusiness

O exemplo seguinte mostra como eliminar uma unidadeInclusionRule associada a um onedriveForBusinessProtectionPolicy e desproteger as unidades que protege.

Solicitação

O exemplo a seguir mostra uma solicitação.

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

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

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

Exemplo 2: Eliminar e desproteger uma caixa de correioInclusionRule associada a uma política de proteção do Exchange

O exemplo seguinte mostra como eliminar uma caixa de correioInclusionRule associada a um exchangeProtectionPolicy.

Solicitação

O exemplo a seguir mostra uma solicitação.

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

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

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