Admin - Get Capacities As Admin
조직의 용량 목록을 반환합니다.
사용 권한
- 사용자는 관리자 권한(예: Office 365 전역 관리자 또는 Power BI 서비스 관리자)이 있거나 서비스 주체를 사용하여 인증해야 합니다.
- 위임된 권한이 지원됩니다.
서비스 기본 인증에서 실행하는 경우 앱에는 Azure Portal 설정된 Power BI에 대한 관리자 동의 필수 프리미션이 없어야 합니다.
필수 범위
Tenant.Read.All 또는 Tenant.ReadWrite.All
표준 위임된 관리자 액세스 토큰을 통해 인증하는 경우에만 관련이 있습니다. 서비스 주체를 통한 인증을 사용할 때는 없어야 합니다.
GET https://api.powerbi.com/v1.0/myorg/admin/capacities
GET https://api.powerbi.com/v1.0/myorg/admin/capacities?$expand={$expand}
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
$expand
|
query |
string |
관련 엔터티 인라인 확장 |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
확인 |
예제
Example |
Example with expand on tenant key |
Example
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/capacities
Sample Response
{
"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
{
"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 용량 |
Capacity |
용량 상태 |
capacity |
사용자가 용량에 대해 가지고 있는 액세스 권한 |
Tenant |
암호화 키 정보 |
Capacities
Power BI 용량 목록에 대한 OData 응답 래퍼
Name | 형식 | Description |
---|---|---|
odata.context |
string |
|
value |
Capacity[] |
용량 목록 |
Capacity
Power BI 용량
Name | 형식 | Description |
---|---|---|
admins |
string[] |
용량 관리자 배열 |
capacityUserAccessRight |
사용자가 용량에 대한 액세스 권한 |
|
displayName |
string |
용량의 표시 이름 |
id |
string |
용량 ID |
region |
string |
용량이 프로비전된 Azure 지역 |
sku |
string |
용량 SKU |
state |
용량 상태 |
|
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 |
암호화 키의 마지막 업데이트 날짜 및 시간 |