Admin - WidelySharedArtifacts PublishedToWeb

Service:

Power BI REST APIs

API Version:

v1.0

Gibt eine Liste von Power BI-Elementen (z. B. Berichte oder Dashboards) zurück, die im Web veröffentlicht werden.

Berechtigungen

• Der Benutzer muss über Administratorrechte (z. B. Office 365 globalen Administrator oder Power BI-Dienstadministrator) verfügen oder sich mithilfe eines Dienstprinzipals authentifizieren.
• Delegierte Berechtigungen werden unterstützt.

Erforderlicher Bereich

Tenant.Read.All oder Tenant.ReadWrite.All

Einschränkungen

Maximal 200 Anforderungen pro Stunde.

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

With optional parameters:

GET https://api.powerbi.com/v1.0/myorg/admin/widelySharedArtifacts/publishedToWeb?continuationToken={continuationToken}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
continuationToken	query		string	Token erforderlich, um den nächsten Abschnitt des Resultsets abzurufen

Antworten

Name	Typ	Beschreibung
200 OK	ArtifactAccessResponse	OK

Beispiele

Example

Sample Request

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

Sample Response

Status code:

200

{
  "artifactAccessEntities": [
    {
      "artifactId": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
      "displayName": "test report",
      "artifactType": "Report",
      "accessRight": "None",
      "shareType": "PublishToWeb",
      "sharer": {
        "displayName": "John Nick",
        "emailAddress": "john@contoso.com",
        "identifier": "john@contoso.com",
        "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
        "principalType": "User"
      }
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/widelySharedArtifacts/linksSharedToWholeOrganization?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

Definitionen

Name	Beschreibung
ArtifactAccessEntry	Ein Benutzerzugriffseintrag für ein Power BI-Element
ArtifactAccessResponse	Der OData-Antwortwrapper für eine Liste von Power BI-Elementen (z. B. Berichte oder Dashboards), auf die ein Benutzer zugreifen kann
ArtifactType	Artefakttyp
PrincipalType	Der Prinzipaltyp
ServicePrincipalProfile	Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Mehrinstanzenlösung.
User	Ein Power BI-Benutzer

ArtifactAccessEntry

Ein Benutzerzugriffseintrag für ein Power BI-Element

Name	Typ	Beschreibung
accessRight	string	Das Zugriffsrecht, das der Benutzer für das Power BI-Element hat
artifactId	string	Die Power BI-Element-ID
artifactType	ArtifactType	Der Typ des Power BI-Elements
displayName	string	Der Anzeigename des Power BI-Elements
shareType	string	Der Typ, wie der Zugriff auf das Power BI-Element gewährt wird. Nur für weit verbreitete Artefakt-APIs verfügbar.
sharer	User	Der Benutzer, der das Power BI-Element freigegeben hat. Nur für weit verbreitete Artefakt-APIs verfügbar.

ArtifactAccessResponse

Der OData-Antwortwrapper für eine Liste von Power BI-Elementen (z. B. Berichte oder Dashboards), auf die ein Benutzer zugreifen kann

Name	Typ	Beschreibung
artifactAccessEntities	ArtifactAccessEntry[]	Die Liste der Power BI-Elemente, auf die ein Benutzer zugreifen kann
continuationToken	string	Das Token für den nächsten Block im Resultset
continuationUri	string	Der URI des nächsten Blöckes im Resultset
odata.context	string

ArtifactType

Artefakttyp

Name	Typ	Beschreibung
App	string	Power BI-Apps
Capacity	string	Capacity-Objekt
Dashboard	string	Power BI-Dashboard
Dataflow	string	Power BI-Dataflow
Dataset	string	Power BI-Dataset
Group	string	V1-Objekt des freigegebenen Arbeitsbereichs
PaginatedReport	string	Paginierter Power BI-Bericht
PersonalGroup	string	Mein Arbeitsbereichsobjekt
Report	string	Power BI-Bericht
Workspace	string	Freigegebenes Arbeitsbereichsobjekt

PrincipalType

Der Prinzipaltyp

Name	Typ	Beschreibung
App	string	Dienstprinzipaltyp
Group	string	Gruppenprinzipaltyp
None	string	Kein Prinzipaltyp. Verwenden Sie für den Zugriff auf die gesamte organization ebene.
User	string	Benutzerprinzipaltyp

ServicePrincipalProfile

Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Mehrinstanzenlösung.

Name	Typ	Beschreibung
displayName	string	Der Dienstprinzipalprofilname
id	string	Die Dienstprinzipalprofil-ID

User

Ein Power BI-Benutzer

Name	Typ	Beschreibung
displayName	string	Anzeigename des Prinzipals
emailAddress	string	E-Mail-Adresse des Benutzers
graphId	string	Bezeichner des Prinzipals in Microsoft Graph. Nur für Administrator-APIs verfügbar.
identifier	string	Bezeichner des Prinzipals
principalType	PrincipalType	Der Prinzipaltyp
profile	ServicePrincipalProfile	Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Mehrinstanzenlösung.
userType	string	Typ des Benutzers.