Admin - InformationProtection RemoveLabelsAsAdmin

참조

Service:: Power BI REST APIs

API Version:: v1.0

항목 ID별로 Power BI 항목(예: 보고서 또는 대시보드)에서 민감도 레이블을 제거합니다.

사용 예제는 민감도 레이블 설정 또는 제거를 참조하세요.

사용 권한

사용자에게 관리자 권한(예: Office 365 전역 관리자 또는 Power BI 서비스 관리자)이 있어야 합니다.
관리자에게 레이블을 삭제할 수 있는 충분한 사용 권한이 있어야 합니다.

필수 범위

Tenant.ReadWrite.All

제한 사항

시간당 최대 25개 요청.
각 요청은 최대 2,000개의 Power BI 항목을 업데이트할 수 있습니다.

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

요청 본문

Name	형식	Description
dashboards	ArtifactId[]	고유한 대시보드 ID 목록
dataflows	ArtifactId[]	고유한 데이터 흐름 ID 목록
datasets	ArtifactStringId[]	고유한 데이터 세트 ID 목록
reports	ArtifactId[]	고유한 보고서 ID 목록

응답

Name	형식	Description
200 OK	InformationProtectionChangeLabelResponse	정상

예제

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

정의

Name	Description
ArtifactId	UUID 형식의 Power BI 항목의 고유 ID입니다. 대시보드, 보고서 및 데이터 흐름 ID는 UUID 형식이며 데이터 세트 ID는 UUID 또는 문자열 형식일 수 있습니다.
ArtifactStringId	문자열 또는 UUID 형식의 Power BI 항목의 고유 ID입니다. 대시보드, 보고서 및 데이터 흐름 ID는 UUID 형식이며 데이터 세트 ID는 UUID 또는 문자열 형식일 수 있습니다.
ChangeLabelStatus	Power BI 항목의 고유 ID 및 정보 보호 레이블 변경 상태
InformationProtectionArtifactsChangeLabel	각 항목 유형에 대한 Power BI 항목 ID의 복합입니다. ID는 정보 보호 레이블 업데이트가 필요한 Power BI 항목을 지정합니다.
InformationProtectionChangeLabelResponse	형식별로 구성된 하나 이상의 Power BI 항목에 대한 ID 및 정보 보호 레이블 변경 상태의 복합
status	정보 보호 레이블 변경 작업의 상태

ArtifactId

UUID 형식의 Power BI 항목의 고유 ID입니다. 대시보드, 보고서 및 데이터 흐름 ID는 UUID 형식이며 데이터 세트 ID는 UUID 또는 문자열 형식일 수 있습니다.

Name	형식	Description
id	string	UUID 형식의 ID

ArtifactStringId

문자열 또는 UUID 형식의 Power BI 항목의 고유 ID입니다. 대시보드, 보고서 및 데이터 흐름 ID는 UUID 형식이며 데이터 세트 ID는 UUID 또는 문자열 형식일 수 있습니다.

Name	형식	Description
id	string	문자열 또는 UUID 형식의 ID

ChangeLabelStatus

Power BI 항목의 고유 ID 및 정보 보호 레이블 변경 상태

Name	형식	Description
id	string	Power BI 항목의 고유 ID입니다. ID는 대시보드, 보고서 및 데이터 흐름에 대한 UUID 형식입니다. 및 데이터 세트에 대한 UUID 또는 문자열 형식입니다.
status	status	정보 보호 레이블 변경 작업의 상태

InformationProtectionArtifactsChangeLabel

각 항목 유형에 대한 Power BI 항목 ID의 복합입니다. ID는 정보 보호 레이블 업데이트가 필요한 Power BI 항목을 지정합니다.

Name	형식	Description
dashboards	ArtifactId[]	고유한 대시보드 ID 목록
dataflows	ArtifactId[]	고유한 데이터 흐름 ID 목록
datasets	ArtifactStringId[]	고유한 데이터 세트 ID 목록
reports	ArtifactId[]	고유한 보고서 ID 목록

InformationProtectionChangeLabelResponse

형식별로 구성된 하나 이상의 Power BI 항목에 대한 ID 및 정보 보호 레이블 변경 상태의 복합

Name	형식	Description
dashboards	ChangeLabelStatus[]	하나 이상의 대시보드의 고유 ID 및 정보 보호 레이블 변경 상태를 포함하는 목록
dataflows	ChangeLabelStatus[]	하나 이상의 데이터 흐름의 고유 ID 및 정보 보호 레이블 변경 상태를 포함하는 목록
datasets	ChangeLabelStatus[]	하나 이상의 데이터 세트의 고유 ID 및 정보 보호 레이블 변경 상태를 포함하는 목록
reports	ChangeLabelStatus[]	하나 이상의 보고서의 고유 ID 및 정보 보호 레이블 변경 상태를 포함하는 목록

status

정보 보호 레이블 변경 작업의 상태

Name	형식	Description
Failed	string	새 레이블을 설정하지 못했습니다. 다시 시도하세요.
FailedToGetUsageRights	string	새 레이블을 설정하지 못했습니다. Power BI 항목에는 보호 설정이 있는 민감도 레이블이 있으며, Power BI에서 사용자에게 레이블을 변경할 수 있는 충분한 사용 권한이 있는지 확인할 수 없습니다.
InsufficientUsageRights	string	새 레이블을 설정하지 못했습니다. Power BI 항목에는 보호 설정이 있는 민감도 레이블이 있으며 관리 사용자(및 위임된 사용자(제공된 경우)에는 레이블을 변경할 수 있는 충분한 사용 권한이 없습니다.
NotFound	string	Power BI 항목 ID 또는 레이블을 찾을 수 없습니다.
Succeeded	string	Power BI 항목 레이블이 변경되었습니다.