Capacities - Get Refreshables

서비스:: Power BI REST APIs

API 버전:: v1.0

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

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

필수 범위

Capacity.Read.All 또는 Capacity.ReadWrite.All

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

선택적 매개 변수:

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
$top	query	True	integer (int32) minimum: 1	첫 번째 n 결과만 반환합니다.
$expand	query		string	응답에서 인라인으로 확장되는 쉼표로 구분된 데이터 형식 목록을 허용합니다. `capacity` 및 `group`지원합니다.
$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/capacities/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/capacities/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/capacities/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

Object

Power BI 용량

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

CapacityState

열거형

용량 상태

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

capacityUserAccessRight

열거형

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

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

days

열거형

새로 고침을 실행할 일

값	Description
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday
Sunday

Refresh

Object

Power BI 새로 고침 기록 항목

Name	형식	Description
endTime	string (date-time)	새로 고침의 종료 날짜 및 시간(새로 고침이 진행 중인 경우 비어 있을 수 있음) UTC 형식입니다.
refreshAttempts	RefreshAttempt[]	새로 고침 시도 목록입니다.
refreshType	RefreshType	새로 고침 요청의 유형
requestId	string	새로 고침 요청의 식별자입니다. 모든 서비스 요청에 이 식별자를 제공합니다.
serviceExceptionJson	string	JSON 형식의 오류 오류 코드(오류가 없는 경우 비어 있음)
startTime	string (date-time)	새로 고침의 시작 날짜 및 시간(UTC 형식)입니다.
status	string	완료 상태를 알 수 없거나 새로 고침이 진행 중인지 `Unknown`. 성공적으로 완료된 새로 고침에 대한 `Completed`. 실패한 새로 고침에 대한 `Failed`(`serviceExceptionJson` 오류 코드 포함) 선택적 새로 고침으로 새로 고침을 사용하지 않도록 설정했는지 `Disabled`.

Refreshable

Object

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

Name	형식	Description
averageDuration	number	새로 고침 데이터가 있는 기간 동안 새로 고침의 평균 기간(초)입니다.
capacity	Capacity	새로 고칠 수 있는 항목의 용량
configuredBy	string[]	새로 고칠 수 있는 소유자
endTime	string (date-time)	새로 고침 데이터가 UTC 형식으로 존재하는 창의 종료 시간입니다.
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 (date-time)	새로 고침 데이터가 UTC 형식으로 존재하는 창의 시작 시간입니다.

RefreshableGroup

Object

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

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

RefreshableKind

열거형

새로 고칠 수 있는 종류

값	Description
Dataset	데이터 세트

Refreshables

Object

Power BI 새로 고침 가능 목록

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

RefreshAttempt

Object

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

Name	형식	Description
attemptId	integer	새로 고침 시도의 인덱스입니다.
endTime	string (date-time)	새로 고침 시도의 종료 날짜 및 시간입니다. 새로 고침 시도가 진행 중인 경우 값은 void입니다.
serviceExceptionJson	string	JSON 형식의 오류 오류 코드입니다. 오류가 없으면 Void입니다.
startTime	string (date-time)	새로 고침 시도의 시작 날짜 및 시간입니다.
type	RefreshAttemptType	새로 고침 시도의 유형입니다.

RefreshAttemptType

열거형

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

값	Description
Data	데이터 세트에 데이터를 로드하려는 새로 고침 시도입니다.
Query	프리미엄 쿼리 캐시 및 대시보드 타일을 새로 고치려는 시도입니다.

RefreshSchedule

Object

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

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

RefreshType

열거형

새로 고침 요청의 유형

값	Description
Scheduled	데이터 세트 새로 고침 일정 설정에 의해 새로 고침이 트리거되었습니다.
OnDemand	새로 고침이 Power BI 포털을 통해 대화형으로 트리거되었습니다.
ViaApi	새로 고침이 API 호출에 의해 트리거되었습니다.
ViaXmlaEndpoint	Power BI 공용 XMLA 엔드포인트를 통해 새로 고침이 트리거되었습니다.
ViaEnhancedApi	새로 고침이 향상된 새로 고침 REST API 호출에 의해 트리거되었습니다.
OnDemandTraining	자동 집계 학습을 사용하여 Power BI 포털을 통해 대화형으로 새로 고침이 트리거되었습니다.

ScheduleNotifyOption

열거형

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

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

TenantKey

Object

암호화 키 정보

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

다음을 통해 공유

Capacities - Get Refreshables

필수 범위

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