Capacities - Get Refreshable For Capacity
Retourne l’actualisation spécifiée pour la capacité spécifiée à laquelle l’utilisateur a accès.
Power BI conserve un historique d’actualisation de sept jours pour chaque jeu de données, jusqu’à un maximum de soixante actualisations.
Étendue requise
Capacity.Read.All ou Capacity.ReadWrite.All
GET https://api.powerbi.com/v1.0/myorg/capacities/{capacityId}/refreshables/{refreshableId}
GET https://api.powerbi.com/v1.0/myorg/capacities/{capacityId}/refreshables/{refreshableId}?$expand={$expand}
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
capacity
|
path | True |
string uuid |
ID de capacité |
refreshable
|
path | True |
string |
ID actualisable |
$expand
|
query |
string |
Accepte une liste séparée par des virgules de types de données, qui sera développée inline dans la réponse. Prend en charge |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
Ok |
Exemples
Example |
Get refreshables with their 'capacity' and 'group' expanded example |
Example
Sample Request
GET https://api.powerbi.com/v1.0/myorg/capacities/{capacityId}/refreshables/{refreshableId}
Sample Response
{
"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 with their 'capacity' and 'group' expanded example
Sample Request
GET https://api.powerbi.com/v1.0/myorg/capacities/{capacityId}/refreshables/{refreshableId}?$expand=capacity,group
Sample Response
{
"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"
}
}
]
}
Définitions
Nom | Description |
---|---|
Capacity |
Une capacité Power BI |
Capacity |
État de la capacité |
capacity |
Droit d’accès dont dispose l’utilisateur sur la capacité |
days |
Jours pendant lesquels exécuter l’actualisation |
Refresh |
Une entrée d’historique d’actualisation Power BI |
Refreshable |
Un élément actualisable Power BI est un jeu de données qui a été actualisé au moins une fois ou pour lequel une planification d’actualisation valide existe. Si un jeu de données ne répond à aucune de ces conditions, il n’apparaît pas dans la réponse de l’API. Power BI conserve un historique d’actualisation de sept jours pour chaque jeu de données, jusqu’à un maximum de soixante actualisations. |
Refreshable |
Un groupe Power BI associé à un élément actualisable |
Refreshable |
Type actualisable |
Refreshables |
Liste des actualisables Power BI |
Refresh |
Power BI effectue automatiquement plusieurs tentatives d’actualisation d’un jeu de données en cas d’échec de l’actualisation. Cet objet contient des informations sur chaque tentative d’actualisation. |
Refresh |
Type de tentative d’actualisation. |
Refresh |
Planification de l’actualisation de Power BI pour le modèle importé |
Refresh |
Type de demande d’actualisation |
Schedule |
Option de notification lors de l’arrêt d’une actualisation planifiée. Les principaux de service prennent uniquement en charge la |
Tenant |
Informations sur la clé de chiffrement |
Capacity
Une capacité Power BI
Nom | Type | Description |
---|---|---|
admins |
string[] |
Tableau d’administrateurs de capacité |
capacityUserAccessRight |
Le droit d’accès d’un utilisateur sur la capacité |
|
displayName |
string |
Nom complet de la capacité |
id |
string |
ID de capacité |
region |
string |
Région Azure où la capacité a été provisionnée |
sku |
string |
Référence SKU de capacité |
state |
État de la capacité |
|
tenantKey |
Informations sur la clé de chiffrement (s’applique uniquement aux itinéraires d’administration) |
|
tenantKeyId |
string |
ID d’une clé de chiffrement (applicable uniquement à l’itinéraire administrateur) |
CapacityState
État de la capacité
Nom | Type | Description |
---|---|---|
Active |
string |
La capacité est prête à l’emploi |
Deleted |
string |
La capacité a été supprimée et n’est pas disponible |
Deleting |
string |
La suppression de la capacité est en cours |
Invalid |
string |
La capacité ne peut pas être utilisée |
NotActivated |
string |
Non pris en charge |
PreSuspended |
string |
Non pris en charge |
ProvisionFailed |
string |
Échec de l’approvisionnement de la capacité |
Provisioning |
string |
L’activation de la capacité est en cours |
Suspended |
string |
L’utilisation de la capacité est suspendue |
UpdatingSku |
string |
Un changement de référence SKU de capacité est en cours |
capacityUserAccessRight
Droit d’accès dont dispose l’utilisateur sur la capacité
Nom | Type | Description |
---|---|---|
Admin |
string |
L’utilisateur dispose de droits d’administrateur sur la capacité |
Assign |
string |
L’utilisateur dispose de droits contributeur et peut affecter des espaces de travail à la capacité |
None |
string |
L’utilisateur n’a pas accès à la capacité |
days
Jours pendant lesquels exécuter l’actualisation
Nom | Type | Description |
---|---|---|
Friday |
string |
|
Monday |
string |
|
Saturday |
string |
|
Sunday |
string |
|
Thursday |
string |
|
Tuesday |
string |
|
Wednesday |
string |
Refresh
Une entrée d’historique d’actualisation Power BI
Nom | Type | Description |
---|---|---|
endTime |
string |
Date et heure de fin de l’actualisation (peut être vide si une actualisation est en cours) |
refreshAttempts |
Liste des tentatives d’actualisation. |
|
refreshType |
Type de demande d’actualisation |
|
requestId |
string |
Identificateur de la demande d’actualisation. Fournissez cet identificateur dans toutes les demandes de service. |
serviceExceptionJson |
string |
Code d’erreur d’échec au format JSON (vide si aucune erreur) |
startTime |
string |
Date et heure de début de l’actualisation |
status |
string |
|
Refreshable
Un élément actualisable Power BI est un jeu de données qui a été actualisé au moins une fois ou pour lequel une planification d’actualisation valide existe. Si un jeu de données ne répond à aucune de ces conditions, il n’apparaît pas dans la réponse de l’API. Power BI conserve un historique d’actualisation de sept jours pour chaque jeu de données, jusqu’à un maximum de soixante actualisations.
Nom | Type | Description |
---|---|---|
averageDuration |
number |
Durée moyenne en secondes d’une actualisation pendant la fenêtre de temps pour laquelle des données d’actualisation existent |
capacity |
Capacité de l’élément actualisable |
|
configuredBy |
string[] |
Propriétaires actualisables |
endTime |
string |
Heure de fin de la fenêtre pour laquelle des données d’actualisation existent |
group |
Groupe associé pour l’élément actualisable |
|
id |
string |
ID d’objet de l’objet actualisable |
kind |
Type actualisable |
|
lastRefresh |
Dernière entrée d’historique d’actualisation Power BI pour l’élément actualisable |
|
medianDuration |
number |
Durée médiane en secondes d’une actualisation dans la fenêtre de temps pour laquelle des données d’actualisation existent |
name |
string |
Nom complet de l’actualisable |
refreshCount |
integer |
Nombre d’actualisations dans la fenêtre de temps pour laquelle des données d’actualisation existent |
refreshFailures |
integer |
Nombre d’échecs d’actualisation dans la fenêtre de temps pour laquelle des données d’actualisation existent |
refreshSchedule |
Planification de l’actualisation de l’élément actualisable |
|
refreshesPerDay |
integer |
Nombre d’actualisations par jour (planifiées et à la demande) dans la fenêtre de temps pour laquelle des données d’actualisation existent |
startTime |
string |
Heure de début de la fenêtre pour laquelle les données d’actualisation existent |
RefreshableGroup
Un groupe Power BI associé à un élément actualisable
Nom | Type | Description |
---|---|---|
id |
string |
L’ID de l’espace de travail |
name |
string |
Nom du groupe |
RefreshableKind
Type actualisable
Nom | Type | Description |
---|---|---|
Dataset |
string |
Dataset |
Refreshables
Liste des actualisables Power BI
Nom | Type | Description |
---|---|---|
odata.context |
string |
Contexte OData |
value |
Les actualisables |
RefreshAttempt
Power BI effectue automatiquement plusieurs tentatives d’actualisation d’un jeu de données en cas d’échec de l’actualisation. Cet objet contient des informations sur chaque tentative d’actualisation.
Nom | Type | Description |
---|---|---|
attemptId |
integer |
Index de la tentative d’actualisation. |
endTime |
string |
Date et heure de fin de la tentative d’actualisation. La valeur est void si la tentative d’actualisation est en cours. |
serviceExceptionJson |
string |
Code d’erreur d’échec au format JSON. Void s’il n’y a pas d’erreur. |
startTime |
string |
Date et heure de début de la tentative d’actualisation. |
type |
Type de tentative d’actualisation. |
RefreshAttemptType
Type de tentative d’actualisation.
Nom | Type | Description |
---|---|---|
Data |
string |
Tentative d’actualisation pour charger des données dans le jeu de données. |
Query |
string |
Tentative d’actualisation des caches de requêtes Premium et des vignettes de tableau de bord.u |
RefreshSchedule
Planification de l’actualisation de Power BI pour le modèle importé
Nom | Type | Description |
---|---|---|
NotifyOption |
Option de notification lors de l’arrêt d’une actualisation planifiée. Les principaux de service prennent uniquement en charge la |
|
days |
days[] |
Jours pendant lesquels exécuter l’actualisation |
enabled |
boolean |
Indique si l’actualisation est activée |
localTimeZoneId |
string |
ID du fuseau horaire à utiliser. Pour plus d’informations, consultez Informations sur les fuseaux horaires. |
times |
string[] |
Heures de la journée pour exécuter l’actualisation |
RefreshType
Type de demande d’actualisation
Nom | Type | Description |
---|---|---|
OnDemand |
string |
L’actualisation a été déclenchée de manière interactive via le portail Power BI |
OnDemandTraining |
string |
L’actualisation a été déclenchée de manière interactive via le portail Power BI avec la formation aux agrégations automatiques |
Scheduled |
string |
L’actualisation a été déclenchée par un paramètre de planification de l’actualisation du jeu de données |
ViaApi |
string |
L’actualisation a été déclenchée par un appel d’API |
ViaEnhancedApi |
string |
L’actualisation a été déclenchée par un appel d’API REST d’actualisation amélioré |
ViaXmlaEndpoint |
string |
L’actualisation a été déclenchée via le point de terminaison XMLA public Power BI |
ScheduleNotifyOption
Option de notification lors de l’arrêt d’une actualisation planifiée. Les principaux de service prennent uniquement en charge la NoNotification
valeur.
Nom | Type | Description |
---|---|---|
MailOnFailure |
string |
Une notification par e-mail est envoyée en cas d’échec d’actualisation |
NoNotification |
string |
Aucune notification ne sera envoyée |
TenantKey
Informations sur la clé de chiffrement
Nom | Type | Description |
---|---|---|
createdAt |
string |
Date et heure de création de la clé de chiffrement |
id |
string |
ID de la clé de chiffrement |
isDefault |
boolean |
Indique si la clé de chiffrement est la clé par défaut pour l’ensemble du locataire. Toute capacité nouvellement créée hérite de la clé par défaut. |
keyVaultKeyIdentifier |
string |
URI qui spécifie de manière unique la clé de chiffrement dans Azure Key Vault |
name |
string |
Nom de la clé de chiffrement |
updatedAt |
string |
Date et heure de la dernière mise à jour de la clé de chiffrement |