Admin - Get Refreshable For Capacity

Başvuru

Service:: Power BI REST APIs

API Version:: v1.0

Kullanıcının erişimi olan belirtilen kapasite için belirtilen yenilenebilir değeri 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 korur.

İzinler

Kullanıcının yönetici haklarına (Office 365 Genel Yönetici veya Power BI Hizmet Yöneticisi gibi) sahip 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 uygulamanın Azure portal Power BI için yönetici onayı için gerekli izinlere sahip olmaması gerekir.

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.

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

With optional parameters:

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
capacityId	path	True	string uuid	Kapasite kimliği
refreshableId	path	True	string	Yenilenebilir kimlik
$expand	query		string	Yanıtta satır içi olarak genişletilecek veri türlerinin virgülle ayrılmış listesini kabul eder. ve 'i `groups`destekler`capacities`.

Yanıtlar

Name	Tür	Description
200 OK	Refreshables	Tamam

Örnekler

Example

Get a refreshable with its 'capacity' and 'group' expanded example

Example

Sample Request

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

Sample Response

Status code:: 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 a refreshable with its 'capacity' and 'group' expanded example

Sample Request

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

Sample Response

Status code:: 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 kapasite üzerinde sahip olduğu erişim hakkı
days	Yenilemenin yürütüldiği günler
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şulların ikisini de 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 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ştığında otomatik olarak bir veri kümesini yenilemek için 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 sürüyor
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 kapasite üzerinde 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ı katkıda bulunan haklarına sahiptir ve kapasiteye çalışma alanları atayabilir
None	string	Kullanıcının kapasiteye erişimi yok

days

Yenilemenin yürütüldiği günler

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şulların ikisini de 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 korur.

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 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	Veri kümesi

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ştığında otomatik olarak bir veri kümesini yenilemek için 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 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 işlemi 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üldiği günler
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ı aracılığıyla etkileşimli olarak tetiklendi
OnDemandTraining	string	Yenileme, otomatik toplama 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 değeri destekler NoNotification .

Name	Tür	Description
MailOnFailure	string	Yenileme hatasında 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ş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 ş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

Admin - Get Refreshable For Capacity

İzinler

Gerekli Kapsam

URI Parametreleri

Yanıtlar

Örnekler

Example

Sample Request

Sample Response

Get a refreshable with its 'capacity' and 'group' expanded example

Sample Request

Sample Response

Tanımlar

Capacity

CapacityState

capacityUserAccessRight

days

Refresh

Refreshable

RefreshableGroup

RefreshableKind

Refreshables

RefreshAttempt

RefreshAttemptType

RefreshSchedule

RefreshType

ScheduleNotifyOption

TenantKey

Ek kaynaklar