Admin - Pipelines GetPipelineUsersAsAdmin

Referencia

Service:: Power BI REST APIs

API Version:: v1.0

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

Permisos

El usuario debe tener derechos de administrador o autenticarse mediante una entidad de servicio.

Ámbito requerido

Tenant.Read.All o Tenant.ReadWrite.All

Limitaciones

Máximo de 200 solicitudes por hora.

GET https://api.powerbi.com/v1.0/myorg/admin/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

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/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"
    }
  ]
}

Definiciones

Nombre	Description
PipelineUser	Una entrada adecuada 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	El tipo de entidad de seguridad

PipelineUser

Una entrada adecuada 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	El tipo de entidad de seguridad

PipelineUserAccessRight

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

Nombre	Tipo	Description
Admin	string	Concede derechos de administrador a una 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

Nombre	Tipo	Description
odata.context	string	Contexto de OData
value	PipelineUser[]	Colección de usuarios de canalización de implementación

PrincipalType

El tipo de entidad de seguridad

Nombre	Tipo	Description
App	string	Tipo de entidad de servicio
Group	string	Tipo de entidad de seguridad de grupo
None	string	No hay ningún tipo de entidad de seguridad. Se usa para el acceso de nivel de organización completo.
User	string	Tipo de entidad de seguridad de usuario

Compartir a través de