Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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)"
}