Items - List Items

Hizmet:: Admin

API Sürümü:: v1

Etkin Fabric ve PowerBI öğelerinin listesini döndürür.

Note

Bu API, önizleme sürümünün bir parçasıdır ve yalnızca değerlendirme ve geliştirme amacıyla sağlanır. Geri bildirim temelinde değişebilir ve üretim kullanımı için önerilmez.

Bu API, sayfalandırmadestekler. İstek başına en fazla 10.000 kayıt döndürülebilir. Yanıtta sağlanan sürekli belirteçle sonraki 10.000 kaydı alabilirsiniz.

Sayfa sırası:

öğeleri Fabric
Datamarts
Reports
Dashboards
SemanticModels
Apps
Dataflows

Permissions

Çağıranın Fabric yöneticisi olması veya hizmet sorumlusu kullanarak kimlik doğrulaması yapması gerekir.

Gerekli Temsilci Kapsamları

Tenant.Read.All veya Tenant.ReadWrite.All

Limitations

Saatte en fazla 200 istek.

Desteklenen kimlikleri Microsoft Entra

Bu API, bu bölümde listelenen Microsoft identities destekler.

Identity	Support
User	Yes
Hizmet sorumlusu ve yönetilen kimlikler	Yes

Interface

GET https://api.fabric.microsoft.com/v1/admin/items

İsteğe bağlı parametrelerle:

GET https://api.fabric.microsoft.com/v1/admin/items?workspaceId={workspaceId}&capacityId={capacityId}&state={state}&type={type}&continuationToken={continuationToken}

URI Parametreleri

Name	İçinde	Tür	Description
capacityId	query	string (uuid)	Çalışma alanının kapasite kimliği.
continuationToken	query	string	Sonraki sayfa öğelerini almak için kullanılan sürekli belirteç.
state	query	string	Öğe durumu. Desteklenen durumlar etkindir.
type	query	string	Öğe türü.
workspaceId	query	string (uuid)	Çalışma alanı kimliği.

Yanıtlar

Name Tür Description

200 OK

Name	Tür	Description
200 OK	Items	İşlem başarılı oldu.
429 Too Many Requests	ErrorResponse	Hizmet fiyatı sınırı aşıldı. Sunucu, istemcinin ek istek göndermeden önce ne kadar beklemesi gerektiğini saniye cinsinden belirten bir `Retry-After` üst bilgi döndürür. Üst Bilgiler Retry-After: integer
Other Status Codes	ErrorResponse	Yaygın hata kodları: ItemNotFound - Öğe Kimliği yok. InvalidItemType - Öğe türü geçerli değil. InvalidItemState - Öğe durumu geçerli değil.

Items

İşlem başarılı oldu.

429 Too Many Requests

ErrorResponse

Hizmet fiyatı sınırı aşıldı. Sunucu, istemcinin ek istek göndermeden önce ne kadar beklemesi gerektiğini saniye cinsinden belirten bir Retry-After üst bilgi döndürür.

Üst Bilgiler

Retry-After: integer

Other Status Codes

ErrorResponse

Yaygın hata kodları:

ItemNotFound - Öğe Kimliği yok.
InvalidItemType - Öğe türü geçerli değil.
InvalidItemState - Öğe durumu geçerli değil.

Örnekler

Get a list of items using type query parameter example

Get all items in the tenant example

Get list of datamarts using type query parameter example

Get a list of items using type query parameter example

Örnek isteği

HTTP

GET https://api.fabric.microsoft.com/v1/admin/items?type=Report

Örnek yanıt

Durum kodu:: 200

