tipo de recurso de recomendação
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 melhor prática ou ação de melhoramento do Microsoft Entra ID recomendada pela Microsoft para o seu inquilino do Microsoft Entra.
O serviço de recomendação do Microsoft Entra é executado diariamente para verificar o seu inquilino relativamente às condições predefinidas para cada recomendação. Se o serviço detetar que uma recomendação se aplica ao seu inquilino, o objeto de recomendação correspondente é gerado e o respetivo estado está definido como ativo.
Para obter mais informações, consulte O que são as recomendações do Microsoft Entra?.
Herda da 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 respetivas propriedades. |
| Get | recomendação | Leia as propriedades e relações de um objeto de recomendação . |
| Adiar | recomendação | Marque o estado de um objeto de recomendação como postponed uma data e hora especificadas. |
| Dismiss | recomendação | Marcar o estado de um objeto de recomendação como dismissed. |
| Concluído | recomendação | Marcar o estado de um objeto de recomendação como completedByUser. |
| Reativar | recomendação | Marcar o estado de um objeto de recomendação como active. |
| Obter Pontuação de Segurança do inquilino | coleção tenantSecureScore | Obtenha dados históricos de Classificação de Segurança para o seu inquilino. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| actionSteps | actionPass collection | Lista de ações a executar para concluir uma recomendação. Herdado da recommendationBase. |
| benefícios | Cadeia de caracteres | Uma explicação do motivo pelo qual concluir a recomendação irá beneficiar o utilizador. Corresponde à secção Valor de uma recomendação apresentada no centro de administração do Microsoft Entra. Herdado da recommendationBase. |
| category | recommendationCategory | Indica a categoria de orientação inteligente na qual a recomendação se enquadra. Os valores possíveis são: identityBestPractice, identitySecureScore, unknownFutureValue. Herdado da recommendationBase. $filterSuporta (eq). |
| createdDateTime | DateTimeOffset | A data e hora em que a recomendação foi detetada como aplicável ao diretório. Herdado da recommendationBase. |
| currentScore | Duplo | O número de pontos atingidos pelo inquilino. Aplica-se apenas a recomendações com categoria definida como identitySecureScore. Herdado da recommendationBase. |
| displayName | Cadeia de caracteres | O título da recomendação. Herdado da recommendationBase. |
| featureAreas | recommendationFeatureAreas collection | A funcionalidade de diretório à qual a recomendação está relacionada. Herdado da recommendationBase. $filterSuporta (eq). |
| id | Cadeia de caracteres | O identificador exclusivo do objeto de recomendação gerado para o seu inquilino. Esta é uma concatenação do seu ID de inquilino e uma alcunha atribuída ao ID do Microsoft Entra para a recomendação. Por exemplo, 7918d4b5-0442-4a97-be2d-36f9f9962ece_Microsoft.Identity.IAM.Insights.ThirdPartyApps. Herdado da recommendationBase. |
| impactStartDateTime | DateTimeOffset | A data e hora futuras em que uma recomendação deve ser concluída. Herdado da recommendationBase. |
| impactType | Cadeia de caracteres | Indica o âmbito do impacto de uma recomendação.
Tenant level indica que a recomendação afeta todo o inquilino. Outros valores possíveis incluem users, applications. Herdado da recommendationBase. |
| insights | Cadeia de caracteres | Descreve o motivo pelo qual uma recomendação se aplica exclusivamente ao seu diretório. Corresponde à secção Descrição de uma recomendação apresentada no centro de administração do Microsoft Entra. Herdado da recommendationBase. |
| lastCheckedDateTime | DateTimeOffset | A data e hora mais recentes em que uma recomendação foi considerada aplicável ao seu diretório. Herdado da recommendationBase. |
| lastModifiedBy | Cadeia de caracteres | Nome do utilizador que atualizou pela última vez o estado da recomendação. Herdado da recommendationBase. |
| lastModifiedDateTime | DateTimeOffset | A data e hora em que o estado de uma recomendação foi atualizado pela última vez. Herdado da recommendationBase. |
| maxScore | Duplo | O número máximo de pontos a atingir. Aplica-se apenas a recomendações com categoria definida como identitySecureScore. Herdado da recommendationBase. |
| postponeUntilDateTime | DateTimeOffset | A data e hora futuras em que o estado de uma recomendação adiada será active novamente. Herdado da recommendationBase. |
| prioridade | recommendationPriority | Indica a sensibilidade de tempo para a conclusão de uma recomendação . A Microsoft atribui automaticamente este valor. Os valores possíveis são: low, medium, high. Herdado da recommendationBase. Somente leitura. $filterSuporta (eq). |
| recommendationType | recommendationType | Nome abreviado amigável para identificar a recomendação. Os valores possíveis são: adfsAppsMigration, , enableDesktopSSO, enablePHSenableProvisioning, switchFromPerUserMFA, thirdPartyAppstenantMFA, turnOffPerUserMFA, , useAuthenticatorApp, useMyApps, staleAppCredsapplicationCredentialExpiryblockLegacyAuthenticationservicePrincipalKeyExpiryintegratedAppsstaleAppsadminMFAV2, oneAdminpasswordHashSyncselfServicePasswordResetverifyAppPublisherappRoleAssignmentsUsersuserRiskPolicyappRoleAssignmentsGroupspwagePolicyNewmfaRegistrationV2privateLinkForAADsigninRiskPolicyoverprivilegedAppsunknownFutureValueroleOverlapmanagedIdentity, longLivedCredentials, aadConnectDeprecated, adalToMsalMigration, ownerlessApps, inactiveGuests, aadGraphDeprecationApplication, , . mfaServerDeprecationaadGraphDeprecationServicePrincipal Tenha em atenção que tem de utilizar o cabeçalho do Prefer: include-unknown-enum-members pedido para obter os seguintes valores nesta enumeração evoluível: longLivedCredentials , , aadConnectDeprecated , adalToMsalMigration , ownerlessAppsinactiveGuests , , aadGraphDeprecationApplication , aadGraphDeprecationServicePrincipal , . mfaServerDeprecation Herdado da recommendationBase. Atualmente, só está disponível um número limitado. Para obter mais informações, veja Tipos de recomendações. $filterSuporta (eq). |
| releaseType | releaseType | O tipo de versão atual da recomendação. Os valores possíveis são: preview, generallyAvailable, unknownFutureValue. Herdado da recommendationBase. |
| remediationImpact | Cadeia de caracteres | Descrição do impacto nos utilizadores da remediação. Aplica-se apenas a recomendações com categoria definida como identitySecureScore. Herdado da recommendationBase. |
| status | recommendationStatus | Indica o estado da recomendação com base na ação do utilizador ou do sistema. Os valores possíveis são: active, completedBySystem, completedByUser, dismissed, postponed, unknownFutureValue. Por predefinição, o estado de uma recomendação está definido como active quando a recomendação é gerada pela primeira vez.
O estado está definido como completedBySystem quando o nosso serviço deteta que uma recomendação anteriormente ativa já não se aplica. Herdado da recommendationBase. $filterSuporta (eq). |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| impactedResources | coleção impactedResource | A lista de objetos de diretório associados à recomendação. Herdado da recommendationBase. |
Representação JSON
A representação JSON seguinte mostra o tipo de recurso.
{
"@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"
}