Admin - Dataflows GetDataflowsAsAdmin

참조

서비스:: Power BI REST APIs

API 버전:: v1.0

조직의 데이터 흐름 목록을 반환합니다.

권한을

사용자는 패브릭 관리자이거나 서비스 주체를 사용하여 인증해야 합니다.
위임된 권한이 지원됩니다.

서비스 기본 인증에서 실행하는 경우 앱 Azure Portal에서 설정된 Power BI에 대한 관리자 동의 필수 사전이 없어야 합니다.

필수 범위

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

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

제한

시간당 최대 200개 요청

GET https://api.powerbi.com/v1.0/myorg/admin/dataflows

선택적 매개 변수:

GET https://api.powerbi.com/v1.0/myorg/admin/dataflows?$filter={$filter}&$top={$top}&$skip={$skip}

URI 매개 변수

Name	In(다음 안에)	형식	Description
$filter	query	string	Odata 필터 쿼리 매개 변수 조건에 따라 결과의 하위 집합을 반환합니다.
$skip	query	integer int32	첫 번째 n 결과를 건너뜁니다.
$top	query	integer int32	첫 번째 n 결과만 반환합니다.

응답

Name	형식	Description
200 OK	AdminDataflows	그래

예제

Example

샘플 요청

GET https://api.powerbi.com/v1.0/myorg/admin/dataflows

샘플 응답

상태 코드:: 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",
      "configuredBy": "john@contoso.com",
      "workspaceId": "6369a442-4bc4-425c-916d-460c42be746b"
    }
  ]
}

정의

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

AdminDataflow

관리자 API에서 반환하는 데이터 흐름의 메타데이터입니다. 다음은 데이터 흐름에 대해 반환될 수 있는 속성 목록입니다. 호출된 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[]	(빈 값) 데이터 흐름 사용자 액세스 세부 정보입니다. 이 속성은 향후 릴리스에서 페이로드 응답에서 제거됩니다. 데이터 흐름 사용자를 관리자 API 호출로 가져오기 또는 `getArtifactUser` 매개 변수를 사용하여 PostWorkspaceInfo API 호출을 사용하여 Power BI 데이터 흐름에서 사용자 정보를 검색할 수 있습니다.
workspaceId	string	데이터 흐름 작업 영역 ID입니다.

AdminDataflows

Power BI 관리자 데이터 흐름 컬렉션에 대한 OData 응답 래퍼

Name	형식	Description
odata.context	string	OData 컨텍스트
value	AdminDataflow[]	보고서 컬렉션

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

다음을 통해 공유