Admin - Get Capacities As Admin

서비스:

Power BI REST APIs

API 버전:

v1.0

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

권한을

• 사용자는 패브릭 관리자이거나 서비스 주체를 사용하여 인증해야 합니다.
• 위임된 권한이 지원됩니다.

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

필수 범위

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

표준 위임된 관리자 액세스 토큰을 통해 인증하는 경우에만 관련됩니다. 서비스 주체를 통한 인증을 사용할 때는 존재하지 않아야 합니다.

제한 사항

시간당 최대 200개 요청

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	Capacities	그래

예제

Example

Example with expand on tenant key

Example

샘플 요청

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

Example with expand on tenant key

샘플 요청

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

샘플 응답

상태 코드:

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