тип ресурса рекомендации

Статья
11/08/2023

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

Важно!

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

Представляет рекомендацию или действие по улучшению идентификатора Microsoft Entra, рекомендуемое корпорацией Майкрософт для клиента Microsoft Entra.

Служба рекомендаций Microsoft Entra работает ежедневно, чтобы проверить клиент на соответствие предопределенным условиям для каждой рекомендации. Если служба обнаруживает, что рекомендация применяется к вашему клиенту, создается соответствующий объект рекомендации, а его состояние устанавливается в активное.

Дополнительные сведения см. в статье Рекомендации Microsoft Entra.

Наследует от recommendationBase.

Методы

Метод	Тип возвращаемых данных	Описание
Список	коллекция рекомендаций	Получение списка объектов рекомендаций и их свойств.
Получение	recommendation	Чтение свойств и связей объекта рекомендации .
Отложить	recommendation	Пометьте состояние объекта рекомендации как `postponed` указанные дату и время.
Dismiss	recommendation	Пометьте состояние объекта рекомендации как `dismissed`.
Завершение	recommendation	Пометьте состояние объекта рекомендации как `completedByUser`.
Повторная активация	recommendation	Пометьте состояние объекта рекомендации как `active`.
Получение оценки безопасности клиента	коллекция tenantSecureScore	Получение исторических данных оценки безопасности для клиента.

Свойства

