Share via

Admin - Profiles GetProfilesAsAdmin

  • 참조
Service:
Power BI REST APIs
API Version:
v1.0

조직의 서비스 주체 프로필 목록을 반환합니다.

사용 권한

사용자에게 관리자 권한이 있거나 서비스 주체를 사용하여 인증해야 합니다.

필수 범위

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

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

URI 매개 변수

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

string

'id', 'displayName' 또는 'servicePrincipalId'를 사용하여 부울 조건에 따라 결과를 필터링합니다. 'eq' 연산자만 지원합니다.
$skip
 query

integer

int32

첫 번째 n개의 결과를 건너뜁니다. 맨 위와 함께 를 사용하여 처음 5000개 이후의 결과를 가져옵니다.
$top
 query

integer

int32

첫 번째 n 결과만 반환합니다. 이 매개 변수는 1-5000 범위여야 합니다.

응답

Name 형식 Description
200 OK

AdminServicePrincipalProfiles

정상

예제

Get a specific service principal profile by id using filter
Get service principal profiles by their parent servicePrincipalId using filter

Get a specific service principal profile by id using filter

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/profiles?$filter=id%20eq%20'3b211778-e7a5-4d73-8187-f10824047724'

Sample Response

Status code:
200 
{
  "value": [
    {
      "id": "3b211778-e7a5-4d73-8187-f10824047724",
      "displayName": "My new profile",
      "servicePrincipalId": "12345678-e7a5-4d73-8187-f10824041234"
    }
  ]
}

Get service principal profiles by their parent servicePrincipalId using filter

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/profiles?$filter=servicePrincipalId%20eq%20'12345678-e7a5-4d73-8187-f10824041234'

Sample Response

Status code:
200 
{
  "value": [
    {
      "id": "3b211778-e7a5-4d73-8187-f10824047724",
      "displayName": "My new profile",
      "servicePrincipalId": "12345678-e7a5-4d73-8187-f10824041234"
    },
    {
      "id": "43211778-e7a5-4d73-8187-f10824044321",
      "displayName": "My new profile2",
      "servicePrincipalId": "12345678-e7a5-4d73-8187-f10824041234"
    }
  ]
}

정의

Name Description
AdminServicePrincipalProfile

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

Power BI 서비스 보안 주체 프로필 컬렉션에 대한 Odata 응답 래퍼입니다.

AdminServicePrincipalProfile

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

Name 형식 Description
displayName

string

서비스 주체 프로필 이름
id

string

서비스 주체 프로필 ID
servicePrincipalId

string

서비스 주체 ID

AdminServicePrincipalProfiles

Power BI 서비스 보안 주체 프로필 컬렉션에 대한 Odata 응답 래퍼입니다.

Name 형식 Description
odata.context

string

OData 컨텍스트
value

AdminServicePrincipalProfile[]

서비스 주체 프로필 컬렉션