governanceResource: registrieren

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Achtung

Diese Version der Privileged Identity Management-API (PIM-API) für Azure-Ressourcen wird in Kürze eingestellt. Verwenden Sie die neue Azure REST PIM-API für Azure-Ressourcenrollen.

Registrieren Sie ein governanceResource-Objekt in Privileged Identity Management.

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.

Hinweis: Diese API erfordert außerdem, dass der Antragsteller mindestens eine aktive Rollenzuweisung für die Ressource hat.

Azure-Ressourcen

Berechtigungstyp	Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto)	PrivilegedAccess.ReadWrite.AzureResources
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	Nicht unterstützt

Azure AD

Berechtigungstyp	Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto)	PrivilegedAccess.ReadWrite.AzureAD
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	Nicht unterstützt

Gruppen

Berechtigungstyp	Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto)	PrivilegedAccess.ReadWrite.AzureADGroup
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	Nicht unterstützt

HTTP-Anforderung

POST /privilegedAccess/azureResources/resources/register

Optionale Abfrageparameter

Diese Methode unterstützt nur die $select $expand OData-Abfrageparameter , um die Antwort anzupassen.

Anforderungsheader

Name	Beschreibung
Authorization	Bearer {token}
Content-type	application/json

Anforderungstext

Eigenschaften	Typ	Beschreibung
externalId	String	Der externe Bezeichner der Ressource, die in PIM registriert werden soll. Wenn Sie ein Abonnement registrieren, ist der Bezeichner der Abonnementbezeichner, der von vorangestellt ist /subscriptions/. Beispiel: /subscriptions/c14ae696-5e0c-4e5d-88cc-bef6637737ac.

Antwort

Bei erfolgreicher Ausführung gibt die Methode eine 200 OK Antwort zurück.

Beispiel

Das folgende Beispiel illustriert, wie Sie diese API aufrufen können.

Anforderung

POST https://graph.microsoft.com/beta/privilegedAccess/azureResources/resources/register
Content-type: application/json

{
  "externalId": "/subscriptions/c14ae696-5e0c-4e5d-88cc-bef6637737ac"
}

Antwort

HTTP/1.1 200 OK