Admin - WorkspaceInfo PostWorkspaceInfo

참조

Service:: Power BI REST APIs

API Version:: v1.0

요청된 작업 영역 목록에 대한 메타데이터를 수신하는 호출을 시작합니다.

중요

또는 datasetExpressions 매개 변수를 datasetSchematrue로 설정하면 데이터를 반환하려면 메타데이터 검사를 완전히 사용하도록 설정해야 합니다. 자세한 내용은 메타데이터 검사에 테넌트 설정 사용을 참조하세요.

사용 권한

사용자에게 관리자 권한(예: Microsoft 365 전역 관리자 또는 Power BI 서비스 관리자)이 있거나 서비스 주체를 사용하여 인증해야 합니다.

서비스 주체 인증으로 실행하는 경우 앱은 Azure Portal Power BI에 대해 관리자 동의가 필요한 권한이 설정되어 있지 않아야 합니다.

필수 범위

Tenant.Read.All 또는 Tenant.ReadWrite.All

표준 위임된 관리자 액세스 토큰을 통해 인증하는 경우에만 관련됩니다. 서비스 주체를 통한 인증을 사용할 때는 존재하지 않아야 합니다.

제한 사항

시간당 최대 500개의 요청.
최대 16개의 동시 요청.

POST https://api.powerbi.com/v1.0/myorg/admin/workspaces/getInfo

With optional parameters:

POST https://api.powerbi.com/v1.0/myorg/admin/workspaces/getInfo?lineage={lineage}&datasourceDetails={datasourceDetails}&datasetSchema={datasetSchema}&datasetExpressions={datasetExpressions}&getArtifactUsers={getArtifactUsers}

URI 매개 변수

Name	In(다음 안에)	형식	Description
datasetExpressions	query	boolean	데이터 세트 식(DAX 및 매시업 쿼리)을 반환할지 여부입니다. 이 매개 변수를 로 `true`설정하면 데이터가 반환되려면 메타데이터 검사를 완전히 사용하도록 설정해야 합니다. 자세한 내용은 메타데이터 검사에 테넌트 설정 사용을 참조하세요.
datasetSchema	query	boolean	데이터 세트 스키마(테이블, 열 및 측정값)를 반환할지 여부입니다. 이 매개 변수를 로 `true`설정하면 데이터가 반환되려면 메타데이터 검사를 완전히 사용하도록 설정해야 합니다. 자세한 내용은 메타데이터 검사에 테넌트 설정 사용을 참조하세요.
datasourceDetails	query	boolean	데이터 원본 세부 정보를 반환할지 여부
getArtifactUsers	query	boolean	Power BI 항목에 대한 사용자 세부 정보(예: 보고서 또는 대시보드)를 반환할지 여부
lineage	query	boolean	계보 정보(업스트림 데이터 흐름, 타일, 데이터 원본 ID)를 반환할지 여부

요청 본문

Name	형식	Description
workspaces	string[]	검사하는 데 필요한 작업 영역 ID(1~100개의 작업 영역 ID 지원)

응답

Name	형식	Description
202 Accepted	ScanRequest	수락됨

예제

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/admin/workspaces/getInfo?lineage=True&datasourceDetails=True&datasetSchema=True&datasetExpressions=True

Request Body

{
  "workspaces": [
    "97d03602-4873-4760-b37e-1563ef5358e3",
    "67b7e93a-3fb3-493c-9e41-2c5051008f24"
  ]
}

Sample Response

Status code:: 202

{
  "id": "e7d03602-4873-4760-b37e-1563ef5358e3",
  "createdDateTime": "2020-06-15T16:46:28.0487687Z",
  "status": "NotStarted"
}

정의

Name	Description
PowerBIApiErrorResponseDetail	Power BI 오류 응답에 대한 자세한 정보
RequiredWorkspaces	필요한 작업 영역 요청
ScanRequest	검사 요청

PowerBIApiErrorResponseDetail

Power BI 오류 응답에 대한 자세한 정보

Name	형식	Description
code	string	오류 코드
message	string	오류 메시지입니다.
target	string	오류 대상

RequiredWorkspaces

필요한 작업 영역 요청

Name	형식	Description
workspaces	string[]	검사하는 데 필요한 작업 영역 ID(1~100개의 작업 영역 ID 지원)

ScanRequest

검사 요청

Name	형식	Description
createdDateTime	string	스캔 생성 날짜 및 시간
error	PowerBIApiErrorResponseDetail	검사 오류(있는 경우)
id	string	스캔 ID
status	string	검사 상태