Admin - Get Refreshables For Capacity

Başvuru

Hizmet:: Power BI REST APIs

API Sürümü:: v1.0

Kullanıcının erişimi olan belirtilen kapasite için yenilenebilir öğeler listesini döndürür.

Power BI, her veri kümesi için en fazla altmış yenilemeye kadar yedi günlük yenileme geçmişini korur.

İzinler

Kullanıcının Doku yöneticisi olması veya hizmet sorumlusu kullanarak kimlik doğrulaması yapması gerekir.
Temsilci izinleri desteklenir.

Hizmet özel kimlik doğrulaması altında çalıştırılırken, bir uygulama Azure portalında Power BI için yönetici onayı gerekli izinlerin ayarlanmaması.

Gerekli Kapsam

Tenant.Read.All veya Tenant.ReadWrite.All

Yalnızca standart bir yönetici temsilcisi erişim belirteci aracılığıyla kimlik doğrulaması yaparken geçerlidir. Hizmet sorumlusu aracılığıyla kimlik doğrulaması kullanıldığında mevcut olmamalıdır.

Sınırlama

Saatte en fazla 200 istek.

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

İsteğe bağlı parametrelerle:

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
capacityId	path	True	string uuid	Kapasite kimliği
$top	query	True	integer int32	Yalnızca ilk n sonucu döndürür.
$expand	query		string	Yanıtta satır içinde genişletilecek veri türlerinin virgülle ayrılmış listesini kabul eder. `capacities` ve `groups`destekler.
$filter	query		string	Odata filtre sorgusu parametre koşuluna göre sonuçların bir alt kümesini döndürür.
$skip	query		integer int32	İlk n sonucu atlar. İlk 1000'in ötesinde sonuçları getirmek için üst ile birlikte kullanın.

Yanıtlar

Name	Tür	Description
200 OK	Refreshables	TAMAM

Örnekler

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

Örnek isteği

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

Örnek yanıt

Durum kodu:: 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.

Örnek isteği

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

Örnek yanıt

Durum kodu:: 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

Örnek isteği

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

Örnek yanıt

Durum kodu:: 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"
      }
    }
  ]
}

Tanımlar

Name	Description
Capacity	Power BI kapasitesi
CapacityState	Kapasite durumu
capacityUserAccessRight	Kullanıcının kapasitede sahip olduğu erişim hakkı
days	Yenilemenin yürütülecek gün sayısı
Refresh	Power BI yenileme geçmişi girdisi
Refreshable	Power BI yenilenebilir, en az bir kez yenilenen veya geçerli bir yenileme zamanlaması bulunan bir veri kümesidir. Bir veri kümesi bu koşullardan herhangi birini karşılamıyorsa API yanıtında gösterilmez. Power BI, her veri kümesi için en fazla altmış yenilemeye kadar yedi günlük yenileme geçmişini korur.
RefreshableGroup	Yenilenebilir öğeyle ilişkilendirilmiş bir Power BI grubu
RefreshableKind	Yenilenebilir tür
Refreshables	Power BI yenilenebilirler listesi
RefreshAttempt	Power BI, yenileme hatasıyla karşılaşırsa otomatik olarak bir veri kümesini yenilemeye yönelik birden çok girişimde bulunur. Bu nesne, her yenileme girişimi hakkında bilgi içerir.
RefreshAttemptType	Yenileme denemesinin türü.
RefreshSchedule	İçeri aktarılan model için Power BI yenileme zamanlaması
RefreshType	Yenileme isteğinin türü
ScheduleNotifyOption	Zamanlanmış yenilemenin sonlandırılmasına ilişkin bildirim seçeneği. Hizmet sorumluları yalnızca `NoNotification` değerini destekler.
TenantKey	Şifreleme anahtarı bilgileri

Capacity

Power BI kapasitesi

Name	Tür	Description
admins	string[]	Kapasite yöneticileri dizisi
capacityUserAccessRight	capacityUserAccessRight	Kullanıcının kapasitede sahip olduğu erişim hakkı
displayName	string	Kapasitenin görünen adı
id	string	Kapasite kimliği
region	string	Kapasitenin sağlandığı Azure bölgesi
sku	string	Kapasite SKU'su
state	CapacityState	Kapasite durumu
tenantKey	TenantKey	Şifreleme anahtarı bilgileri (yalnızca yönetici yolları için geçerlidir)
tenantKeyId	string	Şifreleme anahtarının kimliği (yalnızca yönetici yolu için geçerlidir)

