Admin - InformationProtection SetLabelsAsAdmin

Reference

Service:: Power BI REST APIs

API Version:: v1.0

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

Pokud chcete nastavit popisek citlivosti pomocí tohoto rozhraní API, musí mít uživatel správce nebo delegovaný uživatel (pokud je k dispozici) popisek uvedený v zásadách popisku. 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 správce a delegovaný uživatel (pokud je k dispozici) musí mít dostatečná práva k používání k nastavení 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/setLabels

Text požadavku

Name	Vyžadováno	Typ	Description
artifacts	True	InformationProtectionArtifactsChangeLabel	Složená z ID položek Power BI pro každý typ položky
labelId	True	string	ID popisku, které musí být v zásadách popisků uživatele.
assignmentMethod		assignmentMethod	Určuje, jestli byl přiřazený popisek nastavený automatizovaným procesem nebo ručně.
delegatedUser		DelegatedUser	Podrobnosti delegovaného uživatele Delegovaný uživatel je uživatel v organizaci, jehož správce nastaví popisek jménem uživatele. I když správce nastaví popisek, delegovaný uživatel se označí jako vystavitel štítku.

Odpovědi

Name	Typ	Description
200 OK	InformationProtectionChangeLabelResponse	OK

Příklady

Example

Sample Request

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

Request Body

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

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.
assignmentMethod	Určuje, jestli byl přiřazený popisek nastavený automatizovaným procesem nebo ručně.
ChangeLabelStatus	Jedinečný stav ID a popisku ochrany informací u položky Power BI
DelegatedUser	Podrobnosti delegovaného uživatele Uživatel musí být existujícím uživatelem v Power BI a Azure AAD a během posledních tří měsíců se musí přihlásit k Power BI.
InformationProtectionArtifactsChangeLabel	Složená z 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í.
InformationProtectionChangeLabelDetails	Složená z informací o popisku vyžadovaných k aktualizaci popisku ochrany informací
InformationProtectionChangeLabelResponse	Složená ze stavu 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

assignmentMethod

Určuje, jestli byl přiřazený popisek nastavený automatizovaným procesem nebo ručně.

Name	Typ	Description
Priviledged	string	Popisek byl nastaven ručně.
Standard	string	Popisek byl nastaven automatizovaným procesem (výchozí hodnota)

ChangeLabelStatus

Jedinečný stav 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í

DelegatedUser

Podrobnosti delegovaného uživatele Uživatel musí být existujícím uživatelem v Power BI a Azure AAD a během posledních tří měsíců se musí přihlásit k Power BI.

Name	Typ	Description
emailAddress	string	E-mailová adresa delegovaného uživatele

InformationProtectionArtifactsChangeLabel

Složená z 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ího panelu
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

InformationProtectionChangeLabelDetails

Složená z informací o popisku vyžadovaných k aktualizaci popisku ochrany informací

Name	Typ	Description
artifacts	InformationProtectionArtifactsChangeLabel	Složená z ID položek Power BI pro každý typ položky
assignmentMethod	assignmentMethod	Určuje, jestli byl přiřazený popisek nastavený automatizovaným procesem nebo ručně.
delegatedUser	DelegatedUser	Podrobnosti delegovaného uživatele Delegovaný uživatel je uživatel v organizaci, jehož správce nastaví popisek jménem uživatele. I když správce nastaví popisek, delegovaný uživatel se označí jako vystavitel štítku.
labelId	string	ID popisku, které musí být v zásadách popisků uživatele.

InformationProtectionChangeLabelResponse

Složená ze stavu 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 popisku ochrany informací u jednoho nebo několika řídicích panelů
dataflows	ChangeLabelStatus[]	Seznam obsahující jedinečný stav ID a popisku ochrany informací u jednoho nebo více 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í 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, jestli má uživatel dostatečná práva na 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 správce (a delegovaný uživatel, pokud je k dispozici), nemá dostatečná práva na 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 byl změněn.