Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Espace de noms: microsoft.graph
Importante
Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
Représente une ressource Microsoft Entra dans votre locataire associée à une recommandation Microsoft Entra ID.
Hérite de l’entité.
Méthodes
| Méthode | Type de retour | Description |
|---|---|---|
| List | impactedResource collection | Obtenez les ressources impactedResource à partir de la propriété de navigation impactedResources. |
| Obtenir | impactedResource | Lire les propriétés et les relations d’un objet impactedResource . |
| Reporter | impactedResource | Marquez le status d’un objet impactedResource sur postponed une date et une heure spécifiées. |
| Dismiss | impactedResource | Marquez le status d’un objet impactedResource comme dismissed. |
| Complete | impactedResource | Marquez le status d’un objet impactedResource comme completedByUser. |
| Réactiver | impactedResource | Marquez le status d’un objet impactedResource comme active. |
| Marquer comme planifié | impactedResource | Marquez le status d’un objet impactedResource comme planned. |
| Accepter le risque | impactedResource | Marquez le status d’un objet impactedResource comme riskAccepted. |
| Appliquer une autre atténuation | impactedResource | Marquez le status d’un objet impactedResource comme alternateMitigation. |
| Ajouter une étiquette | recommendationTag | Ajoutez une balise définie par l’utilisateur à une ressource impacted. |
| Supprimer la balise | impactedResource | Supprimez une balise définie par l’utilisateur d’une ressource impacted. |
| Ajouter une étiquette à plusieurs ressources | impactedResource collection | Ajoutez la même étiquette à un maximum de 50 objets impactedResource dans une seule requête. |
| Supprimer l’étiquette de plusieurs ressources | impactedResource collection | Supprimez la même étiquette pour un maximum de 50 objets impactedResource dans une seule requête. |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| addedDateTime | DateTimeOffset | Date et heure auxquelles l’objet impactedResource a été initialement associé à la recommandation. |
| additionalDetails | Collection keyValue | Informations supplémentaires propres à la ressource concernée pour faciliter la mise en contexte de la recommandation. |
| apiUrl | String | Lien URL vers la ressource Microsoft Entra correspondante. |
| displayName | String | Nom convivial de la ressource Microsoft Entra. |
| id | String | Identificateur unique de la ressource Microsoft Entra concernée. |
| lastModifiedBy | String | Nom de l’utilisateur ou du service qui a mis à jour le status pour la dernière fois. |
| lastModifiedDateTime | String | Date et heure de la dernière mise à jour du status. |
| owner | String | Utilisateur responsable de la maintenance de la ressource. |
| portalUrl | String | Lien URL vers la page correspondante du centre dʼadministration Microsoft Entra de la ressource. |
| postponeUntilDateTime | DateTimeOffset | La date et heure futures auxquelles le status d’une ressource impactée reportée sera active à nouveau. |
| rank | Int32 | Indique l’importance de la ressource. Une ressource dont le rang est égal à 1 est de la plus haute importance. |
| recommendationId | String | Identificateur unique de la recommandation à laquelle la ressource est associée. |
| resourceType | String | Indique le type de ressource Microsoft Entra. Par exemple, application, .user |
| status | recommendationStatus | Indique si une ressource doit être adressée. Les valeurs possibles sont : active, , completedByUsercompletedBySystem, dismissedpostponedalternateMitigationthirdPartyneedsMoreActionunknownFutureValueriskAcceptedplanned. Utilisez l’en-tête de Prefer: include-unknown-enum-members requête pour obtenir les valeurs suivantes à partir de cette énumération évolutive : riskAccepted , thirdParty , , plannedalternateMitigation , needsMoreAction, . Par défaut, le status d’une recommandation est défini sur active le moment où la recommandation est générée pour la première fois.
Le statut est défini lorsque notre service détecte qu’une completedBySystem ressource qui était active ne s’applique plus. |
| subjectId | String | Identificateur unique associé, selon resourceType. Par exemple, cette propriété est définie sur si applicationIdresourceType est un application. |
Relations
| Relation | Type | Description |
|---|---|---|
| étiquettes | collection recommendationTag | Étiquettes de forme libre définies par l’utilisateur appliquées à impactedResource. La collection n’est pas directement accessible en écriture ; Les balises sont créées et supprimées via les actions addTag et removeTag . |
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"@odata.type": "#microsoft.graph.impactedResource",
"id": "String (identifier)",
"subjectId": "String",
"recommendationId": "String",
"addedDateTime": "String (timestamp)",
"portalUrl": "String",
"apiUrl": "String",
"displayName": "String",
"resourceType": "String",
"owner": "String",
"rank": "Integer",
"status": "String",
"additionalDetails": [
{
"@odata.type": "microsoft.graph.keyValue"
}
],
"lastModifiedBy": "String",
"lastModifiedDateTime": "String",
"postponeUntilDateTime": "String (timestamp)"
}