Admin - InformationProtection SetLabelsAsAdmin

Referensi

Service:: Power BI REST APIs

API Version:: v1.0

Atur label sensitivitas pada item Power BI (seperti laporan atau dasbor) menurut ID item.

Untuk mengatur label sensitivitas menggunakan API ini, pengguna admin atau pengguna yang didelegasikan (jika disediakan) harus memiliki label yang disertakan dalam kebijakan label mereka. 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 dan pengguna yang didelegasikan (jika disediakan) harus memiliki hak penggunaan yang memadai untuk mengatur 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/setLabels

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
artifacts	True	InformationProtectionArtifactsChangeLabel	Komposit ID item Power BI untuk setiap jenis item
labelId	True	string	ID label, yang harus berada dalam kebijakan label pengguna.
assignmentMethod		assignmentMethod	Menentukan apakah label yang ditetapkan ditetapkan oleh proses otomatis atau secara manual.
delegatedUser		DelegatedUser	Detail pengguna yang didelegasikan. Pengguna yang didelegasikan adalah pengguna dalam organisasi yang adminnya menetapkan label atas nama pengguna. Meskipun admin mengatur label, pengguna yang didelegasikan ditandai sebagai penerbit label.

Respons

Nama	Jenis	Deskripsi
200 OK	InformationProtectionChangeLabelResponse	OK

Contoh

Example

Sample Request

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

Request Body

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

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.
assignmentMethod	Menentukan apakah label yang ditetapkan ditetapkan oleh proses otomatis atau secara manual.
ChangeLabelStatus	ID unik dan label proteksi informasi mengubah status item Power BI
DelegatedUser	Detail pengguna yang didelegasikan. Pengguna harus menjadi pengguna yang sudah ada di Power BI dan Azure AAD, dan harus masuk ke Power BI selama tiga bulan terakhir.
InformationProtectionArtifactsChangeLabel	Komposit ID item Power BI untuk setiap jenis item. ID menentukan item Power BI mana yang memerlukan pembaruan label proteksi informasi.
InformationProtectionChangeLabelDetails	Komposit informasi label yang diperlukan untuk memperbarui label perlindungan 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

assignmentMethod

Menentukan apakah label yang ditetapkan ditetapkan oleh proses otomatis atau secara manual.

Nama	Jenis	Deskripsi
Priviledged	string	Label diatur secara manual
Standard	string	Label diatur oleh proses otomatis (nilai default)

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

DelegatedUser

Detail pengguna yang didelegasikan. Pengguna harus menjadi pengguna yang sudah ada di Power BI dan Azure AAD, dan harus masuk ke Power BI selama tiga bulan terakhir.

Nama	Jenis	Deskripsi
emailAddress	string	Alamat email pengguna yang didelegasikan

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

InformationProtectionChangeLabelDetails

Komposit informasi label yang diperlukan untuk memperbarui label perlindungan informasi

Nama	Jenis	Deskripsi
artifacts	InformationProtectionArtifactsChangeLabel	Komposit ID item Power BI untuk setiap jenis item
assignmentMethod	assignmentMethod	Menentukan apakah label yang ditetapkan ditetapkan oleh proses otomatis atau secara manual.
delegatedUser	DelegatedUser	Detail pengguna yang didelegasikan. Pengguna yang didelegasikan adalah pengguna dalam organisasi yang adminnya menetapkan label atas nama pengguna. Meskipun admin mengatur label, pengguna yang didelegasikan ditandai sebagai penerbit label.
labelId	string	ID label, yang harus berada dalam kebijakan label pengguna.

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