Udostępnij za pośrednictwem

Admin - WorkspaceInfo GetScanResult

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

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
scanId
 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

WorkspaceInfoResponse

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ź

Kod stanu:
200 
{
  "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
ASMashupExpression

Źródło tabeli zestawu danych
Column

Kolumna zestawu danych
DashboardUser

Wpis prawa dostępu użytkownika usługi Power BI dla pulpitu nawigacyjnego
DashboardUserAccessRight

Prawo dostępu, które użytkownik ma dla pulpitu nawigacyjnego (poziom uprawnień)
DataflowUser

Wpis prawa dostępu użytkownika usługi Power BI dla przepływu danych
DataflowUserAccessRight

Prawo dostępu, które użytkownik ma dla przepływu danych (poziom uprawnień)
datamartState

Bieżący stan schematu danych
datamartStatus

Stan obiektu datamart
datamartType

Typ elementu datamart
DatamartUser

Wpis prawa dostępu użytkownika usługi Power BI dla raportu
DatamartUserAccessRight

Prawo dostępu, które użytkownik ma dla elementu datamart (poziom uprawnień)
DatasetUser

Wpis prawa dostępu użytkownika usługi Power BI dla zestawu danych
DatasetUserAccessRight

Prawo dostępu, które użytkownik ma dla zestawu danych (poziom uprawnień)
Datasource

Źródło danych usługi Power BI
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.
DatasourceUsage

Użycie źródła danych
DefaultDatasetStorageFormat

Domyślny format magazynu zestawu danych w grupie
DependentDataflow

Zależny przepływ danych usługi Power BI
DependentDatamart

Tabela danych zależnych od usługi Power BI
DependentDataset

Zestaw danych zależnych od usługi Power BI
EndorsementDetails

Szczegóły poręczenia usługi Power BI
Expression

Wyrażenie zestawu danych
GroupUser

Użytkownik usługi Power BI z dostępem do obszaru roboczego
GroupUserAccessRight

Prawo dostępu (poziom uprawnień), który użytkownik ma w obszarze roboczym
Measure

Miara usługi Power BI
PrincipalType

Typ podmiotu zabezpieczeń
ReportUser

Wpis prawa dostępu użytkownika usługi Power BI dla raportu
ReportUserAccessRight

Prawo dostępu, które użytkownik ma dla raportu (poziom uprawnień)
Role

Rola w konfiguracji zabezpieczeń na poziomie wiersza zestawu danych
RoleMember

Członek roli
RoleTablePermission

Filtr roli
Row

Wiersz danych w zestawie danych
SensitivityLabel

Informacje o etykiecie poufności dla elementu usługi Power BI (na przykład raportu lub pulpitu nawigacyjnego)
ServicePrincipalProfile

Profil jednostki usługi Power BI. Dotyczy tylko rozwiązania wielodostępu usługi Power BI Embedded.
Table

Tabela zestawu danych
WorkspaceInfo

Szczegóły informacji o obszarze roboczym
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.
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.
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.
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.
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.
WorkspaceInfoResponse

Odpowiedź na informacje o obszarze roboczym
WorkspaceInfoTile

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 false.
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

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

PrincipalType

Typ podmiotu zabezpieczeń
profile

ServicePrincipalProfile

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

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

PrincipalType

Typ podmiotu zabezpieczeń
profile

ServicePrincipalProfile

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

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

PrincipalType

Typ podmiotu zabezpieczeń
profile

ServicePrincipalProfile

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

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

PrincipalType

Typ podmiotu zabezpieczeń
profile

ServicePrincipalProfile

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

DatasourceConnectionDetails

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

GroupUserAccessRight

Prawo dostępu (poziom uprawnień), który użytkownik ma w obszarze roboczym
identifier

string

Identyfikator podmiotu zabezpieczeń
principalType

PrincipalType

Typ podmiotu zabezpieczeń
profile

ServicePrincipalProfile

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

PrincipalType

Typ podmiotu zabezpieczeń
profile

ServicePrincipalProfile

Profil jednostki usługi Power BI. Dotyczy tylko rozwiązania wielodostępu usługi Power BI Embedded.
reportUserAccessRight

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

RoleMember

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

RoleTablePermission

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

ASMashupExpression[]

Źródło tabeli

WorkspaceInfo

Szczegóły informacji o obszarze roboczym

Nazwa Typ Opis
capacityId

string

Identyfikator pojemności obszaru roboczego
dashboards

WorkspaceInfoDashboard[]

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

WorkspaceInfoDataflow[]

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

WorkspaceInfoDatamart[]

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

WorkspaceInfoDataset[]

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

DefaultDatasetStorageFormat

Domyślny format magazynu zestawu danych w obszarze roboczym. Zwracane tylko wtedy, gdy isOnDedicatedCapacity jest true
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

WorkspaceInfoReport[]

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

GroupUser[]

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

SensitivityLabel

Etykieta poufności
tiles

WorkspaceInfoTile[]

Kafelki należące do pulpitu nawigacyjnego
users

DashboardUser[]

(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 getArtifactUsers.

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

DatasourceUsage[]

Użycie źródła danych
description

string

Opis przepływu danych
endorsementDetails

EndorsementDetails

Szczegóły zatwierdzenia
misconfiguredDatasourceUsages

DatasourceUsage[]

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

SensitivityLabel

Etykieta poufności
upstreamDataflows

DependentDataflow[]

Lista wszystkich przepływów danych, od których zależy ten element
upstreamDatamarts

DependentDatamart[]

Lista wszystkich modułów danych, od których zależy ten element
users

DataflowUser[]

(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 getArtifactUser.

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

DatasourceUsage[]

Użycie źródła danych
description

string

Opis elementu datamart
endorsementDetails

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

SensitivityLabel

Etykieta poufności datamart
state

datamartState

Bieżący stan schematu danych
status

datamartStatus

Stan obiektu datamart
suspendedBatchId

string

datamart zawieszony identyfikator partii
type

datamartType

Typ elementu datamart
upstreamDataflows

DependentDataflow[]

Lista wszystkich przepływów danych, od których zależy ten element
upstreamDatamarts

DependentDatamart[]

Lista wszystkich modułów danych, od których zależy ten element
users

DatamartUser[]

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

DatasourceUsage[]

Użycie źródła danych
description

string

Opis zestawu danych
endorsementDetails

EndorsementDetails

Szczegóły zatwierdzenia
expressions

Expression[]

Wyrażenia zestawu danych
id

string

Identyfikator zestawu danych
misconfiguredDatasourceUsages

DatasourceUsage[]

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

SensitivityLabel

Etykieta poufności
tables

Table[]

Tabele zestawu danych
targetStorageMode

string

Tryb przechowywania zestawu danych
upstreamDataflows

DependentDataflow[]

Lista wszystkich przepływów danych, od których zależy ten element
upstreamDatamarts

DependentDatamart[]

Lista wszystkich modułów danych, od których zależy ten element
upstreamDatasets

DependentDataset[]

Nadrzędne zestawy danych
users

DatasetUser[]

(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 getArtifactUsers.

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

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:
  • PaginatedReport
  • PowerBIReport

Typ raportu
sensitivityLabel

SensitivityLabel

Etykieta poufności
users

ReportUser[]

(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 getArtifactUsers.

WorkspaceInfoResponse

Odpowiedź na informacje o obszarze roboczym

Nazwa Typ Opis
datasourceInstances

Datasource[]

Wystąpienia źródła danych skojarzone z tym skanowaniem
misconfiguredDatasourceInstances

Datasource[]

Nieprawidłowo skonfigurowane wystąpienia źródła danych skojarzone z tym skanowaniem
workspaces

WorkspaceInfo[]

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