Admin - InformationProtection RemoveLabelsAsAdmin

Referenz

Service:: Power BI REST APIs

API Version:: v1.0

Entfernen Sie Vertraulichkeitsbezeichnungen aus Power BI-Elementen (z. B. Berichte oder Dashboards) nach Element-ID.

Ein Verwendungsbeispiel finden Sie unter Festlegen oder Entfernen von Vertraulichkeitsbezeichnungen.

Berechtigungen

Der Benutzer muss Administratorrechte haben (z. B. Office 365 globaler Administrator oder Power BI-Dienstadministrator).
Der Administratorbenutzer muss über ausreichende Nutzungsrechte verfügen, um Bezeichnungen zu löschen.

Erforderlicher Bereich

Tenant.ReadWrite.All

Einschränkungen

Maximal 25 Anforderungen pro Stunde.
Jede Anforderung kann bis zu 2.000 Power BI-Elemente aktualisieren.

POST https://api.powerbi.com/v1.0/myorg/admin/informationprotection/removeLabels

Anforderungstext

Name	Typ	Beschreibung
dashboards	ArtifactId[]	Eine Liste eindeutiger Dashboard-IDs
dataflows	ArtifactId[]	Eine Liste eindeutiger Datenfluss-IDs
datasets	ArtifactStringId[]	Eine Liste eindeutiger Dataset-IDs
reports	ArtifactId[]	Eine Liste der eindeutigen Berichts-IDs

Antworten

Name	Typ	Beschreibung
200 OK	InformationProtectionChangeLabelResponse	OK

Beispiele

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/admin/informationprotection/removeLabels

Request Body

{
  "dashboards": [
    {
      "id": "fe472f5e-636e-4c10-a1c6-7e9edc0b542a"
    },
    {
      "id": "476fcafe-b514-495d-b13f-ca9a4f0b1d8b"
    }
  ],
  "reports": [
    {
      "id": "fe472f5e-636e-4c10-a1c6-7e9edc0b542c"
    }
  ],
  "datasets": [
    {
      "id": "fe472f5e-636e-4c10-a1c6-7e9edc0b542e"
    },
    {
      "id": "myDatabaseName"
    }
  ],
  "dataflows": [
    {
      "id": "476fcafe-b514-495d-b13f-ca9a4f0b1d8g"
    }
  ]
}

Sample Response

Status code:: 200

{
  "dashboards": [
    {
      "id": "fe472f5e-636e-4c10-a1c6-7e9edc0b542a",
      "status": "NotFound"
    },
    {
      "id": "476fcafe-b514-495d-b13f-ca9a4f0b1d8b",
      "status": "Failed"
    }
  ],
  "reports": [
    {
      "id": "fe472f5e-636e-4c10-a1c6-7e9edc0b542c",
      "status": "Succeeded"
    }
  ],
  "datasets": [
    {
      "id": "fe472f5e-636e-4c10-a1c6-7e9edc0b542e",
      "status": "InsufficientUsageRights"
    },
    {
      "id": "myDatabaseName",
      "status": "FailedToGetUsageRights"
    }
  ],
  "dataflows": [
    {
      "id": "476fcafe-b514-495d-b13f-ca9a4f0b1d8g",
      "status": "Succeeded"
    }
  ]
}

Definitionen

Name	Beschreibung
ArtifactId	Die eindeutige ID eines Power BI-Elements im UUID-Format. Dashboard-, Berichts- und Datenfluss-IDs befinden sich im UUID-Format, und Dataset-IDs können sich im UUID- oder Zeichenfolgenformat befinden.
ArtifactStringId	Die eindeutige ID eines Power BI-Elements im Zeichenfolgen- oder UUID-Format. Dashboard-, Berichts- und Datenfluss-IDs befinden sich im UUID-Format, und Dataset-IDs können sich im UUID- oder Zeichenfolgenformat befinden.
ChangeLabelStatus	Der eindeutige ID- und Informationsschutzbezeichnungsstatus eines Power BI-Elements ändern
InformationProtectionArtifactsChangeLabel	Eine Kombination aus Power BI-Element-IDs für jeden Elementtyp. Die IDs geben an, welche Power BI-Elemente eine Aktualisierung der Informationsschutzbezeichnung erfordern.
InformationProtectionChangeLabelResponse	Ein Zusammengesetzt aus dem Status der ID- und Informationsschutzbezeichnung für einen oder mehrere Power BI-Elemente, die nach Typ organisiert sind
status	Der Status eines Änderungsvorgangs für den Informationsschutz

