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

Ukázkový požadavek

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

Ukázková odpověď

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

Správná položka přístupu uživatele Power BI pro kanál nasazení

PipelineUserAccessRight

Povinné. Přístupové právo, 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

Správná položka přístupu uživatele Power BI pro kanál nasazení

Name Typ Description
accessRight

PipelineUserAccessRight

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

identifier

string

Jako typ Userobjektu zabezpečení zadejte hlavní název uživatele (UPN). V opačném případě zadejte ID objektu objektu.

principalType

PrincipalType

Typ objektu zabezpečení

PipelineUserAccessRight

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

Hodnota Description
Admin

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í

Hodnota Description
None

Žádný typ objektu zabezpečení. Používá se pro přístup na úrovni celé organizace.

User

Typ objektu zabezpečení uživatele

Group

Typ objektu zabezpečení skupiny

App

Typ instančního objektu