Update emailThreatSubmissionPolicy

Статья
04/04/2024

Пространство имен: microsoft.graph.security

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Обновите свойства объекта emailThreatSubmissionPolicy .

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба	Правительство США L4	Правительство США L5 (DOD)	Китай управляется 21Vianet
✅	❌	❌	❌

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения	Разрешения с наименьшими привилегиями	Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись)	ThreatSubmissionPolicy.ReadWrite.All	Недоступно.
Делегированные (личная учетная запись Майкрософт)	Не поддерживается.	Не поддерживается.
Приложение	ThreatSubmissionPolicy.ReadWrite.All	Недоступно.

HTTP-запрос

PATCH security/threatSubmission/emailThreatSubmissionPolicies/{emailThreatSubmissionPoliciesId}

Заголовки запросов

Имя	Описание
Авторизация	Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type	application/json. Обязательно.

Текст запроса

В тексте запроса укажите только значения свойств для обновления. Существующие свойства, которые не включены в текст запроса, сохраняют свои предыдущие значения или пересчитываются на основе изменений других значений свойств.

В следующей таблице указаны свойства, которые можно обновить.

Эти свойства связаны с параметрами сообщения, сообщаемого пользователем. Дополнительные сведения см. в разделе Параметры сообщения, сообщаемого пользователем.

Свойство	Тип	Описание
customizedNotificationSenderEmailAddress	String	Указывает адрес электронной почты отправителя, с которого Уведомления по электронной почте будут отправлены конечным пользователям, чтобы сообщить им, является ли сообщение спамом, фишингом или чистым. Значение по умолчанию — `null`. Необязательный параметр для создания.
customizedReportRecipientEmailAddress	String	Указывает место назначения, куда будут присылать сообщения от конечных пользователей, когда они сообщают о чем-либо как о фишинговом, нежелательном или нежелательном. Значение по умолчанию — `null`. Необязательный параметр для создания.
isAlwaysReportEnabledForUsers	Логический	Указывает, могут ли конечные пользователи сообщать о сообщении как о спаме, фишинге или нежелательной почте напрямую без подтверждения (всплывающего окна). Значение по умолчанию — `true`. Необязательный параметр для создания.
isAskMeEnabledForUsers	Логический	Указывает, могут ли конечные пользователи подтвердить использование всплывающего окна, прежде чем сообщать сообщения о спаме, фишинге или не нежелательном. Значение по умолчанию — `true`. Необязательный параметр для создания.
isCustomizedMessageEnabled	Логический	Указывает, отправляется ли Уведомления по электронной почте конечным пользователям, чтобы сообщить им, является ли сообщение фишинговым, нежелательным или нежелательным. Значение по умолчанию — `false`. Необязательный параметр для создания.
isCustomizedMessageEnabledForPhishing	Логический	Если этот параметр включен, настраиваемое сообщение отображается только в том случае, если сообщение электронной почты сообщается как фишинговое. Значение по умолчанию — `false`. Необязательный параметр для создания.
isCustomizedNotificationSenderEnabled	Логический	Указывает, следует ли использовать адрес электронной почты отправителя, заданный с помощью настраиваемыхNotificationSenderEmailAddress для отправки Уведомления по электронной почте конечным пользователям. Значение по умолчанию — `false`. Необязательный параметр для создания.
isNeverReportEnabledForUsers	Логический	Указывает, могут ли конечные пользователи просто перемещать сообщение из одной папки в другую на основе спама, фишинга или нежелательной почты, не сообщая об этом. Значение по умолчанию — `true`. Необязательный параметр для создания.
isOrganizationBrandingEnabled	Логический	Указывает, следует ли использовать логотип фирменной символики в Уведомления по электронной почте, отправляемых конечным пользователям. Значение по умолчанию — `false`. Необязательный параметр для создания.
isReportFromQuarantineEnabled	Логический	Указывает, могут ли конечные пользователи отправлять сообщения со страницы карантина. Значение по умолчанию — `true`. Необязательный параметр для создания.
isReportToCustomizedEmailAddressEnabled	Логический	Указывает, следует ли отправлять сообщения электронной почты, сообщаемые конечными пользователями, в пользовательский почтовый ящик, настроенный с помощью customedReportRecipientEmailAddress. Значение по умолчанию — `false`. Необязательный параметр для создания.
isReportToMicrosoftEnabled	Логический	Если этот параметр включен, сообщение электронной почты будет отправлено в корпорацию Майкрософт для анализа. Значение по умолчанию — `false`. Повторное создание.
isReviewEmailNotificationEnabled	Логический	Указывает, отправляется ли уведомление по электронной почте конечному пользователю, который сообщил об этом при проверке администратором. Значение по умолчанию — `false`. Необязательный параметр для создания.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 204 No Content. Он не возвращает ничего в теле ответа.

