次の方法で共有

Capacities - Get Capacities

サービス:
Power BI REST APIs
API バージョン:
v1.0

ユーザーがアクセスできる容量の一覧を返します。

Permissions

この API 呼び出しは、サービス プリンシパル プロファイルによって呼び出すことができます。 詳細については、「 Power BI Embedded のサービス プリンシパル プロファイル」を参照してください。 プロファイル作成者は容量のアクセス許可を持っている必要があります。

必要なスコープ

Capacity.Read.All または Capacity.ReadWrite.All 

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

応答

名前 型 説明
200 OK

Capacities

[OK]

例

Example

要求のサンプル

GET https://api.powerbi.com/v1.0/myorg/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"
    }
  ]
}

定義

名前 説明
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)

暗号化キーの最終更新日時