Udostępnij przez


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.

Permissions

  • Użytkownik musi być administratorem sieci szkieletowej.
  • Administrator 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ć do 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

Przykładowe żądanie

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

Przykładowa odpowiedź

{
  "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 pulpitów nawigacyjnych, raportów i przepływów 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 pulpitów nawigacyjnych, raportów i przepływów 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 pulpitów nawigacyjnych, raportów i przepływów danych są w formacie UUID, a identyfikatory zestawów danych mogą być w formacie UUID lub ciągu.

Nazwa Typ Opis
id

string (uuid)

Identyfikator w formacie UUID

ArtifactStringId

Unikatowy identyfikator elementu usługi Power BI w formacie ciągu lub UUID. Identyfikatory pulpitów nawigacyjnych, raportów i przepływów 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 etykietę ochrony informacji o stanie zmiany co najmniej jednego pulpitu nawigacyjnego

dataflows

ChangeLabelStatus[]

Lista zawierająca unikatowy identyfikator i etykietę ochrony informacji o stanie zmiany co najmniej jednego przepływu danych

datasets

ChangeLabelStatus[]

Lista zawierająca unikatowy identyfikator i etykietę ochrony informacji o stanie zmiany co najmniej jednego zestawu danych

reports

ChangeLabelStatus[]

Lista zawierająca unikatowy identyfikator i etykietę ochrony informacji o stanie zmiany co najmniej jednego raportu

status

Stan operacji zmiany etykiety ochrony informacji

Wartość Opis
Failed

Nie można ustawić nowej etykiety. Ponów próbę.

FailedToGetUsageRights

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

InsufficientUsageRights

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

NotFound

Nie można odnaleźć identyfikatora lub etykiety elementu usługi Power BI

Succeeded

Etykieta elementu usługi Power BI została zmieniona