다음을 통해 공유

Datasets - Update Refresh Schedule

  • 참조
Service:
Power BI REST APIs
API Version:
v1.0

내 작업 영역에서 지정된 데이터 세트에 대한 새로 고침 일정을 업데이트.

새로 고침 일정을 사용하지 않도록 설정하는 요청에는 다른 변경 내용이 포함되어야 합니다.

하루 이상을 지정해야 합니다. 횟수 지정이 없으면 Power BI는 매일 기본 단일 시간을 사용합니다.

사용 권한

사용자는 데이터 세트 소유자여야 합니다.

필수 범위

Dataset.ReadWrite.All

제한 사항

일별 시간 슬롯 수 제한은 프리미엄 또는 공유 용량 사용 여부에 따라 달라집니다. 

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
datasetId
 path True

string

데이터 세트 ID

요청 본문

Name 필수 형식 Description
value True

RefreshSchedule

새로 고침 일정의 세부 정보를 포함하는 개체

응답

Name 형식 Description
200 OK

확인

예제

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/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
Request Body
{
  "value": {
    "days": [
      "Sunday",
      "Tuesday",
      "Friday",
      "Saturday"
    ],
    "times": [
      "07:00",
      "11:30",
      "16:00",
      "23:30"
    ],
    "localTimeZoneId": "UTC"
  }
}

Sample Response

Status code:
200

Change the notification option of a refresh schedule example

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
Request Body
{
  "value": {
    "notifyOption": "NoNotification"
  }
}

Sample Response

Status code:
200

Disable a scheduled refresh example

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
Request Body
{
  "value": {
    "enabled": false
  }
}

Sample Response

Status code:
200

Update the times of a refresh schedule example

Sample Request

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

Sample Response

Status code:
200

정의

Name Description
days

새로 고침을 실행할 일
RefreshSchedule

가져온 모델에 대한 Power BI 새로 고침 일정
RefreshScheduleRequest

Power BI 새로 고침 일정 요청
ScheduleNotifyOption

예약된 새로 고침 종료 시 알림 옵션입니다. 서비스 주체는 값만 지원합니다 NoNotification .

days

새로 고침을 실행할 일

Name 형식 Description
Friday

string

Monday

string

Saturday

string

Sunday

string

Thursday

string

Tuesday

string

Wednesday

string

RefreshSchedule

가져온 모델에 대한 Power BI 새로 고침 일정

Name 형식 Description
NotifyOption

ScheduleNotifyOption

예약된 새로 고침 종료 시 알림 옵션입니다. 서비스 주체는 값만 지원합니다 NoNotification .
days

days[]

새로 고침을 실행할 일
enabled

boolean

새로 고침을 사용할 수 있는지 여부
localTimeZoneId

string

사용할 표준 시간대의 ID입니다. 자세한 내용은 표준 시간대 정보를 참조하세요.
times

string[]

새로 고침을 실행하는 하루 중 시간

RefreshScheduleRequest

Power BI 새로 고침 일정 요청

Name 형식 Description
value

RefreshSchedule

새로 고침 일정의 세부 정보를 포함하는 개체

ScheduleNotifyOption

예약된 새로 고침 종료 시 알림 옵션입니다. 서비스 주체는 값만 지원합니다 NoNotification .

Name 형식 Description
MailOnFailure

string

새로 고침 실패 시 메일 알림이 전송됩니다.
NoNotification

string

알림이 전송되지 않습니다.