recommendationBase リソース型

名前空間: microsoft.graph

重要

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

推奨リソースの種類のプロパティを公開する抽象型。

メソッド

なし。

プロパティ

プロパティ 型 説明
actionSteps actionStep コレクション 推奨事項を完了するために実行するアクションの一覧。
利点 文字列 推奨事項を完了することで有益である理由の説明。 Microsoft Entra 管理センターに表示される推奨事項の [値] セクションに対応します。
category recommendationCategory 推奨事項が該当するインテリジェント ガイダンスのカテゴリを示します。 使用可能な値: identityBestPractice、identitySecureScore、unknownFutureValue、mdiSecureScore。 Prefer: include-unknown-enum-members 要求ヘッダーを使用して、この進化可能な列挙型から次の値を取得します。mdiSecureScore。
categoryGroup recommendationCategoryGroup 推奨事項が属するビジネス分類グループ。Microsoft Entra 管理センターで推奨事項を整理するために使用されます。 使用可能な値: strengthenAuthentication、detectAndRespondToThreats、enforceLeastPrivilege、governAppsCredentialsAndAgents、hardenInfrastructure、defenderForIdentity、unknownFutureValue。 読み取り専用です。 $filter (eq)をサポートしています。
completedBySystemDateTime DateTimeOffset 推奨事項サービスが推奨 事項が完全に 修復されたことを確認し、その 状態 を completedBySystem に設定した日時。 推奨事項がシステムによって完了しなかった場合は null されます。 $filter をサポートします。
completedByUserDateTime DateTimeOffset 現在のレビュー サイクルで、ユーザーが推奨 事項 を完了したとマークした日時。ユーザーが完了とマーク付けした影響を受けるすべてのリソースから値がロール アップされた日時も含まれます。 推奨事項が現在のサイクルでユーザーによって完了しなかった場合は null されます。 $filter をサポートしています。
createdDateTime DateTimeOffset 推奨事項がディレクトリに適用可能として検出された日時。
currentScore 倍精度浮動小数点数 テナントが獲得したポイント数。 カテゴリが identitySecureScore に設定された最適化案にのみ適用されます。
displayName 文字列 推奨事項のタイトル。
failedReviewDateTime DateTimeOffset ユーザーが完了とマークした 1 つ以上の影響を受けるリソースがまだ影響を受けていることをレコメンデーション サービスが直近確認し、それらのリソースを needsMoreAction に移行した日時。 レビューされたリソースが修復されるとクリアされるため、 remediatedDateTime と相互に排他的です。 現在検証に不合格となったユーザー レビュー済みリソースがない場合に null されます。 $filter をサポートします。
featureAreas recommendationFeatureAreas コレクション 推奨事項が関連するディレクトリ機能。
id 文字列 テナント用に生成された 推奨事項 オブジェクトの一意の識別子。 これは、テナント ID と、推奨事項の Microsoft Entra ID に割り当てられたニックネームを組み合わせたものです。 たとえば、7918d4b5-0442-4a97-be2d-36f9f9962ece_Microsoft.Identity.IAM.Insights.ThirdPartyApps のように指定します。
impactStartDateTime DateTimeOffset 推奨事項を完了する必要がある将来の日時。
impactType 文字列 推奨の影響範囲を示します。 tenantLevel 推奨事項がテナント全体に影響することを示します。 他の可能な値は、 users、 apps です。
insights 文字列 推奨事項がディレクトリに一意に適用される理由について説明します。 Microsoft Entra 管理センターに表示される推奨事項の [説明] セクションに対応します。
lastCheckedDateTime DateTimeOffset 推奨事項がディレクトリに適用可能と見なされた最新の日時。
lastModifiedBy 文字列 推奨事項の状態を最後に更新したユーザーの名前。
lastModifiedDateTime DateTimeOffset 推奨事項の状態が最後に更新された日時。
maxScore 倍精度浮動小数点数 獲得可能なポイントの最大数。 カテゴリが identitySecureScore に設定された最適化案にのみ適用されます。
needsMoreActionResourceCount Int32 ユーザーが完了とマークし、その後推奨事項サービスが検証した影響を受けるリソースの数は、引き続き影響を受けています ( needsMoreAction に移動)。 failedReviewDateTime が設定されている場合、この値は正確に 0 より大きくなります。 推奨事項がレビュー ライフサイクルに参加しない場合はnullされます。
nistClassifications nistClassification コレクション 推奨事項に対応する NIST サイバーセキュリティ フレームワーク (CSF) 2.0 カテゴリ。 読み取り専用です。
postponeUntilDateTime DateTimeOffset 延期された推奨事項の状態が再びactiveされる将来の日時。
priority recommendationPriority 推奨事項が完了するまでの時間感度を示します。 Microsoft はこの値を自動的に割り当てます。 使用可能な値: low、medium、high、critical、unknownFutureValue。
recommendationType recommendationType 推奨事項を識別するためのフレンドリ ショートネーム。 有効な値は、 adfsAppsMigration、 enableDesktopSSO、 enablePHS、 enableProvisioning、 switchFromPerUserMFA、 tenantMFA、 thirdPartyApps、 turnOffPerUserMFA、 useAuthenticatorApp、 useMyApps、 staleApps、 staleAppCreds、 applicationCredentialExpiry、 servicePrincipalKeyExpiry、 adminMFAV2、 blockLegacyAuthentication、 integratedApps、 mfaRegistrationV2、 pwagePolicyNew、 passwordHashSync、 oneAdmin、 roleOverlap、 selfServicePasswordReset、 signinRiskPolicy、 userRiskPolicy、 verifyAppPublisher、 privateLinkForAAD、 appRoleAssignmentsGroups、 appRoleAssignmentsUsers、 managedIdentity、 overprivilegedApps、 unknownFutureValue、 longLivedCredentials、 aadConnectDeprecated、 adalToMsalMigration、 ownerlessApps、 inactiveGuests、 aadGraphDeprecationApplication、 aadGraphDeprecationServicePrincipal、 mfaServerDeprecation です。 Prefer: include-unknown-enum-members 要求ヘッダーを使用して、この進化可能な列挙型のメンバーを取得します: longLivedCredentials、aadConnectDeprecated、adalToMsalMigration、ownerlessApps、inactiveGuests、aadGraphDeprecationApplication、aadGraphDeprecationServicePrincipal、mfaServerDeprecation。
releaseType releaseType 推奨事項の現在のリリースの種類。 使用可能な値: preview、generallyAvailable、unknownFutureValue。
remediatedDateTime DateTimeOffset ユーザーが完了とマークした影響を受けたリソースが修復されたことを推奨サービスが確認した日時。つまり、ユーザーがレビューしたリソースが completedBySystemに達しました。 レビューされたリソースが後で検証に失敗した場合は、 failedReviewDateTime に置き換えられます。 システムが現在のサイクルでユーザー主導の修復を検証していない場合は null されます。 $filter をサポートします。
remediationImpact 文字列 修復のユーザーへの影響の説明。 カテゴリが identitySecureScore に設定された最適化案にのみ適用されます。
requiredLicenses requiredLicenses 推奨事項を表示するために必要なライセンス。 有効な値は、 notApplicable、 microsoftEntraIdFree、 microsoftEntraIdP1、 microsoftEntraIdP2、 microsoftEntraIdGovernance、 microsoftEntraWorkloadId、 unknownFutureValue、 aatp、 microsoftEntraSuite です。 Prefer: include-unknown-enum-members 要求ヘッダーを使用して、この進化可能な列挙型から次の値を取得します: aatp、microsoftEntraSuite。
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 に設定されます。
statusModifiedDateTime DateTimeOffset 推奨事項の状態 が最後に変更 された日時 (例: active から completedByUser、 dismissed、 postponed、 needsMoreAction へ)。 lastModifiedDateTime とは異なり、状態が変わらずレコメンデーションのインサイト データのみが変更された場合、この値は更新されません。 推奨事項の状態が最初に変更されるまでnullされます。 $filter をサポートします。

