Pipelines - Get Pipeline Users

Servicio:: Power BI REST APIs

Versión de la API:: v1.0

Devuelve una lista de usuarios que tienen acceso a la canalización de implementación especificada.

Ámbito requerido

Pipeline.ReadWrite.All o Pipeline.Read.All

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
pipelineId	path	True	string (uuid)	Identificador de canalización de implementación

Respuestas

Nombre	Tipo	Description
200 OK	PipelineUsers	OK

Ejemplos

Get users of a deployment pipeline example

Solicitud de ejemplo

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

Respuesta de muestra

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

Definiciones

Nombre	Description
PipelineUser	Una entrada adecuada de acceso de usuario de Power BI para una canalización de implementación
PipelineUserAccessRight	Obligatorio. El derecho de acceso que tiene un usuario para la canalización de implementación.
PipelineUsers	Contenedor de respuesta de OData para una colección de usuarios de canalización de implementación de Power BI
PrincipalType	El tipo de entidad de seguridad

PipelineUser

Object

Una entrada adecuada de acceso de usuario de Power BI para una canalización de implementación

Nombre	Tipo	Description
accessRight	PipelineUserAccessRight	Obligatorio. El derecho de acceso que tiene un usuario para la canalización de implementación.
identifier	string	Para el tipo `User`de entidad de seguridad , proporcione el UPN. De lo contrario, proporcione el identificador de objeto de la entidad de seguridad.
principalType	PrincipalType	El tipo de entidad de seguridad

PipelineUserAccessRight

Enumeración

Obligatorio. El derecho de acceso que tiene un usuario para la canalización de implementación.

Valor	Description
Admin	Concede derechos de administrador a una canalización de implementación

PipelineUsers