Admin - WorkspaceInfo GetScanResult

참조

Service:: Power BI REST APIs

API Version:: v1.0

지정된 검사에 대한 검사 결과를 가져옵니다.

GetScanStatus API 호출이 성공한 후에만 이 API 호출을 수행합니다. 검사 결과는 24시간 동안 계속 사용할 수 있습니다.

사용 권한

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

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

필수 범위

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

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

제한 사항

시간당 최대 500개의 요청.

GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/scanResult/{scanId}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
scanId	path	True	string uuid	검사를 트리거한 작업 영역 또는 관리 - WorkspaceInfo PostWorkspaceInfo API 호출의 응답에 포함된 검사 ID입니다.

응답

Name	형식	Description
200 OK	WorkspaceInfoResponse	정상

예제

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/scanResult/e7d03602-4873-4760-b37e-1563ef5358e3

Sample Response

Status code:: 200

{
  "workspaces": [
    {
      "id": "d507422c-8d6d-4361-ac7a-30074a8cd0a1",
      "name": "V2 shared",
      "type": "Workspace",
      "state": "Active",
      "isOnDedicatedCapacity": true,
      "capacityId": "0f084df7-c13d-451b-af5f-ed0c466403b2",
      "defaultDatasetStorageFormat": "Small",
      "reports": [
        {
          "id": "c6d072d1-ed20-4b60-8329-16c4b934203b",
          "name": "CompositeModelParams-RLS",
          "datasetId": "132593c4-bf8d-4548-8f25-1ebb16a1613c",
          "createdDateTime": "2020-06-16T08:22:49.14",
          "modifiedDateTime": "2020-06-16T08:22:49.14",
          "modifiedBy": "john@contoso.com",
          "reportType": "PaginatedReport",
          "endorsementDetails": {
            "endorsement": "Certified",
            "certifiedBy": "john@contoso.com"
          },
          "sensitivityLabel": {
            "labelId": "85b38049-4259-43a2-8feb-244e222d96c0"
          },
          "users": [
            {
              "displayName": "John Nick",
              "emailAddress": "john@contoso.com",
              "appUserAccessRight": "ReadExplore",
              "identifier": "john@contoso.com",
              "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
              "principalType": "User"
            }
          ]
        }
      ],
      "dashboards": [
        {
          "id": "80814ece-9302-49e3-b6bc-bad2f7a86c1a",
          "displayName": "CompositeModelParamsDashboard",
          "isReadOnly": false,
          "tiles": [
            {
              "id": "e687cc21-5b32-48f5-8c5e-4b844f190579",
              "title": "CompositeModelParamsDashboard",
              "reportId": "c6d072d1-ed20-4b60-8329-16c4b934203b",
              "datasetId": "132593c4-bf8d-4548-8f25-1ebb16a1613c"
            }
          ],
          "sensitivityLabel": {
            "labelId": "d9b9581a-0594-4c39-81c5-91ddf40baeda"
          },
          "users": [
            {
              "displayName": "John Nick",
              "emailAddress": "john@contoso.com",
              "appUserAccessRight": "ReadExplore",
              "identifier": "john@contoso.com",
              "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
              "principalType": "User"
            }
          ]
        }
      ],
      "datasets": [
        {
          "id": "e7e8a355-e77b-4418-a7b8-ae5972fdaa03",
          "name": "ExportB",
          "tables": [
            {
              "name": "DW_Revenues",
              "columns": [
                {
                  "name": "RowNumber-2662979B-1795-4F74-8F37-6A1BA8059B61",
                  "dataType": "Int64",
                  "isHidden": true
                }
              ],
              "measures": [
                {
                  "name": "MyMeasure",
                  "expression": "CALCULATE(SELECTEDVALUE('DW_Revenues DW_RevenuesTestToBeDeleted'[Numbers])*10)",
                  "description": "My measure",
                  "isHidden": false
                }
              ],
              "isHidden": false,
              "description": "My table",
              "source": [
                {
                  "expression": "let\n    Source = Revenues,\n    Param = RevenuesParam\nin\n    Source"
                }
              ]
            }
          ],
          "relationships": [],
          "configuredBy": "john@contoso.com",
          "targetStorageMode": "Abf",
          "endorsementDetails": {
            "endorsement": "Certified",
            "certifiedBy": "john@contoso.com"
          },
          "expressions": [
            {
              "name": "Revenues",
              "description": "revenues",
              "expression": "let\n    Source = Sql.Database(\"sqlserver.database.windows.net\", \"DB\"),\n    RevenuesTable = Source{[Schema=\"DB_SCHEMA\",Item=\"DB_SCHEMA_ITEM\"]}[Data]\nin\n    RevenuesTable"
            },
            {
              "name": "RevenuesParam",
              "description": "revenues param",
              "expression": "\"revenues param value\" meta [IsParameterQuery=true, Type=\"Text\", IsParameterQueryRequired=true]"
            }
          ],
          "roles": [
            {
              "name": "Teams",
              "modelPermission": "Read",
              "members": [
                {
                  "memberName": "john@contoso.com",
                  "memberId": "ee96296b-fb71-4f65-a8af-c0ec5a7daced",
                  "memberType": "User",
                  "identityProvider": "AzureAD"
                },
                {
                  "memberName": "group@contoso.com",
                  "memberId": "0a1cdbc3-f82c-4001-8b96-be04ae9d25a3",
                  "memberType": "Group",
                  "identityProvider": "AzureAD"
                }
              ],
              "tablePermissions": [
                {
                  "name": "DW_Revenues DW_RevenuesTest",
                  "filterExpression": "[InTeams] = \"True\""
                }
              ]
            }
          ],
          "upstreamDataflows": [
            {
              "targetDataflowId": "a842dbb1-32ca-46b0-9648-498b2c2d5e38",
              "groupId": "b7416115-7421-42c0-b525-1505ce40d2f0"
            },
            {
              "targetDataflowId": "06898194-2eaf-4122-bacc-133db1f8585d",
              "groupId": "7263838d-80d7-4b8d-a1f6-50fc27e74a97"
            }
          ],
          "datasourceUsages": [
            {
              "datasourceInstanceId": "c79ad907-df19-43fe-a0f7-d9f365d67070"
            }
          ],
          "misconfiguredDatasourceUsages": [
            {
              "datasourceInstanceId": "80ec28bc-fe81-43ea-be52-a07a95cfbcab"
            }
          ],
          "sensitivityLabel": {
            "labelId": "bf3dc57d-d796-41c0-bbe9-a47f5ee3331e"
          },
          "users": [
            {
              "displayName": "John Nick",
              "emailAddress": "john@contoso.com",
              "appUserAccessRight": "ReadExplore",
              "identifier": "john@contoso.com",
              "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
              "principalType": "User"
            }
          ]
        }
      ],
      "dataflows": [
        {
          "objectId": "a842dbb1-32ca-46b0-9648-498b2c2d5e38",
          "name": "Azure SQL",
          "description": "Azure SQL dataflow",
          "configuredBy": "john@contoso.com",
          "modifiedBy": "john@contoso.com",
          "modifiedDateTime": "2020-06-16T08:27:47.783Z",
          "endorsementDetails": {
            "endorsement": "Certified",
            "certifiedBy": "john@contoso.com"
          },
          "datasourceUsages": [
            {
              "datasourceInstanceId": "c79ad907-df19-43fe-a0f7-d9f365d67070"
            }
          ],
          "misconfiguredDatasourceUsages": [
            {
              "datasourceInstanceId": "80ec28bc-fe81-43ea-be52-a07a95cfbcab"
            }
          ],
          "sensitivityLabel": {
            "labelId": "5c9f8c24-2a94-4fd2-a105-9a8b096c5af1"
          },
          "users": [
            {
              "displayName": "John Nick",
              "emailAddress": "john@contoso.com",
              "appUserAccessRight": "ReadExplore",
              "identifier": "john@contoso.com",
              "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
              "principalType": "User"
            }
          ]
        }
      ],
      "datamarts": [
        {
          "id": "9df8d63c-db5b-44c3-a8e3-9f8c8ec1eec2",
          "name": "MyDatamart",
          "description": "SQL datamart",
          "type": "Sql",
          "configuredBy": "john@contoso.com",
          "configuredById": "5c9f8c24-2a94-4fd2-a105-9a8b096cdsew",
          "modifiedBy": "john@contoso.com",
          "modifiedDateTime": "2020-06-16T08:27:47.783Z",
          "sensitivityLabel": {
            "labelId": "5c9f8c24-2a94-4fd2-a105-9a8b096c5af1"
          },
          "endorsementDetails": {
            "endorsement": "Certified",
            "certifiedBy": "john@contoso.com"
          },
          "UpstreamDataflows": [
            {
              "targetDataflowId": "5c9f8c24-2a94-34fd-a105-9a8b096c4555",
              "groupId": "5c9f8c24-4dsc-4fd2-a105-9a8b096c4fgt"
            }
          ],
          "datasourceUsages": [
            {
              "datasourceInstanceId": "c79ad907-df19-43fe-a0f7-d9f365d67070"
            }
          ],
          "Users": [
            {
              "displayName": "John Nick",
              "emailAddress": "john@contoso.com",
              "identifier": "john@contoso.com",
              "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
              "principalType": "User",
              "userType": "User",
              "profile": {
                "id": "45416453",
                "displayName": "John's profile"
              },
              "datamartUserAccessRight": "Read"
            }
          ]
        }
      ],
      "users": [
        {
          "displayName": "John Nick",
          "emailAddress": "john@contoso.com",
          "appUserAccessRight": "ReadExplore",
          "identifier": "john@contoso.com",
          "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
          "principalType": "User"
        }
      ]
    }
  ],
  "datasourceInstances": [
    {
      "datasourceType": "Sql",
      "connectionDetails": {
        "server": "qlserver.database.windows.net",
        "database": "dbo.largest_table"
      },
      "datasourceId": "c79ad907-df19-43fe-a0f7-d9f365d67070",
      "gatewayId": "e820592e-f8cf-4a6f-b1ed-566799d29565"
    }
  ],
  "misconfiguredDatasourceInstances": [
    {
      "datasourceType": "Sql",
      "connectionDetails": {
        "server": "sqlserver.database.windows.net",
        "database": "dbo.table"
      },
      "datasourceId": "80ec28bc-fe81-43ea-be52-a07a95cfbcab",
      "gatewayId": "505a19c1-4190-4e8e-a4f6-dd72722feced"
    }
  ]
}