ArtifactId

Die eindeutige ID eines Power BI-Elements im UUID-Format. Dashboard-, Berichts- und Datenfluss-IDs befinden sich im UUID-Format, und Dataset-IDs können sich im UUID- oder Zeichenfolgenformat befinden.

Name	Typ	Beschreibung
id	string	Eine ID im UUID-Format

ArtifactStringId

Die eindeutige ID eines Power BI-Elements im Zeichenfolgen- oder UUID-Format. Dashboard-, Berichts- und Datenfluss-IDs befinden sich im UUID-Format, und Dataset-IDs können sich im UUID- oder Zeichenfolgenformat befinden.

Name	Typ	Beschreibung
id	string	Eine ID im Zeichenfolgen- oder UUID-Format

ChangeLabelStatus

Der eindeutige ID- und Informationsschutzbezeichnungsstatus eines Power BI-Elements ändern

Name	Typ	Beschreibung
id	string	Die eindeutige ID eines Power BI-Elements. Die ID befindet sich im UUID-Format für Dashboards, Berichte und Datenflüsse; und im UUID- oder Zeichenfolgenformat für Datasets.
status	status	Der Status eines Änderungsvorgangs für den Informationsschutz

InformationProtectionArtifactsChangeLabel

Eine Kombination aus Power BI-Element-IDs für jeden Elementtyp. Die IDs geben an, welche Power BI-Elemente eine Aktualisierung der Informationsschutzbezeichnung erfordern.

Name	Typ	Beschreibung
dashboards	ArtifactId[]	Eine Liste eindeutiger Dashboard-IDs
dataflows	ArtifactId[]	Eine Liste eindeutiger Datenfluss-IDs
datasets	ArtifactStringId[]	Eine Liste eindeutiger Dataset-IDs
reports	ArtifactId[]	Eine Liste der eindeutigen Berichts-IDs

InformationProtectionChangeLabelResponse

Ein Zusammengesetzt aus dem Status der ID- und Informationsschutzbezeichnung für einen oder mehrere Power BI-Elemente, die nach Typ organisiert sind

Name	Typ	Beschreibung
dashboards	ChangeLabelStatus[]	Eine Liste mit dem eindeutigen ID- und Informationsschutzbezeichnungsänderungsstatus eines oder mehrerer Dashboards
dataflows	ChangeLabelStatus[]	Eine Liste mit dem eindeutigen ID- und Informationsschutzbezeichnungsänderungsstatus eines oder mehrerer Datenflüsse
datasets	ChangeLabelStatus[]	Eine Liste mit dem eindeutigen ID- und Informationsschutzbezeichnungsänderungsstatus eines oder mehrerer Datasets
reports	ChangeLabelStatus[]	Eine Liste mit dem eindeutigen ID- und Informationsschutzbezeichnungsstatus eines oder mehrerer Berichte

status

Der Status eines Änderungsvorgangs für den Informationsschutz

Name	Typ	Beschreibung
Failed	string	Fehler beim Festlegen einer neuen Bezeichnung. Versuchen Sie es erneut.
FailedToGetUsageRights	string	Fehler beim Festlegen einer neuen Bezeichnung. Das Power BI-Element verfügt über eine Vertraulichkeitsbezeichnung mit Schutzeinstellungen, und Power BI konnte nicht überprüfen, ob der Benutzer über ausreichende Nutzungsrechte verfügt, um die Bezeichnung zu ändern.
InsufficientUsageRights	string	Fehler beim Festlegen einer neuen Bezeichnung. Das Power BI-Element verfügt über eine Vertraulichkeitsbezeichnung mit Schutzeinstellungen, und der Administratorbenutzer (und der delegierte Benutzer, sofern angegeben), verfügt nicht über ausreichende Nutzungsrechte, um die Bezeichnung zu ändern.
NotFound	string	Die Power BI-Element-ID oder Bezeichnung wurde nicht gefunden.
Succeeded	string	Die Power BI-Elementbezeichnung wurde geändert.