Admin - InformationProtection RemoveLabelsAsAdmin

Reference

Service:: Power BI REST APIs

API Version:: v1.0

Odeberte popisky citlivosti z položek Power BI (například sestav nebo řídicích panelů) podle ID položky.

Příklad použití najdete v tématu Nastavení nebo odebrání popisků citlivosti.

Oprávnění

Uživatel musí mít práva správce (například Office 365 globálního správce nebo správce služby Power BI).
Uživatel s oprávněním správce musí mít dostatečná práva k odstranění popisků.

Požadovaný obor

Tenant.ReadWrite.All

Omezení

Maximálně 25 požadavků za hodinu.
Každý požadavek může aktualizovat až 2 000 položek Power BI.

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

Text požadavku

Name	Typ	Description
dashboards	ArtifactId[]	Seznam jedinečných ID řídicích panelů
dataflows	ArtifactId[]	Seznam jedinečných ID toku dat
datasets	ArtifactStringId[]	Seznam jedinečných ID datových sad
reports	ArtifactId[]	Seznam jedinečných ID sestav

Odpovědi

Name	Typ	Description
200 OK	InformationProtectionChangeLabelResponse	OK

Příklady

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"
    }
  ]
}

Definice

Name	Description
ArtifactId	Jedinečné ID položky Power BI ve formátu UUID ID řídicího panelu, sestavy a toku dat jsou ve formátu UUID a ID datových sad můžou být ve formátu UUID nebo řetězce.
ArtifactStringId	Jedinečné ID položky Power BI ve formátu řetězce nebo UUID ID řídicího panelu, sestavy a toku dat jsou ve formátu UUID a ID datových sad můžou být ve formátu UUID nebo řetězce.
ChangeLabelStatus	Stav změny jedinečného ID a popisku ochrany informací u položky Power BI
InformationProtectionArtifactsChangeLabel	Složené ID položek Power BI pro každý typ položky ID určují, které položky Power BI vyžadují aktualizaci popisku ochrany informací.
InformationProtectionChangeLabelResponse	Složený stav změny ID a popisku ochrany informací pro jednu nebo více položek Power BI uspořádaných podle typu
status	Stav operace změny popisku ochrany informací

ArtifactId

Jedinečné ID položky Power BI ve formátu UUID ID řídicího panelu, sestavy a toku dat jsou ve formátu UUID a ID datových sad můžou být ve formátu UUID nebo řetězce.

Name	Typ	Description
id	string	ID ve formátu UUID

ArtifactStringId

Jedinečné ID položky Power BI ve formátu řetězce nebo UUID ID řídicího panelu, sestavy a toku dat jsou ve formátu UUID a ID datových sad můžou být ve formátu UUID nebo řetězce.

Name	Typ	Description
id	string	ID ve formátu řetězce nebo UUID

ChangeLabelStatus

Stav změny jedinečného ID a popisku ochrany informací u položky Power BI

Name	Typ	Description
id	string	Jedinečné ID položky Power BI ID je ve formátu UUID pro řídicí panely, sestavy a toky dat; a ve formátu UUID nebo řetězce pro datové sady.
status	status	Stav operace změny popisku ochrany informací

InformationProtectionArtifactsChangeLabel

Složené ID položek Power BI pro každý typ položky ID určují, které položky Power BI vyžadují aktualizaci popisku ochrany informací.

Name	Typ	Description
dashboards	ArtifactId[]	Seznam jedinečných ID řídicích panelů
dataflows	ArtifactId[]	Seznam jedinečných ID toku dat
datasets	ArtifactStringId[]	Seznam jedinečných ID datových sad
reports	ArtifactId[]	Seznam jedinečných ID sestav

InformationProtectionChangeLabelResponse

Složený stav změny ID a popisku ochrany informací pro jednu nebo více položek Power BI uspořádaných podle typu

Name	Typ	Description
dashboards	ChangeLabelStatus[]	Seznam obsahující jedinečné ID a stav změny popisku ochrany informací jednoho nebo několika řídicích panelů
dataflows	ChangeLabelStatus[]	Seznam obsahující jedinečné ID a stav změny popisku ochrany informací u jednoho nebo několika toků dat
datasets	ChangeLabelStatus[]	Seznam obsahující jedinečné ID a stav změny popisku ochrany informací u jedné nebo více datových sad
reports	ChangeLabelStatus[]	Seznam obsahující jedinečné ID a stav změny popisku ochrany informací u jedné nebo více sestav

status

Stav operace změny popisku ochrany informací

Name	Typ	Description
Failed	string	Nepodařilo se nastavit nový popisek. Zkuste to prosím znovu.
FailedToGetUsageRights	string	Nepodařilo se nastavit nový popisek. Položka Power BI má popisek citlivosti s nastavením ochrany a Power BI nemohl ověřit, že má uživatel dostatečná práva k použití ke změně popisku.
InsufficientUsageRights	string	Nepodařilo se nastavit nový popisek. Položka Power BI má popisek citlivosti s nastavením ochrany a uživatel s delegovaným uživatelem (pokud je k dispozici) nemá dostatečná práva k použití ke změně popisku.
NotFound	string	ID nebo popisek položky Power BI se nenašlo.
Succeeded	string	Popisek položky Power BI se změnil.

Share via