Admin - WorkspaceInfo GetScanStatus

Service:

Power BI REST APIs

API Version:

v1.0

Obtiene el estado del examen para el examen especificado.

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 en la autenticación de la entidad de servicio, una aplicación no debe tener ningún permiso necesario de 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 10 000 solicitudes por hora.

GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/scanStatus/{scanId}

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
scanId	path	True	string uuid	Identificador de examen, que se incluye en la respuesta de las áreas de trabajo o la llamada API Administración - WorkspaceInfo PostWorkspaceInfo que desencadenó el examen.

Respuestas

Nombre	Tipo	Description
200 OK	ScanRequest	Aceptar

Ejemplos

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/scanStatus/e7d03602-4873-4760-b37e-1563ef5358e3

Sample Response

Status code:

200

{
  "id": "e7d03602-4873-4760-b37e-1563ef5358e3",
  "createdDateTime": "2020-06-15T16:46:28.0487687Z",
  "status": "Succeeded"
}

Definiciones

Nombre	Description
PowerBIApiErrorResponseDetail	Información detallada sobre una respuesta de error de Power BI
ScanRequest	Una solicitud de examen

PowerBIApiErrorResponseDetail

Información detallada sobre una respuesta de error de Power BI

Nombre	Tipo	Description
code	string	Código de error.
message	string	El mensaje de error.
target	string	Destino del error

ScanRequest

Una solicitud de examen

Nombre	Tipo	Description
createdDateTime	string	Fecha y hora de creación del examen
error	PowerBIApiErrorResponseDetail	Error de examen (si existe)
id	string	El identificador de examen
status	string	El estado del examen