Admin - Profiles GetProfilesAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

Mengembalikan daftar profil perwakilan layanan untuk organisasi.

Izin

Pengguna harus memiliki hak administrator atau mengautentikasi menggunakan perwakilan layanan.

Cakupan yang Diperlukan

Tenant.Read.All atau Tenant.ReadWrite.All

GET https://api.powerbi.com/v1.0/myorg/admin/profiles

With optional parameters:

GET https://api.powerbi.com/v1.0/myorg/admin/profiles?$filter={$filter}&$top={$top}&$skip={$skip}

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
$filter	query		string	Memfilter hasil berdasarkan kondisi boolean, menggunakan 'id', 'displayName', atau 'servicePrincipalId'. Hanya mendukung operator 'eq'.
$skip	query		integer int32	Melompati hasil n pertama. Gunakan dengan atas untuk mengambil hasil di luar 5000 pertama.
$top	query		integer int32	Hanya mengembalikan hasil n pertama. Parameter ini harus dalam kisaran 1-5000.

Respons

Nama	Jenis	Deskripsi
200 OK	AdminServicePrincipalProfiles	OK

Contoh

Get a specific service principal profile by id using filter

Get service principal profiles by their parent servicePrincipalId using filter

Get a specific service principal profile by id using filter

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/profiles?$filter=id%20eq%20'3b211778-e7a5-4d73-8187-f10824047724'

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "3b211778-e7a5-4d73-8187-f10824047724",
      "displayName": "My new profile",
      "servicePrincipalId": "12345678-e7a5-4d73-8187-f10824041234"
    }
  ]
}

Get service principal profiles by their parent servicePrincipalId using filter

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/profiles?$filter=servicePrincipalId%20eq%20'12345678-e7a5-4d73-8187-f10824041234'

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "3b211778-e7a5-4d73-8187-f10824047724",
      "displayName": "My new profile",
      "servicePrincipalId": "12345678-e7a5-4d73-8187-f10824041234"
    },
    {
      "id": "43211778-e7a5-4d73-8187-f10824044321",
      "displayName": "My new profile2",
      "servicePrincipalId": "12345678-e7a5-4d73-8187-f10824041234"
    }
  ]
}

Definisi

Nama	Deskripsi
AdminServicePrincipalProfile	Profil utama layanan Power BI. Hanya relevan untuk solusi multi-penyewaan Power BI Embedded.
AdminServicePrincipalProfiles	Pembungkus respons Odata untuk koleksi profil utama layanan Power BI.

AdminServicePrincipalProfile

Profil utama layanan Power BI. Hanya relevan untuk solusi multi-penyewaan Power BI Embedded.

Nama	Jenis	Deskripsi
displayName	string	Nama profil perwakilan layanan
id	string	ID profil perwakilan layanan
servicePrincipalId	string	ID perwakilan layanan

AdminServicePrincipalProfiles

Pembungkus respons Odata untuk koleksi profil utama layanan Power BI.

Nama	Jenis	Deskripsi
odata.context	string	Konteks OData
value	AdminServicePrincipalProfile[]	Kumpulan profil perwakilan layanan