다음을 통해 공유

Capacities - Get Capacities

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

사용자가 액세스할 수 있는 용량 목록을 반환합니다.

Permissions

이 API 호출은 서비스 주체 프로필에서 호출할 수 있습니다. 자세한 내용은 Power BI Embedded의 서비스 주체 프로필을 참조하세요. 프로필 작성자에는 용량 권한이 있어야 합니다.

필수 범위

Capacity.Read.All 또는 Capacity.ReadWrite.All 

GET https://api.powerbi.com/v1.0/myorg/capacities

응답

Name 형식 Description
200 OK

Capacities

그래

예제

Example

샘플 요청

GET https://api.powerbi.com/v1.0/myorg/capacities

샘플 응답

상태 코드:
200 
{
  "value": [
    {
      "id": "0f084df7-c13d-451b-af5f-ed0c466403b2",
      "displayName": "MyCapacity",
      "admins": [
        "john@contoso.com"
      ],
      "sku": "A1",
      "state": "Active",
      "region": "West Central US",
      "capacityUserAccessRight": "Admin"
    }
  ]
}

정의

Name Description
Capacities

Power BI 용량 목록에 대한 OData 응답 래퍼
Capacity

Power BI 용량
CapacityState

용량 상태
capacityUserAccessRight

사용자가 용량에 대해 가지고 있는 액세스 권한
TenantKey

암호화 키 정보

Capacities

Object

Power BI 용량 목록에 대한 OData 응답 래퍼

Name 형식 Description
@odata.context

string

value

Capacity[]

용량 목록

Capacity

Object

Power BI 용량

Name 형식 Description
admins

string[]

용량 관리자의 배열
capacityUserAccessRight

capacityUserAccessRight

사용자가 용량에 대한 액세스 권한
displayName

string

용량의 표시 이름
id

string (uuid)

용량 ID
region

string

용량이 프로비전된 Azure 지역
sku

string

용량 SKU
state

CapacityState

용량 상태
tenantKey

TenantKey

암호화 키 정보(관리자 경로에만 적용됨)
tenantKeyId

string (uuid)

암호화 키의 ID(관리자 경로에만 적용 가능)

CapacityState

열거형

용량 상태

값 Description
NotActivated

지원되지 않음
Active

용량을 사용할 준비가 된 경우
Provisioning

용량 활성화가 진행 중입니다.
ProvisionFailed

용량 프로비전 실패
PreSuspended

지원되지 않음
Suspended

용량 사용이 일시 중단됨
Deleting

용량 삭제가 진행 중입니다.
Deleted

용량이 삭제되었으며 사용할 수 없습니다.
Invalid

용량을 사용할 수 없습니다.
UpdatingSku

용량 SKU 변경이 진행 중입니다.

capacityUserAccessRight

열거형

사용자가 용량에 대해 가지고 있는 액세스 권한

값 Description
None

사용자에게 용량에 대한 액세스 권한이 없습니다.
Assign

사용자에게 기여자 권한이 있으며 작업 영역을 용량에 할당할 수 있습니다.
Admin

사용자에게 용량에 대한 관리자 권한이 있습니다.

TenantKey

Object

암호화 키 정보

Name 형식 Description
createdAt

string (date-time)

암호화 키의 생성 날짜 및 시간
id

string (uuid)

암호화 키의 ID
isDefault

boolean

암호화 키가 전체 테넌트에 대한 기본 키인지 여부입니다. 새로 만든 용량은 기본 키를 상속합니다.
keyVaultKeyIdentifier

string

Azure Key Vault에서 암호화 키를 고유하게 지정하는 URI
name

string

암호화 키의 이름
updatedAt

string (date-time)

암호화 키의 마지막 업데이트 날짜 및 시간