정의

Name	Description
ASMashupExpression	데이터 세트 테이블 원본
Column	데이터 세트 열
DashboardUser	Dashboard 대한 Power BI 사용자 액세스 권한 항목
DashboardUserAccessRight	사용자가 dashboard 대한 액세스 권한(권한 수준)
DataflowUser	데이터 흐름에 대한 Power BI 사용자 액세스 권한 항목
DataflowUserAccessRight	사용자가 데이터 흐름에 대해 갖는 액세스 권한(권한 수준)
datamartState	데이터마트 현재 상태
datamartStatus	데이터 마트 상태
datamartType	데이터 마트 형식
DatamartUser	보고서에 대한 Power BI 사용자 액세스 권한 항목
DatamartUserAccessRight	사용자가 데이터마트에 대해 가지고 있는 액세스 권한(권한 수준)
DatasetUser	데이터 세트에 대한 Power BI 사용자 액세스 권한 항목
DatasetUserAccessRight	사용자가 데이터 세트에 대해 가지고 있는 액세스 권한(권한 수준)
Datasource	Power BI 데이터 원본
DatasourceConnectionDetails	Power BI 데이터 원본 연결 세부 정보입니다. 데이터 원본 가져오기 또는 그룹 내 데이터 원본 가져오기의 예제를 참조하세요.
DatasourceUsage	데이터 원본 사용
DefaultDatasetStorageFormat	그룹의 기본 데이터 세트 스토리지 형식
DependentDataflow	Power BI 종속 데이터 흐름
DependentDatamart	Power BI 종속 데이터 마트
DependentDataset	Power BI 종속 데이터 세트
EndorsementDetails	Power BI 인증 세부 정보
Expression	데이터 세트 식
GroupUser	작업 영역에 액세스할 수 있는 Power BI 사용자
GroupUserAccessRight	사용자가 작업 영역에 있는 액세스 권한(권한 수준)
Measure	Power BI 측정값
PrincipalType	보안 주체 유형
ReportUser	보고서에 대한 Power BI 사용자 액세스 권한 항목
ReportUserAccessRight	사용자가 보고서에 대해 가지고 있는 액세스 권한(권한 수준)
Role	데이터 세트의 RLS 구성에서 역할
RoleMember	역할 멤버
RoleTablePermission	역할 필터
Row	데이터 세트의 데이터 행
SensitivityLabel	Power BI 항목에 대한 민감도 레이블 정보(예: 보고서 또는 dashboard)
ServicePrincipalProfile	Power BI 서비스 보안 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션과만 관련이 있습니다.
Table	데이터 세트 테이블
WorkspaceInfo	작업 영역 정보 세부 정보
WorkspaceInfoDashboard	WorkspaceInfo API에서 반환된 Power BI dashboard. API는 다음 dashboard 속성 목록의 하위 집합을 반환합니다. 하위 집합은 라는 API, 호출자 권한 및 Power BI 데이터베이스의 데이터 가용성에 따라 달라집니다.
WorkspaceInfoDataflow	작업 영역 정보 API에서 반환된 데이터 흐름의 메타데이터입니다. 다음은 데이터 흐름에 대해 반환될 수 있는 속성 목록입니다. 호출된 API, 호출자 권한 및 Power BI 데이터베이스의 데이터 가용성에 따라 속성의 하위 집합만 반환됩니다.
WorkspaceInfoDatamart	작업 영역 정보 API에서 반환된 Power BI 데이터 마트입니다. API는 다음 데이터마트 속성 목록의 하위 집합을 반환합니다. 하위 집합은 라는 API, 호출자 권한 및 Power BI 데이터베이스의 데이터 가용성에 따라 달라집니다.
WorkspaceInfoDataset	WorkspaceInfo API에서 반환된 Power BI 데이터 세트입니다. API는 다음 데이터 세트 속성 목록의 하위 집합을 반환합니다. 하위 집합은 라는 API, 호출자 권한 및 Power BI 데이터베이스의 데이터 가용성에 따라 달라집니다.
WorkspaceInfoReport	작업 영역 정보 API에서 반환된 Power BI 보고서입니다. API는 다음 보고서 속성 목록의 하위 집합을 반환합니다. 하위 집합은 라는 API, 호출자 권한 및 Power BI 데이터베이스의 데이터 가용성에 따라 달라집니다.
WorkspaceInfoResponse	작업 영역 정보 응답
WorkspaceInfoTile	WorkspaceInfo API에서 반환된 Power BI 타일

