Sdílet prostřednictvím


Pipelines - Get Pipeline Users

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

{
  "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