recommendationBase tipo de recurso

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Um tipo abstrato que expõe as propriedades do tipo de recurso de recomendação .

Métodos

Nenhum.

Propriedades

Propriedade Tipo Descrição
etapas de ação Coleção actionStep Lista de ações a serem executadas para concluir uma recomendação.
Benefícios Cadeia de caracteres Uma explicação de por que concluir a recomendação irá beneficiá-lo. Corresponde à seção Valor de uma recomendação mostrada no centro de administração do Microsoft Entra.
category recommendationCategory Indica a categoria de orientação inteligente em que a recomendação se enquadra. Os valores possíveis são: identityBestPractice, identitySecureScore, unknownFutureValue, mdiSecureScore. Use o Prefer: include-unknown-enum-members cabeçalho da solicitação para obter os seguintes valores dessa enumeração evolutiva: mdiSecureScore.
categoryGroup recommendationCategoryGroup O grupo de taxonomia de negócios ao qual a recomendação pertence é usado para organizar recomendações no centro de administração do Microsoft Entra. Os valores possíveis são strengthenAuthentication, detectAndRespondToThreats, enforceLeastPrivilege, governAppsCredentialsAndAgents, hardenInfrastructure, defenderForIdentity, unknownFutureValue. Somente leitura. Suporta $filter (eq).
completedBySystemDateTime DateTimeOffset A data e a hora em que o serviço de recomendações verificou que a recomendação foi totalmente corrigida e definiu seu status como completedBySystem. É null se a recomendação não foi concluída pelo sistema. Oferece suporte para $filter.
completedByUserDateTime DateTimeOffset A data e a hora em que a recomendação foi marcada como concluída pelo usuário para o ciclo de revisão atual, incluindo quando o valor é acumulado de todos os recursos afetados marcados como concluídos pelo usuário. É null se a recomendação não foi concluída por um usuário no ciclo atual. Oferece suporte para $filter.
createdDateTime DateTimeOffset A data e a hora em que a recomendação foi detectada como aplicável ao seu diretório.
currentScore Duplo O número de pontos que o locatário atingiu. Aplica-se somente a recomendações com categoria definida como identitySecureScore.
displayName Cadeia de caracteres O título da recomendação.
failedReviewDateTime DateTimeOffset A data e a hora em que o serviço de recomendações verificou mais recentemente se um ou mais recursos afetados pelo usuário marcou como concluídos ainda são afetados, movendo-os para needsMoreAction. É limpo quando os recursos revisados são corrigidos, portanto, é mutuamente exclusivo com remediatedDateTime. É null quando nenhum recurso revisado pelo usuário está falhando na verificação no momento. Oferece suporte para $filter.
featureAreas Coleção recommendationFeatureAreas O recurso de diretório ao qual a recomendação está relacionada.
id Cadeia de caracteres O identificador exclusivo do objeto de recomendação gerado para seu locatário. Essa é uma concatenação de sua ID de locatário e um apelido atribuído pelo Microsoft Entra ID para a recomendação. Por exemplo, 7918d4b5-0442-4a97-be2d-36f9f9962ece_Microsoft.Identity.IAM.Insights.ThirdPartyApps
impactStartDateTime DateTimeOffset A data e a hora futuras em que uma recomendação deve ser concluída.
impactType Cadeia de caracteres Indica o escopo do impacto de uma recomendação. tenantLevel Indica que a recomendação afeta todo o locatário. Outros valores possíveis incluem users, apps.
insights Cadeia de caracteres Descreve por que uma recomendação se aplica exclusivamente ao seu diretório. Corresponde à seção Descrição de uma recomendação mostrada no centro de administração do Microsoft Entra.
lastCheckedDateTime DateTimeOffset A data e hora mais recentes em que uma recomendação foi considerada aplicável ao seu diretório.
lastModifiedBy Cadeia de caracteres Nome do usuário que atualizou pela última vez o status da recomendação.
lastModifiedDateTime DateTimeOffset A data e a hora em que o status de uma recomendação foi atualizado pela última vez.
maxScore Duplo O número máximo de pontos atingíveis. Aplica-se somente a recomendações com categoria definida como identitySecureScore.
needsMoreActionResourceCount Int32 O número de recursos afetados que o usuário marcou como concluídos e que o serviço de recomendações verificou posteriormente ainda estão afetados (movidos para needsMoreAction). Esse valor é maior que zero exatamente quando failedReviewDateTime é definido. É null quando a recomendação não participa do ciclo de vida da revisão.
nistClassifications Coleção nistClassification As categorias do NIST Cybersecurity Framework (CSF) 2.0 para as quais a recomendação é mapeada. Somente leitura.
postponeUntilDateTime DateTimeOffset A data e a hora futuras em que o status de uma recomendação adiada será active novamente.
prioridade recommendationPriority Indica a sensibilidade ao tempo para que uma recomendação seja concluída. A Microsoft atribui automaticamente esse valor. Os valores possíveis são: low, medium, high, critical, unknownFutureValue.
RecommendationType RecommendationType Nome abreviado amigável para identificar a recomendação. Os valores possíveis são: adfsAppsMigration, enableDesktopSSO, enablePHS, enableProvisioningturnOffPerUserMFAmanagedIdentityuseAuthenticatorAppoverprivilegedAppsuseMyAppsmfaServerDeprecationapplicationCredentialExpiryaadGraphDeprecationServicePrincipalstaleAppCredsaadGraphDeprecationApplicationservicePrincipalKeyExpiryinactiveGuestsstaleAppsownerlessAppsadminMFAV2thirdPartyAppsprivateLinkForAADblockLegacyAuthenticationappRoleAssignmentsGroupsintegratedAppsappRoleAssignmentsUsersaadConnectDeprecatedverifyAppPublisheradalToMsalMigrationlongLivedCredentialsunknownFutureValueuserRiskPolicysigninRiskPolicyselfServicePasswordResetroleOverlappasswordHashSyncmfaRegistrationV2oneAdminswitchFromPerUserMFAtenantMFApwagePolicyNew, Use o cabeçalho da Prefer: include-unknown-enum-members solicitação para obter os seguintes membros nesta enumeração evolutiva: longLivedCredentials , aadConnectDeprecated , adalToMsalMigration , ownerlessAppsinactiveGuests , , aadGraphDeprecationApplication , , aadGraphDeprecationServicePrincipal , . mfaServerDeprecation
releaseType releaseType O tipo de versão atual da recomendação. Os valores possíveis são: preview, generallyAvailable, unknownFutureValue.
remediatedDateTime DateTimeOffset A data e a hora em que o serviço de recomendações verificou se os recursos afetados que o usuário marcou como concluídos foram corrigidos, ou seja, os recursos revisados pelo usuário alcançaram completedBySystem. É substituído por failedReviewDateTime se um recurso revisado falhar posteriormente na verificação. É null se o sistema não verificou uma correção orientada pelo usuário no ciclo atual. Oferece suporte para $filter.
remediaçãoImpacto Cadeia de caracteres Descrição do impacto da correção sobre os usuários. Aplica-se somente a recomendações com categoria definida como identitySecureScore.
Licenças necessárias Licenças necessárias As licenças necessárias para exibir a recomendação. Os valores possíveis são: notApplicable, microsoftEntraIdFree, microsoftEntraIdP1, microsoftEntraIdP2microsoftEntraIdGovernance, microsoftEntraWorkloadId, , unknownFutureValue, , aatp, . microsoftEntraSuite Use o Prefer: include-unknown-enum-members cabeçalho da solicitação para obter os seguintes valores dessa enumeração evolutiva: aatp, microsoftEntraSuite.
status recommendationStatus Indica o status da recomendação com base na ação do usuário ou do sistema. Os valores possíveis são: active, completedBySystem, completedByUser, dismissedriskAcceptedthirdPartyunknownFutureValuepostponed, , planned, , . needsMoreActionalternateMitigation Use o Prefer: include-unknown-enum-members cabeçalho da solicitação para obter os seguintes valores dessa enumeração evolutiva: riskAccepted , thirdParty , planned , alternateMitigation , needsMoreAction, . Por padrão, o status de uma recomendação é definido como active quando a recomendação é gerada pela primeira vez. O status é definido como completedBySystem quando nosso serviço detecta que uma recomendação que estava ativa anteriormente não se aplica mais.
statusModifiedDateTime DateTimeOffset A data e a hora em que o status da recomendação foi alterado pela última vez, por exemplo, de , postponedcompletedByUserdismissed, active , ou .needsMoreAction Ao contrário de lastModifiedDateTime, esse valor não é atualizado quando apenas os dados de insight da recomendação são alterados enquanto o status permanece o mesmo. É null até que o status da recomendação seja alterado pela primeira vez. Oferece suporte para $filter.

Relações

Relação Tipo Descrição
impactedResources Coleção de impactedResource A lista de objetos de diretório associados à recomendação.
tags Coleção RecommendationTag Os rótulos de forma livre definidos pelo usuário aplicados à recomendação. A coleção não é gravável diretamente; As marcas são criadas e removidas por meio das ações addTag e removeTag .

Representação JSON

A representação JSON a seguir mostra o tipo de recurso.

{
  "@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"
}
  • Última atualização em