Admin - Groups GetGroupsAsAdmin

Başvuru

Hizmet:: Power BI REST APIs

API Sürümü:: v1.0

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

İzinler

Kullanıcının Doku yöneticisi 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 uygulama Azure portalında Power BI için yönetici onayı gerekli izinlerin ayarlanmaması.

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ırlama

Kiracı başına saatte en fazla 50 istek veya dakikada 15 istek. Bu çağrı, Power BI hizmeti üzerinde 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}

İsteğe bağlı parametrelerle:

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çinde genişletilecek veri türlerinin virgülle ayrılmış listesini kabul eder. `users`, `reports`, `dashboards`, `datasets`, `dataflows`ve `workbooks`destekler.
$filter	query		string	Odata filtre sorgusu parametre koşuluna göre sonuçların bir alt kümesini döndürür.
$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.

Örnek isteği

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

Örnek yanıt

Durum kodu:: 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.

Örnek isteği

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

Örnek yanıt

Durum kodu:: 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

Örnek isteği

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

Örnek yanıt

Durum kodu:: 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

Örnek isteği

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

Örnek yanıt

Durum kodu:: 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.

Örnek isteği

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

Örnek yanıt

Durum kodu:: 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

Örnek isteği

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

Örnek yanıt

Durum kodu:: 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.

Örnek isteği

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

Örnek yanıt

Durum kodu:: 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

Örnek isteği

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

Örnek yanıt

Durum kodu:: 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'leri tarafından döndürülen Power BI gruplarının listesi için OData yanıt sarmalayıcısı
AdminReport	Yönetici API'leri 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şim girdisi
DashboardUserAccessRight	Kullanıcının pano için sahip olduğu erişim hakkı (izin düzeyi)
DataflowUser	Veri akışı için 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	Power BI kullanıcısı veri kümesi için doğru erişim girdisi
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 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	Asıl tür
ReportUser	Power BI kullanıcısı bir rapor için doğru girişe erişti
ReportUserAccessRight	Kullanıcının rapor için sahip olduğu erişim hakkı (izin düzeyi)
ServicePrincipalProfile	Power BI hizmet sorumlusu profili. Yalnızca Power BI Embedded çok kiracılı çö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) Bir Power BI öğesinin (rapor veya pano gibi) abonelik ayrıntıları. 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 alma 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. Power BI panosundaki kullanıcı bilgilerini almak için Pano Kullanıcılarını Yönetici olarak Al API çağrısı veya parametresiyle PostWorkspaceInfo API çağrısını .
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)
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ı Yönetici API çağrısı olarak alma veya parametresiyle PostWorkspaceInfo API çağrısı kullanarak Power BI veri akışındaki 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
Encryption	Encryption	Veri kümesi şifreleme bilgileri. Yalnızca `$expand` belirtildiğinde geçerlidir.
IsEffectiveIdentityRequired	boolean	Veri kümesinin etkili bir kimlik gerekip gerekmediği; 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 tüketilecek dış kullanıcılarla paylaşılıp paylaşılamayacağı
IsOnPremGatewayRequired	boolean	Veri kümesinin şirket içi veri ağ geçidi gerekip gerektirmediği
IsRefreshable	boolean	Bu alan, veri kümesi yakın zamanda yenilendiğinde veya bağlantı modu özel olarak 'İçeri Aktar' olarak ayarlandığında otomatik yenileme için yapılandırıldığında `true` döndürür. Değer, veri kümesinin el ile yenilenmesinden veya otomatik yenileme için ayarlanmasından bağımsız olarak 'DirectQuery' ve 'LiveConnection' gibi diğer bağlantı modları için `false` döndürür.
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
createdDate	string	Veri kümesi oluşturma tarihi ve saati
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 Olarak Al API'sini veya parametresiyle PostWorkspaceInfo API'sini kullanarak bir Power BI öğesinde (rapor veya pano gibi) kullanıcı bilgilerini 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 `isOnDedicatedCapacitytrue` döndürülür
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ı Yönetici Olarak Al API çağrısı veya parametresiyle PostWorkspaceInfo API çağrısı kullanarak bir Power BI öğesinde (rapor veya pano gibi) kullanıcı bilgilerini alabilirsiniz.
workbooks	Workbook[]	Gruba ait çalışma kitapları

