Udostępnij za pośrednictwem


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

{
  "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