ASMashupExpression

데이터 세트 테이블 원본

Name	형식	Description
expression	string	원본 식

Column

데이터 세트 열

Name	형식	Description
dataCategory	string	선택 사항입니다. 이 열 내의 데이터를 설명하는 데이터 범주에 사용할 문자열 값입니다.
dataType	string	열 데이터 형식
formatString	string	선택 사항입니다. FORMAT_STRING 지정된 열의 형식입니다.
isHidden	boolean	선택 사항입니다. 열이 숨겨져 있는지 여부입니다. 기본값은 `false`입니다.
name	string	열 이름
sortByColumn	string	선택 사항입니다. 현재 열을 정렬하는 데 사용하기 위해 동일 테이블에 있는 열의 문자열 이름입니다.
summarizeBy	string	선택 사항입니다. 이 열을 요약하는 데 사용할 집계 함수입니다.

DashboardUser

Dashboard 대한 Power BI 사용자 액세스 권한 항목

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

DashboardUserAccessRight

사용자가 dashboard 대한 액세스 권한(권한 수준)

Name	형식	Description
None	string	dashboard 콘텐츠에 대한 권한 없음
Owner	string	보고서의 콘텐츠에 대한 읽기, 쓰기 및 다시 공유 액세스 권한 부여
Read	string	dashboard 콘텐츠에 대한 읽기 권한을 부여합니다.
ReadCopy	string	dashboard 콘텐츠에 대한 읽기 및 복사 액세스 권한 부여
ReadReshare	string	dashboard 콘텐츠에 대한 읽기 및 다시 공유 액세스 권한 부여
ReadWrite	string	dashboard 콘텐츠에 대한 읽기 및 쓰기 액세스 권한 부여

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	데이터 흐름의 콘텐츠에 대한 읽기 및 쓰기 액세스 권한 부여