AdminGroups

Yönetici API'leri 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'leri 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ı bir uygulama olarak yayımlandığında gerçek rapor kimliği.
reportType	enum: PaginatedReport PowerBIReport	Rapor türü
subscriptions	Subscription[]	(Boş Değer) Bir Power BI öğesinin (rapor veya pano gibi) abonelik ayrıntıları. 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 alma kullanarak Power BI raporu için abonelik bilgilerini alabilirsiniz.
users	ReportUser[]	(Boş değer) Power BI raporu için 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 olarak Al API çağrısını veya parametresiyle PostWorkspaceInfo API çağrısını kullanarak Power BI raporundaki 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 yayma 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	Kutucuğun 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ılması 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şim 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	Asıl tür
profile	ServicePrincipalProfile	Power BI hizmet sorumlusu 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	Panoda içerik için 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 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	Asıl tür
profile	ServicePrincipalProfile	Power BI hizmet sorumlusu profili. Yalnızca Power BI Embedded çok kiracılı çö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 -1 0-64)

DatasetUser

Power BI kullanıcısı veri kümesi için doğru erişim girdisi

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 hizmet sorumlusu 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 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
AdminWorkspace	string	Doku Yöneticileri için Yönetici İzleme
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ımdan kaldırılacak
Personal	string	SharePoint listesi ve OneDrive tümleştirmesi için özel tür çalışma alanı
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 hizmet sorumlusu 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

Asıl tür

Name	Tür	Description
App	string	Hizmet sorumlusu türü
Group	string	Grup sorumlusu türü
None	string	Sorumlu türü yok. Kuruluş düzeyinde erişimin tamamı için kullanın.
User	string	Kullanıcı asıl türü

ReportUser

Power BI kullanıcısı bir rapor için doğru girişe erişti

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 hizmet sorumlusu profili. Yalnızca Power BI Embedded çok kiracılı çö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	Raporda 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 hizmet sorumlusu profili. Yalnızca Power BI Embedded çok kiracılı çö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 mevcut olup olmadığı
startDate	string	E-posta aboneliğinin başlangıç tarihi ve saati
subArtifactDisplayName	string	Raporsa abone olunan Power BI öğesinin sayfa adı.
title	string	Uygulama adı
users	SubscriptionUser[]	Her e-posta abonesinin ayrıntıları. Kullanıcı Aboneliklerini Yönetici Olarak Al API çağrısı 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. Rapor Aboneliklerini Yönetici Olarak Al kullanarak veya Pano Aboneliklerini Yönetici Olarak Al API çağrılarını bir Power BI raporu veya panosundaki abonelik bilgilerini alabilirsiniz.

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 hizmet sorumlusu 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şkilendirilmiş veri kümesinin kimliği. Yalnızca çalışma kitabının ilişkili bir veri kümesi varsa geçerlidir.
name	string	Çalışma kitabının adı

Aracılığıyla paylaş

Admin - Groups GetGroupsAsAdmin

İzinler

Gerekli Kapsam

Sınırlama

URI Parametreleri

Yanıtlar

Örnekler

Get deleted workspaces example.

Örnek isteği

Örnek yanıt

Get orphaned workspaces example.

Örnek isteği

Örnek yanıt

Get workspaces with their 'dashboards' expanded example

Örnek isteği

Örnek yanıt

Get workspaces with their 'datasets' expanded example

Örnek isteği

Örnek yanıt

Get workspaces with their 'datasets' expanded example.

Örnek isteği

Örnek yanıt

Get workspaces with their 'reports' expanded example

Örnek isteği

Örnek yanıt

Get workspaces with their 'users' expanded example.

Örnek isteği

Örnek yanıt

Get workspaces with their 'workbooks' expanded example

Örnek isteği

Örnek yanıt

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