Atualizar emailNotificationsSetting

Namespace: microsoft.graph

Atualizar as propriedades de um objeto emailNotificationsSetting .

Essa API está disponível nas seguintes implantações de nuvem nacional.

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

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.

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

Solicitação HTTP

PATCH /solutions/backupRestore/emailNotificationsSetting

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

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.

Propriedade Tipo Descrição
Eventos adicionais notificationEventsType Indica se você deseja aceitar atualizações adicionais de política e restauração. Valores possíveis: none, restoreAndPolicyUpdates, unknownFutureValue.
isEnabled Booliano Indica se as notificações estão habilitadas.
destinatários notificationRecipients Especifica os destinatários que recebem as notificações.

Resposta

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

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

PATCH https://graph.microsoft.com/v1.0/solutions/backupRestore/emailNotificationsSetting
Content-Type: application/json

{
  "isEnabled": true,
  "additionalEvents": "restoreAndPolicyUpdates",
  "recipients": {
    "role": "custom",
    "customRecipients": [
      {
        "email": "amala@contoso.com"
      },
      {
        "email": "conrad@contoso.com"
      },
      {
        "email": "lothar@contoso.com"
      }
    ]
  }
}

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

{
  "isEnabled": true,
  "additionalEvents": "restoreAndPolicyUpdates",
  "recipients": {
    "role": "custom",
    "customRecipients": [
      {
        "email": "amala@contoso.com"
      },
      {
        "email": "conrad@contoso.com"
      },
      {
        "email": "lothar@contoso.com"
      }
    ]
  }
}