Condividi tramite

Admin - Pipelines UpdateUserAsAdmin

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