Admin - WorkspaceInfo GetModifiedWorkspaces

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
GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/modified?modifiedSince={modifiedSince}&excludePersonalWorkspaces={excludePersonalWorkspaces}&excludeInActiveWorkspaces={excludeInActiveWorkspaces}

Parámetros de identificador URI

Name In Required Type 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

Name Type Description
200 OK

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

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

Definiciones

ModifiedWorkspace

Un área de trabajo modificada

Name Type Description
Id
  • string

El identificador de objeto del área de trabajo