Admin - Pipelines GetPipelineUsersAsAdmin

Referenz

Service:: Power BI REST APIs

API Version:: v1.0

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

Berechtigungen

Der Benutzer muss über Administratorrechte verfügen oder sich mithilfe eines Dienstprinzipals 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	OK

Beispiele

Get users of a deployment pipeline example

Sample Request

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

Sample Response

Status code:: 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-Benutzer greift auf den richtigen Eintrag für eine Bereitstellungspipeline zu
PipelineUserAccessRight	Erforderlich. Der Zugriffsrecht, über das ein Benutzer für die Bereitstellungspipeline verfügt.
PipelineUsers	OData-Antwortwrapper für eine Sammlung von Power BI-Bereitstellungspipelinebenutzern
PrincipalType	Der Prinzipaltyp

PipelineUser

Ein Power BI-Benutzer greift auf den richtigen Eintrag für eine Bereitstellungspipeline zu

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

PipelineUserAccessRight

Erforderlich. Der Zugriffsrecht, über das ein Benutzer für die Bereitstellungspipeline verfügt.

Name	Typ	Beschreibung
Admin	string	Gewährt Administratorrechten für eine Bereitstellungspipeline

PipelineUsers

OData-Antwortwrapper für eine Sammlung von Power BI-Bereitstellungspipelinebenutzern

Name	Typ	Beschreibung
odata.context	string	OData-Kontext
value	PipelineUser[]	Die Sammlung von Bereitstellungspipelinebenutzern

PrincipalType

Der Prinzipaltyp

Name	Typ	Beschreibung
App	string	Dienstprinzipaltyp
Group	string	Gruppenprinzipaltyp
None	string	Kein Prinzipaltyp. Wird für den gesamten Zugriff auf Organisationsebene verwendet.
User	string	Benutzerprinzipaltyp

Freigeben über