tipo de recurso de recomendação

Artigo
02/26/2024

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 Microsoft Entra ID ação de melhor prática ou aprimoramento recomendada pela Microsoft para seu locatário Microsoft Entra.

O serviço de recomendação Microsoft Entra é executado diariamente para marcar seu locatário em relação às condições predefinidas para cada recomendação. Se o serviço detectar que uma recomendação se aplica ao 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 é Microsoft Entra recomendações?.

Herda de recommendationBase.

Métodos

Método	Tipo de retorno	Descrição
Listar recomendações	coleção de recomendações	Obtenha uma lista dos objetos de recomendação e suas propriedades.
Obter recomendação	recomendação	Leia as propriedades e as relações de um objeto de recomendação .
Adiar	recomendação	Marque o status de um objeto de recomendação quanto `postponed` a uma data e hora especificadas.
Dismiss	recomendação	Marque o status de um objeto de recomendação como `dismissed`.
Concluído	recomendação	Marque o status de um objeto de recomendação como `completedByUser`.
Reativar	recomendação	Marque o status de um objeto de recomendação como `active`.
Obter locatárioSecureScores	coleção tenantSecureScore	Obtenha dados históricos de Pontuação Segura para seu locatário.

Propriedades

Propriedade	Tipo	Descrição
actionSteps	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 beneficiará você. 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 sob a qual a recomendação se enquadra. Os valores possíveis são: `identityBestPractice`, `identitySecureScore`, `unknownFutureValue`. Herdado de recommendationBase. `$filter`Dá suporte (`eq`).
createdDateTime	DateTimeOffset	A data e a hora em que a recomendação foi detectada conforme aplicável ao diretório. Herdado de recommendationBase.
currentScore	Duplo	O número de pontos que o locatário alcançou. Aplica-se apenas a recomendações com categoria definida como `identitySecureScore`. Herdado de recommendationBase.
displayName	Cadeia de caracteres	O título da recomendação. Herdado de recommendationBase.
featureAreas	coleção recommendationFeatureAreas	O recurso de diretório ao qual a recomendação está relacionada. Herdado de recommendationBase. `$filter`Dá suporte (`eq`).
id	Cadeia de caracteres	O identificador exclusivo do objeto de recomendação gerado para seu locatário. Essa é uma concatenação da ID do locatário e um apelido atribuído 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. `Tenant level` indica que a recomendação afeta todo o locatário. Outros valores possíveis incluem `users`, `applications`. Herdado de recommendationBase.
insights	Cadeia de caracteres	Descreve por que uma recomendação se aplica exclusivamente ao 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 que uma recomendação foi considerada aplicável ao 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 alcançáveis. Aplica-se apenas a recomendações com categoria definida como `identitySecureScore`. Herdado de recommendationBase.
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 confidencialidade de tempo para que uma recomendação seja concluída. A Microsoft atribui automaticamente esse valor. Os valores possíveis são: `low`, `medium`, `high`. Herdado de recommendationBase. Somente leitura. `$filter`Dá suporte (`eq`).
recommendationType	recommendationType	Nome curto amigável para identificar a recomendação. Os valores possíveis são: `adfsAppsMigration`, , `enableDesktopSSO`, `enablePHS`, `enableProvisioning`, `switchFromPerUserMFA`, `thirdPartyAppsoverprivilegedAppsappRoleAssignmentsUsersmanagedIdentitystaleAppCredsstaleAppsuseMyAppsapplicationCredentialExpiryuseAuthenticatorApptenantMFAverifyAppPublisheruserRiskPolicyprivateLinkForAADappRoleAssignmentsGroupsselfServicePasswordResetadalToMsalMigrationroleOverlapunknownFutureValueturnOffPerUserMFAservicePrincipalKeyExpiryadminMFAV2blockLegacyAuthenticationmfaRegistrationV2pwagePolicyNewpasswordHashSynclongLivedCredentialsoneAdminaadConnectDeprecatedsigninRiskPolicyintegratedApps`, `ownerlessApps`, `inactiveGuests`, `aadGraphDeprecationApplication`, . `aadGraphDeprecationServicePrincipalmfaServerDeprecation` Além disso, observe que você deve usar o `Prefer: include-unknown-enum-members` cabeçalho de solicitação para obter os seguintes valores neste enumerável em evolução: `longLivedCredentials`, `aadConnectDeprecated`, , `adalToMsalMigration`, `ownerlessAppsinactiveGuests`. Herdado de recommendationBase. Atualmente, apenas oito tipos estão disponíveis. Para obter mais informações, consulte Tipos de recomendações. `$filter`Dá suporte (`eq`).
releaseType	releaseType	O tipo de versão atual da recomendação. Os valores possíveis são: `preview`, `generallyAvailable`, `unknownFutureValue`. Herdado de recommendationBase.
correçãoImpact	Cadeia de caracteres	Descrição do impacto sobre os usuários da correção. Aplica-se apenas 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`, `dismissed`, `postponed`, `unknownFutureValue`. 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 anteriormente ativa não se aplica mais. Herdado de recommendationBase. `$filter`Dá suporte (`eq`).

Relações

Relação	Tipo	Descrição
impactedResources	coleção impactedResource	A lista de objetos de diretório associados à recomendação. 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",
  "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"
}