Dataflows - Get Dataflows

Service:

Power BI REST APIs

API Version:

v1.0

지정된 작업 영역의 모든 데이터 흐름 목록을 반환합니다.

사용 권한

이 API 호출은 서비스 주체 프로필에서 호출할 수 있습니다. 자세한 내용은 Power BI Embedded 서비스 주체 프로필을 참조하세요.

필수 범위

Dataflow.ReadWrite.All 또는 Dataflow.Read.All

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/dataflows

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
groupId	path	True	string uuid	작업 영역 ID

응답

Name	형식	Description
200 OK	Dataflows	정상

예제

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/groups/a2f89923-421a-464e-bf4c-25eab39bb09f/dataflows

Sample Response

Status code:

200

{
  "value": [
    {
      "objectId": "bd32e5c0-363f-430b-a03b-5535a4804b9b",
      "name": "AdventureWorks",
      "description": "Our Adventure Works",
      "modelUrl": "https://MyDataflowStorageAccount.dfs.core.windows.net/powerbi/contoso/AdventureWorks/model.json"
    }
  ]
}

정의

Name	Description
Dataflow	데이터 흐름의 메타데이터입니다. 다음은 데이터 흐름에 대해 반환될 수 있는 속성 목록입니다. 호출된 API, 호출자 권한 및 Power BI 데이터베이스의 데이터 가용성에 따라 속성의 하위 집합만 반환됩니다.
Dataflows	데이터 흐름 메타데이터 목록에 대한 OData 응답 래퍼
DataflowUser	데이터 흐름에 대한 Power BI 사용자 액세스 권한 항목
DataflowUserAccessRight	사용자가 데이터 흐름에 대해 갖는 액세스 권한(권한 수준)
PrincipalType	보안 주체 유형
ServicePrincipalProfile	Power BI 서비스 보안 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션에만 관련됩니다.

Dataflow

데이터 흐름의 메타데이터입니다. 다음은 데이터 흐름에 대해 반환될 수 있는 속성 목록입니다. 호출된 API, 호출자 권한 및 Power BI 데이터베이스의 데이터 가용성에 따라 속성의 하위 집합만 반환됩니다.

Name	형식	Description
configuredBy	string	데이터 흐름 소유자
description	string	데이터 흐름 설명
modelUrl	string	데이터 흐름 정의 파일의 URL(model.json)
modifiedBy	string	데이터 흐름을 수정한 사용자
modifiedDateTime	string	데이터 흐름이 마지막으로 수정된 날짜 및 시간
name	string	데이터 흐름 이름
objectId	string	데이터 흐름 ID
users	DataflowUser[]	(빈 값) 데이터 흐름 사용자 액세스 세부 정보입니다. 이 속성은 예정된 릴리스에서 페이로드 응답에서 제거됩니다. Dataflow 사용자를 관리 API 호출로 가져오기 또는 매개 변수를 사용하여 PostWorkspaceInfo API 호출 getArtifactUser 을 사용하여 Power BI 데이터 흐름에 대한 사용자 정보를 검색할 수 있습니다.

Dataflows

데이터 흐름 메타데이터 목록에 대한 OData 응답 래퍼

Name	형식	Description
odata.context	string
value	Dataflow[]	데이터 흐름 메타데이터 목록

DataflowUser

데이터 흐름에 대한 Power BI 사용자 액세스 권한 항목

Name	형식	Description
DataflowUserAccessRight	DataflowUserAccessRight	사용자가 데이터 흐름에 대해 갖는 액세스 권한(권한 수준)
displayName	string	보안 주체의 표시 이름
emailAddress	string	사용자의 이메일 주소입니다.
graphId	string	Microsoft Graph의 보안 주체 식별자입니다. 관리자 API에만 사용할 수 있습니다.
identifier	string	보안 주체의 식별자
principalType	PrincipalType	보안 주체 유형
profile	ServicePrincipalProfile	Power BI 서비스 보안 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션에만 관련됩니다.
userType	string	사용자 유형입니다.

DataflowUserAccessRight

사용자가 데이터 흐름에 대해 갖는 액세스 권한(권한 수준)

Name	형식	Description
None	string	데이터 흐름의 콘텐츠에 대한 사용 권한을 제거합니다.
Owner	string	데이터 흐름의 콘텐츠에 대한 읽기, 쓰기 및 다시 공유 액세스 권한 부여
Read	string	데이터 흐름의 콘텐츠에 대한 읽기 액세스 권한 부여
ReadReshare	string	데이터 흐름의 콘텐츠에 대한 읽기 및 다시 공유 액세스 권한 부여
ReadWrite	string	데이터 흐름의 콘텐츠에 대한 읽기 및 쓰기 액세스 권한 부여

PrincipalType

보안 주체 유형

Name	형식	Description
App	string	서비스 주체 유형
Group	string	그룹 보안 주체 유형
None	string	보안 주체 유형이 없습니다. 전체 조직 수준 액세스에 사용합니다.
User	string	사용자 계정 유형

ServicePrincipalProfile

Power BI 서비스 보안 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션에만 관련됩니다.

Name	형식	Description
displayName	string	서비스 주체 프로필 이름
id	string	서비스 주체 프로필 ID