CapacityState

Kapasite durumu

Name	Tür	Description
Active	string	Kapasite kullanıma hazır
Deleted	string	Kapasite silindi ve kullanılamıyor
Deleting	string	Kapasite silme işlemi devam ediyor
Invalid	string	Kapasite kullanılamıyor
NotActivated	string	Desteklenme -yen
PreSuspended	string	Desteklenme -yen
ProvisionFailed	string	Kapasite sağlanamadı
Provisioning	string	Kapasitenin etkinleştirilmesi devam ediyor
Suspended	string	Kapasitenin kullanımı askıya alındı
UpdatingSku	string	Kapasite SKU'su değişikliği devam ediyor

capacityUserAccessRight

Kullanıcının kapasitede sahip olduğu erişim hakkı

Name	Tür	Description
Admin	string	Kullanıcının kapasite üzerinde yönetici hakları var
Assign	string	Kullanıcının katkıda bulunan hakları vardır ve kapasiteye çalışma alanları atayabilir
None	string	Kullanıcının kapasiteye erişimi yok

days

Yenilemenin yürütülecek gün sayısı

Name	Tür	Description
Friday	string
Monday	string
Saturday	string
Sunday	string
Thursday	string
Tuesday	string
Wednesday	string

Refresh

Power BI yenileme geçmişi girdisi

Name	Tür	Description
endTime	string	Yenilemenin bitiş tarihi ve saati (yenileme devam ederse boş olabilir)
refreshAttempts	RefreshAttempt[]	Yenileme denemesi listesi.
refreshType	RefreshType	Yenileme isteğinin türü
requestId	string	Yenileme isteğinin tanımlayıcısı. Bu tanımlayıcıyı tüm hizmet isteklerinde sağlayın.
serviceExceptionJson	string	JSON biçiminde hata hata kodu (hata yoksa boş)
startTime	string	Yenilemenin başlangıç tarihi ve saati
status	string	Tamamlanma durumunun bilinmediğini veya yenilemenin devam etmekte olduğunu `Unknown`. Başarıyla tamamlanan yenileme için `Completed`. Başarısız bir yenileme için `Failed` (`serviceExceptionJson` hata kodunu içerir). Yenilemenin seçmeli yenilemeyle devre dışı bırakılıp bırakılmadığı `Disabled`.

Refreshable

Power BI yenilenebilir, en az bir kez yenilenen veya geçerli bir yenileme zamanlaması bulunan bir veri kümesidir. Bir veri kümesi bu koşullardan herhangi birini karşılamıyorsa API yanıtında gösterilmez. Power BI, her veri kümesi için en fazla altmış yenilemeye kadar yedi günlük yenileme geçmişini korur.

Name	Tür	Description
averageDuration	number	Yenileme verilerinin bulunduğu zaman penceresi boyunca yenilemenin saniye cinsinden ortalama süresi
capacity	Capacity	Yenilenebilir öğenin kapasitesi
configuredBy	string[]	Yenilenebilir sahipler
endTime	string	Yenileme verilerinin bulunduğu pencerenin bitiş saati
group	RefreshableGroup	Yenilenebilir öğe için ilişkili grup
id	string	Yenilenebilir nesnenin nesne kimliği
kind	RefreshableKind	Yenilenebilir tür
lastRefresh	Refresh	Yenilenebilir öğe için son Power BI yenileme geçmişi girdisi
medianDuration	number	Yenileme verilerinin bulunduğu zaman penceresinde yenilemenin saniye cinsinden ortanca süresi
name	string	Yenilenebilir öğesinin görünen adı
refreshCount	integer	Yenileme verilerinin bulunduğu zaman penceresindeki yenileme sayısı
refreshFailures	integer	Yenileme verilerinin bulunduğu zaman penceresindeki yenileme hatası sayısı
refreshSchedule	RefreshSchedule	Yenilenebilir öğe için yenileme zamanlaması
refreshesPerDay	integer	Yenileme verilerinin bulunduğu zaman penceresindeki günlük yenileme sayısı (zamanlanmış ve isteğe bağlı)
startTime	string	Yenileme verilerinin bulunduğu pencerenin başlangıç saati

RefreshableGroup

Yenilenebilir öğeyle ilişkilendirilmiş bir Power BI grubu

Name	Tür	Description
id	string	Çalışma alanı kimliği
name	string	Grup adı

RefreshableKind