datamartState

데이터마트 현재 상태

Name	형식	Description
Active	string	데이터 마트가 활성 상태입니다.
Deleted	string	데이터 마트가 삭제되었습니다.
Evicted	string	데이터 마트가 제거되었습니다.
Initialized	string	데이터 마트가 초기화되었습니다.
Invalid	string	데이터 마트의 상태가 잘못되었습니다.
Migrating	string	데이터 마트가 마이그레이션 중임

datamartStatus

데이터 마트 상태

Name	형식	Description
Available	string	데이터 마트를 사용할 수 있습니다.
Error	string	데이터 마트에 오류 상태
InProgress	string	데이터 마트가 진행 중입니다.
Invalid	string	데이터 마트에 잘못된 상태
NoCapacity	string	데이터 마트에 용량이 없습니다.
OutOfRegion	string	데이터 마트가 지역을 벗어났습니다.
SuspendedInCriticalPhase	string	데이터 마트가 중요한 단계에서 일시 중단됨

datamartType

데이터 마트 형식

Name	형식	Description
Dataverse	string	데이터 마트는 Dataverse 형식입니다.
Datawarehouse	string	데이터 마트는 Datawarehouse 형식입니다.
Ignore	string	데이터 마트에 형식이 없습니다.
Lakehouse	string	데이터 마트는 Lakehouse 형식입니다.
Sql	string	데이터 마트는 Sql 형식입니다.
Unset	string	데이터 마트 형식이 설정되지 않았습니다.

DatamartUser

보고서에 대한 Power BI 사용자 액세스 권한 항목

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

DatamartUserAccessRight

사용자가 데이터마트에 대해 가지고 있는 액세스 권한(권한 수준)

Name	형식	Description
Explore	string	데이터마트의 콘텐츠에 대한 액세스 권한 탐색 권한 부여
None	string	데이터마트의 콘텐츠에 대한 사용 권한 없음
Read	string	데이터마트의 콘텐츠에 대한 읽기 액세스 권한 부여
ReadExplore	string	데이터마트의 콘텐츠에 대한 읽기 및 탐색 액세스 권한 부여
ReadReshare	string	데이터 마트의 콘텐츠에 대한 읽기 및 다시 공유 액세스 권한 부여
ReadReshareExplore	string	데이터마트의 콘텐츠에 대한 읽기 및 다시 공유 및 탐색 액세스 권한 부여
ReadWrite	string	데이터마트의 콘텐츠에 대한 읽기 및 쓰기 액세스 권한 부여
ReadWriteExplore	string	데이터마트의 콘텐츠에 대한 읽기 및 쓰기 및 탐색 액세스 권한 부여
ReadWriteReshare	string	데이터마트의 콘텐츠에 대한 읽기 및 쓰기 및 다시 공유 액세스 권한 부여
ReadWriteReshareExplore	string	데이터마트의 콘텐츠에 대한 읽기 및 쓰기 및 다시 공유 및 탐색 액세스 권한 부여
Reshare	string	데이터마트의 콘텐츠에 대한 재공개 액세스 권한 부여
Write	string	데이터마트의 콘텐츠에 대한 쓰기 액세스 권한 부여

