Dataflows - Update Refresh Schedule

Service:

Power BI REST APIs

API Version:

v1.0

Crea o actualiza la programación de actualización de un flujo de datos especificado.

Permisos

Un perfil de entidad de servicio puede llamar a esta llamada API. Para obtener más información, consulte: Perfiles de entidad de servicio en Power BI Embedded.

Ámbito requerido

Dataflow.ReadWrite.All

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
dataflowId	path	True	string uuid	Identificador del flujo de datos
groupId	path	True	string uuid	Identificador del área de trabajo

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
value	True	RefreshSchedule	Objeto que contiene los detalles de una programación de actualización

Respuestas

Nombre	Tipo	Description
200 OK		Aceptar

Ejemplos

Daily refresh schedule example

Disable refresh schedule example

Update refresh schedule times example

Daily refresh schedule example

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/dataflows/928228ba-008d-4fd9-864a-92d2752ee5ce/refreshSchedule

Request Body

{
  "value": {
    "days": [
      "Sunday",
      "Monday",
      "Tuesday",
      "Wednesday",
      "Thursday",
      "Friday",
      "Saturday"
    ],
    "times": [
      "10:00",
      "16:00"
    ],
    "enabled": true,
    "localTimeZoneId": "UTC",
    "notifyOption": "NoNotification"
  }
}

Sample Response

Status code:

200

Disable refresh schedule example

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/dataflows/928228ba-008d-4fd9-864a-92d2752ee5ce/refreshSchedule

Request Body

{
  "value": {
    "enabled": false
  }
}

Sample Response

Status code:

200

Update refresh schedule times example

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/dataflows/928228ba-008d-4fd9-864a-92d2752ee5ce/refreshSchedule

Request Body

{
  "value": {
    "times": [
      "10:30",
      "16:30"
    ],
    "enabled": true,
    "localTimeZoneId": "UTC"
  }
}

Sample Response

Status code:

200

Definiciones

Nombre	Description
days	Días en los que se va a ejecutar la actualización
RefreshSchedule	Una programación de actualización de Power BI para el modelo importado
RefreshScheduleRequest	Solicitud de programación de actualización de Power BI
ScheduleNotifyOption	La opción de notificación al finalizar una actualización programada. Las entidades de servicio solo admiten el NoNotification valor.

days

Días en los que se va a ejecutar la actualización

Nombre	Tipo	Description
Friday	string
Monday	string
Saturday	string
Sunday	string
Thursday	string
Tuesday	string
Wednesday	string

RefreshSchedule

Una programación de actualización de Power BI para el modelo importado

Nombre	Tipo	Description
NotifyOption	ScheduleNotifyOption	La opción de notificación al finalizar una actualización programada. Las entidades de servicio solo admiten el NoNotification valor.
days	days[]	Días en los que se va a ejecutar la actualización
enabled	boolean	Si la actualización está habilitada
localTimeZoneId	string	Identificador de la zona horaria que se va a usar. Para obtener más información, consulte Información de zona horaria.
times	string[]	Horas del día para ejecutar la actualización

RefreshScheduleRequest

Solicitud de programación de actualización de Power BI

Nombre	Tipo	Description
value	RefreshSchedule	Objeto que contiene los detalles de una programación de actualización

ScheduleNotifyOption

La opción de notificación al finalizar una actualización programada. Las entidades de servicio solo admiten el NoNotification valor.

Nombre	Tipo	Description
MailOnFailure	string	Se enviará una notificación por correo cuando se produzca un error de actualización.
NoNotification	string	No se enviará ninguna notificación