Admin - InformationProtection SetLabelsAsAdmin

참조

Service:: Power BI REST APIs

API Version:: v1.0

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

이 API를 사용하여 민감도 레이블을 설정하려면 관리자 사용자 또는 위임된 사용자(제공된 경우)가 레이블 정책에 포함되어 있어야 합니다. 사용 예제는 민감도 레이블 설정 또는 제거를 참조하세요.

사용 권한

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

필수 범위

Tenant.ReadWrite.All

제한 사항

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

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

요청 본문

Name	필수	형식	Description
artifacts	True	InformationProtectionArtifactsChangeLabel	각 항목 유형에 대한 Power BI 항목 ID의 복합
labelId	True	string	사용자의 레이블 정책에 있어야 하는 레이블 ID입니다.
assignmentMethod		assignmentMethod	할당된 레이블이 자동화된 프로세스에 의해 설정되었는지 또는 수동으로 설정되었는지를 지정합니다.
delegatedUser		DelegatedUser	위임된 사용자 세부 정보입니다. 위임된 사용자는 관리자가 사용자를 대신하여 레이블을 설정하는 조직 내의 사용자입니다. 관리자가 레이블을 설정하지만 위임된 사용자는 레이블 발급자로 표시됩니다.

응답

Name	형식	Description
200 OK	InformationProtectionChangeLabelResponse	정상

예제

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

정의

Name	Description
ArtifactId	UUID 형식의 Power BI 항목의 고유 ID입니다. 대시보드, 보고서 및 데이터 흐름 ID는 UUID 형식이며 데이터 세트 ID는 UUID 또는 문자열 형식일 수 있습니다.
ArtifactStringId	문자열 또는 UUID 형식의 Power BI 항목의 고유 ID입니다. 대시보드, 보고서 및 데이터 흐름 ID는 UUID 형식이며 데이터 세트 ID는 UUID 또는 문자열 형식일 수 있습니다.
assignmentMethod	할당된 레이블이 자동화된 프로세스에 의해 설정되었는지 또는 수동으로 설정되었는지를 지정합니다.
ChangeLabelStatus	Power BI 항목의 고유 ID 및 정보 보호 레이블 변경 상태
DelegatedUser	위임된 사용자 세부 정보입니다. 사용자는 Power BI 및 Azure AAD의 기존 사용자여야 하며 지난 3개월 동안 Power BI에 로그인해야 합니다.
InformationProtectionArtifactsChangeLabel	각 항목 유형에 대한 Power BI 항목 ID의 복합입니다. ID는 정보 보호 레이블 업데이트가 필요한 Power BI 항목을 지정합니다.
InformationProtectionChangeLabelDetails	정보 보호 레이블을 업데이트하는 데 필요한 레이블 정보의 복합
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

assignmentMethod

할당된 레이블이 자동화된 프로세스에 의해 설정되었는지 또는 수동으로 설정되었는지를 지정합니다.

Name	형식	Description
Priviledged	string	레이블이 수동으로 설정되었습니다.
Standard	string	레이블이 자동화된 프로세스(기본값)에 의해 설정되었습니다.

ChangeLabelStatus

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

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

DelegatedUser

위임된 사용자 세부 정보입니다. 사용자는 Power BI 및 Azure AAD의 기존 사용자여야 하며 지난 3개월 동안 Power BI에 로그인해야 합니다.

Name	형식	Description
emailAddress	string	위임된 사용자의 이메일 주소

InformationProtectionArtifactsChangeLabel

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

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

InformationProtectionChangeLabelDetails

정보 보호 레이블을 업데이트하는 데 필요한 레이블 정보의 복합

Name	형식	Description
artifacts	InformationProtectionArtifactsChangeLabel	각 항목 유형에 대한 Power BI 항목 ID의 복합
assignmentMethod	assignmentMethod	할당된 레이블이 자동화된 프로세스에 의해 설정되었는지 또는 수동으로 설정되었는지를 지정합니다.
delegatedUser	DelegatedUser	위임된 사용자 세부 정보입니다. 위임된 사용자는 관리자가 사용자를 대신하여 레이블을 설정하는 조직 내의 사용자입니다. 관리자가 레이블을 설정하지만 위임된 사용자는 레이블 발급자로 표시됩니다.
labelId	string	사용자의 레이블 정책에 있어야 하는 레이블 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 항목 레이블이 변경되었습니다.