Aracılığıyla paylaş


Admin - Groups GetGroupsAsAdmin

Kuruluş için çalışma alanlarının listesini döndürür.

İzinler

  • Kullanıcının yönetici haklarına (Office 365 Genel Yönetici veya Power BI Hizmet Yöneticisi gibi) sahip olması veya hizmet sorumlusu kullanarak kimlik doğrulaması yapması gerekir.
  • Temsilci izinleri desteklenir.

Hizmet özel kimlik doğrulaması altında çalıştırılırken, bir uygulamanın Azure portal Power BI için yönetici onayı için gerekli izinlere sahip olmaması gerekir.

Gerekli Kapsam

Tenant.Read.All veya Tenant.ReadWrite.All

Yalnızca standart bir yönetici temsilcisi erişim belirteci aracılığıyla kimlik doğrulaması yaparken geçerlidir. Hizmet sorumlusu aracılığıyla kimlik doğrulaması kullanıldığında mevcut olmamalıdır.

Sınırlamalar

Kiracı başına saatte en fazla 50 istek veya dakikada 15 istek. Bu çağrı, Power BI hizmeti olumsuz etkiyi önlemek için 30 saniye sonra da zaman aşımına uğrar.

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

URI Parametreleri

Name İçinde Gerekli Tür Description
$top
query True

integer

int32

Yalnızca ilk n sonucu döndürür. Bu parametre zorunludur ve 1-5000 aralığında olmalıdır.

$expand
query

string

Yanıtta satır içi olarak genişletilecek veri türlerinin virgülle ayrılmış listesini kabul eder. , , reports, dashboards, datasetsve dataflowsworkbooks'yi desteklerusers.

$filter
query

string

Sonuçları boole koşuluna göre filtreler

$skip
query

integer

int32

İlk n sonucu atlar. İlk 5000'in ötesinde sonuçları getirmek için üst ile birlikte kullanın.

Yanıtlar

Name Tür Description
200 OK

AdminGroups

Tamam

Örnekler

Get deleted workspaces example.
Get orphaned workspaces example.
Get workspaces with their 'dashboards' expanded example
Get workspaces with their 'datasets' expanded example
Get workspaces with their 'datasets' expanded example.
Get workspaces with their 'reports' expanded example
Get workspaces with their 'users' expanded example.
Get workspaces with their 'workbooks' expanded example

Get deleted workspaces example.

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/groups?$filter=state eq 'Deleted'&$top=100

Sample Response

{
  "value": [
    {
      "id": "183dcf10-47b8-48c4-84aa-f0bf9d5f8fcf",
      "isReadOnly": false,
      "isOnDedicatedCapacity": false,
      "name": "Sample Group 2",
      "description": "Deleted sample group",
      "type": "Workspace",
      "state": "Deleted"
    }
  ]
}

Get orphaned workspaces example.

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/groups?$expand=users&$filter=(not users/any()) or (not users/any(u: u/groupUserAccessRight eq Microsoft.PowerBI.ServiceContracts.Api.GroupUserAccessRight'Admin'))&$top=100

Sample Response

{
  "value": [
    {
      "id": "d5caa808-8c91-400a-911d-06af08dbcc31",
      "isReadOnly": false,
      "isOnDedicatedCapacity": false,
      "name": "Orphaned Group",
      "description": "Sample orphan group",
      "type": "Workspace",
      "state": "Active",
      "hasWorkspaceLevelSettings": false,
      "users": []
    }
  ]
}

Get workspaces with their 'dashboards' expanded example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/groups?$expand=dashboards&$top=100

Sample Response

{
  "value": [
    {
      "id": "94E57E92-CEE2-486D-8CC8-218C97200579",
      "isReadOnly": false,
      "isOnDedicatedCapacity": false,
      "capacityMigrationStatus": "Migrated",
      "description": "shorter description",
      "type": "Workspace",
      "state": "Removing",
      "name": "a",
      "hasWorkspaceLevelSettings": false,
      "dashboards": [
        {
          "id": "4668133c-ae3f-42fb-ad7c-214a8623280c",
          "displayName": "SQlAzure-Refresh.pbix",
          "isReadOnly": false
        },
        {
          "id": "a8f18ca7-63e8-4220-bc1c-f576ec180b98",
          "displayName": "cdvc",
          "isReadOnly": false
        }
      ]
    }
  ]
}

Get workspaces with their 'datasets' expanded example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/groups?$expand=datasets&$top=100

Sample Response

