Freigeben über


Pipelines - Get Pipeline Users

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

Erforderlicher Bereich

Pipeline.ReadWrite.All oder Pipeline.Read.All

GET https://api.powerbi.com/v1.0/myorg/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/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users

Beispiel für eine Antwort

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

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 Userden UPN an. Stellen Sie andernfalls die Objekt-ID des Prinzipals bereit.

principalType

PrincipalType

Der Prinzipaltyp

PipelineUserAccessRight

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

Wert Beschreibung
Admin

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

Wert Beschreibung
None

Kein Prinzipaltyp. Wird für den Zugriff auf ganze Organisationsebene verwendet.

User

Benutzerprinzipaltyp

Group

Gruppenprinzipaltyp

App

Dienstprinzipaltyp