Admin - InformationProtection RemoveLabelsAsAdmin

Referensi

Service:: Power BI REST APIs

API Version:: v1.0

Hapus label sensitivitas dari item Power BI (seperti laporan atau dasbor) menurut ID item.

Untuk contoh penggunaan, lihat Mengatur atau menghapus label sensitivitas.

Izin

Pengguna harus memiliki hak administrator (seperti Office 365 Administrator Global atau Administrator Layanan Power BI).
Pengguna admin harus memiliki hak penggunaan yang memadai untuk menghapus label.

Cakupan yang Diperlukan

Tenant.ReadWrite.All

Batasan

Maksimum 25 permintaan per jam.
Setiap permintaan dapat memperbarui hingga 2.000 item Power BI.

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

Isi Permintaan

Nama	Jenis	Deskripsi
dashboards	ArtifactId[]	Daftar ID dasbor unik
dataflows	ArtifactId[]	Daftar ID aliran data unik
datasets	ArtifactStringId[]	Daftar ID himpunan data unik
reports	ArtifactId[]	Daftar ID laporan unik

Respons

Nama	Jenis	Deskripsi
200 OK	InformationProtectionChangeLabelResponse	OK

Contoh

Example

Sample Request

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

Request Body

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

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

Definisi

Nama	Deskripsi
ArtifactId	ID unik item Power BI dalam format UUID. ID dasbor, laporan, dan aliran data dalam format UUID, dan ID himpunan data dapat dalam format UUID atau string.
ArtifactStringId	ID unik item Power BI dalam format string atau UUID. ID dasbor, laporan, dan aliran data dalam format UUID, dan ID himpunan data dapat dalam format UUID atau string.
ChangeLabelStatus	ID unik dan label proteksi informasi mengubah status item Power BI
InformationProtectionArtifactsChangeLabel	Komposit ID item Power BI untuk setiap jenis item. ID menentukan item Power BI mana yang memerlukan pembaruan label proteksi informasi.
InformationProtectionChangeLabelResponse	Komposit id dan status perubahan label proteksi informasi untuk satu atau beberapa item Power BI yang diatur menurut jenis
status	Status operasi perubahan label perlindungan informasi

ArtifactId

ID unik item Power BI dalam format UUID. ID dasbor, laporan, dan aliran data dalam format UUID, dan ID himpunan data dapat dalam format UUID atau string.

Nama	Jenis	Deskripsi
id	string	ID dalam format UUID

ArtifactStringId

ID unik item Power BI dalam format string atau UUID. ID dasbor, laporan, dan aliran data dalam format UUID, dan ID himpunan data dapat dalam format UUID atau string.

Nama	Jenis	Deskripsi
id	string	ID dalam format string atau UUID

ChangeLabelStatus

ID unik dan label proteksi informasi mengubah status item Power BI

Nama	Jenis	Deskripsi
id	string	ID unik item Power BI. ID dalam format UUID untuk dasbor, laporan, dan aliran data; dan dalam format UUID atau string untuk himpunan data.
status	status	Status operasi perubahan label perlindungan informasi

InformationProtectionArtifactsChangeLabel

Komposit ID item Power BI untuk setiap jenis item. ID menentukan item Power BI mana yang memerlukan pembaruan label proteksi informasi.

Nama	Jenis	Deskripsi
dashboards	ArtifactId[]	Daftar ID dasbor unik
dataflows	ArtifactId[]	Daftar ID aliran data unik
datasets	ArtifactStringId[]	Daftar ID himpunan data unik
reports	ArtifactId[]	Daftar ID laporan unik

InformationProtectionChangeLabelResponse

Komposit id dan status perubahan label proteksi informasi untuk satu atau beberapa item Power BI yang diatur menurut jenis

Nama	Jenis	Deskripsi
dashboards	ChangeLabelStatus[]	Daftar yang berisi ID unik dan status perubahan label perlindungan informasi dari satu atau beberapa dasbor
dataflows	ChangeLabelStatus[]	Daftar yang berisi ID unik dan status perubahan label perlindungan informasi dari satu atau beberapa aliran data
datasets	ChangeLabelStatus[]	Daftar yang berisi ID unik dan status perubahan label perlindungan informasi dari satu atau beberapa himpunan data
reports	ChangeLabelStatus[]	Daftar yang berisi ID unik dan status perubahan label perlindungan informasi dari satu atau beberapa laporan

status

Status operasi perubahan label perlindungan informasi

Nama	Jenis	Deskripsi
Failed	string	Gagal menyetel label baru. Coba lagi.
FailedToGetUsageRights	string	Gagal menyetel label baru. Item Power BI memiliki label sensitivitas dengan pengaturan perlindungan, dan Power BI tidak dapat memverifikasi bahwa pengguna memiliki hak penggunaan yang memadai untuk mengubah label.
InsufficientUsageRights	string	Gagal menyetel label baru. Item Power BI memiliki label sensitivitas dengan pengaturan perlindungan, dan pengguna admin (dan pengguna yang didelegasikan, jika disediakan) tidak memiliki hak penggunaan yang memadai untuk mengubah label.
NotFound	string	ID atau label item Power BI tidak ditemukan
Succeeded	string	Label item Power BI diubah

Share via