threatAssessmentRequest から派生したメール脅威評価を作成および取得するために使用されます。
メール脅威評価要求を作成するときは、 recipientEmailで指定されたユーザーがメールを受信する必要があります。 委任された メールのアクセス許可 (Mail.Read または Mail.Read.Shared) は、ユーザーが受信したメールまたは他のユーザーが共有するメールにアクセスするために必要です。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| Create | mailAssessmentRequest | mailAssessmentRequest オブジェクトを投稿して、新しいメール評価要求を作成します。 |
| Get | mailAssessmentRequest | mailAssessmentRequest オブジェクトのプロパティとリレーションシップを読み取ります。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| category | threatCategory | 脅威カテゴリ。 使用可能な値: spam、phishing、malware。 |
| contentType | threatAssessmentContentType | 脅威評価のコンテンツ タイプ。 使用可能な値: mail、url、file。 |
| createdBy | identitySet | 脅威評価要求の作成者。 |
| createdDateTime | DateTimeOffset | Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| destinationRoutingReason | mailDestinationRoutingReason | 宛先にルーティングされたメールの理由。 使用できる値は、 none、 mailFlowRule、 safeSender、 blockedSender、 advancedSpamFiltering、 domainAllowList、 domainBlockList、 notInAddressBook、 firstTimeSender、 autoPurgeToInbox、 autoPurgeToJunk、 autoPurgeToDeleted、 outbound、 notJunk、 junkです。 |
| expectedAssessment | threatExpectedAssessment | 提出者からの予想される評価。 使用可能な値は、 block、 unblockです。 |
| id | 文字列 | 脅威評価要求 ID は、グローバル一意識別子 (GUID) です。 |
| messageUri | 文字列 | 評価用のメール メッセージのリソース URI。 |
| recipientEmail | 文字列 | メールの評価に使用されるポリシーを持つメール受信者。 |
| requestSource | threatAssessmentRequestSource | 脅威評価要求のソース。 使用可能な値は、 administratorです。 |
| status | threatAssessmentStatus | 評価プロセスの状態。 使用可能な値は、 pending、 completedです。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| results | threatAssessmentResult コレクション | 脅威評価結果のコレクション。 読み取り専用です。 既定では、 GET /threatAssessmentRequests/{id} に $expand を適用しない限り、このプロパティは返されません。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"destinationRoutingReason": "String",
"messageUri": "String",
"recipientEmail": "String",
"category": "String",
"contentType": "String",
"createdBy": {"@odata.type": "microsoft.graph.identitySet"},
"createdDateTime": "String (timestamp)",
"expectedAssessment": "String",
"id": "String (identifier)",
"requestSource": "String",
"status": "String"
}