Admin - Get Capacities As Admin

服务:: Power BI REST APIs

API 版本:: v1.0

返回组织的容量列表。

权限

用户必须是 Fabric 管理员或使用服务主体进行身份验证。
支持委派的权限。

在服务特权身份验证下运行时，应用不得在 Azure 门户中为其上设置的 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 参数

名称	在	必需	类型	说明
$expand	query		string	内联扩展相关实体

响应

名称	类型	说明
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"
      }
    }
  ]
}

定义

名称	说明
Capacities	Power BI 容量列表的 OData 响应包装器
Capacity	Power BI 容量
CapacityState	容量状态
capacityUserAccessRight	用户对容量的访问权限
TenantKey	加密密钥信息

Capacities

Object

Power BI 容量列表的 OData 响应包装器

名称	类型	说明
@odata.context	string
value	Capacity[]	容量列表

Capacity

Object

Power BI 容量

名称	类型	说明
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

枚举

容量状态

值	说明
NotActivated	支持
Active	容量已准备就绪，可供使用
Provisioning	正在激活容量
ProvisionFailed	预配容量失败
PreSuspended	支持
Suspended	容量的使用已暂停
Deleting	正在删除容量
Deleted	容量已删除且不可用
Invalid	无法使用容量
UpdatingSku	容量 SKU 更改正在进行中

capacityUserAccessRight

枚举

用户对容量的访问权限

值	说明
None	用户无权访问容量
Assign	用户具有参与者权限，并且可以将工作区分配给容量
Admin	用户对容量具有管理员权限

TenantKey

Object

加密密钥信息

名称	类型	说明
createdAt	string (date-time)	加密密钥的创建日期和时间
id	string (uuid)	加密密钥的 ID
isDefault	boolean	加密密钥是否是整个租户的默认密钥。任何新创建的容量都继承默认密钥。
keyVaultKeyIdentifier	string	唯一指定 Azure Key Vault 中的加密密钥的 URI
name	string	加密密钥的名称
updatedAt	string (date-time)	加密密钥的上次更新日期和时间