Yenilenebilir tür

Name	Tür	Description
Dataset	string	Dataset

Refreshables

Power BI yenilenebilirler listesi

Name	Tür	Description
odata.context	string	OData bağlamı
value	Refreshable[]	Yenilenebilir öğeler

RefreshAttempt

Power BI, yenileme hatasıyla karşılaşırsa otomatik olarak bir veri kümesini yenilemeye yönelik birden çok girişimde bulunur. Bu nesne, her yenileme girişimi hakkında bilgi içerir.

Name	Tür	Description
attemptId	integer	Yenileme denemesinin dizini.
endTime	string	Yenileme denemesinin bitiş tarihi ve saati. Yenileme denemesi devam ederse değer geçersiz olur.
serviceExceptionJson	string	JSON biçiminde hata hatası kodu. Hata yoksa geçersiz.
startTime	string	Yenileme denemesinin başlangıç tarihi ve saati.
type	RefreshAttemptType	Yenileme denemesinin türü.

RefreshAttemptType

Yenileme denemesinin türü.

Name	Tür	Description
Data	string	Yenileme, veri kümesine veri yükleme girişiminde bulunur.
Query	string	Premium sorgu önbelleklerini ve pano kutucuklarını yenileme girişimi.u

RefreshSchedule

İçeri aktarılan model için Power BI yenileme zamanlaması

Name	Tür	Description
NotifyOption	ScheduleNotifyOption	Zamanlanmış yenilemenin sonlandırılmasına ilişkin bildirim seçeneği. Hizmet sorumluları yalnızca `NoNotification` değerini destekler.
days	days[]	Yenilemenin yürütülecek gün sayısı
enabled	boolean	Yenilemenin etkinleştirilip etkinleştirilmediği
localTimeZoneId	string	Kullanılacak saat diliminin kimliği. Daha fazla bilgi için bkz. Saat dilimi bilgileri.
times	string[]	Yenilemenin yürütülmek için günün saatleri

RefreshType

Yenileme isteğinin türü

Name	Tür	Description
OnDemand	string	Yenileme, Power BI portalı üzerinden etkileşimli olarak tetiklendi
OnDemandTraining	string	Yenileme, otomatik toplamalar eğitimiyle Power BI portalı üzerinden etkileşimli olarak tetiklendi
Scheduled	string	Yenileme, veri kümesi yenileme zamanlaması ayarı tarafından tetiklendi
ViaApi	string	Yenileme bir API çağrısı tarafından tetiklendi
ViaEnhancedApi	string	Yenileme, geliştirilmiş bir yenileme REST API çağrısı tarafından tetiklendi
ViaXmlaEndpoint	string	Yenileme, Power BI genel XMLA uç noktası aracılığıyla tetiklendi

ScheduleNotifyOption

Zamanlanmış yenilemenin sonlandırılmasına ilişkin bildirim seçeneği. Hizmet sorumluları yalnızca NoNotification değerini destekler.

Name	Tür	Description
MailOnFailure	string	Yenileme hatasında bir posta bildirimi gönderilecek
NoNotification	string	Bildirim gönderilmez

TenantKey

Şifreleme anahtarı bilgileri

Name	Tür	Description
createdAt	string	Şifreleme anahtarının oluşturma tarihi ve saati
id	string	Şifreleme anahtarının kimliği
isDefault	boolean	Şifreleme anahtarının kiracının tamamı için varsayılan anahtar olup olmadığı. Yeni oluşturulan tüm kapasiteler varsayılan anahtarı devralır.
keyVaultKeyIdentifier	string	Azure Key Vault'ta şifreleme anahtarını benzersiz olarak belirten URI
name	string	Şifreleme anahtarının adı
updatedAt	string	Şifreleme anahtarının son güncelleştirme tarihi ve saati

Aracılığıyla paylaş

Admin - Get Refreshables For Capacity

İzinler

Gerekli Kapsam

Sınırlama

URI Parametreleri

Yanıtlar

Örnekler

Example

Örnek isteği

Örnek yanıt

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

Örnek isteği

Örnek yanıt

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

Örnek isteği

Örnek yanıt

Tanımlar

Capacity

CapacityState

capacityUserAccessRight

days

Refresh

Refreshable

RefreshableGroup

RefreshableKind

Refreshables

RefreshAttempt

RefreshAttemptType

RefreshSchedule

RefreshType

ScheduleNotifyOption

TenantKey

Ek kaynaklar