リレーションシップ

リレーションシップ 型 説明
impactedResources impactedResource コレクション 推奨事項に関連付けられているディレクトリ オブジェクトの一覧。
tags recommendationTag コレクション 推奨事項に適用されるユーザー定義の自由形式ラベル。 コレクションは直接書き込み可能ではありません。タグの作成および削除は、 addTag アクションと removeTag アクションによって行います。

JSON 表記

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

{
  "@odata.type": "#microsoft.graph.recommendationBase",
  "id": "String (identifier)",
  "actionSteps": [
    {
      "@odata.type": "microsoft.graph.actionStep"
    }
  ],
  "benefits": "String",
  "category": "String",
  "categoryGroup": "String",
  "completedBySystemDateTime": "String (timestamp)",
  "completedByUserDateTime": "String (timestamp)",
  "createdDateTime": "String (timestamp)",
  "currentScore": "Double",
  "displayName": "String",
  "failedReviewDateTime": "String (timestamp)",
  "featureAreas": [
    "String"
  ],
  "releaseType": "String",
  "requiredLicenses": "String",
  "impactType": "String",
  "impactStartDateTime": "String (timestamp)",
  "insights": "String",
  "lastCheckedDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "lastModifiedBy": "String",
  "maxScore": "Double",
  "needsMoreActionResourceCount": "Int32",
  "nistClassifications": [
    {
      "@odata.type": "microsoft.graph.nistClassification"
    }
  ],
  "postponeUntilDateTime": "String (timestamp)",
  "priority": "String",
  "remediatedDateTime": "String (timestamp)",
  "status": "String",
  "statusModifiedDateTime": "String (timestamp)",
  "remediationImpact": "String",
  "recommendationType": "String"
}
  • Last updated on