Admin - Imports GetImportsAsAdmin

Služba:: Power BI REST APIs

Verze rozhraní API:: v1.0

Vrátí seznam importů pro organizaci.

Dovolení

Uživatel musí být správcem infrastruktury nebo se musí ověřit pomocí instančního objektu.
Delegovaná oprávnění jsou podporována.

Při spuštění v rámci ověřování prinicipal služby nesmí aplikace nesmí mít na webu Azure Portal nastavené žádné žádosti o udělení souhlasu správce 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. Při ověřování pomocí instančního objektu nesmí být k dispozici.

Omezení

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

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

S volitelnými parametry:

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

Parametry identifikátoru URI

Name	V	Typ	Description
$expand	query	string	Rozbalí související entity vložené do textu.
$filter	query	string	Vrátí podmnožinu výsledků na základě Odata podmínky parametru dotazu filtru.
$skip	query	integer (int32)	Přeskočí první n výsledků.
$top	query	integer (int32)	Vrátí pouze první n výsledků.

Odpovědi

Name	Typ	Description
200 OK	Imports	OK

Příklady

Example

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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 následujících vlastností datové sady. Podmnožina závisí na rozhraní API volaného, oprávnění volajícího a dostupnosti dat v databázi Power BI.
DatasetQueryScaleOutSettings	Dotazování na nastavení horizontálního navýšení kapacity datové sady
DatasetUser	Přístup uživatele Power BI ke správné položce pro datovou sadu
DatasetUserAccessRight	Přístupové právo, které má uživatel pro datovou sadu (ú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 následujících vlastností sestavy. Podmnožina závisí na rozhraní API volaného, oprávnění volajícího a dostupnosti dat v databázi Power BI.
ReportUser	Přístup uživatele Power BI ke správné položce pro sestavu
ReportUserAccessRight	Přístupové právo, které má uživatel pro sestavu (úroveň oprávnění)
ServicePrincipalProfile	Profil instančního objektu Power BI. Relevantní pouze pro víceklientské řešení Power BI Embedded.
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

Objekt

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

Name	Typ	Description
ContentProviderType	string	Zastaralá vlastnost, která by se měla ignorovat.
Encryption	Encryption	Informace o šifrování datové sady Platí pouze v případě, že je zadán `$expand`.
IsEffectiveIdentityRequired	boolean	Určuje, jestli datová sada vyžaduje efektivní identitu, kterou musíte odeslat ve volání rozhraní API GenerateToken.
IsEffectiveIdentityRolesRequired	boolean	Určuje, jestli je zabezpečení na úrovni řádků definováno v souboru Power BI .pbix. Pokud ano, musíte zadat roli.
IsInPlaceSharingEnabled	boolean	Určuje, jestli se datová sada dá sdílet s externími uživateli, kteří se mají využívat ve svém vlastním tenantovi.
IsOnPremGatewayRequired	boolean	Jestli datová sada vyžaduje místní bránu dat
IsRefreshable	boolean	Toto pole vrátí `true`, když se datová sada buď nedávno aktualizuje, nebo je nakonfigurovaná pro automatickou aktualizaci. Režim připojení je speciálně nastavený na Import. Hodnota vrátí `false` pro jiné režimy připojení, například DirectQuery a LiveConnection, bez ohledu na to, jestli se datová sada aktualizuje ručně nebo je nastavená pro automatickou aktualizaci.
addRowsAPIEnabled	boolean	Určuje, jestli datová sada umožňuje přidávat nové řádky.
configuredBy	string	Vlastník datové sady
createReportEmbedURL	string	Adresa URL pro vložení sestavy pro vytvoření datové sady
createdDate	string (date-time)	Datum a čas vytvoření datové sady
description	string	Popis datové sady
id	string	ID datové sady
name	string	Název datové sady
qnaEmbedURL	string	Adresa URL pro vložení Q&datové sady
queryScaleOutSettings	DatasetQueryScaleOutSettings	Dotazování na nastavení horizontálního navýšení kapacity datové sady
targetStorageMode	string	Režim úložiště datové sady
upstreamDataflows	DependentDataflow[]	Seznamvšechch
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živateli položky Power BI (například sestavy nebo řídicího panelu) můžete načíst pomocí rozhraní API Získat uživatele datové sady jako rozhraní API pro správu nebo rozhraní API PostWorkspaceInfo pomocí parametru `getArtifactUsers`.
webUrl	string	Webová adresa URL datové sady

DatasetQueryScaleOutSettings

Objekt

Dotazování na nastavení horizontálního navýšení kapacity datové sady

Name	Typ	Description
autoSyncReadOnlyReplicas	boolean	Jestli datová sada automaticky synchronizuje repliky jen pro čtení
maxReadOnlyReplicas	integer minimum: -1 maximum: 64	Maximální počet replik jen pro čtení pro datovou sadu (0–64, -1 pro automatický počet replik)

DatasetUser

Objekt

Přístup uživatele Power BI ke správné položce pro datovou sadu

Name	Typ	Description
datasetUserAccessRight	DatasetUserAccessRight	Přístupové právo, které má uživatel pro datovou sadu (ú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 instančního objektu Power BI. Relevantní pouze pro víceklientské řešení Power BI Embedded.
userType	string	Typ uživatele

DatasetUserAccessRight

Výčet

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

Hodnota	Description
None	Odebere oprávnění k obsahu v datové sadě.
Read	Uděluje přístup pro čtení k obsahu v datové sadě.
ReadWrite	Uděluje přístup pro čtení a zápis k obsahu v datové sadě.
ReadReshare	Uděluje přístup ke čtení a opětovnému sdílení obsahu v datové sadě.
ReadWriteReshare	Uděluje přístup ke čtení, zápisu a opětovnému sdílení obsahu v datové sadě.
ReadExplore	Uděluje přístup ke čtení a prozkoumání obsahu v datové sadě.
ReadReshareExplore	Uděluje přístup ke čtení, opětovnému sdílení a prozkoumání obsahu v datové sadě.
ReadWriteExplore	Uděluje přístup ke čtení, zápisu a prozkoumání obsahu v datové sadě.
ReadWriteReshareExplore	Uděluje přístup ke čtení, zápisu, opětovnému sdílení a prozkoumání přístupu k obsahu v datové sadě.

DependentDataflow

Objekt

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

Objekt

Informace o šifrování datové sady

Name	Typ	Description
EncryptionStatus	EncryptionStatus	Stav šifrování datové sady

EncryptionStatus

Výčet

Stav šifrování datové sady

Hodnota	Description
Unknown	Stav šifrování není znám kvůli poškození datové sady.
NotSupported	Pro tuto datovou sadu není podporováno šifrování.
InSyncWithWorkspace	Šifrování se podporuje a je synchronizované s nastavením šifrování.
NotInSyncWithWorkspace	Šifrování se podporuje, ale nesynchronizuje se s nastavením šifrování.

Import

Objekt

Objekt importu

Name	Typ	Description
createdDateTime	string (date-time)	Datum a čas vytvoření importu
datasets	Dataset[]	Datové sady přidružené k tomuto importu
id	string (uuid)	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 (date-time)	Import data a času poslední aktualizace

Imports

Objekt

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

Name	Typ	Description
@odata.context	string	Kontext OData
value	Import[]	Kolekce importu

PrincipalType

Výčet

Typ objektu zabezpečení

Hodnota	Description
None	Žádný typ objektu zabezpečení. Používá se pro přístup na úrovni celé organizace.
User	Typ objektu zabezpečení uživatele
Group	Typ objektu zabezpečení skupiny
App	Typ instančního objektu

Report

Objekt

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

Name	Typ	Description
appId	string	ID aplikace, vrácené pouze v případě, že sestava patří do aplikace
datasetId	string	ID datové sady sestavy
description	string	Popis sestavy
embedUrl	string	Adresa URL pro vložení sestavy
format	string	Typ formátu definice sestavy. Pro PowerBIReport: PBIR Starší verze PBIR Pro paginatedReport: `RDL`
id	string (uuid)	ID sestavy
isOwnedByMe	boolean	Určuje, zda má aktuální uživatel možnost upravit nebo vytvořit kopii sestavy.
name	string	Název sestavy Sestavy aplikací začínají předponou [App].
originalReportId	string (uuid)	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 předplatného 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 sestavy Power BI můžete načíst pomocí Získat odběry sestav jako volání rozhraní API pro správce.
users	ReportUser[]	(Prázdná hodnota) Podrobnosti o přístupu uživatele pro sestavu Power BI. Tato vlastnost bude odebrána z odpovědi datové části v nadcházející verzi. Informace o uživateli v sestavě Power BI můžete načíst pomocí volání rozhraní API Získat uživatele sestavy jako volání rozhraní API pro správu nebo volání rozhraní API PostWorkspaceInfo rozhraní API s parametrem `getArtifactUsers`.
webUrl	string	Webová adresa URL sestavy

ReportUser

Objekt

Přístup uživatele Power BI ke správné položce 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 instančního objektu Power BI. Relevantní pouze pro víceklientské řešení Power BI Embedded.
reportUserAccessRight	ReportUserAccessRight	Přístupové právo, které má uživatel pro sestavu (úroveň oprávnění)
userType	string	Typ uživatele

ReportUserAccessRight

Výčet

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

Hodnota	Description
None	Žádná oprávnění k obsahu v sestavě
Read	Uděluje přístup pro čtení k obsahu v sestavě.
ReadWrite	Uděluje přístup pro čtení a zápis k obsahu v sestavě.
ReadReshare	Uděluje přístup ke čtení a opětovnému sdílení obsahu v sestavě.
ReadCopy	Uděluje přístup ke čtení a kopírování obsahu v sestavě.
Owner	Uděluje přístup ke čtení, zápisu a opětovnému sdílení obsahu v sestavě.

ServicePrincipalProfile

Objekt

Profil instančního objektu Power BI. Relevantní pouze pro víceklientské řešení Power BI Embedded.

Name	Typ	Description
displayName	string	Název instančního profilu
id	string (uuid)	ID profilu instančního objektu

Subscription

Objekt

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 sestava nebo řídicí panel)
artifactId	string (uuid)	ID odebírané položky Power BI (například sestavy nebo řídicího panelu)
artifactType	string	Typ položky Power BI (například `Report`, `Dashboard`nebo `Dataset`)
attachmentFormat	string	Formát sestavy připojené k odběru e-mailu
endDate	string (date-time)	Koncové datum a čas odběru e-mailu
frequency	string	Frekvence odběru e-mailů
id	string (uuid)	ID předplatného
isEnabled	boolean	Jestli je povolené e-mailové předplatné
linkToContent	boolean	Jestli odkaz na odběr existuje v e-mailovém předplatném
previewImage	boolean	Jestli v odběru e-mailu existuje snímek obrazovky sestavy
startDate	string (date-time)	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í získání uživatelských předplatných jako správce volání rozhraní API 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 můžete načíst na sestavě nebo řídicím panelu Power BI pomocí Získat předplatná sestav jako správce nebo získat předplatná řídicích panelů jako volání rozhraní API pro správce.

SubscriptionUser

Objekt

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 instančního objektu Power BI. Relevantní pouze pro víceklientské řešení Power BI Embedded.
userType	string	Typ uživatele

Sdílet prostřednictvím

Admin - Imports GetImportsAsAdmin

Dovolení

Požadovaný obor

Omezení

Parametry identifikátoru URI

Odpovědi

Příklady

Example

Ukázkový požadavek

Ukázková odpověď

Definice

Dataset

DatasetQueryScaleOutSettings

DatasetUser

DatasetUserAccessRight

DependentDataflow

Encryption

EncryptionStatus

Import

Imports

PrincipalType

Report

ReportUser

ReportUserAccessRight

ServicePrincipalProfile

Subscription

SubscriptionUser