{
  "itemEntities": [
    {
      "id": "b1a7e572-2585-4650-98ae-b92356f4460b",
      "type": "Report",
      "name": "Test Report",
      "state": "Active",
      "lastUpdatedDate": "2022-06-27T16:55:04.893",
      "workspaceId": "7f4496db-9929-47bd-89c0-d7eb2f517a98",
      "capacityId": "D5E336D6-D919-4ECC-B424-1F771A506851",
      "creatorPrincipal": {
        "id": "f3052d1c-61a9-46fb-8df9-0d78916ae041",
        "displayName": "Jacob Hancock",
        "type": "User",
        "userDetails": {
          "userPrincipalName": "Jacob@example.com"
        }
      },
      "tags": [
        {
          "displayName": "Tag 1",
          "id": "b4e54dd6-1d37-4e7a-9e9a-49a596ff4470"
        },
        {
          "displayName": "Tag 2",
          "id": "62d18d7e-3878-478a-b89b-2f38b73c18a4"
        }
      ]
    }
  ],
  "continuationUri": null,
  "continuationToken": null
}

Get all items in the tenant example

Örnek isteği

HTTP

GET https://api.fabric.microsoft.com/v1/admin/items

Örnek yanıt

Durum kodu:: 200

{
  "itemEntities": [
    {
      "id": "17d8929d-ab32-46d1-858b-fdea74e93bff",
      "type": "Notebook",
      "name": "Test",
      "description": "Test notebook.",
      "state": "Active",
      "lastUpdatedDate": "2022-04-29T17:47:29.98673",
      "workspaceId": "7f4496db-9929-47bd-89c0-d7eb2f517a95",
      "capacityId": "D5E336D6-D919-4ECC-B424-1F771A506851",
      "creatorPrincipal": {
        "id": "f3052d1c-61a9-46fb-8df9-0d78916ae041",
        "displayName": "Caleb Foster",
        "type": "User",
        "userDetails": {
          "userPrincipalName": "caleb@example.com"
        }
      },
      "defaultIdentity": {
        "id": "f3052d1c-61a9-46fb-8df9-0d78916ae041",
        "displayName": "Caleb Foster",
        "type": "User",
        "userDetails": {
          "userPrincipalName": "caleb@example.com"
        }
      },
      "tags": [
        {
          "displayName": "Tag 1",
          "id": "b4e54dd6-1d37-4e7a-9e9a-49a596ff4470"
        },
        {
          "displayName": "Tag 2",
          "id": "62d18d7e-3878-478a-b89b-2f38b73c18a4"
        }
      ]
    },
    {
      "id": "37d8929d-ab32-46d1-858b-fdea74e93bff",
      "type": "KQLDatabase",
      "name": "TestKusto",
      "description": "Test KQL database.",
      "state": "Active",
      "lastUpdatedDate": "2022-06-30T17:47:29.98673",
      "workspaceId": "8f4496db-9929-47bd-89c0-d7eb2f517a95",
      "capacityId": "D5E336D6-D919-4ECC-B424-1F881A506851",
      "creatorPrincipal": {
        "id": "f3052d1c-61a9-46fb-8df9-0d78916ae041",
        "displayName": "Jacob Hancock",
        "type": "User",
        "userDetails": {
          "userPrincipalName": "jacob@example.com"
        }
      },
      "defaultIdentity": {
        "id": "f3052d1c-61a9-46fb-8df9-0d78916ae041",
        "displayName": "Jacob Hancock",
        "type": "User",
        "userDetails": {
          "userPrincipalName": "jacob@example.com"
        }
      }
    }
  ],
  "continuationUri": "https://api.fabric.microsoft.com/v1/admin/items?continuationToken=MSwxMDAwMCww",
  "continuationToken": "MSwxMDAwMCww"
}

Get list of datamarts using type query parameter example

Örnek isteği

HTTP

GET https://api.fabric.microsoft.com/v1/admin/items?type=Lakehouse

Örnek yanıt

Durum kodu:: 200

