다음을 통해 공유


Admin - WorkspaceInfo PostWorkspaceInfo

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

중요

또는 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
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
{
  "workspaces": [
    "97d03602-4873-4760-b37e-1563ef5358e3",
    "67b7e93a-3fb3-493c-9e41-2c5051008f24"
  ]
}

Sample Response

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

검사 상태