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

応答

名前	型	説明
200 OK	Capacities	OK

例

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"
    }
  ]
}

定義

名前	説明
Capacities	Power BI 容量リストの OData 応答ラッパー
Capacity	Power BI 容量
CapacityState	容量の状態
capacityUserAccessRight	ユーザーが容量に対して持っているアクセス権
TenantKey	暗号化キーの情報

Capacities

Power BI 容量リストの OData 応答ラッパー

名前	型	説明
odata.context	string
value	Capacity[]	容量の一覧

Capacity

Power BI 容量

名前	型	説明
admins	string[]	容量管理者の配列
capacityUserAccessRight	capacityUserAccessRight	ユーザーが容量に対して持つアクセス権
displayName	string	容量の表示名
id	string	容量 ID
region	string	容量がプロビジョニングされた Azure リージョン
sku	string	容量 SKU
state	CapacityState	容量の状態
tenantKey	TenantKey	暗号化キー情報 (管理者ルートにのみ適用されます)
tenantKeyId	string	暗号化キーの ID (管理者ルートにのみ適用されます)

CapacityState

容量の状態

名前	型	説明
Active	string	容量を使用する準備が整いました
Deleted	string	容量が削除され、使用できません
Deleting	string	容量の削除が進行中です
Invalid	string	容量を使用できません
NotActivated	string	サポートされていない
PreSuspended	string	サポートされていない
ProvisionFailed	string	容量のプロビジョニングに失敗しました
Provisioning	string	容量のアクティブ化が進行中です
Suspended	string	容量の使用が中断されている
UpdatingSku	string	容量 SKU の変更が進行中です

capacityUserAccessRight

ユーザーが容量に対して持っているアクセス権

名前	型	説明
Admin	string	ユーザーが容量に対する管理者権限を持っている
Assign	string	ユーザーは共同作成者の権限を持ち、ワークスペースを容量に割り当てることができます
None	string	ユーザーが容量にアクセスできない

TenantKey

暗号化キーの情報

名前	型	説明
createdAt	string	暗号化キーの作成日時
id	string	暗号化キーの ID
isDefault	boolean	暗号化キーがテナント全体の既定のキーかどうか。新しく作成された容量は、既定のキーを継承します。
keyVaultKeyIdentifier	string	Azure Key Vaultで暗号化キーを一意に指定する URI
name	string	暗号化キーの名前
updatedAt	string	暗号化キーの最終更新日時

次の方法で共有