Admin - Get Refreshables

Hizmet:: Power BI REST APIs

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

Kapasite içindeki kuruluş 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/refreshables?$top={$top}

İsteğe bağlı parametrelerle:

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
$top	query	True	integer (int32) minimum: 1	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/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/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/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

Nesne

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 (uuid)	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 (uuid)	Şifreleme anahtarının kimliği (yalnızca yönetici yolu için geçerlidir)

CapacityState

Numaralandırma

Kapasite durumu

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

capacityUserAccessRight

Numaralandırma

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

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

days

Numaralandırma

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

Değer	Description
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday
Sunday

Refresh

Nesne

Power BI yenileme geçmişi girdisi

Name	Tür	Description
endTime	string (date-time)	Yenilemenin bitiş tarihi ve saati (yenileme devam ediyorsa boş olabilir) UTC biçimindedir.
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 (date-time)	Yenilemenin başlangıç tarihi ve saati UTC biçimindedir.
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

Nesne

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 (date-time)	Yenileme verilerinin UTC biçiminde 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 (date-time)	Yenileme verilerinin UTC biçiminde bulunduğu pencerenin başlangıç saati.

RefreshableGroup

Nesne

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

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

RefreshableKind

Numaralandırma

Yenilenebilir tür

Değer	Description
Dataset	Dataset

Refreshables

Nesne

Power BI yenilenebilirler listesi

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

RefreshAttempt

Nesne

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 (date-time)	Yenileme denemesinin bitiş tarihi ve saati. Yenileme denemesi devam ederse değer geçersiz olur.
executionMetrics	object[]	Yenileme girişimi sırasında yakalanan Analysis Services altyapısı yürütme ölçümleri.
serviceExceptionJson	string	JSON biçiminde hata hatası kodu. Hata yoksa geçersiz.
startTime	string (date-time)	Yenileme denemesinin başlangıç tarihi ve saati.
type	RefreshAttemptType	Yenileme denemesinin türü.

RefreshAttemptType

Numaralandırma

Yenileme denemesinin türü.

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

RefreshSchedule

Nesne

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

Name	Tür	Description
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.
notifyOption	ScheduleNotifyOption	Zamanlanmış yenilemenin sonlandırılmasına ilişkin bildirim seçeneği. Hizmet sorumluları yalnızca `NoNotification` değerini destekler.
times	string[]	Yenilemenin yürütülmek için günün saatleri

RefreshType

Numaralandırma

Yenileme isteğinin türü

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

ScheduleNotifyOption

Numaralandırma

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

Değer	Description
NoNotification	Bildirim gönderilmez
MailOnFailure	Yenileme hatasında bir posta bildirimi gönderilecek

TenantKey

Nesne

Şifreleme anahtarı bilgileri

Name	Tür	Description
createdAt	string (date-time)	Şifreleme anahtarının oluşturma tarihi ve saati
id	string (uuid)	Ş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 (date-time)	Şifreleme anahtarının son güncelleştirme tarihi ve saati

Aracılığıyla paylaş

Admin - Get Refreshables

İ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