impactedResource リソースの種類

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

Microsoft Entra ID 推奨事項に関連付けられているテナント内の Microsoft Entra リソースを表します。

エンティティ から継承します。

メソッド

メソッド 戻り値の種類 説明
List impactedResource コレクション impactedResources ナビゲーション プロパティから impactedResource リソースを取得します。
Get impactedResource impactedResource オブジェクトのプロパティと関係を読み取ります。
延期 impactedResource impactedResource オブジェクトの状態を、指定した日時にpostponedとしてマークします。
Dismiss impactedResource impactedResource オブジェクトの状態を dismissed としてマークします。
完了する impactedResource impactedResource オブジェクトの状態を completedByUser としてマークします。
再アクティブ化 impactedResource impactedResource オブジェクトの状態を active としてマークします。
計画をマークする impactedResource impactedResource オブジェクトの状態を planned としてマークします。
リスクを受け入れる impactedResource impactedResource オブジェクトの状態を riskAccepted としてマークします。
代替の軽減策を適用する impactedResource impactedResource オブジェクトの状態を alternateMitigation としてマークします。
タグの追加 recommendationTag impactedResource にユーザー定義タグを追加します。
タグを削除する impactedResource impactedResource からユーザー定義タグを削除します。
複数のリソースにタグを追加する impactedResource コレクション 1 回の要求で最大 50 個の impactedResource オブジェクトに同じタグを追加します。
複数のリソースからタグを削除する impactedResource コレクション 1 回の要求で最大 50 個の impactedResource オブジェクトから同じタグを削除します。

プロパティ

プロパティ 型 説明
addedDateTime DateTimeOffset impactedResource オブジェクトが最初に推奨事項に関連付けられた日時。
additionalDetails keyvalue コレクション recommendationのコンテキスト化に役立つimpactedResource固有の追加情報。
apiUrl 文字列 対応する Microsoft Entra リソースへの URL リンク。
displayName 文字列 Microsoft Entra リソースのフレンドリ名。
id 文字列 影響を受ける Microsoft Entra リソースの一意識別子。
lastModifiedBy 文字列 状態を最後に更新したユーザーまたはサービスの名前。
lastModifiedDateTime 文字列 ステータスが最後に更新された日時。
owner String リソースの保守を担当するユーザー。
portalUrl 文字列 リソースの対応する Microsoft Entra 管理センター ページへの URL リンク。
postponeUntilDateTime DateTimeOffset 延期された impactedResourceの状態が再びactiveされる将来の日時。
rank Int32 リソースの重要性を示します。 ランクが 1 に等しいリソースは、最も重要度が高くなります。
recommendationId 文字列 リソースが関連付けられている 推奨事項 の一意の識別子。
resourceType 文字列 Microsoft Entra リソースの種類を示します。 例としては、 user、 application があります。
status recommendationStatus リソースに対処する必要があるかどうかを示します。 有効な値は、 active、 completedBySystem、 completedByUser、 dismissed、 postponed、 unknownFutureValue、 riskAccepted、 thirdParty、 planned、 alternateMitigation、 needsMoreAction です。 Prefer: include-unknown-enum-members 要求ヘッダーを使用して、この進化可能な列挙型から次の値を取得します: riskAccepted、thirdParty、planned、alternateMitigation、needsMoreAction。 既定では、推奨事項 の状態は、 推奨事項が最初に生成されたときに active に設定されます。 状態は、かつてアクティブだったリソースが適用されなくなったことをサービスが検出すると completedBySystem に設定されます。
subjectId 文字列 resourceType に応じた関連する一意識別子。 たとえば、resourceType が application の場合、このプロパティは applicationId に設定されます。

リレーションシップ

リレーションシップ 型 説明
tags recommendationTag コレクション impactedResource に適用されるユーザー定義の自由形式ラベル。 コレクションは直接書き込み可能ではありません。タグの作成および削除は、 addTag アクションと removeTag アクションによって行います。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

{
  "@odata.type": "#microsoft.graph.impactedResource",
  "id": "String (identifier)",
  "subjectId": "String",
  "recommendationId": "String",
  "addedDateTime": "String (timestamp)",
  "portalUrl": "String",
  "apiUrl": "String",
  "displayName": "String",
  "resourceType": "String",
  "owner": "String",
  "rank": "Integer",
  "status": "String",
  "additionalDetails": [
    {
      "@odata.type": "microsoft.graph.keyValue"
    }
  ],
  "lastModifiedBy": "String",
  "lastModifiedDateTime": "String",
  "postponeUntilDateTime": "String (timestamp)"
}