Datasets - Get Refresh History In Group

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

지정된 작업 영역에서 지정된 데이터 세트에 대한 새로 고침 기록을 반환합니다.

사용 권한

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

필수 범위

Dataset.ReadWrite.All 또는 Dataset.Read.All

제한 사항

OneDrive 새로 고침 기록이 반환되지 않습니다. 

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/refreshes
With optional parameters: 
GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/refreshes?$top={$top}

URI 매개 변수

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

string

데이터 세트 ID
groupId
 path True

string

uuid

작업 영역 ID
$top
 query

integer

새로 고침 기록에서 요청된 항목 수입니다. 제공되지 않은 경우 기본값은 마지막으로 사용할 수 있는 60개 항목입니다.

응답

Name 형식 Description
200 OK

Refreshes

정상

예제

Completed refresh example
Failed refresh example
In-progress refresh example

Completed refresh example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes?$top=1

Sample Response

Status code:
200 
{
  "value": [
    {
      "refreshType": "ViaApi",
      "startTime": "2017-06-13T09:25:43.153Z",
      "endTime": "2017-06-13T09:31:43.153Z",
      "status": "Completed",
      "requestId": "9399bb89-25d1-44f8-8576-136d7e9014b1",
      "refreshAttempts": [
        {
          "attemptId": 1,
          "startTime": "2017-06-13T09:25:43.153Z",
          "endTime": "2017-06-13T09:31:40.153Z",
          "type": "Data"
        },
        {
          "attemptId": 1,
          "startTime": "2017-06-13T09:31:40.156Z",
          "endTime": "2017-06-13T09:31:43.153Z",
          "type": "Query"
        }
      ]
    }
  ]
}

Failed refresh example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes?$top=1

Sample Response

Status code:
200 
{
  "value": [
    {
      "refreshType": "ViaApi",
      "startTime": "2017-06-13T09:25:43.153Z",
      "endTime": "2017-06-13T09:31:43.153Z",
      "serviceExceptionJson": "{\"errorCode\":\"ModelRefreshFailed_CredentialsNotSpecified\"}",
      "status": "Failed",
      "requestId": "11bf290a-346b-48b7-8973-c5df149337ff",
      "refreshAttempts": [
        {
          "attemptId": 1,
          "startTime": "2017-06-13T09:25:43.153Z",
          "endTime": "2017-06-13T09:31:43.153Z",
          "serviceExceptionJson": "{\"errorCode\":\"ModelRefreshFailed_CredentialsNotSpecified\"}",
          "type": "Data"
        }
      ]
    }
  ]
}

In-progress refresh example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes?$top=1

Sample Response

Status code:
200 
{
  "value": [
    {
      "refreshType": "ViaApi",
      "startTime": "2017-06-13T09:25:43.153Z",
      "status": "Unknown",
      "requestId": "9399bb89-25d1-44f8-8576-136d7e9014b1"
    }
  ]
}

정의

Name Description
Refresh

Power BI 새로 고침 기록 항목
RefreshAttempt

Power BI는 새로 고침 오류가 발생하는 경우 데이터 세트를 새로 고치려고 여러 차례 자동으로 시도합니다. 이 개체에는 각 새로 고침 시도에 대한 정보가 포함됩니다.
RefreshAttemptType

새로 고침 시도 유형입니다.
Refreshes

Power BI 새로 고침 기록 목록의 OData 응답 래퍼
RefreshType

새로 고침 요청 유형

Refresh

Power BI 새로 고침 기록 항목

Name 형식 Description
endTime

string

새로 고침의 종료 날짜 및 시간(새로 고침이 진행 중인 경우 비어 있을 수 있음)
refreshAttempts

RefreshAttempt[]

새로 고침 시도 목록입니다.
refreshType

RefreshType

새로 고침 요청 유형
requestId

string

새로 고침 요청의 식별자입니다. 모든 서비스 요청에 이 식별자를 제공합니다.
serviceExceptionJson

string

JSON 형식의 오류 오류 코드(오류가 없으면 비어 있음)
startTime

string

새로 고침의 시작 날짜 및 시간
status

string

  • Unknown 완료 상태를 알 수 없거나 새로 고침이 진행 중이면 입니다.
  • Completed 새로 고침을 완료했습니다.
  • Failed 새로 고침에 실패했습니다(serviceExceptionJson 오류 코드가 포함됨).
  • Disabled 선택적 새로 고침으로 새로 고침을 사용하지 않도록 설정하면 입니다.

RefreshAttempt

Power BI는 새로 고침 오류가 발생하는 경우 데이터 세트를 새로 고치려고 여러 차례 자동으로 시도합니다. 이 개체에는 각 새로 고침 시도에 대한 정보가 포함됩니다.

Name 형식 Description
attemptId

integer

새로 고침 시도의 인덱스입니다.
endTime

string

새로 고침 시도의 종료 날짜 및 시간입니다. 새로 고침 시도가 진행 중인 경우 값은 void입니다.
serviceExceptionJson

string

JSON 형식의 오류 오류 코드입니다. 오류가 없으면 Void입니다.
startTime

string

새로 고침 시도의 시작 날짜 및 시간입니다.
type

RefreshAttemptType

새로 고침 시도 유형입니다.

RefreshAttemptType

새로 고침 시도 유형입니다.

Name 형식 Description
Data

string

데이터 세트에 데이터를 로드하려는 새로 고침 시도입니다.
Query

string

프리미엄 쿼리 캐시를 새로 고치고 타일을 dashboard 시도

Refreshes

Power BI 새로 고침 기록 목록의 OData 응답 래퍼

Name 형식 Description
odata.context

string

value

Refresh[]

새로 고침 기록 목록

RefreshType

새로 고침 요청 유형

Name 형식 Description
OnDemand

string

새로 고침이 Power BI 포털을 통해 대화형으로 트리거되었습니다.
OnDemandTraining

string

자동 집계 학습을 통해 Power BI 포털을 통해 대화형으로 새로 고침이 트리거되었습니다.
Scheduled

string

새로 고침이 데이터 세트 새로 고침 일정 설정에 의해 트리거되었습니다.
ViaApi

string

새로 고침이 API 호출에 의해 트리거되었습니다.
ViaEnhancedApi

string

향상된 새로 고침 REST API 호출에 의해 새로 고침이 트리거되었습니다.
ViaXmlaEndpoint

string

새로 고침이 Power BI 공용 XMLA 엔드포인트를 통해 트리거되었습니다.