Admin - Pipelines GetPipelineUsersAsAdmin

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

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