Edytuj

impactedResource resource type

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents a Microsoft Entra resource in your tenant that's associated with a Microsoft Entra ID recommendation.

Inherits from entity.

Methods

Method Return type Description
List impactedResource collection Get the impactedResource resources from the impactedResources navigation property.
Get impactedResource Read the properties and relationships of an impactedResource object.
Postpone impactedResource Mark the status of an impactedResource object as postponed to a specified date and time.
Dismiss impactedResource Mark the status of an impactedResource object as dismissed.
Complete impactedResource Mark the status of an impactedResource object as completedByUser.
Reactivate impactedResource Mark the status of an impactedResource object as active.
Mark planned impactedResource Mark the status of an impactedResource object as planned.
Accept risk impactedResource Mark the status of an impactedResource object as riskAccepted.
Apply alternate mitigation impactedResource Mark the status of an impactedResource object as alternateMitigation.
Add tag recommendationTag Add a user-defined tag to an impactedResource.
Remove tag impactedResource Remove a user-defined tag from an impactedResource.
Add tag to multiple resources impactedResource collection Add the same tag to up to 50 impactedResource objects in a single request.
Remove tag from multiple resources impactedResource collection Remove the same tag from up to 50 impactedResource objects in a single request.

Properties

Property Type Description
addedDateTime DateTimeOffset The date and time when the impactedResource object was initially associated with the recommendation.
additionalDetails keyValue collection Additional information unique to the impactedResource to help contextualize the recommendation.
apiUrl String The URL link to the corresponding Microsoft Entra resource.
displayName String Friendly name of the Microsoft Entra resource.
id String A unique identifier of the impacted Microsoft Entra resource.
lastModifiedBy String Name of the user or service that last updated the status.
lastModifiedDateTime String The date and time when the status was last updated.
owner String The user responsible for maintaining the resource.
portalUrl String The URL link to the corresponding Microsoft Entra admin center page of the resource.
postponeUntilDateTime DateTimeOffset The future date and time when the status of a postponed impactedResource will be active again.
rank Int32 Indicates the importance of the resource. A resource with a rank equal to 1 is of the highest importance.
recommendationId String The unique identifier of the recommendation that the resource is associated with.
resourceType String Indicates the type of Microsoft Entra resource. Examples include user, application.
status recommendationStatus Indicates whether a resource needs to be addressed. The possible values are: active, completedBySystem, completedByUser, dismissed, postponed, unknownFutureValue, riskAccepted, thirdParty, planned, alternateMitigation, needsMoreAction. Use the Prefer: include-unknown-enum-members request header to get the following values from this evolvable enum: riskAccepted , thirdParty , planned , alternateMitigation , needsMoreAction. By default, a recommendation's status is set to active when the recommendation is first generated. Status is set to completedBySystem when our service detects that a resource which was once active no longer applies.
subjectId String The related unique identifier, depending on the resourceType. For example, this property is set to the applicationId if the resourceType is an application.

Relationships

Relationship Type Description
tags recommendationTag collection The user-defined free-form labels applied to the impactedResource. The collection isn't directly writable; tags are created and removed through the addTag and removeTag actions.

JSON representation

The following JSON representation shows the resource type.

{
  "@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)"
}
  • Last updated on