{
  "itemEntities": [
    {
      "id": "b1a7e572-2585-4650-98ae-b92356f4460b",
      "type": "Lakehouse",
      "name": "Lakehouse 2022-03-16T21:42:38.442Z",
      "state": "Active",
      "lastUpdatedDate": "2022-06-27T16:55:04.893",
      "workspaceId": "7f4496db-9929-47bd-89c0-d7eb2f517a98",
      "capacityId": "D5E336D6-D919-4ECC-B424-1F771A506851",
      "creatorPrincipal": {
        "id": "f3052d1c-61a9-46fb-8df9-0d78916ae041",
        "displayName": "Jacob Hancock",
        "type": "User",
        "userDetails": {
          "userPrincipalName": "jacob@example.com"
        }
      },
      "tags": [
        {
          "displayName": "Tag 1",
          "id": "b4e54dd6-1d37-4e7a-9e9a-49a596ff4470"
        }
      ]
    }
  ],
  "continuationUri": null,
  "continuationToken": null
}

Tanımlar

Name	Description
EntireTenantPrincipal	Kiracı sorumlusunu temsil eder
ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları nesnesi.
ErrorResponse	Hata yanıtı.
ErrorResponseDetails	Hata yanıtı ayrıntıları.
GroupDetails	Belirli ayrıntıları gruplandırma. Sorumlu türü `Group`olduğunda geçerlidir.
GroupPrincipal	Bir güvenlik grubunu temsil eder.
GroupType	Grubun türü. Zaman içinde ek grup türleri eklenebilir.
Item	Öğe ayrıntıları.
Items	Öğe listesi.
ItemState	Öğe durumu. Zaman içinde ek öğe durumları eklenebilir.
ItemTag	Bir öğeye uygulanan etiketi temsil eder.
ItemType	Öğenin türü. Zaman içinde ek öğe türleri eklenebilir.
PrincipalType	Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.
ServicePrincipalDetails	Hizmet sorumlusuna özgü ayrıntılar. Sorumlu türü `ServicePrincipal`olduğunda geçerlidir.
ServicePrincipalPrincipal	Microsoft Entra hizmet sorumlusunu temsil eder.
ServicePrincipalProfileDetails	Hizmet sorumlusu profili ayrıntıları. Sorumlu türü `ServicePrincipalProfile`olduğunda geçerlidir.
ServicePrincipalProfilePrincipal	Hizmet sorumlusu profilini temsil eder.
UserDetails	Kullanıcı sorumlusuna özgü ayrıntılar. Sorumlu türü `User`olduğunda geçerlidir.
UserPrincipal	Microsoft Entra kullanıcı sorumlusunu temsil eder.

EntireTenantPrincipal

Nesne

Kiracı sorumlusunu temsil eder

Name	Tür	Description
displayName	string	Sorumlunun görünen adı.
id	string (uuid)	Sorumlunun kimliği.
type	string: EntireTenant	Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.

ErrorRelatedResource

Nesne

Hatayla ilgili kaynak ayrıntıları nesnesi.

Name	Tür	Description
resourceId	string	Hataya dahil olan kaynak kimliği.
resourceType	string	Hataya dahil olan kaynağın türü.

ErrorResponse

Nesne

Hata yanıtı.

Name	Tür	Description
errorCode	string	Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
isRetriable	boolean	True olduğunda istek yeniden denenebilir. Varsa gecikmeyi `Retry-After` belirlemek için yanıt üst bilgisini kullanın.
message	string	Hatanın okunabilir bir gösterimi.
moreDetails	ErrorResponseDetails[]	Ek hata ayrıntılarının listesi.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.
requestId	string (uuid)	Hatayla ilişkili isteğin kimliği.

ErrorResponseDetails

Nesne

Hata yanıtı ayrıntıları.

Name	Tür	Description
errorCode	string	Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
message	string	Hatanın okunabilir bir gösterimi.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.

GroupDetails

Nesne

Belirli ayrıntıları gruplandırma. Sorumlu türü Groupolduğunda geçerlidir.

Name	Tür	Description
groupType	GroupType	Grubun türü. Zaman içinde ek grup türleri eklenebilir.

GroupPrincipal

