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 |
Lista unikatowych identyfikatorów pulpitu nawigacyjnego |
|
| dataflows |
Lista unikatowych identyfikatorów przepływów danych |
|
| datasets |
Lista unikatowych identyfikatorów zestawów danych |
|
| reports |
Lista unikatowych identyfikatorów raportów |
Odpowiedzi
| Nazwa | Typ | Opis |
|---|---|---|
| 200 OK |
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 |
|---|---|
|
Artifact |
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. |
|
Artifact |
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. |
|
Change |
Stan zmiany unikatowego identyfikatora i etykiety ochrony informacji elementu usługi Power BI |
|
Information |
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. |
|
Information |
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 |
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 |
Lista unikatowych identyfikatorów pulpitu nawigacyjnego |
|
| dataflows |
Lista unikatowych identyfikatorów przepływów danych |
|
| datasets |
Lista unikatowych identyfikatorów zestawów danych |
|
| reports |
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 |
Lista zawierająca unikatowy identyfikator i etykietę ochrony informacji o stanie zmiany co najmniej jednego pulpitu nawigacyjnego |
|
| dataflows |
Lista zawierająca unikatowy identyfikator i etykietę ochrony informacji o stanie zmiany co najmniej jednego przepływu danych |
|
| datasets |
Lista zawierająca unikatowy identyfikator i etykietę ochrony informacji o stanie zmiany co najmniej jednego zestawu danych |
|
| reports |
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 |