Compartilhar via


Admin - WorkspaceInfo GetScanStatus

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

Permissões

O usuário deve ser um administrador do Fabric ou autenticar usando uma entidade de serviço.

Ao executar em autenticação de entidade de serviço, um aplicativo não deve ter permissões necessárias de consentimento do administrador para o Power BI definidas 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 é incluída na resposta dos workspaces ou do Admin – WorkspaceInfo PostWorkspaceInfo chamada à API que disparou a verificação.

Respostas

Nome Tipo Description
200 OK

ScanRequest

OKEY

Exemplos

Example

Solicitação de exemplo

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

Resposta de exemplo

{
  "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 (date-time)

A data e a hora de criação da verificação

error

PowerBIApiErrorResponseDetail

O erro de verificação (se houver)

id

string (uuid)

A ID da verificação

status

string

O estado de verificação