Admin - Get Refreshables For Capacity

참조

서비스:: Power BI REST APIs

API 버전:: v1.0

사용자가 액세스할 수 있는 지정된 용량에 대한 새로 고침 가능 항목 목록을 반환합니다.

Power BI는 각 데이터 세트에 대해 최대 60개의 새로 고침에 대해 7일간의 새로 고침 기록을 유지합니다.

권한을

사용자는 패브릭 관리자이거나 서비스 주체를 사용하여 인증해야 합니다.
위임된 권한이 지원됩니다.

서비스 기본 인증에서 실행하는 경우 앱 Azure Portal에서 설정된 Power BI에 대한 관리자 동의 필수 사전이 없어야 합니다.

필수 범위

Tenant.Read.All 또는 Tenant.ReadWrite.All

표준 위임된 관리자 액세스 토큰을 통해 인증하는 경우에만 관련됩니다. 서비스 주체를 통한 인증을 사용할 때는 존재하지 않아야 합니다.

제한

시간당 최대 200개 요청

GET https://api.powerbi.com/v1.0/myorg/admin/capacities/{capacityId}/refreshables?$top={$top}

선택적 매개 변수:

GET https://api.powerbi.com/v1.0/myorg/admin/capacities/{capacityId}/refreshables?$expand={$expand}&$filter={$filter}&$top={$top}&$skip={$skip}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
capacityId	path	True	string uuid	용량 ID
$top	query	True	integer int32	첫 번째 n 결과만 반환합니다.
$expand	query		string	응답에서 인라인으로 확장되는 쉼표로 구분된 데이터 형식 목록을 허용합니다. `capacities` 및 `groups`지원합니다.
$filter	query		string	Odata 필터 쿼리 매개 변수 조건에 따라 결과의 하위 집합을 반환합니다.
$skip	query		integer int32	첫 번째 n 결과를 건너뜁니다. 맨 위와 함께 사용하여 처음 1000을 초과하는 결과를 가져옵니다.

응답

Name	형식	Description
200 OK	Refreshables	그래

예제

Example

Get refreshables, filtering for an average refresh duration of greater than 30 minutes example.

Get refreshables with their 'capacity' and 'group' expanded example

Example

샘플 요청

GET https://api.powerbi.com/v1.0/myorg/admin/capacities/{capacityId}/refreshables

샘플 응답

상태 코드:: 200

{
  "value": [
    {
      "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
      "name": "SalesMarketing",
      "kind": "Dataset",
      "startTime": "2017-06-13T09:25:43.153Z",
      "endTime": "2017-06-19T11:22:32.445Z",
      "refreshCount": 22,
      "refreshFailures": 0,
      "averageDuration": 289.3814,
      "medianDuration": 268.6245,
      "refreshesPerDay": 11,
      "lastRefresh": {
        "refreshType": "ViaApi",
        "startTime": "2017-06-13T09:25:43.153Z",
        "endTime": "2017-06-13T09:31:43.153Z",
        "status": "Completed",
        "requestId": "9399bb89-25d1-44f8-8576-136d7e9014b1"
      },
      "refreshSchedule": {
        "days": [
          "Sunday",
          "Friday",
          "Saturday"
        ],
        "times": [
          "05:00",
          "11:30",
          "17:30",
          "23:00"
        ],
        "enabled": true,
        "localTimeZoneId": "UTC",
        "notifyOption": "MailOnFailure"
      },
      "configuredBy": [
        "john@contoso.com"
      ]
    }
  ]
}

Get refreshables, filtering for an average refresh duration of greater than 30 minutes example.

샘플 요청

GET https://api.powerbi.com/v1.0/myorg/admin/capacities/{capacityId}/refreshables?$filter=averageDuration gt 1800

샘플 응답

상태 코드:: 200

{
  "value": [
    {
      "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
      "name": "SalesMarketing",
      "kind": "Dataset",
      "startTime": "2017-06-13T09:25:43.153Z",
      "endTime": "2017-06-19T11:22:32.445Z",
      "refreshCount": 22,
      "refreshFailures": 0,
      "averageDuration": 3289.3814,
      "medianDuration": 2268.6245,
      "refreshesPerDay": 11,
      "lastRefresh": {
        "refreshType": "ViaApi",
        "startTime": "2017-06-13T09:25:43.153Z",
        "endTime": "2017-06-13T09:58:05.221Z",
        "status": "Completed",
        "requestId": "9399bb89-25d1-44f8-8576-136d7e9014b1"
      },
      "refreshSchedule": {
        "days": [
          "Sunday",
          "Friday",
          "Saturday"
        ],
        "times": [
          "05:00",
          "11:30",
          "17:30",
          "23:00"
        ],
        "enabled": true,
        "localTimeZoneId": "UTC",
        "notifyOption": "MailOnFailure"
      },
      "configuredBy": [
        "john@contoso.com"
      ]
    }
  ]
}

