Dataflows - Refresh Dataflow

Service:

Power BI REST APIs

API Version:

v1.0

Dispara uma atualização para o fluxo de dados especificado.

As opções de notificação por email com suporte são MailOnFailure e NoNotification. Não há suporte para MailOnCompletion.

Permissões

Essa chamada de API pode ser chamada por um perfil de entidade de serviço. Para obter mais informações, consulte: Perfis de entidade de serviço no Power BI Embedded.

Escopo necessário

Dataflow.ReadWrite.All

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/dataflows/{dataflowId}/refreshes

With optional parameters:

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/dataflows/{dataflowId}/refreshes?processType={processType}

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
dataflowId	path	True	string uuid	A ID do fluxo de dados
groupId	path	True	string uuid	A ID do workspace
processType	query		string uuid	Tipo de processo de atualização a ser usado.

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
notifyOption	True	NotifyOption	Opções de notificação por email

Respostas

Nome	Tipo	Description
200 OK		OK

Exemplos

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/51e47fc5-48fd-4826-89f0-021bd3a80abd/dataflows/928228ba-008d-4fd9-864a-92d2752ee5ce/refreshes?processType=default

Request Body

{
  "notifyOption": "MailOnFailure"
}

Sample Response

Status code:

200

Definições

Nome	Description
NotifyOption	Opções de notificação por email
RefreshRequest	Solicitação de atualização do Power BI

NotifyOption

Opções de notificação por email

Nome	Tipo	Description
MailOnCompletion	string	Uma notificação por email indicando êxito ou falha será enviada na conclusão da atualização
MailOnFailure	string	Uma notificação por email será enviada em caso de falha de atualização
NoNotification	string	Nenhuma notificação será enviada

RefreshRequest

Solicitação de atualização do Power BI

Nome	Tipo	Description
notifyOption	NotifyOption	Opções de notificação por email