Pipelines - Get Pipeline Users

Service:

Power BI REST APIs

API Version:

v1.0

Vrátí seznam uživatelů, kteří mají přístup k zadanému kanálu nasazení.

Požadovaný obor

Pipeline.ReadWrite.All nebo Pipeline.Read.All

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
pipelineId	path	True	string uuid	ID kanálu nasazení

Odpovědi

Name	Typ	Description
200 OK	PipelineUsers	OK

Příklady

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"
    }
  ]
}

Definice

Name	Description
PipelineUser	Přístup uživatele Power BI ke správné položce kanálu nasazení
PipelineUserAccessRight	Povinná hodnota. Přístupová práva, které má uživatel pro kanál nasazení.
PipelineUsers	Obálka odpovědí OData pro kolekci uživatelů kanálu nasazení Power BI
PrincipalType	Typ objektu zabezpečení

PipelineUser

Přístup uživatele Power BI ke správné položce kanálu nasazení

Name	Typ	Description
accessRight	PipelineUserAccessRight	Povinná hodnota. Přístupová práva, které má uživatel pro kanál nasazení.
identifier	string	Pro typ Userobjektu zabezpečení zadejte hlavní název uživatele (UPN). V opačném případě zadejte ID objektu objektu objektu instančního objektu.
principalType	PrincipalType	Typ objektu zabezpečení

PipelineUserAccessRight

Povinná hodnota. Přístupová práva, které má uživatel pro kanál nasazení.

Name	Typ	Description
Admin	string	Uděluje oprávnění správce kanálu nasazení.

PipelineUsers

Obálka odpovědí OData pro kolekci uživatelů kanálu nasazení Power BI

Name	Typ	Description
odata.context	string	Kontext OData
value	PipelineUser[]	Kolekce uživatelů kanálu nasazení

PrincipalType

Typ objektu zabezpečení

Name	Typ	Description
App	string	Typ instančního objektu
Group	string	Typ objektu zabezpečení skupiny
None	string	Žádný typ objektu zabezpečení. Používá se pro přístup na úrovni celé organizace.
User	string	Typ objektu zabezpečení uživatele