Get refreshables with their 'capacity' and 'group' expanded example

샘플 요청

GET https://api.powerbi.com/v1.0/myorg/admin/capacities/{capacityId}/refreshables?$expand=capacity,group

샘플 응답

상태 코드:: 200

{
  "value": [
    {
      "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
      "name": "SalesMarketing",
      "kind": "Dataset",
      "startTime": "2017-06-13T09:25:43.153Z",
      "endTime": "2017-06-19T11:22:32.445Z",
      "refreshCount": 22,
      "refreshFailures": 0,
      "averageDuration": 289.3814,
      "medianDuration": 268.6245,
      "refreshesPerDay": 11,
      "lastRefresh": {
        "refreshType": "ViaApi",
        "startTime": "2017-06-13T09:25:43.153Z",
        "endTime": "2017-06-13T09:31:43.153Z",
        "status": "Completed",
        "requestId": "9399bb89-25d1-44f8-8576-136d7e9014b1"
      },
      "refreshSchedule": {
        "days": [
          "Sunday",
          "Friday",
          "Saturday"
        ],
        "times": [
          "05:00",
          "11:30",
          "17:30",
          "23:00"
        ],
        "enabled": true,
        "localTimeZoneId": "UTC",
        "notifyOption": "MailOnFailure"
      },
      "configuredBy": [
        "john@contoso.com"
      ],
      "capacity": {
        "id": "0f084df7-c13d-451b-af5f-ed0c466403b2",
        "displayName": "MyCapacity",
        "sku": "A1"
      },
      "group": {
        "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
        "name": "SalesMarketing"
      }
    }
  ]
}

정의

Name	Description
Capacity	Power BI 용량
CapacityState	용량 상태
capacityUserAccessRight	사용자가 용량에 대해 가지고 있는 액세스 권한
days	새로 고침을 실행할 일
Refresh	Power BI 새로 고침 기록 항목
Refreshable	Power BI 새로 고침 가능 항목은 한 번 이상 새로 고쳐졌거나 유효한 새로 고침 일정이 있는 데이터 세트입니다. 데이터 세트가 이러한 조건 중 하나를 충족하지 않으면 API 응답에 표시되지 않습니다. Power BI는 각 데이터 세트에 대해 최대 60개의 새로 고침에 대해 7일간의 새로 고침 기록을 유지합니다.
RefreshableGroup	새로 고칠 수 있는 항목에 연결된 Power BI 그룹
RefreshableKind	새로 고칠 수 있는 종류
Refreshables	Power BI 새로 고침 가능 목록
RefreshAttempt	Power BI는 새로 고침 오류가 발생하는 경우 데이터 세트를 새로 고치려고 여러 차례 자동으로 시도합니다. 이 개체에는 각 새로 고침 시도에 대한 정보가 포함됩니다.
RefreshAttemptType	새로 고침 시도의 유형입니다.
RefreshSchedule	가져온 모델에 대한 Power BI 새로 고침 일정
RefreshType	새로 고침 요청의 유형
ScheduleNotifyOption	예약된 새로 고침 종료 시 알림 옵션입니다. 서비스 주체는 `NoNotification` 값만 지원합니다.
TenantKey	암호화 키 정보

Capacity

Power BI 용량

Name	형식	Description
admins	string[]	용량 관리자의 배열
capacityUserAccessRight	capacityUserAccessRight	사용자가 용량에 대한 액세스 권한
displayName	string	용량의 표시 이름
id	string	용량 ID
region	string	용량이 프로비전된 Azure 지역
sku	string	용량 SKU
state	CapacityState	용량 상태
tenantKey	TenantKey	암호화 키 정보(관리자 경로에만 적용됨)
tenantKeyId	string	암호화 키의 ID(관리자 경로에만 적용 가능)

CapacityState

용량 상태

Name	형식	Description
Active	string	용량을 사용할 준비가 된 경우
Deleted	string	용량이 삭제되었으며 사용할 수 없습니다.
Deleting	string	용량 삭제가 진행 중입니다.
Invalid	string	용량을 사용할 수 없습니다.
NotActivated	string	지원 되지 않는
PreSuspended	string	지원 되지 않는
ProvisionFailed	string	용량 프로비전 실패
Provisioning	string	용량 활성화가 진행 중입니다.
Suspended	string	용량 사용이 일시 중단됨
UpdatingSku	string	용량 SKU 변경이 진행 중입니다.

