Admin - WorkspaceInfo GetModifiedWorkspaces

  • Başvuru
Service:
Power BI REST APIs
API Version:
v1.0

Kuruluştaki çalışma alanı kimliklerinin listesini alır.

İsteğe bağlı modifiedSince parametre bir tarih-saat olarak ayarlanırsa, yalnızca bu tarih-saatten sonra değiştirilen çalışma alanlarının kimlikleri döndürülür. modifiedSince Parametresi kullanılmıyorsa, kuruluştaki tüm çalışma alanlarının kimlikleri döndürülür. parametresi tarafından modifiedSince belirtilen tarih-saat, çalışma alanı değişikliklerinin geçerli saatten 30 gün öncesine kadar 30 dakika (etkili olması için) aralığında olmalıdır.

İzinler

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

Hizmet sorumlusu kimlik doğrulaması altında çalışı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

Saatte en fazla 30 istek. 

GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/modified
With optional parameters: 
GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/modified?modifiedSince={modifiedSince}&excludePersonalWorkspaces={excludePersonalWorkspaces}&excludeInActiveWorkspaces={excludeInActiveWorkspaces}

URI Parametreleri

Name İçinde Gerekli Tür Description
excludeInActiveWorkspaces
 query

boolean

Etkin olmayan çalışma alanlarının dışlanıp dışlanmadığı
excludePersonalWorkspaces
 query

boolean

Kişisel çalışma alanlarının dışlanıp dışlanmadığı
modifiedSince
 query

string

date-time

Son değiştirme tarihi (ISO 8601 uyumlu UTC biçiminde olmalıdır)

Yanıtlar

Name Tür Description
200 OK

ModifiedWorkspace[]

Tamam

Örnekler

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/modified?modifiedSince=2020-10-02T05:51:30.0000000Z&excludePersonalWorkspaces=True&excludeInActiveWorkspaces=True

Sample Response

Status code:
200 
[
  {
    "Id": "3740504d-1f93-42f9-8e9d-c8ba9b787a3b"
  },
  {
    "Id": "19cb346c-9839-4e19-81e6-76364d0b836f"
  }
]

Tanımlar

ModifiedWorkspace

Değiştirilmiş çalışma alanı

Name Tür Description
Id

string

Çalışma alanı nesne kimliği