Udostępnij za pośrednictwem


Admin - InformationProtection RemoveLabelsAsAdmin

Usuń etykiety poufności z elementów usługi Power BI (takich jak raporty lub pulpity nawigacyjne) według identyfikatora elementu.

Aby zapoznać się z przykładem użycia, zobacz Ustawianie lub usuwanie etykiet poufności.

Uprawnienia

  • Użytkownik musi mieć uprawnienia administratora (takie jak administrator globalny Office 365 lub administrator usługi Power BI).
  • Użytkownik administracyjny musi mieć wystarczające prawa użytkowania , aby usunąć etykiety.

Wymagany zakres

Tenant.ReadWrite.All

Ograniczenia

  • Maksymalnie 25 żądań na godzinę.
  • Każde żądanie może zaktualizować maksymalnie 2000 elementów usługi Power BI.

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

Treść żądania

Nazwa Typ Opis
dashboards

ArtifactId[]

Lista unikatowych identyfikatorów pulpitu nawigacyjnego

dataflows

ArtifactId[]

Lista unikatowych identyfikatorów przepływów danych

datasets

ArtifactStringId[]

Lista unikatowych identyfikatorów zestawów danych

reports

ArtifactId[]

Lista unikatowych identyfikatorów raportów

Odpowiedzi

Nazwa Typ Opis
200 OK

InformationProtectionChangeLabelResponse

OK

Przykłady

Example

Sample Request

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

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

Definicje

Nazwa Opis
ArtifactId

Unikatowy identyfikator elementu usługi Power BI w formacie UUID. Identyfikatory pulpitu nawigacyjnego, raportu i przepływu danych są w formacie UUID, a identyfikatory zestawów danych mogą być w formacie UUID lub ciągu.

ArtifactStringId

Unikatowy identyfikator elementu usługi Power BI w formacie ciągu lub UUID. Identyfikatory pulpitu nawigacyjnego, raportu i przepływu danych są w formacie UUID, a identyfikatory zestawów danych mogą być w formacie UUID lub ciągu.

ChangeLabelStatus

Stan zmiany unikatowego identyfikatora i etykiety ochrony informacji elementu usługi Power BI

InformationProtectionArtifactsChangeLabel

Złożony identyfikator elementów usługi Power BI dla każdego typu elementu. Identyfikatory określają, które elementy usługi Power BI wymagają aktualizacji etykiety ochrony informacji.

InformationProtectionChangeLabelResponse

Złożony stan zmiany etykiety identyfikatora i ochrony informacji dla co najmniej jednego elementu usługi Power BI zorganizowanego według typu

status

Stan operacji zmiany etykiety ochrony informacji

ArtifactId

Unikatowy identyfikator elementu usługi Power BI w formacie UUID. Identyfikatory pulpitu nawigacyjnego, raportu i przepływu danych są w formacie UUID, a identyfikatory zestawów danych mogą być w formacie UUID lub ciągu.

Nazwa Typ Opis
id

string

Identyfikator w formacie UUID

ArtifactStringId

Unikatowy identyfikator elementu usługi Power BI w formacie ciągu lub UUID. Identyfikatory pulpitu nawigacyjnego, raportu i przepływu danych są w formacie UUID, a identyfikatory zestawów danych mogą być w formacie UUID lub ciągu.

Nazwa Typ Opis
id

string

Identyfikator w formacie ciągu lub UUID

ChangeLabelStatus

Stan zmiany unikatowego identyfikatora i etykiety ochrony informacji elementu usługi Power BI

Nazwa Typ Opis
id

string

Unikatowy identyfikator elementu usługi Power BI. Identyfikator jest w formacie UUID dla pulpitów nawigacyjnych, raportów i przepływów danych; i w formacie UUID lub ciągu dla zestawów danych.

status

status

Stan operacji zmiany etykiety ochrony informacji

InformationProtectionArtifactsChangeLabel

Złożony identyfikator elementów usługi Power BI dla każdego typu elementu. Identyfikatory określają, które elementy usługi Power BI wymagają aktualizacji etykiety ochrony informacji.

Nazwa Typ Opis
dashboards

ArtifactId[]

Lista unikatowych identyfikatorów pulpitu nawigacyjnego

dataflows

ArtifactId[]

Lista unikatowych identyfikatorów przepływów danych

datasets

ArtifactStringId[]

Lista unikatowych identyfikatorów zestawów danych

reports

ArtifactId[]

Lista unikatowych identyfikatorów raportów

InformationProtectionChangeLabelResponse

Złożony stan zmiany etykiety identyfikatora i ochrony informacji dla co najmniej jednego elementu usługi Power BI zorganizowanego według typu

Nazwa Typ Opis
dashboards

ChangeLabelStatus[]

Lista zawierająca unikatowy identyfikator i stan zmiany etykiety ochrony informacji co najmniej jednego pulpitu nawigacyjnego

dataflows

ChangeLabelStatus[]

Lista zawierająca unikatowy identyfikator i stan zmiany etykiety ochrony informacji co najmniej jednego przepływu danych

datasets

ChangeLabelStatus[]

Lista zawierająca unikatowy identyfikator i stan zmiany etykiety ochrony informacji dla co najmniej jednego zestawu danych

reports

ChangeLabelStatus[]

Lista zawierająca unikatowy identyfikator i stan zmiany etykiety ochrony informacji co najmniej jednego raportu

status

Stan operacji zmiany etykiety ochrony informacji

Nazwa Typ Opis
Failed

string

Nie można ustawić nowej etykiety. Spróbuj ponownie.

FailedToGetUsageRights

string

Nie można ustawić nowej etykiety. Element usługi Power BI ma etykietę poufności z ustawieniami ochrony, a usługa Power BI nie może sprawdzić, czy użytkownik ma wystarczające prawa użytkowania, aby zmienić etykietę.

InsufficientUsageRights

string

Nie można ustawić nowej etykiety. Element usługi Power BI ma etykietę poufności z ustawieniami ochrony, a administrator (i użytkownik delegowany, jeśli podano) nie ma wystarczających praw użytkowania, aby zmienić etykietę.

NotFound

string

Nie znaleziono identyfikatora lub etykiety elementu usługi Power BI

Succeeded

string

Zmieniono etykietę elementu usługi Power BI