Pipelines - Update Pipeline User

Dienst:

Power BI REST APIs

API-Version:

v1.0

Gewährt Benutzerberechtigungen für die angegebene Bereitstellungspipeline.

Erforderlicher Bereich

Pipeline.ReadWrite.All

POST 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

Anforderungstext

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

Antworten

Name	Typ	Beschreibung
200 OK		OK

Beispiele

Add a group to a deployment pipeline example

Add a service principal to a deployment pipeline example

Add a user to a deployment pipeline example

Add a group to a deployment pipeline example

Beispielanforderung

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

Anforderungstext

{
  "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
  "accessRight": "Admin",
  "principalType": "Group"
}

Beispiel für eine Antwort

Statuscode:

200

Add a service principal to a deployment pipeline example

Beispielanforderung

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

Anforderungstext

{
  "identifier": "a35d842b-90d5-59a1-c56a-5f8fcff0bf9d",
  "accessRight": "Admin",
  "principalType": "App"
}

Beispiel für eine Antwort

Statuscode:

200

Add a user to a deployment pipeline example

Beispielanforderung

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

Anforderungstext

{
  "identifier": "john@contoso.com",
  "accessRight": "Admin",
  "principalType": "User"
}

Beispiel für eine Antwort

Statuscode:

200

Definitionen

Name	Beschreibung
PipelineUser	Ein Power BI-Benutzerzugriff auf den rechten Eintrag für eine Bereitstellungspipeline
PipelineUserAccessRight	Erforderlich. Das Zugriffsrecht, das ein Benutzer für die Bereitstellungspipeline hat.
PrincipalType	Der Prinzipaltyp

PipelineUser

Object

Ein Power BI-Benutzerzugriff auf den rechten Eintrag 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. Andernfalls stellen Sie 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

PrincipalType

Enumeration

Der Prinzipaltyp

Wert	Beschreibung
App	Dienstprinzipaltyp
Group	Gruppenprinzipaltyp
None	Kein Prinzipaltyp. Verwenden Sie den Gesamten Zugriff auf Organisationsebene.
User	Benutzerprinzipaltyp