DatasetUser

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

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

DatasetUserAccessRight

사용자가 데이터 세트에 대해 가지고 있는 액세스 권한(권한 수준)

Name	형식	Description
None	string	데이터 세트의 콘텐츠에 대한 사용 권한을 제거합니다.
Read	string	데이터 세트의 콘텐츠에 대한 읽기 액세스 권한 부여
ReadExplore	string	데이터 세트의 콘텐츠에 대한 읽기 및 탐색 액세스 권한 부여
ReadReshare	string	데이터 세트의 콘텐츠에 대한 읽기 및 다시 공유 액세스 권한 부여
ReadReshareExplore	string	데이터 세트의 콘텐츠에 대한 읽기, 다시 공유 및 탐색 액세스 권한 부여
ReadWrite	string	데이터 세트의 콘텐츠에 대한 읽기 및 쓰기 액세스 권한 부여
ReadWriteExplore	string	데이터 세트의 콘텐츠에 대한 읽기, 쓰기 및 탐색 액세스 권한 부여
ReadWriteReshare	string	데이터 세트의 콘텐츠에 대한 읽기, 쓰기 및 다시 공유 액세스 권한 부여
ReadWriteReshareExplore	string	데이터 세트의 콘텐츠에 대한 읽기, 쓰기, 다시 공유 및 탐색 액세스 권한 부여

Datasource

Power BI 데이터 원본

Name	형식	Description
connectionDetails	DatasourceConnectionDetails	데이터 원본 연결 세부 정보
connectionString	string	(사용되지 않음) 데이터 원본 연결 문자열. DirectQuery에만 사용할 수 있습니다.
datasourceId	string	게이트웨이에 바인딩되지 않은 경우 비어 있는 바인딩된 데이터 원본 ID
datasourceType	string	데이터 원본 형식
gatewayId	string	게이트웨이에 바인딩되지 않은 경우 비어 있는 바인딩된 게이트웨이 ID입니다. 게이트웨이 클러스터를 사용하는 경우 게이트웨이 ID는 클러스터의 기본(첫 번째) 게이트웨이를 참조하며 게이트웨이 클러스터 ID와 유사합니다.
name	string	(사용되지 않음) 데이터 원본 이름입니다. DirectQuery에만 사용할 수 있습니다.

DatasourceConnectionDetails

Power BI 데이터 원본 연결 세부 정보입니다. 데이터 원본 가져오기 또는 그룹 내 데이터 원본 가져오기의 예제를 참조하세요.

Name	형식	Description
account	string	연결 계정
classInfo	string	연결 클래스 정보
database	string	연결 데이터베이스
domain	string	연결 도메인
emailAddress	string	연결 전자 메일 주소
kind	string	연결 종류
loginServer	string	연결 로그인 서버
path	string	연결 경로
server	string	연결 서버
url	string	연결 URL

DatasourceUsage

데이터 원본 사용

Name	형식	Description
datasourceInstanceId	string	데이터 원본 instance ID

DefaultDatasetStorageFormat

그룹의 기본 데이터 세트 스토리지 형식

Name	형식	Description
Large	string	대용량 데이터 세트 스토리지 형식
Small	string	작은 데이터 세트 스토리지 형식

DependentDataflow

Power BI 종속 데이터 흐름

Name	형식	Description
groupId	string	대상 그룹 ID
targetDataflowId	string	대상 데이터 흐름 ID

DependentDatamart

Power BI 종속 데이터 마트

Name	형식	Description
groupId	string	대상 그룹 ID
targetDatamartId	string	대상 데이터 마트 ID

DependentDataset

Power BI 종속 데이터 세트

Name	형식	Description
groupId	string	대상 그룹 ID
targetDatasetId	string	대상 데이터 세트 ID

EndorsementDetails

Power BI 인증 세부 정보

Name	형식	Description
certifiedBy	string	Power BI 항목을 인증한 사용자(예: 보고서 또는 dashboard)
endorsement	string	인증 상태

Expression

데이터 세트 식

Name	형식	Description
description	string	식 설명
expression	ASMashupExpression	데이터 세트 테이블 원본
name	string	식 이름

GroupUser

작업 영역에 액세스할 수 있는 Power BI 사용자

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

GroupUserAccessRight

사용자가 작업 영역에 있는 액세스 권한(권한 수준)

Name	형식	Description
Admin	string	작업 영역 콘텐츠에 대한 관리자 권한
Contributor	string	작업 영역 콘텐츠에 대한 읽기 및 탐색(ReadExplore) 액세스
Member	string	작업 영역 콘텐츠에 대한 읽기, 다시 공유 및 탐색(ReadReshareExplore) 액세스 권한
None	string	작업 영역 콘텐츠에 대한 액세스 권한 없음
Viewer	string	작업 영역 콘텐츠에 대한 읽기 전용(읽기) 액세스

Measure

Power BI 측정값

