Compartilhar via


Atualizar emailNotificationsSetting

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 emailNotificationsSetting .

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-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 do pedido, forneça apenas os valores das propriedades a atualizar. As propriedades existentes que não estão incluídas no corpo do pedido mantêm os valores anteriores ou são recalculadas com base em alterações a outros valores de propriedade.

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

Propriedade Tipo Descrição
additionalEvents notificationEventsType Indica se deve optar ativamente por participar em atualizações adicionais de políticas e restauros. Valores possíveis: none, , restoreAndPolicyUpdatesunknownFutureValue.
isEnabled Booliano Indica se as notificações estão ativadas.
destinatários notificationRecipients Uma lista de destinatários que recebem as notificações.

Resposta

Se for bem-sucedido, este método devolve um 200 OK código de 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/beta/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"
      }
    ]
  }
}