Capacities - Get Capacities

참조

Service:: Power BI REST APIs

API Version:: v1.0

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

사용 권한

이 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

Sample Request

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

Sample Response

Status code:: 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

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

Name	형식	Description
odata.context	string
value	Capacity[]	용량 목록

Capacity

Power BI 용량

Name	형식	Description
admins	string[]	용량 관리자 배열
capacityUserAccessRight	capacityUserAccessRight	사용자가 용량에 대해 가지고 있는 액세스 권한
displayName	string	용량의 표시 이름
id	string	용량 ID
region	string	용량이 프로비전된 Azure 지역
sku	string	용량 SKU
state	CapacityState	용량 상태
tenantKey	TenantKey	암호화 키 정보(관리자 경로에만 적용됨)
tenantKeyId	string	암호화 키의 ID(관리자 경로에만 적용됨)

CapacityState

용량 상태

Name	형식	Description
Active	string	용량을 사용할 준비가 됨
Deleted	string	용량이 삭제되었으며 사용할 수 없음
Deleting	string	용량 삭제가 진행 중입니다.
Invalid	string	용량을 사용할 수 없습니다.
NotActivated	string	지원되지 않음
PreSuspended	string	지원되지 않음
ProvisionFailed	string	용량 프로비전 실패
Provisioning	string	용량 활성화가 진행 중입니다.
Suspended	string	용량 사용이 일시 중단됨
UpdatingSku	string	용량 SKU 변경이 진행 중입니다.

capacityUserAccessRight

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

Name	형식	Description
Admin	string	사용자에게 용량에 대한 관리자 권한이 있습니다.
Assign	string	사용자에게 기여자 권한이 있으며 작업 영역을 용량에 할당할 수 있습니다.
None	string	사용자에게 용량에 대한 액세스 권한이 없습니다.

TenantKey

암호화 키 정보

Name	형식	Description
createdAt	string	암호화 키의 생성 날짜 및 시간
id	string	암호화 키의 ID
isDefault	boolean	암호화 키가 전체 테넌트에 대한 기본 키인지 여부입니다. 새로 만든 모든 용량은 기본 키를 상속합니다.
keyVaultKeyIdentifier	string	Azure Key Vault 암호화 키를 고유하게 지정하는 URI
name	string	암호화 키의 이름
updatedAt	string	암호화 키의 마지막 업데이트 날짜 및 시간

다음을 통해 공유