Admin - Imports GetImportsAsAdmin

  • Reference
Service:
Power BI REST APIs
API Version:
v1.0

Vrátí seznam importů pro organizaci.

Oprávnění

  • Uživatel musí mít oprávnění správce (například Office 365 globálního správce nebo správce služby Power BI) nebo ověřování pomocí instančního objektu.
  • Delegovaná oprávnění jsou podporovaná.

Při spuštění v rámci původního ověřování služby nesmí mít aplikace v Azure Portal nastavená žádná oprávnění vyžadovaná správcem pro Power BI.

Požadovaný obor

Tenant.Read.All nebo Tenant.ReadWrite.All

Relevantní pouze při ověřování prostřednictvím standardního delegovaného přístupového tokenu správce. Nesmí být k dispozici při použití ověřování prostřednictvím instančního objektu.

Omezení

Maximálně 200 požadavků za hodinu. 

GET https://api.powerbi.com/v1.0/myorg/admin/imports
With optional parameters: 
GET https://api.powerbi.com/v1.0/myorg/admin/imports?$expand={$expand}&$filter={$filter}&$top={$top}&$skip={$skip}

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
$expand
 query

string

Rozbalí vložené související entity.
$filter
 query

string

Filtruje výsledky na základě logické podmínky.
$skip
 query

integer

int32

Přeskočí prvních n výsledků.
$top
 query

integer

int32

Vrátí pouze prvních n výsledků.

Odpovědi

Name Typ Description
200 OK

Imports

OK

Příklady

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/imports

Sample Response

Status code:
200 
{
  "value": [
    {
      "id": "82d9a37a-2b45-4221-b012-cb109b8e30c7",
      "importState": "Succeeded",
      "createdDateTime": "2018-05-08T14:56:18.477Z",
      "updatedDateTime": "2018-05-08T14:56:18.477Z",
      "name": "SalesMarketing",
      "connectionType": "import",
      "source": "Upload",
      "datasets": [
        {
          "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
          "name": "SalesMarketing",
          "webUrl": "https://app.powerbi.com/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229"
        }
      ],
      "reports": [
        {
          "id": "5b218778-e7a5-4d73-8187-f10824047715",
          "name": "SalesMarketing",
          "webUrl": "https://app.powerbi.com/reports/5b218778-e7a5-4d73-8187-f10824047715",
          "embedUrl": "https://app.powerbi.com/reportEmbed?reportId=5b218778-e7a5-4d73-8187-f10824047715"
        }
      ]
    }
  ]
}

Definice

Name Description
Dataset

Datová sada Power BI. Rozhraní API vrátí podmnožinu z následujícího seznamu vlastností datové sady. Podmnožina závisí na volaným rozhraní API, oprávněních volajícího a dostupnosti dat v databázi Power BI.
DatasetQueryScaleOutSettings

Dotaz na nastavení škálování datové sady na více instancí
DatasetUser

Položka přístupového práva uživatele Power BI pro datovou sadu
DatasetUserAccessRight

Přístupové právo, které má uživatel k datové sadě (úroveň oprávnění)
DependentDataflow

Tok dat závislý na Power BI
Encryption

Informace o šifrování datové sady
EncryptionStatus

Stav šifrování datové sady
Import

Objekt importu
Imports

Obálka odpovědi OData pro kolekci importu Power BI
PrincipalType

Typ objektu zabezpečení
Report

Sestava Power BI. Rozhraní API vrátí podmnožinu z následujícího seznamu vlastností sestavy. Podmnožina závisí na volaného rozhraní API, oprávněních volajícího a dostupnosti dat v databázi Power BI.
ReportUser

Položka přístupového práva uživatele Power BI pro sestavu
ReportUserAccessRight

Přístupové právo, které má uživatel k sestavě (úroveň oprávnění)
ServicePrincipalProfile

Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.
Subscription