Примеры

Запрос

Ниже показан пример запроса.

PATCH https://graph.microsoft.com/beta/security/threatSubmission/emailthreatSubmissionPolicies/DefaultReportSubmissionPolicy
Content-type: application/json

{
  "isReportToMicrosoftEnabled": false
}


// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Beta.Models.Security;

var requestBody = new EmailThreatSubmissionPolicy
{
	IsReportToMicrosoftEnabled = false,
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Security.ThreatSubmission.EmailThreatSubmissionPolicies["{emailThreatSubmissionPolicy-id}"].PatchAsync(requestBody);

Важно!

Пакеты SDK для Microsoft Graph по умолчанию используют версию API версии 1.0 и поддерживают не все типы, свойства и API, доступные в бета-версии. Дополнительные сведения о доступе к бета-API с помощью SDK см. в статье Использование пакетов Microsoft Graph SDK с бета-API.

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.



mgc-beta security threat-submission email-threat-submission-policies patch --email-threat-submission-policy-id {emailThreatSubmissionPolicy-id} --body '{\
  "isReportToMicrosoftEnabled": false\
}\
'

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.



// Code snippets are only available for the latest major version. Current major version is $v0.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  graphmodelssecurity "github.com/microsoftgraph/msgraph-beta-sdk-go/models/security"
	  //other-imports
)

requestBody := graphmodelssecurity.NewEmailThreatSubmissionPolicy()
isReportToMicrosoftEnabled := false
requestBody.SetIsReportToMicrosoftEnabled(&isReportToMicrosoftEnabled) 

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
emailThreatSubmissionPolicies, err := graphClient.Security().ThreatSubmission().EmailThreatSubmissionPolicies().ByEmailThreatSubmissionPolicyId("emailThreatSubmissionPolicy-id").Patch(context.Background(), requestBody, nil)

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

com.microsoft.graph.beta.models.security.EmailThreatSubmissionPolicy emailThreatSubmissionPolicy = new com.microsoft.graph.beta.models.security.EmailThreatSubmissionPolicy();
emailThreatSubmissionPolicy.setIsReportToMicrosoftEnabled(false);
com.microsoft.graph.models.security.EmailThreatSubmissionPolicy result = graphClient.security().threatSubmission().emailThreatSubmissionPolicies().byEmailThreatSubmissionPolicyId("{emailThreatSubmissionPolicy-id}").patch(emailThreatSubmissionPolicy);

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.


const options = {
	authProvider,
};

const client = Client.init(options);

const emailThreatSubmissionPolicy = {
  isReportToMicrosoftEnabled: false
};

await client.api('/security/threatSubmission/emailthreatSubmissionPolicies/DefaultReportSubmissionPolicy')
	.version('beta')
	.update(emailThreatSubmissionPolicy);

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.


<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\Security\EmailThreatSubmissionPolicy;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new EmailThreatSubmissionPolicy();
$requestBody->setIsReportToMicrosoftEnabled(false);

$result = $graphServiceClient->security()->threatSubmission()->emailThreatSubmissionPolicies()->byEmailThreatSubmissionPolicyId('emailThreatSubmissionPolicy-id')->patch($requestBody)->wait();

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.


Import-Module Microsoft.Graph.Beta.Security

$params = @{
	isReportToMicrosoftEnabled = $false
}

Update-MgBetaSecurityThreatSubmissionEmailThreatSubmissionPolicy -EmailThreatSubmissionPolicyId $emailThreatSubmissionPolicyId -BodyParameter $params

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.security.email_threat_submission_policy import EmailThreatSubmissionPolicy
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = EmailThreatSubmissionPolicy(
	is_report_to_microsoft_enabled = False,
)

result = await graph_client.security.threat_submission.email_threat_submission_policies.by_email_threat_submission_policy_id('emailThreatSubmissionPolicy-id').patch(request_body)

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

Отклик

Ниже приводится пример отклика.

HTTP/1.1 204 No Content

Поделиться через

Update emailThreatSubmissionPolicy

Разрешения

HTTP-запрос

Заголовки запросов

Текст запроса

Отклик

Примеры

Запрос

Отклик

Обратная связь

Дополнительные ресурсы