{
  "value": [
    {
      "id": "94E57E92-CEE2-486D-8CC8-218C97200579",
      "isReadOnly": false,
      "isOnDedicatedCapacity": false,
      "capacityMigrationStatus": "Migrated",
      "description": "shorter description",
      "type": "Workspace",
      "state": "Removing",
      "name": "a",
      "hasWorkspaceLevelSettings": false,
      "datasets": [
        {
          "id": "8ce96c50-85a0-4db3-85c6-7ccc3ed46523",
          "name": "SQlAzure-Refresh",
          "addRowsAPIEnabled": false,
          "configuredBy": "admin@granularcontrols.ccsctp.net",
          "isRefreshable": true,
          "isEffectiveIdentityRequired": false,
          "isEffectiveIdentityRolesRequired": false,
          "isOnPremGatewayRequired": false,
          "targetStorageMode": "Abf",
          "createdDate": "2019-04-30T21:35:15.867-07:00",
          "ContentProviderType": "PbixInImportMode",
          "isInPlaceSharingEnabled": false
        },
        {
          "id": "7d6a4f72-1906-4e08-a469-bd6bc1ab7b69",
          "name": "NESGames",
          "addRowsAPIEnabled": false,
          "configuredBy": "admin@granularcontrols.ccsctp.net",
          "isRefreshable": true,
          "isEffectiveIdentityRequired": false,
          "isEffectiveIdentityRolesRequired": false,
          "isOnPremGatewayRequired": false,
          "targetStorageMode": "Abf",
          "createdDate": "2019-04-30T21:35:15.867-07:00",
          "ContentProviderType": "PbixInImportMode",
          "isInPlaceSharingEnabled": false
        }
      ]
    }
  ]
}

Get workspaces with their 'datasets' expanded example.

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/groups?$expand=datasets

Sample Response

{
  "value": [
    {
      "id": "e380d1d0-1fa6-460b-9a90-1a5c6b02414c",
      "isReadOnly": false,
      "isOnDedicatedCapacity": true,
      "capacityId": "0f084df7-c13d-451b-af5f-ed0c466403b2",
      "defaultDatasetStorageFormat": "Small",
      "name": "Sample Group 1",
      "description": "Sample group",
      "type": "Workspace",
      "state": "Active",
      "hasWorkspaceLevelSettings": true,
      "datasets": [
        {
          "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
          "name": "SalesMarketing",
          "addRowsAPIEnabled": false,
          "configuredBy": "john@contoso.com",
          "isRefreshable": true,
          "isEffectiveIdentityRequired": false,
          "isEffectiveIdentityRolesRequired": false,
          "isOnPremGatewayRequired": false,
          "isInPlaceSharingEnabled": false,
          "encryption": {
            "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
            "encryptionStatus": "InSyncWithWorkspace"
          }
        }
      ]
    },
    {
      "id": "183dcf10-47b8-48c4-84aa-f0bf9d5f8fcf",
      "isReadOnly": false,
      "isOnDedicatedCapacity": false,
      "name": "Sample Group 2",
      "description": "Deleted sample group",
      "type": "Workspace",
      "state": "Deleted",
      "datasets": []
    }
  ]
}

Get workspaces with their 'reports' expanded example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/groups?$expand=reports&$top=100

Sample Response

{
  "value": [
    {
      "id": "EC1EE11F-845D-495E-82A3-9DAC2072305A",
      "isReadOnly": false,
      "isOnDedicatedCapacity": false,
      "capacityMigrationStatus": "Migrated",
      "description": "cvcv",
      "type": "Workspace",
      "state": "Active",
      "name": "WSv2Test12",
      "hasWorkspaceLevelSettings": true,
      "reports": []
    },
    {
      "id": "94E57E92-CEE2-486D-8CC8-218C97200579",
      "isReadOnly": false,
      "isOnDedicatedCapacity": false,
      "capacityMigrationStatus": "Migrated",
      "description": "shorter description",
      "type": "Workspace",
      "state": "Removing",
      "name": "a",
      "hasWorkspaceLevelSettings": false,
      "reports": [
        {
          "id": "5DBA60B0-D9A7-42AE-B12C-6D9D51E7739A",
          "reportType": "PowerBIReport",
          "name": "SQlAzure-Refresh",
          "datasetId": "8ce96c50-85a0-4db3-85c6-7ccc3ed46523"
        },
        {
          "id": "197E5C3C-D2F3-42D8-A536-875FB6D7D48C",
          "reportType": "PowerBIReport",
          "name": "NESGames",
          "datasetId": "7d6a4f72-1906-4e08-a469-bd6bc1ab7b69"
        }
      ]
    }
  ]
}

Get workspaces with their 'users' expanded example.

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/groups?$expand=users&$top=100

Sample Response

{
  "value": [
    {
      "id": "e380d1d0-1fa6-460b-9a90-1a5c6b02414c",
      "isReadOnly": false,
      "isOnDedicatedCapacity": true,
      "capacityId": "0f084df7-c13d-451b-af5f-ed0c466403b2",
      "defaultDatasetStorageFormat": "Small",
      "name": "Sample Group 1",
      "description": "Sample group",
      "type": "Workspace",
      "state": "Active",
      "hasWorkspaceLevelSettings": false,
      "users": [
        {
          "emailAddress": "john@contoso.com",
          "groupUserAccessRight": "Admin"
        }
      ]
    },
    {
      "id": "183dcf10-47b8-48c4-84aa-f0bf9d5f8fcf",
      "isReadOnly": false,
      "isOnDedicatedCapacity": false,
      "name": "Sample Group 2",
      "description": "Deleted sample group",
      "type": "Workspace",
      "state": "Deleted",
      "users": []
    }
  ]
}

