mailAssessmentRequest リソースの種類
名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
threatAssessmentRequest から派生したメール脅威評価を作成および取得するために使用されます。
メール脅威評価要求を作成するときは、 で recipientEmail指定されたユーザーがメールを受信する必要があります。 委任された メールのアクセス許可 (Mail.Read または Mail.Read.Shared) は、ユーザーが受信したメールまたは他のユーザーが共有するメールにアクセスするために必要です。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| Create | mailAssessmentRequest | mailAssessmentRequest オブジェクトを投稿して、新しいメール評価要求をCreateします。 |
| Get | mailAssessmentRequest | mailAssessmentRequest オブジェクトのプロパティとリレーションシップを読み取ります。 |
プロパティ
| プロパティ | 種類 | 説明 |
|---|---|---|
| destinationRoutingReason | mailDestinationRoutingReason | 宛先にルーティングされたメールの理由。 使用できる値は、mailFlowRulenonesafeSender、、blockedSender、、advancedSpamFiltering、domainAllowList、domainBlockList、、 autoPurgeToInboxnotJunkfirstTimeSenderjunknotInAddressBookautoPurgeToJunkautoPurgeToDeletedoutboundです。 |
| messageUri | String | 評価用のメール メッセージのリソース URI。 |
| recipientEmail | String | メールの評価に使用されるポリシーを持つメール受信者。 |
| 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 です。 |
| expectedAssessment | threatExpectedAssessment | 提出者からの予想される評価。 可能な値は、block、unblock です。 |
| id | String | 脅威評価要求 ID は、グローバル一意識別子 (GUID) です。 |
| requestSource | threatAssessmentRequestSource | 脅威評価要求のソース。 可能な値は、user、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"
}