Compartilhar via


Admin - WorkspaceInfo GetScanStatus

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

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