governanceResource-Ressourcentyp

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.

Stellt Ressourcen dar, die von Privileged Identity Management (PIM) verwaltet werden können. Bei Azure-Ressourcen kann es sich um ein Abonnement, eine Ressourcengruppe und eine Ressource wie einen virtuellen Computer, eine SQL-Datenbank usw. handeln.

Methoden

Methode Rückgabetyp Beschreibung
List governanceResource-Sammlung Listet eine Sammlung von Ressourcen auf, auf die der Anforderer Zugriff hat.
Get governanceResource Liest die Eigenschaften und Beziehungen einer Ressourcenentität, die durch die ID angegeben wird.
Registrieren Registrieren Sie ein nicht verwaltetes Azure-Abonnement oder eine Verwaltungsgruppe beim PIM-Dienst.

Nein POST, PUT, , PATCHwerden DELETE für entitätssatz vorerst unterstützt roleDefinitions .

Eigenschaften

Eigenschaft Typ Beschreibung
id Zeichenfolge Die ID der Ressource. Es ist im GUID-Format.
externalId String Die externe ID der Ressource, die ihre ursprüngliche ID im externen System darstellt. Die externe ID einer Abonnementressource kann beispielsweise "/subscriptions/c14ae696-5e0c-4e5d-88cc-bef6637737ac" sein.
type Zeichenfolge Erforderlich. Ressourcentyp. Für Azure-Ressourcen könnte der Typ beispielsweise "Subscription", "ResourceGroup", "Microsoft.Sql/server" usw. sein.
displayName Zeichenfolge Der Anzeigename der Ressource.
status Zeichenfolge Der Status einer bestimmten Ressource. Sie könnte beispielsweise darstellen, ob die Ressource gesperrt ist oder nicht (Werte: Active/Locked). Hinweis: Diese Eigenschaft kann in Zukunft erweitert werden, um weitere Szenarien zu unterstützen.
registeredDateTime DateTimeOffset Stellt die Datumszeit dar, zu der die Ressource in PIM registriert ist.
registeredRoot Zeichenfolge Die externalId des Stammbereichs der Ressource, die in PIM registriert ist. Der Stammbereich kann die Übergeordneten, Großeltern oder übergeordneten Ressourcen sein.
roleAssignmentCount Int32 Optional. Die Anzahl der Rollenzuweisungen für die angegebene Ressource. Um die Eigenschaft abzurufen, verwenden $select=roleAssignmentCount Sie die Abfrage bitte explizit.
roleDefinitionCount Int32 Optional. Die Anzahl der Rollendefinitionen für die angegebene Ressource. Um die Eigenschaft abzurufen, verwenden $select=roleDefinitionCount Sie die Abfrage bitte explizit.
Berechtigungen governancePermission Optional. Es stellt den Status des Zugriffs des Anforderers auf die Ressource dar. Um die Eigenschaft abzurufen, verwenden $select=permissions Sie die Abfrage bitte explizit.

Beziehungen

Beziehung Typ Beschreibung
roleAssignments governanceRoleAssignment-Sammlung Die Sammlung von Rollenzuweisungen für die Ressource.
roleDefinitions governanceRoleDefinition-Sammlung Die Auflistung der Rollendefinitionen für die Ressource.
roleAssignmentRequests governanceRoleAssignmentRequest-Sammlung Die Sammlung von Rollenzuweisungsanforderungen für die Ressource.
roleSettings governanceRoleSetting-Sammlung Die Sammlung der Rolleneinstellungen für die Ressource.
übergeordnetes Element governanceResource Schreibgeschützt. Die übergeordnete Ressource. Für pimforazurerbac Szenario kann es das Abonnement darstellen, zu dem die Ressource gehört.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "id": "String (identifier)",
  "externalId": "String",
  "type": "String",
  "displayName": "String",
  "status": "String",
  "registeredDateTime": "String (timestamp)",
  "registeredRoot": "String",
  "roleAssignmentCount": 12356,
  "roleDefinitionCount": 12356,
  "permissions": {
    "@odata.type": "microsoft.graph.governancePermission"
  }
}