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
| 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"
}
]
}
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Models;
using Microsoft.Kiota.Abstractions.Serialization;
var requestBody = new EmailNotificationsSetting
{
IsEnabled = true,
AdditionalEvents = NotificationEventsType.RestoreAndPolicyUpdates,
Recipients = new NotificationRecipients
{
AdditionalData = new Dictionary<string, object>
{
{
"recipients" , new UntypedObject(new Dictionary<string, UntypedNode>
{
{
"role", new UntypedString("custom")
},
{
"customRecipients", new UntypedArray(new List<UntypedNode>
{
new UntypedObject(new Dictionary<string, UntypedNode>
{
{
"email", new UntypedString("amala@contoso.com")
},
}),
new UntypedObject(new Dictionary<string, UntypedNode>
{
{
"email", new UntypedString("conrad@contoso.com")
},
}),
new UntypedObject(new Dictionary<string, UntypedNode>
{
{
"email", new UntypedString("lothar@contoso.com")
},
}),
})
},
})
},
},
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Solutions.BackupRestore.EmailNotificationsSetting.PatchAsync(requestBody);
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
EmailNotificationsSetting emailNotificationsSetting = new EmailNotificationsSetting();
emailNotificationsSetting.setIsEnabled(true);
emailNotificationsSetting.setAdditionalEvents(EnumSet.of(NotificationEventsType.RestoreAndPolicyUpdates));
NotificationRecipients recipients = new NotificationRecipients();
HashMap<String, Object> additionalData = new HashMap<String, Object>();
recipients1 = new ();
recipients1.setRole("custom");
LinkedList<Object> customRecipients = new LinkedList<Object>();
property = new ();
property.setEmail("amala@contoso.com");
customRecipients.add(property);
property1 = new ();
property1.setEmail("conrad@contoso.com");
customRecipients.add(property1);
property2 = new ();
property2.setEmail("lothar@contoso.com");
customRecipients.add(property2);
recipients1.setCustomRecipients(customRecipients);
additionalData.put("recipients", recipients1);
recipients.setAdditionalData(additionalData);
emailNotificationsSetting.setRecipients(recipients);
EmailNotificationsSetting result = graphClient.solutions().backupRestore().emailNotificationsSetting().patch(emailNotificationsSetting);
const options = {
authProvider,
};
const client = Client.init(options);
const emailNotificationsSetting = {
isEnabled: 'true',
additionalEvents: 'restoreAndPolicyUpdates',
recipients: {
recipients: {
role: 'custom',
customRecipients: [
{
email: 'amala@contoso.com'
},
{
email: 'conrad@contoso.com'
},
{
email: 'lothar@contoso.com'
}
]
}
}
};
await client.api('/solutions/backupRestore/emailNotificationsSetting')
.version('beta')
.update(emailNotificationsSetting);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\EmailNotificationsSetting;
use Microsoft\Graph\Beta\Generated\Models\NotificationEventsType;
use Microsoft\Graph\Beta\Generated\Models\NotificationRecipients;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new EmailNotificationsSetting();
$requestBody->setIsEnabled(true);
$requestBody->setAdditionalEvents(new NotificationEventsType('restoreAndPolicyUpdates'));
$recipients = new NotificationRecipients();
$additionalData = [
'recipients' => [
'role' => 'custom',
'customRecipients' => [
[
'email' => 'amala@contoso.com',
],
[
'email' => 'conrad@contoso.com',
],
[
'email' => 'lothar@contoso.com',
],
],
],
];
$recipients->setAdditionalData($additionalData);
$requestBody->setRecipients($recipients);
$result = $graphServiceClient->solutions()->backupRestore()->emailNotificationsSetting()->patch($requestBody)->wait();
Import-Module Microsoft.Graph.Beta.BackupRestore
$params = @{
isEnabled = "true"
additionalEvents = "restoreAndPolicyUpdates"
recipients = @{
recipients = @{
role = "custom"
customRecipients = @(
@{
email = "amala@contoso.com"
}
@{
email = "conrad@contoso.com"
}
@{
email = "lothar@contoso.com"
}
)
}
}
}
Update-MgBetaSolutionBackupRestoreEmailNotificationSetting -BodyParameter $params
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.email_notifications_setting import EmailNotificationsSetting
from msgraph_beta.generated.models.notification_events_type import NotificationEventsType
from msgraph_beta.generated.models.notification_recipients import NotificationRecipients
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = EmailNotificationsSetting(
is_enabled = True,
additional_events = NotificationEventsType.RestoreAndPolicyUpdates,
recipients = NotificationRecipients(
additional_data = {
"recipients" : {
"role" : "custom",
"custom_recipients" : [
{
"email" : "amala@contoso.com",
},
{
"email" : "conrad@contoso.com",
},
{
"email" : "lothar@contoso.com",
},
],
},
}
),
)
result = await graph_client.solutions.backup_restore.email_notifications_setting.patch(request_body)
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"
}
]
}
}