Admin - WorkspaceInfo GetModifiedWorkspaces

  • Referencia
Service:
Power BI REST APIs
API Version:
v1.0

Obtiene una lista de identificadores de área de trabajo de la organización.

Si el parámetro opcional modifiedSince se establece en una fecha y hora, solo se devuelven los identificadores de las áreas de trabajo que cambiaron después de esa fecha y hora. Si no se usa el modifiedSince parámetro , se devuelven los identificadores de todas las áreas de trabajo de la organización. La fecha y hora especificada por el modifiedSince parámetro debe estar en el intervalo de 30 minutos (para permitir que los cambios del área de trabajo surtan efecto) a 30 días antes de la hora actual.

Permisos

El usuario debe tener derechos de administrador (como Microsoft administrador global de 365 o administrador del servicio Power BI) o autenticarse mediante una entidad de servicio.

Cuando se ejecuta con la autenticación de entidad de servicio, una aplicación no debe tener permisos necesarios para el consentimiento del administrador para Power BI establecido en él en el Azure Portal.

Ámbito requerido

Tenant.Read.All o Tenant.ReadWrite.All

Solo es relevante al autenticarse a través de un token de acceso de administrador delegado estándar. No debe estar presente cuando se usa la autenticación a través de una entidad de servicio.

Limitaciones

Máximo de 30 solicitudes por hora. 

GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/modified
With optional parameters: 
GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/modified?modifiedSince={modifiedSince}&excludePersonalWorkspaces={excludePersonalWorkspaces}&excludeInActiveWorkspaces={excludeInActiveWorkspaces}

Parámetros de identificador URI

Nombre En Requerido Tipo Description
excludeInActiveWorkspaces
 query

boolean

Si se van a excluir áreas de trabajo inactivas
excludePersonalWorkspaces
 query

boolean

Si se van a excluir áreas de trabajo personales
modifiedSince
 query

string

date-time

Fecha de última modificación (debe estar en formato UTC compatible con ISO 8601)

Respuestas

Nombre Tipo Description
200 OK

ModifiedWorkspace[]

Aceptar

Ejemplos

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/modified?modifiedSince=2020-10-02T05:51:30.0000000Z&excludePersonalWorkspaces=True&excludeInActiveWorkspaces=True

Sample Response

Status code:
200 
[
  {
    "Id": "3740504d-1f93-42f9-8e9d-c8ba9b787a3b"
  },
  {
    "Id": "19cb346c-9839-4e19-81e6-76364d0b836f"
  }
]

Definiciones

ModifiedWorkspace

Un área de trabajo modificada

Nombre Tipo Description
Id

string

El identificador de objeto del área de trabajo