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
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
exclude
|
query |
boolean |
Si se van a excluir áreas de trabajo inactivas |
|
exclude
|
query |
boolean |
Si se van a excluir áreas de trabajo personales |
|
modified
|
query |
string date-time |
Fecha de última modificación (debe estar en formato UTC compatible con ISO 8601) |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Aceptar |
Ejemplos
Example
Solicitud de ejemplo
GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/modified?modifiedSince=2020-10-02T05:51:30.0000000Z&excludePersonalWorkspaces=True&excludeInActiveWorkspaces=True
Respuesta de muestra
[
{
"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 |