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
- L’utilisateur doit être le propriétaire du jeu de données.
- Cet appel d’API peut être appelé par un profil de principal de service. Pour plus d’informations, consultez : Profils de principal de service dans Power BI Embedded.
É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 |
|---|---|---|---|---|
|
dataset
|
path | True |
string |
ID du jeu de données |
|
group
|
path | True |
string (uuid) |
ID de l’espace de travail |
Corps de la demande
| Nom | Obligatoire | Type | Description |
|---|---|---|---|
| value | True |
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 |
|
Refresh |
Planification d’actualisation De Power BI pour le modèle importé |
|
Refresh |
Demande de planification d’actualisation Power BI |
|
Schedule |
Option de notification lors de l’arrêt d’une actualisation planifiée. Les principaux de service prennent uniquement en charge la |
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 |
Option de notification lors de l’arrêt d’une actualisation planifiée. Les principaux de service prennent uniquement en charge la |
|
| 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 |
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 |