Admin - Pipelines GetPipelineUsersAsAdmin

Dienst:: Power BI REST APIs

API-Version:: v1.0

Gibt eine Liste von Benutzern zurück, die Zugriff auf eine angegebene Bereitstellungspipeline haben.

Erlaubnisse

Der Benutzer muss über Administratorrechte verfügen oder sich mit einem Dienstprinzipal authentifizieren.

Erforderlicher Bereich

Tenant.Read.All oder Tenant.ReadWrite.All

Einschränkungen

Maximal 200 Anforderungen pro Stunde.

GET https://api.powerbi.com/v1.0/myorg/admin/pipelines/{pipelineId}/users

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
pipelineId	path	True	string (uuid)	Die Bereitstellungspipeline-ID

Antworten

Name	Typ	Beschreibung
200 OK	PipelineUsers	OKAY

Beispiele

Get users of a deployment pipeline example

Beispielanforderung

GET https://api.powerbi.com/v1.0/myorg/admin/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users

Beispiel für eine Antwort

Statuscode:: 200

{
  "value": [
    {
      "identifier": "john@contoso.com",
      "accessRight": "Admin",
      "principalType": "User"
    },
    {
      "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
      "accessRight": "Admin",
      "principalType": "Group"
    },
    {
      "identifier": "a35d842b-90d5-59a1-c56a-5f8fcff0bf9d",
      "accessRight": "Admin",
      "principalType": "App"
    }
  ]
}

Definitionen

Name	Beschreibung
PipelineUser	Ein Power BI-Benutzerzugriffsrecht für eine Bereitstellungspipeline
PipelineUserAccessRight	Erforderlich. Das Zugriffsrecht, das ein Benutzer für die Bereitstellungspipeline hat.
PipelineUsers	OData-Antwortwrapper für eine Sammlung von Power BI-Bereitstellungspipelinebenutzern
PrincipalType	Der Prinzipaltyp

PipelineUser

Objekt

Ein Power BI-Benutzerzugriffsrecht für eine Bereitstellungspipeline

Name	Typ	Beschreibung
accessRight	PipelineUserAccessRight	Erforderlich. Das Zugriffsrecht, das ein Benutzer für die Bereitstellungspipeline hat.
identifier	string	Geben Sie für den Prinzipaltyp `User`den UPN an. Stellen Sie andernfalls die Objekt-ID des Prinzipals bereit.
principalType	PrincipalType	Der Prinzipaltyp

PipelineUserAccessRight

Enumeration

Erforderlich. Das Zugriffsrecht, das ein Benutzer für die Bereitstellungspipeline hat.

Wert	Beschreibung
Admin	Gewährt Administratorrechten für eine Bereitstellungspipeline

PipelineUsers