Atualizar protectionRuleBase

Namespace: microsoft.graph

Atualizar as propriedades de um objeto protectionRuleBase . Esse método só tem suporte para as regras dinâmicas de objetos exchangeProtectionPolicy e onedriveForBusinessProtectionPolicy . Depois que a atualização é aplicada, o valor da propriedade status do objeto protectionRuleBase é definido como updateRequested.

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Solicitação HTTP

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

Cabeçalhos de solicitação

Corpo da solicitação

No corpo da solicitação, forneça apenas os valores das propriedades a serem atualizadas. As propriedades existentes que não estão incluídas no corpo da solicitação mantêm seus valores anteriores ou são recalculadas com base nas alterações de outros valores de propriedade.

A tabela a seguir especifica as propriedades que podem ser atualizadas.

No corpo da solicitação, forneça uma representação JSON de uma das propriedades a seguir para atualizar o objeto protectionRuleBase .

Resposta

Se for bem-sucedido, esse método retornará um código de 200 OK resposta e um objeto protectionRuleBase atualizado no corpo da resposta.

Exemplos

Exemplo 1: Atualizar um driveInclusionRule associado a uma política de proteção onedriveForBusiness

O exemplo a seguir mostra como atualizar uma driveInclusionRule associada a onedriveForBusinessProtectionPolicy.

Solicitação

O exemplo a seguir mostra uma solicitação.

PATCH https://graph.microsoft.com/v1.0/solutions/backupRestore/oneDriveForBusinessProtectionPolicies/e267a763-ca81-4a98-8c1a-f407143cffe1/driveInclusionRules/c31adc5c-b65d-4a85-8eda-976947a24124
Content-Type: application/json

{
  "driveExpression": "(memberOf -any (group.id -in ['4e8e9b15-bfc8-40a2-aed0-3f65a22e2bd4']))"
}

const options = {
	authProvider,
};

const client = Client.init(options);

const driveProtectionRule = {
  driveExpression: '(memberOf -any (group.id -in [\'4e8e9b15-bfc8-40a2-aed0-3f65a22e2bd4\']))'
};

await client.api('/solutions/backupRestore/oneDriveForBusinessProtectionPolicies/e267a763-ca81-4a98-8c1a-f407143cffe1/driveInclusionRules/c31adc5c-b65d-4a85-8eda-976947a24124')
	.update(driveProtectionRule);

Resposta

O exemplo a seguir mostra a resposta.

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

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

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(microsoft.graph.driveProtectionRule)",
  "id": "c31adc5c-b65d-4a85-8eda-976947a24124",
  "status": "updateRequested",
  "createdDateTime": "2025-01-15T14:42:34.5329239Z",
  "lastModifiedDateTime": "2025-01-15T14:58:08.5918017Z",
  "isAutoApplyEnabled": true,
  "createdBy": {
    "application": {
      "id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264"
    },
    "user": {
      "id": "845457dc-4bb2-4815-bef3-8628ebd1952e"
    }
  },
  "lastModifiedBy": {
    "application": {
      "id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264"
    },
    "user": {
      "id": "845457dc-4bb2-4815-bef3-8628ebd1952e"
    }
  },
  "driveExpression": "(memberOf -any (group.id -in ['4e8e9b15-bfc8-40a2-aed0-3f65a22e2bd4']))"
}

Exemplo 2: Atualizar uma mailboxInclusionRule associada a uma política de proteção do Exchange

O exemplo a seguir mostra como atualizar uma mailboxInclusionRule associada a uma exchangeProtectionPolicy.

Solicitação

O exemplo a seguir mostra uma solicitação.

PATCH https://graph.microsoft.com/v1.0/solutions/backupRestore/exchangeProtectionPolicies/e267a763-ca81-4a98-8c1a-f407143cffe1/mailboxInclusionRules/c31adc5c-b65d-4a85-8eda-976947a24124
Content-Type: application/json

{
  "mailboxExpression": "(memberOf -any (group.id -in ['c318eb4a-ea72-42bd-8f0b-d0bbf794bec7']))"
}

const options = {
	authProvider,
};

const client = Client.init(options);

const mailboxProtectionRule = {
  mailboxExpression: '(memberOf -any (group.id -in [\'c318eb4a-ea72-42bd-8f0b-d0bbf794bec7\']))'
};

await client.api('/solutions/backupRestore/exchangeProtectionPolicies/e267a763-ca81-4a98-8c1a-f407143cffe1/mailboxInclusionRules/c31adc5c-b65d-4a85-8eda-976947a24124')
	.update(mailboxProtectionRule);

Resposta

O exemplo a seguir mostra a resposta.

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

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

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(microsoft.graph.mailboxProtectionRule)",
  "id": "c31adc5c-b65d-4a85-8eda-976947a24124",
  "status": "updateRequested",
  "createdBy": {
    "application": {
      "id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264"
    },
    "user": {
      "id": "845457dc-4bb2-4815-bef3-8628ebd1952e"
    }
  },
  "createdDateTime": "2015-06-19T12:01:03.45Z",
  "lastModifiedBy": {
    "application": {
      "id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264"
    },
    "user": {
      "id": "845457dc-4bb2-4815-bef3-8628ebd1952e"
    }
  },
  "lastModifiedDateTime": "2015-06-19T12:01:03.45Z",
  "isAutoApplyEnabled": true,
  "mailboxExpression": "(memberOf -any (group.id -in ['c318eb4a-ea72-42bd-8f0b-d0bbf794bec7']))"
}