共用方式為

Admin - InformationProtection SetLabelsAsAdmin

服務:
Power BI REST APIs
API 版本:
v1.0

依專案識別碼在 Power BI 專案 （例如報表或儀錶板） 上設定敏感度標籤。

若要使用此 API 設定敏感度標籤，系統管理員使用者或委派使用者 （如果提供） 必須在其 標籤原則中包含標籤。 如需使用範例，請參閱 設定或移除敏感度標籤。

權限

  • 使用者必須是 Fabric 系統管理員。
  • 管理員使用者和委派使用者 （如果提供） 必須具有足夠的 使用權限 來設定標籤。

必要範圍

租戶.ReadWrite.All

局限性

  • 每小時最多 25 個請求。
  • 每個要求最多可以更新 2,000 個 Power BI 專案。 

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

要求本文

名稱 必要 類型 Description
artifacts True

InformationProtectionArtifactsChangeLabel

每個專案類型的 Power BI 專案識別碼複合
labelId True

string (uuid)

標籤 ID，必須位於使用者的標籤原則中。
assignmentMethod

assignmentMethod

指定指派的標籤是由自動化程序設定還是手動設定。
delegatedUser

DelegatedUser

委派的使用者詳細資料。 委派使用者是組織內的使用者，其管理員會代表使用者設定標籤。 雖然管理員會設定標籤，但委派的使用者會標示為標籤簽發者。

回應

名稱 類型 Description
200 OK

InformationProtectionChangeLabelResponse

OK

範例

Example

範例要求

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

範例回覆

狀態碼:
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"
    }
  ]
}

定義

名稱 Description
ArtifactId

UUID 格式的 Power BI 專案的唯一識別碼。 儀表板、報表和資料流程ID是UUID格式，資料集ID可以是UUID或字串格式。
ArtifactStringId

字串或 UUID 格式的 Power BI 專案的唯一識別碼。 儀表板、報表和資料流程ID是UUID格式，資料集ID可以是UUID或字串格式。
assignmentMethod

指定指派的標籤是由自動化程序設定還是手動設定。
ChangeLabelStatus

Power BI 專案的唯一識別碼和資訊保護標籤變更狀態
DelegatedUser

委派的使用者詳細資料。 使用者必須是 Power BI 和 Azure AAD 中的現有使用者，而且必須在過去三個月內登入 Power BI。
InformationProtectionArtifactsChangeLabel

每個項目類型的 Power BI 項目識別碼複合。 識別碼會指定哪些 Power BI 專案需要資訊保護標籤更新。
InformationProtectionChangeLabelDetails

更新資訊保護標籤所需的標籤資訊複合
InformationProtectionChangeLabelResponse

依類型組織的一或多個 Power BI 專案的識別碼和資訊保護標籤變更狀態的複合
status

資訊保護標籤變更作業的狀態

ArtifactId

Object

UUID 格式的 Power BI 專案的唯一識別碼。 儀表板、報表和資料流程ID是UUID格式，資料集ID可以是UUID或字串格式。

名稱 類型 Description
id

string (uuid)

UUID 格式的 ID

ArtifactStringId

Object

字串或 UUID 格式的 Power BI 專案的唯一識別碼。 儀表板、報表和資料流程ID是UUID格式，資料集ID可以是UUID或字串格式。

名稱 類型 Description
id

string

字串或UUID格式的ID

assignmentMethod

列舉型別

指定指派的標籤是由自動化程序設定還是手動設定。

值 Description
Standard

標籤是由自動化程序設定的 （預設值）
Priviledged

標籤是手動設定的

ChangeLabelStatus

Object

Power BI 專案的唯一識別碼和資訊保護標籤變更狀態

名稱 類型 Description
id

string

Power BI 專案的唯一識別碼。 ID採用儀表板、報表和資料流的UUID格式;以及資料集的 UUID 或字串格式。
status

status

資訊保護標籤變更作業的狀態

DelegatedUser

Object

委派的使用者詳細資料。 使用者必須是 Power BI 和 Azure AAD 中的現有使用者，而且必須在過去三個月內登入 Power BI。

名稱 類型 Description
emailAddress

string

委派使用者的電子郵件地址

InformationProtectionArtifactsChangeLabel

Object

每個項目類型的 Power BI 項目識別碼複合。 識別碼會指定哪些 Power BI 專案需要資訊保護標籤更新。

名稱 類型 Description
dashboards

ArtifactId[]

唯一儀表板 ID 清單
dataflows

ArtifactId[]

唯一資料流程ID清單
datasets

ArtifactStringId[]

唯一資料集 ID 清單
reports

ArtifactId[]

唯一報表 ID 清單

InformationProtectionChangeLabelDetails

Object

更新資訊保護標籤所需的標籤資訊複合

名稱 類型 Description
artifacts

InformationProtectionArtifactsChangeLabel

每個專案類型的 Power BI 專案識別碼複合
assignmentMethod

assignmentMethod

指定指派的標籤是由自動化程序設定還是手動設定。
delegatedUser

DelegatedUser

委派的使用者詳細資料。 委派使用者是組織內的使用者，其管理員會代表使用者設定標籤。 雖然管理員會設定標籤，但委派的使用者會標示為標籤簽發者。
labelId

string (uuid)

標籤 ID，必須位於使用者的標籤原則中。

InformationProtectionChangeLabelResponse

Object

依類型組織的一或多個 Power BI 專案的識別碼和資訊保護標籤變更狀態的複合

名稱 類型 Description
dashboards

ChangeLabelStatus[]

包含一或多個儀表板的唯一 ID 和資訊保護標籤變更狀態的清單
dataflows

ChangeLabelStatus[]

包含一或多個資料流程的唯一識別碼和資訊保護標籤變更狀態的清單
datasets

ChangeLabelStatus[]

包含一或多個資料集的唯一 ID 和資訊保護標籤變更狀態的清單
reports

ChangeLabelStatus[]

包含一或多個報告的唯一識別碼和資訊保護標籤變更狀態的清單

status

列舉型別

資訊保護標籤變更作業的狀態

值 Description
Failed

無法設定新標籤。 請重試。
FailedToGetUsageRights

無法設定新標籤。 Power BI 專案具有具有保護設定的敏感度標籤，而 Power BI 無法確認使用者有足夠的使用權限來變更標籤。
InsufficientUsageRights

無法設定新標籤。 Power BI 專案具有具有保護設定的敏感度標籤，而系統管理員使用者 （和委派的使用者，如果提供） 沒有足夠的使用權限來變更標籤。
NotFound

找不到 Power BI 專案識別碼或標籤
Succeeded

Power BI 專案標籤已變更