다음을 통해 공유

Admin - Pipelines GetPipelinesAsAdmin

  • 참조
서비스:
Power BI REST APIs
API 버전:
v1.0

조직에 대한 배포 파이프라인 목록을 반환합니다.

권한

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

필수 범위

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

제한점

시간당 최대 200개 요청 

GET https://api.powerbi.com/v1.0/myorg/admin/pipelines
선택적 매개 변수: 
GET https://api.powerbi.com/v1.0/myorg/admin/pipelines?$expand={$expand}&$filter={$filter}&$top={$top}&$skip={$skip}

URI 매개 변수

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

string

응답에서 인라인으로 확장되는 쉼표로 구분된 데이터 형식 목록을 허용합니다. users 및 stages지원합니다.
$filter
 query

string

부울 조건에 따라 결과를 필터링합니다. 이 API는 분리된 배포 파이프라인 필터링만 지원합니다. 지원되지 않는 필터는 필터링되지 않은 결과를 반환합니다.
$skip
 query

integer (int32)

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

integer (int32)

minimum: 1
maximum: 5000

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

응답

Name 형식 Description
200 OK

AdminPipelines

그래

예제

Get deployment pipelines example
Get deployment pipelines with their 'stages' expanded example
Get deployment pipelines with their 'users' expanded example
Get orphaned deployment pipelines example

Get deployment pipelines example

샘플 요청

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

샘플 응답

상태 코드:
200 
{
  "value": [
    {
      "id": "a5ded933-57b7-41f4-b072-ed4c1f9d5824",
      "displayName": "Marketing Deployment Pipeline",
      "description": "Power BI deployment pipeline to manage marketing reports"
    },
    {
      "id": "183dcf10-47b8-48c4-84aa-f0bf9d5f8fcf",
      "displayName": "Financing Deployment Pipeline",
      "description": "Power BI deployment pipeline to manage financing reports"
    }
  ]
}

Get deployment pipelines with their 'stages' expanded example

샘플 요청

GET https://api.powerbi.com/v1.0/myorg/admin/pipelines?$expand=stages&$top=100

샘플 응답

상태 코드:
200 
{
  "value": [
    {
      "id": "a5ded933-57b7-41f4-b072-ed4c1f9d5824",
      "displayName": "Marketing Deployment Pipeline",
      "description": "Power BI deployment pipeline to manage marketing reports",
      "stages": [
        {
          "order": "0",
          "workspaceId": "5dba60b0-d9a7-42a3-b12c-6d9d51e7739a",
          "workspaceName": "SQlAzure-Refresh"
        },
        {
          "order": "1",
          "workspaceId": "8ce96c50-85a0-4db3-85c6-7ccc3ed46523",
          "workspaceName": "SQlAzure-Refresh[Test]"
        },
        {
          "order": "2"
        }
      ]
    }
  ]
}

Get deployment pipelines with their 'users' expanded example

샘플 요청

GET https://api.powerbi.com/v1.0/myorg/admin/pipelines?$expand=users&$top=100

샘플 응답

상태 코드:
200 
{
  "value": [
    {
      "id": "a5ded933-57b7-41f4-b072-ed4c1f9d5824",
      "displayName": "Marketing Deployment Pipeline",
      "description": "Power BI deployment pipeline to manage marketing reports",
      "users": [
        {
          "identifier": "john@contoso.com",
          "accessRight": "Admin",
          "principalType": "User"
        },
        {
          "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
          "accessRight": "Admin",
          "principalType": "Group"
        },
        {
          "identifier": "a35d842b-90d5-59a1-c56a-5f8fcff0bf9d",
          "accessRight": "Admin",
          "principalType": "App"
        }
      ]
    },
    {
      "id": "183dcf10-47b8-48c4-84aa-f0bf9d5f8fcf",
      "displayName": "Financing Deployment Pipeline",
      "description": "Power BI deployment pipeline to manage financing reports",
      "users": []
    }
  ]
}

Get orphaned deployment pipelines example

샘플 요청

GET https://api.powerbi.com/v1.0/myorg/admin/pipelines?$expand=users&$filter=(not users/any())&$top=100

샘플 응답

상태 코드:
200 
{
  "value": [
    {
      "id": "183dcf10-47b8-48c4-84aa-f0bf9d5f8fcf",
      "displayName": "Financing Deployment Pipeline",
      "description": "Power BI deployment pipeline to manage financing reports",
      "users": []
    }
  ]
}

정의

Name Description
AdminPipeline

사용자 API에서 반환된 Power BI 파이프라인
AdminPipelines

Power BI 배포 파이프라인 컬렉션에 대한 OData 응답 래퍼
PipelineStage

Power BI 배포 파이프라인 단계
PipelineUser

배포 파이프라인에 대한 Power BI 사용자 액세스 권한 항목
PipelineUserAccessRight

필수 사항입니다. 사용자가 배포 파이프라인에 대해 가지고 있는 액세스 권한입니다.
PrincipalType

보안 주체 형식

AdminPipeline

Object

사용자 API에서 반환된 Power BI 파이프라인

Name 형식 Description
description

string

배포 파이프라인 설명
displayName

string

배포 파이프라인 표시 이름
id

string (uuid)

배포 파이프라인 ID
stages

PipelineStage[]

배포 파이프라인 단계의 컬렉션입니다. 요청에서 $expandstages 설정되는 경우에만 반환됩니다.
users

PipelineUser[]

배포 파이프라인 사용자의 컬렉션입니다. 요청에서 $expandusers 설정되는 경우에만 반환됩니다.

AdminPipelines

Object

Power BI 배포 파이프라인 컬렉션에 대한 OData 응답 래퍼

Name 형식 Description
@odata.context

string

OData 컨텍스트
value

AdminPipeline[]

배포 파이프라인의 컬렉션

PipelineStage

Object

Power BI 배포 파이프라인 단계

Name 형식 Description
order

integer

스테이지 순서(0부터 시작)입니다.
workspaceId

string (uuid)

할당된 작업 영역 ID입니다. 할당된 작업 영역이 있는 경우에만 적용됩니다.
workspaceName

string

할당된 작업 영역 이름입니다. 할당된 작업 영역이 있고 사용자가 작업 영역에 액세스할 수 있는 경우에만 적용됩니다.

PipelineUser

Object

배포 파이프라인에 대한 Power BI 사용자 액세스 권한 항목

Name 형식 Description
accessRight

PipelineUserAccessRight

필수 사항입니다. 사용자가 배포 파이프라인에 대해 가지고 있는 액세스 권한입니다.
identifier

string

보안 주체 형식 User경우 UPN제공합니다. 그렇지 않으면 보안 주체의 개체 ID 제공합니다.
principalType

PrincipalType

보안 주체 형식

PipelineUserAccessRight

열거형

필수 사항입니다. 사용자가 배포 파이프라인에 대해 가지고 있는 액세스 권한입니다.

값 Description
Admin

배포 파이프라인에 관리자 권한 부여

PrincipalType

열거형

보안 주체 형식

값 Description
App

서비스 주체 유형
Group

그룹 보안 주체 유형
None

보안 주체 형식이 없습니다. 전체 조직 수준 액세스에 사용합니다.
User

사용자 계정 유형