agentIdentity: attest

Namespace: microsoft.graph.identityGovernance

Bestätigen Sie eine agentIdentity, um zu bestätigen, dass sie weiterhin die Anforderungen der geltenden LifecyclePolicy erfüllt. Der Nachweis aktualisiert den Lebenszyklusstatus der Identität und kann nachweisbezogene Complianceprobleme beseitigen.

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) AgentIdentity.ReadWrite.All Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Application AgentIdentity.ReadWrite.All Nicht verfügbar.

Wichtig

Für den delegierten Zugriff reicht der AgentIdentity.ReadWrite.All Umfang allein nicht aus. Dem angemeldeten Benutzer muss außerdem eine unterstützte Microsoft Entra-Rolle zugewiesen werden, er muss ein direkter Besitzer des Agenten oder ein direkter Sponsor des Agenten sein. Der Agentidentitätsadministrator ist die Rolle mit den geringsten Berechtigungen, die für den Administratorpfad unterstützt wird. Eigentum und Sponsoring sind separate Autorisierungspfade, für die diese Rolle nicht erforderlich ist.

Für den Anwendungszugriff gewährt die AgentIdentity.ReadWrite.All Anwendungsberechtigung den Zugriff ohne zusätzliche Besitz-, Sponsoring- oder Administratorrollenüberprüfung. Diese Regeln gelten für den Agent-Nachweis entweder über die Dienstprinzipalroute oder die Agentidentitätsübertragungsroute.

HTTP-Anforderung

POST /servicePrincipals/{servicePrincipalsId}/microsoft.graph.agentIdentity/microsoft.graph.identityGovernance.attest

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.

Anforderungstext

Geben Sie keinen Anforderungstext für diese Methode an.

Antwort

Wenn die Aktion erfolgreich verläuft, wird der Antwortcode 204 No Content zurückgegeben.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/v1.0/servicePrincipals/55bc54bb-f5ef-431b-9e8f-6ee6320191fe/microsoft.graph.agentIdentity/microsoft.graph.identityGovernance.attest

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content