Freigeben über

Admin - Pipelines UpdateUserAsAdmin

Dienst:
Power BI REST APIs
API-Version:
v1.0

Gewährt Benutzerberechtigungen für eine angegebene Bereitstellungspipeline.

Erlaubnisse

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. Stellen Sie andernfalls 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

OKAY

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/admin/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/admin/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/admin/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-Benutzerzugriffsrecht für eine Bereitstellungspipeline
PipelineUserAccessRight

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

Der Prinzipaltyp

PipelineUser

Objekt

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

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
None

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

Benutzerprinzipaltyp
Group

Gruppenprinzipaltyp
App

Dienstprinzipaltyp