Name	형식	Description
description	string	선택 사항입니다. 측정값 설명입니다.
expression	string	유효한 DAX 식
formatString	string	선택 사항입니다. 값이 FORMAT_STRING 지정된 대로 표시될 때 형식을 지정하는 방법을 설명하는 문자열입니다.
isHidden	boolean	선택 사항입니다. 측정값이 숨겨져 있는지 여부입니다.
name	string	측정값 이름

PrincipalType

보안 주체 유형

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

ReportUser

보고서에 대한 Power BI 사용자 액세스 권한 항목

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

ReportUserAccessRight

사용자가 보고서에 대해 가지고 있는 액세스 권한(권한 수준)

Name	형식	Description
None	string	보고서의 콘텐츠에 대한 사용 권한 없음
Owner	string	보고서의 콘텐츠에 대한 읽기, 쓰기 및 다시 공유 액세스 권한 부여
Read	string	보고서의 콘텐츠에 대한 읽기 액세스 권한 부여
ReadCopy	string	보고서의 콘텐츠에 대한 읽기 및 복사 액세스 권한 부여
ReadReshare	string	보고서의 콘텐츠에 대한 읽기 및 다시 공유 액세스 권한 부여
ReadWrite	string	보고서의 콘텐츠에 대한 읽기 및 쓰기 액세스 권한 부여

Role

데이터 세트의 RLS 구성에서 역할

Name	형식	Description
members	RoleMember	역할의 멤버를 나열하는 배열
modelPermission	string	역할의 데이터 세트에 대한 사용 권한입니다. 예를 들어 읽기
name	string	역할의 이름
tablePermissions	RoleTablePermission	역할에 대해 정의된 모든 필터를 나열하는 배열

RoleMember

역할 멤버

Name	형식	Description
identityProvider	string	역할 멤버 ID 공급자
memberId	string	ID 공급자가 할당한 역할 멤버 GUID
memberName	string	역할 멤버의 이름
memberType	string	역할 멤버 유형(사용자 또는 그룹)

RoleTablePermission

역할 필터

Name	형식	Description
filterExpression	string	필터에 지정된 테이블을 필터링하는 식입니다.
name	string	필터에 지정된 테이블의 이름

Row

데이터 세트의 데이터 행

Name	형식	Description
id	string	고유한 행 ID

SensitivityLabel

Power BI 항목에 대한 민감도 레이블 정보(예: 보고서 또는 dashboard)

Name	형식	Description
labelId	string	민감도 레이블 ID

ServicePrincipalProfile

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

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

Table

데이터 세트 테이블

Name	형식	Description
columns	Column[]	이 테이블의 열 스키마
description	string	테이블 설명
isHidden	boolean	선택 사항입니다. 이 데이터 세트 테이블이 숨겨져 있는지 여부입니다.
measures	Measure[]	이 테이블 내의 측정값
name	string	테이블 이름
rows	Row[]	이 테이블 내의 데이터 행
source	ASMashupExpression[]	테이블 원본

WorkspaceInfo

작업 영역 정보 세부 정보

Name	형식	Description
capacityId	string	작업 영역 용량 ID
dashboards	WorkspaceInfoDashboard[]	이 작업 영역과 연결된 대시보드입니다. 반환되는 dashboard 속성 목록은 다른 API 호출에 따라 다르므로 API 응답에 모든 dashboard 속성이 표시되지 않을 수 있습니다.
dataRetrievalState	string	작업 영역 데이터 검색 상태
dataflows	WorkspaceInfoDataflow[]	이 작업 영역과 연결된 데이터 흐름입니다. 반환되는 데이터 흐름 속성 목록은 다른 API 호출에 따라 다르므로 API 응답에 모든 데이터 흐름 속성이 표시되지 않을 수 있습니다.
datamarts	WorkspaceInfoDatamart[]	이 작업 영역과 연결된 데이터 마트입니다. 반환되는 데이터마트 속성 목록은 다른 API 호출에 따라 다르므로 API 응답에 모든 데이터 마트 속성이 표시되지 않을 수 있습니다.
datasets	WorkspaceInfoDataset[]	이 작업 영역과 연결된 데이터 세트입니다. 반환되는 데이터 세트 속성 목록은 다른 API 호출에 따라 다르므로 API 응답에 모든 데이터 세트 속성이 표시되지 않을 수 있습니다.
defaultDatasetStorageFormat	DefaultDatasetStorageFormat	작업 영역의 기본 데이터 세트 스토리지 형식입니다. 가 인 경우에만 반환됩니다.`isOnDedicatedCapacitytrue`
description	string	작업 영역 설명
id	string	작업 영역 개체 ID
isOnDedicatedCapacity	boolean	작업 영역이 전용 용량에 할당되는지 여부
name	string	작업 영역 이름
reports	WorkspaceInfoReport[]	이 작업 영역과 연결된 보고서입니다. 반환되는 보고서 속성 목록은 다른 API 호출에 따라 다르므로 API 응답에 모든 보고서 속성이 표시되지 않을 수 있습니다.
state	string	작업 영역 상태
type	string	작업 영역 유형
users	GroupUser[]	작업 영역에 액세스할 수 있는 사용자입니다. 목록은 명시적으로 요청된 경우에만 반환됩니다. 클래식 작업 영역에 대한 사용자 목록을 검색하려면 Azure Active Directory Graph API 사용합니다.

