Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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.
Representa uma prática recomendada ou uma ação de aprimoramento do Microsoft Entra ID recomendada pela Microsoft para seu locatário do Microsoft Entra.
O serviço de recomendação do Microsoft Entra é executado diariamente para marcar seu locatário em relação a condições predefinidas para cada recomendação. Se o serviço detectar que uma recomendação se aplica ao seu locatário, o objeto de recomendação correspondente será gerado e seu status será definido como ativo.
Para obter mais informações, consulte O que são as recomendações do Microsoft Entra?.
Herda de recommendationBase.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| List | Coleção de recomendações | Obtenha uma lista dos objetos de recomendação e suas propriedades. |
| Get | recomendação | Leia as propriedades e relações de um objeto de recomendação . |
| Adiar | recomendação | Marcar o status de um objeto de recomendação como postponed data e hora especificadas. |
| Dismiss | recomendação | Marcar o status de um objeto de recomendação como dismissed. |
| Concluído | recomendação | Marcar o status de um objeto de recomendação como completedByUser. |
| Reativar | recomendação | Marcar o status de um objeto de recomendação como active. |
| Marcar planejado | recomendação | Marcar o status de um objeto de recomendação como planned. |
| Aceitar o risco | recomendação | Marcar o status de um objeto de recomendação como riskAccepted. |
| Aplicar mitigação alternativa | recomendação | Marcar o status de um objeto de recomendação como alternateMitigation. |
| Adicionar marca | RecommendationTag | Adicione uma marca definida pelo usuário a uma recomendação. |
| Remover marca | recomendação | Remova uma marca definida pelo usuário de uma recomendação. |
| Obter Classificação de Segurança do Locatário | Coleção tenantSecureScore | Obtenha dados históricos do Secure Score para seu locatário. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| etapas de ação | Coleção actionStep | Lista de ações a serem executadas para concluir uma recomendação. Herdado de recommendationBase. |
| 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. Herdado de recommendationBase. |
| 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. Herdado de recommendationBase. Suportes $filter(eq). |
| 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. Herdado de recommendationBase. Somente leitura. Suportes $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. Herdado de recommendationBase. |
| 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. É null se a recomendação não foi concluída por um usuário no ciclo atual. Herdado de recommendationBase. |
| createdDateTime | DateTimeOffset | A data e a hora em que a recomendação foi detectada como aplicável ao seu diretório. Herdado de recommendationBase. |
| currentScore | Duplo | O número de pontos que o locatário atingiu. Aplica-se somente a recomendações com categoria definida como identitySecureScore. Herdado de recommendationBase. |
| displayName | Cadeia de caracteres | O título da recomendação. Herdado de recommendationBase. |
| 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. É mutuamente exclusivo com remediatedDateTime. É null quando nenhum recurso revisado pelo usuário está falhando na verificação no momento. Herdado de recommendationBase. |
| featureAreas | Coleção recommendationFeatureAreas | O recurso de diretório ao qual a recomendação está relacionada. Herdado de recommendationBase. Suportes $filter(eq). |
| 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. Herdado de recommendationBase. |
| impactStartDateTime | DateTimeOffset | A data e a hora futuras em que uma recomendação deve ser concluída. Herdado de recommendationBase. |
| 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. Herdado de recommendationBase. |
| 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. Herdado de recommendationBase. |
| lastCheckedDateTime | DateTimeOffset | A data e hora mais recentes em que uma recomendação foi considerada aplicável ao seu diretório. Herdado de recommendationBase. |
| lastModifiedBy | Cadeia de caracteres | Nome do usuário que atualizou pela última vez o status da recomendação. Herdado de recommendationBase. |
| lastModifiedDateTime | DateTimeOffset | A data e a hora em que o status de uma recomendação foi atualizado pela última vez. Herdado de recommendationBase. |
| maxScore | Duplo | O número máximo de pontos atingíveis. Aplica-se somente a recomendações com categoria definida como identitySecureScore. Herdado de recommendationBase. |
| 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. Herdado de recommendationBase. |
| nistClassifications | Coleção nistClassification | As categorias do NIST Cybersecurity Framework (CSF) 2.0 para as quais a recomendação é mapeada. Herdado de recommendationBase. Somente leitura. |
| postponeUntilDateTime | DateTimeOffset | A data e a hora futuras em que o status de uma recomendação adiada será active novamente. Herdado de recommendationBase. |
| 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. Herdado de recommendationBase. Somente leitura. Suportes $filter(eq). |
| 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 Herdado de recommendationBase. Atualmente, apenas um número limitado está disponível. Para obter mais informações, consulte Tipos de recomendações. Suportes $filter(eq). |
| releaseType | releaseType | O tipo de versão atual da recomendação. Os valores possíveis são: preview, generallyAvailable, unknownFutureValue. Herdado de recommendationBase. |
| 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. Herdado de recommendationBase. |
| 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. Herdado de recommendationBase. |
| 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. Herdado de recommendationBase. Suportes $filter(eq). |
| 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. Herdado de recommendationBase. |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| impactedResources | Coleção de impactedResource | A lista de objetos de diretório associados à recomendação. Herdado de recommendationBase. |
| 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 . Herdado de recommendationBase. |
Representação JSON
A representação JSON a seguir mostra o tipo de recurso.
{
"@odata.type": "#microsoft.graph.recommendation",
"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"
],
"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"
}