Atualizar caixa de correioProtectionUnit

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Atualize as propriedades de um objeto mailboxProtectionUnit .

Observação

Esta API está atualmente disponível apenas através do SDK do PowerShell do Microsoft Graph.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global	US Government L4	US Government L5 (DOD)	China operada pela 21Vianet
✅	❌	❌	❌

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.
Aplicativo	Sem suporte.	Sem suporte.

Solicitação HTTP

PATCH /backupRestore/mailboxProtectionUnits/{mailboxProtectionUnitId}

Cabeçalhos de solicitação

Nome	Descrição
Autorização	{token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type	application/json. Obrigatório.

Corpo da solicitação

Esta API suporta atualizações apenas para a propriedade billingPolicyId e apenas para unidades de proteção removidas das políticas de cópia de segurança (policyId é uma cadeia "" vazia ou null).

No corpo do pedido, forneça uma representação JSON da seguinte propriedade.

Propriedade	Tipo	Descrição
billingPolicyId	String	Opcional. O identificador exclusivo da política de faturação atribuída à unidade de proteção. Só pode atualizar esta propriedade quando policyId for null ou uma cadeia vazia ("").

Nota: Se policyId tiver um valor, a unidade de proteção é anexada a uma política de proteção e billingPolicyId não pode ser atualizado.

Resposta

Se for bem-sucedido, este método devolve um 200 OK código de resposta e um objeto mailboxProtectionUnit atualizado no corpo da resposta.

Para obter uma lista de possíveis respostas a erros, veja Respostas de erros da API de Armazenamento de Cópias de Segurança.

Exemplos

Exemplo 1: atualizar a política de faturação quando a unidade de proteção não estiver anexada a uma política de proteção

O exemplo seguinte mostra como atualizar a propriedade billingPolicyId quando a unidade de proteção não está anexada a uma política de proteção.

Solicitação

O exemplo a seguir mostra uma solicitação.

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

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

Resposta

O exemplo a seguir mostra a resposta.

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

Exemplo 2: atualizar a política de faturação quando a unidade de proteção está anexada a uma política de proteção

O exemplo seguinte mostra a resposta que obtém se tentar atualizar a propriedade billingPolicyId quando a unidade de proteção está anexada a uma política de proteção.

Solicitação

O exemplo a seguir mostra uma solicitação.

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

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

Resposta

O exemplo a seguir mostra a resposta.

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

Conteúdo relacionado

• mailboxProtectionUnit