Datasets - Update Refresh Schedule In Group
Atualizações o agendamento de atualização para o conjunto de dados especificado do workspace especificado.
Uma solicitação que desabilita o agendamento de atualização não deve conter nenhuma outra alteração.
Pelo menos um dia deve ser especificado. Se nenhum horário for especificado, o Power BI usará uma única hora padrão por dia.
Permissões
- O usuário deve ser o proprietário do conjunto de dados.
- 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
Dataset.ReadWrite.All
Limitações
O limite do número de intervalos de tempo por dia depende se uma capacidade Premium ou Compartilhada é usada.
PATCH https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/refreshSchedule
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
dataset
|
path | True |
string |
A ID do conjunto de dados |
group
|
path | True |
string uuid |
A ID do workspace |
Corpo da solicitação
Nome | Obrigatório | Tipo | Description |
---|---|---|---|
value | True |
Um objeto que contém os detalhes de um agendamento de atualização |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
OK |
Exemplos
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
Sample Request
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"
}
}
Sample Response
Change the notification option of a refresh schedule example
Sample Request
PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
{
"value": {
"notifyOption": "NoNotification"
}
}
Sample Response
Disable a scheduled refresh example
Sample Request
PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
{
"value": {
"enabled": false
}
}
Sample Response
Update the times of a refresh schedule example
Sample Request
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"
]
}
}
Sample Response
Definições
Nome | Description |
---|---|
days |
Os dias em que executar a atualização |
Refresh |
Um agendamento de atualização do Power BI para o modelo importado |
Refresh |
Solicitação de agendamento de atualização do Power BI |
Schedule |
A opção de notificação sobre o encerramento de uma atualização agendada. As entidades de serviço só dão suporte ao |
days
Os dias em que executar a atualização
Nome | Tipo | Description |
---|---|---|
Friday |
string |
|
Monday |
string |
|
Saturday |
string |
|
Sunday |
string |
|
Thursday |
string |
|
Tuesday |
string |
|
Wednesday |
string |
RefreshSchedule
Um agendamento de atualização do Power BI para o modelo importado
Nome | Tipo | Description |
---|---|---|
NotifyOption |
A opção de notificação sobre o encerramento de uma atualização agendada. As entidades de serviço só dão suporte ao |
|
days |
days[] |
Os dias em que executar a atualização |
enabled |
boolean |
Se a atualização está habilitada |
localTimeZoneId |
string |
A ID do fuso horário a ser usado. Para obter mais informações, consulte Informações de fuso horário. |
times |
string[] |
As horas do dia para executar a atualização |
RefreshScheduleRequest
Solicitação de agendamento de atualização do Power BI
Nome | Tipo | Description |
---|---|---|
value |
Um objeto que contém os detalhes de um agendamento de atualização |
ScheduleNotifyOption
A opção de notificação sobre o encerramento de uma atualização agendada. As entidades de serviço só dão suporte ao NoNotification
valor.
Nome | Tipo | Description |
---|---|---|
MailOnFailure |
string |
Uma notificação por email será enviada em caso de falha na atualização |
NoNotification |
string |
Nenhuma notificação será enviada |