WorkspaceInfoDashboard

WorkspaceInfo API에서 반환된 Power BI dashboard. API는 다음 dashboard 속성 목록의 하위 집합을 반환합니다. 하위 집합은 라는 API, 호출자 권한 및 Power BI 데이터베이스의 데이터 가용성에 따라 달라집니다.

Name	형식	Description
appId	string	dashboard 앱에 속하는 경우에만 반환되는 앱 ID입니다.
dataClassification	string	Power BI 항목의 데이터 분류 태그(예: 보고서 또는 dashboard)
displayName	string	dashboard 표시 이름
id	string	dashboard ID
isReadOnly	boolean	dashboard 읽기 전용인지 여부
sensitivityLabel	SensitivityLabel	민감도 레이블
tiles	WorkspaceInfoTile[]	dashboard 속하는 타일
users	DashboardUser[]	(빈 값) dashboard 사용자 액세스 세부 정보입니다. 이 속성은 향후 릴리스에서 페이로드 응답에서 제거됩니다. 대시보드 사용자를 관리 API 호출로 가져오기 또는 매개 변수를 사용하여 PostWorkspaceInfo API 호출 `getArtifactUsers` 을 사용하여 Power BI dashboard 사용자 정보를 검색할 수 있습니다.

WorkspaceInfoDataflow

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

Name	형식	Description
configuredBy	string	데이터 흐름 소유자
datasourceUsages	DatasourceUsage[]	데이터 원본 사용량
description	string	데이터 흐름 설명
endorsementDetails	EndorsementDetails	인증 세부 정보
misconfiguredDatasourceUsages	DatasourceUsage[]	데이터 원본이 잘못 구성된 사용량
modelUrl	string	데이터 흐름 정의 파일에 대한 URL(model.json)
modifiedBy	string	데이터 흐름을 수정한 사용자
modifiedDateTime	string	데이터 흐름이 마지막으로 수정된 날짜 및 시간
name	string	데이터 흐름 이름
objectId	string	데이터 흐름 ID
sensitivityLabel	SensitivityLabel	민감도 레이블
upstreamDataflows	DependentDataflow[]	이 항목이 사용하는 모든 데이터 흐름 목록
upstreamDatamarts	DependentDatamart[]	이 항목이 사용하는 모든 데이터 마트 목록
users	DataflowUser[]	(빈 값) 데이터 흐름 사용자 액세스 세부 정보입니다. 이 속성은 향후 릴리스에서 페이로드 응답에서 제거됩니다. Dataflow 사용자를 관리 API 호출로 가져오기 또는 매개 변수를 사용하여 PostWorkspaceInfo API 호출 `getArtifactUser` 을 사용하여 Power BI 데이터 흐름에 대한 사용자 정보를 검색할 수 있습니다.

WorkspaceInfoDatamart

작업 영역 정보 API에서 반환된 Power BI 데이터 마트입니다. API는 다음 데이터마트 속성 목록의 하위 집합을 반환합니다. 하위 집합은 라는 API, 호출자 권한 및 Power BI 데이터베이스의 데이터 가용성에 따라 달라집니다.

Name	형식	Description
configuredBy	string	데이터 마트 소유자의 이름
configuredById	string	데이터 마트 소유자의 ID
datasourceUsages	DatasourceUsage[]	데이터 원본 사용량
description	string	데이터 마트 설명
endorsementDetails	EndorsementDetails	데이터마트 인증 세부 정보
id	string	데이터 마트 ID
modifiedBy	string	데이터 마트를 수정한 마지막 사용자
modifiedById	string	데이터 마트를 수정한 마지막 사용자의 ID입니다.
modifiedDateTime	string	데이터 마트가 마지막으로 수정된 날짜 및 시간
name	string	데이터 마트 이름
sensitivityLabel	SensitivityLabel	데이터마트 민감도 레이블
state	datamartState	데이터마트 현재 상태
status	datamartStatus	데이터 마트 상태
suspendedBatchId	string	datamart 일시 중단된 일괄 처리 ID
type	datamartType	데이터 마트 형식
upstreamDataflows	DependentDataflow[]	이 항목이 사용하는 모든 데이터 흐름 목록
upstreamDatamarts	DependentDatamart[]	이 항목이 사용하는 모든 데이터 마트 목록
users	DatamartUser[]	Power BI 데이터 마트에 대한 사용자 액세스 세부 정보입니다.

WorkspaceInfoDataset

WorkspaceInfo API에서 반환된 Power BI 데이터 세트입니다. API는 다음 데이터 세트 속성 목록의 하위 집합을 반환합니다. 하위 집합은 라는 API, 호출자 권한 및 Power BI 데이터베이스의 데이터 가용성에 따라 달라집니다.

