Pipelines - Get Pipeline Users

Service:

Power BI REST APIs

API Version:

v1.0

Restituisce un elenco di utenti che hanno accesso alla pipeline di distribuzione specificata.

Ambito obbligatorio

Pipeline.ReadWrite.All o Pipeline.Read.All

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

Parametri dell'URI

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

Risposte

Nome	Tipo	Descrizione
200 OK	PipelineUsers	OK

Esempio

Get users of a deployment pipeline example

Sample Request

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

Sample Response

Status code:

200

{
  "value": [
    {
      "identifier": "john@contoso.com",
      "accessRight": "Admin",
      "principalType": "User"
    },
    {
      "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
      "accessRight": "Admin",
      "principalType": "Group"
    },
    {
      "identifier": "a35d842b-90d5-59a1-c56a-5f8fcff0bf9d",
      "accessRight": "Admin",
      "principalType": "App"
    }
  ]
}

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.
PipelineUsers	Wrapper di risposta OData per una raccolta di utenti della pipeline di distribuzione di Power BI
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

PipelineUsers

Wrapper di risposta OData per una raccolta di utenti della pipeline di distribuzione di Power BI

Nome	Tipo	Descrizione
odata.context	string	Contesto OData
value	PipelineUser[]	Raccolta di utenti della 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