Admin - Users GetUserSubscriptionsAsAdmin

サービス:: Power BI REST APIs

API バージョン:: v1.0

指定したユーザーのサブスクリプションの一覧を返します。これはプレビュー API 呼び出しです。

権限

ユーザーは、ファブリック管理者であるか、サービスプリンシパルを使用して認証されている必要があります。
委任されたアクセス許可がサポートされています。

必要なスコープ

Tenant.Read.All または Tenant.ReadWrite.All

制限

1 時間あたり最大 200 要求。

GET https://api.powerbi.com/v1.0/myorg/admin/users/{userId}/subscriptions

省略可能なパラメーターを含む:

GET https://api.powerbi.com/v1.0/myorg/admin/users/{userId}/subscriptions?continuationToken={continuationToken}

URI パラメーター

名前	/	必須	型	説明
userId	path	True	string	ユーザーのグラフ ID またはユーザープリンシパル名 (UPN)
continuationToken	query		string	結果セットの次のチャンクを取得するために必要なトークン

応答

名前	型	説明
200 OK	SubscriptionsByUserResponse	わかりました

例

Example

要求のサンプル

GET https://api.powerbi.com/v1.0/myorg/admin/users/f089354e-8366-4e18-aea3-4cb4a3a50b48/subscriptions

応答のサンプル

状態コード:: 200

{
  "subscriptionEntities": [
    {
      "id": "9225d0bc-9f5e-4819-a637-799c0c4fh3f1",
      "title": "Team Scorecard-test",
      "artifactId": "0b50f0bf-b22b-4685-83b9-b6d17f7f4e46",
      "artifactDisplayName": "Customer Profitability Sample",
      "subArtifactDisplayName": "Team Scorecard",
      "artifactType": "Report",
      "isEnabled": false,
      "frequency": "Daily",
      "startDate": "8/10/2021 12:00:00 AM",
      "endDate": "8/10/2022 12:00:00 AM",
      "linkToContent": false,
      "previewImage": true,
      "attachmentFormat": "PNG",
      "users": []
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/f089354e-8366-4e18-aea3-4cb4a3a50b48/subscriptions?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

定義

名前	説明
PrincipalType	プリンシパルの種類
ServicePrincipalProfile	Power BI サービスプリンシパルプロファイル。 Power BI Embedded マルチテナントソリューションにのみ関連します。
Subscription	Power BI アイテムのメールサブスクリプション (レポートやダッシュボードなど)
SubscriptionsByUserResponse	ユーザーの Power BI サブスクリプションの OData 応答ラッパー
SubscriptionUser	Power BI メールサブスクリプションユーザー

PrincipalType

列挙

プリンシパルの種類

値	説明
None	プリンシパルの種類はありません。組織全体レベルのアクセスに使用します。
User	ユーザープリンシパルの種類
Group	グループプリンシパルの種類
App	サービスプリンシパルの種類

ServicePrincipalProfile

Object

Power BI サービスプリンシパルプロファイル。 Power BI Embedded マルチテナントソリューションにのみ関連します。

名前	型	説明
displayName	string	サービスプリンシパルプロファイル名
id	string (uuid)	サービスプリンシパルプロファイル ID

Subscription

Object

Power BI アイテムのメールサブスクリプション (レポートやダッシュボードなど)

名前	型	説明
artifactDisplayName	string	サブスクライブされている Power BI アイテムの名前 (レポートやダッシュボードなど)
artifactId	string (uuid)	サブスクライブした Power BI アイテムの ID (レポートやダッシュボードなど)
artifactType	string	Power BI 項目の種類 (`Report`、`Dashboard`、`Dataset`など)
attachmentFormat	string	電子メールサブスクリプションに添付されているレポートの形式
endDate	string (date-time)	電子メールサブスクリプションの終了日時
frequency	string	電子メールサブスクリプションの頻度
id	string (uuid)	サブスクリプション ID
isEnabled	boolean	電子メールサブスクリプションが有効になっているかどうか
linkToContent	boolean	電子メールサブスクリプションにサブスクリプションリンクが存在するかどうか
previewImage	boolean	レポートのスクリーンショットが電子メールサブスクリプションに存在するかどうか
startDate	string (date-time)	電子メールサブスクリプションの開始日時
subArtifactDisplayName	string	サブスクライブした Power BI アイテムのページ名 (レポートの場合)。
title	string	アプリ名
users	SubscriptionUser[]	各メールサブスクライバーの詳細。 Get User Subscriptions As Admin API 呼び出しを使用する場合、返される値は空の配列 (null) です。このプロパティは、今後のリリースでペイロードの応答から削除されます。 Power BI レポートまたはダッシュボードでサブスクリプション情報を取得するには、[レポートサブスクリプションを管理者として取得] を使用するか、[ダッシュボードサブスクリプションを管理者として取得] API 呼び出しをします。

SubscriptionsByUserResponse

Object

ユーザーの Power BI サブスクリプションの OData 応答ラッパー

名前	型	説明
@odata.context	string
continuationToken	string	結果セットの次のチャンクを取得するトークン
continuationUri	string	結果セット内の次のチャンクの URI
subscriptionEntities	Subscription[]	ユーザーのサブスクリプション

SubscriptionUser

Object

Power BI メールサブスクリプションユーザー

名前	型	説明
displayName	string	プリンシパルの表示名
emailAddress	string	ユーザーのメールアドレス
graphId	string	Microsoft Graph のプリンシパルの識別子。管理者 API でのみ使用できます。
identifier	string	プリンシパルの識別子
principalType	PrincipalType	プリンシパルの種類
profile	ServicePrincipalProfile	Power BI サービスプリンシパルプロファイル。 Power BI Embedded マルチテナントソリューションにのみ関連します。
userType	string	ユーザーの種類。

次の方法で共有

Admin - Users GetUserSubscriptionsAsAdmin

権限

必要なスコープ

制限

URI パラメーター

応答

例

Example

要求のサンプル

応答のサンプル

定義

PrincipalType

ServicePrincipalProfile

Subscription

SubscriptionsByUserResponse

SubscriptionUser