Bagikan melalui


Admin - InformationProtection SetLabelsAsAdmin

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

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