тип ресурса рекомендации
Пространство имен: 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"
}