Partager via


Datasets - Update Refresh Schedule In Group

Met à jour la planification d’actualisation du jeu de données spécifié à partir de l’espace de travail spécifié.

Une demande qui désactive la planification d’actualisation ne doit contenir aucune autre modification.

Au moins un jour doit être spécifié. Si aucune heure n’est spécifiée, Power BI utilise une seule heure par jour par défaut.

Permissions

Étendue requise

Dataset.ReadWrite.All

Limites

La limite du nombre de créneaux horaires par jour dépend de l’utilisation d’une capacité Premium ou Partagée.

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

Paramètres URI

Nom Dans Obligatoire Type Description
datasetId
path True

string

ID du jeu de données

groupId
path True

string (uuid)

ID de l’espace de travail

Corps de la demande

Nom Obligatoire Type Description
value True

RefreshSchedule

Objet qui contient les détails d’une planification d’actualisation

Réponses

Nom Type Description
200 OK

Ok

Exemples

Change the days and times of a refresh schedule example
Change the notification option of a refresh schedule example
Disable a scheduled refresh example
Update the times of a refresh schedule example

Change the days and times of a refresh schedule example

Exemple de requête

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
{
  "value": {
    "days": [
      "Sunday",
      "Tuesday",
      "Friday",
      "Saturday"
    ],
    "times": [
      "07:00",
      "11:30",
      "16:00",
      "23:30"
    ],
    "localTimeZoneId": "UTC"
  }
}

Exemple de réponse

Change the notification option of a refresh schedule example

Exemple de requête

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
{
  "value": {
    "notifyOption": "NoNotification"
  }
}

Exemple de réponse

Disable a scheduled refresh example

Exemple de requête

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
{
  "value": {
    "enabled": false
  }
}

Exemple de réponse

Update the times of a refresh schedule example

Exemple de requête

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
{
  "value": {
    "times": [
      "08:00",
      "16:00"
    ]
  }
}

Exemple de réponse

Définitions

Nom Description
days

Jours sur lesquels exécuter l’actualisation

RefreshSchedule

Planification d’actualisation De Power BI pour le modèle importé

RefreshScheduleRequest

Demande de planification d’actualisation Power BI

ScheduleNotifyOption

Option de notification lors de l’arrêt d’une actualisation planifiée. Les principaux de service prennent uniquement en charge la NoNotification valeur.

days

Jours sur lesquels exécuter l’actualisation

Valeur Description
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday
Sunday

RefreshSchedule

Planification d’actualisation De Power BI pour le modèle importé

Nom Type Description
days

days[]

Jours sur lesquels exécuter l’actualisation

enabled

boolean

Indique si l’actualisation est activée

localTimeZoneId

string

ID du fuseau horaire à utiliser. Pour plus d’informations, consultez les informations du fuseau horaire.

notifyOption

ScheduleNotifyOption

Option de notification lors de l’arrêt d’une actualisation planifiée. Les principaux de service prennent uniquement en charge la NoNotification valeur.

times

string[]

Heures de la journée d’exécution de l’actualisation

RefreshScheduleRequest

Demande de planification d’actualisation Power BI

Nom Type Description
value

RefreshSchedule

Objet qui contient les détails d’une planification d’actualisation

ScheduleNotifyOption

Option de notification lors de l’arrêt d’une actualisation planifiée. Les principaux de service prennent uniquement en charge la NoNotification valeur.

Valeur Description
NoNotification

Aucune notification n’est envoyée

MailOnFailure

Une notification par courrier électronique sera envoyée lors de l’échec de l’actualisation