Name	형식	Description
ContentProviderType	string	데이터 세트의 콘텐츠 공급자 형식
CreatedDate	string	데이터 세트 만들기 날짜 및 시간
configuredBy	string	데이터 세트 소유자
datasourceUsages	DatasourceUsage[]	데이터 원본 사용량
description	string	데이터 세트 설명
endorsementDetails	EndorsementDetails	인증 세부 정보
expressions	Expression[]	데이터 세트 식
id	string	데이터 세트 ID
misconfiguredDatasourceUsages	DatasourceUsage[]	데이터 원본이 잘못 구성된 사용량
name	string	데이터 세트 이름
roles	Role[]	데이터 세트 역할
schemaMayNotBeUpToDate	boolean	데이터 세트 스키마가 최신이 아닐 수 있는지 여부
schemaRetrievalError	string	데이터 세트 스키마 검색 오류
sensitivityLabel	SensitivityLabel	민감도 레이블
tables	Table[]	데이터 세트 테이블
targetStorageMode	string	데이터 세트 스토리지 모드
upstreamDataflows	DependentDataflow[]	이 항목이 사용하는 모든 데이터 흐름 목록
upstreamDatamarts	DependentDatamart[]	이 항목이 사용하는 모든 데이터 마트 목록
upstreamDatasets	DependentDataset[]	업스트림 데이터 세트
users	DatasetUser[]	(빈 값) 데이터 세트 사용자 액세스 세부 정보입니다. 이 속성은 향후 릴리스에서 페이로드 응답에서 제거됩니다. 데이터 세트 사용자를 관리 API로 가져오기 또는 매개 변수를 사용하여 PostWorkspaceInfo API `getArtifactUsers` 를 사용하여 Power BI 항목(예: 보고서 또는 dashboard)에서 사용자 정보를 검색할 수 있습니다.

WorkspaceInfoReport

작업 영역 정보 API에서 반환된 Power BI 보고서입니다. API는 다음 보고서 속성 목록의 하위 집합을 반환합니다. 하위 집합은 라는 API, 호출자 권한 및 Power BI 데이터베이스의 데이터 가용성에 따라 달라집니다.

Name	형식	Description
appId	string	보고서가 앱에 속하는 경우에만 반환되는 앱 ID
createdBy	string	보고서 소유자입니다. 2019년 6월 이후에 생성된 보고서에만 사용할 수 있습니다.
createdById	string	보고서 소유자의 ID입니다. 2019년 6월 이후에 생성된 보고서에만 사용할 수 있습니다.
createdDateTime	string	보고서 생성 날짜 및 시간
datasetId	string	보고서의 데이터 세트 ID
datasetWorkspaceId	string	관련 데이터 세트가 다른 작업 영역에 속하는 경우에만 반환되는 관련 데이터 세트의 작업 영역 ID입니다.
description	string	보고서 설명
endorsementDetails	EndorsementDetails	인증 세부 정보
id	string	보고서 ID
isOwnedByMe	boolean	현재 사용자가 보고서를 만들었는지 확인합니다.
modifiedBy	string	보고서를 수정한 마지막 사용자
modifiedById	string	보고서를 수정한 마지막 사용자의 ID입니다.
modifiedDateTime	string	보고서가 마지막으로 수정된 날짜 및 시간
name	string	보고서의 이름
originalReportId	string	작업 영역이 앱으로 게시될 때의 실제 보고서 ID입니다.
reportType	enum: PaginatedReport PowerBIReport	보고서 유형
sensitivityLabel	SensitivityLabel	민감도 레이블
users	ReportUser[]	(빈 값) Power BI 보고서에 대한 사용자 액세스 세부 정보입니다. 이 속성은 향후 릴리스에서 페이로드 응답에서 제거됩니다. 보고서 사용자 가져오기를 관리 API 호출로 사용하거나 매개 변수를 사용하여 PostWorkspaceInfo API 호출 `getArtifactUsers` 을 사용하여 Power BI 보고서에서 사용자 정보를 검색할 수 있습니다.

WorkspaceInfoResponse

작업 영역 정보 응답

Name	형식	Description
datasourceInstances	Datasource[]	이 검사와 연결된 데이터 원본 인스턴스
misconfiguredDatasourceInstances	Datasource[]	이 검사와 연결된 데이터 원본이 잘못 구성된 인스턴스
workspaces	WorkspaceInfo[]	이 검사와 관련된 작업 영역 정보

WorkspaceInfoTile

WorkspaceInfo API에서 반환된 Power BI 타일

Name	형식	Description
datasetId	string	데이터 집합 ID입니다. 보고서에서 만든 타일 또는 Q&A 타일과 같은 데이터 세트를 사용하는 경우에만 사용할 수 있습니다.
datasetWorkspaceId	string	관련 데이터 세트가 다른 작업 영역에 속하는 경우에만 반환되는 관련 데이터 세트의 작업 영역 ID입니다.
id	string	타일 ID
reportId	string	보고서 ID입니다. 보고서에서 만든 타일에만 사용할 수 있습니다.
title	string	타일의 표시 이름

Share via