Admin - Pipelines UpdateUserAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

Concede le autorizzazioni utente a una pipeline di distribuzione specificata.

Autorizzazioni

L'utente deve disporre dei diritti di amministratore.

Ambito obbligatorio

Tenant.ReadWrite.All

Limitazioni

Numero massimo di 200 richieste all'ora.

POST https://api.powerbi.com/v1.0/myorg/admin/pipelines/{pipelineId}/users

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
pipelineId	path	True	string uuid	ID della pipeline di distribuzione

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
identifier	True	string	Per il tipo di Userentità specificare l'UPN. In caso contrario, specificare l'ID oggetto dell'entità.
principalType	True	PrincipalType	Tipo di entità
accessRight		PipelineUserAccessRight	Obbligatorio. Il diritto di accesso di un utente per la pipeline di distribuzione.

Risposte

Nome	Tipo	Descrizione
200 OK		OK

Esempio

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

Definizioni

Nome	Descrizione
PipelineUser	Immissione del diritto di accesso utente di Power BI per una pipeline di distribuzione
PipelineUserAccessRight	Obbligatorio. Il diritto di accesso di un utente per la pipeline di distribuzione.
PrincipalType	Tipo di entità

PipelineUser

Immissione del diritto di accesso utente di Power BI per una pipeline di distribuzione

Nome	Tipo	Descrizione
accessRight	PipelineUserAccessRight	Obbligatorio. Il diritto di accesso di un utente per la pipeline di distribuzione.
identifier	string	Per il tipo di Userentità specificare l'UPN. In caso contrario, specificare l'ID oggetto dell'entità.
principalType	PrincipalType	Tipo di entità

PipelineUserAccessRight

Obbligatorio. Il diritto di accesso di un utente per la pipeline di distribuzione.

Nome	Tipo	Descrizione
Admin	string	Concede diritti di amministratore a una pipeline di distribuzione

PrincipalType

Tipo di entità

Nome	Tipo	Descrizione
App	string	Tipo di entità servizio
Group	string	Tipo di entità gruppo
None	string	Nessun tipo di entità. Usare per l'accesso a livello di intera organizzazione.
User	string	Tipo di entità utente