Admin - WorkspaceInfo GetScanStatus

Service:

Power BI REST APIs

API Version:

v1.0

Obtém o status da verificação especificada.

Permissões

O usuário deve ter direitos de administrador (como Microsoft Administrador Global do 365 ou Administrador de Serviços do Power BI) ou autenticar usando uma entidade de serviço.

Ao executar em autenticação de entidade de serviço, um aplicativo não deve ter nenhuma permissão de consentimento de administrador necessária para o Power BI definida nele no portal do Azure.

Escopo necessário

Tenant.Read.All ou Tenant.ReadWrite.All

Relevante somente ao autenticar por meio de um token de acesso de administrador delegado padrão. Não deve estar presente quando a autenticação por meio de uma entidade de serviço é usada.

Limitações

Máximo de 10.000 solicitações por hora.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
scanId	path	True	string uuid	A ID de verificação, que está incluída na resposta dos workspaces ou da chamada à API Administração - WorkspaceInfo PostWorkspaceInfo que disparou a verificação.

Respostas

Nome	Tipo	Description
200 OK	ScanRequest	OK

Exemplos

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"
}

Definições

Nome	Description
PowerBIApiErrorResponseDetail	Informações detalhadas sobre uma resposta de erro do Power BI
ScanRequest	Uma solicitação de verificação

PowerBIApiErrorResponseDetail

Informações detalhadas sobre uma resposta de erro do Power BI

Nome	Tipo	Description
code	string	O código de erro
message	string	A mensagem de erro
target	string	O destino do erro

ScanRequest

Uma solicitação de verificação

Nome	Tipo	Description
createdDateTime	string	A data e a hora da criação da verificação
error	PowerBIApiErrorResponseDetail	O erro de verificação (se houver)
id	string	A ID da verificação
status	string	O estado de verificação