Get workspaces with their 'workbooks' expanded example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/groups?$expand=workbooks&$top=100

Sample Response

{
  "value": [
    {
      "id": "94E57E92-CEE2-486D-8CC8-218C97200579",
      "isReadOnly": false,
      "isOnDedicatedCapacity": false,
      "description": "shorter description",
      "type": "Workspace",
      "state": "Removing",
      "hasWorkspaceLevelSettings": false,
      "name": "a",
      "workbooks": [
        {
          "name": "My Excel sheet",
          "datasetId": "8ce96c50-85a0-4db3-85c6-7ccc3ed46523"
        }
      ]
    }
  ]
}

Tanımlar

Name Description
AdminDashboard

Yönetici API'leri tarafından döndürülen bir Power BI panosu. API, aşağıdaki pano özellikleri listesinin bir alt kümesini döndürür. Alt küme, çağrılan API'ye, çağıran izinlerine ve Power BI veritabanındaki verilerin kullanılabilirliğine bağlıdır.

AdminDataflow

Yönetici API'leri tarafından döndürülen veri akışının meta verileri. Aşağıda, veri akışı için döndürülebilecek özelliklerin listesi yer almaktadır. Çağrılan API'ye, çağıran izinlerine ve Power BI veritabanındaki verilerin kullanılabilirliğine bağlı olarak özelliklerin yalnızca bir alt kümesi döndürülür.

AdminDataset

Yönetici API'leri tarafından döndürülen bir Power BI veri kümesi. API, aşağıdaki veri kümesi özellikleri listesinin bir alt kümesini döndürür. Alt küme, çağrılan API'ye, çağıran izinlerine ve Power BI veritabanındaki verilerin kullanılabilirliğine bağlıdır.

AdminGroup

Yönetici API'leri tarafından döndürülen bir Power BI grubu

AdminGroups

Yönetici API'ler tarafından döndürülen Power BI gruplarının listesi için OData yanıt sarmalayıcısı

AdminReport

Yönetici API'ler tarafından döndürülen bir Power BI raporu. API, aşağıdaki rapor özellikleri listesinin bir alt kümesini döndürür. Alt küme, çağrılan API'ye, çağıran izinlerine ve Power BI veritabanındaki verilerin kullanılabilirliğine bağlıdır.

AdminTile

Yönetici API'leri tarafından döndürülen bir Power BI kutucuğu.

AzureResource

Log Analytics çalışma alanı gibi kullanıcıya ait bir Azure kaynağının ayrıntılarını içeren yanıt.

DashboardUser

Power BI kullanıcısı bir pano için doğru erişime sahip giriş

DashboardUserAccessRight

Kullanıcının pano için sahip olduğu erişim hakkı (izin düzeyi)

DataflowUser

Power BI kullanıcısı veri akışı için doğru erişime sahip giriş

DataflowUserAccessRight

Bir kullanıcının veri akışı için sahip olduğu erişim hakkı (izin düzeyi)

DatasetQueryScaleOutSettings

Veri kümesinin ölçeği genişletme ayarlarını sorgulama

DatasetUser

Power BI kullanıcısı bir veri kümesi için doğru erişime sahip giriş

DatasetUserAccessRight

Kullanıcının veri kümesi için sahip olduğu erişim hakkı (izin düzeyi)

DefaultDatasetStorageFormat

Gruptaki varsayılan veri kümesi depolama biçimi

DependentDataflow

Power BI'a bağımlı veri akışı

Encryption

Veri kümesi için şifreleme bilgileri

EncryptionStatus

Veri kümesi şifreleme durumu

GroupType

Grup türü

GroupUser

Çalışma alanına erişimi olan bir Power BI kullanıcısı

GroupUserAccessRight

Kullanıcının çalışma alanında sahip olduğu erişim hakkı (izin düzeyi)

PrincipalType

Sorumlu türü

ReportUser

Bir rapor için Power BI kullanıcı erişim hakkı girdisi

ReportUserAccessRight

Kullanıcının rapor için sahip olduğu erişim hakkı (izin düzeyi)

ServicePrincipalProfile

Power BI hizmeti asıl profili. Yalnızca çok kiracılı Power BI Embedded çözüm için geçerlidir.

Subscription

Power BI öğesi (rapor veya pano gibi) için e-posta aboneliği

SubscriptionUser

Power BI e-posta aboneliği kullanıcısı

Workbook

Power BI çalışma kitabı

AdminDashboard

Yönetici API'leri tarafından döndürülen bir Power BI panosu. API, aşağıdaki pano özellikleri listesinin bir alt kümesini döndürür. Alt küme, çağrılan API'ye, çağıran izinlerine ve Power BI veritabanındaki verilerin kullanılabilirliğine bağlıdır.