Odběr e-mailu pro položku Power BI (například sestavu nebo řídicí panel)
SubscriptionUser

Uživatel e-mailového předplatného Power BI

Dataset

Datová sada Power BI. Rozhraní API vrátí podmnožinu z následujícího seznamu vlastností datové sady. Podmnožina závisí na volaným rozhraní API, oprávněních volajícího a dostupnosti dat v databázi Power BI.

Name Typ Description
ContentProviderType

string

Typ zprostředkovatele obsahu pro datovou sadu
CreateReportEmbedURL

string

Adresa URL pro vložení sestavy pro vytvoření datové sady
CreatedDate

string

Datum a čas vytvoření datové sady
Encryption

Encryption

Informace o šifrování datové sady. Platí pouze v případě, že $expand je zadáno.
IsEffectiveIdentityRequired

boolean

Jestli datová sada vyžaduje efektivní identitu, kterou musíte odeslat ve volání rozhraní API GenerateToken .
IsEffectiveIdentityRolesRequired

boolean

Určuje, jestli je v souboru .pbix Power BI definované zabezpečení na úrovni řádků. Pokud ano, musíte zadat roli.
IsInPlaceSharingEnabled

boolean

Jestli je možné datovou sadu sdílet s externími uživateli, aby ji mohli využívat ve svém vlastním tenantovi.
IsOnPremGatewayRequired

boolean

Jestli datová sada vyžaduje místní bránu dat
IsRefreshable

boolean

Jestli je datová sada aktualizovatelná nebo ne. Aktualizovatelná datová sada Power BI je datová sada, která se alespoň jednou aktualizovala nebo pro kterou existuje platný plán aktualizace.
QnaEmbedURL

string

Adresa URL pro vložení Q&A datové sady
addRowsAPIEnabled

boolean

Jestli datová sada umožňuje přidávat nové řádky
configuredBy

string

Vlastník datové sady
description

string

Popis datové sady
id

string

ID datové sady
name

string

Název datové sady
queryScaleOutSettings

DatasetQueryScaleOutSettings

Dotaz na nastavení škálování datové sady na více instancí
targetStorageMode

string

Režim úložiště datové sady
upstreamDataflows

DependentDataflow[]

Seznam všech toků dat, na které tato položka závisí
users

DatasetUser[]

(Prázdná hodnota) Podrobnosti o přístupu uživatele k datové sadě Tato vlastnost bude odebrána z odpovědi datové části v nadcházející verzi. Informace o uživatelích u položky Power BI (například sestavy nebo řídicího panelu) můžete načíst pomocí rozhraní API Get Dataset Users as Správa nebo rozhraní API PostWorkspaceInfo s parametrem getArtifactUsers .
webUrl

string

Webová adresa URL datové sady

DatasetQueryScaleOutSettings

Dotaz na nastavení škálování datové sady na více instancí

Name Typ Description
autoSyncReadOnlyReplicas

boolean

Jestli datová sada automaticky synchronizuje repliky jen pro čtení
maxReadOnlyReplicas

integer

Maximální počet replik jen pro čtení pro datovou sadu (0–64, -1 pro automatický počet replik)

DatasetUser

Položka přístupového práva uživatele Power BI pro datovou sadu

Name Typ Description
datasetUserAccessRight

DatasetUserAccessRight

Přístupové právo, které má uživatel k datové sadě (úroveň oprávnění)
displayName

string

Zobrazovaný název objektu zabezpečení
emailAddress

string

E-mailová adresa uživatele
graphId

string

Identifikátor objektu zabezpečení v Microsoft Graphu. K dispozici pouze pro rozhraní API pro správu.
identifier

string

Identifikátor objektu zabezpečení
principalType

PrincipalType

Typ objektu zabezpečení
profile

ServicePrincipalProfile

Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.
userType

string

Typ uživatele.

DatasetUserAccessRight

Přístupové právo, které má uživatel k datové sadě (úroveň oprávnění)