Nesne

Bir güvenlik grubunu temsil eder.

Name	Tür	Description
displayName	string	Sorumlunun görünen adı.
groupDetails	GroupDetails	Belirli ayrıntıları gruplandırma. Sorumlu türü `Group`olduğunda geçerlidir.
id	string (uuid)	Sorumlunun kimliği.
type	string: Group	Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.

GroupType

Numaralandırma

Grubun türü. Zaman içinde ek grup türleri eklenebilir.

Değer	Description
Unknown	Asıl grup türü bilinmiyor.
SecurityGroup	Sorumlu bir güvenlik grubudur.
DistributionList	Sorumlu bir dağıtım listesidir.

Item

Nesne

Öğe ayrıntıları.

Name	Tür	Description
capacityId	string (uuid)	Çalışma alanının kapasite kimliği.
creatorPrincipal	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	Öğenin sahibi.
defaultIdentity	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	Öğenin varsayılan kimliği.
description	string	Öğe türü ve öğe kullanımı dahil olmak üzere öğe ayrıntıları.
folderId	string (uuid)	Öğenin klasör kimliği.
id	string (uuid)	Öğe kimliği.
lastUpdatedDate	string (date-time)	Son güncelleştirme tarihi ve saati.
name	string	Öğe adı.
state	ItemState	Öğe durumu.
tags	ItemTag[]	Uygulanan etiketlerin listesi.
type	ItemType	Öğe türü. Synapse, Notebook, Kqldatabase ve SynapseWorkbook gibi değerleri içerir.
workspaceId	string (uuid)	Öğenin çalışma alanı kimliği.

Items

Nesne

Öğe listesi.

Name	Tür	Description
continuationToken	string	Sonraki sonuç kümesi toplu işleminin belirteci. Başka kayıt yoksa yanıttan kaldırılır.
continuationUri	string	Sonraki sonuç kümesi toplu işleminin URI'sini. Başka kayıt yoksa yanıttan kaldırılır.
itemEntities	Item[]	Belirli bir kiracının öğe listesi.

ItemState

Numaralandırma

Öğe durumu. Zaman içinde ek öğe durumları eklenebilir.

Değer	Description
Active	Etkin bir öğe.

ItemTag

Nesne

Bir öğeye uygulanan etiketi temsil eder.

Name	Tür	Description
displayName	string	Etiketin adı.
id	string (uuid)	Etiket kimliği.

ItemType

Numaralandırma

Öğenin türü. Zaman içinde ek öğe türleri eklenebilir.

Değer	Description
Dashboard	PowerBI panosu.
Report	PowerBI raporu.
SemanticModel	PowerBI anlam modeli.
PaginatedReport	PowerBI sayfalandırılmış raporu.
Datamart	PowerBI datamart.
Lakehouse	Göl evi.
Eventhouse	Bir olay evi.
Environment	Bir ortam.
KQLDatabase	KQL veritabanı.
KQLQueryset	KQL sorgu kümesi.
KQLDashboard	KQL panosu.
DataPipeline	Veri işlem hattı.
Notebook	Bir not defteri.
SparkJobDefinition	Spark iş tanımı.
MLExperiment	Makine öğrenmesi denemesi.
MLModel	Makine öğrenmesi modeli.
Warehouse	Bir depo.
Eventstream	Bir olay akışı.
SQLEndpoint	Bir SQL uç noktası.
MirroredWarehouse	Aynalı bir depo.
MirroredDatabase	Yansıtılmış veritabanı.
Reflex	Bir refleks.
GraphQLApi	GraphQL öğesi için bir API.
MountedDataFactory	Bir MountedDataFactory.
SQLDatabase	A SQLDatabase.
CopyJob	Kopyalama işi.
VariableLibrary	Bir VariableLibrary.
Dataflow	Veri akışı.
ApacheAirflowJob	An ApacheAirflowJob.
WarehouseSnapshot	Ambar anlık görüntüsü.
DigitalTwinBuilder	A DigitalTwinBuilder.
DigitalTwinBuilderFlow	Dijital İkiz Oluşturucu Akışı.
MirroredAzureDatabricksCatalog	Yansıtılmış azure databricks kataloğu.
Map	Bir harita.
AnomalyDetector	Anomali Algılayıcısı.
UserDataFunction	Kullanıcı Verileri İşlevi.
GraphModel	A GraphModel.
GraphQuerySet	A Graph QuerySet.
SnowflakeDatabase	Snowflake hesabından oluşturulan Iceberg tablolarını depolamak için bir Snowflake Veritabanı.
OperationsAgent	A OperationsAgent.
CosmosDBDatabase	Cosmos DB Veritabanı.
Ontology	Bir Ontoloji.
EventSchemaSet	Bir EventSchemaSet.
DataAgent	A DataAgent.
MirroredCatalog	A MirroredCatalog.
AppBackend	An AppBackend.
OrgApp	Kuruluş uygulaması.
OrgAppAudience	Kuruluş Uygulaması Hedef Kitlesi.
DataBuildToolJob	A DataBuildToolJob.
AzureDatabricksStorage	Azure Databricks için OneLake destekli bir depolama öğesi.
Plan	Bir plan.

