governanceResource: registrierengovernanceResource: register

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Registrieren eines governanceResource -Objekts in einer privilegierten Identitätsverwaltung.Register a governanceResource object in Privileged Identity Management.

BerechtigungenPermissions

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.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Hinweis: Diese API erfordert auch, dass die anfordernde Person über mindestens eine aktive Rollenzuweisung für die Ressource verfügt.Note: This API also requires that the requester have at least one active role assignment on the resource.

BerechtigungstypPermission type BerechtigungenPermissions
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) PrivilegedAccess. ReadWrite. AzureResourcesPrivilegedAccess.ReadWrite.AzureResources
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported.
AnwendungApplication Nicht unterstütztNot supported.

HTTP-AnforderungHTTP request

POST /privilegedAccess/azureResources/resources/register

Optionale AbfrageparameterOptional query parameters

Diese Methode **** unterstützt nur $select die $expand und OData-Abfrageparameter zur Unterstützung der Anpassung der Antwort.This method only supports the $select and $expand OData query parameters to help customize the response.

AnforderungsheaderRequest headers

NameName BeschreibungDescription
AuthorizationAuthorization Bearer {token}Bearer {token}
Content-typeContent-type application/jsonapplication/json

AnforderungstextRequest body

EigenschaftenProperties TypType BeschreibungDescription
externalIdexternalId StringString Der externe Bezeichner der Ressource, die in PIM registriert werden soll.The external identifier of the resource to be registered in PIM. Wenn Sie ein Abonnement registrieren, ist der Bezeichner die Abonnement-ID, /subscriptions/der durch vorangestellt wurde.If registering a subscription, the identifier is the subscription identifier prepended by /subscriptions/. Beispiel: /subscriptions/c14ae696-5e0c-4e5d-88cc-bef6637737ac.For example, /subscriptions/c14ae696-5e0c-4e5d-88cc-bef6637737ac.

AntwortResponse

Wenn die Methode erfolgreich verläuft, 200 OK wird eine Antwort zurückgegeben.If successful, this method returns a 200 OK response.

BeispielExample

Das folgende Beispiel illustriert, wie Sie diese API aufrufen können.The following example shows how to call this API.

AnforderungRequest

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

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

AntwortResponse

HTTP/1.1 200 OK