Name Tür Description
appId

string

Yalnızca pano bir uygulamaya aitse döndürülen uygulama kimliği

displayName

string

Panonun görünen adı

embedUrl

string

Panonun ekleme URL'si

id

string

Pano kimliği

isReadOnly

boolean

Panonun salt okunur olup olmadığı

subscriptions

Subscription[]

(Boş Değer) Power BI öğesinin abonelik ayrıntıları (rapor veya pano gibi). Bu özellik, gelecek bir sürümde yük yanıtından kaldırılacaktır. Rapor Aboneliklerini Yönetici API çağrısı olarak al'ı kullanarak Power BI raporu için abonelik bilgilerini alabilirsiniz.

tiles

AdminTile[]

Panoya ait kutucuklar

users

DashboardUser[]

(Boş değer) Pano kullanıcısı erişim ayrıntıları. Bu özellik, gelecek bir sürümde yük yanıtından kaldırılacaktır. Yönetici API çağrısı olarak Pano Kullanıcılarını Al çağrısını veya parametresiyle PostWorkspaceInfo API çağrısını kullanarak bir Power BI panosundaki getArtifactUsers kullanıcı bilgilerini alabilirsiniz.

webUrl

string

Panonun web URL'si

workspaceId

string

Panonun çalışma alanı kimliği (GUID). Bu özellik yalnızca GetDashboardsAsAdmin içinde döndürülür.

AdminDataflow

Yönetici API'leri tarafından döndürülen veri akışının meta verileri. Aşağıda, veri akışı için döndürülebilecek özelliklerin listesi yer almaktadır. Çağrılan API'ye, çağıran izinlerine ve Power BI veritabanındaki verilerin kullanılabilirliğine bağlı olarak özelliklerin yalnızca bir alt kümesi döndürülür.

Name Tür Description
configuredBy

string

Veri akışı sahibi

description

string

Veri akışı açıklaması

modelUrl

string

Veri akışı tanım dosyasının URL'si (model.json)

modifiedBy

string

Veri akışını değiştiren kullanıcı

modifiedDateTime

string

Veri akışının son değiştirildiği tarih ve saat

name

string

Veri akışı adı

objectId

string

Veri akışı kimliği

users

DataflowUser[]

(Boş değer) Veri akışı kullanıcı erişim ayrıntıları. Bu özellik, gelecek bir sürümde yük yanıtından kaldırılacaktır. Veri Akışı Kullanıcılarını Al api çağrısını Yönetici veya parametresiyle PostWorkspaceInfo API çağrısını kullanarak Power BI veri akışındaki getArtifactUser kullanıcı bilgilerini alabilirsiniz.

workspaceId

string

Veri akışı çalışma alanı kimliği.

AdminDataset

Yönetici API'leri tarafından döndürülen bir Power BI veri kümesi. API, aşağıdaki veri kümesi özellikleri listesinin bir alt kümesini döndürür. Alt küme, çağrılan API'ye, çağıran izinlerine ve Power BI veritabanındaki verilerin kullanılabilirliğine bağlıdır.

Name Tür Description
ContentProviderType

string

Veri kümesinin içerik sağlayıcısı türü

CreateReportEmbedURL

string

Veri kümesi rapor ekleme URL'si oluşturur

CreatedDate

string

Veri kümesi oluşturma tarihi ve saati

Encryption

Encryption

Veri kümesi şifreleme bilgileri. Yalnızca belirtildiğinde $expand geçerlidir.

IsEffectiveIdentityRequired

boolean

Veri kümesinin etkili bir kimlik gerektirilip gerekmediği; bir GenerateToken API çağrısında göndermeniz gerekir.

IsEffectiveIdentityRolesRequired

boolean

Satır düzeyi güvenliğin Power BI .pbix dosyasında tanımlanıp tanımlanmadığı. Öyleyse, bir rol belirtmeniz gerekir.

IsInPlaceSharingEnabled

boolean

Veri kümesinin kendi kiracılarında kullanılacak dış kullanıcılarla paylaşılıp paylaşılamayacağı

IsOnPremGatewayRequired

boolean

Veri kümesinin şirket içi veri ağ geçidi gerektip gerektirmediği

IsRefreshable

boolean

Veri kümesinin yenilenebilir olup olmadığı. Power BI yenilenebilir veri kümesi, en az bir kez yenilenen veya geçerli bir yenileme zamanlaması bulunan bir veri kümesidir.

QnaEmbedURL

string

Q&A ekleme URL'si veri kümesi

addRowsAPIEnabled

boolean

Veri kümesinin yeni satır eklemeye izin verip vermediği

configuredBy

string

Veri kümesi sahibi

description

string

Veri kümesi açıklaması

id

string

Veri kümesi kimliği

name

string

Veri kümesi adı

queryScaleOutSettings

DatasetQueryScaleOutSettings

Veri kümesinin ölçeği genişletme ayarlarını sorgulama

targetStorageMode

string

Veri kümesi depolama modu

