Admin - Pipelines UpdateUserAsAdmin

指定したデプロイ パイプラインに対するユーザーアクセス許可を付与します。

Permissions

ユーザーは管理者権限を持っている必要があります。

必要なスコープ

Tenant.ReadWrite.All

制限事項

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

POST https://api.powerbi.com/v1.0/myorg/admin/pipelines/{pipelineId}/users

URI パラメーター

名前 / 必須 型 説明
pipelineId
path True

string (uuid)

デプロイ パイプライン ID

要求本文

名前 必須 型 説明
identifier True

string

プリンシパルの種類 Userの場合は、 UPN を指定します。 それ以外の場合は、プリンシパルの オブジェクト ID を 指定します。

principalType True

PrincipalType

プリンシパルの種類

accessRight

PipelineUserAccessRight

必須。 ユーザーがデプロイ パイプラインに対して持っているアクセス権。

応答

名前 型 説明
200 OK

[OK]

例

Add a group to a deployment pipeline example
Add a service principal to a deployment pipeline example
Add a user to a deployment pipeline example

Add a group to a deployment pipeline example

要求のサンプル

POST https://api.powerbi.com/v1.0/myorg/admin/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users
{
  "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
  "accessRight": "Admin",
  "principalType": "Group"
}

応答のサンプル

Add a service principal to a deployment pipeline example

要求のサンプル

POST https://api.powerbi.com/v1.0/myorg/admin/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users
{
  "identifier": "a35d842b-90d5-59a1-c56a-5f8fcff0bf9d",
  "accessRight": "Admin",
  "principalType": "App"
}

応答のサンプル

Add a user to a deployment pipeline example

要求のサンプル

POST https://api.powerbi.com/v1.0/myorg/admin/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users
{
  "identifier": "john@contoso.com",
  "accessRight": "Admin",
  "principalType": "User"
}

応答のサンプル

定義

名前 説明
PipelineUser

デプロイ パイプラインの Power BI ユーザー アクセス権エントリ

PipelineUserAccessRight

必須。 ユーザーがデプロイ パイプラインに対して持っているアクセス権。

PrincipalType

プリンシパルの種類

PipelineUser

デプロイ パイプラインの Power BI ユーザー アクセス権エントリ

名前 型 説明
accessRight

PipelineUserAccessRight

必須。 ユーザーがデプロイ パイプラインに対して持っているアクセス権。

identifier

string

プリンシパルの種類 Userの場合は、 UPN を指定します。 それ以外の場合は、プリンシパルの オブジェクト ID を 指定します。

principalType

PrincipalType

プリンシパルの種類

PipelineUserAccessRight

必須。 ユーザーがデプロイ パイプラインに対して持っているアクセス権。

値 説明
Admin

デプロイ パイプラインに管理者権限を付与する

PrincipalType

プリンシパルの種類

値 説明
None

プリンシパルの種類はありません。 組織全体レベルのアクセスに使用します。

User

ユーザー プリンシパルの種類

Group

グループ プリンシパルの種類

App

サービス プリンシパルの種類