Share via


Admin - WorkspaceInfo GetModifiedWorkspaces

조직의 작업 영역 ID 목록을 가져옵니다.

선택적 modifiedSince 매개 변수가 날짜-시간으로 설정된 경우 해당 날짜 시간 이후에 변경된 작업 영역의 ID만 반환됩니다. 매개 변수를 modifiedSince 사용하지 않으면 조직의 모든 작업 영역 ID가 반환됩니다. 매개 변수에 지정된 modifiedSince 날짜 시간은 현재 시간 이전의 30일(작업 영역 변경 내용이 적용되도록 허용)의 30분 범위에 있어야 합니다.

사용 권한

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

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

필수 범위

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

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

제한 사항

시간당 최대 30개의 요청.

GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/modified
GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/modified?modifiedSince={modifiedSince}&excludePersonalWorkspaces={excludePersonalWorkspaces}&excludeInActiveWorkspaces={excludeInActiveWorkspaces}

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
excludeInActiveWorkspaces
query

boolean

비활성 작업 영역을 제외할지 여부

excludePersonalWorkspaces
query

boolean

개인 작업 영역을 제외할지 여부

modifiedSince
query

string

date-time

마지막으로 수정한 날짜(ISO 8601 규격 UTC 형식이어야 합니다).

응답

Name 형식 Description
200 OK

ModifiedWorkspace[]

확인

예제

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/modified?modifiedSince=2020-10-02T05:51:30.0000000Z&excludePersonalWorkspaces=True&excludeInActiveWorkspaces=True

Sample Response

[
  {
    "Id": "3740504d-1f93-42f9-8e9d-c8ba9b787a3b"
  },
  {
    "Id": "19cb346c-9839-4e19-81e6-76364d0b836f"
  }
]

정의

ModifiedWorkspace

수정된 작업 영역

Name 형식 Description
Id

string

작업 영역 개체 ID