Admin - Groups GetGroupsAsAdmin

Başvuru

Service:: Power BI REST APIs

API Version:: v1.0

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 prinicipal 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}

With optional parameters:

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`, `datasetsdataflows`ve `workbooks`'yi destekler`users`.
$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

Status code:: 200

{
  "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

Status code:: 200

{
  "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

Status code:: 200

{
  "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

Status code:: 200

{
  "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

Status code:: 200

{
  "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

Status code:: 200

{
  "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

Status code:: 200

{
  "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

Status code:: 200

{
  "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	Bir pano için Power BI kullanıcı erişim hakkı girdisi
DashboardUserAccessRight	Kullanıcının pano için sahip olduğu erişim hakkı (izin düzeyi)
DataflowUser	Veri akışı için Bir Power BI kullanıcı erişim hakkı girdisi
DataflowUserAccessRight	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	Bir veri kümesi için Power BI kullanıcı erişim hakkı girişi
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
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

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

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	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.
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

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

Name	Tür	Description
DataflowUserAccessRight	DataflowUserAccessRight	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	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.
userType	string	Kullanıcının türü.

DataflowUserAccessRight

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

Bir veri kümesi için Power BI kullanıcı erişim hakkı girişi

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	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.
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 Araştırma 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 Araştırma 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çeriğe 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`, , `Dashboard`veya `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	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.
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ı

Admin - Groups GetGroupsAsAdmin

İzinler

Gerekli Kapsam

Sınırlamalar

URI Parametreleri

Yanıtlar

Örnekler

Get deleted workspaces example.

Sample Request

Sample Response

Get orphaned workspaces example.

Sample Request

Sample Response

Get workspaces with their 'dashboards' expanded example

Sample Request

Sample Response

Get workspaces with their 'datasets' expanded example

Sample Request

Sample Response

Get workspaces with their 'datasets' expanded example.

Sample Request

Sample Response

Get workspaces with their 'reports' expanded example

Sample Request

Sample Response

Get workspaces with their 'users' expanded example.

Sample Request

Sample Response

Get workspaces with their 'workbooks' expanded example

Sample Request

Sample Response

Tanımlar

AdminDashboard

AdminDataflow

AdminDataset

AdminGroup

AdminGroups

AdminReport

AdminTile

AzureResource

DashboardUser

DashboardUserAccessRight

DataflowUser

DataflowUserAccessRight

DatasetQueryScaleOutSettings

DatasetUser

DatasetUserAccessRight

DefaultDatasetStorageFormat

DependentDataflow

Encryption

EncryptionStatus

GroupType

GroupUser

GroupUserAccessRight

PrincipalType

ReportUser

ReportUserAccessRight

ServicePrincipalProfile

Subscription

SubscriptionUser

Workbook

Ek kaynaklar