Datasets - Update Direct Query Refresh Schedule

Service:

Power BI REST APIs

API Version:

v1.0

Novedades la programación de actualización de un conjunto de datos DirectQuery o LiveConnection especificado desde Mi área de trabajo.

Una solicitud debe contener un conjunto de días y horas o una frecuencia válida, pero no ambas. Si elige un conjunto de días sin especificar ninguna hora, Power BI usará una única hora predeterminada al día. Al establecer la frecuencia, se sobrescribirá automáticamente la configuración de días y horas.

Permisos

El usuario debe ser el propietario del conjunto de datos.

Ámbito requerido

Dataset.ReadWrite.All

PATCH https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/directQueryRefreshSchedule

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
datasetId	path	True	string	El identificador del conjunto de datos

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
value	True	DirectQueryRefreshSchedule	Objeto que contiene los detalles de la programación de actualización de DirectQuery o LiveConnection.

Respuestas

Nombre	Tipo	Description
200 OK		Aceptar

Ejemplos

Disable a scheduled refresh example

Set a days and times based schedule example

Set a frequency based schedule example

Update the times of a days and times based schedule example

Disable a scheduled refresh example

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule

Request Body

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

Sample Response

Status code:

200

Set a days and times based schedule example

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule

Request Body

{
  "value": {
    "days": [
      "Sunday",
      "Tuesday",
      "Friday",
      "Saturday"
    ],
    "times": [
      "07:00",
      "11:30",
      "16:00",
      "23:30"
    ],
    "localTimeZoneId": "UTC"
  }
}

Sample Response

Status code:

200

Set a frequency based schedule example

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule

Request Body

{
  "value": {
    "frequency": 30
  }
}

Sample Response

Status code:

200

Update the times of a days and times based schedule example

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule

Request Body

{
  "value": {
    "times": [
      "07:00",
      "16:30",
      "23:30"
    ]
  }
}

Sample Response

Status code:

200

Definiciones

Nombre	Description
days	Días en los que se va a ejecutar la actualización
DirectQueryRefreshSchedule	Una programación de actualización de Power BI para DirectQuery o LiveConnection, especificando la frecuencia o una combinación de días y horas.
DirectQueryRefreshScheduleRequest	Solicitud de programación de actualización de Power BI para DirectQuery o LiveConnection

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

DirectQueryRefreshSchedule

Una programación de actualización de Power BI para DirectQuery o LiveConnection, especificando la frecuencia o una combinación de días y horas.

Nombre	Tipo	Description
days	days[]	Días en los que se va a ejecutar la actualización
frequency	integer	Intervalo en minutos entre actualizaciones sucesivas. Los valores admitidos son 15, 30, 60, 120 y 180.
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

DirectQueryRefreshScheduleRequest

Solicitud de programación de actualización de Power BI para DirectQuery o LiveConnection

Nombre	Tipo	Description
value	DirectQueryRefreshSchedule	Objeto que contiene los detalles de la programación de actualización de DirectQuery o LiveConnection.