Admin - Pipelines UpdateUserAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

Gewährt Benutzerberechtigungen für eine angegebene Bereitstellungspipeline.

Berechtigungen

Der Benutzer muss über Administratorrechte verfügen.

Erforderlicher Bereich

Tenant.ReadWrite.All

Einschränkungen

Maximal 200 Anforderungen pro Stunde.

POST 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

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

Sample Request

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

Request Body

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

Sample Response

Status code:

200

Add a service principal to a deployment pipeline example

Sample Request

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

Request Body

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

Sample Response

Status code:

200

Add a user to a deployment pipeline example

Sample Request

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

Request Body

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

Sample Response

Status code:

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

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

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

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

PrincipalType

Der Prinzipaltyp

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