Admin - InformationProtection SetLabelsAsAdmin

Legen Sie Vertraulichkeitsbezeichnungen für Power BI-Elemente (z. B. Berichte oder Dashboards) nach Element-ID fest.

Um eine Vertraulichkeitsbezeichnung mit dieser API festzulegen, muss der Administratorbenutzer oder der delegierte Benutzer (sofern angegeben) die Bezeichnung in der Bezeichnungsrichtlinie enthalten. Ein Verwendungsbeispiel finden Sie unter Festlegen oder Entfernen von Vertraulichkeitsbezeichnungen.

Erlaubnisse

• Der Benutzer muss ein Fabric-Administrator sein.
• Der Administratorbenutzer und der delegierte Benutzer (sofern angegeben) müssen über ausreichende Nutzungsrechte zum Festlegen von Bezeichnungen verfügen.

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/setLabels

Anforderungstext

Antworten

Beispiele

Example

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

{
  "artifacts": {
    "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"
      }
    ]
  },
  "labelId": "fe472f5e-636e-4c10-a1c6-7e9edc0b542p",
  "assignmentMethod": "Standard",
  "delegatedUser": {
    "emailAddress": "john@contoso.com"
  }
}

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

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.

assignmentMethod

Gibt an, ob die zugewiesene Bezeichnung von einem automatisierten Prozess oder manuell festgelegt wurde.

ChangeLabelStatus

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

DelegatedUser

Delegierte Benutzerdetails. Der Benutzer muss ein vorhandener Benutzer in Power BI und Azure AAD sein und sich in den letzten drei Monaten bei Power BI angemeldet haben.

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.

InformationProtectionChangeLabelDetails

Eine Kombination aus Bezeichnungsinformationen, die zum Aktualisieren einer Informationsschutzbezeichnung erforderlich sind

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