PrincipalType

Numaralandırma

Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.

Değer	Description
User	Sorumlu, Microsoft Entra kullanıcı sorumlusudur.
ServicePrincipal	Sorumlu bir Microsoft Entra hizmet sorumlusudur.
Group	Sorumlu bir güvenlik grubudur.
ServicePrincipalProfile	Sorumlu bir hizmet sorumlusu profilidir.
EntireTenant	Sorumlu, tüm kiracı kullanıcılarını temsil eder.

ServicePrincipalDetails

Nesne

Hizmet sorumlusuna özgü ayrıntılar. Sorumlu türü ServicePrincipalolduğunda geçerlidir.

Name	Tür	Description
aadAppId	string (uuid)	Hizmet sorumlusunun Microsoft Entra AppId değeri.

ServicePrincipalPrincipal

Nesne

Microsoft Entra hizmet sorumlusunu temsil eder.

Name	Tür	Description
displayName	string	Sorumlunun görünen adı.
id	string (uuid)	Sorumlunun kimliği.
servicePrincipalDetails	ServicePrincipalDetails	Hizmet sorumlusuna özgü ayrıntılar. Sorumlu türü `ServicePrincipal`olduğunda geçerlidir.
type	string: ServicePrincipal	Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.

ServicePrincipalProfileDetails

Nesne

Hizmet sorumlusu profili ayrıntıları. Sorumlu türü ServicePrincipalProfileolduğunda geçerlidir.

Name	Tür	Description
parentPrincipal	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	Hizmet sorumlusu profilinin üst sorumlusu.

ServicePrincipalProfilePrincipal

Nesne

Hizmet sorumlusu profilini temsil eder.

Name	Tür	Description
displayName	string	Sorumlunun görünen adı.
id	string (uuid)	Sorumlunun kimliği.
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	Hizmet sorumlusu profili ayrıntıları. Sorumlu türü `ServicePrincipalProfile`olduğunda geçerlidir.
type	string: ServicePrincipalProfile	Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.

UserDetails

Nesne

Kullanıcı sorumlusuna özgü ayrıntılar. Sorumlu türü Userolduğunda geçerlidir.

Name	Tür	Description
userPrincipalName	string	Kullanıcı asıl adı.

UserPrincipal

Nesne

Microsoft Entra kullanıcı sorumlusunu temsil eder.

Name	Tür	Description
displayName	string	Sorumlunun görünen adı.
id	string (uuid)	Sorumlunun kimliği.
type	string: User	Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.
userDetails	UserDetails	Kullanıcı sorumlusuna özgü ayrıntılar. Sorumlu türü `User`olduğunda geçerlidir.