Dataflows - Refresh Dataflow

Serviço:: Power BI REST APIs

Versão da API:: 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.

Permissions

Essa chamada à 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

Com parâmetros opcionais:

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	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		OKEY

Exemplos

Example

Solicitação de exemplo

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

Corpo da solicitação

{
  "notifyOption": "MailOnFailure"
}

Resposta de exemplo

Código de status:: 200

Definições

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

NotifyOption

Enumeração

Opções de notificação por email

Valor	Description
NoNotification	Nenhuma notificação será enviada
MailOnFailure	Uma notificação por email será enviada por falha de atualização
MailOnCompletion	Uma notificação de email que indica êxito ou falha será enviada na conclusão da atualização

RefreshRequest

Objeto

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

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

Partilhar via