Admin - Get Capacities As Admin

Service:

Power BI REST APIs

API Version:

v1.0

조직의 용량 목록을 반환합니다.

사용 권한

• 사용자는 관리자 권한(예: Office 365 전역 관리자 또는 Power BI 서비스 관리자)이 있거나 서비스 주체를 사용하여 인증해야 합니다.
• 위임된 권한이 지원됩니다.

서비스 기본 인증에서 실행하는 경우 앱에는 Azure Portal 설정된 Power BI에 대한 관리자 동의 필수 프리미션이 없어야 합니다.

필수 범위

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

표준 위임된 관리자 액세스 토큰을 통해 인증하는 경우에만 관련이 있습니다. 서비스 주체를 통한 인증을 사용할 때는 없어야 합니다.

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

With optional parameters:

GET https://api.powerbi.com/v1.0/myorg/admin/capacities?$expand={$expand}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
$expand	query		string	관련 엔터티 인라인 확장

응답

Name	형식	Description
200 OK	Capacities	확인

예제

Example

Example with expand on tenant key

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/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",
      "tenantKeyId": "82d9a37a-2b45-4221-b012-cb109b8e30c7"
    }
  ]
}

Example with expand on tenant key

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/capacities?$expand=tenantKey

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",
      "tenantKeyId": "82d9a37a-2b45-4221-b012-cb109b8e30c7",
      "tenantKey": {
        "id": "82d9a37a-2b45-4221-b012-cb109b8e30c7",
        "name": "Contoso Sales",
        "keyVaultKeyIdentifier": "https://contoso-vault2.vault.azure.net/keys/ContosoKeyVault/b2ab4ba1c7b341eea5ecaaa2wb54c4d2",
        "isDefault": true,
        "createdAt": "2019-04-30T21:35:15.867-07:00",
        "updatedAt": "2019-04-30T21:35:15.867-07:00"
      }
    }
  ]
}

정의

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	암호화 키의 마지막 업데이트 날짜 및 시간