Свойство	Тип	Описание
actionSteps	коллекция actionStep	Список действий, выполняемых для выполнения рекомендации. Наследуется от recommendationBase.
Преимущества	String	Объяснение того, почему выполнение рекомендации принесет вам пользу. Соответствует разделу Значение рекомендации, показанной в Центре администрирования Microsoft Entra. Наследуется от recommendationBase.
category	recommendationCategory	Указывает категорию интеллектуального руководства, к которому относится рекомендация. Допустимые значения: `identityBestPractice`, `identitySecureScore`, `unknownFutureValue`. Наследуется от recommendationBase. Поддерживает `$filter`(`eq`).
createdDateTime	DateTimeOffset	Дата и время обнаружения рекомендации в соответствии с вашим каталогом. Наследуется от recommendationBase.
currentScore	Двойное с плавающей точкой	Количество баллов, достигнутое клиентом. Применяется только к рекомендациям с категорией , для нее задано значение `identitySecureScore`. Наследуется от recommendationBase.
displayName	String	Заголовок рекомендации. Наследуется от recommendationBase.
featureAreas	коллекция recommendationFeatureAreas	Компонент каталога, с которым связана рекомендация . Наследуется от recommendationBase. Поддерживает `$filter`(`eq`).
id	String	Уникальный идентификатор объекта рекомендации , созданного для клиента. Это объединение идентификатора клиента и псевдонима, присвоенного идентификатором Microsoft Entra для рекомендации. Например, `7918d4b5-0442-4a97-be2d-36f9f9962ece_Microsoft.Identity.IAM.Insights.ThirdPartyApps`. Наследуется от recommendationBase.
impactStartDateTime	DateTimeOffset	Дата и время выполнения рекомендации в будущем. Наследуется от recommendationBase.
impactType	String	Указывает область влияния рекомендации. `Tenant level` указывает, что рекомендация влияет на весь клиент. Другие возможные значения: `users`, `applications`. Наследуется от recommendationBase.
insights	String	Описывает, почему рекомендация однозначно применяется к вашему каталогу. Соответствует разделу Описание рекомендации, показанной в Центре администрирования Microsoft Entra. Наследуется от recommendationBase.
lastCheckedDateTime	DateTimeOffset	Последняя дата и время, когда рекомендация считается применимой к вашему каталогу. Наследуется от recommendationBase.
lastModifiedBy	String	Имя пользователя, который в последний раз обновлял состояниерекомендации. Наследуется от recommendationBase.
lastModifiedDateTime	DateTimeOffset	Дата и время последнего обновления состояниярекомендации . Наследуется от recommendationBase.
maxScore	Двойное с плавающей точкой	Максимальное достижимое количество баллов. Применяется только к рекомендациям с категорией , для нее задано значение `identitySecureScore`. Наследуется от recommendationBase.
postponeUntilDateTime	DateTimeOffset	Будущая дата и время повторного выполнения отложенной рекомендации`active`. Наследуется от recommendationBase.
priority	recommendationPriority	Указывает чувствительность времени для выполнения рекомендации . Корпорация Майкрософт автоматически присваивает это значение. Допустимые значения: `low`, `medium`, `high`. Наследуется от recommendationBase. Только для чтения. Поддерживает `$filter`(`eq`).
recommendationType	recommendationType	Понятное короткое имя для определения рекомендации. Возможные значения: `adfsAppsMigration`, , `enableDesktopSSOenablePHS`, , `enableProvisioning`, `switchFromPerUserMFAtenantMFA`, , `thirdPartyAppsappRoleAssignmentsUsersoverprivilegedAppspwagePolicyNewappRoleAssignmentsGroupsintegratedAppsmanagedIdentitysigninRiskPolicyadminMFAV2servicePrincipalKeyExpiryapplicationCredentialExpiryroleOverlapmfaRegistrationV2staleAppCredsblockLegacyAuthenticationpasswordHashSyncverifyAppPublisherprivateLinkForAADuserRiskPolicyselfServicePasswordResetoneAdminstaleAppsuseMyAppsuseAuthenticatorAppturnOffPerUserMFA`, `unknownFutureValue`, `longLivedCredentials`, , . `aadConnectDeprecatedadalToMsalMigrationownerlessAppsinactiveGuestsaadGraphDeprecationApplicationaadGraphDeprecationServicePrincipalmfaServerDeprecation` Обратите внимание, что необходимо использовать `Prefer: include-unknown-enum-members` заголовок запроса для получения следующих значений в этом развиваемом перечислении: `longLivedCredentials` , `aadConnectDeprecated` , `adalToMsalMigration` , `ownerlessApps` , `inactiveGuests` , `aadGraphDeprecationApplication` , `aadGraphDeprecationServicePrincipal` . `mfaServerDeprecation` Наследуется от recommendationBase. В настоящее время доступно только ограниченное число. Дополнительные сведения см. в разделе Типы рекомендаций. Поддерживает `$filter`(`eq`).
releaseType	releaseType	Текущий тип выпуска рекомендации. Допустимые значения: `preview`, `generallyAvailable`, `unknownFutureValue`. Наследуется от recommendationBase.
remediationImpact	String	Описание влияния исправления на пользователей. Применяется только к рекомендациям с категорией , для нее задано значение `identitySecureScore`. Наследуется от recommendationBase.
status	recommendationStatus	Указывает состояние рекомендации на основе действия пользователя или системы. Допустимые значения: `active`, `completedBySystem`, `completedByUser`, `dismissed`, `postponed`, `unknownFutureValue`. По умолчанию состояние рекомендации устанавливается в значение `active` при первом создании рекомендации. Состояние имеет значение , `completedBySystem` когда наша служба обнаруживает, что рекомендация, которая ранее была активной, больше не применяется. Наследуется от recommendationBase. Поддерживает `$filter`(`eq`).

Связи

Связь	Тип	Описание
impactedResources	коллекция impactedResource	Список объектов каталога, связанных с рекомендацией. Наследуется от recommendationBase.

Представление JSON

В следующем представлении JSON показан тип ресурса.

{
  "@odata.type": "#microsoft.graph.recommendation",
  "id": "String (identifier)",
  "actionSteps": [
    {
      "@odata.type": "microsoft.graph.actionStep"
    }
  ],
  "benefits": "String",
  "category": "String",
  "createdDateTime": "String (timestamp)",
  "currentScore": "Double",
  "displayName": "String",
  "featureAreas": [
    "String"
  ],
  "impactType": "String",
  "impactStartDateTime": "String (timestamp)",
  "insights": "String",
  "lastCheckedDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "lastModifiedBy": "String",
  "maxScore": "Double",
  "postponeUntilDateTime": "String (timestamp)",
  "priority": "String",
  "status": "String",
  "remediationImpact": "String",
  "recommendationType": "String"
}

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