Ressourcentyp der betroffenen Ressource

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Stellt eine Microsoft Entra-Ressource in Ihrem Mandanten dar, die einer Microsoft Entra ID-Empfehlung zugeordnet ist.

Erbt von entity.

Methoden

Methode Rückgabetyp Beschreibung
List impactedResource collection Rufen Sie die impactedResource-Ressourcen aus der Navigationseigenschaft impactedResources ab.
Get impactedResource Lesen Sie die Eigenschaften und Beziehungen eines impactedResource-Objekts .
Verschieben impactedResource Markieren des Status eines impactedResource-Objekts zu postponed einem angegebenen Datum und einer angegebenen Uhrzeit.
Dismiss impactedResource Markieren Sie den Status eines impactedResource-Objekts als dismissed.
Complete impactedResource Markieren Sie den Status eines impactedResource-Objekts als completedByUser.
Reaktivieren impactedResource Markieren Sie den Status eines impactedResource-Objekts als active.
Als geplant markieren impactedResource Markieren Sie den Status eines impactedResource-Objekts als planned.
Risiko akzeptieren impactedResource Markieren Sie den Status eines impactedResource-Objekts als riskAccepted.
Wenden Sie eine alternative Risikominderung an impactedResource Markieren Sie den Status eines impactedResource-Objekts als alternateMitigation.
Tag hinzufügen recommendationTag Fügen Sie einer impactedResource ein benutzerdefiniertes Tag hinzu.
Tag entfernen impactedResource Entfernen Sie ein benutzerdefiniertes Tag aus einer impactedResource.
Tag zu mehreren Ressourcen hinzufügen impactedResource collection Fügen Sie dasselbe Tag in einer einzigen Anforderung zu bis zu 50 betroffenen Resource-Objekten hinzu.
Entfernen von Tags aus mehreren Ressourcen impactedResource collection Entfernen Sie dasselbe Tag aus bis zu 50 betroffenen Resource-Objekten in einer einzigen Anforderung.

Eigenschaften

Eigenschaft Typ Beschreibung
addedDateTime DateTimeOffset Das Datum und die Uhrzeit, zu der das impactedResource-Objekt der Empfehlung erstmals zugeordnet wurde.
additionalDetails keyValue-Sammlung Zusätzliche Informationen, die für die impactedResource eindeutig sind, um die Empfehlung kontextualisieren zu können.
apiUrl Zeichenfolge Der URL-Link zur entsprechenden Microsoft Entra-Ressource.
displayName Zeichenfolge Anzeigename der Microsoft Entra-Ressource.
id Zeichenfolge Ein eindeutiger Bezeichner der betroffenen Microsoft Entra-Ressource.
lastModifiedBy Zeichenfolge Name des Benutzers oder Diensts, der den Status zuletzt aktualisiert hat.
lastModifiedDateTime Zeichenfolge Datum und Uhrzeit der letzten Aktualisierung des Status.
owner Zeichenfolge Der Benutzer, der für die Pflege der Ressource verantwortlich ist.
portalUrl Zeichenfolge Der URL-Link zur entsprechenden Microsoft Entra Admin Center-Seite der Ressource.
postponeUntilDateTime DateTimeOffset Das zukünftige Datum und die zukünftige Uhrzeit, zu der der Status einer zurückgestellten betroffenen Ressource wieder angezeigt wirdactive.
rank Int32 Gibt die Bedeutung der Ressource an. Eine Ressource mit einem Rang gleich 1 ist von höchster Wichtigkeit.
recommendationId Zeichenfolge Der eindeutige Bezeichner der Empfehlung , der die Ressource zugeordnet ist.
resourceType Zeichenfolge Gibt den Typ der Microsoft Entra-Ressource an. Beispiele hierfür sind user, application.
status recommendationStatus Gibt an, ob eine Ressource adressiert werden muss. Die möglichen Werte sind: active, completedBySystem, completedByUser, dismissed, postponed, unknownFutureValuealternateMitigationriskAcceptedplannedthirdPartyneedsMoreAction. Verwenden Sie den Prefer: include-unknown-enum-members Anforderungsheader, um die folgenden Werte aus dieser evolvierbaren Aufzählung zu erhalten: riskAccepted , thirdParty , planned , alternateMitigation , needsMoreAction. Standardmäßig wird der Status einer Empfehlung auf active den Zeitpunkt festgelegt, zu dem die Empfehlung zum ersten Mal generiert wird. Der Status wird gesetzt completedBySystem , wenn unser Dienst erkennt, dass eine Ressource, die einst aktiv war, nicht mehr anwendbar ist.
subjectId Zeichenfolge Der zugehörige eindeutige Bezeichner, abhängig vom resourceType. Diese Eigenschaft wird beispielsweise auf festgelegtapplicationId, wenn der resourceType ein .application

Beziehungen

Beziehung Typ Beschreibung
tags recommendationTag-Sammlung Die benutzerdefinierten Freiformbezeichnungen, die auf die impactedResource angewendet werden. Die Sammlung ist nicht direkt beschreibbar; Tags werden über die Aktionen addTag und removeTag erstellt und entfernt.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@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)"
}