Datasets - Get Refresh History In Group
Belirtilen çalışma alanından belirtilen veri kümesinin yenileme geçmişini döndürür.
İzinler
Bu API çağrısı bir hizmet sorumlusu profili tarafından çağrılabilir. Daha fazla bilgi için bkz. Power BI Embedded hizmet sorumlusu profilleri.
Gerekli Kapsam
Dataset.ReadWrite.All veya Dataset.Read.All
Sınırlamalar
OneDrive yenileme geçmişi döndürülmedi.
GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/refreshes
GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/refreshes?$top={$top}
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
dataset
|
path | True |
string |
Veri kümesi kimliği |
group
|
path | True |
string uuid |
Çalışma alanı kimliği |
$top
|
query |
integer |
Yenileme geçmişinde istenen girdi sayısı. Sağlanmadıysa, varsayılan değer kullanılabilir son 60 giriştir. |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Tamam |
Örnekler
Completed refresh example |
Failed refresh example |
In-progress refresh example |
Completed refresh example
Sample Request
GET https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes?$top=1
Sample Response
{
"value": [
{
"refreshType": "ViaApi",
"startTime": "2017-06-13T09:25:43.153Z",
"endTime": "2017-06-13T09:31:43.153Z",
"status": "Completed",
"requestId": "9399bb89-25d1-44f8-8576-136d7e9014b1",
"refreshAttempts": [
{
"attemptId": 1,
"startTime": "2017-06-13T09:25:43.153Z",
"endTime": "2017-06-13T09:31:40.153Z",
"type": "Data"
},
{
"attemptId": 1,
"startTime": "2017-06-13T09:31:40.156Z",
"endTime": "2017-06-13T09:31:43.153Z",
"type": "Query"
}
]
}
]
}
Failed refresh example
Sample Request
GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes?$top=1
Sample Response
{
"value": [
{
"refreshType": "ViaApi",
"startTime": "2017-06-13T09:25:43.153Z",
"endTime": "2017-06-13T09:31:43.153Z",
"serviceExceptionJson": "{\"errorCode\":\"ModelRefreshFailed_CredentialsNotSpecified\"}",
"status": "Failed",
"requestId": "11bf290a-346b-48b7-8973-c5df149337ff",
"refreshAttempts": [
{
"attemptId": 1,
"startTime": "2017-06-13T09:25:43.153Z",
"endTime": "2017-06-13T09:31:43.153Z",
"serviceExceptionJson": "{\"errorCode\":\"ModelRefreshFailed_CredentialsNotSpecified\"}",
"type": "Data"
}
]
}
]
}
In-progress refresh example
Sample Request
GET https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes?$top=1
Sample Response
{
"value": [
{
"refreshType": "ViaApi",
"startTime": "2017-06-13T09:25:43.153Z",
"status": "Unknown",
"requestId": "9399bb89-25d1-44f8-8576-136d7e9014b1"
}
]
}
Tanımlar
Name | Description |
---|---|
Refresh |
Power BI yenileme geçmişi girdisi |
Refresh |
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. |
Refresh |
Yenileme denemesinin türü. |
Refreshes |
Power BI yenileme geçmişi listesi için OData yanıt sarmalayıcısı |
Refresh |
Yenileme isteğinin türü |
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 |
Yenileme denemesi listesi. |
|
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 |
|
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 |
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 |
Refreshes
Power BI yenileme geçmişi listesi için OData yanıt sarmalayıcısı
Name | Tür | Description |
---|---|---|
odata.context |
string |
|
value |
Refresh[] |
Yenileme geçmişi listesi |
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 |