upstreamDataflows

DependentDataflow[]

Bu öğenin bağlı olduğu tüm veri akışlarının listesi

users

DatasetUser[]

(Boş değer) Veri kümesi kullanıcı erişim ayrıntıları. Bu özellik, gelecek bir sürümde yük yanıtından kaldırılacaktır. Veri Kümesi Kullanıcılarını Yönetici API olarak alma veya PostWorkspaceInfo API'sini parametresiyle getArtifactUsers kullanarak bir Power BI öğesindeki kullanıcı bilgilerini (rapor veya pano gibi) alabilirsiniz.

webUrl

string

Veri kümesinin web URL'si

workspaceId

string

Veri kümesi çalışma alanı kimliği. Bu özellik yalnızca GetDatasetsAsAdmin içinde döndürülür.

AdminGroup

Yönetici API'leri tarafından döndürülen bir Power BI grubu

Name Tür Description
capacityId

string

Kapasite kimliği

dashboards

AdminDashboard[]

Gruba ait panolar

dataflowStorageId

string

Power BI veri akışı depolama hesabı kimliği

dataflows

AdminDataflow[]

Gruba ait veri akışları

datasets

AdminDataset[]

Gruba ait veri kümeleri

defaultDatasetStorageFormat

DefaultDatasetStorageFormat

Çalışma alanındaki varsayılan veri kümesi depolama biçimi. Yalnızca şu durumlarda döndürülür:isOnDedicatedCapacitytrue

description

string

Grup açıklaması

hasWorkspaceLevelSettings

boolean

Çalışma alanının özel ayarları olup olmadığı

id

string

Çalışma alanı kimliği

isOnDedicatedCapacity

boolean

Grubun ayrılmış kapasiteye atanıp atanmadığı

isReadOnly

boolean

Grubun salt okunur olup olmadığı

logAnalyticsWorkspace

AzureResource

Gruba atanan Log Analytics çalışma alanı. Bu yalnızca tek bir grup alınırken döndürülür.

name

string

Grup adı

pipelineId

string

Çalışma alanının atandığı dağıtım işlem hattı kimliği.

reports

AdminReport[]

Gruba ait raporlar

state

string

Grup durumu

type

GroupType

Döndürülen grubun türü.

users

GroupUser[]

(Boş değer) Gruba ait olan kullanıcılar ve erişim hakları. Bu özellik, gelecek bir sürümde yük yanıtından kaldırılacaktır. Grup Kullanıcılarını API Yönetici olarak al api çağrısını veya postWorkspaceInfo API çağrısını parametresiyle getArtifactUsers kullanarak bir Power BI öğesindeki (rapor veya pano gibi) kullanıcı bilgilerini alabilirsiniz.

workbooks

Workbook[]

Gruba ait çalışma kitapları

AdminGroups

Yönetici API'ler tarafından döndürülen Power BI gruplarının listesi için OData yanıt sarmalayıcısı

Name Tür Description
odata.context

string

OData bağlamı

value

AdminGroup[]

Grup listesi

AdminReport

Yönetici API'ler tarafından döndürülen bir Power BI raporu. API, aşağıdaki rapor özellikleri listesinin bir alt kümesini döndürür. Alt küme, çağrılan API'ye, çağıran izinlerine ve Power BI veritabanındaki verilerin kullanılabilirliğine bağlıdır.

Name Tür Description
appId

string

Yalnızca rapor bir uygulamaya aitse döndürülen uygulama kimliği

createdBy

string

Rapor sahibi. Yalnızca Haziran 2019'dan sonra oluşturulan raporlarda kullanılabilir.

createdDateTime

string

Rapor oluşturma tarihi ve saati

datasetId

string

Raporun veri kümesi kimliği

description

string

Rapor açıklaması

embedUrl

string

Raporun ekleme URL'si

id

string

Rapor kimliği

isOwnedByMe

boolean

Raporun geçerli kullanıcı tarafından oluşturulup oluşturulmadığını belirleyin.

modifiedBy

string

Raporu değiştiren son kullanıcı

modifiedDateTime

string

Raporun son değiştirildiği tarih ve saat

name

string

Raporun adı

originalReportId

string

Çalışma alanı uygulama olarak yayımlandığında gerçek rapor kimliği.

reportType enum:
  • PaginatedReport
  • PowerBIReport

Rapor türü

subscriptions

Subscription[]

(Boş Değer) Power BI öğesinin abonelik ayrıntıları (rapor veya pano gibi). Bu özellik, gelecek bir sürümde yük yanıtından kaldırılacaktır. Rapor Aboneliklerini Yönetici API çağrısı olarak al'ı kullanarak Power BI raporu için abonelik bilgilerini alabilirsiniz.

users

ReportUser[]

(Boş değer) Power BI raporunun kullanıcı erişim ayrıntıları. Bu özellik, gelecek bir sürümde yük yanıtından kaldırılacaktır. Rapor Kullanıcılarını Yönetici API çağrısı olarak al veya parametresiyle PostWorkspaceInfo API çağrısını kullanarak bir Power BI raporundaki getArtifactUsers kullanıcı bilgilerini alabilirsiniz.

