Freigeben über

Admin - Pipelines UpdateUserAsAdmin

  • Referenz
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