Dataflows - Refresh Dataflow

지정된 데이터 흐름에 대한 새로 고침을 트리거합니다.

지원되는 메일 알림 옵션은 MailOnFailureNoNotification입니다. MailOnCompletion 은 지원되지 않습니다.

사용 권한

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

필수 범위

Dataflow.ReadWrite.All

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/dataflows/{dataflowId}/refreshes
POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/dataflows/{dataflowId}/refreshes?processType={processType}

URI 매개 변수

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

string

uuid

데이터 흐름 ID

groupId
path True

string

uuid

작업 영역 ID

processType
query

string

uuid

사용할 새로 고침 프로세스의 유형입니다.

요청 본문

Name 필수 형식 Description
notifyOption True

NotifyOption

메일 알림 옵션

응답

Name 형식 Description
200 OK

정상

예제

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/51e47fc5-48fd-4826-89f0-021bd3a80abd/dataflows/928228ba-008d-4fd9-864a-92d2752ee5ce/refreshes?processType=default
{
  "notifyOption": "MailOnFailure"
}

Sample Response

정의

Name Description
NotifyOption

메일 알림 옵션

RefreshRequest

Power BI 새로 고침 요청

NotifyOption

메일 알림 옵션

Name 형식 Description
MailOnCompletion

string

새로 고침 완료 시 성공 또는 실패를 나타내는 메일 알림이 전송됩니다.

MailOnFailure

string

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

NoNotification

string

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

RefreshRequest

Power BI 새로 고침 요청

Name 형식 Description
notifyOption

NotifyOption

메일 알림 옵션