webUrl

string

Raporun web URL'si

workspaceId

string

Raporun çalışma alanı kimliği (GUID). Bu özellik yalnızca GetReportsAsAdmin içinde döndürülür.

AdminTile

Yönetici API'leri tarafından döndürülen bir Power BI kutucuğu.

Name Tür Description
colSpan

integer

Kutucuk yayılma sütunlarının sayısı

datasetId

string

Veri kümesi kimliği. Yalnızca bir rapordan veya Q&A kutucukları gibi bir veri kümesi kullanılarak oluşturulan kutucuklar için kullanılabilir.

embedData

string

Kutucuk için ekleme verileri

embedUrl

string

Kutucuğun ekleme URL'si

id

string

Kutucuk kimliği

reportId

string

Rapor kimliği. Yalnızca rapordan oluşturulan kutucuklar için kullanılabilir.

rowSpan

integer

Kutucuk yayılma satırlarının sayısı

title

string

Kutucuğun görünen adı

AzureResource

Log Analytics çalışma alanı gibi kullanıcıya ait bir Azure kaynağının ayrıntılarını içeren yanıt.

Name Tür Description
id

string

Power BI içindeki kaynağın tanımlayıcısı.

resourceGroup

string

Kaynağın bulunduğu abonelik içindeki kaynak grubu.

resourceName

string

Kaynağın adı.

subscriptionId

string

Kaynağın bulunduğu Azure aboneliği.

DashboardUser

Power BI kullanıcısı bir pano için doğru erişime sahip giriş

Name Tür Description
dashboardUserAccessRight

DashboardUserAccessRight

Kullanıcının pano için sahip olduğu erişim hakkı (izin düzeyi)

displayName

string

Sorumlunun görünen adı

emailAddress

string

Kullanıcının e-posta adresi

graphId

string

Microsoft Graph'ta sorumlunun tanımlayıcısı. Yalnızca yönetici API'leri için kullanılabilir.

identifier

string

Sorumlunun tanımlayıcısı

principalType

PrincipalType

Asıl tür

profile

ServicePrincipalProfile

Power BI hizmeti asıl profili. Yalnızca Power BI Embedded çok kiracılı çözüm için geçerlidir.

userType

string

Kullanıcının türü.

DashboardUserAccessRight

Kullanıcının pano için sahip olduğu erişim hakkı (izin düzeyi)

Name Tür Description
None

string

Panodaki içeriğe izin yok

Owner

string

Rapordaki içeriğe Okuma, Yazma ve Yeniden Paylaşma erişimi verir

Read

string

Panodaki içeriğe Okuma erişimi verir

ReadCopy

string

Panodaki içeriğe Okuma ve Kopyalama erişimi verir

ReadReshare

string

Panodaki içeriğe Okuma ve Yeniden Paylaşma erişimi verir

ReadWrite

string

Panodaki içeriğe Okuma ve Yazma erişimi verir

DataflowUser

Power BI kullanıcısı veri akışı için doğru erişime sahip giriş

Name Tür Description
DataflowUserAccessRight

DataflowUserAccessRight

Bir kullanıcının veri akışı için sahip olduğu erişim hakkı (izin düzeyi)

displayName

string

Sorumlunun görünen adı

emailAddress

string

Kullanıcının e-posta adresi

graphId

string

Microsoft Graph'ta sorumlunun tanımlayıcısı. Yalnızca yönetici API'leri için kullanılabilir.

identifier

string

Sorumlunun tanımlayıcısı

principalType

PrincipalType

Asıl tür

profile

ServicePrincipalProfile

Power BI hizmeti asıl profili. Yalnızca Power BI Embedded çok kiracılı çözüm için geçerlidir.

userType

string

Kullanıcının türü.

DataflowUserAccessRight

Bir kullanıcının veri akışı için sahip olduğu erişim hakkı (izin düzeyi)

Name Tür Description
None

string

Veri akışındaki içeriğe yönelik izni kaldırır

Owner

string

Veri akışındaki içeriğe Okuma, Yazma ve Yeniden Paylaşma erişimi verir

Read

string

Veri akışındaki içeriğe Okuma erişimi verir

ReadReshare

string

Veri akışındaki içeriğe Okuma ve Yeniden Paylaşma erişimi verir

ReadWrite

string

Veri akışındaki içeriğe Okuma ve Yazma erişimi verir

DatasetQueryScaleOutSettings

Veri kümesinin ölçeği genişletme ayarlarını sorgulama

Name Tür Description
autoSyncReadOnlyReplicas

boolean

Veri kümesinin salt okunur çoğaltmaları otomatik olarak eşitleyip eşitlemediği

maxReadOnlyReplicas

integer

Veri kümesi için en fazla salt okunur çoğaltma sayısı (otomatik çoğaltma sayısı için 0-64, -1)

