Dataflows - Update Refresh Schedule

서비스:

Power BI REST APIs

API 버전:

v1.0

지정된 데이터 흐름에 대한 새로 고침 일정을 만들거나 업데이트합니다.

Permissions

이 API 호출은 서비스 주체 프로필에서 호출할 수 있습니다. 자세한 내용은 Power BI Embedded의 서비스 주체 프로필을 참조하세요.

필수 범위

Dataflow.ReadWrite.All

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
dataflowId	path	True	string (uuid)	데이터 흐름 ID
groupId	path	True	string (uuid)	작업 영역 ID

요청 본문

Name	필수	형식	Description
value	True	RefreshSchedule	새로 고침 일정의 세부 정보를 포함하는 개체

응답

Name	형식	Description
200 OK		그래

예제

Daily refresh schedule example

Disable refresh schedule example

Update refresh schedule times example

Daily refresh schedule example

샘플 요청

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/dataflows/928228ba-008d-4fd9-864a-92d2752ee5ce/refreshSchedule

요청 본문

{
  "value": {
    "days": [
      "Sunday",
      "Monday",
      "Tuesday",
      "Wednesday",
      "Thursday",
      "Friday",
      "Saturday"
    ],
    "times": [
      "10:00",
      "16:00"
    ],
    "enabled": true,
    "localTimeZoneId": "UTC",
    "notifyOption": "NoNotification"
  }
}

샘플 응답

상태 코드:

200

Disable refresh schedule example

샘플 요청

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/dataflows/928228ba-008d-4fd9-864a-92d2752ee5ce/refreshSchedule

요청 본문

{
  "value": {
    "enabled": false,
    "times": [],
    "localTimeZoneId": "UTC"
  }
}

샘플 응답

상태 코드:

200

Update refresh schedule times example

샘플 요청

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/dataflows/928228ba-008d-4fd9-864a-92d2752ee5ce/refreshSchedule

요청 본문

{
  "value": {
    "times": [
      "10:30",
      "16:30"
    ],
    "enabled": true,
    "localTimeZoneId": "UTC"
  }
}

샘플 응답

상태 코드:

200

정의

Name	Description
days	새로 고침을 실행할 일
RefreshSchedule	가져온 모델에 대한 Power BI 새로 고침 일정
RefreshScheduleRequest	Power BI 새로 고침 일정 요청
ScheduleNotifyOption	예약된 새로 고침 종료 시 알림 옵션입니다. 서비스 주체는 이 값만 지원합니다 NoNotification .

days

열거형

새로 고침을 실행할 일

값	Description
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday
Sunday

RefreshSchedule

Object

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

Name	형식	Description
days	days[]	새로 고침을 실행할 일
enabled	boolean	새로 고침 사용 여부
localTimeZoneId	string	사용할 표준 시간대의 ID입니다. 자세한 내용은 표준 시간대 정보를 참조하세요.
notifyOption	ScheduleNotifyOption	예약된 새로 고침 종료 시 알림 옵션입니다. 서비스 주체는 이 값만 지원합니다 NoNotification .
times	string[]	새로 고침을 실행하는 하루 중 시간

RefreshScheduleRequest

Object

Power BI 새로 고침 일정 요청

Name	형식	Description
value	RefreshSchedule	새로 고침 일정의 세부 정보를 포함하는 개체

ScheduleNotifyOption

열거형

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

값	Description
NoNotification	알림이 전송되지 않습니다.
MailOnFailure	새로 고침 실패 시 메일 알림이 전송됩니다.