Pipelines - Get Pipeline Users

Referencia

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	Aceptar

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 correcta de acceso de usuario de Power BI para una canalización de implementación
PipelineUserAccessRight	Necesario. 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	Tipo de entidad de seguridad

PipelineUser

Object

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

Nombre	Tipo	Description
accessRight	PipelineUserAccessRight	Necesario. 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	Tipo de entidad de seguridad

PipelineUserAccessRight

Enumeration

Necesario. 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