Udostępnij przez

Admin - WorkspaceInfo PostWorkspaceInfo

Usługa:
Power BI REST APIs
Wersja interfejsu API:
v1.0

Inicjuje wywołanie odbierania metadanych dla żądanej listy obszarów roboczych.

Ważne

Jeśli ustawisz datasetSchema parametry lub datasetExpressions na true, musisz w pełni włączyć skanowanie metadanych, aby dane zostały zwrócone. Aby uzyskać więcej informacji, zobacz Włączanie ustawień dzierżawy na potrzeby skanowania metadanych.

Permissions

Użytkownik musi być administratorem sieci szkieletowej lub uwierzytelniać się przy użyciu jednostki usługi.

W przypadku uruchamiania w ramach uwierzytelniania jednostki usługi aplikacja nie może mieć żadnych uprawnień wymaganych przez administratora dla usługi Power BI ustawionej w witrynie Azure Portal.

Wymagany zakres

Tenant.Read.All lub Tenant.ReadWrite.All

Istotne tylko w przypadku uwierzytelniania za pośrednictwem standardowego delegowanego tokenu dostępu administratora. Nie może być obecny, gdy jest używane uwierzytelnianie za pośrednictwem jednostki usługi.

Ograniczenia

  • Maksymalna liczba żądań 500 na godzinę.
  • Maksymalnie 16 równoczesnych żądań. 

POST https://api.powerbi.com/v1.0/myorg/admin/workspaces/getInfo
Z parametrami opcjonalnymi: 
POST https://api.powerbi.com/v1.0/myorg/admin/workspaces/getInfo?lineage={lineage}&datasourceDetails={datasourceDetails}&datasetSchema={datasetSchema}&datasetExpressions={datasetExpressions}&getArtifactUsers={getArtifactUsers}

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
datasetExpressions
 query

boolean

Czy zwracać wyrażenia zestawu danych (zapytania języka DAX i Mashup). Jeśli ustawisz ten parametr na truewartość , musisz w pełni włączyć skanowanie metadanych w celu zwrócenia danych. Aby uzyskać więcej informacji, zobacz Włączanie ustawień dzierżawy na potrzeby skanowania metadanych.
datasetSchema
 query

boolean

Czy zwracać schemat zestawu danych (tabele, kolumny i miary). Jeśli ustawisz ten parametr na truewartość , musisz w pełni włączyć skanowanie metadanych w celu zwrócenia danych. Aby uzyskać więcej informacji, zobacz Włączanie ustawień dzierżawy na potrzeby skanowania metadanych.
datasourceDetails
 query

boolean

Czy zwracać szczegóły źródła danych
getArtifactUsers
 query

boolean

Czy zwracać szczegóły użytkownika dla elementu usługi Power BI (np. raportu lub pulpitu nawigacyjnego)
lineage
 query

boolean

Czy zwracać informacje o pochodzenia danych (nadrzędne przepływy danych, kafelki, identyfikatory źródeł danych)

Treść żądania

Nazwa Typ Opis
workspaces

string[] (uuid)

Wymagane identyfikatory obszarów roboczych do skanowania (obsługuje od 1 do 100 identyfikatorów obszarów roboczych)

Odpowiedzi

Nazwa Typ Opis
202 Accepted

ScanRequest

Akceptowane

Przykłady

Example

Przykładowe żądanie

POST https://api.powerbi.com/v1.0/myorg/admin/workspaces/getInfo?lineage=True&datasourceDetails=True&datasetSchema=True&datasetExpressions=True
Treść żądania
{
  "workspaces": [
    "97d03602-4873-4760-b37e-1563ef5358e3",
    "67b7e93a-3fb3-493c-9e41-2c5051008f24"
  ]
}

Przykładowa odpowiedź

Kod stanu:
202 
{
  "id": "e7d03602-4873-4760-b37e-1563ef5358e3",
  "createdDateTime": "2020-06-15T16:46:28.0487687Z",
  "status": "NotStarted"
}

Definicje

Nazwa Opis
PowerBIApiErrorResponseDetail

Szczegółowe informacje o odpowiedzi na błędy usługi Power BI
RequiredWorkspaces

Żądanie wymaganych obszarów roboczych
ScanRequest

Żądanie skanowania

PowerBIApiErrorResponseDetail

Objekt

Szczegółowe informacje o odpowiedzi na błędy usługi Power BI

Nazwa Typ Opis
code

string

Kod błędu
message

string

Komunikat o błędzie
target

string

Cel błędu

RequiredWorkspaces

Objekt

Żądanie wymaganych obszarów roboczych

Nazwa Typ Opis
workspaces

string[] (uuid)

Wymagane identyfikatory obszarów roboczych do skanowania (obsługuje od 1 do 100 identyfikatorów obszarów roboczych)

ScanRequest

Objekt

Żądanie skanowania

Nazwa Typ Opis
createdDateTime

string (date-time)

Data i godzina utworzenia skanowania
error

PowerBIApiErrorResponseDetail

Błąd skanowania (jeśli istnieje)
id

string (uuid)

Identyfikator skanowania
status

string

Stan skanowania