Sdílet prostřednictvím


Admin - InformationProtection SetLabelsAsAdmin

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

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