Тип ресурса recommendationBase
Пространство имен: microsoft.graph
Важно!
API версии /beta
в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Абстрактный тип, предоставляющий свойства для типа ресурса рекомендации .
Методы
Нет.
Свойства
Свойство | Тип | Описание |
---|---|---|
actionSteps | коллекция actionStep | Список действий, выполняемых для выполнения рекомендации. |
Преимущества | String | Объяснение того, почему выполнение рекомендации принесет вам пользу. Соответствует разделу Значение рекомендации, показанной в Центре администрирования Microsoft Entra. |
category | recommendationCategory | Указывает категорию интеллектуального руководства, к которому относится рекомендация. Допустимые значения: identityBestPractice , identitySecureScore , unknownFutureValue . |
createdDateTime | DateTimeOffset | Дата и время обнаружения рекомендации в соответствии с вашим каталогом. |
currentScore | Двойное с плавающей точкой | Количество баллов, достигнутое клиентом. Применяется только к рекомендациям с категорией , для нее задано значение identitySecureScore . |
displayName | String | Заголовок рекомендации. |
featureAreas | коллекция recommendationFeatureAreas | Компонент каталога, с которым связана рекомендация . |
id | String | Уникальный идентификатор объекта рекомендации , созданного для клиента. Это объединение идентификатора клиента и псевдонима, присвоенного идентификатором Microsoft Entra для рекомендации. Пример: 7918d4b5-0442-4a97-be2d-36f9f9962ece_Microsoft.Identity.IAM.Insights.ThirdPartyApps |
impactStartDateTime | DateTimeOffset | Дата и время выполнения рекомендации в будущем. |
impactType | String | Указывает область влияния рекомендации.
Tenant level указывает, что рекомендация влияет на весь клиент. Другие возможные значения: users , applications . |
insights | String | Описывает, почему рекомендация однозначно применяется к вашему каталогу. Соответствует разделу Описание рекомендации, показанной в Центре администрирования Microsoft Entra. |
lastCheckedDateTime | DateTimeOffset | Последняя дата и время, когда рекомендация считается применимой к вашему каталогу. |
lastModifiedBy | String | Имя пользователя, который в последний раз обновлял состояниерекомендации. |
lastModifiedDateTime | DateTimeOffset | Дата и время последнего обновления состояниярекомендации . |
maxScore | Двойное с плавающей точкой | Максимальное достижимое количество баллов. Применяется только к рекомендациям с категорией , для нее задано значение identitySecureScore . |
postponeUntilDateTime | DateTimeOffset | Будущая дата и время повторного выполнения отложенной рекомендацииactive . |
priority | recommendationPriority | Указывает чувствительность времени для выполнения рекомендации . Корпорация Майкрософт автоматически присваивает это значение. Допустимые значения: low , medium , high . |
recommendationType | recommendationType | Понятное короткое имя для определения рекомендации. Возможные значения: adfsAppsMigration , , enableDesktopSSO enablePHS , , enableProvisioning , switchFromPerUserMFA tenantMFA , , thirdPartyApps appRoleAssignmentsUsers overprivilegedApps pwagePolicyNew appRoleAssignmentsGroups integratedApps managedIdentity signinRiskPolicy adminMFAV2 servicePrincipalKeyExpiry applicationCredentialExpiry roleOverlap mfaRegistrationV2 staleAppCreds blockLegacyAuthentication passwordHashSync verifyAppPublisher privateLinkForAAD userRiskPolicy selfServicePasswordReset oneAdmin staleApps useMyApps useAuthenticatorApp turnOffPerUserMFA , 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 . |
remediationImpact | String | Описание влияния исправления на пользователей. Применяется только к рекомендациям с категорией , для нее задано значение identitySecureScore . |
requiredLicenses | requiredLicenses | Необходимые лицензии для просмотра рекомендации. Возможные значения: notApplicable , microsoftEntraIdFree , microsoftEntraIdP1 , microsoftEntraIdP2 , microsoftEntraIdGovernance , microsoftEntraWorkloadId , unknownFutureValue . |
status | recommendationStatus | Указывает состояние рекомендации на основе действия пользователя или системы. Допустимые значения: active , completedBySystem , completedByUser , dismissed , postponed , unknownFutureValue . По умолчанию состояние рекомендации устанавливается в значение active при первом создании рекомендации.
Состояние имеет значение , completedBySystem когда наша служба обнаруживает, что рекомендация, которая ранее была активной, больше не применяется. |
Связи
Связь | Тип | Описание |
---|---|---|
impactedResources | коллекция impactedResource | Список объектов каталога, связанных с рекомендацией. |
Представление JSON
В следующем представлении JSON показан тип ресурса.
{
"@odata.type": "#microsoft.graph.recommendationBase",
"id": "String (identifier)",
"actionSteps": [
{
"@odata.type": "microsoft.graph.actionStep"
}
],
"benefits": "String",
"category": "String",
"createdDateTime": "String (timestamp)",
"currentScore": "Double",
"displayName": "String",
"featureAreas": [
"String"
],
"releaseType": "String",
"requiredLicenses": "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"
}