capacityUserAccessRight

사용자가 용량에 대해 가지고 있는 액세스 권한

Name	형식	Description
Admin	string	사용자에게 용량에 대한 관리자 권한이 있습니다.
Assign	string	사용자에게 기여자 권한이 있으며 작업 영역을 용량에 할당할 수 있습니다.
None	string	사용자에게 용량에 대한 액세스 권한이 없습니다.

days

새로 고침을 실행할 일

Name	형식	Description
Friday	string
Monday	string
Saturday	string
Sunday	string
Thursday	string
Tuesday	string
Wednesday	string

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`.

Refreshable

Power BI 새로 고침 가능 항목은 한 번 이상 새로 고쳐졌거나 유효한 새로 고침 일정이 있는 데이터 세트입니다. 데이터 세트가 이러한 조건 중 하나를 충족하지 않으면 API 응답에 표시되지 않습니다. Power BI는 각 데이터 세트에 대해 최대 60개의 새로 고침에 대해 7일간의 새로 고침 기록을 유지합니다.

Name	형식	Description
averageDuration	number	새로 고침 데이터가 있는 기간 동안 새로 고침의 평균 기간(초)입니다.
capacity	Capacity	새로 고칠 수 있는 항목의 용량
configuredBy	string[]	새로 고칠 수 있는 소유자
endTime	string	새로 고침 데이터가 있는 창의 종료 시간
group	RefreshableGroup	새로 고칠 수 있는 항목에 대한 연결된 그룹
id	string	새로 고칠 수 있는 개체 ID
kind	RefreshableKind	새로 고칠 수 있는 종류
lastRefresh	Refresh	새로 고칠 수 있는 항목에 대한 마지막 Power BI 새로 고침 기록 항목
medianDuration	number	새로 고침 데이터가 있는 시간 범위 내에서 새로 고침의 평균 기간(초)
name	string	새로 고칠 수 있는 표시 이름
refreshCount	integer	새로 고침 데이터가 있는 기간 내의 새로 고침 수
refreshFailures	integer	새로 고침 데이터가 있는 시간 범위 내의 새로 고침 실패 횟수
refreshSchedule	RefreshSchedule	새로 고칠 수 있는 항목에 대한 새로 고침 일정
refreshesPerDay	integer	새로 고침 데이터가 존재하는 기간 내의 일별 새로 고침 수(예약 및 주문형)
startTime	string	새로 고침 데이터가 있는 창의 시작 시간

RefreshableGroup

새로 고칠 수 있는 항목에 연결된 Power BI 그룹

Name	형식	Description
id	string	작업 영역 ID
name	string	그룹 이름

RefreshableKind

새로 고칠 수 있는 종류

Name	형식	Description
Dataset	string	데이터 세트

Refreshables

Power BI 새로 고침 가능 목록

Name	형식	Description
odata.context	string	OData 컨텍스트
value	Refreshable[]	새로 고침 가능

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	프리미엄 쿼리 캐시 및 대시보드 타일을 새로 고치려는 시도입니다.

RefreshSchedule

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

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

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 엔드포인트를 통해 새로 고침이 트리거되었습니다.

ScheduleNotifyOption

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

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

TenantKey

암호화 키 정보

Name	형식	Description
createdAt	string	암호화 키의 생성 날짜 및 시간
id	string	암호화 키의 ID
isDefault	boolean	암호화 키가 전체 테넌트에 대한 기본 키인지 여부입니다. 새로 만든 용량은 기본 키를 상속합니다.
keyVaultKeyIdentifier	string	Azure Key Vault에서 암호화 키를 고유하게 지정하는 URI
name	string	암호화 키의 이름
updatedAt	string	암호화 키의 마지막 업데이트 날짜 및 시간

다음을 통해 공유

Admin - Get Refreshables For Capacity

권한을

필수 범위

제한

URI 매개 변수

응답

예제

Example

샘플 요청

샘플 응답

Get refreshables, filtering for an average refresh duration of greater than 30 minutes example.

샘플 요청

샘플 응답

Get refreshables with their 'capacity' and 'group' expanded example

샘플 요청

샘플 응답

정의

Capacity

CapacityState

capacityUserAccessRight

days

Refresh

Refreshable

RefreshableGroup

RefreshableKind

Refreshables

RefreshAttempt

RefreshAttemptType

RefreshSchedule

RefreshType

ScheduleNotifyOption

TenantKey

추가 리소스