Admin - WorkspaceInfo PostWorkspaceInfo

Başvuru

Service:: Power BI REST APIs

API Version:: v1.0

İstenen çalışma alanları listesi için meta verileri almak için bir çağrı başlatır.

Önemli

veya datasetExpressions parametrelerini olarak trueayarlarsanızdatasetSchema, verilerin döndürülmesi için meta veri taramasını tamamen etkinleştirmeniz gerekir. Daha fazla bilgi için bkz . Meta veri tarama için kiracı ayarlarını etkinleştirme.

İ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 500 istek.
En fazla 16 eşzamanlı istek.

POST https://api.powerbi.com/v1.0/myorg/admin/workspaces/getInfo

With optional parameters:

POST https://api.powerbi.com/v1.0/myorg/admin/workspaces/getInfo?lineage={lineage}&datasourceDetails={datasourceDetails}&datasetSchema={datasetSchema}&datasetExpressions={datasetExpressions}&getArtifactUsers={getArtifactUsers}

URI Parametreleri

Name	İçinde	Tür	Description
datasetExpressions	query	boolean	Veri kümesi ifadelerinin döndürülip döndürülmeyeceği (DAX ve Mashup sorguları). Bu parametreyi olarak `true`ayarlarsanız, verilerin döndürülmesi için meta veri taramasını tamamen etkinleştirmeniz gerekir. Daha fazla bilgi için bkz . Meta veri tarama için kiracı ayarlarını etkinleştirme.
datasetSchema	query	boolean	Veri kümesi şemasının (tablolar, sütunlar ve ölçüler) döndürülip döndürülmeyeceği. Bu parametreyi olarak `true`ayarlarsanız, verilerin döndürülmesi için meta veri taramasını tamamen etkinleştirmeniz gerekir. Daha fazla bilgi için bkz . Meta veri tarama için kiracı ayarlarını etkinleştirme.
datasourceDetails	query	boolean	Veri kaynağı ayrıntılarının döndürülip döndürülmeyeceği
getArtifactUsers	query	boolean	Power BI öğesi için kullanıcı ayrıntılarının (rapor veya pano gibi) döndürülip döndürülmeyeceği
lineage	query	boolean	Köken bilgilerinin (yukarı akış veri akışları, kutucuklar, veri kaynağı kimlikleri) döndürülip döndürülmeyeceği

İstek Gövdesi

Name	Tür	Description
workspaces	string[]	Taranacak gerekli çalışma alanı kimlikleri (1 ile 100 çalışma alanı kimliklerini destekler)

Yanıtlar

Name	Tür	Description
202 Accepted	ScanRequest	Kabul edildi

Örnekler

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/admin/workspaces/getInfo?lineage=True&datasourceDetails=True&datasetSchema=True&datasetExpressions=True

Request Body

{
  "workspaces": [
    "97d03602-4873-4760-b37e-1563ef5358e3",
    "67b7e93a-3fb3-493c-9e41-2c5051008f24"
  ]
}

Sample Response

Status code:: 202

{
  "id": "e7d03602-4873-4760-b37e-1563ef5358e3",
  "createdDateTime": "2020-06-15T16:46:28.0487687Z",
  "status": "NotStarted"
}

Tanımlar

Name	Description
PowerBIApiErrorResponseDetail	Power BI hata yanıtı hakkında ayrıntılı bilgi
RequiredWorkspaces	Gerekli bir çalışma alanı isteği
ScanRequest	Tarama isteği

PowerBIApiErrorResponseDetail

Power BI hata yanıtı hakkında ayrıntılı bilgi

Name	Tür	Description
code	string	Hata kodu
message	string	Hata iletisi
target	string	Hata hedefi

RequiredWorkspaces

Gerekli bir çalışma alanı isteği

Name	Tür	Description
workspaces	string[]	Taranacak gerekli çalışma alanı kimlikleri (1 ile 100 çalışma alanı kimliklerini destekler)

ScanRequest

Tarama isteği

Name	Tür	Description
createdDateTime	string	Tarama oluşturma tarihi ve saati
error	PowerBIApiErrorResponseDetail	Tarama hatası (varsa)
id	string	Tarama kimliği
status	string	Tarama durumu

Aracılığıyla paylaş