Hinzufügen von agentIdentityBlueprintPrincipal-Besitzern

Namespace: microsoft.graph

Fügen Sie einen Besitzer für agentIdentityBlueprintPrincipal hinzu. Besitzer des Agent-Identitätsblaupausenprinzipals können Benutzer, der Blaupausenprinzipal der Agent-Identität selbst oder andere Dienstprinzipale sein.

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	Berechtigung mit den geringsten Rechten	Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto)	AgentIdentityBlueprint.ReadWrite.All	Nicht verfügbar
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt	Nicht unterstützt
Application	AgentIdentityBlueprint.ReadWrite.All	Nicht verfügbar

Wichtig

• Ein Prinzipal, der eine Agentidentitätsblaupause oder einen Blaupausenprinzipal erstellt, wird automatisch als Besitzer zugewiesen.
• Besitzer können Agentidentitäten erstellen und ändern, die einer Blaupause zugeordnet sind, die sie besitzen, ohne eine Agent-ID-Rolle zugewiesen zu werden.
• Damit Nichtbesitzer diese API in delegierten Szenarien mit Geschäfts-, Schul- oder Unikonten aufrufen können, muss dem Administrator eine unterstützte Microsoft Entra Rolle zugewiesen werden. Dieser Vorgang unterstützt die folgende integrierte Rolle mit den geringsten Rechten:
  • Agent-ID-Administrator

HTTP-Anforderung

Sie können den Blaupausenprinzipal der Agent-Identität entweder mit seiner ID oder appId adressieren. id und appId werden in App-Registrierungen im Microsoft Entra Admin Center als Objekt-ID bzw. Anwendungs-ID (Client-ID) bezeichnet.

POST /servicePrincipals/{id}/microsoft.graph.agentIdentityBlueprintPrincipal/owners/$ref
POST /servicePrincipals(appId='{appId}')/microsoft.graph.agentIdentityBlueprintPrincipal/owners/$ref

Anforderungsheader

Name	Beschreibung
Authorization	Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type	application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des directoryObject-Objekts an.

Antwort

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

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

HTTP

POST https://graph.microsoft.com/v1.0/servicePrincipals/{id}/microsoft.graph.agentIdentityBlueprintPrincipal/owners/$ref
Content-Type: application/json

{
    "@odata.id": "https://graph.microsoft.com/v1.0/directoryObjects/1511d5e7-c324-4362-ad4b-16c20076e5aa"
}

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const directoryObject = {
    '@odata.id': 'https://graph.microsoft.com/v1.0/directoryObjects/1511d5e7-c324-4362-ad4b-16c20076e5aa'
};

await client.api('/servicePrincipals/{id}/microsoft.graph.agentIdentityBlueprintPrincipal/owners/$ref')
	.post(directoryObject);

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content