Admin - WorkspaceInfo GetScanResult
Pobiera wynik skanowania dla określonego skanowania.
Wykonaj to wywołanie interfejsu API tylko po pomyślnym wywołaniu interfejsu API GetScanStatus. Wynik skanowania pozostanie dostępny przez 24 godziny.
Uprawnienia
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 aplikacji nie może mieć żadnych uprawnień wymaganych przez administratora dla usługi Power BI ustawionych 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ę.
GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/scanResult/{scanId}
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
scan
|
path | True |
string uuid |
Identyfikator skanowania, który jest uwzględniony w odpowiedzi z obszarów roboczych lub administratora — WorkspaceInfo PostWorkspaceInfo wywołanie interfejsu API, które wyzwoliło skanowanie. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
OK |
Przykłady
Example
Przykładowe żądanie
GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/scanResult/e7d03602-4873-4760-b37e-1563ef5358e3
Przykładowa odpowiedź
{
"workspaces": [
{
"id": "d507422c-8d6d-4361-ac7a-30074a8cd0a1",
"name": "V2 shared",
"type": "Workspace",
"state": "Active",
"isOnDedicatedCapacity": true,
"capacityId": "0f084df7-c13d-451b-af5f-ed0c466403b2",
"defaultDatasetStorageFormat": "Small",
"reports": [
{
"id": "c6d072d1-ed20-4b60-8329-16c4b934203b",
"name": "CompositeModelParams-RLS",
"datasetId": "132593c4-bf8d-4548-8f25-1ebb16a1613c",
"createdDateTime": "2020-06-16T08:22:49.14",
"modifiedDateTime": "2020-06-16T08:22:49.14",
"modifiedBy": "john@contoso.com",
"reportType": "PaginatedReport",
"endorsementDetails": {
"endorsement": "Certified",
"certifiedBy": "john@contoso.com"
},
"sensitivityLabel": {
"labelId": "85b38049-4259-43a2-8feb-244e222d96c0"
},
"users": [
{
"displayName": "John Nick",
"emailAddress": "john@contoso.com",
"appUserAccessRight": "ReadExplore",
"identifier": "john@contoso.com",
"graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
"principalType": "User"
}
]
}
],
"dashboards": [
{
"id": "80814ece-9302-49e3-b6bc-bad2f7a86c1a",
"displayName": "CompositeModelParamsDashboard",
"isReadOnly": false,
"tiles": [
{
"id": "e687cc21-5b32-48f5-8c5e-4b844f190579",
"title": "CompositeModelParamsDashboard",
"reportId": "c6d072d1-ed20-4b60-8329-16c4b934203b",
"datasetId": "132593c4-bf8d-4548-8f25-1ebb16a1613c"
}
],
"sensitivityLabel": {
"labelId": "d9b9581a-0594-4c39-81c5-91ddf40baeda"
},
"users": [
{
"displayName": "John Nick",
"emailAddress": "john@contoso.com",
"appUserAccessRight": "ReadExplore",
"identifier": "john@contoso.com",
"graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
"principalType": "User"
}
]
}
],
"datasets": [
{
"id": "e7e8a355-e77b-4418-a7b8-ae5972fdaa03",
"name": "ExportB",
"tables": [
{
"name": "DW_Revenues",
"columns": [
{
"name": "RowNumber-2662979B-1795-4F74-8F37-6A1BA8059B61",
"dataType": "Int64",
"isHidden": true
}
],
"measures": [
{
"name": "MyMeasure",
"expression": "CALCULATE(SELECTEDVALUE('DW_Revenues DW_RevenuesTestToBeDeleted'[Numbers])*10)",
"description": "My measure",
"isHidden": false
}
],
"isHidden": false,
"description": "My table",
"source": [
{
"expression": "let\n Source = Revenues,\n Param = RevenuesParam\nin\n Source"
}
]
}
],
"relationships": [],
"configuredBy": "john@contoso.com",
"targetStorageMode": "Abf",
"endorsementDetails": {
"endorsement": "Certified",
"certifiedBy": "john@contoso.com"
},
"expressions": [
{
"name": "Revenues",
"description": "revenues",
"expression": "let\n Source = Sql.Database(\"sqlserver.database.windows.net\", \"DB\"),\n RevenuesTable = Source{[Schema=\"DB_SCHEMA\",Item=\"DB_SCHEMA_ITEM\"]}[Data]\nin\n RevenuesTable"
},
{
"name": "RevenuesParam",
"description": "revenues param",
"expression": "\"revenues param value\" meta [IsParameterQuery=true, Type=\"Text\", IsParameterQueryRequired=true]"
}
],
"roles": [
{
"name": "Teams",
"modelPermission": "Read",
"members": [
{
"memberName": "john@contoso.com",
"memberId": "ee96296b-fb71-4f65-a8af-c0ec5a7daced",
"memberType": "User",
"identityProvider": "AzureAD"
},
{
"memberName": "group@contoso.com",
"memberId": "0a1cdbc3-f82c-4001-8b96-be04ae9d25a3",
"memberType": "Group",
"identityProvider": "AzureAD"
}
],
"tablePermissions": [
{
"name": "DW_Revenues DW_RevenuesTest",
"filterExpression": "[InTeams] = \"True\""
}
]
}
],
"upstreamDataflows": [
{
"targetDataflowId": "a842dbb1-32ca-46b0-9648-498b2c2d5e38",
"groupId": "b7416115-7421-42c0-b525-1505ce40d2f0"
},
{
"targetDataflowId": "06898194-2eaf-4122-bacc-133db1f8585d",
"groupId": "7263838d-80d7-4b8d-a1f6-50fc27e74a97"
}
],
"datasourceUsages": [
{
"datasourceInstanceId": "c79ad907-df19-43fe-a0f7-d9f365d67070"
}
],
"misconfiguredDatasourceUsages": [
{
"datasourceInstanceId": "80ec28bc-fe81-43ea-be52-a07a95cfbcab"
}
],
"sensitivityLabel": {
"labelId": "bf3dc57d-d796-41c0-bbe9-a47f5ee3331e"
},
"users": [
{
"displayName": "John Nick",
"emailAddress": "john@contoso.com",
"appUserAccessRight": "ReadExplore",
"identifier": "john@contoso.com",
"graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
"principalType": "User"
}
]
}
],
"dataflows": [
{
"objectId": "a842dbb1-32ca-46b0-9648-498b2c2d5e38",
"name": "Azure SQL",
"description": "Azure SQL dataflow",
"configuredBy": "john@contoso.com",
"modifiedBy": "john@contoso.com",
"modifiedDateTime": "2020-06-16T08:27:47.783Z",
"endorsementDetails": {
"endorsement": "Certified",
"certifiedBy": "john@contoso.com"
},
"datasourceUsages": [
{
"datasourceInstanceId": "c79ad907-df19-43fe-a0f7-d9f365d67070"
}
],
"misconfiguredDatasourceUsages": [
{
"datasourceInstanceId": "80ec28bc-fe81-43ea-be52-a07a95cfbcab"
}
],
"sensitivityLabel": {
"labelId": "5c9f8c24-2a94-4fd2-a105-9a8b096c5af1"
},
"users": [
{
"displayName": "John Nick",
"emailAddress": "john@contoso.com",
"appUserAccessRight": "ReadExplore",
"identifier": "john@contoso.com",
"graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
"principalType": "User"
}
]
}
],
"datamarts": [
{
"id": "9df8d63c-db5b-44c3-a8e3-9f8c8ec1eec2",
"name": "MyDatamart",
"description": "SQL datamart",
"type": "Sql",
"configuredBy": "john@contoso.com",
"configuredById": "5c9f8c24-2a94-4fd2-a105-9a8b096cdsew",
"modifiedBy": "john@contoso.com",
"modifiedDateTime": "2020-06-16T08:27:47.783Z",
"sensitivityLabel": {
"labelId": "5c9f8c24-2a94-4fd2-a105-9a8b096c5af1"
},
"endorsementDetails": {
"endorsement": "Certified",
"certifiedBy": "john@contoso.com"
},
"UpstreamDataflows": [
{
"targetDataflowId": "5c9f8c24-2a94-34fd-a105-9a8b096c4555",
"groupId": "5c9f8c24-4dsc-4fd2-a105-9a8b096c4fgt"
}
],
"datasourceUsages": [
{
"datasourceInstanceId": "c79ad907-df19-43fe-a0f7-d9f365d67070"
}
],
"Users": [
{
"displayName": "John Nick",
"emailAddress": "john@contoso.com",
"identifier": "john@contoso.com",
"graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
"principalType": "User",
"userType": "User",
"profile": {
"id": "45416453",
"displayName": "John's profile"
},
"datamartUserAccessRight": "Read"
}
]
}
],
"users": [
{
"displayName": "John Nick",
"emailAddress": "john@contoso.com",
"appUserAccessRight": "ReadExplore",
"identifier": "john@contoso.com",
"graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
"principalType": "User"
}
]
}
],
"datasourceInstances": [
{
"datasourceType": "Sql",
"connectionDetails": {
"server": "qlserver.database.windows.net",
"database": "dbo.largest_table"
},
"datasourceId": "c79ad907-df19-43fe-a0f7-d9f365d67070",
"gatewayId": "e820592e-f8cf-4a6f-b1ed-566799d29565"
}
],
"misconfiguredDatasourceInstances": [
{
"datasourceType": "Sql",
"connectionDetails": {
"server": "sqlserver.database.windows.net",
"database": "dbo.table"
},
"datasourceId": "80ec28bc-fe81-43ea-be52-a07a95cfbcab",
"gatewayId": "505a19c1-4190-4e8e-a4f6-dd72722feced"
}
]
}
Definicje
Nazwa | Opis |
---|---|
ASMashup |
Źródło tabeli zestawu danych |
Column |
Kolumna zestawu danych |
Dashboard |
Wpis prawa dostępu użytkownika usługi Power BI dla pulpitu nawigacyjnego |
Dashboard |
Prawo dostępu, które użytkownik ma dla pulpitu nawigacyjnego (poziom uprawnień) |
Dataflow |
Wpis prawa dostępu użytkownika usługi Power BI dla przepływu danych |
Dataflow |
Prawo dostępu, które użytkownik ma dla przepływu danych (poziom uprawnień) |
datamart |
Bieżący stan schematu danych |
datamart |
Stan obiektu datamart |
datamart |
Typ elementu datamart |
Datamart |
Wpis prawa dostępu użytkownika usługi Power BI dla raportu |
Datamart |
Prawo dostępu, które użytkownik ma dla elementu datamart (poziom uprawnień) |
Dataset |
Wpis prawa dostępu użytkownika usługi Power BI dla zestawu danych |
Dataset |
Prawo dostępu, które użytkownik ma dla zestawu danych (poziom uprawnień) |
Datasource |
Źródło danych usługi Power BI |
Datasource |
Szczegóły połączenia ze źródłem danych usługi Power BI. Zobacz przykłady Pobieranie źródeł danych lub Pobieranie źródeł danych w grupie. |
Datasource |
Użycie źródła danych |
Default |
Domyślny format magazynu zestawu danych w grupie |
Dependent |
Zależny przepływ danych usługi Power BI |
Dependent |
Tabela danych zależnych od usługi Power BI |
Dependent |
Zestaw danych zależnych od usługi Power BI |
Endorsement |
Szczegóły poręczenia usługi Power BI |
Expression |
Wyrażenie zestawu danych |
Group |
Użytkownik usługi Power BI z dostępem do obszaru roboczego |
Group |
Prawo dostępu (poziom uprawnień), który użytkownik ma w obszarze roboczym |
Measure |
Miara usługi Power BI |
Principal |
Typ podmiotu zabezpieczeń |
Report |
Wpis prawa dostępu użytkownika usługi Power BI dla raportu |
Report |
Prawo dostępu, które użytkownik ma dla raportu (poziom uprawnień) |
Role |
Rola w konfiguracji zabezpieczeń na poziomie wiersza zestawu danych |
Role |
Członek roli |
Role |
Filtr roli |
Row |
Wiersz danych w zestawie danych |
Sensitivity |
Informacje o etykiecie poufności dla elementu usługi Power BI (na przykład raportu lub pulpitu nawigacyjnego) |
Service |
Profil jednostki usługi Power BI. Dotyczy tylko rozwiązania wielodostępu usługi Power BI Embedded. |
Table |
Tabela zestawu danych |
Workspace |
Szczegóły informacji o obszarze roboczym |
Workspace |
Pulpit nawigacyjny usługi Power BI zwracany przez interfejsy API WorkspaceInfo. Interfejs API zwraca podzestaw następujących właściwości pulpitu nawigacyjnego. Podzestaw zależy od interfejsu API o nazwie, uprawnieniach wywołującego i dostępności danych w bazie danych usługi Power BI. |
Workspace |
Metadane przepływu danych zwrócone przez interfejsy API informacji o obszarze roboczym. Poniżej znajduje się lista właściwości, które mogą być zwracane dla przepływu danych. W zależności od wywoływanego interfejsu API zostanie zwrócony tylko podzbiór właściwości, uprawnienia obiektu wywołującego i dostępność danych w bazie danych usługi Power BI. |
Workspace |
Schemat danych usługi Power BI zwracany przez interfejsy API informacji o obszarze roboczym. Interfejs API zwraca podzbiór następujących właściwości elementu datamart. Podzestaw zależy od interfejsu API o nazwie, uprawnieniach wywołującego i dostępności danych w bazie danych usługi Power BI. |
Workspace |
Zestaw danych usługi Power BI zwrócony przez interfejsy API WorkspaceInfo. Interfejs API zwraca podzbiór poniższych właściwości zestawu danych. Podzestaw zależy od interfejsu API o nazwie, uprawnieniach wywołującego i dostępności danych w bazie danych usługi Power BI. |
Workspace |
Raport usługi Power BI zwracany przez interfejsy API informacji o obszarze roboczym. Interfejs API zwraca podzestaw następujących właściwości raportu. Podzestaw zależy od interfejsu API o nazwie, uprawnieniach wywołującego i dostępności danych w bazie danych usługi Power BI. |
Workspace |
Odpowiedź na informacje o obszarze roboczym |
Workspace |
Kafelek usługi Power BI zwracany przez interfejsy API WorkspaceInfo |
ASMashupExpression
Źródło tabeli zestawu danych
Nazwa | Typ | Opis |
---|---|---|
expression |
string |
Wyrażenie źródłowe |
Column
Kolumna zestawu danych
Nazwa | Typ | Opis |
---|---|---|
dataCategory |
string |
Fakultatywny. Wartość ciągu, która ma być używana dla kategorii danych, która opisuje dane w tej kolumnie. |
dataType |
string |
Typ danych kolumny |
formatString |
string |
Fakultatywny. Format kolumny określony w FORMAT_STRING. |
isHidden |
boolean |
Fakultatywny. Czy kolumna jest ukryta. Wartość domyślna to |
name |
string |
Nazwa kolumny |
sortByColumn |
string |
Fakultatywny. Nazwa ciągu kolumny w tej samej tabeli, która ma być używana do zamawiania bieżącej kolumny. |
summarizeBy |
string |
Fakultatywny. Funkcja agregacji używana do podsumowywania tej kolumny. |
DashboardUser
Wpis prawa dostępu użytkownika usługi Power BI dla pulpitu nawigacyjnego
Nazwa | Typ | Opis |
---|---|---|
dashboardUserAccessRight |
Prawo dostępu, które użytkownik ma dla pulpitu nawigacyjnego (poziom uprawnień) |
|
displayName |
string |
Nazwa wyświetlana podmiotu zabezpieczeń |
emailAddress |
string |
Adres e-mail użytkownika |
graphId |
string |
Identyfikator podmiotu zabezpieczeń w programie Microsoft Graph. Dostępne tylko dla interfejsów API administratorów. |
identifier |
string |
Identyfikator podmiotu zabezpieczeń |
principalType |
Typ podmiotu zabezpieczeń |
|
profile |
Profil jednostki usługi Power BI. Dotyczy tylko rozwiązania wielodostępu usługi Power BI Embedded. |
|
userType |
string |
Typ użytkownika. |
DashboardUserAccessRight
Prawo dostępu, które użytkownik ma dla pulpitu nawigacyjnego (poziom uprawnień)
Nazwa | Typ | Opis |
---|---|---|
None |
string |
Brak uprawnień do zawartości na pulpicie nawigacyjnym |
Owner |
string |
Udziela dostępu do odczytu, zapisu i udostępniania dalej do zawartości w raporcie |
Read |
string |
Przyznaje dostęp do odczytu zawartości na pulpicie nawigacyjnym |
ReadCopy |
string |
Udziela dostępu do odczytu i kopiowania zawartości na pulpicie nawigacyjnym |
ReadReshare |
string |
Udziela dostępu do odczytu i udostępniania dalej zawartości na pulpicie nawigacyjnym |
ReadWrite |
string |
Udziela dostępu do odczytu i zapisu do zawartości na pulpicie nawigacyjnym |
DataflowUser
Wpis prawa dostępu użytkownika usługi Power BI dla przepływu danych
Nazwa | Typ | Opis |
---|---|---|
DataflowUserAccessRight |
Prawo dostępu, które użytkownik ma dla przepływu danych (poziom uprawnień) |
|
displayName |
string |
Nazwa wyświetlana podmiotu zabezpieczeń |
emailAddress |
string |
Adres e-mail użytkownika |
graphId |
string |
Identyfikator podmiotu zabezpieczeń w programie Microsoft Graph. Dostępne tylko dla interfejsów API administratorów. |
identifier |
string |
Identyfikator podmiotu zabezpieczeń |
principalType |
Typ podmiotu zabezpieczeń |
|
profile |
Profil jednostki usługi Power BI. Dotyczy tylko rozwiązania wielodostępu usługi Power BI Embedded. |
|
userType |
string |
Typ użytkownika. |
DataflowUserAccessRight
Prawo dostępu, które użytkownik ma dla przepływu danych (poziom uprawnień)
Nazwa | Typ | Opis |
---|---|---|
None |
string |
Usuwa uprawnienia do zawartości w przepływie danych |
Owner |
string |
Udziela dostępu do odczytu, zapisu i udostępniania dalej do zawartości w przepływie danych |
Read |
string |
Przyznaje dostęp do odczytu do zawartości w przepływie danych |
ReadReshare |
string |
Udziela dostępu do odczytu i udostępniania dalej zawartości w przepływie danych |
ReadWrite |
string |
Przyznaje dostęp do odczytu i zapisu do zawartości w przepływie danych |
datamartState
Bieżący stan schematu danych
Nazwa | Typ | Opis |
---|---|---|
Active |
string |
Schemat danych jest aktywny |
Deleted |
string |
Datamart został usunięty |
Evicted |
string |
Eksmitowany element datamart |
Initialized |
string |
Datamart został zainicjowany |
Invalid |
string |
Schemat danych ma nieprawidłowy stan |
Migrating |
string |
Migrowanie schematu danych |
datamartStatus
Stan obiektu datamart
Nazwa | Typ | Opis |
---|---|---|
Available |
string |
Tabela datamart jest dostępna |
Error |
string |
Tabela datamart ma stan błędu |
InProgress |
string |
Schemat danych jest w toku |
Invalid |
string |
Schemat danych ma nieprawidłowy stan |
NoCapacity |
string |
Tabela datamart nie ma pojemności |
OutOfRegion |
string |
Tabela datamart jest poza regionem |
SuspendedInCriticalPhase |
string |
Schemat danych jest zawieszony w fazie krytycznej |
datamartType
Typ elementu datamart
Nazwa | Typ | Opis |
---|---|---|
Dataverse |
string |
Datamart ma typ Dataverse |
Datawarehouse |
string |
Datamart jest typu Datawarehouse |
Ignore |
string |
Datamart nie ma typu |
Lakehouse |
string |
Datamart jest typu Lakehouse |
Sql |
string |
Datamart jest typu Sql |
Unset |
string |
Typ elementu datamart nie został zdenerwowany |
DatamartUser
Wpis prawa dostępu użytkownika usługi Power BI dla raportu
Nazwa | Typ | Opis |
---|---|---|
datamartUserAccessRight |
Prawo dostępu, które użytkownik ma dla elementu datamart (poziom uprawnień) |
|
displayName |
string |
Nazwa wyświetlana podmiotu zabezpieczeń |
emailAddress |
string |
Adres e-mail użytkownika |
graphId |
string |
Identyfikator podmiotu zabezpieczeń w programie Microsoft Graph. Dostępne tylko dla interfejsów API administratorów. |
identifier |
string |
Identyfikator podmiotu zabezpieczeń |
principalType |
Typ podmiotu zabezpieczeń |
|
profile |
Profil jednostki usługi Power BI. Dotyczy tylko rozwiązania wielodostępu usługi Power BI Embedded. |
|
userType |
string |
Typ użytkownika. |
DatamartUserAccessRight
Prawo dostępu, które użytkownik ma dla elementu datamart (poziom uprawnień)
Nazwa | Typ | Opis |
---|---|---|
Explore |
string |
Przyznaje eksplorowanie dostępu do zawartości w narzędziu datamart |
None |
string |
Brak uprawnień do zawartości w narzędziu datamart |
Read |
string |
Udziela dostępu do odczytu do zawartości w narzędziu datamart |
ReadExplore |
string |
Przyznaje odczyt i eksplorowanie dostępu do zawartości w narzędziu datamart |
ReadReshare |
string |
Przyznaje dostęp do odczytu i udostępniania dalej zawartości w narzędziu datamart |
ReadReshareExplore |
string |
Udziela uprawnień do odczytu i udostępniania dalej oraz eksplorowania dostępu do zawartości w narzędziu datamart |
ReadWrite |
string |
Przyznaje dostęp do odczytu i zapisu do zawartości w narzędziu datamart |
ReadWriteExplore |
string |
Udziela uprawnień do odczytu i zapisu oraz eksplorowania dostępu do zawartości w narzędziu datamart |
ReadWriteReshare |
string |
Przyznaje dostęp do odczytu i zapisu i ponownego udostępniania zawartości w narzędziu datamart |
ReadWriteReshareExplore |
string |
Udziela uprawnień do odczytu i zapisu i ponownego udostępniania oraz eksplorowania dostępu do zawartości w narzędziu datamart |
Reshare |
string |
Udziela dostępu do udostępniania dalej zawartości w narzędziu datamart |
Write |
string |
Udziela dostępu do zapisu do zawartości w narzędziu datamart |
DatasetUser
Wpis prawa dostępu użytkownika usługi Power BI dla zestawu danych
Nazwa | Typ | Opis |
---|---|---|
datasetUserAccessRight |
Prawo dostępu, które użytkownik ma dla zestawu danych (poziom uprawnień) |
|
displayName |
string |
Nazwa wyświetlana podmiotu zabezpieczeń |
emailAddress |
string |
Adres e-mail użytkownika |
graphId |
string |
Identyfikator podmiotu zabezpieczeń w programie Microsoft Graph. Dostępne tylko dla interfejsów API administratorów. |
identifier |
string |
Identyfikator podmiotu zabezpieczeń |
principalType |
Typ podmiotu zabezpieczeń |
|
profile |
Profil jednostki usługi Power BI. Dotyczy tylko rozwiązania wielodostępu usługi Power BI Embedded. |
|
userType |
string |
Typ użytkownika. |
DatasetUserAccessRight
Prawo dostępu, które użytkownik ma dla zestawu danych (poziom uprawnień)
Nazwa | Typ | Opis |
---|---|---|
None |
string |
Usuwa uprawnienia do zawartości w zestawie danych |
Read |
string |
Przyznaje dostęp do odczytu zawartości w zestawie danych |
ReadExplore |
string |
Przyznaje dostęp do odczytu i eksplorowania zawartości w zestawie danych |
ReadReshare |
string |
Przyznaje dostęp do odczytu i udostępniania dalej do zawartości w zestawie danych |
ReadReshareExplore |
string |
Udziela uprawnień do odczytu, udostępniania dalej i eksplorowania dostępu do zawartości w zestawie danych |
ReadWrite |
string |
Przyznaje dostęp do odczytu i zapisu do zawartości w zestawie danych |
ReadWriteExplore |
string |
Udziela dostępu do odczytu, zapisu i eksplorowania zawartości w zestawie danych |
ReadWriteReshare |
string |
Udziela dostępu do odczytu, zapisu i udostępniania dalej do zawartości w zestawie danych |
ReadWriteReshareExplore |
string |
Przyznaje dostęp do zawartości w zestawie danych: odczyt, zapis, udostępnianie dalej i eksplorowanie |
Datasource
Źródło danych usługi Power BI
Nazwa | Typ | Opis |
---|---|---|
connectionDetails |
Szczegóły połączenia ze źródłem danych |
|
connectionString |
string |
(Przestarzałe) Parametry połączenia ze źródłem danych. Dostępne tylko dla trybu DirectQuery. |
datasourceId |
string |
Powiązany identyfikator źródła danych, który jest pusty, gdy nie jest powiązany z bramą |
datasourceType |
string |
Typ źródła danych |
gatewayId |
string |
Powiązany identyfikator bramy, który jest pusty, gdy nie jest powiązany z bramą. W przypadku korzystania z klastra bramy identyfikator bramy odnosi się do bramy podstawowej (pierwszej) w klastrze i jest podobny do identyfikatora klastra bramy. |
name |
string |
(Przestarzałe) Nazwa źródła danych. Dostępne tylko dla trybu DirectQuery. |
DatasourceConnectionDetails
Szczegóły połączenia ze źródłem danych usługi Power BI. Zobacz przykłady Pobieranie źródeł danych lub Pobieranie źródeł danych w grupie.
Nazwa | Typ | Opis |
---|---|---|
account |
string |
Konto połączenia |
classInfo |
string |
Informacje o klasie połączenia |
database |
string |
Baza danych połączeń |
domain |
string |
Domena połączenia |
emailAddress |
string |
Adres e-mail połączenia |
kind |
string |
Rodzaj połączenia |
loginServer |
string |
Serwer logowania połączenia |
path |
string |
Ścieżka połączenia |
server |
string |
Serwer połączeń |
url |
string |
Adres URL połączenia |
DatasourceUsage
Użycie źródła danych
Nazwa | Typ | Opis |
---|---|---|
datasourceInstanceId |
string |
Identyfikator wystąpienia źródła danych |
DefaultDatasetStorageFormat
Domyślny format magazynu zestawu danych w grupie
Nazwa | Typ | Opis |
---|---|---|
Large |
string |
Format magazynu dużych zestawów danych |
Small |
string |
Format magazynu małych zestawów danych |
DependentDataflow
Zależny przepływ danych usługi Power BI
Nazwa | Typ | Opis |
---|---|---|
groupId |
string |
Identyfikator grupy docelowej |
targetDataflowId |
string |
Identyfikator docelowego przepływu danych |
DependentDatamart
Tabela danych zależnych od usługi Power BI
Nazwa | Typ | Opis |
---|---|---|
groupId |
string |
Identyfikator grupy docelowej |
targetDatamartId |
string |
Identyfikator docelowego schematu danych |
DependentDataset
Zestaw danych zależnych od usługi Power BI
Nazwa | Typ | Opis |
---|---|---|
groupId |
string |
Identyfikator grupy docelowej |
targetDatasetId |
string |
Identyfikator docelowego zestawu danych |
EndorsementDetails
Szczegóły poręczenia usługi Power BI
Nazwa | Typ | Opis |
---|---|---|
certifiedBy |
string |
Użytkownik, który certyfikowanie elementu usługi Power BI (na przykład raportu lub pulpitu nawigacyjnego) |
endorsement |
string |
Stan poręczenia |
Expression
Wyrażenie zestawu danych
Nazwa | Typ | Opis |
---|---|---|
description |
string |
Opis wyrażenia |
expression |
string |
Wartość wyrażenia |
name |
string |
Nazwa wyrażenia |
GroupUser
Użytkownik usługi Power BI z dostępem do obszaru roboczego
Nazwa | Typ | Opis |
---|---|---|
displayName |
string |
Nazwa wyświetlana podmiotu zabezpieczeń |
emailAddress |
string |
Adres e-mail użytkownika |
graphId |
string |
Identyfikator podmiotu zabezpieczeń w programie Microsoft Graph. Dostępne tylko dla interfejsów API administratorów. |
groupUserAccessRight |
Prawo dostępu (poziom uprawnień), który użytkownik ma w obszarze roboczym |
|
identifier |
string |
Identyfikator podmiotu zabezpieczeń |
principalType |
Typ podmiotu zabezpieczeń |
|
profile |
Profil jednostki usługi Power BI. Dotyczy tylko rozwiązania wielodostępu usługi Power BI Embedded. |
|
userType |
string |
Typ użytkownika. |
GroupUserAccessRight
Prawo dostępu (poziom uprawnień), który użytkownik ma w obszarze roboczym
Nazwa | Typ | Opis |
---|---|---|
Admin |
string |
Uprawnienia administratora do zawartości obszaru roboczego |
Contributor |
string |
Odczyt i eksplorowanie (ReadExplore) dostęp do zawartości obszaru roboczego |
Member |
string |
Odczyt, ponowne udostępnianie i eksplorowanie (ReadReshareExplore) praw dostępu do zawartości obszaru roboczego |
None |
string |
Brak dostępu do zawartości obszaru roboczego |
Viewer |
string |
Dostęp tylko do odczytu (odczyt) do zawartości obszaru roboczego |
Measure
Miara usługi Power BI
Nazwa | Typ | Opis |
---|---|---|
description |
string |
Fakultatywny. Opis miary. |
expression |
string |
Prawidłowe wyrażenie języka DAX |
formatString |
string |
Fakultatywny. Ciąg opisujący sposób formatowania wartości, gdy jest on wyświetlany zgodnie z opisem w FORMAT_STRING. |
isHidden |
boolean |
Fakultatywny. Czy miara jest ukryta. |
name |
string |
Nazwa miary |
PrincipalType
Typ podmiotu zabezpieczeń
Nazwa | Typ | Opis |
---|---|---|
App |
string |
Typ jednostki usługi |
Group |
string |
Typ podmiotu zabezpieczeń grupy |
None |
string |
Brak typu podmiotu zabezpieczeń. Służy do uzyskiwania dostępu na poziomie całej organizacji. |
User |
string |
Typ podmiotu zabezpieczeń użytkownika |
ReportUser
Wpis prawa dostępu użytkownika usługi Power BI dla raportu
Nazwa | Typ | Opis |
---|---|---|
displayName |
string |
Nazwa wyświetlana podmiotu zabezpieczeń |
emailAddress |
string |
Adres e-mail użytkownika |
graphId |
string |
Identyfikator podmiotu zabezpieczeń w programie Microsoft Graph. Dostępne tylko dla interfejsów API administratorów. |
identifier |
string |
Identyfikator podmiotu zabezpieczeń |
principalType |
Typ podmiotu zabezpieczeń |
|
profile |
Profil jednostki usługi Power BI. Dotyczy tylko rozwiązania wielodostępu usługi Power BI Embedded. |
|
reportUserAccessRight |
Prawo dostępu, które użytkownik ma dla raportu (poziom uprawnień) |
|
userType |
string |
Typ użytkownika. |
ReportUserAccessRight
Prawo dostępu, które użytkownik ma dla raportu (poziom uprawnień)
Nazwa | Typ | Opis |
---|---|---|
None |
string |
Brak uprawnień do zawartości w raporcie |
Owner |
string |
Udziela dostępu do odczytu, zapisu i udostępniania dalej do zawartości w raporcie |
Read |
string |
Przyznaje dostęp do odczytu zawartości w raporcie |
ReadCopy |
string |
Przyznaje dostęp do odczytu i kopiowania zawartości w raporcie |
ReadReshare |
string |
Udziela dostępu do odczytu i udostępniania dalej zawartości w raporcie |
ReadWrite |
string |
Udziela dostępu do odczytu i zapisu do zawartości w raporcie |
Role
Rola w konfiguracji zabezpieczeń na poziomie wiersza zestawu danych
Nazwa | Typ | Opis |
---|---|---|
members |
Tablica z listą elementów członkowskich roli |
|
modelPermission |
string |
Uprawnienia, które ma rola w zestawie danych. Na przykład Odczyt |
name |
string |
Nazwa roli |
tablePermissions |
Tablica zawierająca listę wszystkich filtrów zdefiniowanych dla roli |
RoleMember
Członek roli
Nazwa | Typ | Opis |
---|---|---|
identityProvider |
string |
Dostawca tożsamości członka roli |
memberId |
string |
Identyfikator GUID członka roli przypisany przez dostawcę tożsamości |
memberName |
string |
Nazwa członka roli |
memberType |
string |
Typ elementu członkowskiego roli (użytkownik lub grupa) |
RoleTablePermission
Filtr roli
Nazwa | Typ | Opis |
---|---|---|
filterExpression |
string |
Wyrażenie filtrujące tabelę określoną w filtrze |
name |
string |
Nazwa tabeli określonej w filtrze |
Row
Wiersz danych w zestawie danych
Nazwa | Typ | Opis |
---|---|---|
id |
string |
Unikatowy identyfikator wiersza |
SensitivityLabel
Informacje o etykiecie poufności dla elementu usługi Power BI (na przykład raportu lub pulpitu nawigacyjnego)
Nazwa | Typ | Opis |
---|---|---|
labelId |
string |
Identyfikator etykiety poufności |
ServicePrincipalProfile
Profil jednostki usługi Power BI. Dotyczy tylko rozwiązania wielodostępu usługi Power BI Embedded.
Nazwa | Typ | Opis |
---|---|---|
displayName |
string |
Nazwa profilu jednostki usługi |
id |
string |
Identyfikator profilu jednostki usługi |
Table
Tabela zestawu danych
Nazwa | Typ | Opis |
---|---|---|
columns |
Column[] |
Schemat kolumny dla tej tabeli |
description |
string |
Opis tabeli |
isHidden |
boolean |
Fakultatywny. Czy ta tabela zestawów danych jest ukryta. |
measures |
Measure[] |
Miary w tej tabeli |
name |
string |
Nazwa tabeli |
rows |
Row[] |
Wiersze danych w tej tabeli |
source |
Źródło tabeli |
WorkspaceInfo
Szczegóły informacji o obszarze roboczym
Nazwa | Typ | Opis |
---|---|---|
capacityId |
string |
Identyfikator pojemności obszaru roboczego |
dashboards |
Pulpity nawigacyjne skojarzone z tym obszarem roboczym. Zwracana lista właściwości pulpitu nawigacyjnego różni się w przypadku różnych wywołań interfejsu API, więc w odpowiedzi interfejsu API może nie być widoczna wszystkie właściwości pulpitu nawigacyjnego. |
|
dataRetrievalState |
string |
Stan pobierania danych obszaru roboczego |
dataflows |
Przepływy danych skojarzone z tym obszarem roboczym. Zwracana lista właściwości przepływu danych różni się w przypadku różnych wywołań interfejsu API, więc w odpowiedzi interfejsu API może nie być widocznych wszystkie właściwości przepływu danych. |
|
datamarts |
Magazyny danych skojarzone z tym obszarem roboczym. Zwracana lista właściwości elementu datamart różni się w przypadku różnych wywołań interfejsu API, więc w odpowiedzi interfejsu API może nie być widoczna wszystkie właściwości elementu datamart. |
|
datasets |
Zestawy danych skojarzone z tym obszarem roboczym. Zwracana lista właściwości zestawu danych różni się w przypadku różnych wywołań interfejsu API, więc w odpowiedzi interfejsu API może nie być widocznych wszystkie właściwości zestawu danych. |
|
defaultDatasetStorageFormat |
Domyślny format magazynu zestawu danych w obszarze roboczym. Zwracane tylko wtedy, gdy |
|
description |
string |
Opis obszaru roboczego |
id |
string |
Identyfikator obiektu obszaru roboczego |
isOnDedicatedCapacity |
boolean |
Czy obszar roboczy jest przypisany do pojemności dedykowanej |
name |
string |
Nazwa obszaru roboczego |
reports |
Raporty skojarzone z tym obszarem roboczym. Zwracana lista właściwości raportu różni się w przypadku różnych wywołań interfejsu API, więc w odpowiedzi interfejsu API może nie być widocznych wszystkich właściwości raportu. |
|
state |
string |
Stan obszaru roboczego |
type |
string |
Typ obszaru roboczego |
users |
Użytkownicy z dostępem do obszaru roboczego. Lista jest zwracana tylko w przypadku jawnego żądania. Aby pobrać listę użytkowników dla klasycznego obszaru roboczego, użyj interfejsu API programu Graph usługi Azure Active Directory. |
WorkspaceInfoDashboard
Pulpit nawigacyjny usługi Power BI zwracany przez interfejsy API WorkspaceInfo. Interfejs API zwraca podzestaw następujących właściwości pulpitu nawigacyjnego. Podzestaw zależy od interfejsu API o nazwie, uprawnieniach wywołującego i dostępności danych w bazie danych usługi Power BI.
Nazwa | Typ | Opis |
---|---|---|
appId |
string |
Identyfikator aplikacji zwrócony tylko wtedy, gdy pulpit nawigacyjny należy do aplikacji |
dataClassification |
string |
Tag klasyfikacji danych elementu usługi Power BI (na przykład raport lub pulpit nawigacyjny) |
displayName |
string |
Nazwa wyświetlana pulpitu nawigacyjnego |
id |
string |
Identyfikator pulpitu nawigacyjnego |
isReadOnly |
boolean |
Czy pulpit nawigacyjny jest tylko do odczytu |
sensitivityLabel |
Etykieta poufności |
|
tiles |
Kafelki należące do pulpitu nawigacyjnego |
|
users |
(Pusta wartość) Szczegóły dostępu użytkownika pulpitu nawigacyjnego. Ta właściwość zostanie usunięta z odpowiedzi ładunku w nadchodzącej wersji. Informacje o użytkowniku na pulpicie nawigacyjnym usługi Power BI można pobrać przy użyciu wywołania interfejsu API administratora Pobierz użytkowników pulpitu nawigacyjnego lub wywołania interfejsu API PostWorkspaceInfo z parametrem |
WorkspaceInfoDataflow
Metadane przepływu danych zwrócone przez interfejsy API informacji o obszarze roboczym. Poniżej znajduje się lista właściwości, które mogą być zwracane dla przepływu danych. W zależności od wywoływanego interfejsu API zostanie zwrócony tylko podzbiór właściwości, uprawnienia obiektu wywołującego i dostępność danych w bazie danych usługi Power BI.
Nazwa | Typ | Opis |
---|---|---|
configuredBy |
string |
Właściciel przepływu danych |
datasourceUsages |
Użycie źródła danych |
|
description |
string |
Opis przepływu danych |
endorsementDetails |
Szczegóły zatwierdzenia |
|
misconfiguredDatasourceUsages |
Nieprawidłowo skonfigurowane użycie źródła danych |
|
modelUrl |
string |
Adres URL pliku definicji przepływu danych (model.json) |
name |
string |
Nazwa przepływu danych |
objectId |
string |
Identyfikator przepływu danych |
sensitivityLabel |
Etykieta poufności |
|
upstreamDataflows |
Lista wszystkich przepływów danych, od których zależy ten element |
|
upstreamDatamarts |
Lista wszystkich modułów danych, od których zależy ten element |
|
users |
(Pusta wartość) Szczegóły dostępu użytkownika przepływu danych. Ta właściwość zostanie usunięta z odpowiedzi ładunku w nadchodzącej wersji. Informacje o użytkowniku w przepływie danych usługi Power BI można pobrać przy użyciu wywołania interfejsu API administratora Pobierz użytkowników przepływu danych lub wywołania interfejsu API PostWorkspaceInfo z parametrem |
WorkspaceInfoDatamart
Schemat danych usługi Power BI zwracany przez interfejsy API informacji o obszarze roboczym. Interfejs API zwraca podzbiór następujących właściwości elementu datamart. Podzestaw zależy od interfejsu API o nazwie, uprawnieniach wywołującego i dostępności danych w bazie danych usługi Power BI.
Nazwa | Typ | Opis |
---|---|---|
configuredBy |
string |
Nazwa właściciela obiektu datamart |
configuredById |
string |
Identyfikator właściciela elementu datamart |
datasourceUsages |
Użycie źródła danych |
|
description |
string |
Opis elementu datamart |
endorsementDetails |
Szczegóły poręczenia obiektu datamart |
|
id |
string |
Identyfikator elementu datamart |
modifiedBy |
string |
Ostatni użytkownik, który zmodyfikował schemat danych |
modifiedById |
string |
Identyfikator ostatniego użytkownika, który zmodyfikował schemat danych |
modifiedDateTime |
string |
Data i godzina ostatniej modyfikacji elementu datamart |
name |
string |
Nazwa elementu datamart |
sensitivityLabel |
Etykieta poufności datamart |
|
state |
Bieżący stan schematu danych |
|
status |
Stan obiektu datamart |
|
suspendedBatchId |
string |
datamart zawieszony identyfikator partii |
type |
Typ elementu datamart |
|
upstreamDataflows |
Lista wszystkich przepływów danych, od których zależy ten element |
|
upstreamDatamarts |
Lista wszystkich modułów danych, od których zależy ten element |
|
users |
Szczegóły dostępu użytkownika dla elementu datamart usługi Power BI. |
WorkspaceInfoDataset
Zestaw danych usługi Power BI zwrócony przez interfejsy API WorkspaceInfo. Interfejs API zwraca podzbiór poniższych właściwości zestawu danych. Podzestaw zależy od interfejsu API o nazwie, uprawnieniach wywołującego i dostępności danych w bazie danych usługi Power BI.
Nazwa | Typ | Opis |
---|---|---|
ContentProviderType |
string |
Typ dostawcy zawartości dla zestawu danych |
configuredBy |
string |
Właściciel zestawu danych |
createdDate |
string |
Data i godzina utworzenia zestawu danych |
datasourceUsages |
Użycie źródła danych |
|
description |
string |
Opis zestawu danych |
endorsementDetails |
Szczegóły zatwierdzenia |
|
expressions |
Wyrażenia zestawu danych |
|
id |
string |
Identyfikator zestawu danych |
misconfiguredDatasourceUsages |
Nieprawidłowo skonfigurowane użycie źródła danych |
|
name |
string |
Nazwa zestawu danych |
roles |
Role[] |
Role zestawu danych |
schemaMayNotBeUpToDate |
boolean |
Czy schemat zestawu danych może nie być aktualny |
schemaRetrievalError |
string |
Błąd pobierania schematu zestawu danych |
sensitivityLabel |
Etykieta poufności |
|
tables |
Table[] |
Tabele zestawu danych |
targetStorageMode |
string |
Tryb przechowywania zestawu danych |
upstreamDataflows |
Lista wszystkich przepływów danych, od których zależy ten element |
|
upstreamDatamarts |
Lista wszystkich modułów danych, od których zależy ten element |
|
upstreamDatasets |
Nadrzędne zestawy danych |
|
users |
(Pusta wartość) Szczegóły dostępu użytkownika zestawu danych. Ta właściwość zostanie usunięta z odpowiedzi ładunku w nadchodzącej wersji. Informacje o użytkowniku w elemencie usługi Power BI (takim jak raport lub pulpit nawigacyjny) można pobrać przy użyciu Pobierz użytkowników zestawu danych jako interfejsu API administratora lub interfejsu API PostWorkspaceInfo za pomocą parametru |
WorkspaceInfoReport
Raport usługi Power BI zwracany przez interfejsy API informacji o obszarze roboczym. Interfejs API zwraca podzestaw następujących właściwości raportu. Podzestaw zależy od interfejsu API o nazwie, uprawnieniach wywołującego i dostępności danych w bazie danych usługi Power BI.
Nazwa | Typ | Opis |
---|---|---|
appId |
string |
Identyfikator aplikacji zwrócony tylko wtedy, gdy raport należy do aplikacji |
createdBy |
string |
Właściciel raportu. Dostępne tylko dla raportów utworzonych po czerwcu 2019 r. |
createdById |
string |
Identyfikator właściciela raportu. Dostępne tylko dla raportów utworzonych po czerwcu 2019 r. |
createdDateTime |
string |
Data i godzina utworzenia raportu |
datasetId |
string |
Identyfikator zestawu danych raportu |
datasetWorkspaceId |
string |
Identyfikator obszaru roboczego powiązanego zestawu danych zwrócony tylko wtedy, gdy powiązany zestaw danych należy do innego obszaru roboczego |
description |
string |
Opis raportu |
endorsementDetails |
Szczegóły zatwierdzenia |
|
id |
string |
Identyfikator raportu |
isOwnedByMe |
boolean |
Ustal, czy raport jest tworzony przez bieżącego użytkownika. |
modifiedBy |
string |
Ostatni użytkownik, który zmodyfikował raport |
modifiedById |
string |
Identyfikator ostatniego użytkownika, który zmodyfikował raport |
modifiedDateTime |
string |
Data i godzina ostatniej modyfikacji raportu |
name |
string |
Nazwa raportu |
originalReportId |
string |
Rzeczywisty identyfikator raportu po opublikowaniu obszaru roboczego jako aplikacja. |
reportType |
enum:
|
Typ raportu |
sensitivityLabel |
Etykieta poufności |
|
users |
(Pusta wartość) Szczegóły dostępu użytkownika dla raportu usługi Power BI. Ta właściwość zostanie usunięta z odpowiedzi ładunku w nadchodzącej wersji. Informacje o użytkowniku w raporcie usługi Power BI można pobrać przy użyciu wywołania interfejsu API administratora Pobierz użytkowników raportów lub wywołania interfejsu API PostWorkspaceInfo z parametrem |
WorkspaceInfoResponse
Odpowiedź na informacje o obszarze roboczym
Nazwa | Typ | Opis |
---|---|---|
datasourceInstances |
Wystąpienia źródła danych skojarzone z tym skanowaniem |
|
misconfiguredDatasourceInstances |
Nieprawidłowo skonfigurowane wystąpienia źródła danych skojarzone z tym skanowaniem |
|
workspaces |
Informacje o obszarze roboczym skojarzone z tym skanowaniem |
WorkspaceInfoTile
Kafelek usługi Power BI zwracany przez interfejsy API WorkspaceInfo
Nazwa | Typ | Opis |
---|---|---|
datasetId |
string |
Identyfikator zestawu danych. Dostępne tylko dla kafelków utworzonych na podstawie raportu lub przy użyciu zestawu danych, takiego jak kafelki Q&A. |
datasetWorkspaceId |
string |
Identyfikator obszaru roboczego powiązanego zestawu danych zwrócony tylko wtedy, gdy powiązany zestaw danych należy do innego obszaru roboczego |
id |
string |
Identyfikator kafelka |
reportId |
string |
Identyfikator raportu. Dostępne tylko dla kafelków utworzonych na podstawie raportu. |
title |
string |
Nazwa wyświetlana kafelka |