Name Typ Description
None

string

Odebere oprávnění k obsahu v datové sadě.
Read

string

Udělí oprávnění ke čtení obsahu v datové sadě.
ReadExplore

string

Udělí přístup ke čtení a prozkoumání obsahu v datové sadě.
ReadReshare

string

Uděluje přístup ke čtení a sdílení obsahu v datové sadě.
ReadReshareExplore

string

Uděluje přístup ke čtení, sdílení a prozkoumání obsahu v datové sadě.
ReadWrite

string

Uděluje přístup ke čtení a zápisu k obsahu v datové sadě.
ReadWriteExplore

string

Uděluje přístup ke čtení, zápisu a prozkoumání obsahu v datové sadě.
ReadWriteReshare

string

Uděluje přístup ke čtení, zápisu a sdílení obsahu v datové sadě.
ReadWriteReshareExplore

string

Uděluje přístup ke čtení, zápisu, sdílení a prozkoumání obsahu v datové sadě.

DependentDataflow

Tok dat závislý na Power BI

Name Typ Description
groupId

string

ID cílové skupiny
targetDataflowId

string

ID cílového toku dat

Encryption

Informace o šifrování datové sady

Name Typ Description
EncryptionStatus

EncryptionStatus

Stav šifrování datové sady

EncryptionStatus

Stav šifrování datové sady

Name Typ Description
InSyncWithWorkspace

string

Šifrování se podporuje a synchronizuje se s nastavením šifrování.
NotInSyncWithWorkspace

string

Šifrování se podporuje, ale není synchronizované s nastavením šifrování.
NotSupported

string

U této datové sady se nepodporuje šifrování.
Unknown

string

Stav šifrování je neznámý kvůli poškození datové sady.

Import

Objekt importu

Name Typ Description
createdDateTime

string

Datum a čas vytvoření importu
datasets

Dataset[]

Datové sady přidružené k tomuto importu
id

string

ID importu
importState enum:
  • Failed
  • Publishing
  • Succeeded

Stav nahrání importu
name

string

Název importu
reports

Report[]

Sestavy přidružené k tomuto importu
updatedDateTime

string

Importovat datum a čas poslední aktualizace

Imports

Obálka odpovědi OData pro kolekci importu Power BI

Name Typ Description
odata.context

string

Kontext OData
value

Import[]

Kolekce importu

PrincipalType

Typ objektu zabezpečení

Name Typ Description
App

string

Typ instančního objektu
Group

string

Typ objektu zabezpečení skupiny
None

string

Žádný typ objektu zabezpečení. Používá se pro přístup na úrovni celé organizace.
User

string

Typ objektu zabezpečení uživatele

Report

Sestava Power BI. Rozhraní API vrátí podmnožinu z následujícího seznamu vlastností sestavy. Podmnožina závisí na volaného rozhraní API, oprávněních volajícího a dostupnosti dat v databázi Power BI.

Name Typ Description
appId

string

ID aplikace, které se vrátí jenom v případě, že sestava patří aplikaci
datasetId

string

ID datové sady sestavy
description

string

Popis sestavy
embedUrl

string

Adresa URL pro vložení sestavy
id

string

ID sestavy
name

string

Název sestavy
originalReportId

string

Skutečné ID sestavy při publikování pracovního prostoru jako aplikace
reportType enum:
  • PaginatedReport
  • PowerBIReport

Typ sestavy
subscriptions

Subscription[]

(Prázdná hodnota) Podrobnosti o předplatném pro položku Power BI (například sestavu nebo řídicí panel). Tato vlastnost bude odebrána z odpovědi datové části v nadcházející verzi. Informace o předplatném pro sestavu Power BI můžete načíst pomocí volání Získat odběry sestav jako Správa rozhraní API.
users

ReportUser[]

