governanceResource-Ressourcentyp

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

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 Privileged Identity Management (PIM)-Ressourcen dar. Bei Azure-Ressourcen kann es sich um ein Abonnement, eine Ressourcengruppe und eine Ressource wie einen virtuellen Computer usw. handeln.

Methoden

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

Für Entitätensätze werden derzeit keine POST, , PATCHund DELETE unterstütztroleDefinitions. PUT

Eigenschaften

Eigenschaft Typ Beschreibung
id String Die ID der Ressource. Es liegt im GUID-Format vor.
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 String Erforderlich. Ressourcentyp. Für Azure-Ressourcen kann der Typ z. B. "Subscription", "ResourceGroup", "Microsoft.Sql/server" usw. sein.
displayName String Der Anzeigename der Ressource.
status String Die status einer bestimmten Ressource. Sie könnte z. B. angeben, 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 das Datum dar, zu dem die Ressource in PIM registriert wird.
registeredRoot String Die externalId des Stammbereichs der Ressource, der in PIM registriert ist. Der Stammbereich kann die übergeordneten, übergeordneten oder übergeordneten Ressourcen sein.
roleAssignmentCount Int32 Optional. Die Anzahl der Rollenzuweisungen für die angegebene Ressource. Verwenden Sie $select=roleAssignmentCount explizit in der Abfrage, um die -Eigenschaft abzurufen.
roleDefinitionCount Int32 Optional. Die Anzahl der Rollendefinitionen für die angegebene Ressource. Verwenden Sie $select=roleDefinitionCount explizit in der Abfrage, um die -Eigenschaft abzurufen.
Berechtigungen governancePermission Optional. Sie stellt die status des Zugriffs des Anforderers auf die Ressource dar. Verwenden Sie $select=permissions explizit in der Abfrage, um die -Eigenschaft abzurufen.

Beziehungen

Beziehung Typ Beschreibung
roleAssignments governanceRoleAssignment-Sammlung Die Auflistung der 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 Auflistung der Rolleneinstellungen für die Ressource.
übergeordnetes Element governanceResource Schreibgeschützt. Die übergeordnete Ressource. Für pimforazurerbac das Szenario kann sie das Abonnement darstellen, zu dem die Ressource gehört.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

{
  "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"
  }
}