Capacities - Get Refreshables

Başvuru

Hizmet:: Power BI REST APIs

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

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

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

Gerekli Kapsam

Capacity.Read.All veya Capacity.ReadWrite.All

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

İsteğe bağlı parametrelerle:

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
$top	query	True	integer int32	Yalnızca ilk n sonucu döndürür.
$expand	query		string	Yanıtta satır içi olarak genişletilecek veri türlerinin virgülle ayrılmış listesini kabul eder. ve 'i `group`destekler`capacity`.
$filter	query		string	Sonuçları boole koşuluna göre filtreler
$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/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/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/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ış yenileme olmak üzere yedi günlük yenileme geçmişini tutar.
RefreshableGroup	Yenilenebilir öğeyle ilişkilendirilmiş bir Power BI grubu
RefreshableKind	Yenilenebilir tür
Refreshables	Power BI yenilenebilir öğeler listesi
RefreshAttempt	Power BI, yenileme hatasıyla karşılaştığında 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 değeri destekler `NoNotification` .
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	Desteklenmeyen
PreSuspended	string	Desteklenmeyen
ProvisionFailed	string	Kapasite sağlanamadı
Provisioning	string	Kapasitenin etkinleştirilmesi devam ediyor
Suspended	string	Kapasite 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	`Unknown` tamamlanma durumu bilinmiyorsa veya yenileme devam ediyorsa. `Completed` başarıyla tamamlanan bir yenileme için. `Failed` başarısız bir yenileme için (`serviceExceptionJson` hata kodunu içerir). `Disabled` yenileme seçmeli yenileme tarafından devre dışı bırakılırsa.

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ış yenileme olmak üzere yedi günlük yenileme geçmişini tutar.

Name	Tür	Description
averageDuration	number	Yenileme verilerinin bulunduğu zaman penceresinde 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 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 mevcut olduğ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	Veri kümesi

Refreshables

Power BI yenilenebilir öğeler listesi

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

RefreshAttempt

Power BI, yenileme hatasıyla karşılaştığında 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 hata kodu. Hata yoksa geçersiz olur.
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üklemeyi dener.
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 değeri destekler `NoNotification` .
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[]	Yenilemeyi yürütmek 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 toplama eğitimiyle Power BI portalı üzerinden etkileşimli olarak tetiklendi
Scheduled	string	Yenileme bir veri kümesi yenileme zamanlaması ayarı tarafından tetiklendi
ViaApi	string	Yenileme bir API çağrısı tarafından tetiklendi
ViaEnhancedApi	string	Yenileme, gelişmiş bir yenileme REST API çağrısıyla 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 değeri destekler NoNotification .

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

TenantKey

Şifreleme anahtarı bilgileri

Name	Tür	Description
createdAt	string	Şifreleme anahtarının oluşturulma 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 ş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ş

Capacities - Get Refreshables

Gerekli Kapsam

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