(Prázdná hodnota) Podrobnosti o přístupu uživatele k sestavě Power BI Tato vlastnost bude odebrána z odpovědi datové části v nadcházející verzi. Informace o uživatelích v sestavě Power BI můžete načíst pomocí volání Rozhraní API Get Report Users as Správa nebo pomocí volání rozhraní API PostWorkspaceInfo s parametremgetArtifactUsers.
webUrl

string

Webová adresa URL sestavy

ReportUser

Položka přístupového práva uživatele Power BI pro sestavu

Name Typ Description
displayName

string

Zobrazovaný název objektu zabezpečení
emailAddress

string

E-mailová adresa uživatele
graphId

string

Identifikátor objektu zabezpečení v Microsoft Graphu. K dispozici pouze pro rozhraní API pro správu.
identifier

string

Identifikátor objektu zabezpečení
principalType

PrincipalType

Typ objektu zabezpečení
profile

ServicePrincipalProfile

Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.
reportUserAccessRight

ReportUserAccessRight

Přístupové právo, které má uživatel k sestavě (úroveň oprávnění)
userType

string

Typ uživatele.

ReportUserAccessRight

Přístupové právo, které má uživatel k sestavě (úroveň oprávnění)

Name Typ Description
None

string

Žádná oprávnění k obsahu v sestavě
Owner

string

Uděluje přístup ke čtení, zápisu a sdílení obsahu v sestavě.
Read

string

Uděluje oprávnění ke čtení obsahu v sestavě.
ReadCopy

string

Uděluje přístup ke čtení a kopírování obsahu v sestavě.
ReadReshare

string

Uděluje přístup ke čtení a opětovnému sdílení obsahu v sestavě.
ReadWrite

string

Uděluje přístup ke čtení a zápisu k obsahu v sestavě.

ServicePrincipalProfile

Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.

Name Typ Description
displayName

string

Název profilu instančního objektu
id

string

ID profilu instančního objektu

Subscription

Odběr e-mailu pro položku Power BI (například sestavu nebo řídicí panel)

Name Typ Description
artifactDisplayName

string

Název odebírané položky Power BI (například sestavy nebo řídicího panelu)
artifactId

string

ID odebírané položky Power BI (například sestavy nebo řídicího panelu)
artifactType

string

Typ položky Power BI (například Report, Dashboardnebo Dataset)
attachmentFormat

string

Formát sestavy připojené k odběru e-mailu
endDate

string

Koncové datum a čas odběru e-mailu
frequency

string

Frekvence odběru e-mailu
id

string

ID předplatného
isEnabled

boolean

Jestli je povolené předplatné e-mailu
linkToContent

boolean

Jestli v e-mailovém předplatném existuje odkaz na předplatné
previewImage

boolean

Jestli v odběru e-mailu existuje snímek obrazovky se sestavou
startDate

string

Počáteční datum a čas odběru e-mailu
subArtifactDisplayName

string

Název stránky odebírané položky Power BI, pokud se jedná o sestavu.
title

string

Název aplikace
users

SubscriptionUser[]

Podrobnosti o každém odběrateli e-mailu. Při použití volání rozhraní API Get User Subscriptions As Správa je vrácená hodnota prázdné pole (null). Tato vlastnost bude odebrána z odpovědi datové části v nadcházející verzi. Informace o předplatném sestavy nebo řídicího panelu Power BI můžete načíst pomocí volání rozhraní API Získat odběry sestav jako Správa nebo Získat odběry řídicích panelů jako Správa.

SubscriptionUser

Uživatel e-mailového předplatného Power BI

Name Typ Description
displayName

string

Zobrazovaný název objektu zabezpečení
emailAddress

string

E-mailová adresa uživatele
graphId

string

Identifikátor objektu zabezpečení v Microsoft Graphu. K dispozici pouze pro rozhraní API pro správu.
identifier

string

Identifikátor objektu zabezpečení
principalType

PrincipalType

Typ objektu zabezpečení
profile

ServicePrincipalProfile

Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.
userType

string

Typ uživatele.