Freigeben über

Admin - InformationProtection RemoveLabelsAsAdmin

Dienst:
Power BI REST APIs
API-Version:
v1.0

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

Ein Verwendungsbeispiel finden Sie unter Festlegen oder Entfernen von Vertraulichkeitsbezeichnungen.

Erlaubnisse

  • Der Benutzer muss ein Fabric-Administrator sein.
  • 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 eindeutiger Berichts-IDs

Antworten

Name Typ Beschreibung
200 OK

InformationProtectionChangeLabelResponse

OKAY

Beispiele

Example

Beispielanforderung

POST https://api.powerbi.com/v1.0/myorg/admin/informationprotection/removeLabels
Anforderungstext
{
  "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"
    }
  ]
}

Beispiel für eine Antwort

Statuscode:
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

Die eindeutige ID und die Bezeichnung für den Informationsschutz ändern den Status eines Power BI-Elements.
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

Eine Kombination aus dem Id- und Informationsschutzbezeichnungsänderungsstatus für ein oder mehrere Power BI-Elemente, die nach Typ organisiert sind
status

Der Status eines Änderungsvorgangs für Informationsschutzbezeichnungen

ArtifactId

Objekt

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 (uuid)

Eine ID im UUID-Format

ArtifactStringId

Objekt

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

Objekt

Die eindeutige ID und die Bezeichnung für den Informationsschutz ändern den Status eines Power BI-Elements.

Name Typ Beschreibung
id

string

Die eindeutige ID eines Power BI-Elements. Die ID ist 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 Informationsschutzbezeichnungen

InformationProtectionArtifactsChangeLabel

Objekt

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 eindeutiger Berichts-IDs

InformationProtectionChangeLabelResponse

Objekt

Eine Kombination aus dem Id- und Informationsschutzbezeichnungsänderungsstatus für ein oder mehrere Power BI-Elemente, die nach Typ organisiert sind

Name Typ Beschreibung
dashboards

ChangeLabelStatus[]

Eine Liste mit der eindeutigen ID und der Bezeichnung "Information Protection" ändern den Status eines oder mehrerer Dashboards.
dataflows

ChangeLabelStatus[]

Eine Liste, die die eindeutige ID und den Status der Bezeichnung "Information Protection" eines oder mehrerer Datenflüsse enthält
datasets

ChangeLabelStatus[]

Eine Liste mit der eindeutigen ID und dem Status der Bezeichnung "Information Protection" eines oder mehrerer Datasets
reports

ChangeLabelStatus[]

Eine Liste mit der eindeutigen ID und dem Status der Bezeichnung "Information Protection" eines oder mehrerer Berichte

status

Enumeration

Der Status eines Änderungsvorgangs für Informationsschutzbezeichnungen

Wert Beschreibung
Failed

Fehler beim Festlegen einer neuen Bezeichnung. Versuchen Sie es erneut.
FailedToGetUsageRights

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

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

Die Power BI-Element-ID oder -Bezeichnung wurde nicht gefunden.
Succeeded

Die Power BI-Elementbezeichnung wurde geändert.