DatasetUser

Power BI kullanıcısı bir veri kümesi için doğru erişime sahip giriş

Name Tür Description
datasetUserAccessRight

DatasetUserAccessRight

Kullanıcının veri kümesi için sahip olduğu erişim hakkı (izin düzeyi)

displayName

string

Sorumlunun görünen adı

emailAddress

string

Kullanıcının e-posta adresi

graphId

string

Microsoft Graph'ta sorumlunun tanımlayıcısı. Yalnızca yönetici API'leri için kullanılabilir.

identifier

string

Sorumlunun tanımlayıcısı

principalType

PrincipalType

Asıl tür

profile

ServicePrincipalProfile

Power BI hizmeti asıl profili. Yalnızca Power BI Embedded çok kiracılı çözüm için geçerlidir.

userType

string

Kullanıcının türü.

DatasetUserAccessRight

Kullanıcının veri kümesi için sahip olduğu erişim hakkı (izin düzeyi)

Name Tür Description
None

string

Veri kümesindeki içeriğe yönelik izni kaldırır

Read

string

Veri kümesindeki içeriğe Okuma erişimi verir

ReadExplore

string

Veri kümesindeki içeriğe Okuma ve Araştırma erişimi verir

ReadReshare

string

Veri kümesindeki içeriğe Okuma ve Yeniden Paylaşma erişimi verir

ReadReshareExplore

string

Veri kümesindeki içeriğe Okuma, Yeniden Paylaşma ve Keşfetme erişimi verir

ReadWrite

string

Veri kümesindeki içeriğe Okuma ve Yazma erişimi verir

ReadWriteExplore

string

Veri kümesindeki içeriğe Okuma, Yazma ve Araştırma erişimi verir

ReadWriteReshare

string

Veri kümesindeki içeriğe Okuma, Yazma ve Yeniden Paylaşma erişimi verir

ReadWriteReshareExplore

string

Veri kümesindeki içeriğe Okuma, Yazma, Yeniden Paylaşma ve Keşfetme erişimi verir

DefaultDatasetStorageFormat

Gruptaki varsayılan veri kümesi depolama biçimi

Name Tür Description
Large

string

Büyük veri kümesi depolama biçimi

Small

string

Küçük veri kümesi depolama biçimi

DependentDataflow

Power BI'a bağımlı veri akışı

Name Tür Description
groupId

string

Hedef grup kimliği

targetDataflowId

string

Hedef veri akışı kimliği

Encryption

Veri kümesi için şifreleme bilgileri

Name Tür Description
EncryptionStatus

EncryptionStatus

Veri kümesi şifreleme durumu

EncryptionStatus

Veri kümesi şifreleme durumu

Name Tür Description
InSyncWithWorkspace

string

Şifreleme desteklenir ve şifreleme ayarlarıyla eşitlenir

NotInSyncWithWorkspace

string

Şifreleme desteklenir ancak şifreleme ayarlarıyla eşitlenmez

NotSupported

string

Bu veri kümesi için şifreleme desteklenmiyor

Unknown

string

Veri kümesi bozulması nedeniyle şifreleme durumu bilinmiyor

GroupType

Grup türü

Name Tür Description
Group

string

Paylaşılan çalışma alanının V1 sürümü. Microsoft tüm çalışma alanlarını paylaşılan çalışma alanının en son sürümüne geçirirken bu tür çalışma alanları kullanım dışı bırakılacak

Personal

string

SharePoint listesi ve OneDrive tümleştirmesi için özel çalışma alanı türü

PersonalGroup

string

Kişisel çalışma alanı olarak da bilinen "Çalışma alanım".

Workspace

string

Paylaşılan çalışma alanı veya kuruluştaki diğer kullanıcılarla içerik paylaşmak için kullanılan basit çalışma alanı

GroupUser

Çalışma alanına erişimi olan bir Power BI kullanıcısı

Name Tür Description
displayName

string

Sorumlunun görünen adı

emailAddress

string

Kullanıcının e-posta adresi

graphId

string

Microsoft Graph'ta sorumlunun tanımlayıcısı. Yalnızca yönetici API'leri için kullanılabilir.

groupUserAccessRight

GroupUserAccessRight

Kullanıcının çalışma alanında sahip olduğu erişim hakkı (izin düzeyi)

identifier

string

Sorumlunun tanımlayıcısı

principalType

PrincipalType

Asıl tür

profile

ServicePrincipalProfile

Power BI hizmeti asıl profili. Yalnızca Power BI Embedded çok kiracılı çözüm için geçerlidir.

userType

string

Kullanıcının türü.

GroupUserAccessRight

Kullanıcının çalışma alanında sahip olduğu erişim hakkı (izin düzeyi)

Name Tür Description
Admin

string

Çalışma alanı içeriği için yönetici hakları

Contributor

string

Çalışma alanı içeriğine erişimi okuma ve keşfetme (ReadExplore)

Member

string

