Datasets - Update Refresh Schedule
Atualiza o agendamento de atualização do conjunto de dados especificado do Meu workspace.
Uma solicitação que desabilita o agendamento de atualização não deve conter outras alterações.
Pelo menos um dia deve ser especificado. Se nenhum horário for especificado, o Power BI usará uma única hora padrão por dia.
Permissions
O usuário deve ser o proprietário do conjunto de dados.
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/datasets/{datasetId}/refreshSchedule
Parâmetros de URI
| Nome | Em | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
dataset
|
path | True |
string |
A ID do conjunto de dados |
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 |
OKEY |
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
Solicitação de exemplo
PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
{
"value": {
"days": [
"Sunday",
"Tuesday",
"Friday",
"Saturday"
],
"times": [
"07:00",
"11:30",
"16:00",
"23:30"
],
"localTimeZoneId": "UTC"
}
}
Resposta de exemplo
Change the notification option of a refresh schedule example
Solicitação de exemplo
PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
{
"value": {
"notifyOption": "NoNotification"
}
}
Resposta de exemplo
Disable a scheduled refresh example
Solicitação de exemplo
PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
{
"value": {
"enabled": false
}
}
Resposta de exemplo
Update the times of a refresh schedule example
Solicitação de exemplo
PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
{
"value": {
"times": [
"08:00",
"16:00"
]
}
}
Resposta de exemplo
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 no 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
| Valor | Description |
|---|---|
| Monday | |
| Tuesday | |
| Wednesday | |
| Thursday | |
| Friday | |
| Saturday | |
| Sunday |
RefreshSchedule
Um agendamento de atualização do Power BI para o modelo importado
| Nome | Tipo | Description |
|---|---|---|
| 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. |
| notifyOption |
A opção de notificação no encerramento de uma atualização agendada. As entidades de serviço só dão suporte ao |
|
| 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 no encerramento de uma atualização agendada. As entidades de serviço só dão suporte ao NoNotification valor.
| Valor | Description |
|---|---|
| NoNotification |
Nenhuma notificação será enviada |
| MailOnFailure |
Uma notificação por email será enviada por falha de atualização |