Çalışma alanı içeriğine erişim haklarını okuma, yeniden paylaşma ve keşfetme (ReadReshareExplore)

None

string

Çalışma alanı içeriğine erişim yok

Viewer

string

Çalışma alanı içeriğine salt okunur (Okuma) erişimi

PrincipalType

Sorumlu türü

Name Tür Description
App

string

Hizmet sorumlusu türü

Group

string

Grup sorumlusu türü

None

string

Sorumlu türü yok. Tüm kuruluş düzeyinde erişim için kullanın.

User

string

Kullanıcı asıl türü

ReportUser

Bir rapor için Power BI kullanıcı erişim hakkı girdisi

Name Tür Description
displayName

string

Sorumlunun görünen adı

emailAddress

string

Kullanıcının e-posta adresi

graphId

string

Microsoft Graph'ta sorumlunun tanımlayıcısı. Yalnızca yönetici API'leri için kullanılabilir.

identifier

string

Sorumlunun tanımlayıcısı

principalType

PrincipalType

Sorumlu türü

profile

ServicePrincipalProfile

Power BI hizmeti asıl profili. Yalnızca çok kiracılı Power BI Embedded çözüm için geçerlidir.

reportUserAccessRight

ReportUserAccessRight

Kullanıcının rapor için sahip olduğu erişim hakkı (izin düzeyi)

userType

string

Kullanıcının türü.

ReportUserAccessRight

Kullanıcının rapor için sahip olduğu erişim hakkı (izin düzeyi)

Name Tür Description
None

string

Rapordaki içerik için izin yok

Owner

string

Rapordaki içeriğe Okuma, Yazma ve Yeniden Paylaşma erişimi verir

Read

string

Rapordaki içeriğe Okuma erişimi verir

ReadCopy

string

Rapordaki içeriğe Okuma ve Kopyalama erişimi verir

ReadReshare

string

Rapordaki içeriğe Okuma ve Yeniden Paylaşma erişimi verir

ReadWrite

string

Rapordaki içeriğe Okuma ve Yazma erişimi verir

ServicePrincipalProfile

Power BI hizmeti asıl profili. Yalnızca çok kiracılı Power BI Embedded çözüm için geçerlidir.

Name Tür Description
displayName

string

Hizmet sorumlusu profil adı

id

string

Hizmet sorumlusu profil kimliği

Subscription

Power BI öğesi (rapor veya pano gibi) için e-posta aboneliği

Name Tür Description
artifactDisplayName

string

Abone olunan Power BI öğesinin adı (rapor veya pano gibi)

artifactId

string

Abone olunan Power BI öğesinin kimliği (rapor veya pano gibi)

artifactType

string

Power BI öğesinin türü (örneğin Report, , Dashboardveya Dataset)

attachmentFormat

string

E-posta aboneliğine eklenen raporun biçimi

endDate

string

E-posta aboneliğinin bitiş tarihi ve saati

frequency

string

E-posta aboneliğinin sıklığı

id

string

Abonelik kimliği

isEnabled

boolean

E-posta aboneliğinin etkinleştirilip etkinleştirilmediği

linkToContent

boolean

E-posta aboneliğinde abonelik bağlantısı olup olmadığı

previewImage

boolean

Raporun ekran görüntüsünün e-posta aboneliğinde olup olmadığı

startDate

string

E-posta aboneliğinin başlangıç tarihi ve saati

subArtifactDisplayName

string

Bir raporsa abone olunan Power BI öğesinin sayfa adı.

title

string

Uygulama adı

users

SubscriptionUser[]

Her e-posta abonesinin ayrıntıları. Api çağrısını Yönetici Olarak Kullanıcı Aboneliklerini Al kullanıldığında, döndürülen değer boş bir dizidir (null). Bu özellik, gelecek bir sürümde yük yanıtından kaldırılacaktır. Bir Power BI raporu veya panosundaki abonelik bilgilerini almak için Rapor Aboneliklerini Yönetici Olarak Al veya Pano Aboneliklerini Yönetici API çağrıları olarak al'ı kullanabilirsiniz.

SubscriptionUser

Power BI e-posta aboneliği kullanıcısı

Name Tür Description
displayName

string

Sorumlunun görünen adı

emailAddress

string

Kullanıcının e-posta adresi

graphId

string

Microsoft Graph'ta sorumlunun tanımlayıcısı. Yalnızca yönetici API'leri için kullanılabilir.

identifier

string

Sorumlunun tanımlayıcısı

principalType

PrincipalType

Asıl tür

profile

ServicePrincipalProfile

Power BI hizmeti asıl profili. Yalnızca Power BI Embedded çok kiracılı çözüm için geçerlidir.

userType

string

Kullanıcının türü.

Workbook

Power BI çalışma kitabı

Name Tür Description
datasetId

string

Çalışma kitabıyla ilişkili veri kümesinin kimliği. Yalnızca çalışma kitabında ilişkili bir veri kümesi varsa geçerlidir.

name

string

Çalışma kitabının adı